requirements-manager 0.1.1

Plain-text requirements management tool
Documentation
---
_version: '1'
uuid: cdc17618-c093-47d4-a145-a216b32fd866
created: 2025-10-26T18:20:13.125589520Z
parents:
- uuid: b871f9b8-ae8f-405b-8727-11e2409f20c3
  fingerprint: c97e85a0e7958c3c8fb32f7c20e76bb0204d5730f9c1fd6cfe20045602be669e
  hrid: USR-007
---
# SYS-020 Status Dashboard CLI Command

## Statement

The tool shall provide a `req status` command that prints a simple table of requirement counts by kind and reports the number of suspect links.

## Rationale

Systems engineers need a quick snapshot before reviews, releases, or CI runs. A single command that surfaces totals, traceability gaps (roots/leaves), tagging coverage, and suspect links reduces context switching and supports continuous monitoring.

## Scope

The status view shall deliver an immediate health snapshot: total counts, breakdown by kind, and suspect link posture. It must favour legibility, fast startup, and CI-friendly behaviour so teams can wire it into pre-commit hooks and dashboards.

Presentation, table layout, and interaction guidance are captured in [SPC-003](./SPC-003.md).

## Verification

- Running the command in a mixed repository prints an accurate summary without failure.
- Totals reconcile with the counts in each requirement kind.
- Exit status signals whether suspect links remain so automation can act on the result.