colregs 0.3.0 → 0.3.2

package/data/applicability.json

@@ -9,47 +9,47 @@
   "rel:overrides": "the superiority relation: the referencing norm's obligation displaces the referenced norm's when both apply"
  },
  "modalities": {
-  "shall": "mandatory",
-  "may": "permitted alternative",
-  "shall-if-practicable": "mandatory where practicable, with a stated fallback",
-  "conditional": "modality depends on facts; see modality_by",
-  "exempt": "the entry relieves a requirement rather than imposing one",
-  "shall-not": "mandatory prohibition",
-  "shall-not-impede": "a distinct duty to avoid impeding another vessel, not a negated shall"
+  "modality:shall": "mandatory",
+  "modality:may": "permitted alternative",
+  "modality:shall-if-practicable": "mandatory where practicable, with a stated fallback",
+  "modality:conditional": "modality depends on facts; see modality_by",
+  "modality:exempt": "the entry relieves a requirement rather than imposing one",
+  "modality:shall-not": "mandatory prohibition",
+  "modality:shall-not-impede": "a distinct duty to avoid impeding another vessel, not a negated shall"
  },
  "categories": {
-  "definition": "produces vocabulary; not evaluated",
-  "standard": "produces technical values (ranges, heights); not evaluated",
-  "scope": "reads visibility, in-sight, jurisdiction; the engine derives which sections apply",
-  "display": "reads one vessel's facts; the engine derives signals and modality",
-  "classification": "reads relative geometry and history; the engine derives encounter type and risk of collision",
-  "precedence": "reads two vessels' facts plus encounter type; the engine derives give-way/stand-on/shall-not-impede/none",
-  "conduct": "reads encounter, role, phase, kinematics and observations; monitored over a trace, not evaluated at a point",
-  "care": "reads anything; produces residual responsibility; represented, never independently evaluated",
-  "meta": "reads the region state; produces a banner and advisories; computed by a solver, reviewed by humans"
+  "category:definition": "produces vocabulary; not evaluated",
+  "category:standard": "produces technical values (ranges, heights); not evaluated",
+  "category:scope": "reads visibility, in-sight, jurisdiction; the engine derives which sections apply",
+  "category:display": "reads one vessel's facts; the engine derives signals and modality",
+  "category:classification": "reads relative geometry and history; the engine derives encounter type and risk of collision",
+  "category:precedence": "reads two vessels' facts plus encounter type; the engine derives give-way/stand-on/shall-not-impede/none",
+  "category:conduct": "reads encounter, role, phase, kinematics and observations; monitored over a trace, not evaluated at a point",
+  "category:care": "reads anything; produces residual responsibility; represented, never independently evaluated",
+  "category:meta": "reads the region state; produces a banner and advisories; computed by a solver, reviewed by humans"
  },
  "effects": {
-  "note": "What a two-subject entry produces. `effect` is {\"own\": <role>, \"other\": <role>} for a `precedence` entry, {\"part\", \"section\", \"applies_rules\"} for a `scope` entry, and for a `classification` entry exactly one of {\"encounter\": <encounter>} or {\"risk_of_collision\": true}. A `display` entry has no `effect`; its output is `lights`. Roles and encounters are closed vocabularies and are not identifiers (docs/identifiers.md, 'What is not an identifier'). Pencil: ADR 0005 and docs/identifiers.md.",
+  "note": "What a two-subject entry produces. `effect` is {\"self\": <role>, \"other\": <role>} for a `category:precedence` entry, {\"part\", \"section\", \"applies_rules\"} for a `category:scope` entry, and for a `category:classification` entry exactly one of {\"encounter\": <encounter>} or {\"risk_of_collision\": true}. A `category:display` entry has no `effect`; its output is `lights`. Roles and encounters are closed vocabularies and are prefixed identifiers (`role:`, `encounter:`; docs/identifiers.md, 'The scheme'). Pencil: ADR 0005 and docs/identifiers.md.",
   "roles": {
-   "give-way": "this subject shall keep out of the way of the other; Rule 16 governs the action",
-   "stand-on": "this subject shall keep her course and speed; Rule 17 governs, including 17(a)(ii) and 17(b)",
-   "shall-not-impede": "this subject shall not impede the other's passage or safe passage; Rule 8(f) governs, and by 8(f)(iii) it confers nothing on the other",
-   "keep-clear": "this subject shall keep well clear of the other and avoid impeding her navigation, outside the give-way/stand-on pairing (18(e), 18(f)(i))",
-   "none": "this paragraph confers no role on this subject. Recorded rather than omitted: `none` on the counterpart of a shall-not-impede duty is the content of 8(f)(iii), and `none` on both sides of a NUC/RAM pair is the content of Rule 18's partial order."
+   "role:give-way": "this subject shall keep out of the way of the other; Rule 16 governs the action",
+   "role:stand-on": "this subject shall keep her course and speed; Rule 17 governs, including 17(a)(ii) and 17(b)",
+   "role:shall-not-impede": "this subject shall not impede the other's passage or safe passage; Rule 8(f) governs, and by 8(f)(iii) it confers nothing on the other",
+   "role:keep-clear": "this subject shall keep well clear of the other and avoid impeding her navigation, outside the give-way/stand-on pairing (18(e), 18(f)(i))",
+   "role:none": "this paragraph confers no role on this subject. Recorded rather than omitted: `role:none` on the counterpart of a shall-not-impede duty is the content of 8(f)(iii), and `role:none` on both sides of a NUC/RAM pair is the content of Rule 18's partial order."
   },
   "encounters": {
-   "head-on": "Rule 14: two power-driven vessels meeting on reciprocal or nearly reciprocal courses",
-   "crossing": "Rule 15: two power-driven vessels crossing. The residual of the other three, derived with `not` rather than written as its own sector, so the four cannot drift apart",
-   "overtaking": "Rule 13: one vessel coming up with another from more than 22.5 degrees abaft her beam, or latched there by 13(d)",
-   "none": "no encounter of Section II's three types. Declared for completeness of the vocabulary; no entry produces it, because an encounter type is asserted by a paragraph and the absence of one is the absence of an entry, not an entry with a null value"
+   "encounter:head-on": "Rule 14: two power-driven vessels meeting on reciprocal or nearly reciprocal courses",
+   "encounter:crossing": "Rule 15: two power-driven vessels crossing. The residual of the other three, derived with `not` rather than written as its own sector, so the four cannot drift apart",
+   "encounter:overtaking": "Rule 13: one vessel coming up with another from more than 22.5 degrees abaft her beam, or held there by 13(d)'s overtaking history",
+   "encounter:none": "no encounter of Section II's three types. Declared for completeness of the vocabulary; no entry produces it, because an encounter type is asserted by a paragraph and the absence of one is the absence of an entry, not an entry with a null value"
   },
-  "classification_shape": "A classification effect carries exactly one key: `encounter`, whose value is one of `encounters` above, or `risk_of_collision`, whose value is `true`. Two shapes rather than one because Rule 7(d) and Rules 13-15 answer two different questions -- does risk exist, and what kind of encounter is this -- and ADR 0005 gives both to `classification`. A single merged shape would have made every encounter entry state a risk it does not decide."
+  "classification_shape": "A classification effect carries exactly one key: `encounter`, whose value is one of `encounters` above, or `risk_of_collision`, whose value is `true`. Two shapes rather than one because Rule 7(d) and Rules 13-15 answer two different questions -- does risk exist, and what kind of encounter is this -- and ADR 0005 gives both to `category:classification`. A single merged shape would have made every encounter entry state a risk it does not decide."
  },
  "known_omissions": [
   {
    "cite": "24(d)",
    "what": "A power-driven vessel to which 24(a) or (c) applies shall also comply with 23(a)(ii) — the second masthead light.",
-   "why": "Not an entry in the settled table; 24a-m2/24a-m3 carry in_lieu_of against 23a1 and 23a2 instead. Recorded here rather than added unilaterally."
+   "why": "Not an entry in the settled table; 24a-m2/24a-m3 carry in_lieu_of against rule:23a_i and rule:23a_ii instead. Recorded here rather than added unilaterally."
   },
   {
    "cite": "24(f), 24(g), 24(h), 24(i)",
@@ -74,26 +74,26 @@
   {
    "cite": "9(d)",
    "what": "A vessel shall not cross a narrow channel or fairway if such crossing impedes the passage of a vessel which can safely navigate only within that channel.",
-   "why": "The duty is conditioned on own crossing the channel, which is a relation between own's heading and the channel's axis. Neither the channel's axis nor 'crossing it' is a fact this package carries, and `pair:env:narrow_channel` is a boolean about the place, not a geometry. No entry rather than an entry whose predicate is not the paragraph's."
+   "why": "The duty is conditioned on self crossing the channel, which is a relation between self's heading and the channel's axis. Neither the channel's axis nor 'crossing it' is a fact this package carries, and `pair:env:narrow_channel` is a boolean about the place, not a geometry. No entry rather than an entry whose predicate is not the paragraph's."
   },
   {
    "cite": "18(d)(ii)",
    "what": "A vessel constrained by her draft shall navigate with particular caution having full regard to her special condition.",
-   "why": "`conduct`, not `precedence`: it prescribes a manner of navigating rather than a role in a pair, and conduct is monitored over a trace rather than evaluated at a point (ADR 0005 sec. 1). No conduct entry shape exists yet."
+   "why": "`category:conduct`, not `category:precedence`: it prescribes a manner of navigating rather than a role in a pair, and conduct is monitored over a trace rather than evaluated at a point (ADR 0005 sec. 1). No conduct entry shape exists yet."
   },
   {
    "cite": "18(e)",
    "what": "A seaplane on the water shall in general keep well clear of all vessels and avoid impeding their navigation; where risk of collision exists she shall comply with Rules 4-19.",
-   "why": "There is no fact for being a seaplane. `fact:propulsion` has power, sail and oars, and Rule 3(a) makes a seaplane a vessel without giving the fact record anywhere to say so. The effect vocabulary has `keep-clear` for it; the predicate does not exist."
+   "why": "There is no fact for being a seaplane. `fact:propulsion` has power, sail and oars, and Rule 3(a) makes a seaplane a vessel without giving the fact record anywhere to say so. The effect vocabulary has `role:keep-clear` for it; the predicate does not exist."
   },
   {
    "cite": "18(f)(ii)",
    "what": "A WIG craft operating on the water surface shall comply with Rules 4-19 as a power-driven vessel.",
-   "why": "Not a precedence norm: it maps a WIG on the surface onto `propulsion:power` for the rest of Part B, which is a classification or a decode-table statement rather than a role in a pair. 18(f)(i) -- the phase that does change the roles -- is entry 18f1."
+   "why": "Not a precedence norm: it maps a WIG on the surface onto `propulsion:power` for the rest of Part B, which is a classification or a decode-table statement rather than a role in a pair. 18(f)(i) -- the phase that does change the roles -- is entry rule:18f_i."
   },
   {
    "cite": "1(a), 1(b), 1(c), 1(d), 1(e), 20(b), 20(c)",
-   "what": "The remaining `scope` paragraphs: the waters the Rules apply to, special rules made by an authority, the adoption of traffic separation schemes, the special-construction determination, and the sunset-to-sunrise and restricted-visibility gates on the light rules.",
+   "what": "The remaining `category:scope` paragraphs: the waters the Rules apply to, special rules made by an authority, the adoption of traffic separation schemes, the special-construction determination, and the sunset-to-sunrise and restricted-visibility gates on the light rules.",
    "why": "None of them reads a fact this package declares. 1(a) needs a fact about the waters; 1(b)/(c)/(e) are about an authority's determination, which is closer to the jurisdiction dimension of ADR 0001 than to a predicate; 1(d) is not addressed to a vessel at all; 20(b)/(c) need time of day and visibility, and applicability.json's `conditions` note already records that night is assumed rather than gated. Deferred to a later PR with 4, 11 and 19(a) landing first."
   },
   {
@@ -109,38 +109,28 @@
   {
    "cite": "14(a)",
    "what": "When two power-driven vessels are meeting on reciprocal or nearly reciprocal courses so as to involve risk of collision each shall alter her course to starboard so that each shall pass on the port side of the other.",
-   "why": "`conduct`, not `classification`: the paragraph states the situation in words and prescribes the action, and 14(b) is the paragraph that deems the situation to exist -- entry 14b cites it. The action is monitored over a trace rather than evaluated at a point (ADR 0005 sec. 1), and no conduct entry shape exists yet. Q-45."
+   "why": "`category:conduct`, not `category:classification`: the paragraph states the situation in words and prescribes the action, and 14(b) is the paragraph that deems the situation to exist -- entry rule:14b cites it. The action is monitored over a trace rather than evaluated at a point (ADR 0005 sec. 1), and no conduct entry shape exists yet. Q-45."
   }
  ],
  "represented_paragraphs": [
   {
-   "id": "2a",
+   "id": "rule:2a",
    "jurisdiction": "intl",
    "cite": "2(a)",
-   "category": "care",
+   "category": "category:care",
    "note": "Residual responsibility for every other paragraph; nothing in this package discharges it, so it is recorded rather than dropped from the model."
   },
   {
-   "id": "2b",
+   "id": "rule:2b",
    "jurisdiction": "intl",
    "cite": "2(b)",
-   "category": "meta",
+   "category": "category:meta",
    "note": "Names the region where a departure from the Rules may be necessary; scoped to level-1/2 invariant violations and computed offline by a solver as a region of situation space, never evaluated here as a predicate."
   }
  ],
- "retired_entry_ids": {
-  "note": "Entry ids that existed and no longer do. REQ-MODEL-10 makes an identifier immutable, which means a retired id is never reused for a different entry -- recorded here so that a later session cannot reuse one by accident. The first four retirements cost no consumer anything since nothing had shipped yet; `14a` is the first to have shipped (v0.1.3), so it is deprecated rather than dropped -- see data/deprecated-identifiers.json.",
-  "ids": {
-   "9b-small": "Collapsed into `9b` when `any_of` gave the predicate language a disjunction; 9(b)'s subject needed two entries only because a `when` was a conjunction.",
-   "9b-sail": "Collapsed into `9b`, same reason.",
-   "10j-small": "Collapsed into `10j`, same reason.",
-   "10j-sail": "Collapsed into `10j`, same reason.",
-   "14a": "Renamed `14b` when the head-on classification moved its cite from 14(a) to 14(b), the deeming paragraph it reads; 14(a) is conduct and is in known_omissions. Shipped in v0.1.3, so it is the first record in data/deprecated-identifiers.json (REQ-MODEL-11). Q-45."
-  }
- },
  "entries": [
   {
-   "id": "23a1",
+   "id": "rule:23a_i",
    "jurisdiction": "intl",
    "cite": "23(a)(i)",
    "when": {
@@ -155,13 +145,13 @@
      "count": 1
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_23_a.png"
    ]
   },
   {
-   "id": "23a2",
+   "id": "rule:23a_ii",
    "jurisdiction": "intl",
    "cite": "23(a)(ii)",
    "when": {
@@ -176,7 +166,7 @@
      "count": 1
     }
    ],
-   "modality": "conditional",
+   "modality": "modality:conditional",
    "modality_by": [
     {
      "when": {
@@ -184,7 +174,7 @@
        "gte": 50
       }
      },
-     "modality": "shall"
+     "modality": "modality:shall"
     },
     {
      "when": {
@@ -192,7 +182,7 @@
        "lt": 50
       }
      },
-     "modality": "may"
+     "modality": "modality:may"
     }
    ],
    "images": [
@@ -201,7 +191,7 @@
    ]
   },
   {
-   "id": "23a34",
+   "id": "rule:23a_iii_iv",
    "jurisdiction": "intl",
    "cite": "23(a)(iii)-(iv)",
    "when": {
@@ -217,10 +207,10 @@
      "light": "light:sternlight"
     }
    ],
