Skip to content

Surface actionable rust-hybrid fallback diagnostics#675

Merged
jununfly merged 1 commit into
mainfrom
codex/fallback-diagnostics-ux
Jul 2, 2026
Merged

Surface actionable rust-hybrid fallback diagnostics#675
jununfly merged 1 commit into
mainfrom
codex/fallback-diagnostics-ux

Conversation

@jununfly

@jununfly jununfly commented Jul 2, 2026

Copy link
Copy Markdown
Owner

Summary

Resolves the remaining diagnostics UX scope from #668, #669, and #670 by making degraded rust-hybrid fallback state actionable in status, doctor, and docs.

  • Adds a Rust-hybrid Fallback section to human zcodegraph status output with graph usability, translated top reason groups, the exact doctor command, and the privacy-preserving artifact to share.
  • Adds fallbackDiagnostics to zcodegraph status --json for scripts and agents.
  • Extends degraded doctor --bundle --last-run summaries with the per-file-diagnostics.json handoff artifact and maintainer next step.
  • Reuses the fallback reason label vocabulary across status and doctor so human output does not rely only on internal taxonomy codes.
  • Documents the global workflow: init creates, index rebuilds, sync catches up edits, status answers trust, and doctor packages evidence.
  • Records the completed roadmap under docs/plans/2026-07-02-fallback-diagnostics-ux-roadmap.*.

Scope note

This PR closes the diagnostics transparency and workflow issues. It does not implement new Vue/TypeScript parser coverage; that should follow as a separate measurable fallback-reduction slice if needed.

Verification

  • npx vitest run __tests__/rust-index-engine-cli-fallback.test.ts __tests__/rust-hybrid-doctor.test.ts __tests__/status-json.test.ts
  • npm run build
  • git diff --check

All passed locally.

@jununfly
jununfly merged commit 1eb6760 into main Jul 2, 2026
3 checks passed
@jununfly
jununfly deleted the codex/fallback-diagnostics-ux branch July 2, 2026 14:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant