c64-kb 0.17.0

package/dist/tools/query/game-design.js

@@ -0,0 +1,83 @@
+/**
+ * GameDesign reads (schema 28): one design with its phases, archetypes,
+ * recipes and measured frames, the designs of an archetype, and every
+ * design name for a not-found reply.
+ */
+import { z } from "zod";
+import { getFalkor } from "../../context.js";
+import { BUDGET_PHASES } from "../../domain/budget.js";
+import { CostBasisSchema } from "../../schemas/cost-basis.js";
+import { parseRows } from "./shared.js";
+const StringList = z
+    .unknown()
+    .transform((v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x !== "") : []);
+const MeasuredSchema = z.array(z.object({
+    phase: z.enum(BUDGET_PHASES),
+    region: z.enum(["PAL", "NTSC"]),
+    worst: z.number().int(),
+    typical: z.number().int().optional(),
+    basis: CostBasisSchema,
+    source: z.string(),
+}));
+const DesignRow = z.object({
+    name: z.string(),
+    title: z.string().nullable(),
+    region: z.enum(["PAL", "NTSC", "both"]).nullable(),
+    measured: z.string().nullable(),
+    source_doc: z.string().nullable(),
+    archetypes: StringList,
+    recipes: StringList,
+    composes: z.array(z.object({ technique: z.string().nullable(), phase: z.string().nullable() })),
+});
+const DESIGN_QUERY = `MATCH (g:GameDesign) WHERE g.name IN $names
+  OPTIONAL MATCH (g)-[:INSTANCE_OF]->(a:Archetype)
+  WITH g, collect(DISTINCT a.name) AS archetypes
+  OPTIONAL MATCH (g)-[:REALISED_BY]->(r:Recipe)
+  WITH g, archetypes, collect(DISTINCT r.name) AS recipes
+  OPTIONAL MATCH (g)-[c:COMPOSES]->(t:Technique)
+  RETURN g.name AS name, g.title AS title, g.region AS region, g.measured AS measured,
+         g.source_doc AS source_doc, archetypes, recipes,
+         collect({technique: t.name, phase: c.phase}) AS composes`;
+function isPhase(p) {
+    return BUDGET_PHASES.some((x) => x === p);
+}
+function recordOf(row) {
+    const composes = row.composes.flatMap((c) => c.technique && isPhase(c.phase) ? [{ technique: c.technique, phase: c.phase }] : []);
+    // Phase order, then technique name, so the expansion does not depend on edge order.
+    composes.sort((a, b) => BUDGET_PHASES.indexOf(a.phase) - BUDGET_PHASES.indexOf(b.phase) ||
+        a.technique.localeCompare(b.technique));
+    const measured = row.measured ? MeasuredSchema.parse(JSON.parse(row.measured)) : [];
+    return {
+        name: row.name,
+        title: row.title ?? row.name,
+        region: row.region,
+        instance_of: [...row.archetypes].sort(),
+        realised_by: [...row.recipes].sort(),
+        composes,
+        measured,
+        source_doc: row.source_doc ?? "",
+    };
+}
+async function designsNamed(names) {
+    if (names.length === 0)
+        return [];
+    const f = await getFalkor();
+    return parseRows(DesignRow, await f.roQuery(DESIGN_QUERY, { names })).map(recordOf);
+}
+/** One design by exact name, or null. */
+export async function fetchGameDesign(name) {
+    return (await designsNamed([name.trim()])).at(0) ?? null;
+}
+/** Every GameDesign name, sorted: the known list of a not-found reply. */
+export async function knownGameDesigns() {
+    const f = await getFalkor();
+    const rows = parseRows(z.object({ name: z.string() }), await f.roQuery(`MATCH (g:GameDesign) RETURN g.name AS name ORDER BY name`));
+    return rows.map((r) => r.name);
+}
+/** The designs INSTANCE_OF an archetype, by name. */
+export async function designsOfArchetype(archetype) {
+    const f = await getFalkor();
+    const rows = parseRows(z.object({ name: z.string() }), await f.roQuery(`MATCH (g:GameDesign)-[:INSTANCE_OF]->(:Archetype {name: $archetype}) RETURN g.name AS name ORDER BY name`, { archetype }));
+    return designsNamed(rows.map((r) => r.name));
+}
+//# sourceMappingURL=game-design.js.map