-   "modality": "shall"
+   "modality": "modality:shall"
   },
   {
-   "id": "23b",
+   "id": "rule:23b",
    "jurisdiction": "intl",
    "cite": "23(b)",
    "when": {
@@ -238,18 +228,18 @@
     }
    ],
    "rel:includes": [
-    "23a1",
-    "23a2",
-    "23a34"
+    "rule:23a_i",
+    "rule:23a_ii",
+    "rule:23a_iii_iv"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_23_b.png"
    ],
    "notes": "Air-cushion vessel operating in non-displacement mode; in addition to 23(a)."
   },
   {
-   "id": "23c",
+   "id": "rule:23c",
    "jurisdiction": "intl",
    "cite": "23(c)",
    "when": {
@@ -269,15 +259,15 @@
     }
    ],
    "rel:includes": [
-    "23a1",
-    "23a2",
-    "23a34"
+    "rule:23a_i",
+    "rule:23a_ii",
+    "rule:23a_iii_iv"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "notes": "Only when taking off, landing and in flight near the surface."
   },
   {
-   "id": "23d1",
+   "id": "rule:23d_i",
    "jurisdiction": "intl",
    "cite": "23(d)(i)",
    "when": {
@@ -299,17 +289,17 @@
     }
    ],
    "rel:in_lieu_of": [
-    "23a1",
-    "23a2",
-    "23a34"
+    "rule:23a_i",
+    "rule:23a_ii",
+    "rule:23a_iii_iv"
    ],
-   "modality": "may",
+   "modality": "modality:may",
    "images": [
     "NRHB_23_di.png"
    ]
   },
   {
-   "id": "23d2",
+   "id": "rule:23d_ii",
    "jurisdiction": "intl",
    "cite": "23(d)(ii)",
    "when": {
@@ -331,22 +321,22 @@
     },
     {
      "light": "light:sidelights",
-     "modality": "shall-if-practicable"
+     "modality": "modality:shall-if-practicable"
     }
    ],
    "rel:in_lieu_of": [
-    "23a1",
-    "23a2",
-    "23a34"
+    "rule:23a_i",
+    "rule:23a_ii",
+    "rule:23a_iii_iv"
    ],
-   "modality": "may",
+   "modality": "modality:may",
    "images": [
     "NRHB_23_Intl_dii.png"
    ],
    "notes": "The all-round white light is 'may'; the sidelights are 'shall, if practicable' — one paragraph, two modalities."
   },
   {
-   "id": "24a-m2",
+   "id": "rule:24a_i",
    "jurisdiction": "intl",
    "cite": "24(a)(i)",
    "when": {
@@ -363,16 +353,16 @@
     }
    ],
    "rel:in_lieu_of": [
-    "23a1",
-    "23a2"
+    "rule:23a_i",
+    "rule:23a_ii"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_24_a.png"
    ]
   },
   {
-   "id": "24a-m3",
+   "id": "rule:24a_i:exceeds_200m",
    "jurisdiction": "intl",
    "cite": "24(a)(i)",
    "when": {
@@ -389,16 +379,16 @@
     }
    ],
    "rel:in_lieu_of": [
-    "23a1",
-    "23a2"
+    "rule:23a_i",
+    "rule:23a_ii"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_24_av.png"
    ]
   },
   {
-   "id": "24a-rest",
+   "id": "rule:24a_ii_iv",
    "jurisdiction": "intl",
    "cite": "24(a)(ii)-(iv)",
    "when": {
@@ -417,17 +407,17 @@
       "fact:position": "position:underway"
      },
      "rel:includes": [
-      "23a34"
+      "rule:23a_iii_iv"
      ]
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_24_a.png"
    ]
   },
   {
-   "id": "24b",
+   "id": "rule:24b",
    "jurisdiction": "intl",
    "cite": "24(b)",
    "when": {
@@ -441,20 +431,20 @@
       "fact:position": "position:underway"
      },
      "rel:includes": [
-      "23a1",
-      "23a2",
-      "23a34"
+      "rule:23a_i",
+      "rule:23a_ii",
+      "rule:23a_iii_iv"
      ]
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_23_a.png"
    ],
    "notes": "A composite unit is regarded as a power-driven vessel."
   },
   {
-   "id": "24c",
+   "id": "rule:24c",
    "jurisdiction": "intl",
    "cite": "24(c)",
    "when": {
@@ -474,19 +464,19 @@
       "fact:position": "position:underway"
      },
      "rel:includes": [
-      "23a34"
+      "rule:23a_iii_iv"
      ]
     }
    ],
    "rel:in_lieu_of": [
-    "23a1",
-    "23a2"
+    "rule:23a_i",
+    "rule:23a_ii"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "notes": "Also covers towing alongside (towed_alongside=true)."
   },
   {
-   "id": "24e",
+   "id": "rule:24e",
    "jurisdiction": "intl",
    "cite": "24(e)",
    "when": {
@@ -500,14 +490,14 @@
      "light": "light:sternlight"
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_24_e.png"
    ],
    "notes": "Other than the inconspicuous, partly submerged objects of 24(g)."
   },
   {
-   "id": "25a",
+   "id": "rule:25a",
    "jurisdiction": "intl",
    "cite": "25(a)",
    "when": {
@@ -523,13 +513,13 @@
      "light": "light:sternlight"
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_25_a.png"
    ]
   },
   {
-   "id": "25b",
+   "id": "rule:25b",
    "jurisdiction": "intl",
    "cite": "25(b)",
    "when": {
@@ -553,19 +543,19 @@
     }
    ],
    "rel:in_lieu_of": [
-    "25a"
+    "rule:25a"
    ],
    "rel:excludes": [
-    "25c"
+    "rule:25c"
    ],
-   "modality": "may",
+   "modality": "modality:may",
    "images": [
     "NRHB_25_b.png"
    ],
    "notes": "The tricolor: 25(a)'s lights combined in one lantern."
   },
   {
-   "id": "25c",
+   "id": "rule:25c",
    "jurisdiction": "intl",
    "cite": "25(c)",
    "when": {
@@ -588,18 +578,18 @@
     }
    ],
    "rel:includes": [
-    "25a"
+    "rule:25a"
    ],
    "rel:excludes": [
-    "25b"
+    "rule:25b"
    ],
-   "modality": "may",
+   "modality": "modality:may",
    "images": [
     "NRHB_25_c.png"
    ]
   },
   {
-   "id": "25d1",
+   "id": "rule:25d_i",
    "jurisdiction": "intl",
    "cite": "25(d)(i)",
    "when": {
@@ -619,17 +609,17 @@
     }
    ],
    "rel:in_lieu_of": [
-    "25a",
-    "25b"
+    "rule:25a",
+    "rule:25b"
    ],
