c64-kb 0.17.0

package/dist/tools/briefings/render.js

@@ -0,0 +1,151 @@
+/**
+ * The briefing as text: the one-paragraph brief summary and the markdown
+ * report the CLI and MCP text channel print.
+ */
+import { renderBudgetText } from "./budget.js";
+function archetypeLabel(resolved, archetype, kindWord) {
+    if (resolved?.mode === "graph")
+        return ` (${kindWord}: ${resolved.archetype.name}, ${resolved.archetype.title})`;
+    if (resolved?.mode === "not_found")
+        return ` (${kindWord} "${archetype ?? ""}" is not an archetype the graph knows)`;
+    return archetype ? ` (${kindWord}: ${archetype})` : "";
+}
+function budgetPhrase(budget) {
+    if (budget.cycles_verdict === "no_data")
+        return "no cycle figures";
+    const range = budget.cycles_low === budget.cycles_per_frame_sum
+        ? `${budget.cycles_per_frame_sum}`
+        : `${budget.cycles_low}-${budget.cycles_per_frame_sum}`;
+    const fixed = budget.fixed_loss_cycles > 0 ? ` + ${budget.fixed_loss_cycles} badlines` : "";
+    const unknown = budget.unknown.length > 0 ? `; ${budget.unknown.length} member(s) with no cycles figure` : "";
+    return `${range}${fixed} of ${budget.frame_cycles} ${budget.region} cycles per frame, ${budget.cycles_verdict}${unknown}`;
+}
+export function briefSummary(opts) {
+    const { description, isGame, plan } = opts;
+    const label = archetypeLabel(opts.resolved, opts.archetype, isGame ? "genre" : "form");
+    const categories = new Set(plan.proposed_techniques.map((t) => t.category)).size;
+    const handoff = plan.toolchain_split.cycle_tight_handoff.length;
+    return (`C64 ${isGame ? "game" : "demo"} plan for: "${description}"${label}. ` +
+        `Proposed ${plan.proposed_techniques.length} technique(s) across ${categories} categories. ` +
+        `Compatibility: ${opts.verdict}. ` +
+        `Pitfalls to watch: ${plan.pitfalls.length}. ` +
+        `Toolchain: Oscar64 primary${handoff > 0 ? `, KickAssembler for ${handoff} cycle-tight component(s)` : ""}. ` +
+        `Budget: ${budgetPhrase(plan.budget)}.`);
+}
+function renderArchetype(b) {
+    let out = "";
+    const missing = b.archetype_not_found;
+    if (missing) {
+        out +=
+            `**Archetype not found:** "${missing.requested}".` +
+                (missing.candidates?.length ? ` Did you mean one of: ${missing.candidates.join(", ")}?` : "") +
+                ` Known archetypes: ${missing.known.join(", ")}\n\n`;
+    }
+    if (b.archetype) {
+        out += `**Archetype:** ${b.archetype.name} (${b.archetype.title}, ${b.archetype.kind})\n`;
+        if (b.archetype.inferred_from) {
+            out += `Routed from the brief's words: ${b.archetype.inferred_from.join(", ")} (pass archetype to choose another)\n`;
+        }
+        out += `Fingerprint: ${b.archetype.features.join(", ") || "(none)"}\n`;
+        out += `Common pitfalls: ${b.archetype.risks.join(", ") || "(none)"}\n`;
+        if (b.archetype.starter) {
+            out += `Starter: templates/${b.archetype.starter} (a playable project on the build-and-check harness; `;
+            out += `start with \`npm run new-project -- ${b.archetype.starter} <dir>\` in the c64-kb checkout)\n`;
+        }
+        out += "\n";
+    }
+    for (const d of b.designs ?? []) {
+        const measured = d.measured
+            .map((m) => `${m.phase} ${m.region} worst ${m.worst}${m.typical !== null ? `, typical ${m.typical}` : ""}`)
+            .join("; ");
+        out +=
+            `**Game design:** ${d.name} (${d.title}), realised by ${d.realised_by.join(", ") || "(no recipe)"}; ` +
+                `${measured ? `measured ${measured} cycles` : "no measured frame"}. ` +
+                `Budget it with c64_plan_budget {"design": "${d.name}"}.\n`;
+    }
+    if ((b.designs ?? []).length > 0)
+        out += "\n";
+    return out;
+}
+const orNone = (xs) => (xs.length > 0 ? xs.join(", ") : "(none)");
+function renderTechniques(b) {
+    let out = `## Proposed Techniques (${b.proposed_techniques.length})\n\n`;
+    out += `| Name | Category | Complexity | Why |\n|------|----------|------------|-----|\n`;
+    for (const t of b.proposed_techniques) {
+        out += `| ${t.name} | ${t.category} | ${t.complexity ?? "-"} | ${t.why_proposed} |\n`;
+    }
+    if (b.proposed_techniques.length > 0) {
+        out += `\n### Register + KERNAL dependencies\n\n`;
+        for (const t of b.proposed_techniques) {
+            out += `- **${t.name}**: registers [${orNone(t.uses_registers)}], KERNAL [${orNone(t.uses_kernal)}]\n`;
+        }
+    }
+    return out;
+}
+function renderCompatibility(b) {
+    let out = `\n## Compatibility\n\n`;
+    const allConflicts = [...b.compatibility.conflicts, ...b.compatibility.warnings];
+    if (allConflicts.length === 0)
+        out += `No conflicts detected.\n`;
+    for (const c of allConflicts)
+        out += `- **${c.kind}**: ${c.a} × ${c.b} — ${c.rationale}\n`;
+    if (b.compatibility.shared_infrastructure.length > 0) {
+        out += `\n**Shared infrastructure:** `;
+        out += b.compatibility.shared_infrastructure.map((s) => s.name).join(", ") + "\n";
+    }
+    return out;
+}
+function renderPitfalls(b) {
+    let out = `\n## Pitfalls to Avoid (${b.pitfalls.length})\n\n`;
+    if (b.pitfalls.length === 0)
+        out += `No specific pitfalls identified.\n`;
+    for (const p of b.pitfalls) {
+        const triggers = p.triggered_by_proposed.length > 0
+            ? p.triggered_by_proposed.join(", ")
+            : "(archetype risk; no proposed technique triggers it)";
+        out += `- **[${p.severity.toUpperCase()}]** ${p.name}: ${p.title}\n`;
+        out += `  Triggered by: ${triggers}\n`;
+    }
+    return out;
+}
+function renderToolchain(b) {
+    let out = `\n## Toolchain Split\n\n`;
+    out += `**Primary:** ${b.toolchain_split.primary}\n`;
+    out += `${b.toolchain_split.rationale}\n`;
+    if (b.toolchain_split.cycle_tight_handoff.length > 0) {
+        out += `**KickAssembler handoff:** ${b.toolchain_split.cycle_tight_handoff.join(", ")}\n`;
+    }
+    return out;
+}
+function renderBuildOrder(b, scaffoldPages) {
+    let out = `\n## Build Order\n\n`;
+    for (const step of b.build_order) {
+        out += `${step.step}. **${step.label}**`;
+        if (step.recipes.length > 0)
+            out += ` → recipes: ${step.recipes.join(", ")}`;
+        out += `\n`;
+        // The scaffold step names the page to copy, not just the recipe. Only
+        // that step: a scaffold recipe also implements techniques, so its name
+        // recurs in later steps, where the page line would be noise.
+        if (!step.label.startsWith("Game scaffold"))
+            continue;
+        for (const name of step.recipes) {
+            const page = scaffoldPages.get(name);
+            if (page)
+                out += `   copy the scaffold from docs/${page.replace(/^docs\//, "")} (recipe ${name})\n`;
+        }
+    }
+    return out;
+}
+export function renderBriefingText(b, isGame, scaffoldPages = new Map()) {
+    return (`# C64 ${isGame ? "Game" : "Demo"} Briefing\n\n` +
+        `**Brief:** ${b.brief}\n\n` +
+        renderArchetype(b) +
+        renderTechniques(b) +
+        renderCompatibility(b) +
+        renderPitfalls(b) +
+        renderToolchain(b) +
+        renderBuildOrder(b, scaffoldPages) +
+        renderBudgetText(b.budget));
+}
+//# sourceMappingURL=render.js.map

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

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

