c64-kb 0.17.0

package/dist/domain/game-design.js

@@ -0,0 +1,77 @@
+/**
+ * A GameDesign's measured frame beside the budget planBudget predicts for
+ * the same phase and region (schema 28). Pure: the caller fetches the
+ * design and the plan.
+ */
+function missingOf(p) {
+    const multi = p.excluded.filter((e) => e.reason === "multi_frame").map((e) => e.name);
+    return [...p.unknown, ...p.not_found, ...multi];
+}
+function positionOf(worst, low, top, incomplete) {
+    if (worst < low)
+        return "below_low";
+    if (worst > top)
+        return "above_high";
+    return incomplete ? "within_incomplete" : "within";
+}
+/**
+ * `label` names the figure and its value, e.g. "measured worst 8693
+ * (measured-vice)"; `of` names it in the percentage ("the measured worst").
+ * An excess is given as a share of the figure placed, so a typical frame's
+ * excess is not divided by the worst frame.
+ */
+function placeText(label, of, value, range) {
+    const { low, top } = range;
+    if (value >= low && value <= top)
+        return `${label} lies within the predicted ${low}-${top}`;
+    if (value > top)
+        return `${label} is above the predicted ${low}-${top} by ${value - top} (${Math.round((100 * (value - top)) / value)} % of ${of})`;
+    return `${label} is below the predicted ${low}-${top} by ${low - value}`;
+}
+function findingText(m, p, missing) {
+    const top = p.high + p.fixed_losses.badlines + p.fixed_losses.sprite_dma;
+    const range = { low: p.low, top };
+    let out = placeText(`measured worst ${m.worst} (${m.basis})`, "the measured worst", m.worst, range);
+    if (m.typical !== undefined)
+        out += `; ${placeText(`typical ${m.typical}`, "the typical", m.typical, range)}`;
+    if (missing.length === 0)
+        return out;
+    const n = missing.length;
+    const consequence = m.worst > top
+        ? "the uncounted cycles may account for the excess"
+        : m.worst < p.low
+            ? "a missing member can only raise the range, so the measured worst stays below it"
+            : "any agreement is partial";
+    return `${out}. ${n} member${n === 1 ? " has" : "s have"} no figure (${missing.join(", ")}), so the prediction is incomplete: ${consequence}`;
+}
+/** Each measurement beside the plan's phase for the same phase and region, if the plan has one. */
+export function compareMeasured(measured, phases) {
+    return measured.map((m) => {
+        const base = {
+            phase: m.phase,
+            region: m.region,
+            worst: m.worst,
+            typical: m.typical ?? null,
+            basis: m.basis,
+            source: m.source,
+        };
+        const p = phases.find((x) => x.phase === m.phase && x.region === m.region);
+        if (!p) {
+            return {
+                ...base,
+                predicted: null,
+                position: "not_predicted",
+                finding: `no ${m.phase} budget for ${m.region}: the region was not asked for, or the design composes nothing in that phase`,
+            };
+        }
+        const fixed = p.fixed_losses.badlines + p.fixed_losses.sprite_dma;
+        const missing = missingOf(p);
+        return {
+            ...base,
+            predicted: { low: p.low, high: p.high, fixed, verdict: p.verdict, missing },
+            position: positionOf(m.worst, p.low, p.high + fixed, missing.length > 0),
+            finding: findingText(m, p, missing),
+        };
+    });
+}
+//# sourceMappingURL=game-design.js.map

