What to build
Give --json a documented, versioned contract so downstream agents and tools
can depend on it. Real usage shows agents guessing at the shape (a flat list of
hunk objects vs. a nested by-file/by-status structure) and silently failing when
they guess wrong. Pin the schema down:
- Add a
schema_version to the JSON envelope.
- Document the exact shape (fields, types, status values) in the README.
- Optionally expose the JSON Schema (e.g. a
--json-schema flag) so consumers
can validate.
Acceptance criteria
Blocked by
None - can start immediately.
What to build
Give
--jsona documented, versioned contract so downstream agents and toolscan depend on it. Real usage shows agents guessing at the shape (a flat list of
hunk objects vs. a nested by-file/by-status structure) and silently failing when
they guess wrong. Pin the schema down:
schema_versionto the JSON envelope.--json-schemaflag) so consumerscan validate.
Acceptance criteria
list --jsonoutput carries an explicitschema_version.unintentionally.
Blocked by
None - can start immediately.