c64-kb 0.17.0

package/dist/tools/selfimprovement.js

@@ -0,0 +1,367 @@
+/**
+ * Phase 7a self-improvement tools — coverage(), suggestLinks(), reportGap().
+ *
+ * coverage(): snapshot KB state across categories + recent gaps.
+ * suggestLinks(): heuristic missing-edge suggestions (Phase 7a Task 4).
+ * reportGap(): agent-facing gap recording (Phase 7a Task 5).
+ */
+import { z } from "zod";
+import { getFalkor, getQdrant, getAnalytics } from "../context.js";
+// ---------------------------------------------------------------------------
+// coverage
+// ---------------------------------------------------------------------------
+const CategoryCount = z.object({ category: z.string(), count: z.number() });
+const ToolchainCount = z.object({ toolchain: z.string(), count: z.number() });
+// An aggregate over no rows can come back null; the old reads defaulted it to 0.
+const KernalTotals = z.object({ total: z.number().nullish(), withPairs: z.number().nullish() });
+const Count = z.object({ c: z.number().nullish() });
+/** The first row of a one-row aggregate, validated; undefined when there is none. */
+async function one(f, cypher, schema) {
+    return (await f.roQuery(cypher, undefined, schema)).data[0];
+}
+/** Qdrant's point count. A failure leaves the snapshot's other figures standing, reported as 0. */
+async function qdrantPoints(qd) {
+    try {
+        return (await qd.getStats()).total_points;
+    }
+    catch (err) {
+        console.error(`[coverage] Qdrant stats unavailable: ${err instanceof Error ? err.message : String(err)}`);
+        return 0;
+    }
+}
+async function graphDimensions(f) {
+    const techniques = await f.roQuery(`MATCH (t:Technique) RETURN t.category AS category, count(*) AS count ORDER BY count DESC`, undefined, CategoryCount);
+    const pitfalls = await f.roQuery(`MATCH (p:Pitfall) RETURN p.category AS category, count(*) AS count ORDER BY count DESC`, undefined, CategoryCount);
+    const recipes = await f.roQuery(`MATCH (r:Recipe) RETURN r.toolchain AS toolchain, count(*) AS count ORDER BY count DESC`, undefined, ToolchainCount);
+    const kernal = await one(f, `MATCH (k:KernalRoutine)
+     OPTIONAL MATCH (k)-[:PAIRS_WITH]->(:KernalRoutine)
+     WITH k, count(*) AS pairs
+     RETURN count(k) AS total,
+            sum(CASE WHEN pairs > 0 THEN 1 ELSE 0 END) AS withPairs`, KernalTotals);
+    return {
+        technique_categories: techniques.data,
+        pitfall_categories: pitfalls.data,
+        recipe_toolchains: recipes.data,
+        kernal_coverage: {
+            total_routines: kernal?.total ?? 0,
+            with_doc_chunks: kernal?.total ?? 0,
+            with_pairs_with_edge: kernal?.withPairs ?? 0,
+        },
+    };
+}
+export async function coverage() {
+    const f = await getFalkor();
+    const qd = await getQdrant();
+    const an = getAnalytics();
+    const dimensions = await graphDimensions(f);
+    const nodes = await one(f, `MATCH (n) RETURN count(n) AS c`, Count);
+    const edges = await one(f, `MATCH ()-[r]->() RETURN count(r) AS c`, Count);
+    const structured = {
+        dimensions,
+        totals: {
+            qdrant_chunks: await qdrantPoints(qd),
+            falkor_nodes: nodes?.c ?? 0,
+            falkor_edges: edges?.c ?? 0,
+        },
+        recent_gaps: an.getRecentGaps(10).map((g) => ({
+            query: g.query,
+            tool: g.tool,
+            hit_count: g.hit_count,
+            last_seen: g.last_seen,
+            user_reported: g.user_reported,
+        })),
+        generated_at: new Date().toISOString(),
+    };
+    const text = formatCoverageText(structured);
+    an.logQuery({ tool: "c64_coverage", query: "snapshot", resultCount: 1 });
+    return { structured, text };
+}
+function formatCoverageText(c) {
+    const lines = [
+        `# c64-kb Coverage Snapshot`,
+        ``,
+        `Generated: ${c.generated_at}`,
+        ``,
+        `## Totals`,
+        `- Qdrant chunks: ${c.totals.qdrant_chunks}`,
+        `- FalkorDB nodes: ${c.totals.falkor_nodes}`,
+        `- FalkorDB edges: ${c.totals.falkor_edges}`,
+        ``,
+        `## Technique categories`,
+        ...c.dimensions.technique_categories.map((t) => `- ${t.category}: ${t.count}`),
+        ``,
+        `## Pitfall categories`,
+        ...c.dimensions.pitfall_categories.map((p) => `- ${p.category}: ${p.count}`),
+        ``,
+        `## Recipe toolchains`,
+        ...c.dimensions.recipe_toolchains.map((r) => `- ${r.toolchain}: ${r.count}`),
+        ``,
+        `## KERNAL coverage`,
+        `- Total routines: ${c.dimensions.kernal_coverage.total_routines}`,
+        `- With PAIRS_WITH edge: ${c.dimensions.kernal_coverage.with_pairs_with_edge}`,
+        ``,
+        `## Recent gaps (top ${c.recent_gaps.length})`,
+        ...c.recent_gaps.map((g) => `- "${g.query}" via ${g.tool} (hit ${g.hit_count}x, last ${g.last_seen})${g.user_reported ? " [user-reported]" : ""}`),
+    ];
+    return lines.join("\n");
+}
+/** The first new edge this chunk evidences, if any (one suggestion per chunk). */
+function suggestFromChunk(h, e, ch, seen) {
+    const ctx = h.context(e, ch.section.toLowerCase());
+    for (const t of h.targets) {
+        if (ctx.exclude.has(t.key))
+            continue;
+        const dedupKey = `${e.name}::${t.key}${ctx.tag}`;
+        if (seen.has(dedupKey))
+            continue;
+        if (!t.forms.some((form) => ch.text.includes(form)))
+            continue;
+        seen.add(dedupKey);
+        return {
+            kind: ctx.kind,
+            from: { kind: h.fromKind, name: e.name },
+            to: { kind: h.toKind, name: t.name },
+            evidence: ch.text.slice(0, 150).trim(),
+            confidence: ctx.confidence,
+        };
+    }
+    return null;
+}
+async function runHeuristic(h, out, limit) {
+    // Each unique missing edge surfaces once however many chunks evidence it.
+    const seen = new Set();
+    for (const e of h.entities) {
+        if (out.length >= limit)
+            return;
+        for (const ch of await h.chunks(e)) {
+            if (out.length >= limit)
+                return;
+            const s = suggestFromChunk(h, e, ch, seen);
+            if (s)
+                out.push(s);
+        }
+    }
+}
+/** "high" when the section names one of `high`, "medium" when it names `medium`, else "low". */
+function sectionConfidence(section, high, medium) {
+    if (high.some((w) => section.includes(w)))
+        return "high";
+    return section.includes(medium) ? "medium" : "low";
+}
+/**
+ * Up to `n` chunks of one source doc. With `nameHint`, chunks whose section
+ * names the entity come first; without a match, the file's first chunks.
+ * A failed scroll is reported on stderr and gives no chunks.
+ */
+async function docChunks(qd, source, opts) {
+    let all;
+    try {
+        // scrollBySource does exact keyword-index match — fast and correct
+        all = await qd.scrollBySource(source, opts.nameHint ? 50 : opts.n);
+    }
+    catch (err) {
+        console.error(`[suggest-links] cannot read chunks of ${source}: ${err instanceof Error ? err.message : String(err)}`);
+        return [];
+    }
+    if (!opts.nameHint)
+        return all;
+    const nameKey = opts.nameHint.toLowerCase().replace(/_/g, "");
+    const matched = all.filter((ch) => ch.section
+        .toLowerCase()
+        .replace(/[\s_-]/g, "")
+        .includes(nameKey));
+    return (matched.length > 0 ? matched : all).slice(0, opts.n);
+}
+/**
+ * Derive a source doc path for a Pitfall from its category.
+ * The pitfalls/ directory uses different naming conventions for some files.
+ */
+function pitfallSourceDoc(category) {
+    const PITFALL_FILE_MAP = {
+        raster: "raster-and-badline.md",
+        kernal: "kernal-and-io.md",
+        region: "region-timing.md",
+    };
+    const file = PITFALL_FILE_MAP[category] ?? `${category}.md`;
+    return `pitfalls/${file}`;
+}
+const RegisterRow = z.object({ name: z.string(), aliases: z.array(z.string()).nullable() });
+const TechniqueUsesRow = z.object({
+    name: z.string(),
+    category: z.string(),
+    uses: z.array(z.string().nullable()),
+});
+const NameRow = z.object({ name: z.string() });
+const RecipeRow = z.object({
+    name: z.string(),
+    source_doc: z.string().nullable(),
+    implements: z.array(z.string()),
+});
+const PitfallRow = z.object({
+    name: z.string(),
+    category: z.string(),
+    triggered_by: z.array(z.string()),
+    mitigated_by: z.array(z.string()),
+});
+async function techniqueTargets(f) {
+    const rows = await f.roQuery(`MATCH (t:Technique) RETURN DISTINCT t.name AS name`, undefined, NameRow);
+    return rows.data.map(({ name }) => ({ name, key: name, forms: [name] }));
+}
+/**
+ * TECHNIQUE USES REGISTER. Registers are grouped with their aliases, so D011
+ * and SCROLY are one target and a USES edge to either covers both (P5-15
+ * dedup workaround).
+ */
+async function techniqueRegisterHeuristic(f, qd) {
+    const regs = await f.roQuery(`MATCH (r:Register) RETURN DISTINCT r.name AS name, r.aliases AS aliases`, undefined, RegisterRow);
+    // Every form maps to one key: the sorted, joined set of all the register's forms.
+    const groupOf = new Map();
+    const targets = regs.data.map((r) => {
+        const forms = [r.name, ...(r.aliases ?? [])];
+        const key = [...forms].sort().join("|");
+        for (const form of forms)
+            groupOf.set(form, key);
+        return { name: r.name, key, forms };
+    });
+    // Re-key after all groups are known: a later row can claim an earlier row's form.
+    for (const t of targets)
+        t.key = groupOf.get(t.name) ?? t.name;
+    const techs = await f.roQuery(`MATCH (t:Technique)
+     OPTIONAL MATCH (t)-[:USES]->(reg:Register)
+     RETURN t.name AS name, t.title AS title, t.category AS category, collect(reg.name) AS uses`, undefined, TechniqueUsesRow);
+    const entities = techs.data.map((t) => ({
+        name: t.name,
+        category: t.category,
+        usesGroups: new Set(t.uses.filter((u) => Boolean(u)).map((u) => groupOf.get(u) ?? u)),
+    }));
+    return {
+        fromKind: "Technique",
+        toKind: "Register",
+        entities: targets.length === 0 ? [] : entities,
+        targets,
+        chunks: (t) => docChunks(qd, `techniques/${t.category}.md`, { n: 5, nameHint: t.name }),
+        context: (t, section) => ({
+            kind: "technique_uses_register",
+            exclude: t.usesGroups,
+            confidence: sectionConfidence(section, ["uses", "registers"], "technique"),
+            tag: "",
+        }),
+    };
+}
+/** RECIPE IMPLEMENTS TECHNIQUE: a technique name in the recipe's own page. */
+async function recipeTechniqueHeuristic(f, qd) {
+    const targets = await techniqueTargets(f);
+    const recipes = await f.roQuery(`MATCH (r:Recipe)
+     OPTIONAL MATCH (r)-[:IMPLEMENTS]->(t:Technique)
+     RETURN r.name AS name, r.source_doc AS source_doc, collect(t.name) AS implements`, undefined, RecipeRow);
+    return {
+        fromKind: "Recipe",
+        toKind: "Technique",
+        entities: targets.length === 0
+            ? []
+            : recipes.data.map((r) => ({
+                name: r.name,
+                sourceDoc: r.source_doc ?? "",
+                implemented: new Set(r.implements),
+            })),
+        targets,
+        chunks: (r) => (r.sourceDoc ? docChunks(qd, r.sourceDoc, { n: 5 }) : Promise.resolve([])),
+        context: (r, section) => ({
+            kind: "recipe_implements_technique",
+            exclude: r.implemented,
+            confidence: sectionConfidence(section, ["implements", "techniques"], "recipe"),
+            tag: "",
+        }),
+    };
+}
+/**
+ * PITFALL TRIGGERED_BY / MITIGATED_BY TECHNIQUE. The chunker's heading path
+ * ends in the H3 ("... > name — title > Fix"). A technique named in the Fix
+ * is evidence for MITIGATED_BY, not for TRIGGERED_BY: the two relations were
+ * conflated here until schema 19.
+ */
+async function pitfallTechniqueHeuristic(f, qd) {
+    const targets = await techniqueTargets(f);
+    const pitfalls = await f.roQuery(`MATCH (p:Pitfall)
+     OPTIONAL MATCH (p)-[:TRIGGERED_BY]->(t:Technique)
+     WITH p, collect(DISTINCT t.name) AS triggered_by
+     OPTIONAL MATCH (p)-[:MITIGATED_BY]->(m:Technique)
+     RETURN p.name AS name, p.category AS category, triggered_by, collect(DISTINCT m.name) AS mitigated_by`, undefined, PitfallRow);
+    return {
+        fromKind: "Pitfall",
+        toKind: "Technique",
+        entities: targets.length === 0
+            ? []
+            : pitfalls.data.map((p) => ({
+                name: p.name,
+                category: p.category,
+                triggeredBy: new Set(p.triggered_by),
+                mitigatedBy: new Set(p.mitigated_by),
+            })),
+        targets,
+        chunks: (p) => docChunks(qd, pitfallSourceDoc(p.category), { n: 5, nameHint: p.name }),
+        context: (p, section) => {
+            const isFix = (section.split(">").pop() ?? "").trim().startsWith("fix");
+            const kind = isFix ? "pitfall_mitigated_by_technique" : "pitfall_triggered_by_technique";
+            return {
+                kind,
+                exclude: isFix ? p.mitigatedBy : p.triggeredBy,
+                confidence: isFix ? "medium" : sectionConfidence(section, ["triggered", "techniques"], "pitfall"),
+                tag: `::${kind}`,
+            };
+        },
+    };
+}
+export async function suggestLinks(opts = {}) {
+    const kind = opts.kind ?? "all";
+    const limit = opts.limit ?? 20;
+    const f = await getFalkor();
+    const qd = await getQdrant();
+    const suggestions = [];
+    if (kind === "all" || kind === "technique-register") {
+        await runHeuristic(await techniqueRegisterHeuristic(f, qd), suggestions, limit);
+    }
+    if ((kind === "all" || kind === "recipe-technique") && suggestions.length < limit) {
+        await runHeuristic(await recipeTechniqueHeuristic(f, qd), suggestions, limit);
+    }
+    if ((kind === "all" || kind === "pitfall-technique") && suggestions.length < limit) {
+        await runHeuristic(await pitfallTechniqueHeuristic(f, qd), suggestions, limit);
+    }
+    const structured = {
+        suggestions: suggestions.slice(0, limit),
+        generated_at: new Date().toISOString(),
+    };
+    const text = formatSuggestLinksText(structured);
+    getAnalytics().logQuery({
+        tool: "c64_suggest_links",
+        query: `kind=${kind} limit=${limit}`,
+        resultCount: structured.suggestions.length,
+    });
+    return { structured, text };
+}
+function formatSuggestLinksText(s) {
+    if (s.suggestions.length === 0) {
+        return `# c64-kb Link Suggestions\n\nGenerated: ${s.generated_at}\n\nNo link suggestions surfaced. The graph may be well-connected, or the heuristics didn't fire.`;
+    }
+    const lines = [`# c64-kb Link Suggestions`, ``, `Generated: ${s.generated_at}`, ``];
+    for (const sug of s.suggestions) {
+        lines.push(`## ${sug.kind} (${sug.confidence})`);
+        lines.push(`- ${sug.from.kind} \`${sug.from.name}\` → ${sug.to.kind} \`${sug.to.name}\``);
+        lines.push(`- Evidence: "${sug.evidence}"`);
+        lines.push(``);
+    }
+    return lines.join("\n");
+}
+export function reportGap(opts) {
+    const result = getAnalytics().reportGap(opts.query, opts.tool_called ?? "unknown", opts.notes);
+    const structured = {
+        gap_id: result.gap_id,
+        hit_count: result.hit_count,
+        status: result.status,
+        message: result.status === "new"
+            ? `Gap recorded as id=${result.gap_id}. Hit count: ${result.hit_count}.`
+            : `Existing gap ${result.gap_id} incremented to hit_count=${result.hit_count}.`,
+    };
+    return Promise.resolve({ structured, text: structured.message });
+}
+//# sourceMappingURL=selfimprovement.js.map

