Summary
The CLI dispatcher (ProgramRunner.cs:67-93) recognises 15+ commands (search, symbols, definition, callers, callees, references, outline, hotspots, deps, impact, find_in_file, excerpt, status, validate, unused, etc.) but no cdidx suggestions subcommand. Suggestions live in a JSON store (.cdidx/suggestions-*.json) and are completely invisible to the CLI surface. Users cannot list, filter, search, export, or inspect their suggestion history without reading raw JSON. Team collaboration ("share your suggestions for triage") requires manual file copying.
Where
src/CodeIndex/Cli/ProgramRunner.cs:67-93 (command dispatch — no suggestions entry)src/CodeIndex/Cli/SuggestionStore.cs (the store — no CLI surface)
Suggested approach
(1) Add a cdidx suggestions subcommand with sub-verbs: list, show <id>, export [--json|--markdown], submit <id>, resolve <id>, delete <id>, sync (cross-link C501 lifecycle / GitHub state sync). (2) list should support filters mirroring the C502 query API: --status, --language, --category, --since, --agent (cross-link C503 attribution). (3) Default list output: id, created_at, status, category, title — one line each, sortable. (4) --json output for machine consumers, with the same envelope as other commands (cross-link #1808). (5) Add the command to the (just-filed C483) command reference table. (6) Document the workflow in USER_GUIDE under "Suggestions": when to inspect, how to triage, how to export for team review. (7) Add regression tests: list returns expected entries, filters work, export round-trips. (8) Cross-link with the just-filed C501/C502/C503/C505 (lifecycle / query / attribution / submit fallback) and #1810 (tool examples).
Summary
The CLI dispatcher (ProgramRunner.cs:67-93) recognises 15+ commands (search, symbols, definition, callers, callees, references, outline, hotspots, deps, impact, find_in_file, excerpt, status, validate, unused, etc.) but no
cdidx suggestionssubcommand. Suggestions live in a JSON store (.cdidx/suggestions-*.json) and are completely invisible to the CLI surface. Users cannot list, filter, search, export, or inspect their suggestion history without reading raw JSON. Team collaboration ("share your suggestions for triage") requires manual file copying.Where
src/CodeIndex/Cli/ProgramRunner.cs:67-93(command dispatch — no suggestions entry)src/CodeIndex/Cli/SuggestionStore.cs(the store — no CLI surface)Suggested approach
(1) Add a
cdidx suggestionssubcommand with sub-verbs:list,show <id>,export [--json|--markdown],submit <id>,resolve <id>,delete <id>,sync(cross-link C501 lifecycle / GitHub state sync). (2)listshould support filters mirroring the C502 query API:--status,--language,--category,--since,--agent(cross-link C503 attribution). (3) Defaultlistoutput: id, created_at, status, category, title — one line each, sortable. (4)--jsonoutput for machine consumers, with the same envelope as other commands (cross-link #1808). (5) Add the command to the (just-filed C483) command reference table. (6) Document the workflow in USER_GUIDE under "Suggestions": when to inspect, how to triage, how to export for team review. (7) Add regression tests: list returns expected entries, filters work, export round-trips. (8) Cross-link with the just-filed C501/C502/C503/C505 (lifecycle / query / attribution / submit fallback) and #1810 (tool examples).