[dmarx]

This is stacked on #378. Merge that first; this PR's base will then move to main.

Why

The export's citations table had one binary column, excused, set to 1 when a directive acknowledges the citation. It could not tell apart five situations the lint already distinguishes:

• the cited document is in force;
• a directive acknowledges the citation;
• a lint.inactive_ok rule (Add lint.inactive_ok: pattern rules for citations of retired documents that need no acknowledgement #378) sanctions it;
• it is retired and nothing acknowledges it;
• the code resolves to no document.

In-force sites and unacknowledged ones both exported as excused = 0, and a sanctioned site looked unacknowledged.

What

• New column standing TEXT NOT NULL: one of in-force, acknowledged, sanctioned, unacknowledged or dangling. A dangling site under unresolved-ok is acknowledged.
• New column excused_by TEXT: what clears the site. It is inactive-ok @ path:line for a directive (or inactive-ok-file, or unresolved-ok), lint.inactive_ok[N] for a rule, and NULL when nothing clears it.
• excused generalized: it is now 1 when a directive or a rule excuses the site.
• One source. The standing is derived once, in ref_status (Citation.standing, Citation.cleared_by), from the same scan the lint reads. export.py only copies the values out (DP-004). Citation now keeps two facts the scan already had and was dropping: whether the code resolves, and whether the cited document is in force.

mention-ok sites

• A mention-ok over a document in force leaves the site in-force, with excused = 1 and excused_by naming the mention, since a mention claims nothing about status.
• Over a retired or dangling target, the mention answers the finding, so the site is acknowledged.
• Where a rule also matches, the rule wins in both standing and excused_by.

Record

• ADR ADR-tmptj3j3 records the change of meaning for excused and the rejected alternatives: keeping excused as it was and adding only standing; dropping excused; deriving the standing in export.py.
• A changelog fragment and a devlog entry.
• docs/cli.md describes the new columns.

Tests

• Written first and seen to fail. They cover each of the five standings, excused_by for a directive and for a rule, excused = 1 for both acknowledged and sanctioned sites, the mention-ok cases, and Citation.standing itself.
• Full suite: 1884 passed, 33 skipped.
• luria lint gives the same findings as before.

---

Generated by Claude Code