feat(ux): add guided project status facade

[2233admin]

Closes #281

Summary

• add code-intel status [<repo>] [--json] as the low-friction project readiness entry
• return needs_run, ready, or stale with repository identity, committed-run receipt, freshness, and bounded next actions
• guide the existing context/query/impact/MCP trace workflow without importing a new indexer, graph store, provider, or authority path
• register the public route and v4 full-help contract, and document the workflow in README

Authority boundaries

• resolves placement through ProjectContext; the public command accepts no artifact-root, repo-key, run-id, or manifest override
• reports committed authority only when a verified completed run exists
• preserves current/stale snapshot identities; stale impact remains explicitly advisory
• treats an absent committed run as a usable needs_run state, while malformed evidence and host I/O still fail closed

Verification

• cargo test -p code-intel --bin code-intel (729 passed)
• cargo test -p code-intel --test primary_entry (12 passed)
• cargo test -p code-intel --test cli_head_parity (3 passed)
• legacy/tools/check-hardcoded-paths.ps1 (129 files, OK)
• Sentrux session_end (4263 -> 4265; coupling 65.88 -> 65.58; pass)
• authoritative self-scan (run execute): exit 0, completed, zero domain/process failures
• code-intel change impact ... --staleness advisory (returned stale-advisory and selected primary_entry)

[coderabbitai]

Warning

Review limit reached

@2233admin, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 17 minutes

Limit details: You’ve used all 1 included review currently available under your plan.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: a01c3cdb-7373-46ac-8088-ef1b9720e7a8

📥 Commits

Reviewing files that changed from the base of the PR and between ad07dce and 1231cd4.

📒 Files selected for processing (15)

• README.md
• crates/code-intel-cli/src/cli/command_catalog/contract.rs
• crates/code-intel-cli/src/cli/command_catalog/mod.rs
• crates/code-intel-cli/src/cli/command_catalog/routes/mod.rs
• crates/code-intel-cli/src/cli/command_catalog/routes/project_routes.rs
• crates/code-intel-cli/src/cli/command_catalog/routes/types.rs
• crates/code-intel-cli/src/cli/command_catalog/tests.rs
• crates/code-intel-cli/src/cli/legacy.rs
• crates/code-intel-cli/src/cli/project_query.rs
• crates/code-intel-cli/src/project_context.rs
• crates/code-intel-cli/src/project_context/status.rs
• crates/code-intel-cli/src/project_context/tests.rs
• crates/code-intel-cli/tests/cli_head_parity.rs
• crates/code-intel-cli/tests/fixtures/cli-head-parity.v2.json
• crates/code-intel-cli/tests/primary_entry.rs

---

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.}

[repowise-bot]

✅ Health of changed files: 5.3 → 5.5 (+0.2)
_{🚨 Change risk: high, riskier than 82% of this repo's commits.}

📋 At a glance
3 files changed health · 5 hotspots touched · 3 new findings introduced · 2 files with recent fix history · 1 dead-code finding. Scoped to crates.

✅ Health gate: passed

🔎 More signals (3)

🗺️ Change map

flowchart LR
  subgraph PR ["Changed in this PR (4 with dependents)"]
    f_crates_code_intel_cli_src_project_context_rs[".../src/project_context.rs 🔥"]:::changed
    f_crates_code_intel_cli_src_cli_command_catalog_routes_types_rs[".../routes/types.rs"]:::changed
    f_crates_code_intel_cli_tests_cli_head_parity_rs[".../tests/cli_head_parity.rs"]:::changed
    f_crates_code_intel_cli_tests_primary_entry_rs[".../tests/primary_entry.rs"]:::changed
  end
  f_crates_code_intel_cli_src_cli_primary_rs[".../cli/primary.rs"]
  f_crates_code_intel_cli_src_project_context_rs --> f_crates_code_intel_cli_src_cli_primary_rs
  f_crates_code_intel_cli_src_main_rs[".../src/main.rs"]
  f_crates_code_intel_cli_src_project_context_rs --> f_crates_code_intel_cli_src_main_rs
  f_crates_code_intel_cli_src_mcp_serve_handlers_rs[".../mcp_serve/handlers.rs"]
  f_crates_code_intel_cli_src_project_context_rs --> f_crates_code_intel_cli_src_mcp_serve_handlers_rs
  f_crates_code_intel_cli_src_mcp_serve_mod_rs[".../mcp_serve/mod.rs"]
  f_crates_code_intel_cli_src_project_context_rs --> f_crates_code_intel_cli_src_mcp_serve_mod_rs
  f_test_scoped_repowise_validator_py["test-scoped-repowise-validator.py"]
  f_crates_code_intel_cli_src_cli_command_catalog_routes_types_rs --> f_test_scoped_repowise_validator_py
  f_crates_code_intel_cli_tests_cli_head_parity_rs --> f_crates_code_intel_cli_src_main_rs
  f_crates_code_intel_cli_tests_primary_entry_rs --> f_crates_code_intel_cli_src_cli_primary_rs
  f_crates_code_intel_cli_tests_primary_entry_rs --> f_crates_code_intel_cli_src_main_rs
  more(["+1 more dependent"])
  PR --> more
  classDef changed fill:#dbeafe,stroke:#1d4ed8,color:#1e3a5f
  classDef warn fill:#fef3c7,stroke:#b45309,color:#78350f
  classDef guard fill:#dcfce7,stroke:#15803d,color:#14532d

Loading

_{Solid arrows: code that imports the changed files (6 direct dependents, from the last indexed snapshot). Dashed: history/tests.}

🔥 Hotspots touched (5)

• .../routes/mod.rs: 6 commits/90d, 1 dependents
• .../command_catalog/contract.rs: 1 commits/90d, 3 dependents
• .../cli/project_query.rs: 1 commits/90d, 2 dependents

2 more

• .../tests/primary_entry.rs: 10 commits/90d, 4 dependents
• .../src/project_context.rs: 1 commits/90d, 7 dependents

💀 Dead code (1 finding)

• 💀 .../command_catalog/mod.rs (file-level) (confidence 0.40)

---

📊 See the full report for this PR
_{Your repo map with this PR's blast radius lit up, every caller of the contracts it changes, and health before and after. No sign-in. · ⭐ Star Repowise · 📥 Install bot · Silence on a single PR with [skip repowise] in the title · Per-repo toggle on repowise.dev/settings?tab=bot · Updated 2026-08-18 02:27 UTC (since the last push: health 5.4 to 5.5, 1 new finding)}

[github-actions]

Code Intel change risk

Score	Percentile	Level
65/100	73th (vs last 48 commits)	🟡 medium

Top signals

• Diff shape: 15 file(s), +607/-30 (max file share 0.28)
• Test asymmetry: source changed, tests touched
• Bug-magnet: 12 fix commit(s) in touched files (180d)
• Churn: 127 commit(s) touching these files (90d)

_{revspec: origin/main..HEAD · threshold: percentile >= 90 blocks unless labeled risk-accepted · code-intel change risk}

[2233admin]

收口审查：当前 head 仍被阻塞。agent-gate 缺少人工审核标签；Ubuntu smoke 曾因 apt 镜像超时取消，重跑中；同时 DR-0005 要求先降低已有修复 PR 积压（#202/#248/#249/#250/#280）再推进新 feature。另需在 #280/#250 处理后重新吸收共享文件变更，并补齐 current/stale committed-run fixture 的端到端证据；本 PR 暂不进入人工审核/合并。