package/dist/tools/query/game-design.js.map

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

package/dist/tools/query/lookups.js

@@ -0,0 +1,220 @@
+/**
+ * Exact lookups against the graph: registers, KERNAL routines and the
+ * memory map, each followed by the best-matching document chunks.
+ */
+import { z } from "zod";
+import { getFalkor, getAnalytics } from "../../context.js";
+import { names, parseRows, renderDocBlocks, searchChunks, toDocChunk } from "./shared.js";
+function hexToInt(addr) {
+    return parseInt(addr.replace(/^\$/, ""), 16);
+}
+function normalizeRw(rw) {
+    const upper = (rw ?? "").trim().toUpperCase();
+    if (upper === "R" || upper === "W" || upper === "RW")
+        return upper;
+    // Stored values like "Read-only" / "Write-only" — best-effort coerce.
+    if (upper.startsWith("R") && !upper.includes("W"))
+        return "R";
+    if (upper.startsWith("W") && !upper.includes("R"))
+        return "W";
+    return "RW";
+}
+/** Up to five names of `label` nodes whose name or address contains the first three characters. */
+async function nearMatches(label, cleaned) {
+    const partial = cleaned.slice(0, 3);
+    if (!partial)
+        return [];
+    const f = await getFalkor();
+    return names(await f.roQuery(`MATCH (r:${label})
+       WHERE r.name CONTAINS $partial
+          OR r.address CONTAINS $partial
+       RETURN r.name AS name LIMIT 5`, { partial }));
+}
+function notFoundText(what, query, suggestions) {
+    return (`No ${what} found matching "${query}".\n\n` +
+        `Did you mean: ${suggestions.length > 0 ? suggestions.join(", ") : "(no near-matches)"}.\n\n` +
+        `Try \`c64_search\` with "${query}" for fuzzy lookup.`);
+}
+const emptyRegister = () => ({
+    found: false,
+    name: "",
+    address: "",
+    chip: "",
+    rw: "RW",
+    aliases: [],
+    documentation: [],
+});
+const RegisterRow = z.object({
+    name: z.string(),
+    addr: z.string(),
+    rw: z.string(),
+    aliases: z.array(z.string()).nullable(),
+    chip: z.string().nullable(),
+});
+/**
+ * Decimal I/O address to hex: 53265 → "D011". All C64 I/O registers live
+ * in $D000–$DFFF (53248–57343); anything else is not a decimal address.
+ */
+function decimalIoToHex(cleaned) {
+    if (!/^\d{4,5}$/.test(cleaned))
+        return null;
+    const decimal = parseInt(cleaned, 10);
+    if (decimal < 0xd000 || decimal > 0xdfff)
+        return null;
+    return decimal.toString(16).toUpperCase().padStart(4, "0");
+}
+export async function lookupRegister(nameOrAddr) {
+    const cleaned = nameOrAddr.trim().toUpperCase().replace(/^\$/, "");
+    // Guard: single-letter mnemonic queries match the entire register table and
+    // produce useless noise. Return early with a helpful hint.
+    if (/^[A-Z]$/.test(cleaned)) {
+        return {
+            structured: emptyRegister(),
+            text: `"${nameOrAddr}" is too short for a register lookup. ` +
+                `Provide at least 2 characters for mnemonic lookups; ` +
+                `for fuzzy intent use c64_search instead.`,
+        };
+    }
+    const asHex = decimalIoToHex(cleaned);
+    if (asHex !== null)
+        return lookupRegister(asHex);
+    // Match by canonical name, hex address, or any alias.
+    const f = await getFalkor();
+    const rows = parseRows(RegisterRow, await f.roQuery(`MATCH (r:Register)
+       WHERE r.name = $cleaned
+          OR r.address = $addr
+          OR $cleaned IN r.aliases
+       OPTIONAL MATCH (r)-[:BELONGS_TO]->(c:Chip)
+       RETURN r.name AS name,
+              r.address AS addr,
+              r.rw AS rw,
+              r.aliases AS aliases,
+              c.name AS chip
+       LIMIT 1`, { cleaned, addr: `$${cleaned}` }));
+    getAnalytics().logQuery({ tool: "c64_lookup_register", query: nameOrAddr, resultCount: rows.length });
+    const reg = rows.at(0);
+    if (!reg) {
+        return {
+            structured: emptyRegister(),
+            text: notFoundText("register", nameOrAddr, await nearMatches("Register", cleaned)),
+        };
+    }
+    return describeRegister(reg);
+}
+async function describeRegister(reg) {
+    const aliases = reg.aliases ?? [];
+    const chip = reg.chip ?? "unknown";
+    // Pull richer context from Qdrant. Include all alias forms so both
+    // dense and sparse vectors have multiple shots at the right chunk.
+    const queryStr = [reg.name, reg.addr, ...aliases].filter(Boolean).join(" ");
+    const { chunks: ctx } = await searchChunks({ query: queryStr, limit: 3 });
+    const structured = {
+        found: true,
+        name: reg.name,
+        address: reg.addr,
+        chip,
+        rw: normalizeRw(reg.rw),
+        aliases,
+        documentation: ctx.map(toDocChunk),
+    };
+    let out = `# ${reg.name} — ${reg.addr}\n\n**Chip:** ${chip}\n**Access:** ${reg.rw}\n`;
+    if (aliases.length > 0)
+        out += `**Aliases:** ${aliases.join(", ")}\n`;
+    out += `\n`;
+    out +=
+        ctx.length > 0 ? `## Documentation\n\n${renderDocBlocks(ctx)}` : `(No additional documentation found.)\n`;
+    return { structured, text: out };
+}
+const KernalRow = z.object({
+    name: z.string(),
+    addr: z.string(),
+    desc: z.string().nullable(),
+    pairs: z.array(z.string()),
+});
+const KERNAL_QUERY = (key) => `MATCH (k:KernalRoutine {${key}: $value})
+   OPTIONAL MATCH (k)-[:PAIRS_WITH]->(p:KernalRoutine)
+   RETURN k.name AS name, k.address AS addr, k.description AS desc, collect(DISTINCT p.name) AS pairs`;
+export async function lookupKernal(nameOrAddr) {
+    const f = await getFalkor();
+    const cleaned = nameOrAddr.trim().toUpperCase().replace(/^\$/, "");
+    const byName = parseRows(KernalRow, await f.roQuery(KERNAL_QUERY("name"), { value: cleaned }));
+    const byAddr = parseRows(KernalRow, await f.roQuery(KERNAL_QUERY("address"), { value: `$${cleaned}` }));
+    const rows = [...byName, ...byAddr];
+    getAnalytics().logQuery({ tool: "c64_lookup_kernal", query: nameOrAddr, resultCount: rows.length });
+    const row = rows.at(0);
+    if (!row) {
+        return {
+            structured: { name: "", address: "", description: "", pairs_with: [], documentation: [] },
+            text: notFoundText("KERNAL routine", nameOrAddr, await nearMatches("KernalRoutine", cleaned)),
+        };
+    }
+    const { chunks: ctx } = await searchChunks({
+        query: `KERNAL ${row.name} ${row.addr}`,
+        limit: 3,
+        keywordText: `${row.name} ${row.addr}`,
+    });
+    const desc = row.desc ?? "";
+    const structured = {
+        name: row.name,
+        address: row.addr,
+        description: desc,
+        pairs_with: row.pairs,
+        documentation: ctx.map(toDocChunk),
+    };
+    let out = `# ${row.name} — ${row.addr}\n\n${desc}\n\n`;
+    if (row.pairs.length > 0)
+        out += `**Pairs with:** ${row.pairs.join(", ")}\n\n`;
+    if (ctx.length > 0)
+        out += `## Documentation\n\n${renderDocBlocks(ctx)}`;
+    return { structured, text: out };
+}
+const MemoryRegionRow = z.object({
+    name: z.string(),
+    start: z.string(),
+    end: z.string(),
+    use: z.string().nullable(),
+    bank: z.unknown(),
+});
+export async function memoryMap(addr) {
+    const cleaned = addr
+        .trim()
+        .toUpperCase()
+        .replace(/^\$/, "")
+        .replace(/[^0-9A-F]/g, "");
+    if (!cleaned) {
+        return {
+            structured: { address: addr, regions: [] },
+            text: `Invalid address: "${addr}". Use a hex address like $D011 or 0400.`,
+        };
+    }
+    const numeric = parseInt(cleaned, 16);
+    const canonicalAddr = `$${cleaned}`;
+    // Find regions whose [start, end] contains this address.
+    const f = await getFalkor();
+    const rows = parseRows(MemoryRegionRow, await f.roQuery(`MATCH (m:MemoryRegion)
+       RETURN m.name AS name, m.start AS start, m.end AS end, m.default_use AS use, m.bank_switchable AS bank`));
+    const matches = rows.filter((r) => numeric >= hexToInt(r.start) && numeric <= hexToInt(r.end));
+    getAnalytics().logQuery({ tool: "c64_memory_map", query: addr, resultCount: matches.length });
+    const regions = matches.map((r) => ({
+        name: r.name,
+        start: r.start,
+        end: r.end,
+        default_use: r.use ?? "",
+        bank_switchable: Boolean(r.bank),
+    }));
+    const structured = { address: canonicalAddr, regions };
+    if (regions.length === 0) {
+        return {
+            structured,
+            text: `No memory region found containing ${canonicalAddr}. The address may be outside any documented region.`,
+        };
+    }
+    let out = `# ${canonicalAddr} memory map\n\n`;
+    for (const region of regions) {
+        out += `## ${region.name} (${region.start}-${region.end})\n`;
+        out += `**Default use:** ${region.default_use || "(not documented)"}\n`;
+        out += `**Bank-switchable:** ${region.bank_switchable ? "Yes" : "No"}\n\n`;
+    }
+    return { structured, text: out };
+}
+//# sourceMappingURL=lookups.js.map

