docs(cli): record retirement of status --json in v8 migration
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 30/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Stale
- Domain
- cli, documentation
Research direction
Start with PR #795 and its command-surface smoke test, then check the v8 release or migration note against the acceptance criteria. Done means the obsolete status surface is absent, doctor’s human diagnostic role is documented, and the migration note states that doctor is not a JSON-compatible replacement.
Written by the indexing model from the issue text.
Description
Context
On next, the documentation promises aidd status --json for CI, while the shipped command rejects the flag. That mismatch is real.
PR #795 deliberately replaces the old CLI surface:
aidd statusis retired.aidd doctorbecomes the human diagnostic view and includes drift alongside installation health.- Machine-readable output remains command-specific:
aidd framework rules --jsonandaidd telemetry report --json. There is no generic output mode.
The PR already removes the obsolete status --json promise from CLI memory. Reintroducing the old command or adding doctor --json here would work against that new surface and would create an unplanned general output contract.
Decision
Treat this as a v8 migration/documentation gate for #795, not as implementation of status --json.
This decision intentionally leaves no machine-readable full-drift replacement. A consumer that needs one must justify a separate, versioned report contract; it must not silently substitute doctor text parsing.
Acceptance criteria
- #795 contains no
aidd statuscommand orstatus --jsondocumentation promise. -
aidd doctordocuments and presents the human drift/health diagnostic role. - The v8 release or migration note explicitly states:
aidd statusand its undocumented JSON contract are removed;aidd doctoris the human replacement, not a JSON-compatible replacement. - The command-surface smoke test reflects the retirement.
- #795 links this issue and it is closed only after that PR merges.
Boundary
Do not add --json to doctor, an alias for status, or a generic output abstraction. Those are separate product decisions.
- Dominant language
- TypeScript
- Stars
- 481
- Forks
- 45
- Avg merge
- 14h 36m
- Merged PRs (30d)
- 110
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from ai-driven-dev/framework
-
refactor(aidd-orchestrator): the check zone says when to stop, and reviews its axes in one round Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#887 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
ai-driven-dev/framework#873 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
ai-driven-dev/framework#872 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
ai-driven-dev/framework#625 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#467 · 1 comment ·
All issues in ai-driven-dev/framework
Similar issues
-
comp/desktop P3 type/bug
Difficulty 1/5 Under an hour Newbie friendliness 92/100
NousResearch/hermes-agent#118866 ·
-
Browser Waiting for: Product Owner
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
getsentry/sentry-javascript#24577 · 1 comment ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
agilepathway/label-checker#640 ·
-
Plugin stuck at "loading" on DSH 0.1.6-alpha.2 — turnTail list slot registration missing options.id Open
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
chrisparsons83/flexspotff#153 ·