package/dist/domain/game-design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-design.js","sourceRoot":"","sources":["../../src/domain/game-design.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwCH,SAAS,SAAS,CAAC,CAAc;IAC/B,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,UAAU,CACjB,KAAa,EACb,GAAW,EACX,GAAW,EACX,UAAmB;IAEnB,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,WAAW,CAAC;IACpC,IAAI,KAAK,GAAG,GAAG;QAAE,OAAO,YAAY,CAAC;IACrC,OAAO,UAAU,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,KAAa,EAAE,EAAU,EAAE,KAAa,EAAE,KAAmC;IAC9F,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IAC3B,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,GAAG,KAAK,8BAA8B,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5F,IAAI,KAAK,GAAG,GAAG;QACb,OAAO,GAAG,KAAK,2BAA2B,GAAG,IAAI,GAAG,OAAO,KAAK,GAAG,GAAG,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC;IACrI,OAAO,GAAG,KAAK,2BAA2B,GAAG,IAAI,GAAG,OAAO,GAAG,GAAG,KAAK,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,WAAW,CAAC,CAAoB,EAAE,CAAc,EAAE,OAAiB;IAC1E,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC;IACzE,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;IAClC,IAAI,GAAG,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,GAAG,EAAE,oBAAoB,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACpG,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS;QACzB,GAAG,IAAI,KAAK,SAAS,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;IACnF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACrC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACzB,MAAM,WAAW,GACf,CAAC,CAAC,KAAK,GAAG,GAAG;QACX,CAAC,CAAC,iDAAiD;QACnD,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG;YACf,CAAC,CAAC,iFAAiF;YACnF,CAAC,CAAC,0BAA0B,CAAC;IACnC,OAAO,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,eAAe,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,uCAAuC,WAAW,EAAE,CAAC;AAChJ,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,eAAe,CAAC,QAA6B,EAAE,MAAqB;IAClF,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG;YACX,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,IAAI;YAC1B,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC;QACF,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;QAC3E,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,OAAO;gBACL,GAAG,IAAI;gBACP,SAAS,EAAE,IAAI;gBACf,QAAQ,EAAE,eAAe;gBACzB,OAAO,EAAE,MAAM,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,MAAM,8EAA8E;aAC5H,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,CAAC,YAAY,CAAC,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC;QAClE,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC7B,OAAO;YACL,GAAG,IAAI;YACP,SAAS,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE;YAC3E,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,KAAK,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACxE,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;SACpC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/domain/timing.js

@@ -0,0 +1,39 @@
+/**
+ * VIC-II frame and line timing: the constants every cycle budget in the
+ * tools is built from. Pure data and arithmetic, no services.
+ */
+// PAL 6569: 63 cycles x 312 lines = 19656. NTSC 6567R8: 65 x 263 = 17095.
+export const REGION_TIMING = {
+    PAL: { cycles_per_line: 63, lines_per_frame: 312, cycles_per_frame: 63 * 312 },
+    NTSC: { cycles_per_line: 65, lines_per_frame: 263, cycles_per_frame: 65 * 263 },
+};
+/** "pal", "NTSC" and so on to a region key; anything else is PAL. */
+export function videoRegion(name) {
+    return name.toUpperCase() === "NTSC" ? "NTSC" : "PAL";
+}
+// A badline takes the bus for 40 cycles (15-54) and pulls BA low three cycles
+// earlier; the CPU can spend those three only on write cycles, so 43 is the
+// figure to plan on (20 of 63 left on PAL, 22 of 65 on NTSC).
+export const BADLINE_CYCLES_LOST = 43;
+// Badlines in a frame with the display on and the default YSCROLL of 3:
+// lines 51, 59, ..., 243, one every eighth line, 25 in all
+// (docs/hardware/vic-ii-reference.md, "Badlines").
+export const BADLINE_ROWS = Array.from({ length: 25 }, (_, i) => 51 + 8 * i);
+export const BADLINES_PER_FRAME = BADLINE_ROWS.length;
+// Through the KERNAL vector: 7 cycles of interrupt sequence + 29 for the
+// dispatcher at $FF48 before the handler's first instruction. A handler on
+// $FFFE with the KERNAL out pays 7 plus its own register saves.
+export const DEFAULT_IRQ_OVERHEAD = 36;
+// Sprite DMA on a line where n sprites are displayed: BA drops three cycles
+// before the first sprite's slot (usable only by write cycles), then two
+// bus cycles per sprite; the p-access costs the CPU nothing. Measured in
+// VICE x64sc (docs/hardware/vic-ii-reference.md, "Sprite DMA"): 5 for one
+// sprite, 19 for eight, and the CPU resumes where 3 + 2n predicts for
+// sprites 0..k with k = 0, 2, 3, 6, 7. Sprites numbered with a gap pay the
+// three lead-in cycles again per group: sprites 0 and 7 measured 10, not 7.
+export const SPRITE_BA_LEAD_IN = 3;
+export const SPRITE_CYCLES_EACH = 2;
+export function spriteDmaCycles(sprites) {
+    return sprites > 0 ? SPRITE_BA_LEAD_IN + SPRITE_CYCLES_EACH * sprites : 0;
+}
+//# sourceMappingURL=timing.js.map