package/dist/tools/query/lookups.js.map

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

package/dist/tools/query/plan-budget.js

@@ -0,0 +1,266 @@
+/**
+ * c64_plan_budget: read the named techniques' Cost lines, bands, REQUIRES
+ * closures and implementing recipes from the graph, hand them to the pure
+ * planBudget (src/domain/budget.ts), and render the result.
+ */
+import { z } from "zod";
+import { getFalkor, getAnalytics } from "../../context.js";
+import { BUDGET_PHASES, followIncludes, planBudget, } from "../../domain/budget.js";
+import { compareMeasured } from "../../domain/game-design.js";
+import { CostBasisSchema } from "../../schemas/tool-outputs.js";
+import { fetchGameDesign, knownGameDesigns } from "./game-design.js";
+import { parseRows } from "./shared.js";
+const OptNumber = z.unknown().transform((v) => (typeof v === "number" ? v : undefined));
+const OptString = z.unknown().transform((v) => (typeof v === "string" && v !== "" ? v : undefined));
+const StringList = z
+    .unknown()
+    .transform((v) => Array.isArray(v) ? v.filter((x) => typeof x === "string" && x !== "") : []);
+const MemberRow = z.object({
+    name: z.string(),
+    requires_region: OptString,
+    raster_band: OptString,
+    cycles_per_frame: OptNumber,
+    cycles_per_frame_typical: OptNumber,
+    cycles_per_line: OptNumber,
+    lines_active: OptNumber,
+    bytes_code: OptNumber,
+    bytes_data: OptNumber,
+    irq_slots: OptNumber,
+    basis: CostBasisSchema.nullable(),
+    measured_on: OptString,
+    conditions: OptString,
+    includes: StringList,
+    closure: StringList,
+    recipes: StringList,
+});
+const MEMBERS_QUERY = `MATCH (t:Technique) WHERE t.name IN $names
+  OPTIONAL MATCH (t)-[:REQUIRES_REGION]->(rr:Region)
+  OPTIONAL MATCH (t)-[:REQUIRES*1..12]->(p:Technique)
+  WITH t, rr, collect(DISTINCT p.name) AS closure
+  OPTIONAL MATCH (r:Recipe)-[:IMPLEMENTS]->(t)
+  RETURN t.name AS name, toLower(rr.name) AS requires_region, t.raster_band AS raster_band,
+         t.cost_cycles_per_frame AS cycles_per_frame, t.cost_cycles_per_frame_typical AS cycles_per_frame_typical,
+         t.cost_cycles_per_line AS cycles_per_line, t.cost_lines_active AS lines_active,
+         t.cost_bytes_code AS bytes_code, t.cost_bytes_data AS bytes_data, t.cost_irq_slots AS irq_slots,
+         t.cost_basis AS basis, t.cost_recipe AS measured_on, t.cost_conditions AS conditions,
+         t.cost_includes AS includes, closure, collect(DISTINCT r.name) AS recipes`;
+// Every Cost includes line in the graph, so an include is followed through
+// a technique that is not in the set (a includes b, b includes c: a holds c).
+const INCLUDES_QUERY = `MATCH (t:Technique) WHERE t.cost_includes IS NOT NULL
+  RETURN t.name AS name, t.cost_includes AS includes`;
+const IncludesRow = z.object({ name: z.string(), includes: StringList });
+/** "name" or "name:phase"; a phase outside play, transition, init is refused. */
+export function parseMemberSpec(spec) {
+    const [rawName = "", rawPhase, ...rest] = spec.trim().split(":");
+    const name = rawName.trim();
+    if (name === "" || rest.length > 0)
+        return { error: `"${spec}" is not "name" or "name:phase"` };
+    if (rawPhase === undefined)
+        return { name, phase: "play" };
+    const phase = BUDGET_PHASES.find((p) => p === rawPhase.trim().toLowerCase());
+    return phase ? { name, phase } : { error: `phase "${rawPhase}" is not one of ${BUDGET_PHASES.join(", ")}` };
+}
+function memberOf(name, phase, row) {
+    if (!row)
+        return { name, phase, found: false };
+    return {
+        name,
+        phase,
+        found: true,
+        requires_region: row.requires_region,
+        raster_band: row.raster_band,
+        requires_closure: row.closure,
+        recipes: [...row.recipes].sort(),
+        ...(row.basis
+            ? {
+                cost: {
+                    cycles_per_frame: row.cycles_per_frame,
+                    cycles_per_frame_typical: row.cycles_per_frame_typical,
+                    cycles_per_line: row.cycles_per_line,
+                    lines_active: row.lines_active,
+                    bytes_code: row.bytes_code,
+                    bytes_data: row.bytes_data,
+                    irq_slots: row.irq_slots,
+                    basis: row.basis,
+                    measured_on: row.measured_on,
+                    conditions: row.conditions,
+                    includes: row.includes,
+                },
+            }
+            : {}),
+    };
+}
+/** Graph rows for the named techniques, as planBudget members in the order asked. */
+export async function fetchBudgetMembers(specs) {
+    const f = await getFalkor();
+    const names = [...new Set(specs.map((s) => s.name))];
+    const rows = parseRows(MemberRow, await f.roQuery(MEMBERS_QUERY, { names }));
+    const direct = new Map(parseRows(IncludesRow, await f.roQuery(INCLUDES_QUERY, {})).map((r) => [r.name, r.includes]));
+    const byName = new Map(rows.map((r) => [r.name, { ...r, includes: followIncludes(r.name, (n) => direct.get(n) ?? []) }]));
+    return specs.map((s) => memberOf(s.name, s.phase, byName.get(s.name)));
+}
+function rangeText(p) {
+    const fixed = p.fixed_losses.badlines + p.fixed_losses.sprite_dma;
+    const range = p.low === p.high ? `${p.high}` : `${p.low}-${p.high}`;
+    return `${fixed > 0 ? `${range} + ${fixed} fixed` : range} cycles; floor ${p.floor}`;
+}
+function contributorLine(c) {
+    const figure = c.low === c.high ? `${c.high}` : `${c.low}-${c.high}`;
+    const on = c.measured_on
+        ? `, on ${c.measured_on}${c.conditions ? ` (${c.conditions})` : ""}`
+        : ", recipe not stated";
+    const how = c.charge === "band" ? ", band lines × line" : c.charge === "per_line" ? ", per line × lines" : "";
+    return `- ${c.name}: ${figure} (${c.basis}${on}${how})\n`;
+}
+function excludedLine(e) {
+    if (e.reason === "multi_frame")
+        return `- ${e.name}: ${e.cycles} cycles, above one frame: a multi-frame operation, not summed${e.measured_on ? ` (measured on ${e.measured_on})` : ""}\n`;
+    const why = e.reason === "included_by"
+        ? `inside ${e.by}'s figure (Cost includes)`
+        : `runs inside ${e.by}'s raster band`;
+    return `- ${e.name}: not added, ${why}\n`;
+}
+function renderPhase(p) {
+    let out = `\n## ${p.phase} (${p.region}, ${p.frame} cycles a frame): ${p.verdict}\n\n`;
+    out += `Range ${rangeText(p)}; weakest basis ${p.weakest_basis ?? "(nothing summed)"}; IRQ slots ${p.irq_slots}.\n`;
+    if (p.contributors.length > 0)
+        out += `\nSummed:\n${p.contributors.map(contributorLine).join("")}`;
+    if (p.excluded.length > 0)
+        out += `\nLeft out:\n${p.excluded.map(excludedLine).join("")}`;
+    if (p.to_measure.length > 0) {
+        out += `\nTo measure:\n`;
+        for (const m of p.to_measure)
+            out += `- ${m.technique}: ${m.why}; ${m.recipe ? `measure it on ${m.recipe}` : "no recipe yet"}\n`;
+    }
+    if (p.not_found.length > 0)
+        out += `\nNo such technique: ${p.not_found.join(", ")}.\n`;
+    if (p.notes.length > 0)
+        out += `\nNotes:\n${p.notes.map((n) => `- ${n}\n`).join("")}`;
+    return out;
+}
+function bytesLine(bytes) {
+    const inside = bytes.inside.length > 0
+        ? ` Not added, inside another member's code: ${bytes.inside.map((i) => `${i.name} (${i.by})`).join(", ")}.`
+        : "";
+    if (bytes.contributors.length === 0)
+        return `No member states a byte figure that can be summed.${inside}`;
+    const floor = bytes.without_bytes.length > 0 ? `; a floor, since ${bytes.without_bytes.join(", ")} state no bytes` : "";
+    return `Sum ${bytes.sum} over ${bytes.contributors.map((c) => c.name).join(", ")}${floor}.${inside}`;
+}
+function renderDesign(b) {
+    if (b.design_not_found) {
+        const known = b.design_not_found.known.join(", ") || "(none in this graph)";
+        return `\nNo GameDesign is named "${b.design_not_found.requested}". Known: ${known}.\n`;
+    }
+    const d = b.design;
+    if (!d)
+        return "";
+    let out = `\nDesign: ${d.title} (\`${d.name}\`), ${d.source_doc}. Instance of ${d.instance_of.join(", ") || "(none)"}; realised by ${d.realised_by.join(", ") || "(no recipe)"}.\n`;
+    if (d.measured.length === 0)
+        return `${out}The design states no measured frame.\n`;
+    out += `\nMeasured beside predicted:\n`;
+    for (const m of d.measured) {
+        const typical = m.typical !== null ? `, typical ${m.typical}` : "";
+        out += `- ${m.phase} ${m.region}: worst ${m.worst}${typical} (${m.source}); ${m.finding}\n`;
+    }
+    return out;
+}
+function renderPlan(b) {
+    let out = `# Budget plan: ${b.verdict}\n`;
+    out += renderDesign(b);
+    out += `\nTechniques: ${b.techniques.join(", ") || "(none)"}\n`;
+    for (const r of b.refused)
+        out += `- Refused "${r.input}": ${r.why}\n`;
+    for (const p of b.phases)
+        out += renderPhase(p);
+    out += `\n## Bytes\n\n${bytesLine(b.bytes)}\n`;
+    for (const e of b.bytes.excluded)
+        out += `- ${e.name}: ${e.bytes} bytes left out, the whole program, not the technique\n`;
+    out += `\n## Assumptions\n\n`;
+    for (const a of b.assumptions)
+        out += `- ${a}\n`;
+    return out;
+}
+/** The region words the tool accepts, any case. */
+export const BUDGET_REGION = /^\s*(pal|ntsc|both)\s*$/i;
+/** 'pal', 'NTSC', 'both' to the planner's words; none is the planner's default; anything else is refused. */
+export function budgetRegion(region) {
+    if (region === undefined)
+        return undefined;
+    const r = region.trim().toUpperCase();
+    if (r === "PAL" || r === "NTSC")
+        return r;
+    if (r === "BOTH")
+        return "both";
+    throw new Error(`region "${region}" is not pal, ntsc or both`);
+}
+/** Parse every spec; a malformed one, or a name already listed in the same phase, is refused with the reason. */
+export function parseMemberSpecs(inputs) {
+    const refused = [];
+    const specs = [];
+    const listed = new Set();
+    for (const t of inputs) {
+        const parsed = parseMemberSpec(t);
+        if ("error" in parsed) {
+            refused.push({ input: t, why: parsed.error });
+            continue;
+        }
+        const key = `${parsed.name}:${parsed.phase}`;
+        if (listed.has(key)) {
+            refused.push({ input: t, why: `${parsed.name} is already listed in ${parsed.phase}; counted once` });
+            continue;
+        }
+        listed.add(key);
+        specs.push(parsed);
+    }
+    return { specs, refused };
+}
+/** The design's members as "name" / "name:phase" specs, play first. */
+function designSpecs(d) {
+    return d.composes.map((c) => (c.phase === "play" ? c.technique : `${c.technique}:${c.phase}`));
+}
+async function resolveDesign(name) {
+    const wanted = name?.trim();
+    if (!wanted)
+        return { design: null };
+    const design = await fetchGameDesign(wanted);
+    if (design)
+        return { design };
+    return { design: null, notFound: { requested: wanted, known: await knownGameDesigns() } };
+}
+export async function planBudgetTool(req) {
+    const { design, notFound } = await resolveDesign(req.design);
+    const inputs = [...(design ? designSpecs(design) : []), ...(req.techniques ?? [])];
+    if (inputs.length === 0 && !notFound)
+        throw new Error("give techniques, a design, or both");
+    const { specs, refused } = parseMemberSpecs(inputs);
+    const members = await fetchBudgetMembers(specs);
+    // A design's own region is the default; the caller's word overrides it.
+    const region = req.region ?? design?.region ?? undefined;
+    const plan = planBudget(members, { ...req, region });
+    const structured = {
+        design: design
+            ? {
+                name: design.name,
+                title: design.title,
+                region: design.region,
+                instance_of: design.instance_of,
+                realised_by: design.realised_by,
+                composes: design.composes,
+                source_doc: design.source_doc,
+                measured: compareMeasured(design.measured, plan.phases),
+            }
+            : null,
+        ...(notFound ? { design_not_found: notFound } : {}),
+        techniques: specs.map((s) => (s.phase === "play" ? s.name : `${s.name}:${s.phase}`)),
+        refused,
+        ...plan,
+    };
+    getAnalytics().logQuery({
+        tool: "c64_plan_budget",
+        query: [req.design ? `design=${req.design}` : "", ...(req.techniques ?? [])].filter(Boolean).join(","),
+        resultCount: members.length,
+    });
+    return { structured, text: renderPlan(structured) };
+}
+//# sourceMappingURL=plan-budget.js.map

package/dist/tools/query/plan-budget.js.map

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