Chirality Agent User Manual · Edition 4 · Accepted 10 October 2026 · Source 22dd62a7f0 ↗ · Markdown
4. Query dependencies
Run the deliverable CLI from the repository root. It requires Python 3 and PyYAML. The CLI reports JSON and does not maintain a generated register.
python3 -m tools.deliverables --project projects/chirality-app-v4 neighborhood DEL-07-02
python3 -m tools.deliverables --project projects/chirality-piping neighborhood DEL-04-01
| Command | What it establishes |
|---|---|
neighborhood <DEL> |
Declared direct inputs and consumers. |
impact <DEL> |
Declared downstream reach, including non-gating relationships. |
touches <rev or PR:n> |
Relevant deliverables for changed code paths; missing mappings remain visible. |
dag-diff <tag> |
Declaration changes against a baseline revision. |
check |
Structural errors, unresolved references and reported cycles. |
A single Git revision supplied to touches means that commit's changes, not the difference between that revision and the working tree. A PR reference requires authenticated gh access. The CLI README defines the supported forms and current limits.
Each need identifies a supplier and a condition. Optional fields describe timing, gating and evidence. The consumer maintains its needs; reverse links are derived. Update unchanged rows only when their meaning actually changes.
A present file proves presence, not suitability. A merge proves integration, not acceptance or fulfillment. The agent must inspect the relevant condition and evidence. The tool does not infer that a test passed or a deliverable is complete.
check rejects malformed metadata and escaping paths. It reports unresolved suppliers, planned paths and cycles without treating them as automatic failures. Missing edges do not prove independence. Examine shared interfaces, code and resources before dividing work.
A baseline tag supports comparison and recovery. It does not approve every future dependency change. Ordinary changes do not require a new tag or a currency packet. Preserve actual owner holds and specific adopted acceptance requirements.