c64-kb 0.17.0

package/dist/tools/query/techniques.js

@@ -0,0 +1,331 @@
+/**
+ * Technique tools: one technique with its graph neighbourhood, and the
+ * technique index by category, chip, region, register, recipe or
+ * prerequisite.
+ */
+import { z } from "zod";
+import { getFalkor, getAnalytics } from "../../context.js";
+import { CostBasisSchema, } from "../../schemas/tool-outputs.js";
+import { describeFilter, names, parseRows, searchChunks, suggestNames, toDocChunk, } from "./shared.js";
+import { CLAIM_MODES } from "../../graph/claims.js";
+import { compressUnits } from "./compatibility/unit-rules.js";
+/** A number property, or null when the node has none (or a non-number). */
+const OptNumber = z.unknown().transform((v) => (typeof v === "number" ? v : null));
+const TechniqueRow = z.object({
+    name: z.string(),
+    title: z.string().nullable(),
+    category: z.string().nullable(),
+    complexity: z.string().nullable(),
+    chip: z.string().nullable(),
+    requires_region: z.string().nullable(),
+    cost_cycles_per_line: OptNumber,
+    cost_cycles_per_frame: OptNumber,
+    cost_lines_active: OptNumber,
+    cost_bytes_code: OptNumber,
+    cost_bytes_data: OptNumber,
+    cost_zp_bytes: OptNumber,
+    cost_irq_slots: OptNumber,
+    cost_sprites_per_line: OptNumber,
+    cost_cycles_per_frame_typical: OptNumber,
+    cost_basis: CostBasisSchema.nullable(),
+    cost_recipe: z.string().nullable(),
+    cost_conditions: z.string().nullable(),
+    cost_includes: z.array(z.string()).nullable(),
+    raster_band: z.string().nullable(),
+    claims_stated: z.string().nullable(),
+    claims_basis: z.string().nullable(),
+});
+const TECHNIQUE_QUERY = `MATCH (t:Technique {name: $name})
+     OPTIONAL MATCH (t)-[:BELONGS_TO]->(c:Chip)
+     OPTIONAL MATCH (t)-[:REQUIRES_REGION]->(rr:Region)
+     RETURN t.name AS name, t.title AS title, t.category AS category,
+            t.complexity AS complexity, c.name AS chip, toLower(rr.name) AS requires_region,
+            t.cost_cycles_per_line AS cost_cycles_per_line, t.cost_cycles_per_frame AS cost_cycles_per_frame,
+            t.cost_lines_active AS cost_lines_active, t.cost_bytes_code AS cost_bytes_code,
+            t.cost_bytes_data AS cost_bytes_data, t.cost_zp_bytes AS cost_zp_bytes,
+            t.cost_irq_slots AS cost_irq_slots, t.cost_sprites_per_line AS cost_sprites_per_line, t.cost_basis AS cost_basis,
+            t.cost_cycles_per_frame_typical AS cost_cycles_per_frame_typical, t.cost_recipe AS cost_recipe,
+            t.cost_conditions AS cost_conditions, t.cost_includes AS cost_includes,
+            t.raster_band AS raster_band, t.claims_stated AS claims_stated, t.claims_basis AS claims_basis
+     LIMIT 1`;
+// Cost figure keys in output order, with the row column each comes from.
+const COST_FIGURES = [
+    ["cycles_per_line", "cost_cycles_per_line"],
+    ["cycles_per_frame", "cost_cycles_per_frame"],
+    ["lines_active", "cost_lines_active"],
+    ["bytes_code", "cost_bytes_code"],
+    ["bytes_data", "cost_bytes_data"],
+    ["zp_bytes", "cost_zp_bytes"],
+    ["irq_slots", "cost_irq_slots"],
+    ["sprites_per_line", "cost_sprites_per_line"],
+    ["cycles_per_frame_typical", "cost_cycles_per_frame_typical"],
+];
+/**
+ * Cost model (schema 22): only the keys the page's **Cost:** line carried
+ * are present, and the object is absent when the page has no line.
+ */
+function costOf(row) {
+    if (!row.cost_basis)
+        return undefined;
+    const figures = {};
+    for (const [key, column] of COST_FIGURES) {
+        const v = row[column];
+        if (v !== null)
+            figures[key] = v;
+    }
+    // basis after the figures, as the output has always ordered it; the
+    // provenance lines (schema 27) after the basis.
+    return {
+        ...figures,
+        basis: row.cost_basis,
+        ...(row.cost_recipe ? { measured_on: row.cost_recipe } : {}),
+        ...(row.cost_conditions ? { conditions: row.cost_conditions } : {}),
+        ...(row.cost_includes && row.cost_includes.length > 0 ? { includes: row.cost_includes } : {}),
+    };
+}
+async function techniqueNotFound(name) {
+    const f = await getFalkor();
+    const all = names(await f.roQuery(`MATCH (t:Technique) RETURN t.name AS name ORDER BY t.name`));
+    const suggestions = suggestNames(name, all, "_");
+    getAnalytics().logQuery({ tool: "c64_technique_lookup", query: name, resultCount: 0 });
+    const empty = {
+        name: "",
+        title: "",
+        category: "",
+        complexity: "",
+        uses_registers: [],
+        uses_kernal: [],
+        recipes: [],
+        requires: [],
+        required_by: [],
+        mitigates: [],
+        documentation: [],
+    };
+    const text = `Technique \`${name}\` not found.` +
+        (suggestions.length > 0 ? `\n\nDid you mean: ${suggestions.join(", ")}?` : "") +
+        `\n\nList all techniques with \`c64-kb techniques-for\` (no filter).`;
+    return { structured: empty, text };
+}
+const AddressedRow = z.object({ name: z.string(), address: z.string().nullable() });
+const RecipeRefRow = z.object({ name: z.string(), toolchain: z.string() });
+const TechniqueRefRow = z.object({ name: z.string(), title: z.string().nullable() });
+const PitfallRefRow = z.object({
+    name: z.string(),
+    title: z.string().nullable(),
+    severity: z.string().nullable(),
+});
+/** The technique's edges: USES, IMPLEMENTS (reverse), REQUIRES both ways, MITIGATED_BY (reverse). */
+async function neighbourhoodOf(name) {
+    const f = await getFalkor();
+    const q = (cypher) => f.roQuery(cypher, { name });
+    const [regs, kernal, recipes, requires, requiredBy, mitigates] = await Promise.all([
+        q(`MATCH (t:Technique {name: $name})-[:USES]->(r:Register)
+       RETURN r.name AS name, r.address AS address`),
+        q(`MATCH (t:Technique {name: $name})-[:USES]->(k:KernalRoutine)
+       RETURN k.name AS name, k.address AS address`),
+        q(`MATCH (t:Technique {name: $name})<-[:IMPLEMENTS]-(r:Recipe)
+       RETURN r.name AS name, r.toolchain AS toolchain`),
+        // REQUIRES → techniques that must be set up before, or run underneath, this one
+        q(`MATCH (t:Technique {name: $name})-[:REQUIRES]->(p:Technique)
+       RETURN p.name AS name, p.title AS title ORDER BY p.name`),
+        // REQUIRES (reverse) → techniques that presuppose this one
+        q(`MATCH (t:Technique {name: $name})<-[:REQUIRES]-(d:Technique)
+       RETURN d.name AS name, d.title AS title ORDER BY d.name`),
+        // MITIGATED_BY (reverse) → pitfalls whose Fix is this technique
+        q(`MATCH (t:Technique {name: $name})<-[:MITIGATED_BY]-(p:Pitfall)
+       RETURN p.name AS name, p.title AS title, p.severity AS severity ORDER BY p.name`),
+    ]);
+    const addressed = (r) => ({ name: r.name, address: r.address ?? "" });
+    const ref = (r) => ({ name: r.name, title: r.title ?? "" });
+    return {
+        uses_registers: parseRows(AddressedRow, regs).map(addressed),
+        uses_kernal: parseRows(AddressedRow, kernal).map(addressed),
+        recipes: parseRows(RecipeRefRow, recipes),
+        requires: parseRows(TechniqueRefRow, requires).map(ref),
+        required_by: parseRows(TechniqueRefRow, requiredBy).map(ref),
+        mitigates: parseRows(PitfallRefRow, mitigates).map((p) => ({
+            name: p.name,
+            title: p.title ?? "",
+            severity: p.severity ?? "",
+        })),
+    };
+}
+const ClaimRow = z.object({
+    unit: z.string(),
+    mode: z.enum(CLAIM_MODES),
+    ranges: z.string().nullable(),
+    relocatable: z.boolean().nullable(),
+});
+/** CLAIMS → HardwareUnits (schema 25). No Claims line reads as "unknown", never as "none". */
+async function claimsOf(row) {
+    const f = await getFalkor();
+    const rows = parseRows(ClaimRow, await f.roQuery(`MATCH (t:Technique {name: $name})-[c:CLAIMS]->(h:HardwareUnit)
+       RETURN h.name AS unit, c.mode AS mode, c.ranges AS ranges, c.relocatable AS relocatable ORDER BY h.name`, { name: row.name }));
+    const claims = rows.map((c) => ({
+        unit: c.unit,
+        mode: c.mode,
+        ...(c.ranges ? { ranges: c.ranges } : {}),
+        ...(c.relocatable ? { relocatable: true } : {}),
+    }));
+    const stated = row.claims_stated === "stated" || row.claims_stated === "none" ? row.claims_stated : "unknown";
+    return { claims, claims_stated: stated, ...(row.claims_basis ? { claims_basis: row.claims_basis } : {}) };
+}
+/** The Claims line as the page would write it, runs of units compressed (sprite_0-7). */
+function renderClaims(t) {
+    if (t.claims_stated === undefined || t.claims_stated === "unknown") {
+        return `**Claims:** unknown (the page states no unit claims; a unit conflict with it cannot be ruled out)\n`;
+    }
+    if (t.claims_stated === "none")
+        return `**Claims:** none\n**Claims basis:** ${t.claims_basis ?? ""}\n`;
+    const byMode = new Map();
+    const items = [];
+    for (const c of t.claims ?? []) {
+        if (c.ranges) {
+            const bytes = `$${c.ranges.replace(/,/g, "+$").replace(/-/g, "-$")}`;
+            items.push(`${c.unit} ${bytes} (${c.mode}${c.relocatable ? ", relocatable" : ""})`);
+        }
+        else
+            byMode.set(c.mode, [...(byMode.get(c.mode) ?? []), c.unit]);
+    }
+    for (const [mode, units] of byMode)
+        for (const u of compressUnits(units))
+            items.push(`${u} (${mode})`);
+    return `**Claims:** ${items.join(", ")}\n**Claims basis:** ${t.claims_basis ?? ""}\n`;
+}
+export async function techniqueLookup(name) {
+    const f = await getFalkor();
+    const row = parseRows(TechniqueRow, await f.roQuery(TECHNIQUE_QUERY, { name })).at(0);
+    if (!row)
+        return techniqueNotFound(name);
+    const cost = costOf(row);
+    const edges = await neighbourhoodOf(name);
+    const claims = await claimsOf(row);
+    // Documentation chunks from Qdrant
+    const { chunks: ctx } = await searchChunks({ query: `${name} ${row.title ?? ""}`.trim(), limit: 3 });
+    const documentation = ctx.map(toDocChunk);
+    getAnalytics().logQuery({ tool: "c64_technique_lookup", query: name, resultCount: 1 });
+    const structured = {
+        name: row.name,
+        title: row.title ?? "",
+        category: row.category ?? "",
+        complexity: row.complexity ?? "",
+        chip: row.chip ?? undefined,
+        requires_region: row.requires_region ?? undefined,
+        ...(row.raster_band ? { raster_band: row.raster_band } : {}),
+        ...edges,
+        documentation,
+        ...(cost ? { cost } : {}),
+        ...claims,
+    };
+    return { structured, text: renderTechnique(structured, cost, documentation) };
+}
+function renderTechniqueHeader(t, cost) {
+    let out = `# Technique: ${t.name} — ${t.title}\n\n`;
+    out += `**Category:** ${t.category}\n`;
+    out += `**Complexity:** ${t.complexity || "(not set)"}\n`;
+    if (t.chip)
+        out += `**Chip:** ${t.chip}\n`;
+    if (t.requires_region)
+        out += `**Requires region:** ${t.requires_region}\n`;
+    if (t.raster_band)
+        out += `**Raster band:** ${t.raster_band}\n`;
+    if (cost) {
+        const { basis, measured_on, conditions, includes, ...figures } = cost;
+        out += `**Cost:** ${Object.entries(figures)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(", ")}\n`;
+        out += `**Cost basis:** ${basis}\n`;
+        if (measured_on)
+            out += `**Cost measured on:** ${measured_on}${conditions ? ` (${conditions})` : ""}\n`;
+        if (includes)
+            out += `**Cost includes:** ${includes.join(", ")}\n`;
+    }
+    return out + renderClaims(t) + `\n`;
+}
+function renderTechnique(t, cost, documentation) {
+    let out = renderTechniqueHeader(t, cost);
+    const line = (label, items) => {
+        if (items.length > 0)
+            out += `**${label}:** ${items.join(", ")}\n`;
+    };
+    line("Uses registers", t.uses_registers.map((r) => r.name));
+    line("Uses KERNAL", t.uses_kernal.map((k) => k.name));
+    line("Requires", (t.requires ?? []).map((r) => r.name));
+    line("Required by", (t.required_by ?? []).map((r) => r.name));
+    line("Mitigates", (t.mitigates ?? []).map((m) => `${m.name} (${m.severity})`));
+    if (t.recipes.length > 0) {
+        out += `\n## Recipes\n\n`;
+        for (const r of t.recipes)
+            out += `- \`${r.name}\` (${r.toolchain})\n`;
+    }
+    if (documentation.length > 0) {
+        out += `\n## Documentation\n\n`;
+        for (const d of documentation)
+            out += `### ${d.source} > ${d.section}\n${d.text}\n\n---\n\n`;
+    }
+    return out;
+}
+// Pattern fragment each filter key adds after `MATCH (t:Technique)`, in order.
+const TECHNIQUE_FILTER_PATTERNS = [
+    ["chip", ` -[:BELONGS_TO]-> (ch:Chip {name: $chip})`],
+    // "What builds on X": techniques whose REQUIRES chain reaches X, directly
+    // or through other techniques (ifli_image -> fli_image -> stable_raster_irq),
+    // up to twelve edges deep (the longest authored chain is two). Variants
+    // are not unified: double_irq has no edge to stable_raster_irq.
+    ["requires", ` , (t)-[:REQUIRES*1..12]->(req:Technique {name: $requires})`],
+    ["region", ` , (t)-[:REQUIRES_REGION]->(reg:Region {name: $region})`],
+    ["register", ` , (t)-[:USES]->(rg:Register {name: $register})`],
+    ["recipe", ` , (rec:Recipe {name: $recipe})-[:IMPLEMENTS]->(t)`],
+    // "Who claims sid_voice_3": a CLAIMS edge to that HardwareUnit, any mode.
+    ["claims", ` , (t)-[:CLAIMS]->(hu:HardwareUnit {name: $claims})`],
+];
+function techniquesForCypher(filter) {
+    const params = {};
+    let cypher = `MATCH (t:Technique)`;
+    for (const [key, pattern] of TECHNIQUE_FILTER_PATTERNS) {
+        const value = filter[key];
+        if (!value)
+            continue;
+        cypher += pattern;
+        params[key] = value;
+    }
+    if (filter.category) {
+        cypher += ` WHERE t.category = $category`;
+        params.category = filter.category;
+    }
+    cypher += ` RETURN DISTINCT t.name AS name, t.title AS title, t.category AS category, t.complexity AS complexity ORDER BY t.category, t.name`;
+    return { cypher, params };
+}
+const TechniqueListRow = TechniqueRow.pick({ name: true, title: true, category: true, complexity: true });
+export async function techniquesFor(filter) {
+    const f = await getFalkor();
+    const { cypher, params } = techniquesForCypher(filter);
+    const techniques = parseRows(TechniqueListRow, await f.roQuery(cypher, params)).map((r) => ({
+        name: r.name,
+        title: r.title ?? "",
+        category: r.category ?? "",
+        complexity: r.complexity ?? "",
+    }));
+    getAnalytics().logQuery({
+        tool: "c64_techniques_for",
+        query: JSON.stringify(filter),
+        resultCount: techniques.length,
+    });
+    const structured = { filter, techniques };
+    let out = `# Techniques`;
+    const flt = describeFilter({ ...filter });
+    if (flt)
+        out += ` (filter: ${flt})`;
+    out += `\n\n`;
+    if (techniques.length === 0) {
+        out += `No techniques match. Try a broader filter or no filter at all.`;
+    }
+    else {
+        out += `| Name | Title | Category | Complexity |\n|------|-------|----------|------------|\n`;
+        for (const t of techniques) {
+            out += `| ${t.name} | ${t.title} | ${t.category} | ${t.complexity} |\n`;
+        }
+    }
+    return { structured, text: out };
+}
+//# sourceMappingURL=techniques.js.map

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

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

