[sunerpy]

Summary

Cold serve --mcp previously ran a spawn→poll(≤400ms)→proxy-attach→heal prelude BEFORE answering the MCP initialize/tools/list handshake. Under load that prelude exceeded the MCP client init timeout, so opencode (and other clients) marked the codegraph MCP server failed and its codegraph_* tools never registered.

This splits the SpawnOrProxy decision into a pure cold_start_action(daemon_running):

• WARM (live daemon): attach via proxy_to_running_daemon (old spawn_or_proxy semantics unchanged), falling back to serve_direct on attach failure.
• COLD (no live daemon): fire-and-forget spawn_shared_daemon_best_effort for the NEXT session, then serve_direct THIS session immediately — no poll, no blocking proxy. The daemon pid lock guarantees N concurrent cold starts converge on ≤1 daemon.

Serve-path only — no extraction/resolve/store change, golden .schema byte-stability and the no-AI/vector/LLM guardrail untouched.

Verification

• make ci green locally (fmt + clippy + test + guardrail).
• New integration test cold_start_serve_answers_handshake_within_bound: cold serve --mcp answers initialize + tools/list in <2s and exposes codegraph_search/codegraph_explore; reaps the fire-and-forget daemon in teardown; passes 3× (~0.2s each), no orphan process.
• New unit test cold_start_action_warm_proxies_cold_spawns_then_serves_direct.
• Independent oracle review: APPROVE (warm path preserved, cold path converges on ≤1 daemon, invariants intact).

Note

In production cold start the direct session runs a transient second watcher alongside the just-spawned daemon until the session exits; safe (WAL + busy_timeout serialize writes, idempotent upserts) and bounded, but noted for reviewers.

[codecov]

Codecov Report

❌ Patch coverage is 29.72973% with 26 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
crates/codegraph-cli/src/main.rs	29.72%	26 Missing ⚠️

❌ Your patch check has failed because the patch coverage (29.72%) is below the target coverage (95.00%). You can increase the patch coverage or adjust the target coverage.

@@            Coverage Diff             @@
##             main     #129      +/-   ##
==========================================
- Coverage   95.64%   95.63%   -0.01%     
==========================================
  Files         115      115              
  Lines       55334    55348      +14     
==========================================
+ Hits        52923    52934      +11     
- Misses       2411     2414       +3     

Files with missing lines	Coverage Δ
crates/codegraph-cli/src/main.rs	89.03% <29.72%> (-0.05%)	⬇️

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.