c64-kb 0.17.0

package/dist/services/vice-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vice-bin.js","sourceRoot":"","sources":["../../src/services/vice-bin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,4EAA4E;AAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAChD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAItF,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAClC,IAAI,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC/E,IAAI,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACnG,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;aAC3E,QAAQ,EAAE;aACV,IAAI,EAAE,CAAC;QACV,IAAI,KAAK;YAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,oBAAoB;IACtB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,MAA0B;IACtD,IAAI,CAAC,MAAM;QAAE,OAAO,iEAAiE,CAAC;IACtF,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,UAAU,MAAM,CAAC,IAAI,cAAc,CAAC;IACtE,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,UAAU,MAAM,CAAC,IAAI,qBAAqB,CAAC;IAClF,OAAO,UAAU,MAAM,CAAC,IAAI,8FAA8F,CAAC;AAC7H,CAAC"}

package/dist/tools/briefings/archetype.js

@@ -0,0 +1,174 @@
+/**
+ * Archetype resolution against the graph, and the techniques a brief or an
+ * archetype forces into the proposal.
+ */
+import { getFalkor } from "../../context.js";
+import { normaliseBriefText } from "../../graph/extract/archetype.js";
+import { ArchetypeRow, BriefWordsRow, NameRow, parseRows } from "./rows.js";
+/** "Vertical Shmup" / "vertical-shmup" / "Vertical_Shmup" all read as vertical_shmup. */
+function normaliseArchetypeName(raw) {
+    return raw
+        .trim()
+        .toLowerCase()
+        .replace(/[\s-]+/g, "_");
+}
+async function knownArchetypes() {
+    const fk = await getFalkor();
+    const all = await fk.roQuery(`MATCH (a:Archetype) RETURN a.name AS name, a.title AS title, a.kind AS kind, a.starter AS starter ORDER BY name`);
+    return parseRows(ArchetypeRow, all.data).flatMap((r) => r.name ? [{ name: r.name, title: r.title, kind: r.kind, starter: r.starter }] : []);
+}
+async function namesOf(cypher, name) {
+    const fk = await getFalkor();
+    const result = await fk.roQuery(cypher, { name });
+    // t.name / p.name is set on every ingested node; a null would print as "".
+    return parseRows(NameRow, result.data).map((x) => x.name ?? "");
+}
+/**
+ * Exact name first. A partial name ("platformer", "shmup") resolves when
+ * exactly one archetype contains every word of it; several matches are
+ * reported as candidates rather than guessed between. The first blind build
+ * spent a call learning that "platformer" is not a name.
+ */
+function matchArchetype(rows, wanted, raw) {
+    // Names are unique across every archetype page (the ingest MERGEs on
+    // name alone), so at most one row matches exactly.
+    const exact = rows.filter((r) => r.name === wanted);
+    if (exact.length > 0 || !wanted)
+        return { hits: exact };
+    const words = wanted.split("_").filter(Boolean);
+    const partial = rows.filter((r) => {
+        const parts = r.name.split("_");
+        return words.every((w) => parts.includes(w) || r.name.includes(w));
+    });
+    const distinct = [...new Set(partial.map((r) => r.name))];
+    if (distinct.length === 1)
+        return { hits: partial, resolvedFrom: raw };
+    if (distinct.length > 1)
+        return { candidates: distinct };
+    return { hits: [] };
+}
+/**
+ * Look the archetype up. When the graph holds no Archetype nodes at all
+ * (fixture graphs, a store ingested before schema 21) the result is
+ * "fallback" and the caller uses the built-in tables; a graph with
+ * archetypes never falls back, so an unknown name is reported, not guessed.
+ */
+export async function resolveArchetype(raw, preferKind) {
+    const rows = await knownArchetypes();
+    if (rows.length === 0)
+        return { mode: "fallback" };
+    const known = () => [...new Set(rows.map((r) => r.name))];
+    const match = matchArchetype(rows, normaliseArchetypeName(raw), raw);
+    if ("candidates" in match) {
+        return { mode: "not_found", requested: raw, known: known(), candidates: match.candidates };
+    }
+    // preferKind is a guard only: names are unique.
+    const hit = match.hits.find((r) => r.kind === preferKind) ?? match.hits.at(0);
+    if (!hit)
+        return { mode: "not_found", requested: raw, known: known() };
+    return {
+        ...(await graphResolution(hit)),
+        ...(match.resolvedFrom ? { resolved_from: match.resolvedFrom } : {}),
+    };
+}
+async function graphResolution(hit) {
+    const features = await namesOf(`MATCH (a:Archetype {name: $name})-[:FEATURES]->(t:Technique) RETURN t.name AS name ORDER BY name`, hit.name);
+    const risks = await namesOf(`MATCH (a:Archetype {name: $name})-[:RISKS]->(p:Pitfall) RETURN p.name AS name ORDER BY name`, hit.name);
+    return {
+        mode: "graph",
+        archetype: {
+            name: hit.name,
+            title: hit.title ?? hit.name,
+            kind: hit.kind ?? "game",
+            ...(hit.starter ? { starter: hit.starter } : {}),
+        },
+        features,
+        risks,
+    };
+}
+/** The brief words of `words` that the normalised brief contains, a plural "s" or "es" allowed. */
+function wordsInBrief(brief, words) {
+    return words.filter((w) => new RegExp(`(^| )${w}(s|es)?( |$)`).test(brief));
+}
+/**
+ * Route a game brief that names no archetype. Each game Archetype's
+ * **Brief words:** line (docs/CONVENTIONS-archetypes.md) is matched against
+ * the brief; the archetype with the most distinct words present wins. A tie
+ * or no match routes nowhere and the plan is built from the description, as
+ * before. The words are data on the page, so no genre or title is spelled
+ * in this code.
+ */
+export async function routeArchetypeFromBrief(description) {
+    const fk = await getFalkor();
+    const result = await fk.roQuery(`MATCH (a:Archetype {kind: "game"}) RETURN a.name AS name, a.title AS title, a.kind AS kind, a.starter AS starter, a.brief_words AS brief_words ORDER BY name`);
+    const brief = normaliseBriefText(description);
+    const scored = parseRows(BriefWordsRow, result.data).flatMap((r) => {
+        if (!r.name)
+            return [];
+        const matched = wordsInBrief(brief, r.brief_words ?? []);
+        return matched.length > 0
+            ? [{ row: { name: r.name, title: r.title, kind: r.kind, starter: r.starter }, matched }]
+            : [];
+    });
+    scored.sort((a, b) => b.matched.length - a.matched.length);
+    const [first, second] = scored;
+    if (!first || second?.matched.length === first.matched.length)
+        return undefined;
+    return { ...(await graphResolution(first.row)), inferred_from: first.matched };
+}
+// Built-in tables, used ONLY when the graph has no Archetype nodes. With the
+// archetype page ingested (schema 21) the page is the source of truth and
+// these are never read.
+const FALLBACK_ARCHETYPE_TERMS = new Map([
+    ["shmup", "sprite multiplex scroll raster SID music shoot enemy"],
+    ["platformer", "sprite scroll character collision SID music jump"],
+    ["puzzle", "text mode overlay render playfield piece field character SID music logic"],
+    ["adventure", "text mode overlay render character scroll SID music KERNAL"],
+]);
+const FALLBACK_FORCED_TECHNIQUES = new Map([
+    ["puzzle", ["text_mode_overlay_render"]],
+    ["adventure", ["text_mode_overlay_render"]],
+]);
+// Description-level signals that force specific techniques regardless of
+// archetype (e.g. a demo brief mentioning "text-mode playfield" should
+// still get the rendering pitfall surfaced).
+const FORCED_BY_DESCRIPTION_PATTERN = [
+    {
+        pattern: /\b(text[- ]mode|petscii|playfield|tetris|tetromino|sokoban|boulder dash|board game|falling (block|piece))\b/i,
+        techniques: ["text_mode_overlay_render"],
+    },
+];
+/**
+ * For game briefs the archetype comes from the graph: its title widens the
+ * search, its FEATURES are forced into the proposal (they survive the
+ * per-category cap: the page authored them, the keyword scorer did not
+ * guess them), its RISKS join the pitfalls. Only a graph with no Archetype
+ * nodes reads the built-in tables.
+ */
+export function seedsFor(opts) {
+    const { description, archetype, resolved, isGame } = opts;
+    let searchDescription = description;
+    const forced = [];
+    if (resolved?.mode === "graph") {
+        searchDescription = `${description} ${resolved.archetype.title}`;
+        forced.push(...resolved.features);
+    }
+    else if (resolved?.mode === "fallback" && archetype && isGame) {
+        // The built-in tables are game genres; a demo form has no fallback.
+        const key = archetype.toLowerCase();
+        const terms = FALLBACK_ARCHETYPE_TERMS.get(key);
+        if (terms)
+            searchDescription = `${description} ${terms}`;
+        forced.push(...(FALLBACK_FORCED_TECHNIQUES.get(key) ?? []));
+    }
+    for (const rule of FORCED_BY_DESCRIPTION_PATTERN) {
+        if (!rule.pattern.test(description))
+            continue;
+        for (const t of rule.techniques)
+            if (!forced.includes(t))
+                forced.push(t);
+    }
+    const archetypeForced = new Set(resolved?.mode === "graph" ? resolved.features : []);
+    return { searchDescription, forced, archetypeForced };
+}
+//# sourceMappingURL=archetype.js.map

