c64-kb 0.17.0

package/dist/tools/lint/text.js

@@ -0,0 +1,122 @@
+/** Text helpers for the source lints: comment stripping, number parsing, language detection. */
+const MNEMONIC_LINE = /^\s*(?:[\w.@!+-]+:\s*)?(lda|ldx|ldy|sta|stx|sty|jsr|jmp|rts|rti|sei|cli|inc|dec|inx|iny|dex|dey|cmp|cpx|cpy|bne|beq|bcc|bcs|bpl|bmi|bvc|bvs|adc|sbc|and|ora|eor|asl|lsr|rol|ror|bit|pha|pla|php|plp|tax|tay|txa|tya|tsx|txs|nop|brk|sed|cld|sec|clc|clv)\b(?=\s*$|\s+[^=\s])/i;
+const ASM_DIRECTIVE = /^\s*(\.pc\b|\.(for|while|byte|word|fill|var|const|text|encoding|import|macro|label)\b|!byte\b|!word\b|!fill\b|!zone\b|\.org\b|\.byt\b)/m;
+const C_STATEMENT = /(^|[^.\w])(void|int|char|unsigned|struct|while|for|if|return|switch|case|byte|word)\b[^;\n]*[;{(:]/;
+/** Assembler signatures, tested on comment-stripped text before the C shape test. */
+function looksLikeAsm(asmText) {
+    return /^\s*\*\s*=/m.test(asmText) || ASM_DIRECTIVE.test(asmText) || /\bBasicUpstart2?\s*\(/.test(asmText);
+}
+/** C by statement shape: a `;`-terminated line and either a C keyword statement or a bare call/assignment. */
+function looksLikeC(cText) {
+    const terminated = /;\s*(\}|$)/m.test(cText);
+    if (!terminated)
+        return false;
+    if (C_STATEMENT.test(cText))
+        return true;
+    // Bare statements: a call or an assignment ending in `;`.
+    return /^\s*[\w.>[\]-]+\s*(\([^;]*\)|=[^=][^;]*)\s*;/m.test(cText);
+}
+/**
+ * Detect the language from the text when the caller does not say.
+ * Comments are stripped first, so a `//` comment ending in `;` or a
+ * `for` inside a KickAssembler `.for` cannot make an assembler listing
+ * read as C. Assembler signatures are tested before the C shape test.
+ */
+export function detectLanguage(source) {
+    if (/^\s*#\s*(include|define|pragma|assign|repeat|embed|ifdef|ifndef)\b/m.test(source))
+        return "c";
+    const asmText = stripAsm(source);
+    if (looksLikeAsm(asmText))
+        return "asm";
+    const cText = stripC(source);
+    if (/__asm\s*\{/.test(cText))
+        return "c";
+    const mnemonicLines = asmText.split("\n").filter((l) => MNEMONIC_LINE.test(l)).length;
+    if (mnemonicLines >= 3)
+        return "asm";
+    return looksLikeC(cText) ? "c" : "asm";
+}
+function blockComment(source, i) {
+    const end = source.indexOf("*/", i + 2);
+    const stop = end < 0 ? source.length : end + 2;
+    return { text: source.slice(i, stop).replace(/[^\n]/g, " "), next: stop };
+}
+function lineComment(source, i) {
+    let j = i;
+    while (j < source.length && source.charAt(j) !== "\n")
+        j++;
+    return { text: " ".repeat(j - i), next: j };
+}
+function quoted(source, i, quote) {
+    const n = source.length;
+    let j = i + 1;
+    while (j < n && source.charAt(j) !== quote && source.charAt(j) !== "\n") {
+        if (source.charAt(j) === "\\")
+            j++;
+        j++;
+    }
+    const stop = Math.min(n, j + 1);
+    // keep the quotes so an empty string is still recognisable as ""
+    return { text: quote + " ".repeat(Math.max(0, stop - i - 2)) + (stop - i >= 2 ? quote : ""), next: stop };
+}
+function cToken(source, i) {
+    const c = source.charAt(i);
+    const d = source.charAt(i + 1);
+    if (c === "/" && d === "*")
+        return blockComment(source, i);
+    if (c === "/" && d === "/")
+        return lineComment(source, i);
+    if (c === '"' || c === "'")
+        return quoted(source, i, c);
+    return { text: c, next: i + 1 };
+}
+/**
+ * Blank out comments and string literals in C while keeping every line
+ * break, so line numbers survive and a `sid.` inside a comment or a
+ * string is never matched.
+ */
+export function stripC(source) {
+    const out = [];
+    let i = 0;
+    while (i < source.length) {
+        const t = cToken(source, i);
+        out.push(t.text);
+        i = t.next;
+    }
+    return out.join("");
+}
+/** Blank out `;` and `//` comments in assembly, keeping line breaks. */
+export function stripAsm(source) {
+    return source
+        .split("\n")
+        .map((line) => {
+        let cut = line.length;
+        const a = line.indexOf(";");
+        const b = line.indexOf("//");
+        if (a >= 0)
+            cut = Math.min(cut, a);
+        if (b >= 0)
+            cut = Math.min(cut, b);
+        return line.slice(0, cut);
+    })
+        .join("\n");
+}
+export function parseNumber(tok) {
+    const t = tok.trim();
+    if (/^\$[0-9a-f]+$/i.test(t))
+        return parseInt(t.slice(1), 16);
+    if (/^0x[0-9a-f]+$/i.test(t))
+        return parseInt(t.slice(2), 16);
+    if (/^%[01]+$/.test(t))
+        return parseInt(t.slice(1), 2);
+    if (/^[0-9]+$/.test(t))
+        return parseInt(t, 10);
+    return null;
+}
+export function isZero(tok) {
+    return parseNumber(tok) === 0;
+}
+export function hex4(v) {
+    return v.toString(16).toUpperCase().padStart(4, "0");
+}
+//# sourceMappingURL=text.js.map

package/dist/tools/lint/text.js.map

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

package/dist/tools/lint/types.js

@@ -0,0 +1,40 @@
+/** Types, page links and shared wording for the source lints (src/tools/lint.ts). */
+export const PAGES = {
+    sid: "docs/pitfalls/sid.md#sid_write_only_registers",
+    ddr: "docs/pitfalls/input.md#cia1_ddr_cleared_kills_keyboard",
+    open15: "docs/recipes/oscar64/high-score-persist.md",
+    rasterPoll: "docs/recipes/oscar64/frame-sync-loop.md",
+    lfsr: "docs/pitfalls/cpu.md#lfsr_zero_state_lockup",
+    decimal: "docs/pitfalls/kernal-and-io.md#decimal_mode_in_irq_handler",
+    d016: "docs/pitfalls/scroll.md#d016_unmasked_rmw_clobbers_csel_mcm",
+    jmp: "docs/pitfalls/cpu.md#jmp_indirect_page_boundary_bug",
+};
+// The two pages that speak to a bare OPEN of channel 15 disagree, and
+// the rule says so rather than pick one. high-score-persist.md measured
+// the OPEN returning success with no drive present; techniques/file-io.md
+// tests the carry after it and expects C=1, A=5. Which is right is not
+// measured by this lint.
+export const OPEN15_MECHANISM = "high-score-persist.md: the KERNAL sends nothing on the bus when the filename length is zero, so that OPEN returned success with no drive present, and the CHKIN inside the read then hangs with no timeout. techniques/file-io.md opens the status channel bare on purpose and tests the carry after OPEN (bcs no_drive, C=1 A=5). The two pages disagree on what a bare OPEN returns with no drive; this lint does not settle it. Safe either way: read the status channel only after a named OPEN (a file, or a DOS command such as I0) has succeeded.";
+// SID fields with a read path ($D419-$D41C). Every other field is write-only.
+export const SID_READABLE = new Set(["potx", "poty", "random", "env3"]);
+/** Push one finding for 0-based line `idx`, with the excerpt taken from the raw text. */
+export function report(ctx, idx, f) {
+    ctx.findings.push({
+        rule: f.rule,
+        pitfall: f.pitfall,
+        line: idx + 1,
+        excerpt: lineAt(ctx.rawLines, idx).trim().slice(0, 120),
+        message: f.message,
+        page: f.page,
+        certainty: f.certainty,
+    });
+}
+/** Line `i`, or "" past either end. */
+export function lineAt(lines, i) {
+    return lines[i] ?? "";
+}
+/** Capture group `n` of a match, or "" when the group did not take part. */
+export function group(m, n) {
+    return m[n] ?? "";
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/lint/types.ts"],"names":[],"mappings":"AAAA,qFAAqF;AA6BrF,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,GAAG,EAAE,+CAA+C;IACpD,GAAG,EAAE,wDAAwD;IAC7D,MAAM,EAAE,4CAA4C;IACpD,UAAU,EAAE,yCAAyC;IACrD,IAAI,EAAE,6CAA6C;IACnD,OAAO,EAAE,4DAA4D;IACrE,IAAI,EAAE,6DAA6D;IACnE,GAAG,EAAE,qDAAqD;CAClD,CAAC;AAEX,sEAAsE;AACtE,wEAAwE;AACxE,0EAA0E;AAC1E,uEAAuE;AACvE,yBAAyB;AACzB,MAAM,CAAC,MAAM,gBAAgB,GAC3B,0hBAA0hB,CAAC;AAE7hB,8EAA8E;AAC9E,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAUxE,yFAAyF;AACzF,MAAM,UAAU,MAAM,CAAC,GAAgB,EAAE,GAAW,EAAE,CAAwC;IAC5F,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,IAAI,EAAE,GAAG,GAAG,CAAC;QACb,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACvD,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,SAAS,EAAE,CAAC,CAAC,SAAS;KACvB,CAAC,CAAC;AACL,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,MAAM,CAAC,KAAsC,EAAE,CAAS;IACtE,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,KAAK,CAAC,CAAkC,EAAE,CAAS;IACjE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/dist/tools/lint.js

@@ -0,0 +1,76 @@
+/**
+ * Source lints compiled from the pitfall pages.
+ *
+ * lintSource(source, opts) runs the knowledge base's own rules over a
+ * piece of C (Oscar64) or 6502 assembly and returns one finding per
+ * site. Each rule is named after the pitfall it compiles and points at
+ * the page that states it, so a finding can be read back against the
+ * page. No graph or vector store is needed; the rules are text
+ * patterns, and each carries a certainty:
+ *
+ *   definite   the pattern is the pitfall by construction
+ *   likely     the pattern is the pitfall unless something the lint
+ *              cannot see (an earlier call, a shadow variable) excuses it
+ *   heuristic  the pattern often accompanies the pitfall; read the page
+ *              and decide
+ *
+ * The messages use the pages' own words. The rules are deliberately
+ * narrow: a lint that is quiet on correct code is worth more to an
+ * agent than one that is loud on everything.
+ *
+ * The rules live in src/tools/lint/ (c-rules.ts, asm-rules.ts,
+ * asm-decimal.ts); this file is the entry point.
+ */
+import { lintAsm } from "./lint/asm-rules.js";
+import { lintC } from "./lint/c-rules.js";
+import { detectLanguage } from "./lint/text.js";
+export { detectLanguage };
+export function lintSource(source, opts = { language: "auto" }) {
+    const language = opts.language === "auto" ? detectLanguage(source) : opts.language;
+    const findings = [];
+    if (language === "c")
+        lintC(source, findings);
+    else
+        lintAsm(source, findings);
+    findings.sort((a, b) => a.line - b.line || a.rule.localeCompare(b.rule));
+    return findings;
+}
+const CERTAINTY_ORDER = ["definite", "likely", "heuristic"];
+function summarise(findings) {
+    if (findings.length === 0)
+        return "No findings.";
+    const counts = CERTAINTY_ORDER.map((c) => [c, findings.filter((f) => f.certainty === c).length])
+        .filter(([, n]) => n > 0)
+        .map(([c, n]) => `${n} ${c}`)
+        .join(", ");
+    const rules = [...new Set(findings.map((f) => f.rule))];
+    return `${findings.length} finding${findings.length === 1 ? "" : "s"} (${counts}) across ${rules.length} rule${rules.length === 1 ? "" : "s"}: ${rules.join(", ")}.`;
+}
+export function lintSourceResult(source, opts = { language: "auto" }, label) {
+    const language = opts.language === "auto" ? detectLanguage(source) : opts.language;
+    const findings = lintSource(source, { ...opts, language });
+    const summary = summarise(findings);
+    const lines = [];
+    lines.push(`# Lint${label ? `: ${label}` : ""} (${language})`);
+    lines.push("");
+    lines.push(summary);
+    for (const f of findings) {
+        lines.push("");
+        lines.push(`## line ${f.line}: ${f.rule} [${f.certainty}]`);
+        lines.push("");
+        lines.push("    " + f.excerpt);
+        lines.push("");
+        lines.push(f.message);
+        lines.push(`Page: ${f.page}`);
+    }
+    return {
+        structured: {
+            language,
+            ...(opts.toolchain === undefined ? {} : { toolchain: opts.toolchain }),
+            findings,
+            summary,
+        },
+        text: lines.join("\n"),
+    };
+}
+//# sourceMappingURL=lint.js.map

package/dist/tools/lint.js.map

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

package/dist/tools/memorization-mcp.js

@@ -0,0 +1,111 @@
+/**
+ * MCP tool for the memorization-detection service (SID Phase A, M6.5).
+ *
+ * Runs as a one-shot subprocess per call (no persistent worker pool) —
+ * memorization checks are infrequent and the latency cost is acceptable.
+ * Phase 0b can promote this to a persistent pool if needed.
+ */
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+import { defineTool, READ_ONLY } from "../server/define-tool.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ANALYZER_DIR = path.resolve(__dirname, "../../analyzer");
+const InputSchema = z.object({
+    candidate_events: z
+        .array(z.record(z.string(), z.unknown()))
+        .describe("Note events from the candidate tune (NoteEvent.model_dump() shape)"),
+    reference_events: z
+        .array(z.array(z.record(z.string(), z.unknown())))
+        .default([])
+        .describe("List of reference tune event lists. Pass [] to get a neutral (no-reference) verdict."),
+});
+const PYTHON = path.join(ANALYZER_DIR, ".venv/bin/python");
+/** Run one check in a fresh analyzer subprocess and return its one-line JSON reply. */
+function runService(requestLine) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn(PYTHON, ["-m", "src.memorization.service", "--stdio"], {
+            cwd: ANALYZER_DIR,
+            stdio: ["pipe", "pipe", "inherit"],
+        });
+        let stdout = "";
+        proc.stdout.on("data", (b) => {
+            stdout += b.toString();
+        });
+        proc.on("error", reject);
+        proc.on("close", (code) => {
+            if (code === 0) {
+                resolve(stdout.trim());
+            }
+            else {
+                reject(new Error(`memorization service exited with code ${String(code)}`));
+            }
+        });
+        proc.stdin.write(requestLine + "\n");
+        proc.stdin.end();
+    });
+}
+/**
+ * The service answers {kind: "error", ...} on its own failures; an MCP
+ * client only sees a failure when isError is set. A reply that is not JSON,
+ * or is JSON null, is a failure too.
+ */
+function isServiceError(reply) {
+    let parsed;
+    try {
+        parsed = JSON.parse(reply);
+    }
+    catch (e) {
+        if (e instanceof SyntaxError)
+            return true;
+        throw e;
+    }
+    if (parsed === null)
+        return true;
+    return typeof parsed === "object" && "kind" in parsed && parsed.kind === "error";
+}
+/**
+ * Defined only where the Python analyzer is installed. The public
+ * repository has no analyzer/, and the tool used to be listed there anyway
+ * and fail on every call.
+ */
+export const memorizationTool = existsSync(PYTHON)
+    ? defineTool({
+        name: "c64_memorization_check",
+        title: "Check a SID tune for memorized copies",
+        description: `Check whether a candidate's SID note stream resembles any reference tune via SSIMuse + Originality Report detectors.
+
+Purpose: Guards the SID generation pipeline against memorized copies of HVSC canon tunes. Returns a structured verdict with nearest-neighbor distance, similarity scores, and a binary copy_detected flag calibrated against the YAML-configured thresholds.
+
+Inputs:
+  - candidate_events (required): array of NoteEvent dicts for the tune being evaluated. Shape: {voice, frame, kind, pitch_hz, sid_chip}.
+  - reference_events (optional, default []): array of arrays — each inner array is one reference tune's event list. Pass [] for a no-reference neutral check. Pass the HVSC canon events to run the full detector.
+
+Output: a MemorizationResult JSON object with fields:
+  - kind: "result"
+  - nearest_neighbor_distance: 0.0 (identical) → 1.0 (maximally different)
+  - ssimuse_score: 0.0 → 1.0 (higher = more similar to best reference)
+  - originality_pct: 0.0 (fully original) → 1.0 (fully recycled n-grams)
+  - copy_detected: true if ANY detector exceeds its configured threshold
+  - copies: [] (populated in a follow-up phase when (md5, title, composer) lookup is wired)
+  - thresholds: the threshold dict active for this verdict
+
+On service error, returns a ServiceError object: {kind: "error", error_kind, message}.
+
+When to use: After generating a SID candidate, before publishing or scoring it. Also useful for human-in-the-loop audits via the memorize-audit CLI.
+
+Example: {"candidate_events": [...], "reference_events": [[...]]} → {"kind": "result", "copy_detected": true, ...}
+
+Limitations: copies[] is always [] in Phase A — identifying WHICH reference matched requires a follow-up md5 lookup pass. SSIMuse + Originality Report use PAL-50Hz frame timing by default.`,
+        inputSchema: InputSchema.shape,
+        // Runs a local subprocess that reads its inputs and writes nothing.
+        annotations: READ_ONLY,
+        run: async ({ candidate_events, reference_events }) => {
+            const reply = await runService(JSON.stringify({ kind: "check", events: candidate_events, references: reference_events }));
+            return { text: reply, isError: isServiceError(reply) };
+        },
+    })
+    : undefined;
+//# sourceMappingURL=memorization-mcp.js.map

package/dist/tools/memorization-mcp.js.map

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

package/dist/tools/pitfalls/bm25.js

@@ -0,0 +1,53 @@
+/**
+ * The BM25 vocabulary for the pitfall search fallback's sparse vector.
+ *
+ * Duplicate: src/tools/query.ts has its own copy of this loader (same file,
+ * same cache shape). They belong in one shared module, likely next to
+ * BM25Encoder in src/services/bm25.ts; until then keep the two in step.
+ */
+import fs from "fs";
+import path from "path";
+import { z } from "zod";
+import { BM25Encoder } from "../../services/bm25.js";
+import { config } from "../../config.js";
+const VOCAB_FILE = path.resolve(config.analytics.dbPath, "../bm25-vocab.json");
+// The shape BM25Encoder.toJSON writes.
+const VocabFileSchema = z.object({
+    vocab: z.array(z.tuple([z.string(), z.number()])),
+    df: z.array(z.tuple([z.number(), z.number()])),
+    avgDocLen: z.number(),
+    numDocs: z.number(),
+    k1: z.number(),
+    b: z.number(),
+});
+let bm25Cache; // undefined = not yet attempted
+function loadVocab() {
+    // No vocabulary file (no ingest has run): search runs dense-only.
+    if (!fs.existsSync(VOCAB_FILE))
+        return null;
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(VOCAB_FILE, "utf-8"));
+    }
+    catch (err) {
+        // stderr only: the MCP server owns stdout.
+        console.error(`pitfalls: ${VOCAB_FILE} unreadable, sparse search off: ${String(err)}`);
+        return null;
+    }
+    const parsed = VocabFileSchema.safeParse(raw);
+    if (!parsed.success) {
+        console.error(`pitfalls: ${VOCAB_FILE} is not a BM25 vocabulary, sparse search off: ${parsed.error.message}`);
+        return null;
+    }
+    return BM25Encoder.fromJSON(parsed.data);
+}
+function getBM25() {
+    if (bm25Cache === undefined)
+        bm25Cache = loadVocab();
+    return bm25Cache;
+}
+export function encodeSparse(text) {
+    const enc = getBM25();
+    return enc ? enc.encode(text) : { indices: [], values: [] };
+}
+//# sourceMappingURL=bm25.js.map

