CodeVetter docs

The local-first knowledge system for the CodeVetter repository.

CodeVetter docs

This is the canonical knowledge system for the CodeVetter repository. The committed Markdown here is the source of truth; Blume is only the presentation and search layer.

• Short current view: STATUS.md
• Deep timeline + feature log: PROJECT_STATUS.md
• Agent bootloader: agents.md
• Product readme: README.md

Product

• overview.md — what CodeVetter is, durable scope, capability matrix, strategy.
• surfaces.md — nav tabs, URL-only routes, removed surfaces.
• synthetic-user-qa.md — runtime proof layer for agent-written code.

Architecture

• Start here: how-it-works.md — end-to-end pedagogical overview of the whole system (components, review flow, key decisions).
• overview.md — layers, critical invariants, what was removed.
• ipc-and-commands.md — the IPC bridge and command map.
• data-model.md — SQLite tables and persistence boundaries.
• review-pipeline.md — review → fix → re-review → proof.
• graph-and-history.md — canonical structural graph + release history workbench.
• repo-unpacked.md — evidence-backed repo briefs.
• mcp-sidecar.md — opt-in local MCP server.
• history-evidence-import.md — importing provider-side outcomes.
• native-agent-island.md — supervised Swift status, speech, and provider-action boundary.

Decisions

• mcp-sdk.md — chose rmcp 2.2.0 for the MCP sidecar.
• oss-integration.md — OSS integration evaluation.
• structural-graph-contract.md — first-party code-graph capability and release contract.

Development

• setup.md — prerequisites, install, run.
• testing.md — the four test surfaces.
• performance.md — perf harness and baselines.
• benchmark.md — catch-rate benchmark.
• configuration.md — runtime config and CSP.
• docs.md — how to write, validate, and render docs.

Operations

• automation-contract.md — privacy-safe product, release, reliability, and Foundry evidence contracts.
• release-pipeline.md — desktop release chain.
• signing-and-updates.md — signing keys + auto-update mechanism.
• landing-deploy.md — Cloudflare Pages deploy.
• ci.md — CI workflow and order.

Jobs

• weekly-quality.md — Monday cron canary.

Runbooks

• cut-a-release.md — ship a new desktop version.
• deploy-landing.md — deploy the Astro site.

Knowledge

• failed-approaches.md — things that broke and the constraints they left.
• competitive-landscape.md — AI code review competitive landscape.

Learnings

• README.md — learning roadmap and coverage map.
• new-things.md — platform + stack concepts.
• telemetry-and-indexing.md — the usage pipeline.
• verification-and-judgment.md — the verification stack.

Archive

Superseded docs kept for git history. Do not treat as current. These are excluded from the rendered Blume site (see blume.config.ts), so the links below point at the files in the repo on GitHub.

• DECISIONS.md — older decision log.
• LESSONS.md — older lessons.
• PRD-*.md — scoped PRDs for shipped slices.
• stale-competitive-landscape-2026-03.md — full March competitor survey + April OSS GTM plan.
• stale-architecture-2026-04.md — pre-desloppification architecture (removed packages//workers/).
• stale-development-2026-04.md
• stale-configuration-2026-04.md
• stale-testing-2026-04.md
• planning-codebase/ — pre-desloppification .planning/codebase/ docs.

Open questions

Tracked in STATUS.md under “Unresolved questions”. Do not invent answers in docs; mark gaps explicitly.