package/dist/tools/selfimprovement.js.map

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

package/docker-compose.yml

@@ -0,0 +1,35 @@
+services:
+  qdrant:
+    image: qdrant/qdrant:v1.18.0@sha256:b3063c673f3973877c038eeecc392bad5011f072ee7892b56c9a8e204a3bdea9
+    restart: unless-stopped
+    ports:
+      - "7333:6333"
+      - "7334:6334"
+    volumes:
+      - ${C64_KB_STORAGE:-./storage}/qdrant:/qdrant/storage
+    environment:
+      QDRANT__SERVICE__GRPC_PORT: 6334
+    healthcheck:
+      test:
+        [
+          "CMD-SHELL",
+          "bash -c 'echo -e \"GET /readyz HTTP/1.0\\r\\nHost: localhost\\r\\n\\r\\n\" > /dev/tcp/localhost/6333'",
+        ]
+      interval: 10s
+      timeout: 5s
+      retries: 3
+
+  falkordb:
+    image: falkordb/falkordb@sha256:e93fcd753fe612fb0a222166a0620a1ae31b826a12f223c3b6d06038d9d7a364 # graph module 4.18.7 (INFO modules ver=41807); pinned 2026-09-22, was :latest
+    restart: unless-stopped
+    ports:
+      - "7379:6379"
+    volumes:
+      - ${C64_KB_STORAGE:-./storage}/falkordb:/var/lib/falkordb/data
+    environment:
+      REDIS_ARGS: "--appendonly yes"
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 3