-   "modality": "shall-if-practicable",
+   "modality": "modality:shall-if-practicable",
    "images": [
     "NRHB_25_d.png"
    ],
    "notes": "25(a) or (b) shall be shown if practicable; the torch is the fallback."
   },
   {
-   "id": "25d2",
+   "id": "rule:25d_ii",
    "jurisdiction": "intl",
    "cite": "25(d)(ii)",
    "when": {
@@ -646,19 +636,19 @@
    "rel:conditional_includes": [
     {
      "one_of": [
-      "25a",
-      "25b"
+      "rule:25a",
+      "rule:25b"
      ]
     }
    ],
-   "modality": "may",
+   "modality": "modality:may",
    "images": [
     "NRHB_25_dii.png"
    ],
    "notes": "No length gate at all: a vessel under oars of any length may show only the torch, where a sailing vessel of 10 m may not."
   },
   {
-   "id": "26b-id",
+   "id": "rule:26b_i",
    "jurisdiction": "intl",
    "cite": "26(b)(i)",
    "when": {
@@ -682,17 +672,17 @@
     }
    ],
    "rel:overrides": [
-    "30a",
-    "30b"
+    "rule:30a",
+    "rule:30b"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_26_b.png"
    ],
    "notes": "Rule 26(a) — 'only the lights prescribed in this Rule' — prevails over Rule 30's anchor lights underway or at anchor (rel:overrides, ADR 0007). Aground is neither (Rule 3(i)); she shows 30(d) alone."
   },
   {
-   "id": "26b-mast",
+   "id": "rule:26b_ii",
    "jurisdiction": "intl",
    "cite": "26(b)(ii)",
    "when": {
@@ -708,7 +698,7 @@
      "count": 1
     }
    ],
-   "modality": "conditional",
+   "modality": "modality:conditional",
    "modality_by": [
     {
      "when": {
@@ -716,7 +706,7 @@
        "gte": 50
       }
      },
-     "modality": "shall"
+     "modality": "modality:shall"
     },
     {
      "when": {
@@ -724,12 +714,12 @@
        "lt": 50
       }
      },
-     "modality": "may"
+     "modality": "modality:may"
     }
    ]
   },
   {
-   "id": "26b-mw",
+   "id": "rule:26b_iii",
    "jurisdiction": "intl",
    "cite": "26(b)(iii)",
    "when": {
@@ -738,15 +728,15 @@
    },
    "lights": [],
    "rel:includes": [
-    "23a34"
+    "rule:23a_iii_iv"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_26_biii.png"
    ]
   },
   {
-   "id": "26c-id",
+   "id": "rule:26c_i",
    "jurisdiction": "intl",
    "cite": "26(c)(i)",
    "when": {
@@ -770,13 +760,13 @@
     }
    ],
    "rel:overrides": [
-    "30a",
-    "30b"
+    "rule:30a",
+    "rule:30b"
    ],
-   "modality": "shall"
+   "modality": "modality:shall"
   },
   {
-   "id": "26c-gear",
+   "id": "rule:26c_ii",
    "jurisdiction": "intl",
    "cite": "26(c)(ii)",
    "when": {
@@ -796,10 +786,10 @@
      "position": "in the direction of the gear"
     }
    ],
-   "modality": "shall"
+   "modality": "modality:shall"
   },
   {
-   "id": "26c-mw",
+   "id": "rule:26c_iii",
    "jurisdiction": "intl",
    "cite": "26(c)(iii)",
    "when": {
@@ -808,15 +798,15 @@
    },
    "lights": [],
    "rel:includes": [
-    "23a34"
+    "rule:23a_iii_iv"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_26_ciii.png"
    ]
   },
   {
-   "id": "27a-id",
+   "id": "rule:27a_i",
    "jurisdiction": "intl",
    "cite": "27(a)(i)",
    "when": {
@@ -831,13 +821,13 @@
      "arrangement": "vertical"
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_27_a.png"
    ]
   },
   {
-   "id": "27a-mw",
+   "id": "rule:27a_iii",
    "jurisdiction": "intl",
    "cite": "27(a)(iii)",
    "when": {
@@ -846,15 +836,15 @@
    },
    "lights": [],
    "rel:includes": [
-    "23a34"
+    "rule:23a_iii_iv"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_27_aiii.png"
    ]
   },
   {
-   "id": "27b-id",
+   "id": "rule:27b_i",
    "jurisdiction": "intl",
    "cite": "27(b)(i)",
    "when": {
@@ -880,11 +870,11 @@
      "position": "lower"
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "notes": "Except a vessel engaged in mine clearance operations (27(f))."
   },
   {
-   "id": "27b-mw",
+   "id": "rule:27b_iii",
    "jurisdiction": "intl",
    "cite": "27(b)(iii)",
    "when": {
@@ -893,17 +883,17 @@
    },
    "lights": [],
    "rel:includes": [
-    "23a1",
-    "23a2",
-    "23a34"
+    "rule:23a_i",
+    "rule:23a_ii",
+    "rule:23a_iii_iv"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_27_biii.png"
    ]
   },
   {
-   "id": "27b-anc",
+   "id": "rule:27b_iv",
    "jurisdiction": "intl",
    "cite": "27(b)(iv)",
    "when": {
@@ -914,18 +904,18 @@
    "rel:conditional_includes": [
     {
      "one_of": [
-      "30a",
-      "30b"
+      "rule:30a",
+      "rule:30b"
      ]
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_27_biv.png"
    ]
   },
   {
-   "id": "27d",
+   "id": "rule:27d",
    "jurisdiction": "intl",
    "cite": "27(d)",
    "when": {
@@ -949,9 +939,9 @@
     }
    ],
    "rel:includes": [
-    "27b-id"
+    "rule:27b_i"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_27_d.png",
     "NRHB_27_diii.png"
@@ -959,7 +949,7 @@
    "notes": "27(d)(iii): when at anchor these lights are shown instead of Rule 30's."
   },
   {
-   "id": "27e",
+   "id": "rule:27e_i",
    "jurisdiction": "intl",
    "cite": "27(e)(i)",
    "when": {
@@ -986,13 +976,13 @@
     }
    ],
    "rel:in_lieu_of": [
-    "27d"
+    "rule:27d"
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "notes": "Only when the vessel's size makes the full 27(d) display impracticable."
   },
   {
-   "id": "27f",
+   "id": "rule:27f",
    "jurisdiction": "intl",
    "cite": "27(f)",
    "when": {
@@ -1012,9 +1002,9 @@
       "fact:position": "position:underway"
      },
      "rel:includes": [
-      "23a1",
-      "23a2",
-      "23a34"
+      "rule:23a_i",
+      "rule:23a_ii",
+      "rule:23a_iii_iv"
      ],
      "cite": "27(f)"
     },
@@ -1023,20 +1013,20 @@
       "fact:position": "position:anchored"
      },
      "one_of": [
-      "30a",
-      "30b"
+      "rule:30a",
+      "rule:30b"
      ],
      "cite": "27(f)"
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_27_f.png"
    ],
    "notes": "27(f) adds the three green lights 'to the lights prescribed for a power-driven vessel in Rule 23 or to the lights or shape prescribed for a vessel at anchor in Rule 30, as appropriate': which set is imported turns on fact:position, so both imports are gated (the 29(a) pattern). The anchored branch is genuine practice, added by A.464(XII) in 1981 — docs/verification/2026-09-05-rule27f-rule28-anchor-scenarios.md, Q1."
   },
   {
-   "id": "28",
+   "id": "rule:28",
    "jurisdiction": "intl",
    "cite": "28",
    "when": {
@@ -1052,18 +1042,18 @@
     }
    ],
    "rel:includes": [
-    "23a1",
-    "23a2",
-    "23a34"
+    "rule:23a_i",
+    "rule:23a_ii",
+    "rule:23a_iii_iv"
    ],
-   "modality": "may",
+   "modality": "modality:may",
    "images": [
     "NRHB_28.png"
    ],
    "notes": "The Rule 23(a) lights are 'shall' (she is a power-driven vessel underway); the three red lights are 'may'. International Rules only. Position is pinned to underway rather than gating the Rule 23 import: 'constrained by her draught' is a status of a vessel navigating (3(h)); the standard commentary and IMO guidance treat the Rule 28 signal as shown only with the underway lights; and Annex I positions the red lights only relative to masthead lights — docs/verification/2026-09-05-rule27f-rule28-anchor-scenarios.md, Q2. A record of activity:cbd at anchor therefore gets Rule 30 alone."
   },
   {
-   "id": "29a",
+   "id": "rule:29a",
    "jurisdiction": "intl",
    "cite": "29(a)",
    "when": {
@@ -1089,7 +1079,7 @@
       "fact:position": "position:underway"
      },
      "rel:includes": [
-      "23a34"
+      "rule:23a_iii_iv"
      ],
      "cite": "29(a)(ii)"
     },
@@ -1098,20 +1088,20 @@
       "fact:position": "position:anchored"
      },
      "one_of": [
-      "30a",
-      "30b"
+      "rule:30a",
+      "rule:30b"
      ],
      "cite": "29(a)(iii)"
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_29_a.png",
     "NRHB_29_aiii.png"
    ]
   },
   {
-   "id": "30a",
+   "id": "rule:30a",
    "jurisdiction": "intl",
    "cite": "30(a)",
    "when": {
@@ -1131,13 +1121,13 @@
      "position": "at or near the stern, at a lower level than the fore one"
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "images": [
     "NRHB_30_d.png"
    ]
   },
   {
-   "id": "30b",
+   "id": "rule:30b",
    "jurisdiction": "intl",
    "cite": "30(b)",
    "when": {
@@ -1155,15 +1145,15 @@
     }
    ],
    "rel:in_lieu_of": [
-    "30a"
+    "rule:30a"
    ],
-   "modality": "may",
+   "modality": "modality:may",
    "images": [
     "NRHB_30_a.png"
    ]
   },
   {
-   "id": "30c",
+   "id": "rule:30c",
    "jurisdiction": "intl",
    "cite": "30(c)",
    "when": {
@@ -1175,7 +1165,7 @@
      "note": "available working or equivalent lights to illuminate her decks"
     }
    ],
-   "modality": "conditional",
+   "modality": "modality:conditional",
    "modality_by": [
     {
      "when": {
@@ -1183,7 +1173,7 @@
        "gte": 100
       }
      },
-     "modality": "shall"
+     "modality": "modality:shall"
     },
     {
      "when": {
@@ -1191,12 +1181,12 @@
        "lt": 100
       }
      },
