docs: design the repo-oriented code-intelligence provider contract

Design for the OPTIONAL code-intelligence provider contract that lets a
user pick how their codebase is indexed and searched, replacing gstack's
~17k LOC of bespoke GBrain glue. Repo-oriented ops (register_source/
refresh/search/status required; add/delete/export optional), a per-provider
capability matrix, GBrain-recommended-first selection, repo-scoped + install
consent, and a phased rollout that keeps gstack fully functional with no
provider selected. All three providers are driven from the runtime via CLI
or HTTP — no MCP client.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Sinabina
2026-07-21 17:16:53 -07:00
co-authored by Claude Opus 4.8
parent a84a6e233d
commit b4421a4e69
6 changed files with 914 additions and 0 deletions
+14
View File
@@ -0,0 +1,14 @@
/**
* code-intelligence — the OPTIONAL, repo-oriented provider contract.
* See docs/designs/CODE_INTELLIGENCE_PROVIDER_CONTRACT.md.
*/
export * from "./contract";
export { GbrainProvider, parseGbrainSearch } from "./gbrain-adapter";
export { SourcebotProvider, GraphifyProvider } from "./mcp-adapters";
export {
recommendCodeProvider,
resolveCodeProvider,
RECOMMENDED_ORDER,
type PickerOptions,
} from "./picker";