Documentation

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 optionMeaning
--refsList every reference row, grouped by spec file.
--gapsList only uncovered source files, one per line.
--rowsEmit TSV: bucket, path, spec host, detail.
--strictExit 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.

Back to all commands