-     "modality": "may"
+     "modality": "modality:may"
     }
    ]
   },
   {
-   "id": "30d-anchor",
+   "id": "rule:30d",
    "jurisdiction": "intl",
    "cite": "30(d)",
    "when": {
@@ -1206,18 +1196,18 @@
    "rel:conditional_includes": [
     {
      "one_of": [
-      "30a",
-      "30b"
+      "rule:30a",
+      "rule:30b"
      ]
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "notes": "30(d)'s lead-in requires the 30(a)/(b) anchor lights unconditionally, with no length gate; only the two red lights below (30(d)(i)-(ii)) are subject to the 30(f) exemption."
   },
   {
-   "id": "30d-red",
+   "id": "rule:30d_i",
    "jurisdiction": "intl",
-   "cite": "30(d)",
+   "cite": "30(d)(i)",
    "when": {
     "fact:position": "position:aground",
     "fact:length_m": {
@@ -1232,14 +1222,14 @@
      "arrangement": "vertical"
     }
    ],
-   "modality": "shall-if-practicable",
+   "modality": "modality:shall-if-practicable",
    "images": [
     "NRHB_30_dii.png"
    ],
-   "notes": "The two red lights are 'shall, if practicable'. 30(f) exempts vessels under 12 m from them; it does not exempt the 30(a)/(b) anchor lights, see 30d-anchor."
+   "notes": "The two red lights are 'shall, if practicable'. 30(f) exempts vessels under 12 m from them; it does not exempt the 30(a)/(b) anchor lights, see rule:30d."
   },
   {
-   "id": "30e",
+   "id": "rule:30e",
    "jurisdiction": "intl",
    "cite": "30(e)",
    "when": {
@@ -1251,19 +1241,19 @@
    },
    "lights": [],
    "rel:exempts": [
-    "30a",
-    "30b"
+    "rule:30a",
+    "rule:30b"
    ],
-   "modality": "exempt"
+   "modality": "modality:exempt"
   },
   {
-   "id": "4",
+   "id": "rule:4",
    "jurisdiction": "intl",
    "cite": "4",
-   "category": "scope",
+   "category": "category:scope",
    "subjects": 2,
    "when": {},
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
     "part": "B",
     "section": "I",
@@ -1280,15 +1270,15 @@
    "note": "Part B Section I is ungated: the predicate is empty because 'any condition of visibility' is the absence of a condition, not a fact. A scope entry is never a display entry, so an empty `when` selects no lights."
   },
   {
-   "id": "11",
+   "id": "rule:11",
    "jurisdiction": "intl",
    "cite": "11",
-   "category": "scope",
+   "category": "category:scope",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
     "part": "B",
     "section": "II",
@@ -1306,15 +1296,15 @@
    "note": "Rule 3(k)'s in-sight test is a fact of the pair, so Section II is gated on `pair:geo:in_sight` and every Rule 18 entry below repeats that gate rather than relying on the engine to apply this one."
   },
   {
-   "id": "19a",
+   "id": "rule:19a",
    "jurisdiction": "intl",
    "cite": "19(a)",
-   "category": "scope",
+   "category": "category:scope",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": false
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
     "part": "B",
     "section": "III",
@@ -1326,325 +1316,325 @@
    "note": "The complement of 11. Rule 3(l) defines restricted visibility; nothing in facts.json carries it."
   },
   {
-   "id": "18a1",
+   "id": "rule:18a_i",
    "jurisdiction": "intl",
    "cite": "18(a)(i)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:propulsion": "propulsion:power",
-    "own:fact:rule18_class": {
+    "self:fact:propulsion": "propulsion:power",
+    "self:fact:rule18_class": {
      "not": [
       "rule18_class:nuc",
       "rule18_class:ram",
       "rule18_class:fishing"
      ]
     },
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:rule18_class": "rule18_class:nuc",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "rel:overrides": [
-    "15a-give-way"
+    "rule:15a:keep_out_of_the_way"
    ],
-   "note": "Own is 'a power-driven vessel underway' (18(a)) that is not herself ranked by Rule 18 -- written as the negation the paragraph implies rather than as an enumeration of activity values that had to be edited every time the axis grew (Q-33). A vessel constrained by her draught and a WIG craft on the surface are both power-driven and both stay inside it, which is why the gate is `fact:propulsion` plus the negated rank and not `rule18_class:power`: 18(d) protects a CBD vessel, it does not exempt her from 18(a). Overrides `15a-give-way` (Q-40): own and a vessel not under command are both power-driven vessels by 3(b) whenever her machinery is in use, so 15(a) is in force between them as well and would hand the give-way role to whichever has the other on her starboard side, rank or no rank. Rule 18's opening words except Rules 9, 10 and 13 and no others, so this paragraph displaces it."
+   "note": "Self is 'a power-driven vessel underway' (18(a)) that is not herself ranked by Rule 18 -- written as the negation the paragraph implies rather than as an enumeration of activity values that had to be edited every time the axis grew (Q-33). A vessel constrained by her draught and a WIG craft on the surface are both power-driven and both stay inside it, which is why the gate is `fact:propulsion` plus the negated rank and not `rule18_class:power`: 18(d) protects a CBD vessel, it does not exempt her from 18(a). Overrides `rule:15a:keep_out_of_the_way` (Q-40): self and a vessel not under command are both power-driven vessels by 3(b) whenever her machinery is in use, so 15(a) is in force between them as well and would hand the give-way role to whichever has the other on her starboard side, rank or no rank. Rule 18's opening words except Rules 9, 10 and 13 and no others, so this paragraph displaces it."
   },
   {
-   "id": "18a2",
+   "id": "rule:18a_ii",
    "jurisdiction": "intl",
    "cite": "18(a)(ii)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:propulsion": "propulsion:power",
-    "own:fact:rule18_class": {
+    "self:fact:propulsion": "propulsion:power",
+    "self:fact:rule18_class": {
      "not": [
       "rule18_class:nuc",
       "rule18_class:ram",
       "rule18_class:fishing"
      ]
     },
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:rule18_class": "rule18_class:ram",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "rel:overrides": [
-    "15a-give-way"
+    "rule:15a:keep_out_of_the_way"
    ],
-   "note": "Mine clearance (27(f)) and diving (27(e)) reach this entry through `rule18_class:ram`, which decodes them by 3(g), instead of being listed here by hand. That is the display/rank divergence Q-32 named, moved into facts.json. Overrides `15a-give-way` (Q-40): own and a vessel restricted in her ability to manoeuvre are both power-driven vessels by 3(b) whenever her machinery is in use, so 15(a) is in force between them as well and would hand the give-way role to whichever has the other on her starboard side, rank or no rank. Rule 18's opening words except Rules 9, 10 and 13 and no others, so this paragraph displaces it."
+   "note": "Mine clearance (27(f)) and diving (27(e)) reach this entry through `rule18_class:ram`, which decodes them by 3(g), instead of being listed here by hand. That is the display/rank divergence Q-32 named, moved into facts.json. Overrides `rule:15a:keep_out_of_the_way` (Q-40): self and a vessel restricted in her ability to manoeuvre are both power-driven vessels by 3(b) whenever her machinery is in use, so 15(a) is in force between them as well and would hand the give-way role to whichever has the other on her starboard side, rank or no rank. Rule 18's opening words except Rules 9, 10 and 13 and no others, so this paragraph displaces it."
   },
   {
-   "id": "18a3",
+   "id": "rule:18a_iii",
    "jurisdiction": "intl",
    "cite": "18(a)(iii)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:propulsion": "propulsion:power",
-    "own:fact:rule18_class": {
+    "self:fact:propulsion": "propulsion:power",
+    "self:fact:rule18_class": {
      "not": [
       "rule18_class:nuc",
       "rule18_class:ram",
       "rule18_class:fishing"
      ]
     },
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:rule18_class": "rule18_class:fishing",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "rel:overrides": [
-    "15a-give-way"
+    "rule:15a:keep_out_of_the_way"
    ],
-   "note": "`activity:trawling` reaches this entry through the class decode rather than by being listed beside `activity:fishing`; a fishing vessel under sail is `rule18_class:fishing` too, which is 18(c)'s reading of the axis. Overrides `15a-give-way` (Q-40): own and a vessel engaged in fishing are both power-driven vessels by 3(b) whenever her machinery is in use, so 15(a) is in force between them as well and would hand the give-way role to whichever has the other on her starboard side, rank or no rank. Rule 18's opening words except Rules 9, 10 and 13 and no others, so this paragraph displaces it."
+   "note": "`activity:trawling` reaches this entry through the class decode rather than by being listed beside `activity:fishing`; a fishing vessel under sail is `rule18_class:fishing` too, which is 18(c)'s reading of the axis. Overrides `rule:15a:keep_out_of_the_way` (Q-40): self and a vessel engaged in fishing are both power-driven vessels by 3(b) whenever her machinery is in use, so 15(a) is in force between them as well and would hand the give-way role to whichever has the other on her starboard side, rank or no rank. Rule 18's opening words except Rules 9, 10 and 13 and no others, so this paragraph displaces it."
   },
   {
-   "id": "18a4",
+   "id": "rule:18a_iv",
    "jurisdiction": "intl",
    "cite": "18(a)(iv)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:propulsion": "propulsion:power",
-    "own:fact:rule18_class": {
+    "self:fact:propulsion": "propulsion:power",
+    "self:fact:rule18_class": {
      "not": [
       "rule18_class:nuc",
       "rule18_class:ram",
       "rule18_class:fishing"
      ]
     },
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:rule18_class": "rule18_class:sail",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "note": "A sailing vessel that is also fishing decodes to `rule18_class:fishing` and is ranked by 18(a)(iii), so the class alone carries what the old predicate needed a propulsion gate and an activity list to say."
   },
   {
-   "id": "18b1",
+   "id": "rule:18b_i",
    "jurisdiction": "intl",
    "cite": "18(b)(i)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:rule18_class": "rule18_class:sail",
-    "own:fact:position": "position:underway",
+    "self:fact:rule18_class": "rule18_class:sail",
+    "self:fact:position": "position:underway",
     "other:fact:rule18_class": "rule18_class:nuc",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "rel:overrides": [
-    "12a1",
-    "12a2",
-    "12a3"
+    "rule:12a_i",
+    "rule:12a_ii",
+    "rule:12a_iii"
    ],
-   "note": "Own is `rule18_class:sail`, which is 3(c)'s sailing vessel and not a fishing vessel under sail -- the class carries both halves of what the propulsion gate and the activity list used to say between them. Overrides the three Rule 12 entries (Q-40): both subjects can be sailing vessels by 3(c) -- the other under sail and not under command, restricted in her ability to manoeuvre, or engaged in fishing -- so Rule 12 is in force between them too, and Rule 18's chapeau excepts only Rules 9, 10 and 13."
+   "note": "Self is `rule18_class:sail`, which is 3(c)'s sailing vessel and not a fishing vessel under sail -- the class carries both halves of what the propulsion gate and the activity list used to say between them. Overrides the three Rule 12 entries (Q-40): both subjects can be sailing vessels by 3(c) -- the other under sail and not under command, restricted in her ability to manoeuvre, or engaged in fishing -- so Rule 12 is in force between them too, and Rule 18's chapeau excepts only Rules 9, 10 and 13."
   },
   {
-   "id": "18b2",
+   "id": "rule:18b_ii",
    "jurisdiction": "intl",
    "cite": "18(b)(ii)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:rule18_class": "rule18_class:sail",
-    "own:fact:position": "position:underway",
+    "self:fact:rule18_class": "rule18_class:sail",
+    "self:fact:position": "position:underway",
     "other:fact:rule18_class": "rule18_class:ram",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "rel:overrides": [
-    "12a1",
-    "12a2",
-    "12a3"
+    "rule:12a_i",
+    "rule:12a_ii",
+    "rule:12a_iii"
    ],
    "note": "Overrides the three Rule 12 entries (Q-40): both subjects can be sailing vessels by 3(c) -- the other under sail and not under command, restricted in her ability to manoeuvre, or engaged in fishing -- so Rule 12 is in force between them too, and Rule 18's chapeau excepts only Rules 9, 10 and 13."
   },
   {
-   "id": "18b3",
+   "id": "rule:18b_iii",
    "jurisdiction": "intl",
    "cite": "18(b)(iii)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:rule18_class": "rule18_class:sail",
-    "own:fact:position": "position:underway",
+    "self:fact:rule18_class": "rule18_class:sail",
+    "self:fact:position": "position:underway",
     "other:fact:rule18_class": "rule18_class:fishing",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "rel:overrides": [
-    "12a1",
-    "12a2",
-    "12a3"
+    "rule:12a_i",
+    "rule:12a_ii",
+    "rule:12a_iii"
    ],
    "note": "Overrides the three Rule 12 entries (Q-40): both subjects can be sailing vessels by 3(c) -- the other under sail and not under command, restricted in her ability to manoeuvre, or engaged in fishing -- so Rule 12 is in force between them too, and Rule 18's chapeau excepts only Rules 9, 10 and 13."
   },
   {
-   "id": "18c1",
+   "id": "rule:18c_i",
    "jurisdiction": "intl",
    "cite": "18(c)(i)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:rule18_class": "rule18_class:fishing",
-    "own:fact:position": "position:underway",
+    "self:fact:rule18_class": "rule18_class:fishing",
+    "self:fact:position": "position:underway",
     "other:fact:rule18_class": "rule18_class:nuc",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall-if-practicable",
+   "modality": "modality:shall-if-practicable",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "rel:overrides": [
-    "12a1",
-    "12a2",
-    "12a3",
-    "15a-give-way"
+    "rule:12a_i",
+    "rule:12a_ii",
+    "rule:12a_iii",
+    "rule:15a:keep_out_of_the_way"
    ],
-   "note": "'so far as possible' is the practicability qualifier, so the modality is shall-if-practicable. 18(c) does not distinguish propulsion, and `rule18_class:fishing` does not either: a fishing vessel under sail is ranked here. Overrides the three Rule 12 entries (Q-40): a vessel engaged in fishing under sail is a sailing vessel by 3(c), and if the vessel she must keep out of the way of is under sail as well, Rule 12 is in force between them; Rule 18's chapeau excepts only Rules 9, 10 and 13. It overrides `15a-give-way` on the same ground (Q-40): a fishing vessel under power and a vessel not under command under power are two power-driven vessels by 3(b), so Rule 15 is in force between them too."
+   "note": "'so far as possible' is the practicability qualifier, so the modality is shall-if-practicable. 18(c) does not distinguish propulsion, and `rule18_class:fishing` does not either: a fishing vessel under sail is ranked here. Overrides the three Rule 12 entries (Q-40): a vessel engaged in fishing under sail is a sailing vessel by 3(c), and if the vessel she must keep out of the way of is under sail as well, Rule 12 is in force between them; Rule 18's chapeau excepts only Rules 9, 10 and 13. It overrides `rule:15a:keep_out_of_the_way` on the same ground (Q-40): a fishing vessel under power and a vessel not under command under power are two power-driven vessels by 3(b), so Rule 15 is in force between them too."
   },
   {
-   "id": "18c2",
+   "id": "rule:18c_ii",
    "jurisdiction": "intl",
    "cite": "18(c)(ii)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:rule18_class": "rule18_class:fishing",
-    "own:fact:position": "position:underway",
+    "self:fact:rule18_class": "rule18_class:fishing",
+    "self:fact:position": "position:underway",
     "other:fact:rule18_class": "rule18_class:ram",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall-if-practicable",
+   "modality": "modality:shall-if-practicable",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "rel:overrides": [
-    "12a1",
-    "12a2",
-    "12a3",
-    "15a-give-way"
+    "rule:12a_i",
+    "rule:12a_ii",
+    "rule:12a_iii",
+    "rule:15a:keep_out_of_the_way"
    ],
-   "note": "Overrides the three Rule 12 entries (Q-40): a vessel engaged in fishing under sail is a sailing vessel by 3(c), and if the vessel she must keep out of the way of is under sail as well, Rule 12 is in force between them; Rule 18's chapeau excepts only Rules 9, 10 and 13. It overrides `15a-give-way` on the same ground (Q-40): a fishing vessel under power and a vessel restricted in her ability to manoeuvre under power are two power-driven vessels by 3(b), so Rule 15 is in force between them too."
+   "note": "Overrides the three Rule 12 entries (Q-40): a vessel engaged in fishing under sail is a sailing vessel by 3(c), and if the vessel she must keep out of the way of is under sail as well, Rule 12 is in force between them; Rule 18's chapeau excepts only Rules 9, 10 and 13. It overrides `rule:15a:keep_out_of_the_way` on the same ground (Q-40): a fishing vessel under power and a vessel restricted in her ability to manoeuvre under power are two power-driven vessels by 3(b), so Rule 15 is in force between them too."
   },
   {
-   "id": "18d1",
+   "id": "rule:18d_i",
    "jurisdiction": "intl",
    "cite": "18(d)(i)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:rule18_class": {
+    "self:fact:rule18_class": {
      "not": [
       "rule18_class:nuc",
       "rule18_class:ram"
      ]
     },
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:rule18_class": "rule18_class:cbd",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall-if-practicable",
+   "modality": "modality:shall-if-practicable",
    "effect": {
-    "own": "shall-not-impede",
-    "other": "none"
+    "self": "role:shall-not-impede",
+    "other": "role:none"
    },
-   "note": "Own is the paragraph's own subject, verbatim: 'any vessel other than a vessel not under command or a vessel restricted in her ability to manoeuvre'. That is a negation, and it is now written as one (Q-33) instead of as the eight-value positive list it took before. `other` is `none` and not `stand-on`: 18(d) confers no stand-on role, which is the point 8(f)(iii) makes explicit. The modality is `shall-if-practicable` because the duty itself now lives in `effect.own` -- 'shall, if the circumstances of the case admit' is the deontic qualification and `shall-not-impede` is the role, so the two halves the paragraph carries at once are held in two fields rather than fought over in one. That closes 18(d)(i)'s half of Q-31 and leaves the general question open.",
+   "note": "Self is the paragraph's self subject, verbatim: 'any vessel other than a vessel not under command or a vessel restricted in her ability to manoeuvre'. That is a negation, and it is now written as one (Q-33) instead of as the eight-value positive list it took before. `other` is `role:none` and not `role:stand-on`: 18(d) confers no stand-on role, which is the point 8(f)(iii) makes explicit. The modality is `modality:shall-if-practicable` because the duty itself now lives in `effect.self` -- 'shall, if the circumstances of the case admit' is the deontic qualification and `role:shall-not-impede` is the role, so the two halves the paragraph carries at once are held in two fields rather than fought over in one. That closes 18(d)(i)'s half of Q-31 and leaves the general question open.",
    "gap": "18(d)(i) conditions on the CBD vessel 'exhibiting the signals in Rule 28', which is a display fact of the other vessel and is not read here; the entry is that much wider than the paragraph. Q-34."
   },
   {
-   "id": "18f1",
+   "id": "rule:18f_i",
    "jurisdiction": "intl",
    "cite": "18(f)(i)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
-    "own:fact:rule18_class": "rule18_class:wig",
-    "own:fact:position": "position:underway",
+    "self:fact:rule18_class": "rule18_class:wig",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway",
     "pair:geo:in_sight": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "keep-clear",
-    "other": "none"
+    "self": "role:keep-clear",
+    "other": "role:none"
    },
    "rel:overrides": [
-    "18a1",
-    "18a2",
-    "18a3",
-    "18a4",
-    "18d1",
-    "15a-give-way"
+    "rule:18a_i",
+    "rule:18a_ii",
+    "rule:18a_iii",
+    "rule:18a_iv",
+    "rule:18d_i",
+    "rule:15a:keep_out_of_the_way"
    ],
-   "note": "`rule18_class:wig` is the decode of `fact:wig` and `fact:wig_near_surface` together, so the phase gate 18(f)(i) is scoped to is stated once in facts.json rather than as a pair of booleans in every entry that needs it. A WIG craft near the surface still satisfies 18(a)'s predicate -- she is a power-driven vessel underway and the negated rank does not exclude her -- so the rel:overrides against the 18(a) family and 18(d)(i) still carries. `keep-clear` is one effect for the paragraph's two duties, which the effect vocabulary cannot separate. It overrides `15a-give-way` as well (Q-40): a WIG craft operating on the water surface is a power-driven vessel by 3(m), so 15(a) would give her a give-way or stand-on role beside 18(f)(i)'s keep-clear duty -- two helm roles at once, which is the conflict the rank negation on `15a-give-way` used to avoid by keeping her out of Rule 15 altogether."
+   "note": "`rule18_class:wig` is the decode of `fact:wig` and `fact:wig_near_surface` together, so the phase gate 18(f)(i) is scoped to is stated once in facts.json rather than as a pair of booleans in every entry that needs it. A WIG craft near the surface still satisfies 18(a)'s predicate -- she is a power-driven vessel underway and the negated rank does not exclude her -- so the rel:overrides against the 18(a) family and 18(d)(i) still carries. `role:keep-clear` is one effect for the paragraph's two duties, which the effect vocabulary cannot separate. It overrides `rule:15a:keep_out_of_the_way` as well (Q-40): a WIG craft operating on the water surface is a power-driven vessel by 3(m), so 15(a) would give her a give-way or stand-on role beside 18(f)(i)'s keep-clear duty -- two helm roles at once, which is the conflict the rank negation on `rule:15a:keep_out_of_the_way` used to avoid by keeping her out of Rule 15 altogether."
   },
   {
-   "id": "8f3",
+   "id": "rule:8f_iii",
    "jurisdiction": "intl",
    "cite": "8(f)(iii)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
     "pair:geo:risk_of_collision": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "none",
-    "other": "none"
+    "self": "role:none",
+    "other": "role:none"
    },
-   "note": "Recorded as a precedence norm rather than as a rel:overrides. It is not a superiority relation: 8(f)(ii) keeps the impeding vessel's duty alive, so nothing is displaced. What 8(f)(iii) does is deny the not-to-be-impeded vessel any role -- `none` on both sides -- so that shall-not-impede is never read as conferring stand-on.",
+   "note": "Recorded as a precedence norm rather than as a rel:overrides. It is not a superiority relation: 8(f)(ii) keeps the impeding vessel's duty alive, so nothing is displaced. What 8(f)(iii) does is deny the not-to-be-impeded vessel any role -- `role:none` on both sides -- so that shall-not-impede is never read as conferring stand-on.",
    "gap": "The paragraph's antecedent is 'a vessel, the passage of which is not to be impeded'. That is the output of another norm, not a fact, and a precedence predicate reads only facts. The `when` is therefore the risk-of-collision half alone, which makes this entry wider than the paragraph: it applies to any pair with risk of collision. Kept wide and recorded rather than narrowed by inventing a fact.",
    "no_gate_note": "No in-sight gate: Rule 4 puts Rules 4-10 in any condition of visibility."
   },
   {
-   "id": "13a",
+   "id": "rule:13a",
    "jurisdiction": "intl",
    "cite": "13(a)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": true,
@@ -1660,152 +1650,152 @@
       "other:hist:was_overtaking": false
      },
      {
-      "own:hist:was_overtaking": true
+      "self:hist:was_overtaking": true
      }
     ],
     "other:fact:position": "position:underway"
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "rel:overrides": [
-    "18a1",
-    "18a2",
-    "18a3",
-    "18a4",
-    "18b1",
-    "18b2",
-    "18b3",
-    "18c1",
-    "18c2",
-    "18d1",
-    "18f1",
-    "12a1",
-    "12a2",
-    "12a3"
-   ],
-   "note": "Categorised `precedence`, not `classification` as ADR 0005 sec. 1 and the proposal's first-cut table have it. 13(a) is the one paragraph of Rule 13 that assigns a role, and a `classification` entry has no field to put a role in; 13(b)'s sector test is the classification and is what sets the latch. Q-14 settles membership paragraph by paragraph and this is one of them. The predicate now carries both halves of 'any vessel overtaking any other': the 13(b) sector, which 13b-overtaking classifies, and the 13(d) latch, which 13d classifies. They are a disjunction, which is what the entry could not write before the predicate language grew `any_of` (Q-33). Now also overrides the three Rule 12 entries: 'notwithstanding anything contained in' the Rules of Part B Sections I and II includes Rule 12, and two sailing vessels in an overtaking would otherwise hold 13(a)'s and 12(a)'s roles at once (Q-40). The sector branch now also reads `other:hist:was_overtaking: false`, so it cannot newly name a second give-way vessel while the other side already holds 13(d)'s latch -- once overtaking, always overtaking, on whichever vessel history says holds the role (Q-47).",
-   "gap": "Only own's side. 13(a) lays the duty on the overtaking vessel, so this entry is directional by design and the overtaken vessel's stand-on role comes from the same entry read on the swapped situation. What it still cannot say is 13(c) -- a vessel in any doubt as to whether she is overtaking shall assume that she is -- because doubt is a state of the observer and no fact carries it; and it inherits 13b-overtaking's speed-comparison gap. Q-41, Q-46."
-  },
-  {
-   "id": "9b",
+    "rule:18a_i",
+    "rule:18a_ii",
+    "rule:18a_iii",
+    "rule:18a_iv",
+    "rule:18b_i",
+    "rule:18b_ii",
+    "rule:18b_iii",
+    "rule:18c_i",
+    "rule:18c_ii",
+    "rule:18d_i",
+    "rule:18f_i",
+    "rule:12a_i",
+    "rule:12a_ii",
+    "rule:12a_iii"
+   ],
+   "note": "Categorised `category:precedence`, not `category:classification` as ADR 0005 sec. 1 and the proposal's first-cut table have it. 13(a) is the one paragraph of Rule 13 that assigns a role, and a `category:classification` entry has no field to put a role in; 13(b)'s sector test is the classification and is what starts the overtaking history. Q-14 settles membership paragraph by paragraph and this is one of them. The predicate now carries both halves of 'any vessel overtaking any other': the 13(b) sector, which rule:13b classifies, and 13(d)'s overtaking history, which rule:13d classifies. They are a disjunction, which is what the entry could not write before the predicate language grew `any_of` (Q-33). Now also overrides the three Rule 12 entries: 'notwithstanding anything contained in' the Rules of Part B Sections I and II includes Rule 12, and two sailing vessels in an overtaking would otherwise hold 13(a)'s and 12(a)'s roles at once (Q-40). The sector branch now also reads `other:hist:was_overtaking: false`, so it cannot newly name a second give-way vessel while the other side already holds 13(d)'s overtaking history -- once overtaking, always overtaking, on whichever vessel history says holds the role (Q-47).",
+   "gap": "Only self's side, directional by design -- but not, as once claimed here, recoverable by reading this entry with the vessels swapped: Q-47's `other:hist:was_overtaking: false` guard blocks that swapped read once the overtaking history is set, so nothing today names the overtaken vessel stand-on from this entry. Also cannot say 13(c) (doubt is not a fact) and inherits rule:13b's speed-comparison gap. Q-41, Q-46."
+  },
+  {
+   "id": "rule:9b",
    "jurisdiction": "intl",
    "cite": "9(b)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
     "pair:env:narrow_channel": true,
     "any_of": [
      {
-      "own:fact:length_m": {
+      "self:fact:length_m": {
        "lt": 20
       }
      },
      {
-      "own:fact:propulsion": "propulsion:sail"
+      "self:fact:propulsion": "propulsion:sail"
      }
     ],
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway",
     "other:fact:confined_to_channel": true
    },
-   "modality": "shall-not-impede",
+   "modality": "modality:shall-not-impede",
    "effect": {
-    "own": "shall-not-impede",
-    "other": "none"
+    "self": "role:shall-not-impede",
+    "other": "role:none"
    },
    "rel:overrides": [
-    "18a4"
+    "rule:18a_iv"
    ],
    "note": "9(b)'s subject is disjunctive -- 'a vessel of less than 20 metres in length or a sailing vessel' -- and used to take two entries, `9b-small` and `9b-sail`, because a `when` was a conjunction. `any_of` is that disjunction (Q-33), so the paragraph is one entry again and the entry id is the plain citation-derived one. The two suffixed ids are retired and not reused (REQ-MODEL-10). The gate is `fact:propulsion` and not `rule18_class:sail`: 9(b)'s subject is a sailing vessel in the ordinary sense and 9(c) covers fishing vessels separately, so borrowing Rule 18's rank here would quietly move a fishing vessel under sail from one paragraph to the other. `other:fact:confined_to_channel` closes Q-34: the entry now reads which vessel the paragraph protects instead of assuming it from the encounter being in a channel at all."
   },
   {
-   "id": "9c",
+   "id": "rule:9c",
    "jurisdiction": "intl",
    "cite": "9(c)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
     "pair:env:narrow_channel": true,
-    "own:fact:rule18_class": "rule18_class:fishing",
-    "own:fact:position": "position:underway",
+    "self:fact:rule18_class": "rule18_class:fishing",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway"
    },