package/dist/tools/briefings/archetype.js.map

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

package/dist/tools/briefings/budget.js

@@ -0,0 +1,177 @@
+/**
+ * The plan added up (schema 22, tools 1.25.0): the proposed set's cycles
+ * and bytes against a frame and a RAM budget, and the text that shows it.
+ *
+ * Since schema 27 (tools 2.0.0) the arithmetic is planBudget
+ * (src/domain/budget.ts), the same rules c64_plan_budget applies, with every
+ * proposed technique in one play frame. Before, this summed every
+ * cycles_per_frame: a 74,041-cycle full-screen shift counted as a per-frame
+ * cost, a missing figure counted as zero, and work one figure already held
+ * counted twice (design 2.1 measured errors from -96 % to about 10× over).
+ */
+import { planBudget } from "../../domain/budget.js";
+// PAL: 63 cycles × 312 lines; NTSC: 65 × 263. The same constants
+// c64_timing_budget uses.
+export const FRAME_CYCLES = { PAL: 19656, NTSC: 17095 };
+// The RAM budget the byte sum is judged against: $0801 to $9FFF, the BASIC
+// program area a PRG loads into with the ROMs in place (0x9FFF - 0x0801 + 1
+// = 38,911 bytes, the figure the boot banner prints). It is an assumption,
+// stated in the output; a program that banks BASIC out or loads under the
+// KERNAL has more, and the caller can re-judge the sum against its own map.
+export const RAM_BUDGET_BYTES = 38911;
+function regionNote(regionHint, members) {
+    if (regionHint)
+        return "";
+    const locked = members.some((m) => /^(pal|ntsc)$/i.test(m.requires_region ?? ""));
+    return locked
+        ? " (chosen from the set's REQUIRES_REGION edges)"
+        : " (no technique in the set is region-locked; PAL assumed)";
+}
+function contributorsOf(members, phase, bytes) {
+    const summed = new Map(phase.contributors.map((c) => [c.name, c]));
+    const out = [];
+    for (const m of members) {
+        if (!m.cost)
+            continue;
+        const c = summed.get(m.name);
+        const b = bytes.get(m.name);
+        out.push({
+            name: m.name,
+            ...(c ? { cycles_per_frame: c.high } : {}),
+            ...(c && c.low !== c.high ? { cycles_per_frame_typical: c.low } : {}),
+            ...(b !== undefined ? { bytes: b } : {}),
+            basis: m.cost.basis,
+            ...(m.cost.measured_on ? { measured_on: m.cost.measured_on } : {}),
+        });
+    }
+    return out;
+}
+function cyclesVerdict(p) {
+    if (p.contributors.length === 0 && p.excluded.length === 0 && p.unknown.length === 0)
+        return "no_data";
+    if (p.verdict === "fits")
+        return "under";
+    return p.verdict;
+}
+function assumptionsFor(region, note, p, withoutCost) {
+    const out = [
+        `Region ${region}: ${FRAME_CYCLES[region]} cycles per frame${note}.`,
+        `RAM budget ${RAM_BUDGET_BYTES} bytes: the BASIC program area $0801-$9FFF with the ROMs in place. Re-judge the byte sum against your own memory map if you bank BASIC out or load under the KERNAL.`,
+        "This adds up a proposal, every technique in one play frame. c64_plan_budget takes your own list with phases (play, transition, init) and shows each rule it applied.",
+        "Each technique's figures are what its own page states, measured on the recipe it names; bytes are that recipe's segments, not a minimal implementation.",
+        ...p.notes,
+    ];
+    if (withoutCost > 0)
+        out.push(`${withoutCost} proposed technique(s) have no Cost line.`);
+    return out;
+}
+/**
+ * Add a proposed set up against a frame and a RAM budget. Pure, so a test
+ * can hand it a fixture. The region is PAL unless every region-locked
+ * technique in the set is NTSC-locked; the choice is written into
+ * `assumptions`.
+ */
+export function computeBudget(techs, regionHint) {
+    const members = techs.map((t) => ({ ...t, found: t.found ?? true, phase: "play" }));
+    const plan = planBudget(members, regionHint ? { region: regionHint } : {});
+    const phase = plan.phases.at(0);
+    const region = phase?.region ?? regionHint ?? "PAL";
+    const frame_cycles = FRAME_CYCLES[region];
+    const bytes = new Map(plan.bytes.contributors.map((c) => [c.name, c.bytes]));
+    const without_cost = techs.filter((t) => !t.cost).map((t) => t.name);
+    const empty = {
+        phase: "play",
+        region,
+        frame: frame_cycles,
+        members: [],
+        contributors: [],
+        excluded: [],
+        unknown: [],
+        not_found: [],
+        to_measure: [],
+        fixed_losses: { badlines: 0, sprite_dma: 0, charged_for: [], badlines_in_bands: 0, floor: 0 },
+        worst_only: [],
+        low: 0,
+        high: 0,
+        floor: 0,
+        verdict: "undetermined",
+        weakest_basis: null,
+        irq_slots: 0,
+        notes: [],
+    };
+    const p = phase ?? empty;
+    return {
+        region,
+        frame_cycles,
+        cycles_per_frame_sum: p.high,
+        cycles_low: p.low,
+        fixed_loss_cycles: p.fixed_losses.badlines + p.fixed_losses.sprite_dma,
+        cycles_verdict: cyclesVerdict(p),
+        ram_budget_bytes: RAM_BUDGET_BYTES,
+        bytes_sum: plan.bytes.sum,
+        bytes_verdict: plan.bytes.contributors.length === 0 ? "no_data" : plan.bytes.sum > RAM_BUDGET_BYTES ? "over" : "under",
+        contributors: contributorsOf(techs, p, bytes),
+        excluded: [
+            ...p.excluded.map((e) => ({ name: e.name, reason: e.reason, ...(e.by ? { by: e.by } : {}) })),
+            ...plan.bytes.excluded.map((e) => ({ name: e.name, reason: "whole_program_bytes" })),
+        ],
+        unknown: p.unknown,
+        to_measure: p.to_measure.map((m) => ({ technique: m.technique, recipe: m.recipe })),
+        without_cost,
+        weakest_basis: p.weakest_basis,
+        is_floor: p.unknown.length > 0,
+        assumptions: assumptionsFor(region, regionNote(regionHint, techs), p, without_cost.length),
+    };
+}
+function verdictCell(v) {
+    if (v === "no_data")
+        return "no data";
+    return v === "undetermined" ? "undetermined" : `${v} budget`;
+}
+function cyclesCell(g) {
+    const range = g.cycles_low === g.cycles_per_frame_sum
+        ? `${g.cycles_per_frame_sum}`
+        : `${g.cycles_low}-${g.cycles_per_frame_sum}`;
+    return g.fixed_loss_cycles > 0 ? `${range} + ${g.fixed_loss_cycles} badlines` : range;
+}
+function excludedText(e) {
+    if (e.reason === "multi_frame")
+        return `${e.name} (above one frame: a multi-frame operation)`;
+    if (e.reason === "whole_program_bytes")
+        return `${e.name} bytes (the whole program, not the technique)`;
+    return `${e.name} (${e.reason === "included_by" ? "inside" : "in the raster band of"} ${e.by ?? "?"})`;
+}
+function contributorText(c) {
+    const parts = [];
+    if (c.cycles_per_frame !== undefined) {
+        const typical = c.cycles_per_frame_typical !== undefined ? `${c.cycles_per_frame_typical}-` : "";
+        parts.push(`${typical}${c.cycles_per_frame} cycles/frame`);
+    }
+    if (c.bytes !== undefined)
+        parts.push(`${c.bytes} bytes`);
+    const on = c.measured_on ? `, on ${c.measured_on}` : "";
+    return `- ${c.name}: ${parts.join(", ") || "(no summable figure)"} (${c.basis}${on})\n`;
+}
+export function renderBudgetText(g) {
+    let out = `\n## Budget (${g.region})\n\n`;
+    out += `| Sum | Value | Limit | Verdict |\n|-----|-------|-------|---------|\n`;
+    out += `| Cycles per frame | ${cyclesCell(g)} | ${g.frame_cycles} | ${verdictCell(g.cycles_verdict)} |\n`;
+    out += `| Bytes (code + data) | ${g.bytes_sum} | ${g.ram_budget_bytes} | ${verdictCell(g.bytes_verdict)} |\n`;
+    if (g.contributors.length > 0) {
+        out += `\nContributors:\n`;
+        for (const c of g.contributors)
+            out += contributorText(c);
+    }
+    if (g.excluded.length > 0)
+        out += `\nLeft out: ${g.excluded.map(excludedText).join("; ")}.\n`;
+    out += `\nWeakest basis: ${g.weakest_basis ?? "(nothing contributed)"}.\n`;
+    if (g.unknown.length > 0) {
+        out += `Unknown, not zero, so the verdict cannot be under: ${g.unknown.join(", ")}.\n`;
+    }
+    if (g.without_cost.length > 0)
+        out += `No Cost line: ${g.without_cost.join(", ")}.\n`;
+    for (const a of g.assumptions)
+        out += `- ${a}\n`;
+    return out;
+}
+//# sourceMappingURL=budget.js.map

