[PatrickSys]

Draft. Do not merge or publish yet.

init now does the multi-tool setup from #139 and saves the launch command the way #140 does. It detects Claude Code, Codex, Cursor and OpenCode and writes a config for each one you pick.

Fixes:

1. Docs match the new init, and they note it isn't in npm 2.2.0 yet.
2. map builds the index on a fresh project, so it no longer reports 0 files.
3. Adds --version / -v.
4. Adds a Codex setup line (codex mcp add codebase-context -- npx -y codebase-context).
5. A weak search result now explains itself and suggests a narrower next step.

Tests: type-check passes and 679/679 tests pass.

Still open: re-running the 5 dogfood questions, a Windows install check, memory use on a mid-size repo, and search quality. #139 and #140 are left as they are.

Tracked in IdeaSpine: https://github.com/PatrickSys/ideaspine/issues/17

[PatrickSys]

Tracked in IdeaSpine: https://github.com/PatrickSys/ideaspine/blob/main/staging/ideaspine/assist-log.md

[PatrickSys]

Closing this superseded draft because its commit is included in #131's public branch, alongside the publication and source-validity fixes. The installed candidate recorded on #131 exercised the Windows install and five original Express questions: frozen retrieval found an expected file in the top five for 14/21 queries, with Hono peak sampled server RSS of 1.516 GB and an explicit graph limitation. PR131 remains a draft while its final repair is validated; nothing is being claimed merged or released. PR140's extra client targets and HTTP setup remain separate. This branch is being retained.

[cursor]

Adversarial review (maintainer)

Verdict: fix first — do not merge until rebased onto current master.

What I verified: Checked out the branch, pnpm build, 680/680 tests (after fix), MCP initialize OK, CLI reindex/map/search on this repo and sindresorhus/is; map auto-index on fresh tree works.

What I fixed (pushed 0265d4d): The branch still used argv[1] endsWith('index.js') entry detection, so npm-style bin symlinks silently no-op (npx codebase-context --version prints nothing). Ported canonical realpath entrypoint matching from master and added a symlink --version regression test.

Blockers left:

1. Stale base — branch predates master (e87020f, 5db8705); would regress model-free indexing / Hono / smol-toml init unless rebased.
2. Hard merge conflict with First-run fixes: OPENAI_BASE_URL and CLI entrypoint regression test #145 on src/index.ts, src/cli-init.ts, docs, and several tests — rebase Beta: usable setup (combines #139 + #140, fixes 5 dogfood blockers) #142 after First-run fixes: OPENAI_BASE_URL and CLI entrypoint regression test #145 or resolve manually.
3. Missing First-run fixes: OPENAI_BASE_URL and CLI entrypoint regression test #145 — no OPENAI_BASE_URL wiring here.
4. Dogfood nit: CLI search can show confidence >1.0 (score boost not capped in display); unrelated to this PR but confusing for agents.

Suggested order: Merge #145 first, rebase #142, rerun full suite + init wizard smoke.

[cursor]

Review update (post–master merge)

Verdict: merge after #145 (was fix-first; now current with master).

Done: Merged origin/master into this branch (cc18718, normal merge, no rebase/force-push). Conflicts resolved by keeping master’s init preflight/smol-toml, index-artifact map path, and embedding CLI flags, plus this branch’s canonical symlink entrypoint + tests/cli-version.test.ts symlink case and search-quality hint text/docs.

Verified: pnpm build + 1304 passed (7 skipped). Local merge of cursor/first-run-fixes-16ec on top applied cleanly (no conflict markers); combined embedding tests pass; test merge was not pushed to this branch.

Still: Land #145 first, then merge this PR. npm publish remains out of scope.