-   "modality": "shall-not-impede",
+   "modality": "modality:shall-not-impede",
    "effect": {
-    "own": "shall-not-impede",
-    "other": "none"
+    "self": "role:shall-not-impede",
+    "other": "role:none"
    },
    "rel:overrides": [
-    "18a3",
-    "18b3"
+    "rule:18a_iii",
+    "rule:18b_iii"
    ],
    "note": "Reverses 18(a)(iii) and 18(b)(iii) inside a narrow channel: 9(c)'s object is 'any other vessel navigating within a narrow channel or fairway', so unlike 9(b) it needs no further fact about the other vessel."
   },
   {
-   "id": "10i",
+   "id": "rule:10i",
    "jurisdiction": "intl",
    "cite": "10(i)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
     "pair:env:traffic_lane": true,
-    "own:fact:rule18_class": "rule18_class:fishing",
-    "own:fact:position": "position:underway",
+    "self:fact:rule18_class": "rule18_class:fishing",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway",
     "other:fact:following_traffic_lane": true
    },
-   "modality": "shall-not-impede",
+   "modality": "modality:shall-not-impede",
    "effect": {
-    "own": "shall-not-impede",
-    "other": "none"
+    "self": "role:shall-not-impede",
+    "other": "role:none"
    },
    "rel:overrides": [
-    "18a3",
-    "18b3"
+    "rule:18a_iii",
+    "rule:18b_iii"
    ],
    "note": "`other:fact:following_traffic_lane` closes Q-34: the entry now reads which vessel the paragraph protects instead of assuming it from the encounter being in a lane at all."
   },
   {
-   "id": "10j",
+   "id": "rule:10j",
    "jurisdiction": "intl",
    "cite": "10(j)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
     "pair:env:traffic_lane": true,
     "any_of": [
      {
-      "own:fact:length_m": {
+      "self:fact:length_m": {
        "lt": 20
       }
      },
      {
-      "own:fact:propulsion": "propulsion:sail"
+      "self:fact:propulsion": "propulsion:sail"
      }
     ],
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:propulsion": "propulsion:power",
     "other:fact:position": "position:underway",
     "other:fact:following_traffic_lane": true
    },
-   "modality": "shall-not-impede",
+   "modality": "modality:shall-not-impede",
    "effect": {
-    "own": "shall-not-impede",
-    "other": "none"
+    "self": "role:shall-not-impede",
+    "other": "role:none"
    },
    "rel:overrides": [
-    "18a4"
+    "rule:18a_iv"
    ],
-   "note": "The same collapse as 9b, and the same disjunctive subject. 10(j)'s object is narrower than 9(b)'s -- a power-driven vessel -- so `other:fact:propulsion` is read. `10j-small` and `10j-sail` are retired and not reused. `other:fact:following_traffic_lane` closes Q-34, same as 10i."
+   "note": "The same collapse as rule:9b, and the same disjunctive subject. 10(j)'s object is narrower than 9(b)'s -- a power-driven vessel -- so `other:fact:propulsion` is read. `10j-small` and `10j-sail` are retired and not reused. `other:fact:following_traffic_lane` closes Q-34, same as rule:10i."
   },
   {
-   "id": "7d1",
+   "id": "rule:7d_i",
    "jurisdiction": "intl",
    "cite": "7(d)(i)",
-   "category": "classification",
+   "category": "category:classification",
    "subjects": 2,
    "when": {
     "pair:geo:bearing_change_deg_min": {
@@ -1816,7 +1806,7 @@
      "gt": 0
     }
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
     "risk_of_collision": true
    },
@@ -1825,176 +1815,161 @@
    "no_gate_note": "No in-sight gate: Rule 4 puts Rules 4-10 in any condition of visibility."
   },
   {
-   "id": "12a1",
+   "id": "rule:12a_i",
    "jurisdiction": "intl",
    "cite": "12(a)(i)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": true,
     "pair:geo:risk_of_collision": true,
-    "own:fact:propulsion": "propulsion:sail",
+    "self:fact:propulsion": "propulsion:sail",
     "other:fact:propulsion": "propulsion:sail",
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway",
-    "own:kin:wind_side": "wind_side:port",
+    "self:kin:wind_side": "wind_side:port",
     "other:kin:wind_side": "wind_side:starboard"
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
-   "note": "Each has the wind on a different side, so the vessel with the wind on the port side keeps out of the way. Evaluated from own's side, so the mirror case -- own on starboard, other on port -- is this same entry read on the swapped situation, and it is what makes the other vessel stand-on. 'Two sailing vessels' is 3(c), so both subjects are gated on `fact:propulsion: propulsion:sail` and not on `rule18_class:sail` (Q-40): a vessel engaged in fishing under sail, or not under command under sail, is a sailing vessel by 3(c) and is inside Rule 12. Where Rule 18 also ranks the pair -- 18(b) from the ordinary sailing vessel's side, 18(c) from the fishing vessel's -- that entry carries `rel:overrides` against this one, because Rule 18's opening words except Rules 9, 10 and 13 and no others; 13(a)'s 'notwithstanding' overrides it the same way. Between two sailing vessels Rule 18 leaves unordered -- one not under command and one restricted in her ability to manoeuvre -- this entry is the only norm in force, and it lays a helm duty on a vessel that may be unable to discharge it; that is Rule 2's region and is recorded in Q-40 rather than gated away."
+   "note": "Each has the wind on a different side, so the vessel with the wind on the port side keeps out of the way. Evaluated from self's side, so the mirror case -- self on starboard, other on port -- is this same entry read on the swapped situation, and it is what makes the other vessel stand-on. 'Two sailing vessels' is 3(c), so both subjects are gated on `fact:propulsion: propulsion:sail` and not on `rule18_class:sail` (Q-40): a vessel engaged in fishing under sail, or not under command under sail, is a sailing vessel by 3(c) and is inside Rule 12. Where Rule 18 also ranks the pair -- 18(b) from the ordinary sailing vessel's side, 18(c) from the fishing vessel's -- that entry carries `rel:overrides` against this one, because Rule 18's opening words except Rules 9, 10 and 13 and no others; 13(a)'s 'notwithstanding' overrides it the same way. Between two sailing vessels Rule 18 leaves unordered -- one not under command and one restricted in her ability to manoeuvre -- this entry is the only norm in force, and it lays a helm duty on a vessel that may be unable to discharge it; that is Rule 2's region and is recorded in Q-40 rather than gated away."
   },
   {
-   "id": "12a2",
+   "id": "rule:12a_ii",
    "jurisdiction": "intl",
    "cite": "12(a)(ii)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": true,
     "pair:geo:risk_of_collision": true,
-    "own:fact:propulsion": "propulsion:sail",
+    "self:fact:propulsion": "propulsion:sail",
     "other:fact:propulsion": "propulsion:sail",
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway",
-    "own:geo:windward": true,
+    "self:geo:windward": true,
     "any_of": [
      {
-      "own:kin:wind_side": "wind_side:port",
+      "self:kin:wind_side": "wind_side:port",
       "other:kin:wind_side": "wind_side:port"
      },
      {
-      "own:kin:wind_side": "wind_side:starboard",
+      "self:kin:wind_side": "wind_side:starboard",
       "other:kin:wind_side": "wind_side:starboard"
      }
     ]
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
    "note": "Both have the wind on the same side, so the windward vessel keeps clear. 'The same side' is a comparison between two facts and the predicate language compares a fact to a constant, so the disjunction is written out over the two values the comparison can take -- which is why `wind_side:unknown` on either subject falls through to 12(a)(iii) rather than into this entry. 'Two sailing vessels' is 3(c), so both subjects are gated on `fact:propulsion: propulsion:sail` and not on `rule18_class:sail` (Q-40): a vessel engaged in fishing under sail, or not under command under sail, is a sailing vessel by 3(c) and is inside Rule 12. Where Rule 18 also ranks the pair -- 18(b) from the ordinary sailing vessel's side, 18(c) from the fishing vessel's -- that entry carries `rel:overrides` against this one, because Rule 18's opening words except Rules 9, 10 and 13 and no others; 13(a)'s 'notwithstanding' overrides it the same way. Between two sailing vessels Rule 18 leaves unordered -- one not under command and one restricted in her ability to manoeuvre -- this entry is the only norm in force, and it lays a helm duty on a vessel that may be unable to discharge it; that is Rule 2's region and is recorded in Q-40 rather than gated away."
   },
   {
-   "id": "12a3",
+   "id": "rule:12a_iii",
    "jurisdiction": "intl",
    "cite": "12(a)(iii)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": true,
     "pair:geo:risk_of_collision": true,
-    "own:fact:propulsion": "propulsion:sail",
+    "self:fact:propulsion": "propulsion:sail",
     "other:fact:propulsion": "propulsion:sail",
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway",
-    "own:kin:wind_side": "wind_side:port",
+    "self:kin:wind_side": "wind_side:port",
     "other:kin:wind_side": "wind_side:unknown",
     "other:geo:windward": true
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
-   "note": "The doubt case, and the one paragraph of Rule 12 that is expressible only because uncertainty is a declared value of the fact rather than the fact's absence. `wind_side:unknown` on the other subject is 'cannot determine with certainty', and an absent fact would have been the wrong model for it: absent satisfies nothing, so silence would have relieved own of a duty the paragraph imposes. This is the shape 13(c) and 14(c) would need and do not have -- Q-41. 'Two sailing vessels' is 3(c), so both subjects are gated on `fact:propulsion: propulsion:sail` and not on `rule18_class:sail` (Q-40): a vessel engaged in fishing under sail, or not under command under sail, is a sailing vessel by 3(c) and is inside Rule 12. Where Rule 18 also ranks the pair -- 18(b) from the ordinary sailing vessel's side, 18(c) from the fishing vessel's -- that entry carries `rel:overrides` against this one, because Rule 18's opening words except Rules 9, 10 and 13 and no others; 13(a)'s 'notwithstanding' overrides it the same way. Between two sailing vessels Rule 18 leaves unordered -- one not under command and one restricted in her ability to manoeuvre -- this entry is the only norm in force, and it lays a helm duty on a vessel that may be unable to discharge it; that is Rule 2's region and is recorded in Q-40 rather than gated away."
+   "note": "The doubt case, and the one paragraph of Rule 12 that is expressible only because uncertainty is a declared value of the fact rather than the fact's absence. `wind_side:unknown` on the other subject is 'cannot determine with certainty', and an absent fact would have been the wrong model for it: absent satisfies nothing, so silence would have relieved self of a duty the paragraph imposes. This is the shape 13(c) and 14(c) would need and do not have -- Q-41. 'Two sailing vessels' is 3(c), so both subjects are gated on `fact:propulsion: propulsion:sail` and not on `rule18_class:sail` (Q-40): a vessel engaged in fishing under sail, or not under command under sail, is a sailing vessel by 3(c) and is inside Rule 12. Where Rule 18 also ranks the pair -- 18(b) from the ordinary sailing vessel's side, 18(c) from the fishing vessel's -- that entry carries `rel:overrides` against this one, because Rule 18's opening words except Rules 9, 10 and 13 and no others; 13(a)'s 'notwithstanding' overrides it the same way. Between two sailing vessels Rule 18 leaves unordered -- one not under command and one restricted in her ability to manoeuvre -- this entry is the only norm in force, and it lays a helm duty on a vessel that may be unable to discharge it; that is Rule 2's region and is recorded in Q-40 rather than gated away."
   },
   {
-   "id": "13b-overtaking",
+   "id": "rule:13b",
    "jurisdiction": "intl",
    "cite": "13(b)",
-   "category": "classification",
+   "category": "category:classification",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": true,
-    "other:geo:rel_bearing_deg": {
-     "gt": 112.5,
-     "lt": 247.5
-    },
-    "pair:geo:tcpa_s": {
-     "gt": 0
-    },
-    "own:fact:position": "position:underway",
-    "other:fact:position": "position:underway"
-   },
-   "modality": "shall",
-   "effect": {
-    "encounter": "overtaking"
-   },
-   "note": "own is the overtaking vessel: own bears in the other's stern sector. 13(b) is the deeming paragraph and therefore the classification, which is the half of Q-37 PR #24 left open. It is written twice, once per subject, because the encounter type is a property of the pair and not of one vessel: a vessel being overtaken is in an overtaking, and reading only `other:geo:rel_bearing_deg` would have classified her side of the same encounter as a crossing. Which vessel carries the duty is 13(a)'s question, not this one's.",
-   "gap": "'Coming up with' is a comparison of the two vessels' speeds, and a predicate compares a fact to a constant, never one fact to another. `pair:geo:tcpa_s` positive stands in for it: the closest point of approach is still ahead, so the pair is closing, and closing from abaft the beam is coming up. A vessel drawing away astern is excluded, which is the case that mattered; a pair closing because the vessel ahead has stopped is not, and is classified as an overtaking. Q-46."
-  },
-  {
-   "id": "13b-overtaken",
-   "jurisdiction": "intl",
-   "cite": "13(b)",
-   "category": "classification",
-   "subjects": 2,
-   "when": {
-    "pair:geo:in_sight": true,
-    "own:geo:rel_bearing_deg": {
-     "gt": 112.5,
-     "lt": 247.5
-    },
+    "any_of": [
+     {
+      "other:geo:rel_bearing_deg": {
+       "gt": 112.5,
+       "lt": 247.5
+      }
+     },
+     {
+      "self:geo:rel_bearing_deg": {
+       "gt": 112.5,
+       "lt": 247.5
+      }
+     }
+    ],
     "pair:geo:tcpa_s": {
      "gt": 0
     },
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway"
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "encounter": "overtaking"
+    "encounter": "encounter:overtaking"
    },
-   "note": "own is the vessel being overtaken: the other bears in own's stern sector. 13(b) is the deeming paragraph and therefore the classification, which is the half of Q-37 PR #24 left open. It is written twice, once per subject, because the encounter type is a property of the pair and not of one vessel: a vessel being overtaken is in an overtaking, and reading only `other:geo:rel_bearing_deg` would have classified her side of the same encounter as a crossing. Which vessel carries the duty is 13(a)'s question, not this one's.",
-   "gap": "'Coming up with' is a comparison of the two vessels' speeds, and a predicate compares a fact to a constant, never one fact to another. `pair:geo:tcpa_s` positive stands in for it: the closest point of approach is still ahead, so the pair is closing, and closing from abaft the beam is coming up. A vessel drawing away astern is excluded, which is the case that mattered; a pair closing because the vessel ahead has stopped is not, and is classified as an overtaking. Q-46."
+   "note": "The deeming paragraph, and therefore the classification -- the half of Q-37 left open when 13(a) took the role. One symmetric entry: the encounter type belongs to the pair, so the sector is read on either subject under `any_of` -- self is in an overtaking whether she is coming up with the other or being come up with. Reading aspect alone would classify the overtaken vessel's side of the same encounter as a crossing. Which vessel carries the duty is 13(a)'s question.",
+   "gap": "'Coming up with' is a comparison of the two vessels' speeds, and a predicate compares a fact to a constant, never one fact to another. `pair:geo:tcpa_s` positive stands in: the closest point of approach is still ahead, so the pair is closing, and closing from abaft the beam is coming up. A vessel drawing away astern is excluded, which is the case that mattered; a pair closing because the vessel ahead has stopped is not. Q-46."
   },
   {
-   "id": "13d",
+   "id": "rule:13d",
    "jurisdiction": "intl",
    "cite": "13(d)",
-   "category": "classification",
+   "category": "category:classification",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": true,
     "any_of": [
      {
-      "own:hist:was_overtaking": true
+      "self:hist:was_overtaking": true
      },
      {
       "other:hist:was_overtaking": true
      }
     ],
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway"
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "encounter": "overtaking"
+    "encounter": "encounter:overtaking"
    },