package/docs/ARCHITECTURE.md

@@ -0,0 +1,164 @@
+# c64-kb Architecture
+
+## System overview
+
+c64-kb is a knowledge-base MCP server: hybrid vector search over a corpus of
+markdown reference documents, plus a knowledge graph of the entities those
+documents define, both served to Claude Code (or any MCP client) over stdio,
+and to the terminal through the same functions as a CLI.
+
+```
++---------------------+     +----------------------+
+|  a C64 project      |     |  templates/          |
+|  .mcp.json          |     |  starters, harness   |
++----------+----------+     +-----------+----------+
+           |        MCP (stdio)         |
+           +-------------+--------------+
+                         |
+              +----------v-----------+      +---------------------+
+              |  src/server.ts       |      |  src/cli.ts         |
+              |  23 tools, 12 res.,  |      |  same functions,    |
+              |  2 prompts           |      |  --json for hooks   |
+              +----------+-----------+      +----------+----------+
+                         +--------------+--------------+
+                                        |
+                          +-------------v--------------+
+                          |  src/tools/*.ts            |
+                          |  query, pitfalls,          |
+                          |  briefings, intelligence,  |
+                          |  selfimprovement, hydrate, |
+                          |  resources, run-game       |
+                          +---+--------------------+---+
+                              |                    |
+                  +-----------v-----+    +---------v----------+
+                  |  Qdrant :7333   |    |  FalkorDB :7379    |
+                  |  c64_docs       |    |  graph c64         |
+                  |  dense + BM25   |    |  node labels and   |
+                  +--------+--------+    |  edge types        |
+                           |             +--------------------+
+                  +--------v--------+
+                  |  Ollama :11434  |
+                  |  mxbai-embed-   |
+                  |  large (1024)   |
+                  +-----------------+
+```
+
+## Data flow
+
+**Ingest** (`src/ingest.ts`, `npm run ingest`):
+
+1. Walk `docs/` for markdown (75 files; `docs/superpowers/` is skipped if
+   present). `formats/` is walked first so FileFormat descriptions win the
+   on-create race; nothing else depends on order.
+2. Chunk each file by `##`/`###` heading (`src/services/chunker.ts`: up to
+   1,500 characters per chunk, split on paragraph boundaries above that,
+   code fences never split).
+3. Embed every chunk with `mxbai-embed-large` (8 requests in flight) and
+   encode a BM25 sparse vector from a vocabulary fitted over the whole
+   corpus. Delete the file's previous chunks, then upsert. Point ids are
+   `sha256(file, section, index)`; the delete is what removes a section
+   that was renamed or dropped.
+4. Extract graph entities from the same text (`src/graph/extract.ts`),
+   driven by the `CONVENTIONS-*.md` structure: H3 headings for registers,
+   memory regions and KERNAL routines; H2 blocks with metadata lines for
+   techniques and pitfalls; frontmatter for recipes; listing load addresses
+   for `OCCUPIES`.
+5. Two passes into FalkorDB: nodes first, then every edge, so a document
+   may reference an entity another document defines. A reference whose
+   target does not exist is warned about and counted; the run reports
+   edges in the graph, distinct references, and references dropped.
+6. After the passes, address-derived edges: each Register and KernalRoutine
+   into the MemoryRegion that contains its address.
+
+`--clean` (and `--force`, which implies it) wipes the graph's entity labels
+and drops and recreates the Qdrant collection first, because MERGE never
+removes an edge a document has stopped asserting.
+
+**Query**: tools in `src/tools/` read Qdrant (RRF fusion of dense and BM25
+results; keyword-only when Ollama is down) and FalkorDB (Cypher through
+`FalkorService.roQuery`). Every call is logged to SQLite
+(`data/analytics.db`) so queries with no results surface as gap candidates.
+
+## CLI-first
+
+Tool logic lives in `src/tools/*.ts` as functions returning
+`{ structured, text }`. Two entry points share them:
+
+- **CLI** (`src/cli.ts`): `health`, `serve`, `search`, `ingest-doc`,
+  `lookup-register`, `lookup-kernal`, `memory-map`, `lookup-opcode`,
+  `pal-ntsc-diff`, `toolchain-hint`, `recipe-lookup`, `recipes-for`,
+  `technique-lookup`, `techniques-for`, `check-compatibility`,
+  `timing-budget`, `pitfalls-for`, `failure-diagnose`, `demo-briefing`,
+  `game-briefing`, `version`; `--json` for hooks and scripts.
+- **MCP** (`src/server.ts`): the 23 tools listed in the README, 11 static
+  `c64://` resources plus the `c64://register/{name}` template, and the
+  `c64_demo_brief` / `c64_game_brief` prompts. Output schemas are Zod
+  (`src/schemas/tool-outputs.ts`).
+
+## Components
+
+### Qdrant (`src/services/qdrant.ts`)
+
+- Collection `c64_docs` (env `QDRANT_COLLECTION`); host port 7333 REST,
+  7334 gRPC (unused).
+- Named vectors: `dense` (1024, cosine) and `bm25` (sparse, IDF modifier).
+- Payload indexes: `source` (keyword, used by delete-by-source and
+  filtered search) and `text` (full text, keyword fallback).
+
+### FalkorDB (`src/services/falkor.ts`)
+
+- Graph `c64` (env `FALKOR_GRAPH`); host port 7379, Redis protocol.
+- Node labels `Chip`, `Region`, `Register`, `KernalRoutine`,
+  `MemoryRegion`, `Technique`, `Recipe`, `Pitfall`, `CrashPattern`, `Tool`,
+  `FileFormat`, `Resource` and `Archetype`, and the edge types between
+  them; `ONTOLOGY.md` defines each and says which page line produces it.
+- Range index and unique constraint on every primary key; `Chip` and
+  `Region` seeded by `ensureSchema()`.
+- Registers, KERNAL routines and memory regions carry numeric address
+  properties (`addr_n`, `start_n`, `end_n`) for the range queries behind
+  `IN_REGION` and `OCCUPIES`.
+
+### Embeddings (`src/services/embeddings.ts`)
+
+`mxbai-embed-large` through Ollama at `:11434`, 1024 dimensions, 8
+concurrent requests. Returns null when Ollama is unreachable; query paths
+fall back to keyword search, ingest stops.
+
+### Analytics (`src/services/analytics.ts`)
+
+SQLite at `data/analytics.db` (env `ANALYTICS_DB`). One row per tool call
+with query and result count; read by `c64_coverage` and `c64_report_gap`.
+
+### Evaluation (`src/tools/run-game.ts`)
+
+`c64_run_game` spawns `x64sc` with `-autostart`, connects through a local
+vice-mcp (`VICE_MCP_PATH`) and returns a state trace and screen render. It
+is the only path that touches an emulator and nothing else depends on it.
+
+## Verification
+
+- `npm test`: vitest, 155 tests. `vitest.config.ts` points them at
+  `FALKOR_GRAPH=c64_test` and `QDRANT_COLLECTION=c64_docs_test`; tests
+  call `clean()` freely and the ingested stores are never touched.
+- `npm run check:listings` (`scripts/check-listings.ts`): builds every
+  recipe listing with the toolchain it names (KickAssembler via
+  `KICKASS_JAR`, Oscar64, cc65) and assembles every KickAssembler-syntax
+  fragment elsewhere in `docs/`. The vitest wrapper runs it with
+  `--allow-missing`.
+- The KickAssembler recipes were also run headless in VICE
+  (`x64sc -warp -autostartprgmode 1 -limitcycles N -exitscreenshot`) and
+  the screenshots measured; they live in
+  `docs/recipes/kickassembler/screenshots/`.
+
+## Ports
+
+| Service | Host port | In-container | Protocol |
+|---------|-----------|--------------|----------|
+| Qdrant | 7333 | 6333 | HTTP REST |
+| Qdrant | 7334 | 6334 | gRPC (unused) |
+| FalkorDB | 7379 | 6379 | Redis |
+| Ollama | 11434 | n/a (host) | HTTP |
+
+All on localhost. `docker-compose.yml` ships Qdrant and FalkorDB; Ollama
+is installed on the host. The MCP server is not containerized: stdio
+transport means the process runs beside the Claude Code session.