CLI reference / Maintain
cumaru coverage
Report which Git-tracked source files the durable specification references.
Synopsis
cumaru coverage [--refs|--gaps|--rows] [--strict] Arguments and options
| Argument or option | Meaning |
|---|---|
--refs | List every reference row, grouped by spec file. |
--gaps | List only uncovered source files, one per line. |
--rows | Emit TSV: bucket, path, spec host, detail. |
--strict | Exit 1 when any uncovered, stale, or invalid entry exists. |
Side effects
- Writes: None. Read-only.
- Network: None. Requires a Git work tree; the source list comes from git ls-files.
Behavior
- Only reference tags under the durable pillar count (meta.specification_dir, default specs).
- Each reference row must target a repository source file resolved from the project root.
- Buckets: covered, uncovered, stale, invalid, foreign. meta.coverage.source globs narrow the source list.
- The cumaru-refs skill closes the gaps; coverage only reports them.
Example
cumaru coverage --gaps Failures
- Exit 1: missing tree, config, or pillar; non-Git project; malformed host; or --strict with gaps.
- Exit 2: several modes or an unknown argument.
Sources: docs/coverage.md; cumaru coverage --help of CLI 0.15.3.