# 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](docs/method/severity.md),
  [disclosure](docs/method/disclosure.md),
  [escalation](docs/method/escalation.md),
  [review and expiry](docs/method/review.md).
- **`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](SCOPE.md)