feat: add tabular Work summaries and CSV exports
Test / Tests and coverage occurred while executing withChecks step.
Intrepid/AI Engineering/pipeline/head There was a failure building this commit
build / jvm (push) Canceled after 0s
build / native (macos-15, macos-arm64) (push) Canceled after 0s
build / native (ubuntu-24.04, linux-x86_64) (push) Canceled after 0s
build / native (windows-2025, windows-x86_64) (push) Canceled after 0s

This commit is contained in:
Nilton Constantino
2026-11-16 15:59:26 +00:00
parent f296d252c6
commit a7e3a2fdfc
21 changed files with 642 additions and 5 deletions
+33
View File
@@ -149,6 +149,39 @@ The exported context brings together the Work's scope, discussion, decisions,
plans, evidence references, and pending questions. `next-actions` suggests what to
address next. Every command provides `--help`; inspection commands support JSON.
### Choose the next Work
`work list`, `status`, and `next-actions` accept `--format table|csv|markdown|json`.
Markdown is the default and renders actual tables. Use aligned tables in the
terminal, CSV for spreadsheets, and JSON for the existing full structured records:
```sh
aie work list --open --format table
aie status --format table
aie next-actions --format table
aie work list --open --format csv > open-works.csv
aie next-actions WRK-0001 --format csv > next-actions.csv
```
Work summaries show ID, title, status, archive flag, completed/total steps,
pending action count, validation, and the next suggested command. Steps count
all registered Plans, including cancelled steps in the total; `0/0` means no
steps are registered, and `unavailable` means Plan data could not be read.
Pending actions are the deterministic suggestions from `next-actions`, including
execution, questions, decision review, dependencies, repairs, and archival.
They are not a count of blockers or a priority ranking. Use `next-actions WRK`
to inspect every suggestion and its explanation.
`--open` includes OPEN, ACTIVE, and BLOCKED Works and excludes completed,
cancelled, and archived Works, in every format. Without this filter, `work list`
continues to include all Works. `status` hides archived Works unless `--all` is
given. JSON schemas and default formats elsewhere are unchanged. CSV uses UTF-8,
comma separators, a fixed header, CRLF record endings, and quoted fields when
needed; original multiline text is preserved. CSV contains just the table,
including a header for empty results. Markdown escapes cell content and table
output flattens line breaks and control characters. These commands only read
project records and never invoke a model.
### Use existing Git repositories
Git is required when registering or inspecting source repositories. In a project