# 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