package/dist/tools/briefings/rows.js

@@ -0,0 +1,41 @@
+/**
+ * FalkorDB rows come back as `unknown[]`. Each query in the briefing reads
+ * its rows through one of these schemas, so a property the graph lacks
+ * (FalkorDB returns null for it) is typed as possibly missing and the
+ * fallbacks that handle it are real guards, not decoration.
+ */
+import { z } from "zod";
+/** Parse every row of a query result; a row of the wrong shape throws. */
+export function parseRows(schema, data) {
+    return z.array(schema).parse(data);
+}
+const nullableString = z.string().nullish();
+const nameList = z.array(z.string().nullish()).nullish();
+export const TechniqueScoreRow = z.object({
+    name: z.string(),
+    title: nullableString,
+    category: nullableString,
+    complexity: nullableString,
+    recipe_count: z.union([z.number(), z.string()]).nullish(),
+});
+export const ArchetypeRow = z.object({
+    name: nullableString,
+    title: nullableString,
+    kind: nullableString,
+    starter: nullableString,
+});
+export const BriefWordsRow = ArchetypeRow.extend({ brief_words: z.array(z.string()).nullish() });
+export const NameRow = z.object({ name: nullableString });
+export const RiskPitfallRow = z.object({
+    name: z.string(),
+    title: nullableString,
+    severity: nullableString,
+    triggers: nameList,
+});
+export const DemandsRow = z.object({ name: z.string(), demands: nameList });
+export const ScaffoldRow = z.object({ name: nullableString, source_doc: nullableString });
+/** Drop null and empty entries from a collect() list. */
+export function presentNames(list) {
+    return (list ?? []).filter((x) => typeof x === "string" && x !== "");
+}
+//# sourceMappingURL=rows.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rows.js","sourceRoot":"","sources":["../../../src/tools/briefings/rows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0EAA0E;AAC1E,MAAM,UAAU,SAAS,CAAsB,MAAS,EAAE,IAAe;IACvE,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;AAC5C,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;AAEzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,cAAc;IACxB,UAAU,EAAE,cAAc;IAC1B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,cAAc;IACrB,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,cAAc;CACxB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;AAE1D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,cAAc;IACrB,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,QAAQ;CACnB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;AAE1F,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,IAAsD;IACjF,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;AACpF,CAAC"}

