explico 0.7.0 → 0.11.0

package/dist/rules/rules.schema.json

@@ -0,0 +1,1072 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$comment": "Generated by scripts/gen-rules-schema.mjs from src/rules/catalog.ts — do not edit.",
+  "title": "Rules",
+  "description": "Authoring rules this course turns off or tunes, by rule ID. List only what differs from the defaults: every rule is on, with the defaults shown, until a block here says otherwise. A locked rule has no `enabled`. Invariants (always-on syntax checks) are not listed. See docs/authoring/README.md for the index.",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "N9": {
+      "title": "N9 — A quantity/unit/operator is typeset in `$…$`, never as plain text",
+      "description": "Never write `45 m/s`, `t (s)`, `vx` or `KE/m` as plain text, and never spell a stated quantity's unit out: \"4 seconds\", \"2 meters per second squared\", \"30 degrees\", \"$x = 3$ meters\" are `$4\\ \\text{s}$`, `$2\\ \\text{m/s}^2$`, `$30^{\\circ}$`, `$x = 3\\ \\text{m}$`. A unit inside math is `\\text{}`-wrapped, short form, in the same span as its number or symbol. A unit named on its own (\"measured in meters\") stays a word; a sentence that defines a unit is waived. JSX prop strings (`caption=\"…\"`) and assessment choice labels render no math, so N9 does not apply there.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose",
+        "assessment",
+        "table"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/notation.md#n9",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        },
+        "allow": {
+          "title": "Unit words prose may spell out",
+          "description": "Unit words (`hour`, `minute`) this course lets prose write out next to a number or `per`, singular or plural. Every other unit in `unit-words.ts` must be a symbol in `$…$`.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        }
+      }
+    },
+    "N14": {
+      "title": "N14 — An abbreviation-shaped word in prose is universal, or explained",
+      "description": "An all-caps or dotted token in prose (`OLS`, `w.r.t.`) is on the shipped list (plus `allow`) or has an entry in `content/abbreviations/`.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/notation.md#n14",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        },
+        "allow": {
+          "title": "Also allow",
+          "description": "Abbreviations this course treats as universal, in addition to the shipped list.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        },
+        "deny": {
+          "title": "Always explain",
+          "description": "Shipped abbreviations this course still wants explained.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        }
+      }
+    },
+    "S5": {
+      "title": "S5 — A sign / perspective convention is declared once and cited elsewhere",
+      "description": "Prose that states a sign / cash-flow-perspective convention resolves it to the single declaration — the `conventions.signConventionKey` notation entry (`[[key]]`) or the `conventions.cashFlowPerspectiveCompetency` competency — rather than restating it.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/structure-rules.md#s5",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "S8": {
+      "title": "S8 — Prefer `<Memo>` over a Starlight aside when the content needs an anchor, a caption or collapsing",
+      "description": "A `:::note`/`:::tip`/`:::caution`/`:::danger` (or `<Aside>`) is a short callout read in passing: no number, no link, never folded. Anything a reader may want to cite, skip or come back to is a `<Memo id=\"…\">`.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/structure-rules.md#s8",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "P1": {
+      "title": "P1 — \"or\" never introduces a second name for the same thing",
+      "description": "“The residual, or error, is …” introduces a synonym; pick one name and use it. “or” joins alternatives, not names.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/prose.md#p1",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "P2": {
+      "title": "P2 — One term for each concept, repeated — no synonyms for variety",
+      "description": "Say “residual” every time; never rotate synonyms for variety.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/prose.md#p2",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "P3": {
+      "title": "P3 — One meaning for each term; no technical term in its everyday sense",
+      "description": "A technical term keeps its technical meaning on the page; do not also use it in its everyday sense (“significant”, “normal”).",
+      "x-element": "prose",
+      "x-elements": [
+        "prose"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/prose.md#p3",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "P4": {
+      "title": "P4 — Use the established term; define it where the argument first needs it",
+      "description": "Prefer the field’s standard term over a coined one, and define it at first use — not earlier in a glossary paragraph, not later.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/prose.md#p4",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "P5": {
+      "title": "P5 — Main text is literal: no idioms, metaphors, buzzwords, entertainment",
+      "description": "Main text states facts and steps plainly; no “let’s dive in”, no metaphor, no joke. An aside may be lighter.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/prose.md#p5",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "P6": {
+      "title": "P6 — Industry jargon only in an optional \"Industry jargon\" aside",
+      "description": "Use the textbook term in the argument; list the trade’s words for it in an “Industry jargon” aside if the reader will meet them.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/prose.md#p6",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "P7": {
+      "title": "P7 — One claim per sentence; every logical link stated",
+      "description": "One assertion per sentence; “because”, “so”, “therefore” are written out, never left for the reader to infer.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/prose.md#p7",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "P8": {
+      "title": "P8 — Words for a relation match the math exactly (\"proportional to\")",
+      "description": "“Proportional to” means `y = kx`; “grows with” means monotone; “depends on” means a function of. Match the words to the formula.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose",
+        "math"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/prose.md#p8",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "P9": {
+      "title": "P9 — A display equation's lead-in says what it gives and where it comes from",
+      "description": "The sentence before a display equation names the quantity it yields and the step or law it follows from — not “we have:”.",
+      "x-element": "prose",
+      "x-elements": [
+        "prose",
+        "equation"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/prose.md#p9",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "N2": {
+      "title": "N2 — A reserved spelling is used only for its reserved meaning",
+      "description": "The `reserved` setting is this course’s table of spellings that are fixed to one meaning — nothing else may use them, and they need no notation key. Every *other* styled letter (`\\mathbb{E}`, `\\mathcal{L}`, an italic `d` used as a variable) is an ordinary symbol that needs a notation entry of its own, even when the plain letter has one (N4).",
+      "x-element": "math",
+      "x-elements": [
+        "math"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/notation.md#n2",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        },
+        "reserved": {
+          "title": "Reserved spellings",
+          "description": "One `<latex> — <meaning>` line per spelling this course fixes to a single meaning, printed on the rules-in-effect page so an author or an agent reads the table without opening the rule page. Nothing checks it — which spelling was chosen is caught in review; rule N4’s gate only asks that a glyph resolve. Replace the shipped list to change the conventions: drop the probability lines in a course with no probability, or write `\\mathcal{N}(\\mu, \\sigma)` for a course that parameterises the normal by standard deviation.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": [
+            "\\mathbb{N} — the natural numbers",
+            "\\mathbb{Z} — the integers",
+            "\\mathbb{R} — the reals",
+            "\\mathbb{C} — the complex numbers",
+            "\\mathbb{P} — probability",
+            "\\mathcal{N}(\\mu, \\sigma^2) — the normal distribution (mean, variance)",
+            "\\mathrm{d} — the differential"
+          ]
+        }
+      }
+    },
+    "N4": {
+      "title": "N4 — One meaning per glyph; define once; `[[key]]` before first math",
+      "description": "Every glyph in rendered math resolves to exactly one notation entry on the page: introduce it with `[[key]]` in prose before its first `$…$`, define a page-local one in `notation.local`, or bind a compound with `\\explain{key}{latex}`. Do not reuse a glyph for a second meaning on the same page. Locked — the notation layer is this rule — an unresolved glyph has no hover card and the render path needs every glyph bound.",
+      "x-element": "math",
+      "x-elements": [
+        "math",
+        "notation"
+      ],
+      "x-enforcement": "locked",
+      "x-doc": "docs/authoring/notation.md#n4",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "N8": {
+      "title": "N8 — A named operator is universal (shipped/course list) or explained",
+      "description": "An operator such as `\\sin` or `\\operatorname{Var}` is either on the shipped universal list (plus the course’s `allow` list) or has a notation entry. The `deny` list forces an entry for a shipped one.",
+      "x-element": "math",
+      "x-elements": [
+        "math",
+        "notation"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/notation.md#n8",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        },
+        "allow": {
+          "title": "Also allow",
+          "description": "Operators this course treats as universal, in addition to the shipped list.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        },
+        "deny": {
+          "title": "Always explain",
+          "description": "Shipped operators this course still wants explained.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        }
+      }
+    },
+    "N10": {
+      "title": "N10 — A multi-letter label is `\\mathrm{…}`, and universal or explained",
+      "description": "Write a word-like label inside math as `\\mathrm{KE}`, `v_{\\mathrm{max}}` — never a bare run of italic letters, which reads as a product. The label itself is on the shipped list (plus `allow`) or has a notation entry: the glyph resolver skips a `\\mathrm{}` body, so nothing else gives it a hover card. Not checked by the build: that a bare multi-letter run was wrapped in `\\mathrm{…}` at all — rule N4’s gate reports it as unresolved one-letter symbols, which is a different message for the same mistake.",
+      "x-element": "math",
+      "x-elements": [
+        "math",
+        "notation"
+      ],
+      "x-enforcement": "partial",
+      "x-doc": "docs/authoring/notation.md#n10",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        },
+        "allow": {
+          "title": "Also allow",
+          "description": "Roman labels this course treats as universal, in addition to the shipped list.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        },
+        "deny": {
+          "title": "Always explain",
+          "description": "Shipped roman labels this course still wants explained.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        }
+      }
+    },
+    "N11": {
+      "title": "N11 — A worked example never drops a unit from a substituted value",
+      "description": "When numbers replace symbols, every value keeps its unit (`$v = 3\\ \\text{m/s} \\cdot 4\\ \\text{s}$`), and the result’s unit follows from them.",
+      "x-element": "math",
+      "x-elements": [
+        "math",
+        "prose"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/notation.md#n11",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "N12": {
+      "title": "N12 — Math syntax never carries the sentence's own trailing punctuation",
+      "description": "Math, and each row before a `\\\\`, never ends in `.`, `,`, `;` or `:` — the sentence’s own punctuation goes after the closing `$`, or is dropped after a display block. A trailing decimal point (`5.`) and a typed `...` count too. The only exception is an upright dotted abbreviation that is notation (`\\text{h.c.}`): the shipped list plus `allow`.",
+      "x-element": "math",
+      "x-elements": [
+        "math",
+        "prose",
+        "assessment"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/notation.md#n12",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        },
+        "allow": {
+          "title": "Also allow",
+          "description": "Dotted abbreviations this course sets as notation at the end of math (`\\text{w.p.}`), in addition to the shipped `a.e.`, `a.s.`, `c.c.`, `const.`, `h.c.`, `i.i.d.`.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        },
+        "deny": {
+          "title": "Never allow",
+          "description": "Shipped abbreviations this course does not accept at the end of math.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        }
+      }
+    },
+    "N13": {
+      "title": "N13 — A nonlinear function always takes a parenthesized argument",
+      "description": "Write `\\sin(x)`, `\\ln(t)`, `f(x)` — never `\\sin x`. Locked — the glyph resolver cannot tell where an unparenthesized argument ends, so it cannot bind the symbols inside it.",
+      "x-element": "math",
+      "x-elements": [
+        "math"
+      ],
+      "x-enforcement": "locked",
+      "x-doc": "docs/authoring/notation.md#n13",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "N15": {
+      "title": "N15 — A nested `(`, `[`, `{`, or `|` must use scalable sizing",
+      "description": "Inside another delimiter pair, write `\\left( … \\right)`, `\\left| … \\right|`; a bare nested `|` or `(` fails the build. Locked — a bare `|` is both an opener and a closer; nested, the resolver cannot pair it, so the rule is a parsing precondition.",
+      "x-element": "math",
+      "x-elements": [
+        "math"
+      ],
+      "x-enforcement": "locked",
+      "x-doc": "docs/authoring/notation.md#n15",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {}
+    },
+    "N17": {
+      "title": "N17 — A delimiter’s shape is semantic; a nest is engine-sized, not hand-sized",
+      "description": "Keep the shape each delimiter has for its meaning — an interval `[a, b)`, a norm `\\|·\\|`, a set `\\{…\\}`, a parenthesis for grouping — and never swap shapes (`( [ \\{ … \\} ] )`) to mark depth. Depth is size: write `\\left`/`\\right` at every level and let the engine size them, never `\\bigl…\\bigr` and friends inside a nest. Not checked by the build: the shape half — `delimiter-manual-size` parses sizing syntax only, and never decides whether a bracket is semantic. A bare nested delimiter is rule N15’s error instead.",
+      "x-element": "math",
+      "x-elements": [
+        "math"
+      ],
+      "x-enforcement": "partial",
+      "x-doc": "docs/authoring/notation.md#n17",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "N22": {
+      "title": "N22 — An accent or mark is an operator: universal, explained, or a whole form",
+      "description": "A decoration (`\\hat`, `\\bar`, `\\overline`, `'`, `^*`, `^\\dagger`, …) is on the course’s `allow` list (shipped empty), explained by an operator entry (`latex: \\hat{}`), or the decorated form has its own entry (`latex: \\hat{\\beta}`), which wins for that form. A page may suspend a decoration in `notation.suspend`, with a `reason`; every decorated form of it there then needs its own entry.",
+      "x-element": "math",
+      "x-elements": [
+        "math",
+        "notation"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/notation.md#n22",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        },
+        "allow": {
+          "title": "Also allow",
+          "description": "Decorations this course treats as universal, in addition to the shipped list.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        },
+        "deny": {
+          "title": "Always explain",
+          "description": "Shipped decorations this course still wants explained.",
+          "type": "array",
+          "items": {
+            "title": "Entry",
+            "type": "string",
+            "minLength": 1
+          },
+          "default": []
+        }
+      }
+    },
+    "N5": {
+      "title": "N5 — Referenced display equations carry `\\label{eq:key}`",
+      "description": "Label a display equation with `\\label{eq:key}` when — and only when — prose refers back to it with `[[eq-key]]`. A label nothing references is noise. Not checked by the build: that a referenced-in-prose equation actually carries a label.",
+      "x-element": "equation",
+      "x-elements": [
+        "equation"
+      ],
+      "x-enforcement": "partial",
+      "x-doc": "docs/authoring/notation.md#n5",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "N18": {
+      "title": "N18 — A multi-step derivation is one aligned chain; reasons follow `\\qquad`",
+      "description": "A derivation is one `aligned` block: each step on its own line, `&=` at the relation, the reason after `\\qquad` on the same line — not a run of separate display equations.",
+      "x-element": "equation",
+      "x-elements": [
+        "equation"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/notation.md#n18",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "N19": {
+      "title": "N19 — A notation entry states `units` from the vocabulary, or `dimensionless`",
+      "description": "Every notation entry has `units:` from `units-vocab.ts` (`m/s`, `s`, `kg`, …) or `dimensionless: true`. A token outside the vocabulary is a warning.",
+      "x-element": "notation",
+      "x-elements": [
+        "notation"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/notation.md#n19",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "N20": {
+      "title": "N20 — A notation entry's source citation carries a locator",
+      "description": "Each item in a notation entry’s `sources` names the place in the source (`locator: \"§3.2\"`, `\"p. 41\"`), not just the source id.",
+      "x-element": "notation",
+      "x-elements": [
+        "notation",
+        "source"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/notation.md#n20",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "N21": {
+      "title": "N21 — A gloss is named by a short noun phrase, not a sentence",
+      "description": "A gloss `label` names the symbol in a few words (“launch angle”); a clause, sentence punctuation, or a definition belongs in a full notation entry instead.",
+      "x-element": "notation",
+      "x-elements": [
+        "notation"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/notation.md#n21",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "S1": {
+      "title": "S1 — No heading, short caption or short-note title over 65 characters",
+      "description": "A Markdown heading, the `short` caption of a `Figure`, `Diagram`, `Table`, `Memo` or `CompactExamples`, an equation’s `\\caption{}` and a `ShortNote` `title` are short noun phrases of at most `maxLength` characters; the claim goes in the prose or the long `caption`, which is never measured. Not checked by the build: a lesson’s `frontmatter.title` — the gate scans the body only.",
+      "x-element": "heading",
+      "x-elements": [
+        "heading"
+      ],
+      "x-enforcement": "partial",
+      "x-doc": "docs/authoring/structure-rules.md#s1",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        },
+        "maxLength": {
+          "title": "Maximum length",
+          "description": "Characters a heading or short caption may run to.",
+          "type": "integer",
+          "minimum": 20,
+          "default": 65
+        }
+      }
+    },
+    "S6": {
+      "title": "S6 — Headings descend one level at a time, from `##`",
+      "description": "The page title is the lesson’s only `#`, so the body’s first heading is `##`, and each heading is at most one level deeper than the one before it (`##` → `###`, never `##` → `####`); going back up any number of levels is fine. A knowledge check’s and a worked-example set’s heading count as a `##`.",
+      "x-element": "heading",
+      "x-elements": [
+        "heading"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/structure-rules.md#s6",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "S7": {
+      "title": "S7 — A heading is followed by body content, never by another heading",
+      "description": "Write body content — at least a sentence on what the section is about — between a heading and the next one, whatever their levels. `<AssessmentSet />` and `<CompactExamples>` draw an `<h2>` of their own, so no heading goes directly above either.",
+      "x-element": "heading",
+      "x-elements": [
+        "heading"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/structure-rules.md#s7",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "S2": {
+      "title": "S2 — A part page carries a `<PartBridge>` (earlier parts → this one) and a `<PartScope>` paragraph",
+      "description": "A `content/docs/<dir>/index.mdx` has one `<PartBridge>` paragraph (optional on the first part) then one `<PartScope>` paragraph, each inside the word range, before `<PartOverview />`. Keep a blank line inside each tag. Not checked by the build: what each paragraph says — the gate cannot tell a bridge that links the parts from one that does not.",
+      "x-element": "part-page",
+      "x-elements": [
+        "part-page"
+      ],
+      "x-enforcement": "partial",
+      "x-doc": "docs/authoring/structure-rules.md#s2",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        },
+        "bridgeMinWords": {
+          "title": "Bridge: minimum words",
+          "description": "Fewest words the `<PartBridge>` paragraph may have.",
+          "type": "integer",
+          "minimum": 1,
+          "default": 30
+        },
+        "bridgeMaxWords": {
+          "title": "Bridge: maximum words",
+          "description": "Most words the `<PartBridge>` paragraph may have.",
+          "type": "integer",
+          "minimum": 1,
+          "default": 150
+        },
+        "scopeMinWords": {
+          "title": "Scope: minimum words",
+          "description": "Fewest words the `<PartScope>` paragraph may have.",
+          "type": "integer",
+          "minimum": 1,
+          "default": 30
+        },
+        "scopeMaxWords": {
+          "title": "Scope: maximum words",
+          "description": "Most words the `<PartScope>` paragraph may have.",
+          "type": "integer",
+          "minimum": 1,
+          "default": 150
+        }
+      }
+    },
+    "V2": {
+      "title": "V2 — Static charts: SVG → D3 → Observable Plot, chosen per figure",
+      "description": "For a static chart pick the lightest tool that draws it: inline SVG, then D3, then Observable Plot. State the choice in the figure’s source comment.",
+      "x-element": "plot",
+      "x-elements": [
+        "plot"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/visualizations.md#v2",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "V3": {
+      "title": "V3 — Interactive figures: a hydrated island + the `renderLabMath` seam",
+      "description": "An interactive figure is an island under `content/labs/` inside a `<Figure>`, renders its equations through `renderLabMath`, and labels its controls; the figure’s caption is its name, so the lab writes no accessible name or text alternative of its own.",
+      "x-element": "plot",
+      "x-elements": [
+        "plot"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/visualizations.md#v3",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "V4": {
+      "title": "V4 — Randomised figures expose an adjustable, deterministic seed",
+      "description": "Randomness in a figure comes from a seed the reader can see and change; the same seed always draws the same picture.",
+      "x-element": "plot",
+      "x-elements": [
+        "plot"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/visualizations.md#v4",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "V5": {
+      "title": "V5 — Axis ranges span the first 10 seeds at the current control values",
+      "description": "Fix each axis range so the drawings for seeds 1…`seeds` all fit at the current control values; the axes do not jump when the seed changes.",
+      "x-element": "plot",
+      "x-elements": [
+        "plot"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/visualizations.md#v5",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        },
+        "seeds": {
+          "title": "Seeds spanned",
+          "description": "How many leading seeds an axis range must accommodate.",
+          "type": "integer",
+          "minimum": 1,
+          "default": 10
+        }
+      }
+    },
+    "V6": {
+      "title": "V6 — Every quantitative axis shows at least three labelled values",
+      "description": "Each numeric axis carries at least `minLabels` tick labels, so a reader can read a value off the chart.",
+      "x-element": "plot",
+      "x-elements": [
+        "plot"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/visualizations.md#v6",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        },
+        "minLabels": {
+          "title": "Minimum axis labels",
+          "description": "Labelled tick values a quantitative axis must show.",
+          "type": "integer",
+          "minimum": 2,
+          "default": 3
+        }
+      }
+    },
+    "S9": {
+      "title": "S9 — A float’s short caption names it; the long caption goes on from that name",
+      "description": "Give each figure, table and diagram a `short` caption that names it: it opens the caption line in bold, and names the float in \"Hidden here\", a copied link and the \"Figures and tables\" page. The long `caption` goes on from that name to say what the float shows — its subject, its marks and symbols, the case shown — and at most the one thing to notice. The argument drawn from a figure is lesson text after it, and a lab’s instructions are the first line of its `tools`.",
+      "x-element": "plot",
+      "x-elements": [
+        "plot",
+        "table",
+        "diagram"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/structure-rules.md#s9",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "V1": {
+      "title": "V1 — Graphs and flowcharts use the `Diagram` component",
+      "description": "A node-and-edge picture — a dependency graph, a flowchart — is a `<Diagram id=\"…\">` with its nodes and formulas declared, never a hand-drawn SVG or an image.",
+      "x-element": "diagram",
+      "x-elements": [
+        "diagram"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/visualizations.md#v1",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "S4": {
+      "title": "S4 — A `<Diagram>` carries an `id` and sits where numbering can see it",
+      "description": "Give every `<Diagram>` an `id`, and place it at the top level or inside `<Memo>`/`<ShortNote>`/`<Table>`/`<Figure>` — a diagram nested elsewhere (e.g. in `<CompactExample>`) is never numbered.",
+      "x-element": "diagram",
+      "x-elements": [
+        "diagram"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/structure-rules.md#s4",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "S3": {
+      "title": "S3 — A table is a `<Table id=\"…\">`, never a raw Markdown/HTML table",
+      "description": "Wrap every pipe table or `<table>` in `<Table id=\"…\" caption=\"…\">` so it gets a number and `[[tab-…]]` can reach it.",
+      "x-element": "table",
+      "x-elements": [
+        "table"
+      ],
+      "x-enforcement": "script",
+      "x-doc": "docs/authoring/structure-rules.md#s3",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "C1": {
+      "title": "C1 — Every content change lands with a `content/CHANGELOG.md` entry",
+      "description": "Any edit under `content/` adds a bullet to `content/CHANGELOG.md` under `## [Unreleased]` in the same commit.",
+      "x-element": "changelog",
+      "x-elements": [
+        "changelog"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/versioning.md#c1",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "C2": {
+      "title": "C2 — The knowledge version is semver over learning-facing content",
+      "description": "Bump `about.version` MAJOR when a lesson, competency, notation key or stated outcome is removed or changed; MINOR for something new; PATCH for a fix or clarification.",
+      "x-element": "changelog",
+      "x-elements": [
+        "changelog"
+      ],
+      "x-enforcement": "guide",
+      "x-doc": "docs/authoring/versioning.md#c2",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the rule leaves the rules-in-effect page and an agent neither applies it nor flags it in review.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    },
+    "C3": {
+      "title": "C3 — `about.version` equals the newest changelog heading; a release moves both",
+      "description": "The version in `course.config.ts` and the newest dated heading in `content/CHANGELOG.md` are the same string. On a release, rename `## [Unreleased]` to `## [x.y.z] - <date>`, open a fresh empty `## [Unreleased]` above it, and set `about.version` to that `x.y.z` — in one commit. Between releases `about.version` stays at the last released value. Not checked by the build: that the two edits landed in one commit — the build only ever sees the end state, so a release split across commits warns until the second half lands.",
+      "x-element": "changelog",
+      "x-elements": [
+        "changelog"
+      ],
+      "x-enforcement": "partial",
+      "x-doc": "docs/authoring/versioning.md#c3",
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": {
+          "title": "Enabled",
+          "description": "Off: the check does not run, and the rule leaves the rules-in-effect page.",
+          "type": "boolean",
+          "default": true
+        }
+      }
+    }
+  }
+}