package/dist/tools/query/timing.js

@@ -0,0 +1,106 @@
+/**
+ * timingBudget: the per-line cycle budget for a technique on PAL or NTSC.
+ */
+import { z } from "zod";
+import { getFalkor, getAnalytics } from "../../context.js";
+import { BADLINE_CYCLES_LOST, DEFAULT_IRQ_OVERHEAD, REGION_TIMING, SPRITE_BA_LEAD_IN, SPRITE_CYCLES_EACH, spriteDmaCycles, videoRegion, } from "../../domain/timing.js";
+import { parseRows } from "./shared.js";
+const SpritesRow = z.object({ n: z.unknown() });
+/**
+ * Sprites on the line: the caller's figure wins; otherwise the technique's
+ * own **Cost:** sprites_per_line; otherwise none, and the notes say so.
+ */
+async function spritesOnLine(opts) {
+    if (opts.sprites_per_line !== undefined && Number.isFinite(opts.sprites_per_line)) {
+        return { sprites: Math.max(0, Math.min(8, Math.trunc(opts.sprites_per_line))), source: "input" };
+    }
+    const f = await getFalkor();
+    const row = parseRows(SpritesRow, await f.roQuery(`MATCH (t:Technique {name: $name}) RETURN t.cost_sprites_per_line AS n`, {
+        name: opts.technique,
+    })).at(0);
+    return typeof row?.n === "number"
+        ? { sprites: row.n, source: "technique" }
+        : { sprites: 0, source: "none" };
+}
+function spriteNote(t) {
+    if (t.sprites_per_line > 0) {
+        const from = t.sprites_source === "input" ? "from the request" : `from ${t.technique}'s Cost line`;
+        return `Sprite DMA: ${t.sprites_per_line} sprite(s) on the line (${from}) take ${SPRITE_BA_LEAD_IN} + ${SPRITE_CYCLES_EACH} × ${t.sprites_per_line} = ${t.sprite_dma_cycles} cycles, measured in VICE x64sc for sprites numbered without gaps (5 for one, 19 for eight). This is the minimum for that many sprites: each gap in the numbering adds up to ${SPRITE_BA_LEAD_IN} more (sprites 0 and 7 measured 10). The BA lead-in cycles are usable by writes only.`;
+    }
+    return t.sprites_source === "none"
+        ? `Sprite DMA: not counted. ${t.technique} states no sprites_per_line; pass sprites_per_line to count it (3 + 2 per sprite, 19 for eight, measured in VICE x64sc).`
+        : `Sprite DMA: none (0 sprites on the line).`;
+}
+function budgetNotes(t, lines_per_frame) {
+    const dma = t.sprite_dma_cycles > 0 ? ` - ${t.sprite_dma_cycles}` : "";
+    const notes = [
+        `${t.region}: ${t.cycles_per_line} cycles/line × ${lines_per_frame} lines = ${t.cycles_per_frame} cycles/frame.`,
+        `Badline: the VIC takes the bus on cycles 15-54 and drops BA on cycle 12, so ${BADLINE_CYCLES_LOST} cycles are lost to code that is not writing on 12-14 (40 to code that is). No read cycle is possible between 12 and 54.`,
+        `IRQ overhead: ${t.irq_overhead_cycles} cycles before the handler's first instruction (7 interrupt sequence + 29 KERNAL dispatcher at $FF48 via $0314; 7 via $FFFE with the KERNAL out), plus 0-6 cycles of jitter unless a double IRQ is used.`,
+        spriteNote(t),
+        `User cycles/line normal: ${t.cycles_per_line} - ${t.irq_overhead_cycles}${dma} = ${t.user_cycles_per_line_normal}.`,
+        `User cycles/line badline: ${t.cycles_per_line} - ${t.irq_overhead_cycles} - ${BADLINE_CYCLES_LOST}${dma} = ${t.user_cycles_per_line_badline}.`,
+    ];
+    if (t.sprites_per_line > 0) {
+        notes.push(`Without the IRQ entry, a line with ${t.sprites_per_line} sprite(s) leaves ${Math.max(0, t.cycles_per_line - t.sprite_dma_cycles)} cycles, a badline ${Math.max(0, t.cycles_per_line - BADLINE_CYCLES_LOST - t.sprite_dma_cycles)} (arithmetic; for eight sprites on a PAL badline cpu-cycle-tricks.md measures 4 including the 3 write-only cycles, which is the 1 this gives plus those 3).`);
+    }
+    if (t.user_cycles_per_line_badline <= 0) {
+        notes.push(`WARNING: badline leaves no user cycles — tight handler required.`);
+    }
+    return notes;
+}
+function renderBudget(t) {
+    const spritesFrom = t.sprites_source === "none" ? " (not stated)" : ` (${t.sprites_source})`;
+    let out = `# Timing budget: ${t.technique} (${t.region})\n\n`;
+    out += `| Property | Value |\n|----------|-------|\n`;
+    out += `| Region | ${t.region} |\n`;
+    out += `| Cycles/line | ${t.cycles_per_line} |\n`;
+    out += `| Cycles/frame | ${t.cycles_per_frame} |\n`;
+    out += `| Badline cycles lost | ${t.badline_cycles_lost} |\n`;
+    out += `| IRQ overhead | ${t.irq_overhead_cycles} |\n`;
+    out += `| Sprites on the line | ${t.sprites_per_line}${spritesFrom} |\n`;
+    out += `| Sprite DMA cycles | ${t.sprite_dma_cycles} |\n`;
+    out += `| User cycles/line (normal) | ${t.user_cycles_per_line_normal} |\n`;
+    out += `| User cycles/line (badline) | ${t.user_cycles_per_line_badline} |\n`;
+    out += `\n## Notes\n\n`;
+    for (const note of t.notes)
+        out += `- ${note}\n`;
+    return out;
+}
+export async function timingBudget(opts) {
+    const { sprites, source } = await spritesOnLine(opts);
+    const sprite_dma_cycles = spriteDmaCycles(sprites);
+    const region = videoRegion(opts.region);
+    const rc = REGION_TIMING[region];
+    // The IRQ overhead is the KERNAL-vector constant. An earlier version read
+    // t.irq_overhead here, a property no extractor or ingest ever wrote, so the
+    // read always fell through to the default; the dead read was removed in
+    // tools 1.25.0 rather than given a writer, because the per-technique cost
+    // line (cost_cycles_per_line and friends) is the model that carries a
+    // technique's own figures, and the graph connection went with it.
+    const irq = DEFAULT_IRQ_OVERHEAD;
+    const budget = {
+        technique: opts.technique,
+        region,
+        cycles_per_line: rc.cycles_per_line,
+        cycles_per_frame: rc.cycles_per_frame,
+        badline_cycles_lost: BADLINE_CYCLES_LOST,
+        irq_overhead_cycles: irq,
+        sprites_per_line: sprites,
+        sprites_source: source,
+        sprite_dma_cycles,
+        user_cycles_per_line_normal: Math.max(0, rc.cycles_per_line - irq - sprite_dma_cycles),
+        // A handler entered on a badline through the KERNAL vector has nothing
+        // left on that line (63 - 43 - 36 < 0); report 0, and the notes say
+        // to put splits on non-badlines.
+        user_cycles_per_line_badline: Math.max(0, rc.cycles_per_line - irq - BADLINE_CYCLES_LOST - sprite_dma_cycles),
+    };
+    const structured = { ...budget, notes: budgetNotes(budget, rc.lines_per_frame) };
+    getAnalytics().logQuery({
+        tool: "c64_timing_budget",
+        query: `${opts.technique}:${region}`,
+        resultCount: 1,
+    });
+    return { structured, text: renderBudget(structured) };
+}
+//# sourceMappingURL=timing.js.map

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

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

