c64-kb 0.17.0

package/dist/graph/extract/archetype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetype.js","sourceRoot":"","sources":["../../../src/graph/extract/archetype.ts"],"names":[],"mappings":"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"}

package/dist/graph/extract/common.js

@@ -0,0 +1,69 @@
+/** Helpers every doc-type parser shares: frontmatter, section splits, field lines, lists. */
+/** Capture group `i` of a match, or "" when the group did not take part. */
+export function group(m, i) {
+    return m.at(i) ?? "";
+}
+/** Parse `---` YAML-ish frontmatter at the top of the doc. */
+export function parseFrontmatter(content) {
+    if (!content.startsWith("---\n"))
+        return { fm: {}, rest: content };
+    const end = content.indexOf("\n---\n", 4);
+    if (end === -1)
+        return { fm: {}, rest: content };
+    const block = content.slice(4, end);
+    const fm = {};
+    for (const line of block.split("\n")) {
+        const m = /^([a-z_]+):\s*(.+?)\s*$/i.exec(line);
+        if (m)
+            fm[group(m, 1)] = group(m, 2);
+    }
+    return { fm, rest: content.slice(end + 5) };
+}
+/**
+ * Split a doc body into sections at headings that start with `prefix`
+ * (`"## "` or `"### "`). Each section is the heading line plus the body up
+ * to the next such heading or the end. Text before the first heading is dropped.
+ */
+function splitSections(body, prefix) {
+    const sections = [];
+    let current = null;
+    for (const line of body.split("\n")) {
+        if (line.startsWith(prefix)) {
+            if (current !== null)
+                sections.push({ heading: current.heading, body: current.lines.join("\n") });
+            current = { heading: line, lines: [] };
+        }
+        else if (current !== null) {
+            current.lines.push(line);
+        }
+    }
+    if (current !== null)
+        sections.push({ heading: current.heading, body: current.lines.join("\n") });
+    return sections;
+}
+export function splitH2Sections(body) {
+    return splitSections(body, "## ");
+}
+export function splitH3Sections(body) {
+    return splitSections(body, "### ");
+}
+/** Group 1 of the first match of `re` in `body`, or undefined. */
+export function matchField(body, re) {
+    const m = body.match(re);
+    return m ? group(m, 1) : undefined;
+}
+/**
+ * Split a comma-separated metadata value: trim each item, optionally strip
+ * backticks after trimming, drop empty items.
+ */
+export function splitList(value, options = {}) {
+    return value
+        .split(",")
+        .map((s) => (options.stripBackticks ? s.trim().replace(/`/g, "") : s.trim()))
+        .filter(Boolean);
+}
+/** Warn about a doc problem on stderr, in the extractor's usual form. */
+export function warn(message) {
+    console.warn(`[extract] ${message}`);
+}
+//# sourceMappingURL=common.js.map

package/dist/graph/extract/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/graph/extract/common.ts"],"names":[],"mappings":"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"}

package/dist/graph/extract/failure.js

@@ -0,0 +1,37 @@
+/** failure-reference pages: one CrashPattern per `## symptom — Description` H2. */
+import { group, matchField, parseFrontmatter, splitH2Sections, splitList } from "./common.js";
+import { ENTITY_H2 } from "./technique.js";
+const LIKELY_CAUSES = /^\*\*Likely causes:\*\*\s+(.+)$/m;
+const DIAGNOSIS_STEPS = /^\*\*Diagnosis steps:\*\*\s+(.+)$/m;
+const CAUSE_LINES = [
+    [/^\*\*Caused by registers:\*\*\s+(.+)$/m, "Register"],
+    [/^\*\*Caused by kernal:\*\*\s+(.+)$/m, "KernalRoutine"],
+    [/^\*\*Caused by techniques:\*\*\s+(.+)$/m, "Technique"],
+];
+function sectionEntities(section) {
+    const header = ENTITY_H2.exec(section.heading);
+    if (!header)
+        return [];
+    const symptom = group(header, 1);
+    const out = [
+        {
+            type: "crash_pattern",
+            symptom,
+            description: group(header, 2),
+            likely_causes: splitList(matchField(section.body, LIKELY_CAUSES) ?? ""),
+            diagnosis_steps: matchField(section.body, DIAGNOSIS_STEPS) ?? "",
+        },
+    ];
+    for (const [re, targetKind] of CAUSE_LINES) {
+        const line = matchField(section.body, re);
+        if (!line)
+            continue;
+        for (const target of splitList(line))
+            out.push({ type: "caused_by", symptom, target, targetKind });
+    }
+    return out;
+}
+export function parseFailureDoc(content) {
+    return splitH2Sections(parseFrontmatter(content).rest).flatMap(sectionEntities);
+}
+//# sourceMappingURL=failure.js.map

package/dist/graph/extract/failure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure.js","sourceRoot":"","sources":["../../../src/graph/extract/failure.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAgB,MAAM,aAAa,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,MAAM,aAAa,GAAG,kCAAkC,CAAC;AACzD,MAAM,eAAe,GAAG,oCAAoC,CAAC;AAC7D,MAAM,WAAW,GAAoC;IACnD,CAAC,wCAAwC,EAAE,UAAU,CAAC;IACtD,CAAC,qCAAqC,EAAE,eAAe,CAAC;IACxD,CAAC,yCAAyC,EAAE,WAAW,CAAC;CACzD,CAAC;AAEF,SAAS,eAAe,CAAC,OAAgB;IACvC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjC,MAAM,GAAG,GAAkB;QACzB;YACE,IAAI,EAAE,eAAe;YACrB,OAAO;YACP,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7B,aAAa,EAAE,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC;YACvE,eAAe,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE;SACjE;KACF,CAAC;IACF,KAAK,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,IAAI,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACrG,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,eAAe,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;AAClF,CAAC"}

package/dist/graph/extract/game-design.js

@@ -0,0 +1,189 @@
+/**
+ * game-design pages (docs/CONVENTIONS-game-designs.md, schema 28). Each H2
+ * is one GameDesign: a whole game named by its archetype, the recipe that
+ * builds it, the techniques it composes in each phase, and, when the built
+ * game was timed, what its frame measured.
+ */
+import { BUDGET_PHASES } from "../../domain/budget.js";
+import { COST_BASIS_WORDS, isCostBasis } from "./vocabulary.js";
+import { group, matchField, splitH2Sections, warn } from "./common.js";
+import { TECHNIQUE_NAME } from "./technique-entities.js";
+// The phases c64_plan_budget budgets apart; a design names the same three.
+const GAME_DESIGN_PHASES = BUDGET_PHASES;
+const NAME_LINE = /^\*\*Game design:\*\*\s+`?([a-z][a-z0-9_]*)`?\s*$/m;
+const INSTANCE_OF_LINE = /^\*\*Instance of:\*\*\s+(.+)$/m;
+const REALISED_BY_LINE = /^\*\*Realised by:\*\*\s+(.+)$/m;
+const COMPOSES_LINE = /^\*\*Composes:\*\*\s+(.+)$/m;
+const REGION_LINE = /^\*\*Region:\*\*\s+(PAL|NTSC|both)\s*$/im;
+const MEASURED_LINE = /^\*\*Measured frame:\*\*\s+(.+)$/gm;
+// A canonical recipe name: <toolchain>-<recipe>, lower case with hyphens.
+const RECIPE_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)+$/;
+const COMPOSES_ITEM = /^([a-z][a-z0-9_]*)(?:\s*\(\s*([a-z]+)\s*\))?$/;
+const MEASURED_ENTRY = /^([a-z]+)\s+(pal|ntsc)\s+(.+)$/i;
+const MEASURED_PAIR = /^(worst|typical)=(\d+)$/;
+function isPhase(word) {
+    return GAME_DESIGN_PHASES.some((p) => p === word);
+}
+/** Backticks off, trimmed, empty items dropped. */
+function items(line) {
+    return line
+        .split(",")
+        .map((s) => s.trim().replace(/`/g, ""))
+        .filter(Boolean);
+}
+/** Names that pass `re`; any other is warned about and skipped. Repeats are folded. */
+function names(line, re, where, label) {
+    if (!line)
+        return [];
+    const out = [];
+    for (const n of items(line)) {
+        if (!re.test(n)) {
+            warn(`${where} lists "${n}" under ${label}, which is not a valid name — not ingested`);
+            continue;
+        }
+        if (!out.includes(n))
+            out.push(n);
+    }
+    return out;
+}
+/**
+ * `a, b (init), c (transition)`: each technique in a phase, play when no
+ * phase is given. The same technique may be listed once per phase; a bad
+ * item is warned about and skipped.
+ */
+export function parseComposes(line, where) {
+    const out = [];
+    for (const item of items(line)) {
+        const m = COMPOSES_ITEM.exec(item);
+        const technique = m ? group(m, 1) : "";
+        const phase = m ? group(m, 2) || "play" : "";
+        if (!m || !TECHNIQUE_NAME.test(technique)) {
+            warn(`${where}: **Composes:** item "${item}" is not "technique" or "technique (phase)" — skipped`);
+            continue;
+        }
+        if (!isPhase(phase)) {
+            warn(`${where}: **Composes:** phase "${phase}" is not one of ${GAME_DESIGN_PHASES.join(", ")} — skipped`);
+            continue;
+        }
+        if (out.some((c) => c.technique === technique && c.phase === phase))
+            continue;
+        out.push({ technique, phase });
+    }
+    return out;
+}
+/** One `<phase> <pal|ntsc> worst=N [typical=N]` entry, or why it is refused. */
+function parseMeasuredEntry(entry) {
+    const e = MEASURED_ENTRY.exec(entry);
+    if (!e)
+        return { error: `"${entry}" is not "<phase> <pal|ntsc> worst=N [typical=N]"` };
+    const phase = group(e, 1).toLowerCase();
+    if (!isPhase(phase))
+        return { error: `phase "${phase}" is not one of ${GAME_DESIGN_PHASES.join(", ")}` };
+    const region = group(e, 2).toUpperCase() === "PAL" ? "PAL" : "NTSC";
+    const figures = new Map();
+    for (const pair of group(e, 3).trim().split(/\s+/)) {
+        const p = MEASURED_PAIR.exec(pair);
+        if (!p)
+            return { error: `"${pair}" is not worst=N or typical=N` };
+        figures.set(group(p, 1), Number(group(p, 2)));
+    }
+    const worst = figures.get("worst");
+    if (worst === undefined)
+        return { error: `"${entry}" has no worst=` };
+    const typical = figures.get("typical");
+    return { phase, region, worst, ...(typical !== undefined ? { typical } : {}) };
+}
+/**
+ * `play pal worst=8693 typical=4966; play ntsc worst=10287 (measured-vice, <source>)`.
+ * The parenthetical at the end is required: its first word is the basis,
+ * the rest names where the figures are. Any malformed part refuses the
+ * whole line, as a partial line would read as the whole measurement.
+ */
+export function parseMeasuredFrame(line) {
+    const m = /^(.*?)\(\s*([a-z-]+)\s*,\s*(.+)\)\s*$/.exec(line.trim());
+    if (!m)
+        return { error: `no "(basis, source)" at the end` };
+    const basis = group(m, 2);
+    const source = group(m, 3).trim();
+    if (!isCostBasis(basis))
+        return { error: `basis "${basis}" is not one of ${COST_BASIS_WORDS.join(", ")}` };
+    const out = [];
+    const entries = group(m, 1)
+        .split(";")
+        .map((x) => x.trim())
+        .filter(Boolean);
+    for (const entry of entries) {
+        const parsed = parseMeasuredEntry(entry);
+        if ("error" in parsed)
+            return parsed;
+        if (out.some((f) => f.phase === parsed.phase && f.region === parsed.region))
+            return { error: `${parsed.phase} ${parsed.region} is given twice` };
+        out.push({ ...parsed, basis, source });
+    }
+    if (out.length === 0)
+        return { error: "no measured entries" };
+    return out;
+}
+function measuredFrames(body, where) {
+    const out = [];
+    for (const m of body.matchAll(MEASURED_LINE)) {
+        const parsed = parseMeasuredFrame(group(m, 1));
+        if ("error" in parsed) {
+            warn(`${where}: **Measured frame:** line refused: ${parsed.error}`);
+            continue;
+        }
+        for (const f of parsed) {
+            if (out.some((o) => o.phase === f.phase && o.region === f.region)) {
+                warn(`${where}: **Measured frame:** ${f.phase} ${f.region} is given on two lines — second one skipped`);
+                continue;
+            }
+            out.push(f);
+        }
+    }
+    return out;
+}
+function designRegion(word) {
+    const w = word?.toUpperCase();
+    if (w === "PAL" || w === "NTSC")
+        return w;
+    return w === "BOTH" ? "both" : undefined;
+}
+function sectionEntities(section, sourcePath, seen) {
+    const title = section.heading.replace(/^##\s+/, "").trim();
+    const nameM = NAME_LINE.exec(section.body);
+    if (!nameM) {
+        if (COMPOSES_LINE.test(section.body))
+            warn(`${sourcePath}: H2 "${title}" has a **Composes:** line but no **Game design:** line — not ingested`);
+        return [];
+    }
+    const name = group(nameM, 1);
+    if (seen.has(name)) {
+        warn(`${sourcePath}: game design "${name}" appears under two H2s — second one not ingested`);
+        return [];
+    }
+    seen.add(name);
+    const where = `${sourcePath}: game design ${name}`;
+    const composesLine = matchField(section.body, COMPOSES_LINE);
+    if (!composesLine)
+        warn(`${where} has no **Composes:** line; it budgets nothing`);
+    const composes = composesLine ? parseComposes(composesLine, where) : [];
+    const region = designRegion(matchField(section.body, REGION_LINE));
+    return [
+        {
+            type: "game_design",
+            name,
+            title,
+            ...(region ? { region } : {}),
+            measured: measuredFrames(section.body, where),
+            source_doc: sourcePath,
+        },
+        ...composes.map((c) => ({ type: "composes", design: name, ...c })),
+        ...names(matchField(section.body, INSTANCE_OF_LINE), TECHNIQUE_NAME, where, "**Instance of:**").map((archetype) => ({ type: "instance_of", design: name, archetype })),
+        ...names(matchField(section.body, REALISED_BY_LINE), RECIPE_NAME, where, "**Realised by:**").map((recipe) => ({ type: "realised_by", design: name, recipe })),
+    ];
+}
+export function parseGameDesignDoc(content, sourcePath) {
+    const seen = new Set();
+    return splitH2Sections(content).flatMap((s) => sectionEntities(s, sourcePath, seen));
+}
+//# sourceMappingURL=game-design.js.map

package/dist/graph/extract/game-design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-design.js","sourceRoot":"","sources":["../../../src/graph/extract/game-design.ts"],"names":[],"mappings":"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"}

package/dist/graph/extract/hardware.js

@@ -0,0 +1,124 @@
+/**
+ * hardware-reference pages (docs/CONVENTIONS-hardware-reference.md):
+ *   - Register H3:   `### $D011 — D011 — Screen Control Register 1 (RW)`
+ *   - KERNAL H3:     `### $FFD2 — CHROUT — Output a character`
+ *   - Memory H3:     `### $0400-$07FF — Default Screen RAM`
+ * Separators accept `—` (U+2014) or ` -- `.
+ */
+import { formatZeroPageRanges } from "../claims.js";
+import { CLOBBERS_LINE, parseClobbers } from "../kernal-clobbers.js";
+import { group, matchField, parseFrontmatter, splitH3Sections, warn } from "./common.js";
+const REG_H3 = /^###\s+(\$[0-9A-F]{4})\s+(?:—|--)\s+([A-Z][A-Z0-9_]*)\s+(?:—|--)\s+(.+?)\s+\((R|W|RW)\)\s*$/;
+const KERNAL_H3 = /^###\s+(\$[0-9A-F]{4})\s+(?:—|--)\s+([A-Z][A-Z0-9_]+)\s+(?:—|--)\s+(.+)$/;
+const MEMORY_H3 = /^###\s+(\$[0-9A-F]{4})-(\$[0-9A-F]{4})\s+(?:—|--)\s+(.+)$/;
+// Hardcoded per-field bold-label extractors (avoids dynamic RegExp construction).
+const FIELD_CHIP = /^\*\*Chip:\*\*\s*(.+?)\s*$/m;
+const FIELD_BANK = /^\*\*Bank-switchable:\*\*\s*(.+?)\s*$/m;
+const FIELD_DEFAULT_USE = /^\*\*Default use:\*\*\s*(.+?)\s*$/m;
+const FIELD_INPUT = /^\*\*Input:\*\*\s*(.+?)\s*$/m;
+const FIELD_OUTPUT = /^\*\*Output:\*\*\s*(.+?)\s*$/m;
+const FIELD_AFFECTS = /^\*\*Affects:\*\*\s*(.+?)\s*$/m;
+const FIELD_PAIRS_WITH = /^\*\*Pairs with:\*\*\s*(.+?)\s*$/m;
+/** Optional string fields, with the absent ones left out rather than set to undefined. */
+function optionalFields(body, fields) {
+    const out = {};
+    for (const [key, re] of Object.entries(fields)) {
+        const value = matchField(body, re);
+        if (value !== undefined)
+            out[key] = value;
+    }
+    return out;
+}
+function registerEntities(m, body, defaultChip) {
+    const addr = group(m, 1);
+    const name = group(m, 2);
+    const chip = matchField(body, FIELD_CHIP) ?? defaultChip;
+    if (!chip)
+        return [];
+    // Always derive the hex-byte form (e.g. "D011") from the address. Emit it
+    // as an alias only when the canonical name differs (e.g. mnemonic-style
+    // "SCROLY"). When name == hexForm, aliases is empty.
+    const hexForm = addr.replace(/^\$/, "");
+    const aliases = name !== hexForm ? [hexForm] : [];
+    return [
+        { type: "register", name, address: addr, chip, rw: group(m, 4), aliases },
+        { type: "belongs_to", entityName: name, entityType: "Register", chip },
+    ];
+}
+function memoryEntity(m, body) {
+    const bank = matchField(body, FIELD_BANK)?.toLowerCase().startsWith("y") ?? false;
+    return {
+        type: "memory_region",
+        name: group(m, 3).trim(),
+        start: group(m, 1),
+        end: group(m, 2),
+        ...optionalFields(body, { default_use: FIELD_DEFAULT_USE }),
+        bank_switchable: bank,
+    };
+}
+/**
+ * One CLOBBERS_ZP entity per `**Clobbers zero page:**` line (schema 26): the
+ * may line the ROM walk writes and any must line a VICE trace wrote. A line
+ * that does not parse is warned about and dropped, never guessed at.
+ */
+function clobberEntities(routine, body) {
+    const out = [];
+    for (const m of body.matchAll(CLOBBERS_LINE)) {
+        const c = parseClobbers(group(m, 1));
+        if ("error" in c) {
+            warn(`${routine}: **Clobbers zero page:** refused: ${c.error}`);
+            continue;
+        }
+        out.push({
+            type: "kernal_clobbers_zp",
+            routine,
+            ranges: formatZeroPageRanges(c.ranges),
+            bound: c.bound,
+            basis: c.basis,
+        });
+    }
+    return out;
+}
+function kernalEntities(m, body) {
+    const name = group(m, 2);
+    const entities = [
+        {
+            type: "kernal_routine",
+            name,
+            address: group(m, 1),
+            description: group(m, 3).trim(),
+            ...optionalFields(body, { input: FIELD_INPUT, output: FIELD_OUTPUT, affects: FIELD_AFFECTS }),
+        },
+    ];
+    entities.push(...clobberEntities(name, body));
+    const pairsField = matchField(body, FIELD_PAIRS_WITH);
+    if (pairsField) {
+        const pairs = pairsField
+            .split(/[,;]/)
+            .map((s) => s.trim().replace(/`/g, ""))
+            .filter(Boolean);
+        for (const b of pairs)
+            entities.push({ type: "pairs_with", a: name, b });
+    }
+    return entities;
+}
+function sectionEntities({ heading, body }, defaultChip) {
+    const regM = REG_H3.exec(heading);
+    if (regM)
+        return registerEntities(regM, body, defaultChip);
+    // Memory before KERNAL: both start with an address and a dash separator,
+    // but a memory heading has $START-$END where a KERNAL one has one $ADDR.
+    const memM = MEMORY_H3.exec(heading);
+    if (memM)
+        return [memoryEntity(memM, body)];
+    const krnM = KERNAL_H3.exec(heading);
+    if (krnM)
+        return kernalEntities(krnM, body);
+    return [];
+}
+export function parseHardwareDoc(content) {
+    const { fm, rest } = parseFrontmatter(content);
+    const defaultChip = fm.chip ?? "";
+    return splitH3Sections(rest).flatMap((section) => sectionEntities(section, defaultChip));
+}
+//# sourceMappingURL=hardware.js.map

package/dist/graph/extract/hardware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hardware.js","sourceRoot":"","sources":["../../../src/graph/extract/hardware.ts"],"names":[],"mappings":"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"}

package/dist/graph/extract/pitfall.js

@@ -0,0 +1,62 @@
+/** pitfall-reference pages (docs/CONVENTIONS-pitfalls.md): one Pitfall per `## name — Title` H2. */
+import { group, matchField, parseFrontmatter, splitH2Sections, splitList, warn, } from "./common.js";
+import { TECHNIQUE_NAME } from "./technique-entities.js";
+import { ENTITY_H2, REGION_LINE } from "./technique.js";
+const SEVERITY_LINE = /^\*\*Severity:\*\*\s+(critical|high|medium|low)\s*$/im;
+const TRIGGERED_REGS = /^\*\*Triggered by registers:\*\*\s+(.+)$/m;
+const TRIGGERED_KERNAL = /^\*\*Triggered by kernal:\*\*\s+(.+)$/m;
+const TRIGGERED_TECHS = /^\*\*Triggered by techniques:\*\*\s+(.+)$/m;
+// **Mitigated by techniques:** names the Technique(s) whose application is the
+// Fix section's remedy (docs/CONVENTIONS-pitfalls.md). Techniques only.
+const MITIGATED_TECHS = /^\*\*Mitigated by techniques:\*\*\s+(.+)$/m;
+const TRIGGER_LINES = [
+    [TRIGGERED_REGS, "Register"],
+    [TRIGGERED_KERNAL, "KernalRoutine"],
+    [TRIGGERED_TECHS, "Technique"],
+];
+function mitigatedByEntities(body, pitfall, sourcePath) {
+    const line = matchField(body, MITIGATED_TECHS);
+    if (!line)
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const t of splitList(line, { stripBackticks: true })) {
+        if (!TECHNIQUE_NAME.test(t)) {
+            warn(`${sourcePath}: pitfall ${pitfall} is mitigated by "${t}", which is not a snake_case technique name — not ingested (see CONVENTIONS-pitfalls.md)`);
+            continue;
+        }
+        if (seen.has(t))
+            continue;
+        seen.add(t);
+        out.push({ type: "mitigated_by", pitfall, target: t });
+    }
+    return out;
+}
+function sectionEntities(section, category, sourcePath) {
+    const header = ENTITY_H2.exec(section.heading);
+    if (!header)
+        return [];
+    const name = group(header, 1);
+    const severity = (matchField(section.body, SEVERITY_LINE) ?? "medium").toLowerCase();
+    const region = (matchField(section.body, REGION_LINE) ?? "both").toLowerCase();
+    const out = [{ type: "pitfall", name, title: group(header, 2), severity, region, category }];
+    for (const [re, targetKind] of TRIGGER_LINES) {
+        const line = matchField(section.body, re);
+        if (!line)
+            continue;
+        for (const target of splitList(line))
+            out.push({ type: "triggered_by", pitfall: name, target, targetKind });
+    }
+    out.push(...mitigatedByEntities(section.body, name, sourcePath));
+    return out;
+}
+export function parsePitfallDoc(content, sourcePath) {
+    const { fm, rest } = parseFrontmatter(content);
+    const category = fm.category;
+    if (!category) {
+        warn(`pitfall doc ${sourcePath} missing 'category' frontmatter — skipping`);
+        return [];
+    }
+    return splitH2Sections(rest).flatMap((section) => sectionEntities(section, category, sourcePath));
+}
+//# sourceMappingURL=pitfall.js.map

package/dist/graph/extract/pitfall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pitfall.js","sourceRoot":"","sources":["../../../src/graph/extract/pitfall.ts"],"names":[],"mappings":"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"}

package/dist/graph/extract/raster-band.js

@@ -0,0 +1,56 @@
+/**
+ * **Raster band:** says which raster lines a technique holds the CPU on
+ * (docs/CONVENTIONS-techniques.md). The value is comma-separated ranges of
+ * raster line numbers, `N-M` or `N`, or the word `movable` for a technique
+ * whose lines the program chooses. A trailing parenthetical note says where
+ * the numbers came from and is not part of the value.
+ */
+// Highest raster line number on either machine: PAL has 312 lines (0-311),
+// NTSC 263 (0-262). A band is stated in raster line numbers, the same
+// numbers on both machines; a line past 262 simply does not occur on NTSC.
+const RASTER_LINE_MAX = 311;
+const BAND_PART = /^(\d+)(?:\s*[-–]\s*(\d+))?$/;
+function parseBandPart(part) {
+    const m = BAND_PART.exec(part);
+    if (!m)
+        return { error: `"${part}" is not a line number, a range N-M, or "movable"` };
+    const first = Number(m.at(1));
+    const lastText = m.at(2);
+    const last = lastText !== undefined ? Number(lastText) : first;
+    if (first > last)
+        return { error: `range ${first}-${last} runs backwards (write a wrap as two ranges)` };
+    if (last > RASTER_LINE_MAX)
+        return { error: `line ${last} is past the last raster line, ${RASTER_LINE_MAX}` };
+    return [first, last];
+}
+/**
+ * Parse the value of a **Raster band:** line (or the canonical string stored
+ * on the Technique node). Returns an error string for anything outside the
+ * grammar, so the extractor can warn and ingest nothing rather than guess.
+ */
+export function parseRasterBand(raw) {
+    const value = raw
+        .replace(/`/g, "")
+        .replace(/\s*\([^)]*\)\s*$/, "")
+        .trim()
+        .toLowerCase();
+    if (value === "")
+        return { error: "empty band" };
+    if (value === "movable")
+        return { kind: "movable", canonical: "movable" };
+    const ranges = [];
+    for (const part of value.split(",").map((s) => s.trim())) {
+        const range = parseBandPart(part);
+        if ("error" in range)
+            return range;
+        ranges.push(range);
+    }
+    ranges.sort((a, b) => a[0] - b[0]);
+    const canonical = ranges.map(([a, b]) => (a === b ? `${a}` : `${a}-${b}`)).join(",");
+    return { kind: "lines", ranges, canonical };
+}
+/** True when two line bands share at least one raster line. */
+export function rasterBandsOverlap(a, b) {
+    return a.some(([a0, a1]) => b.some(([b0, b1]) => a0 <= b1 && b0 <= a1));
+}
+//# sourceMappingURL=raster-band.js.map

package/dist/graph/extract/raster-band.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster-band.js","sourceRoot":"","sources":["../../../src/graph/extract/raster-band.ts"],"names":[],"mappings":"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"}