package/dist/tools/briefings/toolchain.js

@@ -0,0 +1,63 @@
+/**
+ * Which proposed techniques the primary toolchain (Oscar64) keeps and which
+ * are handed to KickAssembler.
+ *
+ * The handoff is decided by what a technique DEMANDS of the machine (the
+ * DEMANDS edges the compatibility checker already reads), not by its
+ * category name. Deciding by category handed starfield (effect) to
+ * assembly and sprite_multiplex_24 (sprite) to C, which was backwards.
+ */
+import { getFalkor } from "../../context.js";
+import { DemandsRow, parseRows, presentNames } from "./rows.js";
+const PRIMARY_TOOLCHAIN = "oscar64";
+const CYCLE_TIGHT_DEMANDS = new Set([
+    "cpu_every_line",
+    "midframe_raster_irqs",
+    "continuous_interrupts",
+    "badline_free_region",
+    "changes_sprite_set",
+]);
+async function demandsOf(names) {
+    const out = new Map();
+    if (names.length === 0)
+        return out;
+    const fk = await getFalkor();
+    const result = await fk.roQuery(`MATCH (t:Technique)-[:DEMANDS]->(r:Resource) WHERE t.name IN $names
+     RETURN t.name AS name, collect(r.name) AS demands`, { names });
+    for (const row of parseRows(DemandsRow, result.data))
+        out.set(row.name, presentNames(row.demands));
+    return out;
+}
+function rationaleFor(handoff, keptInPrimary) {
+    const handoffPart = handoff.length > 0
+        ? `KickAssembler handles cycle-tight work for: ${handoff.join(", ")} ` +
+            `(each needs every cycle of the line or is scene-tier, or takes raster interrupts inside the display, interrupts all frame, a badline-free region or a changing sprite set and has no Oscar64 recipe).`
+        : "No technique in this set demands cycle-exact timing of the machine that Oscar64 has no recipe for — Oscar64 can handle all components.";
+    const keptPart = keptInPrimary.length > 0
+        ? ` Cycle-tight but kept in Oscar64 because a recipe exists: ${keptInPrimary.join(", ")}.`
+        : "";
+    return ("Oscar64 is the primary toolchain per c64-kb policy (modern C/C++ → 6502, idiomatic patterns). " +
+        handoffPart +
+        keptPart);
+}
+export async function toolchainSplit(techs) {
+    const demands = await demandsOf(techs.map((t) => t.name));
+    const demandList = (t) => demands.get(t.name) ?? [];
+    const cycleTight = techs.filter((t) => demandList(t).some((d) => CYCLE_TIGHT_DEMANDS.has(d)) || t.complexity === "scene-tier");
+    // A cycle-tight technique the primary toolchain already has a recipe for
+    // stays in C: the KB's own Oscar64 stable-raster-irq, raster-bars and
+    // multiplexer recipes are the evidence that it can be done there. Only a
+    // technique that needs every cycle of the line, or is scene-tier, is
+    // handed off regardless of recipes.
+    const hasPrimaryRecipe = (t) => t.recipes.some((r) => r.toolchain === PRIMARY_TOOLCHAIN || r.name.startsWith(`${PRIMARY_TOOLCHAIN}-`));
+    const mustHandOff = (t) => demandList(t).includes("cpu_every_line") || t.complexity === "scene-tier";
+    const handedOff = cycleTight.filter((t) => mustHandOff(t) || !hasPrimaryRecipe(t));
+    const keptInPrimary = cycleTight.filter((t) => !handedOff.includes(t)).map((t) => t.name);
+    const cycle_tight_handoff = handedOff.map((t) => t.name);
+    return {
+        primary: PRIMARY_TOOLCHAIN,
+        cycle_tight_handoff,
+        rationale: rationaleFor(cycle_tight_handoff, keptInPrimary),
+    };
+}
+//# sourceMappingURL=toolchain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain.js","sourceRoot":"","sources":["../../../src/tools/briefings/toolchain.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEhE,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,gBAAgB;IAChB,sBAAsB;IACtB,uBAAuB;IACvB,qBAAqB;IACrB,oBAAoB;CACrB,CAAC,CAAC;AAEH,KAAK,UAAU,SAAS,CAAC,KAAe;IACtC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,MAAM,EAAE,GAAG,MAAM,SAAS,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAC7B;uDACmD,EACnD,EAAE,KAAK,EAAE,CACV,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;IACnG,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,OAAiB,EAAE,aAAuB;IAC9D,MAAM,WAAW,GACf,OAAO,CAAC,MAAM,GAAG,CAAC;QAChB,CAAC,CAAC,+CAA+C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACpE,uMAAuM;QACzM,CAAC,CAAC,wIAAwI,CAAC;IAC/I,MAAM,QAAQ,GACZ,aAAa,CAAC,MAAM,GAAG,CAAC;QACtB,CAAC,CAAC,6DAA6D,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC1F,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,CACL,gGAAgG;QAChG,WAAW;QACX,QAAQ,CACT,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAA8B;IAE9B,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,CAAC,CAAwB,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3E,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,YAAY,CAC9F,CAAC;IACF,yEAAyE;IACzE,sEAAsE;IACtE,yEAAyE;IACzE,qEAAqE;IACrE,oCAAoC;IACpC,MAAM,gBAAgB,GAAG,CAAC,CAAwB,EAAE,EAAE,CACpD,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,iBAAiB,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,iBAAiB,GAAG,CAAC,CAAC,CAAC;IACzG,MAAM,WAAW,GAAG,CAAC,CAAwB,EAAE,EAAE,CAC/C,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,UAAU,KAAK,YAAY,CAAC;IAC5E,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1F,MAAM,mBAAmB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,OAAO;QACL,OAAO,EAAE,iBAAiB;QAC1B,mBAAmB;QACnB,SAAS,EAAE,YAAY,CAAC,mBAAmB,EAAE,aAAa,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/tools/briefings/why-proposed.js