package/dist/tools/query/types.js

@@ -0,0 +1,11 @@
+/**
+ * Every query tool returns `{ structured, text }`:
+ *   - `structured`: a typed JSON payload matching a Zod outputSchema.
+ *     The MCP layer attaches this to `structuredContent` so consuming
+ *     agents can parse the result without re-tokenizing markdown.
+ *   - `text`: a rendered human-readable markdown blob. The CLI prints
+ *     this directly; the MCP layer includes it as `content[0].text`
+ *     for backward compat.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/query/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/tools/query.js

@@ -0,0 +1,21 @@
+/**
+ * Query tools, split by job under src/tools/query/:
+ *   - retrieval.ts: search, lookupOpcode, palNtscDiff, toolchainHint
+ *   - lookups.ts: lookupRegister, lookupKernal, memoryMap
+ *   - recipes.ts: recipeLookup, recipesFor
+ *   - techniques.ts: techniqueLookup, techniquesFor
+ *   - compatibility/: checkCompatibility (fetch, pure rules, render)
+ *   - timing.ts: timingBudget (constants in src/domain/timing.ts)
+ *   - plan-budget.ts: planBudgetTool (rules in src/domain/budget.ts)
+ *
+ * This file is the stable import path; every tool is re-exported here.
+ */
+export { search, lookupOpcode, palNtscDiff, toolchainHint } from "./query/retrieval.js";
+export { lookupRegister, lookupKernal, memoryMap } from "./query/lookups.js";
+export { recipeLookup, recipesFor } from "./query/recipes.js";
+export { techniqueLookup, techniquesFor } from "./query/techniques.js";
+export { checkCompatibility } from "./query/compatibility/index.js";
+export { timingBudget } from "./query/timing.js";
+export { planBudgetTool, budgetRegion, BUDGET_REGION } from "./query/plan-budget.js";
+export { spriteDmaCycles } from "../domain/timing.js";
+//# sourceMappingURL=query.js.map

package/dist/tools/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/tools/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}