package/dist/domain/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../src/domain/timing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,aAAa,GAAgD;IACxE,GAAG,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,GAAG,GAAG,EAAE;IAC9E,IAAI,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,GAAG,GAAG,EAAE;CAChF,CAAC;AAEF,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AACxD,CAAC;AAED,8EAA8E;AAC9E,4EAA4E;AAC5E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAEtC,wEAAwE;AACxE,2DAA2D;AAC3D,mDAAmD;AACnD,MAAM,CAAC,MAAM,YAAY,GAAsB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAChG,MAAM,CAAC,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,CAAC;AAEtD,yEAAyE;AACzE,2EAA2E;AAC3E,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEvC,4EAA4E;AAC5E,yEAAyE;AACzE,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,2EAA2E;AAC3E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,GAAG,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/graph/apply.js

@@ -0,0 +1,132 @@
+/**
+ * Apply extracted graph entities to FalkorDB. One place maps each entity
+ * type to its FalkorService call, for both batch ingest (src/ingest.ts,
+ * nodes in pass 1 and edges in pass 2) and single-file ingest
+ * (src/tools/hydrate.ts, one pass). Both used to carry their own ~30-case
+ * switch; batch ingest's had no exhaustiveness check, so a new entity type
+ * would have been skipped there without a word.
+ */
+const NODE_TYPES = [
+    "register",
+    "kernal_routine",
+    "memory_region",
+    "tool",
+    "file_format",
+    "recipe",
+    "technique",
+    "pitfall",
+    "crash_pattern",
+    "archetype",
+    "game_design",
+];
+/** Nodes must exist before the edges that reference them, so batch ingest creates them first. */
+export function isNodeEntity(e) {
+    return NODE_TYPES.some((t) => t === e.type);
+}
+export function recipeEdges(r) {
+    return [
+        { type: "recipe_uses_tool", recipe: r.name, tool: r.toolchain },
+        ...r.uses_registers.map((register) => ({
+            type: "recipe_uses_register",
+            recipe: r.name,
+            register,
+        })),
+        ...r.uses_kernal.map((kernal) => ({ type: "recipe_uses_kernal", recipe: r.name, kernal })),
+    ];
+}
+export async function applyNode(f, e) {
+    switch (e.type) {
+        case "register":
+            return f.addRegister(e.name, e.address, e.chip, e.rw, e.aliases);
+        case "kernal_routine":
+            return f.addKernalRoutine(e.name, e.address, e.description);
+        case "memory_region":
+            return f.addMemoryRegion(e.name, e.start, e.end, e.default_use ?? "", e.bank_switchable ?? false);
+        case "tool":
+            return f.addTool(e);
+        case "file_format":
+            return f.addFileFormat(e.name, e.description);
+        case "recipe":
+            return f.addRecipe(e);
+        case "technique":
+            return f.addTechnique(e);
+        case "pitfall":
+            return f.addPitfall(e);
+        case "crash_pattern":
+            return f.addCrashPattern(e);
+        case "archetype":
+            return f.addArchetype(e);
+        case "game_design":
+            return f.addGameDesign(e);
+        default: {
+            // A node type added to NODE_TYPES without a case here is a tsc error.
+            const unhandled = e;
+            throw new Error(`no graph applier for node ${JSON.stringify(unhandled)}`);
+        }
+    }
+}
+/** A link call whose result says nothing about whether the edge landed. */
+function always(link) {
+    return async (f, e) => {
+        await link(f, e);
+        return true;
+    };
+}
+// One entry per edge type: a type missing here is a tsc error, the table
+// form of a `never` guard. Each returns false when the link reports that
+// the edge did not land (a target name that matches no node, or a
+// REQUIRES that would close a cycle).
+const LINKERS = {
+    belongs_to: always((f, e) => f.linkBelongsTo(e.entityType, e.entityName, e.chip)),
+    pairs_with: async (f, e) => (await f.linkPairsWith(e.a, e.b)).linked,
+    produces: always((f, e) => f.linkProduces(e.tool, e.format)),
+    consumes: always((f, e) => f.linkConsumes(e.tool, e.format)),
+    targets: always((f, e) => f.linkTargets(e.tool, e.chip)),
+    implements: always((f, e) => f.linkRecipeImplements(e.recipe, e.technique)),
+    produces_format: always((f, e) => f.linkRecipeProducesFormat(e.recipe, e.format)),
+    scaffolds: (f, e) => f.linkRecipeScaffolds(e.recipe, e.archetype),
+    recipe_occupies: always((f, e) => f.linkRecipeOccupies(e.recipe, e.start, e.end)),
+    recipe_uses_tool: always((f, e) => f.linkRecipeUsesTool(e.recipe, e.tool)),
+    recipe_uses_register: always((f, e) => f.linkRecipeUsesRegister(e.recipe, e.register)),
+    recipe_uses_kernal: always((f, e) => f.linkRecipeUsesKernal(e.recipe, e.kernal)),
+    technique_uses_register: always((f, e) => f.linkTechniqueUsesRegister(e.technique, e.register)),
+    technique_uses_kernal: always((f, e) => f.linkTechniqueUsesKernal(e.technique, e.kernal)),
+    technique_requires_region: always((f, e) => f.linkTechniqueRequiresRegion(e.technique, e.region)),
+    technique_belongs_to: always((f, e) => f.linkTechniqueBelongsTo(e.technique, e.chip)),
+    technique_demands: always((f, e) => f.linkTechniqueDemands(e.technique, e.resource, e.description)),
+    technique_requires: (f, e) => f.linkTechniqueRequires(e.technique, e.requires),
+    triggered_by: (f, e) => f.linkTriggeredBy(e.pitfall, e.target, e.targetKind),
+    mitigated_by: (f, e) => f.linkMitigatedBy(e.pitfall, e.target),
+    caused_by: (f, e) => f.linkCausedBy(e.symptom, e.target, e.targetKind),
+    archetype_features: (f, e) => f.linkArchetypeFeatures(e.archetype, e.technique),
+    archetype_risks: (f, e) => f.linkArchetypeRisks(e.archetype, e.pitfall),
+    claims: (f, e) => f.linkClaims(e),
+    kernal_clobbers_zp: (f, e) => f.linkKernalClobbersZp(e),
+    composes: (f, e) => f.linkComposes(e.design, e.technique, e.phase),
+    instance_of: (f, e) => f.linkInstanceOf(e.design, e.archetype),
+    realised_by: (f, e) => f.linkRealisedBy(e.design, e.recipe),
+};
+/** Create one edge. Resolves false when the link reports the edge did not land. */
+export function applyEdge(f, e) {
+    // LINKERS[e.type] takes exactly the entity whose type is e.type; the
+    // checker cannot correlate the key with the union member, so say so.
+    const link = LINKERS[e.type];
+    return link(f, e);
+}
+/**
+ * Apply one entity in a single pass (single-file ingest): a node, then for
+ * a Recipe the edges its properties imply; or an edge. Returns true for a
+ * node, so callers can count nodes.
+ */
+export async function applyEntity(f, e) {
+    if (!isNodeEntity(e)) {
+        await applyEdge(f, e);
+        return false;
+    }
+    await applyNode(f, e);
+    if (e.type === "recipe")
+        for (const edge of recipeEdges(e))
+            await applyEdge(f, edge);
+    return true;
+}
+//# sourceMappingURL=apply.js.map