@@ -0,0 +1,69 @@
+/**
+ * The one-line "why proposed" reason a briefing gives for each technique.
+ * Rules are tried in order; the first that matches wins.
+ */
+const CATEGORY_REASONS = new Map([
+    ["music", "SID music / audio requested in brief"],
+    ["input", "Player input (joystick / keyboard) the brief's controls need"],
+    ["maths", "Arithmetic or lookup-table support the brief's mechanics need"],
+    ["logic", "Frame loop / game-state structure the brief needs"],
+    ["text", "Text, font or number display mentioned or implied in brief"],
+    ["io", "Disk load / save or persistence mentioned in brief"],
+]);
+const NAME_RULES = [
+    {
+        name: ["scroll", "soft_scroll"],
+        desc: ["scroll", "scroller"],
+        reason: "Scroller effect mentioned in brief",
+    },
+    {
+        name: ["sprite", "multiplex"],
+        desc: ["sprite", "24", "multiplexer", "enemy"],
+        reason: "Sprite/multiplexer technique required for brief",
+    },
+    {
+        name: ["raster", "bar", "double_irq", "stable_raster"],
+        desc: ["raster", "bar", "color"],
+        reason: "Raster color effect mentioned in brief",
+    },
+    { name: ["bitmap"], desc: ["bitmap"], reason: "Bitmap mode mentioned in brief" },
+    {
+        name: ["stable_raster"],
+        reason: "Prerequisite: all raster timing work needs stable IRQ foundation",
+    },
+    {
+        name: ["effect", "plasma", "tunnel", "starfield"],
+        reason: "Visual effect mentioned or implied in brief",
+    },
+    {
+        name: ["loader", "exomizer", "krill"],
+        reason: "Loading / compression needed for multi-part work",
+    },
+];
+const EXACT_NAME_REASONS = new Map([
+    [
+        "text_mode_overlay_render",
+        "Text-mode playfield + moving overlay is the foundation for any falling-piece / board / Tetris-like game",
+    ],
+]);
+function ruleMatches(rule, name, desc) {
+    if (!rule.name.some((w) => name.includes(w)))
+        return false;
+    return rule.desc === undefined || rule.desc.some((w) => desc.includes(w));
+}
+/**
+ * Determine a human-readable "why proposed" string for a technique
+ * given the original description.
+ */
+export function whyProposed(techniqueName, category, description) {
+    const byCategory = CATEGORY_REASONS.get(category);
+    if (byCategory !== undefined)
+        return byCategory;
+    const desc = description.toLowerCase();
+    const name = techniqueName.toLowerCase();
+    const rule = NAME_RULES.find((r) => ruleMatches(r, name, desc));
+    if (rule)
+        return rule.reason;
+    return EXACT_NAME_REASONS.get(name) ?? `Relevant to the brief: "${description.slice(0, 60)}"`;
+}
+//# sourceMappingURL=why-proposed.js.map

