risk-nexus/README.md

risk-nexus

Risk register and regulatory intake for the estate. Owned by the-custodian.

It does not serve its own site. INTENT.md names risk.coulomb.social as the eventual surface; today public findings and method instruments have permanent addresses through policy-nexus. The source stays here and the published page records its exact source revision.

Holds findings — security, architecture, operational, compliance — with a severity, an owner and a date; decides whether and when each is published; and decides which must reach the operator personally rather than sitting in a register.

It does not fix things: findings route to the repo that owns the defect. It does not host: policy-nexus is the publication surface.

Where things are

• REGISTER.md — the whole register, one screen. Generated; do not edit.
• findings/ — one file per finding. findings/README.md is the filing contract for reporting repos.
• notes/ — seen, deliberately below the floor. Not graded, not reviewed.
• docs/method/ — how this repo decides: severity, disclosure, escalation, review and expiry.
• docs/rulings/ — the reasoning behind each grading, dated.
• workplans/ — the work.

Using it

make                                  # list every target with an example
make list                             # live findings, most severe first
make list SEV=high                    # filter by severity (or SYSTEM=qonto-assistant)
make all                              # include fixed and withdrawn
make show ID=RISK-F-0012              # one finding or regulatory record
make waits                            # who owes what, by default date
make escalations                      # escalations and their delivery state
make policies                         # regulatory records and next reviews
make check                            # full sweep: index, due work, inbox
make checked ID=RISK-F-0012 OUTCOME=clean NOTE="what was seen"
make register                         # rebuild REGISTER.md from findings/

The query targets use tools/risk.py, which is read-only. Its verbs (list, show) are generic so that a future common nexus interface can map onto them. Writes go only through make checked.

make check reports ungraded findings, overdue reviews, stalled remediation, embargoes due for re-decision, escalations awaiting the operator, and what is owed at the production transition. It changes nothing.

All check stages run even when the index is stale; the command still exits nonzero for a failed stage. make due shows the full obligation report and inbox freshness, including full regulatory policies, embargo review deadlines and publication handovers that remain pending after a finding closes. make checked accepts finding, regulatory determination and full policy IDs; it records an actual review, not a repair for an overdue warning.

make fixes distinguishes owner workplans from recorded acceptance obligations. make check and make due also show explicit closure_condition evidence still owed by live findings, even when a source workplan has finished. Acceptance terms and a finished workplan are not proof of runtime closure.

Run make test for isolated regression checks. Python 3 and PyYAML are required.

• Intent: INTENT.md
• Current capability: SCOPE.md