package/dist/graph/apply.js.map

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

package/dist/graph/claims.js

@@ -0,0 +1,231 @@
+// Resource claims (schema 25): the HardwareUnit seeds and the grammar of a
+// technique's **Claims:** line (docs/CONVENTIONS-techniques.md). extract.ts
+// re-exports all of it; the extractor reads the line, the ingest seeds the
+// units, check_compatibility sets two claims on one unit against each other.
+import { group } from "./extract/common.js";
+const spriteUnit = (n) => ({
+    name: `sprite_${n}`,
+    kind: "sprite",
+    addresses: `$${(0xd000 + 2 * n).toString(16).toUpperCase()}-$${(0xd001 + 2 * n).toString(16).toUpperCase()}, $${(0xd027 + n).toString(16).toUpperCase()}, bit ${n} of $D010/$D015/$D017/$D01B-$D01D, pointer at screen+$${(0x3f8 + n).toString(16).toUpperCase()}`,
+    chip: "VIC-II",
+});
+// The seed. Addresses from docs/hardware/c64-registers-reference.md and
+// docs/techniques/input.md (CIA1 ports). Keep in step with docs/ONTOLOGY.md.
+export const HARDWARE_UNITS = [
+    { name: "sid_voice_1", kind: "sid_voice", addresses: "$D400-$D406", chip: "SID" },
+    { name: "sid_voice_2", kind: "sid_voice", addresses: "$D407-$D40D", chip: "SID" },
+    { name: "sid_voice_3", kind: "sid_voice", addresses: "$D40E-$D414", chip: "SID" },
+    { name: "sid_filter_volume", kind: "sid_shared", addresses: "$D415-$D418", chip: "SID" },
+    { name: "sid_voice_3_readback", kind: "sid_shared", addresses: "$D41B-$D41C", chip: "SID" },
+    { name: "sid_pots", kind: "port", addresses: "$D419-$D41A", chip: "SID" },
+    ...[0, 1, 2, 3, 4, 5, 6, 7].map(spriteUnit),
+    { name: "cia1_timer_a", kind: "timer", addresses: "$DC04-$DC05, $DC0E, bit 0 of $DC0D", chip: "CIA1" },
+    { name: "cia1_timer_b", kind: "timer", addresses: "$DC06-$DC07, $DC0F, bit 1 of $DC0D", chip: "CIA1" },
+    { name: "cia2_timer_a", kind: "timer", addresses: "$DD04-$DD05, $DD0E, bit 0 of $DD0D", chip: "CIA2" },
+    { name: "cia2_timer_b", kind: "timer", addresses: "$DD06-$DD07, $DD0F, bit 1 of $DD0D", chip: "CIA2" },
+    { name: "cia1_tod", kind: "tod", addresses: "$DC08-$DC0B, bit 2 of $DC0D", chip: "CIA1" },
+    { name: "cia2_tod", kind: "tod", addresses: "$DD08-$DD0B, bit 2 of $DD0D", chip: "CIA2" },
+    {
+        name: "cia1_port_a",
+        kind: "port",
+        addresses: "$DC00 (keyboard column drive, control port 2, POT select)",
+        chip: "CIA1",
+    },
+    { name: "cia1_port_b", kind: "port", addresses: "$DC01 (keyboard rows, control port 1)", chip: "CIA1" },
+    { name: "cia2_vic_bank", kind: "port", addresses: "$DD00 bits 0-1", chip: "CIA2" },
+    { name: "serial_bus", kind: "bus", addresses: "$DD00 bits 3-7 and the drive", chip: "CIA2" },
+    { name: "user_port", kind: "port", addresses: "$DD01", chip: "CIA2" },
+    {
+        name: "vic_raster_irq",
+        kind: "irq_source",
+        addresses: "$D012, $D011 bit 7, $D019/$D01A bit 0",
+        chip: "VIC-II",
+    },
+    { name: "irq_vector_0314", kind: "vector", addresses: "$0314-$0315", chip: "6510" },
+    { name: "irq_vector_fffe", kind: "vector", addresses: "$FFFE-$FFFF", chip: "6510" },
+    { name: "nmi_vector_0318", kind: "vector", addresses: "$0318-$0319", chip: "6510" },
+    { name: "nmi_vector_fffa", kind: "vector", addresses: "$FFFA-$FFFB", chip: "6510" },
+    { name: "expansion_io1", kind: "io_page", addresses: "$DE00-$DEFF" },
+    { name: "expansion_io2", kind: "io_page", addresses: "$DF00-$DFFF" },
+    { name: "zero_page", kind: "zero_page", addresses: "$02-$FF", chip: "6510" },
+];
+const HARDWARE_UNIT_NAMES = new Set(HARDWARE_UNITS.map((u) => u.name));
+export const CLAIM_MODES = ["owns", "shares", "reads", "init"];
+export const CLAIMS_BASIS_WORDS = ["measured-vice", "derived-listing", "estimated"];
+export const isClaimsBasis = (w) => CLAIMS_BASIS_WORDS.includes(w);
+/** Parse zero-page byte ranges written `$02-$0D+$24-$2F` into merged [first, last] pairs. */
+export function parseZeroPageRanges(raw) {
+    const out = [];
+    for (const part of raw.split("+").map((s) => s.trim())) {
+        const m = /^\$([0-9A-Fa-f]{2})(?:\s*-\s*\$([0-9A-Fa-f]{2}))?$/.exec(part);
+        if (!m)
+            return { error: `"${part}" is not a zero-page byte $XX or range $XX-$YY` };
+        const first = parseInt(group(m, 1), 16);
+        const last = m[2] ? parseInt(m[2], 16) : first;
+        if (first > last)
+            return { error: `range ${part} runs backwards` };
+        if (first < 0x02)
+            return { error: `${part} includes $00-$01, the 6510 port, which is not zero-page RAM` };
+        out.push([first, last]);
+    }
+    out.sort((a, b) => a[0] - b[0]);
+    const merged = [];
+    for (const r of out) {
+        const prev = merged.at(-1);
+        if (prev && r[0] <= prev[1] + 1)
+            prev[1] = Math.max(prev[1], r[1]);
+        else
+            merged.push([r[0], r[1]]);
+    }
+    return merged;
+}
+const hex2 = (n) => n.toString(16).toUpperCase().padStart(2, "0");
+/** Canonical form stored on a CLAIMS edge: "02-0D,24-2F", a single byte as "B7". */
+export function formatZeroPageRanges(ranges) {
+    return ranges.map(([a, b]) => (a === b ? hex2(a) : `${hex2(a)}-${hex2(b)}`)).join(",");
+}
+/** Inverse of formatZeroPageRanges; returns [] for anything malformed. */
+export function zeroPageRangesFromCanonical(canonical) {
+    const out = [];
+    for (const part of canonical.split(",").filter((s) => s !== "")) {
+        const m = /^([0-9A-F]{2})(?:-([0-9A-F]{2}))?$/i.exec(part);
+        if (!m)
+            return [];
+        out.push([parseInt(group(m, 1), 16), parseInt(m[2] ?? group(m, 1), 16)]);
+    }
+    return out;
+}
+/** Split on commas that are not inside parentheses. */
+function splitTopLevel(s) {
+    const parts = [];
+    let depth = 0;
+    let cur = "";
+    for (const ch of s) {
+        if (ch === "(")
+            depth++;
+        if (ch === ")")
+            depth = Math.max(0, depth - 1);
+        if (ch === "," && depth === 0) {
+            parts.push(cur);
+            cur = "";
+        }
+        else
+            cur += ch;
+    }
+    parts.push(cur);
+    return parts.map((p) => p.trim()).filter((p) => p !== "");
+}
+/** The words inside an item's parentheses: one mode at most, and "relocatable". */
+function parseModifiers(item, mods) {
+    let mode;
+    let relocatable = false;
+    const words = mods
+        .split(",")
+        .map((w) => w.trim())
+        .filter((w) => w !== "");
+    for (const word of words) {
+        if (word === "relocatable") {
+            relocatable = true;
+            continue;
+        }
+        if (!CLAIM_MODES.includes(word))
+            return { error: `"${word}" in "${item}" is not a mode (${CLAIM_MODES.join(", ")}) or "relocatable"` };
+        if (mode !== undefined)
+            return { error: `"${item}" names two modes` };
+        mode = word;
+    }
+    return { mode: mode ?? "owns", relocatable };
+}
+/** A unit word, or a numbered run of units (sprite_0-7, sid_voice_1-3), checked against the seeds. */
+function expandUnits(unitWord) {
+    let units = [unitWord];
+    const range = /^(.*_)(\d+)-(\d+)$/.exec(unitWord);
+    if (range) {
+        const first = Number(range[2]);
+        const last = Number(range[3]);
+        if (first > last)
+            return { error: `unit range "${unitWord}" runs backwards` };
+        units = [];
+        for (let n = first; n <= last; n++)
+            units.push(`${group(range, 1)}${n}`);
+    }
+    const bad = units.find((u) => !HARDWARE_UNIT_NAMES.has(u));
+    if (bad)
+        return { error: `"${bad}" is not a hardware unit (see docs/ONTOLOGY.md, HardwareUnit)` };
+    return units;
+}
+function parseItem(item) {
+    if (item.toLowerCase() === "none")
+        return { error: `"none" must stand alone` };
+    const m = /^([a-z][a-z0-9_]*(?:-\d+)?)(?:\s+(\$[^()]*?))?\s*(?:\(([^()]*)\))?$/.exec(item);
+    if (!m)
+        return { error: `"${item}" is not <unit>[ (<mode>)]` };
+    const [, unitWord, addr, mods] = m;
+    const modifiers = parseModifiers(item, mods ?? "");
+    if ("error" in modifiers)
+        return modifiers;
+    const units = expandUnits(unitWord);
+    if ("error" in units)
+        return units;
+    return { units, addr, ...modifiers };
+}
+/** Zero page carries its bytes; it is the only unit that takes addresses or can be relocatable. */
+function zeroPageClaim(item) {
+    if (!item.addr)
+        return { error: `zero_page needs its bytes, e.g. "zero_page $FB-$FE"` };
+    const zp = parseZeroPageRanges(item.addr);
+    if ("error" in zp)
+        return zp;
+    return {
+        unit: "zero_page",
+        mode: item.mode,
+        ranges: formatZeroPageRanges(zp),
+        ...(item.relocatable ? { relocatable: true } : {}),
+    };
+}
+function itemClaims(raw, item, seen) {
+    if (item.units.includes("zero_page")) {
+        if (seen.has("zero_page"))
+            return { error: `zero_page is claimed twice; join the ranges with "+"` };
+        seen.add("zero_page");
+        const zp = zeroPageClaim(item);
+        return "error" in zp ? zp : [zp];
+    }
+    if (item.addr)
+        return { error: `"${raw}": only zero_page takes addresses` };
+    if (item.relocatable)
+        return { error: `"${raw}": only zero_page can be relocatable` };
+    const out = [];
+    for (const u of item.units) {
+        if (seen.has(u))
+            return { error: `${u} is claimed twice` };
+        seen.add(u);
+        out.push({ unit: u, mode: item.mode });
+    }
+    return out;
+}
+/**
+ * Parse the value of a **Claims:** line. `none` alone returns an empty list
+ * (claims no unit). Anything outside the grammar returns an error and the
+ * whole line is refused: a partial claim set would read as a complete one.
+ */
+export function parseClaims(raw) {
+    const items = splitTopLevel(raw.replace(/`/g, "").trim());
+    if (items.length === 0)
+        return { error: "empty Claims line" };
+    if (items.length === 1 && items[0]?.toLowerCase() === "none")
+        return [];
+    const claims = [];
+    const seen = new Set();
+    for (const raw of items) {
+        const item = parseItem(raw);
+        if ("error" in item)
+            return item;
+        const got = itemClaims(raw, item, seen);
+        if ("error" in got)
+            return got;
+        claims.push(...got);
+    }
+    return claims;
+}
+//# sourceMappingURL=claims.js.map

package/dist/graph/claims.js.map

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

package/dist/graph/extract/archetype.js

@@ -0,0 +1,118 @@
+/**
+ * archetype-reference pages (docs/CONVENTIONS-archetypes.md). The H2 is the
+ * free-form title and an **Archetype:** line under it carries the
+ * snake_case name. The fingerprint and pitfall lines are the edge sources.
+ */
+import { group, matchField, parseFrontmatter, splitH2Sections, warn } from "./common.js";
+import { TECHNIQUE_NAME } from "./technique-entities.js";
+const ARCHETYPE_NAME_LINE = /^\*\*Archetype:\*\*\s+`?([a-z][a-z0-9_]*)`?\s*$/m;
+const ARCHETYPE_FINGERPRINT = /^\*\*Technique fingerprint:\*\*\s+(.+)$/m;
+const ARCHETYPE_PITFALLS = /^\*\*Common pitfalls:\*\*\s+(.+)$/m;
+const ARCHETYPE_BRIEF_WORDS = /^\*\*Brief words:\*\*\s+(.+)$/m;
+/**
+ * The **Brief words:** line: comma-separated words or phrases, backticks
+ * optional, that route a game brief naming no archetype to this one. Lower
+ * case; an apostrophe is dropped and any other run of characters that are
+ * not letters or digits reads as one space, so "beat-em-up" and "beat 'em
+ * up" are one phrase. The briefing normalises the brief the same way.
+ */
+export function normaliseBriefText(text) {
+    return text
+        .toLowerCase()
+        .replace(/['’`]/g, "")
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+function briefWordList(line) {
+    if (!line)
+        return [];
+    const words = line.split(",").map((w) => normaliseBriefText(w));
+    return [...new Set(words.filter((w) => w !== ""))];
+}
+// The starter project in templates/ that plays this archetype. That the
+// directory exists is a test (test/extract-archetype-starters.test.ts), not an
+// extract-time read: the extractor does no file IO.
+const ARCHETYPE_STARTER = /^\*\*Starter:\*\*\s+`?([a-z][a-z0-9-]*)`?\s*$/m;
+function isArchetypeKind(kind) {
+    return kind === "game" || kind === "demo";
+}
+/**
+ * Split a backticked, comma-separated name list; refuse anything that is
+ * not a snake_case name here. Whether a name exists in the graph is settled
+ * at link time, where a miss is warned about and counted.
+ */
+function nameList(line, where, label) {
+    if (!line)
+        return [];
+    const out = [];
+    for (const raw of line.split(",")) {
+        const n = raw.trim().replace(/`/g, "");
+        if (!n)
+            continue;
+        if (!TECHNIQUE_NAME.test(n)) {
+            warn(`${where} lists "${n}" under ${label}, which is not a snake_case name — not ingested (see CONVENTIONS-archetypes.md)`);
+            continue;
+        }
+        if (out.includes(n))
+            continue;
+        out.push(n);
+    }
+    return out;
+}
+/** The archetype name a section declares, or null (warning when the section looks like a botched archetype). */
+function sectionName(section, title, ctx) {
+    const nameM = ARCHETYPE_NAME_LINE.exec(section.body);
+    if (!nameM) {
+        // A prose H2 on an archetype page (history, cross-references, a
+        // buildable-reference table) is allowed and silent. Only a section that
+        // carries a fingerprint or pitfall line without naming its archetype is
+        // a mistake worth a warning.
+        if (ARCHETYPE_FINGERPRINT.test(section.body) || ARCHETYPE_PITFALLS.test(section.body)) {
+            warn(`${ctx.sourcePath}: H2 "${title}" has a fingerprint or pitfall line but no **Archetype:** line — not ingested (see CONVENTIONS-archetypes.md)`);
+        }
+        return null;
+    }
+    const name = group(nameM, 1);
+    if (ctx.seenNames.has(name)) {
+        warn(`${ctx.sourcePath}: archetype name "${name}" appears under two H2s — second one not ingested`);
+        return null;
+    }
+    ctx.seenNames.add(name);
+    return name;
+}
+function sectionEntities(section, ctx) {
+    const title = section.heading.replace(/^##\s+/, "").trim();
+    const name = sectionName(section, title, ctx);
+    if (name === null)
+        return [];
+    const where = `${ctx.sourcePath}: archetype ${name}`;
+    const features = nameList(matchField(section.body, ARCHETYPE_FINGERPRINT), where, "**Technique fingerprint:**");
+    const risks = nameList(matchField(section.body, ARCHETYPE_PITFALLS), where, "**Common pitfalls:**");
+    const briefWords = briefWordList(matchField(section.body, ARCHETYPE_BRIEF_WORDS));
+    const starterM = ARCHETYPE_STARTER.exec(section.body);
+    const starter = starterM ? { starter: group(starterM, 1) } : {};
+    return [
+        {
+            type: "archetype",
+            name,
+            title,
+            kind: ctx.kind,
+            source_doc: ctx.sourcePath,
+            brief_words: briefWords,
+            ...starter,
+        },
+        ...features.map((technique) => ({ type: "archetype_features", archetype: name, technique })),
+        ...risks.map((pitfall) => ({ type: "archetype_risks", archetype: name, pitfall })),
+    ];
+}
+export function parseArchetypeDoc(content, sourcePath) {
+    const { fm, rest } = parseFrontmatter(content);
+    const kind = fm.kind ?? "game";
+    if (!isArchetypeKind(kind)) {
+        warn(`${sourcePath}: archetype doc kind "${kind}" is not game or demo — no archetypes ingested from this file (see CONVENTIONS-archetypes.md)`);
+        return [];
+    }
+    const ctx = { kind, sourcePath, seenNames: new Set() };
+    return splitH2Sections(rest).flatMap((section) => sectionEntities(section, ctx));
+}
+//# sourceMappingURL=archetype.js.map