package/dist/tools/briefings/why-proposed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"why-proposed.js","sourceRoot":"","sources":["../../../src/tools/briefings/why-proposed.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAiB;IAC/C,CAAC,OAAO,EAAE,sCAAsC,CAAC;IACjD,CAAC,OAAO,EAAE,8DAA8D,CAAC;IACzE,CAAC,OAAO,EAAE,+DAA+D,CAAC;IAC1E,CAAC,OAAO,EAAE,mDAAmD,CAAC;IAC9D,CAAC,MAAM,EAAE,4DAA4D,CAAC;IACtE,CAAC,IAAI,EAAE,oDAAoD,CAAC;CAC7D,CAAC,CAAC;AAUH,MAAM,UAAU,GAAe;IAC7B;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;QAC/B,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;QAC5B,MAAM,EAAE,oCAAoC;KAC7C;IACD;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;QAC7B,IAAI,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC;QAC9C,MAAM,EAAE,iDAAiD;KAC1D;IACD;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,eAAe,CAAC;QACtD,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC;QAChC,MAAM,EAAE,wCAAwC;KACjD;IACD,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,gCAAgC,EAAE;IAChF;QACE,IAAI,EAAE,CAAC,eAAe,CAAC;QACvB,MAAM,EAAE,kEAAkE;KAC3E;IACD;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;QACjD,MAAM,EAAE,6CAA6C;KACtD;IACD;QACE,IAAI,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC;QACrC,MAAM,EAAE,kDAAkD;KAC3D;CACF,CAAC;AAEF,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAiB;IACjD;QACE,0BAA0B;QAC1B,yGAAyG;KAC1G;CACF,CAAC,CAAC;AAEH,SAAS,WAAW,CAAC,IAAc,EAAE,IAAY,EAAE,IAAY;IAC7D,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3D,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,aAAqB,EAAE,QAAgB,EAAE,WAAmB;IACtF,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAChE,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC;IAC7B,OAAO,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,2BAA2B,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;AAChG,CAAC"}

