Author orch Markdown test plan

2026-03-19 16:27:28 +08:00
parent b448d98e71
commit a20bec1cac
68 changed files with 2225 additions and 160 deletions
@@ -0,0 +1,71 @@
+# Orch Markdown Test Gap Fill
+
+## Status
+
+- `completed`
+
+## Owner
+
+- codex
+
+## Started At
+
+- `2026-03-19`
+
+## Goal
+
+- fill the five highest-priority Markdown test-plan gaps in `docs/tests/orch/` so the current `orch` CLI has better coverage for key flag validation, non-default output behavior, and error contracts
+
+## Scope
+
+- add or update `docs/tests/orch/task-add/` for invalid `acceptance-json` and invalid `priority`
+- add or update `docs/tests/orch/ready/` for priority ordering and `--limit`
+- add or update `docs/tests/orch/answer/` for payload-only or empty-input validation
+- add or update `docs/tests/orch/cleanup/` for invalid-input or no-matching-work cleanup behavior
+- add or update `docs/tests/orch/council-report/` for pre-tally/invalid-show/only-unanimous report behavior as needed
+- keep `docs/tests/orch/ROADMAP.md` and `docs/implementation-roadmap.md` synchronized
+
+## Checklist
+
+- [x] create an execution roadmap for the workstream
+- [x] add missing `task add` and `ready` cases and update indexes
+- [x] add missing `answer` and `cleanup` cases and update indexes
+- [x] add missing `council report` cases and update indexes
+- [x] synchronize `docs/tests/orch/ROADMAP.md`
+- [x] update `docs/implementation-roadmap.md`
+- [x] archive this roadmap with a completion summary
+
+## Files
+
+- `docs/roadmaps/archive/orch-markdown-test-gap-fill.md`
+- `docs/implementation-roadmap.md`
+- `docs/tests/orch/ROADMAP.md`
+- `docs/tests/orch/task-add/README.md`
+- `docs/tests/orch/task-add/*.md`
+- `docs/tests/orch/ready/README.md`
+- `docs/tests/orch/ready/*.md`
+- `docs/tests/orch/answer/README.md`
+- `docs/tests/orch/answer/*.md`
+- `docs/tests/orch/cleanup/README.md`
+- `docs/tests/orch/cleanup/*.md`
+- `docs/tests/orch/council-report/README.md`
+- `docs/tests/orch/council-report/*.md`
+
+## Decisions
+
+- use focused follow-up case files instead of broad rewrites to keep the current authored set stable
+- keep shared tracking files in the main thread and delegate only disjoint command directories
+
+## Blockers
+
+- none
+
+## Next Step
+
+- no further step in this workstream; future follow-up should start from the updated `docs/tests/orch/ROADMAP.md`
+
+## Completion Summary
+
+- added 10 supplemental `orch` Markdown test-plan cases covering high-priority gaps in `task add`, `ready`, `answer`, `cleanup`, and `council report`
+- synchronized the relevant command index `README.md` files, the shared `docs/tests/orch/ROADMAP.md` ledger, and the project-level implementation roadmap
+- used sub-agents for three disjoint directory slices while keeping shared tracking files in the main thread