/test-suite
Reference for the /test-suite command: invocation, arguments, inputs and outputs.
Authors and runs behavior-first tests for a repository, triages failures and reports coverage gaps on critical paths. Use when the user asks to 'build a test suite', 'write and run tests for this repo' or 'find coverage gaps'. Tests for one named unit alone fit test-authoring.
Invocation
/test-suite [path/to/repo/] [--focus FILE_OR_DIR]Pipeline position
Consumes the deployed repository's behavior contracts (public-API surfaces, error-handling branches, documented invariants) and emits the test report downstream remediation cycles consume. Upstream: entered from /plan-execute's implementation hand-off or invoked standalone against a deployed repository. Downstream: /code-review (per-file craft) and /code-audit (cross-file forensic) read the coverage-gap findings.
Inputs
The deployed repository's source tree, its root manifest (pyproject.toml / package.json / Cargo.toml / go.mod / sibling), and its existing test corpus. No upstream manifest is required; the command operates against on-disk state.
| Argument | Type | Required | Description |
|---|---|---|---|
path/to/repo/ | Path | Yes | Root directory of the deployed repository. MUST carry a source tree and a discoverable root manifest. The command refuses execution when no source tree is present. |
--focus FILE_OR_DIR | Path | No | Restrict test authoring to the behavior contracts of a single file or directory subtree under the repo root. Path resolves relative to the repo root. |
Outputs
The report at _inputs/test-suite-report.md plus the authored test files at the host's ratified test location. Test files carry the canonical SPDX header per the File-Authoring Contract; the report is header-exempt per the .apothem/** exception class at src/apothem/schemas/header-exceptions.txt.
Next step
Invoke /code-review to walk the per-file craft of the source under test, then /code-audit for cross-file forensic integrity; both consume the coverage-gap findings this command emits at _inputs/test-suite-report.md.
Source
Generated from src/apothem/commands/test-suite.md, the command definition every harness installs.