feat: ship keyword-only CLI v2

[bernoussama]

What changed

• release @clankeroverflow/cli 2.0.0 and stamp the Claude, Codex, and OpenClaw plugin manifests
• replace local semantic and hybrid retrieval with a dependency-light SQLite FTS5 exact-first and tiered keyword path
• migrate legacy sqlite-vec databases through a validated atomic rebuild guarded by a cross-process SQLite lock
• surface v1 configuration cleanup warnings through CLI commands and MCP initialization
• simplify hosted retrieval to the same keyword-only contract and update the web, docs, skills, setup, and evaluations
• add the real-world Stack Overflow duplicate-question benchmark with per-post license and author provenance boundaries

Why

The previous local semantic stack added native/runtime dependencies, configuration surface, and benchmark machinery that were expensive to operate. The v2 contract makes keyword retrieval the single predictable path while preserving legacy local solutions safely.

During review, three release blockers were found and fixed: concurrent processes could race the legacy database swap, benchmark redistribution readiness did not require complete row-level attribution, and destructive configuration migration warnings were not consistently visible.

Impact

• CLI and MCP both advertise version 2.0.0 from the CLI package source of truth.
• Existing local solution and vote data is preserved and reindexed into FTS5 on first open.
• Semantic and hybrid modes and their model dependencies are removed.
• Prepared Stack Overflow artifacts are marked non-redistributable unless every canonical question, accepted answer, and duplicate question has complete license and author provenance.

Validation

• pnpm test
• pnpm check-types
• pnpm lint (no errors; 10 existing warnings)
• pnpm format:check
• pnpm --filter @clankeroverflow/cli build
• pnpm test:memory-retrieval
• pnpm test:stackoverflow-realworld
• pnpm eval:stackoverflow-realworld (1,485 queries)
• pnpm test:e2e:local (clean containers on Node 22 and Node 24)
• real sqlite-vec legacy migration stress test with 8 processes and 20,000 rows
• raw MCP initialize handshake reports server version 2.0.0

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: d08b95a3-61c4-44ba-946c-9f6afff20675

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[bernoussama]

Nightly review — clankeroverflow#73 (feat: ship keyword-only CLI v2)

Verdict: Approve with notes. The pivot is executed consistently — Workers AI/Vectorize bindings, GGUF model download, and the semantic/hybrid env vars are all removed in lockstep with README, opencode skill docs, and test env updates. learn_solution with log_solution kept for compat is a sensible migration path.

Notes:

• This is a breaking CLI change: mode: semantic/hybrid and CLANKER_LOCAL_SEMANTIC / CLANKER_LOCAL_MODEL_PATH / CLANKER_LOCAL_MODEL_ID / CLANKER_LOCAL_MODEL_DIMENSIONS are now silently ignored. Bump the major version and consider warning on startup when persisted config or env contains now-dead keys.
• 15k lines but mostly deletions + docs; the actual logic delta is small. Good.
• Double-check apps/web copy still doesn't advertise semantic search anywhere (pricing/landing fragments).