package/dist/tools/briefings.js

@@ -0,0 +1,44 @@
+/**
+ * Briefing tools — Phase 5 anchor tools.
+ *
+ * demoBriefing(description, archetype?): one-shot structured demo plan — orchestrates
+ *   search → techniqueLookup → checkCompatibility → pitfallsFor → build order.
+ *   The optional archetype is a demo form from
+ *   docs/demo-design/intro-cracktro-patterns.md (cracktro, demo_intro, ...).
+ *
+ * gameBriefing(description, archetype?): same but game-framed. The archetype
+ *   is looked up as an Archetype node (docs/game-design/c64-game-archetypes.md,
+ *   docs/CONVENTIONS-archetypes.md): its FEATURES targets are forced into the
+ *   proposal, its RISKS targets into the pitfalls, and its title into the
+ *   search. A name the graph does not have is reported as archetype_not_found
+ *   with the known names. A graph with no Archetype nodes at all (the test
+ *   fixtures) falls back to a small built-in table.
+ *
+ * Both tools share one archetype path. Archetype names are unique across
+ * every archetype page: the ingest MERGEs the node on name alone, so a name
+ * reused on a second page overwrites the first page's node rather than
+ * adding a second. The known-names list in archetype_not_found spans both
+ * kinds.
+ *
+ * These replace the manual 9-tool composition that a consuming agent had to
+ * perform when using the c64_demo_brief / c64_game_brief MCP Prompts. One
+ * tool call returns the full structured plan.
+ */
+export { whyProposed } from "./briefings/why-proposed.js";
+export { FRAME_CYCLES, RAM_BUDGET_BYTES, computeBudget, renderBudgetText } from "./briefings/budget.js";
+import { buildBriefing } from "./briefings/build.js";
+// The implementation lives in src/tools/briefings/: discovery.ts (keyword and
+// vector technique discovery), archetype.ts, why-proposed.ts,
+// plan-pitfalls.ts, toolchain.ts, build-order.ts, budget.ts, render.ts, and
+// build.ts, which runs the pipeline. This file keeps the import path.
+export async function demoBriefing(description, archetype) {
+    return buildBriefing(description, archetype, false);
+}
+export async function gameBriefing(description, archetype) {
+    // Always a game plan. Until 2026-09-23 a call without an archetype was
+    // framed as a demo plan ("# C64 Demo Briefing", "demo plan for"); it now
+    // routes the brief to an archetype by the page's brief words, and when
+    // none wins it is a game plan with no scaffold step.
+    return buildBriefing(description, archetype, true);
+}
+//# sourceMappingURL=briefings.js.map

