docs(cli): record retirement of status --json in v8 migration

Abierto
#464 2 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
30/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Estancado
Área
cli, documentation

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

good first issue

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 status is retired.
  • aidd doctor becomes the human diagnostic view and includes drift alongside installation health.
  • Machine-readable output remains command-specific: aidd framework rules --json and aidd 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 status command or status --json documentation promise.
  • aidd doctor documents and presents the human drift/health diagnostic role.
  • The v8 release or migration note explicitly states: aidd status and its undocumented JSON contract are removed; aidd doctor is 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.

Lenguaje dominante
TypeScript
Estrellas
481
Forks
45
Merge medio
14 h 36 min
PR fusionados (30 d)
110

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de ai-driven-dev/framework

Todos los issues de ai-driven-dev/framework

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.