package/dist/tools/briefings/budget.js.map

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

package/dist/tools/briefings/build-order.js

@@ -0,0 +1,135 @@
+/**
+ * The briefing's build order: an optional game scaffold step, one step per
+ * dependency tier of the proposed techniques, and the headless harness.
+ */
+import { getFalkor } from "../../context.js";
+import { parseRows, ScaffoldRow } from "./rows.js";
+// Group techniques by category and assign steps in dependency order:
+// 1. Foundation (raster/IRQ prerequisites)
+// 2. Hardware setup (banking, memory layout)
+// 3. Visual effects (sprites, scroll, bitmap, effects)
+// 4. Audio (music, SID)
+// 5. Loader/compression (last — wrap everything)
+const STEP_PRIORITY = new Map([
+    ["raster", 1],
+    ["banking", 2],
+    ["cpu", 2],
+    ["input", 2],
+    ["maths", 2],
+    ["sprite", 3],
+    ["scroll", 3],
+    ["bitmap", 3],
+    ["effect", 3],
+    ["render", 3],
+    ["logic", 3],
+    ["text", 3],
+    ["music", 4],
+    ["loader", 5],
+    ["io", 5],
+]);
+const STEP_LABELS = new Map([
+    [1, "Raster IRQ foundation"],
+    [2, "Memory layout, banking, input and maths"],
+    [3, "Visual / text-mode rendering and game logic"],
+    [4, "SID audio"],
+    [5, "Loader, compression and file I/O"],
+]);
+async function scaffoldRecipes(resolved, archetypeKey, pages) {
+    // With the archetype resolved in the graph, the scaffold recipes are the
+    // ones whose frontmatter says scaffolds: [<archetype>] (a Recipe
+    // SCAFFOLDS Archetype edge, docs/ONTOLOGY.md). The fallback tables know
+    // no edges, so a fallback shmup key still offers the seed shmup recipe
+    // by name when its node exists.
+    let cypher;
+    let params;
+    if (resolved?.mode === "graph") {
+        cypher = `MATCH (r:Recipe)-[:SCAFFOLDS]->(a:Archetype {name: $name}) RETURN r.name AS name, r.source_doc AS source_doc ORDER BY name`;
+        params = { name: resolved.archetype.name };
+    }
+    else if (resolved?.mode === "fallback" && archetypeKey.includes("shmup")) {
+        cypher = `MATCH (r:Recipe {name: "oscar64-simple-shmup"}) RETURN r.name AS name, r.source_doc AS source_doc`;
+    }
+    else {
+        return [];
+    }
+    const fk = await getFalkor();
+    const result = await fk.roQuery(cypher, params);
+    let rows = parseRows(ScaffoldRow, result.data);
+    // The fallback lookup reads its first row only.
+    if (resolved.mode === "fallback")
+        rows = rows.slice(0, 1);
+    const recipes = [];
+    for (const row of rows) {
+        if (!row.name)
+            continue;
+        recipes.push(row.name);
+        if (row.source_doc)
+            pages.set(row.name, row.source_doc);
+    }
+    return recipes;
+}
+/**
+ * The scaffold step for a game brief. In the not-found case the label says
+ * "generic": the graph did not recognise the name, so the scaffold must not
+ * be labelled with it, and nothing is offered.
+ */
+async function scaffoldStep(resolved, archetype, pages) {
+    let archetypeKey = (archetype ?? "").toLowerCase();
+    if (resolved?.mode === "graph")
+        archetypeKey = resolved.archetype.name;
+    else if (resolved?.mode === "not_found")
+        archetypeKey = "";
+    return {
+        label: `Game scaffold (${archetypeKey || "generic"} archetype)`,
+        recipes: await scaffoldRecipes(resolved, archetypeKey, pages),
+    };
+}
+function techniqueSteps(techs) {
+    const grouped = new Map();
+    for (const tech of techs) {
+        const priority = STEP_PRIORITY.get(tech.category) ?? 3;
+        const group = grouped.get(priority) ?? [];
+        group.push(tech);
+        grouped.set(priority, group);
+    }
+    return Array.from(grouped.entries())
+        .sort((a, b) => a[0] - b[0])
+        .map(([priority, group]) => ({
+        label: STEP_LABELS.get(priority) ?? `${group[0]?.category ?? ""} techniques`,
+        recipes: [...new Set(group.flatMap((t) => t.recipes.map((r) => r.name)))],
+    }));
+}
+/**
+ * Every plan ends with the harness: the exit code from the $02FF byte and
+ * the border is how a build proves itself without a human, and a brief
+ * that asks for a "headless harness" has no technique node to reach it
+ * through. Offered when the primary toolchain's recipe is in the graph.
+ */
+async function harnessStep() {
+    const fk = await getFalkor();
+    const harness = await fk.roQuery(`MATCH (r:Recipe {name: "oscar64-headless-verify"}) RETURN r.name AS name`);
+    if (harness.data.length === 0)
+        return undefined;
+    return {
+        label: "Headless verification (exit code from the $02FF byte and the border)",
+        recipes: ["oscar64-headless-verify"],
+    };
+}
+export async function buildOrder(opts) {
+    // The text renderer prints each scaffold recipe's page so the agent knows
+    // which file to copy. It rides outside the structured output, whose shape
+    // does not change.
+    const scaffoldPages = new Map();
+    const steps = [];
+    // A game brief that named no archetype and was routed to none has no
+    // scaffold to offer, so it gets no scaffold step.
+    if (opts.isGame && opts.resolved !== undefined) {
+        steps.push(await scaffoldStep(opts.resolved, opts.archetype, scaffoldPages));
+    }
+    steps.push(...techniqueSteps(opts.techs));
+    const harness = await harnessStep();
+    if (harness)
+        steps.push(harness);
+    return { build_order: steps.map((s, i) => ({ step: i + 1, ...s })), scaffoldPages };
+}
+//# sourceMappingURL=build-order.js.map

package/dist/tools/briefings/build-order.js.map

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