package/dist/tools/briefings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"briefings.js","sourceRoot":"","sources":["../../src/tools/briefings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACxG,OAAO,EAAE,aAAa,EAAuB,MAAM,sBAAsB,CAAC;AAG1E,8EAA8E;AAC9E,8DAA8D;AAC9D,4EAA4E;AAC5E,sEAAsE;AAEtE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,SAAkB;IACxE,OAAO,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,SAAkB;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,uEAAuE;IACvE,qDAAqD;IACrD,OAAO,aAAa,CAAC,WAAW,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/tools/feedback.js

@@ -0,0 +1,97 @@
+/** Generation feedback store (2026-05-21): the substrate that stops verdicts from
+ * evaporating. Every generated candidate + the human's verdict is appended here so
+ * it can later train a learned critic and condition the composer on what worked.
+ * Append-only JSONL — inspectable, crash-safe, no schema migration. */
+import { appendFileSync, readFileSync, existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { z } from "zod";
+export const DEFAULT_FEEDBACK_DB = "./data/generation-feedback.jsonl";
+const MethodSchema = z.enum(["ai", "deterministic", "deterministic-salient", "ablation"]);
+// A line of the JSONL file is JSON from disk: validated, not cast.
+const FeedbackRecordSchema = z.object({
+    id: z.string(),
+    ts: z.string(), // ISO timestamp
+    composer: z.string(),
+    /** how it was generated */
+    method: MethodSchema,
+    ablation: z.string().optional(), // for method "ablation": scramble_palette | no_timbre | generic_phrases
+    seed: z.number().optional(),
+    title: z.string(),
+    metrics: z
+        .object({
+        consonance_pct: z.number().optional(),
+        in_style_pct: z.number().optional(),
+        drum_density: z.number().optional(),
+        stutter_score: z.number().optional(),
+    })
+        .optional(),
+    verdict: z.string().optional(), // human label: e.g. "best-yet", "decent", "not good", "not really X"
+    notes: z.string().optional(),
+});
+/** Append one feedback record as a JSON line (creates the dir/file if needed). */
+export function appendFeedback(rec, dbPath = DEFAULT_FEEDBACK_DB) {
+    mkdirSync(dirname(dbPath), { recursive: true });
+    appendFileSync(dbPath, JSON.stringify(rec) + "\n");
+}
+/** Load all feedback records. Missing file → []. Blank, corrupt or malformed lines are skipped. */
+export function loadFeedback(dbPath = DEFAULT_FEEDBACK_DB) {
+    if (!existsSync(dbPath))
+        return [];
+    const out = [];
+    for (const line of readFileSync(dbPath, "utf8").split("\n")) {
+        const s = line.trim();
+        if (!s)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(s);
+        }
+        catch (e) {
+            if (e instanceof SyntaxError)
+                continue; // a partial or corrupt line
+            throw e;
+        }
+        const rec = FeedbackRecordSchema.safeParse(parsed);
+        if (rec.success)
+            out.push(rec.data);
+    }
+    return out;
+}
+// CLI: npm run feedback:log -- --composer "Rob Hubbard" --method ai --title "X" --verdict "decent" [--notes ..] [--seed N] [--ablation A]
+//      npm run feedback:log -- --list
+async function main() {
+    const { randomUUID } = await import("node:crypto");
+    const argv = process.argv;
+    const get = (n) => {
+        const i = argv.indexOf(`--${n}`);
+        const v = i >= 0 ? argv.at(i + 1) : undefined;
+        return v === "" ? undefined : v;
+    };
+    if (argv.includes("--list")) {
+        const rows = loadFeedback();
+        for (const r of rows)
+            console.log(`${r.ts}  ${r.method.padEnd(20)} ${r.composer.padEnd(16)} ${(r.verdict ?? "").padEnd(28)} ${r.title}`);
+        console.log(`\n${rows.length} records in ${DEFAULT_FEEDBACK_DB}`);
+        return;
+    }
+    const rec = {
+        id: get("id") ?? randomUUID().slice(0, 8),
+        ts: new Date().toISOString(),
+        composer: get("composer") ?? "",
+        method: MethodSchema.parse(get("method") ?? "ai"),
+        title: get("title") ?? "",
+        verdict: get("verdict"),
+        notes: get("notes"),
+        seed: get("seed") ? Number(get("seed")) : undefined,
+        ablation: get("ablation"),
+    };
+    appendFeedback(rec);
+    console.log(`logged ${rec.id} (${rec.composer} / ${rec.method} / "${rec.verdict ?? ""}")`);
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch((e) => {
+        console.error(e);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=feedback.js.map

package/dist/tools/feedback.js.map

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

package/dist/tools/hydrate.js

@@ -0,0 +1,75 @@
+/**
+ * Hydration tools. ingestDoc handles the single-file ingest path used by
+ * the c64-kb ingest-doc CLI and c64_ingest_doc MCP tool. Mirrors the
+ * batch ingest in src/ingest.ts: Qdrant chunk upsert + FalkorDB graph
+ * entity extraction so adding a single doc via MCP keeps both stores
+ * consistent.
+ */
+import { getQdrant, getFalkor } from "../context.js";
+import { chunkMarkdown } from "../services/chunker.js";
+import { isAvailable as ollamaAvailable } from "../services/embeddings.js";
+import { loadBM25Vocab } from "../services/bm25.js";
+import { extractGraphEntities } from "../graph/extract.js";
+import { applyEntity } from "../graph/apply.js";
+import { replaceDocPoints } from "../ingest/points.js";
+import { config } from "../config.js";
+import fs from "fs";
+import path from "path";
+/**
+ * Resolve a caller-supplied doc path inside the docs directory, or null
+ * when it would land outside. Null bytes are stripped and every ".."
+ * segment dropped before path.resolve sees the value.
+ */
+function resolveDocPath(docPath, docsDir) {
+    const sanitized = docPath
+        .replace(/\0/g, "") // null bytes
+        .split(path.sep)
+        .filter((seg) => seg !== "..") // remove every parent-dir jump
+        .join(path.sep);
+    const resolved = path.resolve(docsDir, sanitized);
+    if (!resolved.startsWith(docsDir + path.sep) && resolved !== docsDir)
+        return null;
+    return resolved;
+}
+export async function ingestDoc(docPath, content) {
+    if (!(await ollamaAvailable())) {
+        return "Ollama not available — cannot embed. Run: ollama pull mxbai-embed-large";
+    }
+    const q = await getQdrant();
+    await q.ensureCollection();
+    // Sanitise docPath before any filesystem call to prevent path traversal.
+    const DOCS_DIR = path.resolve(config.docs.dir);
+    const resolvedDocPath = resolveDocPath(docPath, DOCS_DIR);
+    if (resolvedDocPath === null) {
+        return `Rejected: docPath must be inside the docs directory (${DOCS_DIR}).`;
+    }
+    // Write the content being indexed. This used to write only when the file
+    // was absent, so an update indexed text the file on disk did not hold and
+    // the next clean ingest silently reverted it.
+    fs.mkdirSync(path.dirname(resolvedDocPath), { recursive: true });
+    fs.writeFileSync(resolvedDocPath, content);
+    // Chunk + embed + upsert. Live single-doc ingest cannot refit the BM25
+    // vocabulary, because that would invalidate every sparse vector already
+    // in the collection; without a vocab file the sparse vectors are empty.
+    const source = resolvedDocPath.replace(DOCS_DIR + path.sep, ""); // relative path under docs/
+    const pointCount = await replaceDocPoints(q, {
+        source,
+        chunks: chunkMarkdown(content, source),
+        bm25: loadBM25Vocab(),
+    });
+    // Graph extraction — parity with batch ingest, through the same applier.
+    // Single-file ingest stays single-pass intentionally: with only one doc in
+    // flight, node ordering doesn't matter and FalkorDB's MERGE-stub fallback
+    // handles any forward references within the doc. The two-pass linker in
+    // src/ingest.ts is only needed for the full-corpus batch run where edges
+    // from one file may reference nodes defined in a later file.
+    const f = await getFalkor();
+    await f.ensureSchema();
+    let graphCount = 0;
+    for (const entity of extractGraphEntities(content, source)) {
+        if (await applyEntity(f, entity))
+            graphCount++;
+    }
+    return `Ingested ${pointCount} chunks + ${graphCount} graph entities from ${source}.`;
+}
+//# sourceMappingURL=hydrate.js.map

package/dist/tools/hydrate.js.map

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