docs: restructure README and add client setup guide (#82)

* docs: restructure README and add client setup guide

README cut from 707 to ~220 lines. Per-client config blocks, pipeline
internals, and eval harness moved to dedicated docs where they belong.
Screenshots and CLI previews moved up before the setup details.

- docs/client-setup.md: new file with all 7 client configs (stdio + HTTP
  where supported), fallback single-project setup, and local build testing
- docs/capabilities.md: add practical routing examples and selection_required
  response shape (moved from README)
- CONTRIBUTING.md: add eval harness section (moved from README)
- templates/mcp/stdio/.mcp.json + http/.mcp.json: copy-pasteable config templates
- tests/mcp-client-templates.test.ts: regression tests for template validity
  and README/capabilities doc coverage
- package.json: add docs/client-setup.md to files array

* Update tests/mcp-client-templates.test.ts

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>

---------

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>

Author: PatrickSys

CONTRIBUTING.md

@@ -68,6 +68,25 @@ node dist/index.js /path/to/test/project
 
 The server logs to stderr, so you can see what it's doing.
 
+## Evaluation Harness
+
+Run `pnpm eval` to measure search/ranking quality against frozen fixtures. Use this before releases or after changing search/ranking/chunking logic.
+
+```bash
+# Two codebases (defaults to bundled fixtures)
+pnpm eval -- <codebaseA> <codebaseB>
+
+# Offline smoke test (no network)
+pnpm eval -- tests/fixtures/codebases/eval-controlled tests/fixtures/codebases/eval-controlled \
+  --fixture-a=tests/fixtures/eval-controlled.json \
+  --fixture-b=tests/fixtures/eval-controlled.json \
+  --skip-reindex --no-rerank
+```
+
+Flags: `--help`, `--fixture-a`, `--fixture-b`, `--skip-reindex`, `--no-rerank`, `--no-redact`.
+
+Save a report: `pnpm eval -- <path> --skip-reindex > eval-report.txt`
+
 ## Pull Requests
 
 - Fork, branch, make changes