package/dist/tools/pitfalls/bm25.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.js","sourceRoot":"","sources":["../../../src/tools/pitfalls/bm25.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAqB,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAE/E,uCAAuC;AACvC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;CACd,CAAC,CAAC;AAEH,IAAI,SAAyC,CAAC,CAAC,gCAAgC;AAE/E,SAAS,SAAS;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,2CAA2C;QAC3C,OAAO,CAAC,KAAK,CAAC,aAAa,UAAU,mCAAmC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CACX,aAAa,UAAU,iDAAiD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAC/F,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,OAAO;IACd,IAAI,SAAS,KAAK,SAAS;QAAE,SAAS,GAAG,SAAS,EAAE,CAAC;IACrD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;IACtB,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAC9D,CAAC"}

package/dist/tools/pitfalls/format.js

@@ -0,0 +1,58 @@
+/** Text renderings for pitfallsFor and failureDiagnose. */
+/**
+ * Strip the leading "${section}\n\n" prefix from a chunk's stored
+ * text so it isn't rendered twice (once in the formatter heading,
+ * once at the top of the body). Mirrors the pattern in query.ts.
+ */
+function stripSectionPrefix(section, text) {
+    const prefix = `${section}\n\n`;
+    return text.startsWith(prefix) ? text.slice(prefix.length) : text;
+}
+export function formatSearchFallbackText(topic, results) {
+    const lines = [`No direct entity match for "${topic}". Top pitfall-doc matches:`, ""];
+    for (const r of results) {
+        lines.push(`### ${r.source} — ${r.section} (score: ${r.score.toFixed(3)})`);
+        lines.push(stripSectionPrefix(r.section, r.text).slice(0, 240).trim());
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+function formatVia(via) {
+    if (!via?.length)
+        return "";
+    const names = via.map((v) => `${v.name}${v.address ? " " + v.address : ""} (${v.kind})`).join(", ");
+    return `**Reached through:** ${names}, which this technique uses\n`;
+}
+export function formatPitfallsText(topic, kind, pitfalls) {
+    if (pitfalls.length === 0) {
+        return `No pitfalls found for ${kind} "${topic}".`;
+    }
+    const header = `Found ${pitfalls.length} pitfall(s) for ${kind} "${topic}":\n\n`;
+    const rows = pitfalls.map((p) => {
+        const triggers = p.triggered_by.map((t) => `${t.name} (${t.kind})`).join(", ");
+        const remedies = p.mitigated_by.map((t) => t.name).join(", ");
+        return (`### ${p.name} [${p.severity}, ${p.region}]\n` +
+            `**${p.title}**\n` +
+            `**Category:** ${p.category}\n` +
+            (triggers ? `**Triggered by:** ${triggers}\n` : "") +
+            (remedies ? `**Mitigated by:** ${remedies}\n` : "") +
+            formatVia(p.via));
+    });
+    return header + rows.join("\n");
+}
+export function formatFailureDiagnoseText(query, matches) {
+    if (matches.length === 0) {
+        return `No failure patterns matched "${query}". Try c64_search for broader lookup.`;
+    }
+    const header = `# Failure diagnosis: "${query}"\n\nTop ${matches.length} match(es):\n\n`;
+    const rows = matches.map((m) => {
+        const causedBy = m.caused_by.map((c) => `${c.name} (${c.kind})`).join(", ");
+        return (`## ${m.symptom} (relevance: ${m.relevance.toFixed(2)})\n` +
+            `${m.description}\n\n` +
+            `**Likely causes:** ${m.likely_causes.join(", ")}\n\n` +
+            `**Diagnosis:** ${m.diagnosis_steps}\n` +
+            (causedBy ? `**Caused by:** ${causedBy}\n` : ""));
+    });
+    return header + rows.join("\n---\n\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/tools/pitfalls/format.js.map

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

package/dist/tools/pitfalls/graph.js

@@ -0,0 +1,124 @@
+/**
+ * Graph reads for pitfallsFor. FalkorDB rows come back as `unknown`; each is
+ * read through a zod schema here, with null properties typed as missing.
+ */
+import { z } from "zod";
+const SEVERITY_ORDER = ["critical", "high", "medium", "low"];
+const SeveritySchema = z.enum(SEVERITY_ORDER);
+const RegionSchema = z.enum(["pal", "ntsc", "both"]);
+const KindSchema = z.enum(["Register", "KernalRoutine", "Technique"]);
+const PitfallRow = z.object({
+    name: z.string(),
+    title: z.string().nullish(),
+    severity: z.string().nullish(),
+    region: z.string().nullish(),
+    category: z.string().nullish(),
+});
+const ViaRow = PitfallRow.extend({ via: z.array(z.string()).nullish() });
+const EdgeRow = z.object({ tname: z.string().nullish(), tkind: z.string().nullish() });
+const severityRank = (s) => {
+    const i = SEVERITY_ORDER.indexOf(s);
+    return i < 0 ? SEVERITY_ORDER.length : i;
+};
+// Values outside the enum cannot occur on an ingested graph: the extractor
+// lower-cases both fields and defaults them to medium / both.
+const severityOf = (s) => {
+    const r = SeveritySchema.safeParse(s);
+    return r.success ? r.data : "low";
+};
+const regionOf = (s) => {
+    const r = RegionSchema.safeParse(s);
+    return r.success ? r.data : "both";
+};
+export function normalizeKey(kind, topic) {
+    if (kind === "Register")
+        return topic.replace(/^\$/, "").toUpperCase();
+    if (kind === "KernalRoutine")
+        return topic.toUpperCase();
+    return topic.toLowerCase().replace(/[- ]/g, "_");
+}
+/** Pitfalls with a direct TRIGGERED_BY (or, for a technique, MITIGATED_BY) edge to the topic. */
+export async function directPitfalls(f, kind, key) {
+    const severityCase = `CASE p.severity ${SEVERITY_ORDER.map((s, i) => `WHEN '${s}' THEN ${i}`).join(" ")} ELSE ${SEVERITY_ORDER.length} END`;
+    // For Register, also match by address or alias (mirrors lookupRegister logic)
+    const matchClause = kind === "Register"
+        ? `(t:Register) WHERE t.name = $key OR t.address = $addr OR $key IN t.aliases`
+        : `(t:${kind} {name: $key})`;
+    // MITIGATED_BY only ever points at a Technique, so only that branch
+    // widens the relation; a pitfall reached solely through its Fix still
+    // counts as an answer for the technique that fixes it.
+    const rel = kind === "Technique" ? "TRIGGERED_BY|MITIGATED_BY" : "TRIGGERED_BY";
+    const r = await f.roQuery(`MATCH (p:Pitfall)-[:${rel}]->${matchClause}
+     RETURN DISTINCT p.name AS name, p.title AS title, p.severity AS severity,
+            p.region AS region, p.category AS category
+     ORDER BY
+       ${severityCase},
+       p.name`, { key, addr: `$${key}` });
+    return z.array(PitfallRow).parse(r.data);
+}
+function parseVia(v) {
+    const [name = "", label, address] = v.split("|");
+    return {
+        name,
+        kind: label === "KernalRoutine" ? "KernalRoutine" : "Register",
+        ...(address ? { address } : {}),
+    };
+}
+/**
+ * A technique also meets every pitfall that a register or KERNAL routine
+ * it declares (Uses registers / Uses kernal) triggers. Both sides of that
+ * join are exact declarations on the pages, so the edge is derived, not
+ * guessed, and the answer names the register or routine that carried it.
+ * Returns the direct rows plus the derived ones, re-sorted by severity.
+ */
+export async function withPitfallsViaUses(f, key, direct) {
+    const m = await f.roQuery(`MATCH (t:Technique {name: $key})-[:USES]->(x)<-[:TRIGGERED_BY]-(p:Pitfall)
+     WHERE x:Register OR x:KernalRoutine
+     RETURN p.name AS name, p.title AS title, p.severity AS severity,
+            p.region AS region, p.category AS category,
+            collect(DISTINCT (x.name + '|' + labels(x)[0] + '|' + coalesce(x.address, ''))) AS via`, { key });
+    const directNames = new Set(direct.map((x) => x.name));
+    const viaOf = new Map();
+    const rows = [...direct];
+    for (const row of z.array(ViaRow).parse(m.data)) {
+        if (!row.name || directNames.has(row.name))
+            continue;
+        viaOf.set(row.name, (row.via ?? []).map(parseVia));
+        rows.push(row);
+    }
+    rows.sort((a, b) => severityRank(a.severity) - severityRank(b.severity) || a.name.localeCompare(b.name));
+    return { rows, viaOf };
+}
+/** Edges from one node to its targets, as {name, kind}; rows with no name or an unknown label are dropped. */
+export async function edgeTargets(f, cypher, params) {
+    const r = await f.roQuery(cypher, params);
+    return z
+        .array(EdgeRow)
+        .parse(r.data)
+        .flatMap((e) => {
+        const kind = KindSchema.safeParse(e.tkind);
+        return e.tname && kind.success ? [{ name: e.tname, kind: kind.data }] : [];
+    });
+}
+/** One pitfall row with its full TRIGGERED_BY and MITIGATED_BY lists. */
+export async function enrichPitfall(f, row, via) {
+    const triggered_by = await edgeTargets(f, `MATCH (p:Pitfall {name: $name})-[:TRIGGERED_BY]->(t)
+     RETURN t.name AS tname, labels(t)[0] AS tkind`, { name: row.name });
+    const remedies = await f.roQuery(`MATCH (p:Pitfall {name: $name})-[:MITIGATED_BY]->(t:Technique)
+     RETURN t.name AS tname ORDER BY tname`, { name: row.name });
+    const mitigated_by = z
+        .array(EdgeRow.pick({ tname: true }))
+        .parse(remedies.data)
+        .flatMap((e) => (e.tname ? [{ name: e.tname, kind: "Technique" }] : []));
+    return {
+        name: row.name,
+        title: row.title ?? "",
+        severity: severityOf(row.severity),
+        region: regionOf(row.region),
+        category: row.category ?? "",
+        triggered_by,
+        mitigated_by,
+        ...(via ? { via } : {}),
+    };
+}
+//# sourceMappingURL=graph.js.map

package/dist/tools/pitfalls/graph.js.map

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