-   "note": "The latch, and the reason `hist` is a fact class rather than a note. Once either vessel has been the overtaking vessel the encounter stays an overtaking whatever the bearing does next, so this entry reads history alone and no geometry at all. It is the counterpart of the `hist:was_overtaking: false` gate on 14b and 15a-crossing: without both halves the drawn-out bearing would produce a head-on or a crossing beside the overtaking, which is exactly the reclassification 13(d) forbids. `pair:geo:in_sight` stays in the gate; a Rule 19(d)(i) entry reads `hist:was_overtaking` directly (Q-49).",
-   "gap": "'Until she is finally past and clear' is the paragraph's own end condition and nothing in the fact vocabulary carries it, so in this model the latch never clears. A consumer sets and clears `hist:was_overtaking` itself. Recorded rather than approximated with a range or a bearing: past and clear is a seamanship judgement, and inventing a threshold for it would be the kind of number Q-40's neighbours are about. Q-47."
+   "note": "Overtaking history, and the reason `hist` is a fact class rather than a note. Once either vessel has been the overtaking vessel the encounter stays an overtaking whatever the bearing does next, so this entry reads history alone and no geometry at all. It is the counterpart of the `hist:was_overtaking: false` gate on rule:14b and rule:15a:crossing: without both halves the drawn-out bearing would produce a head-on or a crossing beside the overtaking, which is exactly the reclassification 13(d) forbids. `pair:geo:in_sight` stays in the gate; a Rule 19(d)(i) entry reads `hist:was_overtaking` directly (Q-49).",
+   "gap": "'Until she is finally past and clear' is the paragraph's self end condition and nothing in the fact vocabulary carries it, so in this model overtaking history never clears. A consumer sets and clears `hist:was_overtaking` itself. Recorded rather than approximated with a range or a bearing: past and clear is a seamanship judgement, and inventing a threshold for it would be the kind of number Q-40's neighbours are about. Q-47."
   },
   {
-   "id": "14b",
+   "id": "rule:14b",
    "jurisdiction": "intl",
    "cite": "14(b)",
-   "category": "classification",
+   "category": "category:classification",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": true,
     "pair:geo:risk_of_collision": true,
-    "own:fact:propulsion": "propulsion:power",
+    "self:fact:propulsion": "propulsion:power",
     "other:fact:propulsion": "propulsion:power",
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway",
-    "own:hist:was_overtaking": false,
+    "self:hist:was_overtaking": false,
     "other:hist:was_overtaking": false,
-    "own:geo:rel_bearing_deg": {
+    "self:geo:rel_bearing_deg": {
      "any_of": [
       {
        "lte": 11.25
@@ -2015,29 +1990,29 @@
      ]
     }
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "encounter": "head-on"
+    "encounter": "encounter:head-on"
    },
-   "note": "14(b)'s deeming test: both vessels see the other ahead or nearly ahead. Both bearings are read, not one: a single vessel with the other fine on the bow is not a head-on situation unless she is also fine on the other's bow, and reading one bearing alone would have swallowed part of the crossing sector. The half-angle is declared once in facts.json `situation.constants.head_on_half_angle_deg`. Cites 14(b) and not 14(a) because the deeming paragraph is the classification, exactly as 13b-overtaking and 13b-overtaken cite 13(b): 14(a) states the situation in words -- 'reciprocal or nearly reciprocal courses' -- and imposes the duty, each shall alter her course to starboard, which is `conduct`, is not modelled, and is in known_omissions. Q-45.",
+   "note": "14(b)'s deeming test: both vessels see the other ahead or nearly ahead. Both bearings are read, not one: a single vessel with the other fine on the bow is not a head-on situation unless she is also fine on the other's bow, and reading one bearing alone would have swallowed part of the crossing sector. The half-angle is declared once in facts.json `situation.constants.head_on_half_angle_deg`. Cites 14(b) and not 14(a) because the deeming paragraph is the classification, exactly as rule:13b and rule:13b cite 13(b): 14(a) states the situation in words -- 'reciprocal or nearly reciprocal courses' -- and imposes the duty, each shall alter her course to starboard, which is `category:conduct`, is not modelled, and is in known_omissions. Q-45.",
    "gap": "The history gates are 13(d)'s, not Rule 14's, and they are what keeps the three encounter types a partition -- their price is that a situation which omits `hist:was_overtaking` is classified as no encounter at all rather than as a head-on. Q-43."
   },
   {
-   "id": "15a-crossing",
+   "id": "rule:15a:crossing",
    "jurisdiction": "intl",
    "cite": "15(a)",
-   "category": "classification",
+   "category": "category:classification",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": true,
     "pair:geo:risk_of_collision": true,
-    "own:fact:propulsion": "propulsion:power",
+    "self:fact:propulsion": "propulsion:power",
     "other:fact:propulsion": "propulsion:power",
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway",
-    "own:hist:was_overtaking": false,
+    "self:hist:was_overtaking": false,
     "other:hist:was_overtaking": false,
-    "own:geo:rel_bearing_deg": {
+    "self:geo:rel_bearing_deg": {
      "not": {
       "gt": 112.5,
       "lt": 247.5
@@ -2051,7 +2026,7 @@
     },
     "any_of": [
      {
-      "own:geo:rel_bearing_deg": {
+      "self:geo:rel_bearing_deg": {
        "not": {
         "any_of": [
          {
@@ -2080,29 +2055,29 @@
      }
     ]
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "encounter": "crossing"
+    "encounter": "encounter:crossing"
    },
-   "note": "The residual, and derived rather than written as its own sector. Not overtaking is `not` over the very constraint 13b-overtaking uses, on both subjects, so the sector and its complement cannot drift apart and the 112.5 edge lands in exactly one of them. Not head-on is `not` over 14b's cone, on either subject -- the negation of a conjunction, which is why it is an `any_of` and not two constraints. Nothing here enumerates a crossing sector, and that is the point: the only way for the three encounter types to overlap or to leave a bearing unclassified is for someone to edit one of the two constraints without editing the other, and there is only one of each.",
-   "gap": "15(a) says 'two power-driven vessels', which this reads as 3(b)'s definition and nothing more, so a vessel not under command is inside it -- she is power-driven. That is deliberate for the classification: the encounter really is a crossing. `15a-give-way` reads 3(b) the same way and no longer gates on rank either (Q-40): where Rule 18 ranks the pair it is the Rule 18 entry's `rel:overrides` that displaces the role, which is the half of the encounter Rule 18 reaches. The geometry is not that half, and no entry now says otherwise in two places."
+   "note": "The residual, and derived rather than written as its own sector. Not overtaking is `not` over the very constraint rule:13b uses, on both subjects, so the sector and its complement cannot drift apart and the 112.5 edge lands in exactly one of them. Not head-on is `not` over rule:14b's cone, on either subject -- the negation of a conjunction, which is why it is an `any_of` and not two constraints. Nothing here enumerates a crossing sector, and that is the point: the only way for the three encounter types to overlap or to leave a bearing unclassified is for someone to edit one of the two constraints without editing the other, and there is only one of each.",
+   "gap": "15(a) says 'two power-driven vessels', which this reads as 3(b)'s definition and nothing more, so a vessel not under command is inside it -- she is power-driven. That is deliberate for the classification: the encounter really is a crossing. `rule:15a:keep_out_of_the_way` reads 3(b) the same way and no longer gates on rank either (Q-40): where Rule 18 ranks the pair it is that entry's `rel:overrides` that displaces the role."
   },
   {
-   "id": "15a-give-way",
+   "id": "rule:15a:keep_out_of_the_way",
    "jurisdiction": "intl",
    "cite": "15(a)",
-   "category": "precedence",
+   "category": "category:precedence",
    "subjects": 2,
    "when": {
     "pair:geo:in_sight": true,
     "pair:geo:risk_of_collision": true,
-    "own:fact:propulsion": "propulsion:power",
+    "self:fact:propulsion": "propulsion:power",
     "other:fact:propulsion": "propulsion:power",
-    "own:fact:position": "position:underway",
+    "self:fact:position": "position:underway",
     "other:fact:position": "position:underway",
-    "own:hist:was_overtaking": false,
+    "self:hist:was_overtaking": false,
     "other:hist:was_overtaking": false,
-    "own:geo:rel_bearing_deg": {
+    "self:geo:rel_bearing_deg": {
      "gt": 0,
      "lte": 112.5
     },
@@ -2114,7 +2089,7 @@
     },
     "any_of": [
      {
-      "own:geo:rel_bearing_deg": {
+      "self:geo:rel_bearing_deg": {
        "not": {
         "any_of": [
          {
@@ -2143,16 +2118,16 @@
      }
     ]
    },
-   "modality": "shall",
+   "modality": "modality:shall",
    "effect": {
-    "own": "give-way",
-    "other": "stand-on"
+    "self": "role:give-way",
+    "other": "role:stand-on"
    },
-   "note": "The role half of 15(a): the vessel which has the other on her own starboard side keeps out of the way. Own's bearing constraint is the starboard half of the non-overtaking sector, and its upper edge is the same declared constant 13b reads, so it is not a hand-listed sector either; the partition test asserts that this entry selects exactly the crossings in which the other bears between 0 and 180 relative, which is what makes the shorthand checkable rather than trusted. 'Two power-driven vessels' is 3(b) and nothing more, so both subjects are gated on `fact:propulsion: propulsion:power` and on no Rule 18 rank (Q-40): a vessel engaged in fishing, not under command, restricted in her ability to manoeuvre or constrained by her draught is a power-driven vessel whenever her machinery is in use, and is inside Rule 15. Where Rule 18 also ranks the pair, that entry carries `rel:overrides` against this one -- 18(a)(i)-(iii) from the unranked vessel's side, 18(c)(i)-(ii) from the fishing vessel's, 18(f)(i) from the WIG craft's -- because Rule 18's opening words except Rules 9, 10 and 13 and no others; 13(a)'s 'notwithstanding' would override it the same way, and does not need to, because this entry's bearing gates and its `hist:was_overtaking: false` already exclude every overtaking. Where Rule 18 leaves the pair unordered -- two vessels engaged in fishing, or one not under command and one restricted in her ability to manoeuvre -- this entry is the only norm in force, and it lays a helm duty on a vessel that may be unable to discharge it; that is Rule 2's region and is recorded in Q-40 rather than gated away.",
-   "gap": "15(a)'s second duty -- 'shall, if the circumstances of the case admit, avoid crossing ahead of the other vessel' -- is `conduct` with a practicability caveat, and neither half fits a precedence entry. It is dropped here, which is Q-31's shape again: the caveat has no field to move into unless the duty happens to be a role, and this one is an action."
+   "note": "The role half of 15(a): the vessel which has the other on her own starboard side keeps out of the way. Self's bearing constraint is the starboard half of the non-overtaking sector, and its upper edge is the same declared constant 13b reads, so it is not a hand-listed sector either; the partition test asserts that this entry selects exactly the crossings in which the other bears between 0 and 180 relative, which is what makes the shorthand checkable rather than trusted. 'Two power-driven vessels' is 3(b) and nothing more, so both subjects are gated on `fact:propulsion: propulsion:power` and on no Rule 18 rank (Q-40): a vessel engaged in fishing, not under command, restricted in her ability to manoeuvre or constrained by her draught is a power-driven vessel whenever her machinery is in use, and is inside Rule 15. Where Rule 18 also ranks the pair, that entry carries `rel:overrides` against this one -- 18(a)(i)-(iii) from the unranked vessel's side, 18(c)(i)-(ii) from the fishing vessel's, 18(f)(i) from the WIG craft's -- because Rule 18's opening words except Rules 9, 10 and 13 and no others; 13(a)'s 'notwithstanding' would override it the same way, and does not need to, because this entry's bearing gates and its `hist:was_overtaking: false` already exclude every overtaking. Where Rule 18 leaves the pair unordered -- two vessels engaged in fishing, or one not under command and one restricted in her ability to manoeuvre -- this entry is the only norm in force, and it lays a helm duty on a vessel that may be unable to discharge it; that is Rule 2's region and is recorded in Q-40 rather than gated away.",
+   "gap": "15(a)'s second duty -- 'shall, if the circumstances of the case admit, avoid crossing ahead of the other vessel' -- is `category:conduct` with a practicability caveat, and neither half fits a precedence entry. It is dropped here, which is Q-31's shape again: the caveat has no field to move into unless the duty happens to be a role, and this one is an action."
   },
   {
-   "id": "30a-buoy",
+   "id": "rule:30a:mooring_buoy",
    "jurisdiction": "us/inland",
    "cite": "30(a)",
    "when": {
@@ -2173,11 +2148,11 @@
      "position": "at or near the stern, at a lower level than the fore one"
     }
    ],
-   "modality": "shall",
+   "modality": "modality:shall",
    "note": "33 CFR 90.5 deems a vessel made fast to a mooring buoy to be a vessel at anchor, so Inland Rule 30(a) reaches her. The Convention has no such deeming provision: under intl she is 'moored' by Rule 3(i) and no paragraph prescribes lights for her."
   },
   {
-   "id": "30b-buoy",
+   "id": "rule:30b:mooring_buoy",
    "jurisdiction": "us/inland",
    "cite": "30(b)",
    "when": {
@@ -2196,10 +2171,10 @@
     }
    ],
    "rel:in_lieu_of": [
-    "30a-buoy"
+    "rule:30a:mooring_buoy"
    ],
-   "modality": "may",
-   "note": "The under-50 m alternative, on the same 33 CFR 90.5 deeming that brings 30a-buoy in. It is a separate entry because widening 30b's predicate would edit an intl entry to carry a national delta, which REQ-SCOPE-4 forbids."
+   "modality": "modality:may",
+   "note": "The under-50 m alternative, on the same 33 CFR 90.5 deeming that brings rule:30a:mooring_buoy in. It is a separate entry because widening rule:30b's predicate would edit an intl entry to carry a national delta, which REQ-SCOPE-4 forbids."
   }
  ]
 }