c64-kb 0.17.0

package/dist/cli/setup.js

@@ -0,0 +1,66 @@
+/**
+ * Setup commands: the steps an npm install needs before any lookup works.
+ * In a repository checkout the npm scripts do the same (`npm run services`,
+ * `npm run ingest`); an installed package has no npm scripts, so without
+ * these a user could not start the stores or fill them.
+ *
+ *   c64-kb services up|down|status   Qdrant + FalkorDB in Docker
+ *   c64-kb ingest [--clean|--force]  build both stores from the shipped docs/
+ */
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Argument } from "commander";
+import { config } from "../config.js";
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const COMPOSE_FILE = path.join(PACKAGE_ROOT, "docker-compose.yml");
+const COMPOSE_ARGS = {
+    up: ["up", "-d", "--wait"],
+    down: ["down"],
+    status: ["ps"],
+};
+/**
+ * Run `docker compose` on the shipped compose file. The stores' volumes go
+ * under the data folder (C64_KB_STORAGE), not inside the package, which an
+ * upgrade would replace. The project name is fixed so `down` finds what
+ * `up` started from any working directory.
+ */
+function compose(action) {
+    const args = COMPOSE_ARGS[action] ?? [];
+    const storage = process.env.C64_KB_STORAGE ?? path.join(config.dataDir, "storage");
+    // Create the bind-mount folders as this user first. On Linux, Docker
+    // creates a missing one as root, parents included, and the data folder
+    // then refuses the ingest's writes (EACCES on ingest.log, CI 2026-09-24).
+    for (const store of ["qdrant", "falkordb"])
+        fs.mkdirSync(path.join(storage, store), { recursive: true });
+    const r = spawnSync("docker", ["compose", "-f", COMPOSE_FILE, "-p", "c64-kb", ...args], {
+        stdio: "inherit",
+        env: { ...process.env, C64_KB_STORAGE: storage },
+    });
+    if (r.error) {
+        console.error(`c64-kb services: could not run docker (${r.error.message}). Install Docker, then retry.`);
+        return 1;
+    }
+    return r.status ?? 1;
+}
+export function registerSetupCommands(program) {
+    program
+        .command("services")
+        .description("Start, stop or list the Qdrant and FalkorDB containers (needs Docker)")
+        .addArgument(new Argument("<action>", "what to do").choices(Object.keys(COMPOSE_ARGS)))
+        .action((action) => {
+        process.exitCode = compose(action);
+    });
+    program
+        .command("ingest")
+        .description("Build the vector store and the graph from the docs (needs services and Ollama)")
+        .option("--clean", "Wipe the graph and the collection first")
+        .option("--force", "Re-ingest every file (implies --clean)")
+        .action(async (opts) => {
+        const { runIngest } = await import("../ingest.js");
+        const forceAll = opts.force === true;
+        process.exitCode = await runIngest({ forceAll, cleanFirst: forceAll || opts.clean === true });
+    });
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/setup.js.map

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

package/dist/cli-memorize-audit.js

@@ -0,0 +1,97 @@
+#!/usr/bin/env node
+/**
+ * c64-kb memorize-audit — run a candidate's events through the memorization
+ * service and print a verdict table.
+ *
+ * Usage:
+ *   npm run memorize:audit -- --candidate path/to/candidate-events.json
+ *                              [--references path/to/refs.json]
+ *
+ * candidate-events.json is a JSON array of NoteEvent dicts.
+ * references.json is a JSON array of arrays (each inner array is one
+ * reference tune's events).
+ *
+ * Exit codes:
+ *   0 — not flagged as a copy
+ *   1 — service error / crash
+ *   2 — candidate flagged as a possible copy
+ */
+import { readFileSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { join } from "node:path";
+import { z } from "zod";
+// The service's reply is JSON from a subprocess: validated, not cast. Every
+// field is printed as the service sent it, so each is only required to be
+// an object field; thresholds, which is iterated, must be an object if present.
+const VerdictSchema = z.object({
+    kind: z.unknown(),
+    error_kind: z.unknown(),
+    message: z.unknown(),
+    copy_detected: z.unknown(),
+    ssimuse_score: z.unknown(),
+    originality_pct: z.unknown(),
+    nearest_neighbor_distance: z.unknown(),
+    thresholds: z.record(z.string(), z.unknown()).optional(),
+});
+const args = process.argv.slice(2);
+const candidateIdx = args.indexOf("--candidate");
+const referencesIdx = args.indexOf("--references");
+const candidatePath = candidateIdx === -1 ? undefined : args.at(candidateIdx + 1);
+if (!candidatePath) {
+    console.error("Usage: memorize-audit --candidate <events.json> [--references <refs.json>]");
+    process.exit(2);
+}
+const referencesPath = referencesIdx !== -1 ? args.at(referencesIdx + 1) : undefined;
+// Passed through to the service unchanged; the service validates the events.
+const candidate = JSON.parse(readFileSync(candidatePath, "utf8"));
+const references = referencesPath ? JSON.parse(readFileSync(referencesPath, "utf8")) : [];
+const request = JSON.stringify({ kind: "check", events: candidate, references });
+const analyzerDir = join(process.cwd(), "analyzer");
+const result = spawnSync(join(analyzerDir, ".venv/bin/python"), ["-m", "src.memorization.service", "--stdio"], { cwd: analyzerDir, input: request + "\n", encoding: "utf8" });
+if (result.status !== 0) {
+    console.error("Service crashed:", result.stderr);
+    process.exit(1);
+}
+const rawOut = result.stdout.trim();
+if (!rawOut) {
+    console.error("Service produced no output");
+    process.exit(1);
+}
+function parseVerdict(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        console.error("Could not parse service output:", raw);
+        process.exit(1);
+    }
+    const verdict = VerdictSchema.safeParse(parsed);
+    if (!verdict.success) {
+        console.error("Service output is not a verdict object:", raw);
+        process.exit(1);
+    }
+    return verdict.data;
+}
+const verdict = parseVerdict(rawOut);
+if (verdict.kind === "error") {
+    console.error("Service error:", verdict.error_kind, verdict.message);
+    process.exit(1);
+}
+console.log("Memorization audit verdict");
+console.log("==========================");
+console.log(`copy_detected:              ${String(verdict.copy_detected)}`);
+console.log(`ssimuse_score:              ${Number(verdict.ssimuse_score).toFixed(3)}`);
+console.log(`originality_pct:            ${Number(verdict.originality_pct).toFixed(3)}`);
+console.log(`nearest_neighbor_distance:  ${Number(verdict.nearest_neighbor_distance).toFixed(3)}`);
+console.log("");
+console.log("Thresholds:");
+for (const [k, v] of Object.entries(verdict.thresholds ?? {})) {
+    console.log(`  ${k}: ${String(v)}`);
+}
+console.log("");
+if (verdict.copy_detected) {
+    console.error("WARNING: Candidate flagged as a possible copy.");
+    process.exit(2);
+}
+//# sourceMappingURL=cli-memorize-audit.js.map

package/dist/cli-memorize-audit.js.map

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

package/dist/cli.js

@@ -0,0 +1,335 @@
+#!/usr/bin/env node
+/**
+ * c64-kb CLI: terminal access to the Commodore 64 knowledge base. The
+ * commands mirror the MCP tools; `c64-kb --help` lists them.
+ *
+ * Commands set process.exitCode and return; the postAction hook closes the
+ * service connections so the process ends on its own. Every action used to
+ * end in process.exit(), which can cut off a large --json output piped to
+ * another program (stdout to a pipe is asynchronous).
+ */
+import { Command, InvalidArgumentError, Option } from "commander";
+import { health, formatHealth } from "./tools/intelligence.js";
+import { getVersions } from "./services/versions.js";
+import { startMcpServer } from "./server.js";
+import { closeAll } from "./context.js";
+import { definedOnly } from "./server/defined-only.js";
+import { registerSetupCommands } from "./cli/setup.js";
+const TOOLCHAINS = ["oscar64", "kickassembler", "cc65"];
+const REGIONS = ["pal", "ntsc", "both"];
+/** Commander argParser for an integer option; parseInt semantics, as the option was read before. */
+function intArg(value) {
+    const n = parseInt(value, 10);
+    if (Number.isNaN(n))
+        throw new InvalidArgumentError("Not a number.");
+    return n;
+}
+/** Commander argParser for a numeric option; Number() semantics, as the option was read before. */
+function numberArg(value) {
+    const n = Number(value);
+    if (Number.isNaN(n))
+        throw new InvalidArgumentError("Not a number.");
+    return n;
+}
+function regionArg(value) {
+    if (!/^\s*(pal|ntsc|both)\s*$/i.test(value))
+        throw new InvalidArgumentError("Use pal, ntsc or both.");
+    return value;
+}
+const program = new Command();
+// Every lookup command prints its markdown, or, under the global --json
+// flag, the same tool's structured object (the shape the MCP server
+// returns). Until data 718 only the briefings honoured the flag.
+function emit(result) {
+    if (program.opts().json) {
+        console.log(JSON.stringify(result.structured ?? result, null, 2));
+    }
+    else {
+        console.log(result.text);
+    }
+}
+program
+    .name("c64-kb")
+    .description("Commodore 64 knowledge base")
+    .version(getVersions().package)
+    .option("--json", "Output JSON instead of human-readable text")
+    .hook("postAction", async (_program, action) => {
+    if (action.name() !== "serve")
+        await closeAll();
+});
+registerSetupCommands(program);
+program
+    .command("version")
+    .description("Print all c64-kb versions (package, KB data, KB schema, MCP tool surface)")
+    .action(() => {
+    const v = getVersions();
+    if (program.opts().json) {
+        console.log(JSON.stringify(v));
+    }
+    else {
+        console.log(`package         ${v.package}`);
+        console.log(`KB_DATA_VERSION  ${v.kb_data}`);
+        console.log(`KB_SCHEMA_VERSION ${v.kb_schema}`);
+        console.log(`MCP_TOOL_VERSION  ${v.mcp_tool}`);
+    }
+});
+program
+    .command("health")
+    .description("Check backing service health (Qdrant, FalkorDB, Ollama, Analytics)")
+    .action(async () => {
+    const result = await health();
+    if (program.opts().json) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(formatHealth(result));
+    }
+    process.exitCode = result.healthy ? 0 : 1;
+});
+program
+    .command("serve")
+    .description("Start the MCP server on stdio (for .mcp.json connections)")
+    .action(async () => {
+    await startMcpServer();
+});
+program
+    .command("search")
+    .description("Semantic search across the knowledge base")
+    .argument("<query>", "Natural language query")
+    .addOption(new Option("--limit <n>", "Max results").default(5).argParser(intArg))
+    .option("--source <pattern>", "Filter by source file")
+    .action(async (query, opts) => {
+    const { search } = await import("./tools/query.js");
+    const result = await search(query, opts.limit, opts.source);
+    emit(result);
+});
+program
+    .command("ingest-doc")
+    .description("Ingest a single markdown file into the KB")
+    .argument("<path>", "Path to markdown file")
+    .action(async (docPath) => {
+    const { ingestDoc } = await import("./tools/hydrate.js");
+    const fs = await import("fs");
+    const content = fs.readFileSync(docPath, "utf-8");
+    const result = await ingestDoc(docPath, content);
+    console.log(result);
+});
+program
+    .command("lookup-register <name>")
+    .description("Look up a register by name or address")
+    .action(async (name) => {
+    const { lookupRegister } = await import("./tools/query.js");
+    const result = await lookupRegister(name);
+    emit(result);
+});
+program
+    .command("lookup-kernal <name>")
+    .description("Look up a KERNAL routine by name or address")
+    .action(async (name) => {
+    const { lookupKernal } = await import("./tools/query.js");
+    const result = await lookupKernal(name);
+    emit(result);
+});
+program
+    .command("memory-map <addr>")
+    .description("Look up the memory region containing a hex address")
+    .action(async (addr) => {
+    const { memoryMap } = await import("./tools/query.js");
+    const result = await memoryMap(addr);
+    emit(result);
+});
+program
+    .command("lookup-opcode <op>")
+    .description("Look up a 6510 opcode by byte or mnemonic")
+    .action(async (op) => {
+    const { lookupOpcode } = await import("./tools/query.js");
+    const result = await lookupOpcode(op);
+    emit(result);
+});
+program
+    .command("pal-ntsc-diff <topic>")
+    .description("Compare PAL vs NTSC for a topic")
+    .addOption(new Option("--region <region>", "Limit to a single region: pal, ntsc, or both")
+    .choices(REGIONS)
+    .default("both"))
+    .action(async (topic, opts) => {
+    const { palNtscDiff } = await import("./tools/query.js");
+    const result = await palNtscDiff(topic, opts.region);
+    emit(result);
+});
+program
+    .command("toolchain-hint <intent>")
+    .addOption(new Option("--toolchain <toolchain>", "oscar64 | kickassembler | cc65 (default: oscar64)").choices(TOOLCHAINS))
+    .description("Get an idiomatic snippet for a toolchain + intent")
+    .action(async (intent, opts) => {
+    const { toolchainHint } = await import("./tools/query.js");
+    const result = await toolchainHint(opts.toolchain, intent);
+    emit(result);
+});
+program
+    .command("recipe-lookup <name>")
+    .description("Look up a recipe by canonical name (e.g. 'oscar64-hello-world')")
+    .action(async (name) => {
+    const { recipeLookup } = await import("./tools/query.js");
+    const result = await recipeLookup(name);
+    emit(result);
+});
+program
+    .command("recipes-for")
+    .addOption(new Option("--toolchain <toolchain>", "Filter by toolchain").choices(TOOLCHAINS))
+    .addOption(new Option("--region <region>", "Filter by region (pal/ntsc/both)").choices(REGIONS))
+    .option("--technique <technique>", "Filter by Technique title")
+    .option("--file-format <fmt>", "Filter by FileFormat")
+    .option("--verified-on <variant>", "MachineVariant name or region word: recipes run in VICE on it")
+    .description("List recipes filtered by toolchain/region/technique/format/verified-on")
+    .action(async (opts) => {
+    const { recipesFor } = await import("./tools/query.js");
+    const result = await recipesFor(definedOnly({
+        toolchain: opts.toolchain,
+        region: opts.region,
+        technique: opts.technique,
+        file_format: opts.fileFormat,
+        verified_on: opts.verifiedOn,
+    }));
+    emit(result);
+});
+program
+    .command("technique-lookup <name>")
+    .description("Look up a technique by canonical snake_case name (e.g. 'stable_raster_irq')")
+    .action(async (name) => {
+    const { techniqueLookup } = await import("./tools/query.js");
+    const result = await techniqueLookup(name);
+    emit(result);
+});
+program
+    .command("techniques-for")
+    .description("List techniques filtered by category/chip/region/register/recipe/requires/claims")
+    .option("--category <category>", "Filter by category (raster, sprite, scroll, bitmap, banking...)")
+    .option("--chip <chip>", "Filter by chip (e.g. VIC-II, SID)")
+    .option("--region <region>", "Filter by required region (PAL or NTSC)")
+    .option("--register <register>", "Filter by register used (e.g. D011)")
+    .option("--recipe <recipe>", "Filter by recipe that implements the technique")
+    .option("--requires <technique>", "Filter to techniques that build on this one (REQUIRES chain, e.g. stable_raster_irq)")
+    .option("--claims <unit>", "Filter to techniques that claim this HardwareUnit (e.g. sid_voice_3, vic_raster_irq)")
+    .action(async (opts) => {
+    const { techniquesFor } = await import("./tools/query.js");
+    const result = await techniquesFor(definedOnly(opts));
+    emit(result);
+});
+program
+    .command("check-compatibility <techniques...>")
+    .description("Check compatibility of two or more techniques (space-separated names)")
+    .action(async (techniques) => {
+    const { checkCompatibility } = await import("./tools/query.js");
+    const result = await checkCompatibility(techniques);
+    emit(result);
+});
+program
+    .command("timing-budget <technique>")
+    .description("Compute per-scanline cycle budget for a technique")
+    .option("--region <region>", "PAL or NTSC (case-insensitive, default: pal)", "pal")
+    .addOption(new Option("--sprites <n>", "sprites displayed on the line, 0-8 (default: the technique's Cost sprites_per_line)").argParser(numberArg))
+    .action(async (technique, opts) => {
+    const { timingBudget } = await import("./tools/query.js");
+    const result = await timingBudget({
+        technique,
+        region: opts.region,
+        ...(opts.sprites !== undefined ? { sprites_per_line: opts.sprites } : {}),
+    });
+    emit(result);
+});
+program
+    .command("plan-budget [techniques...]")
+    .description('Budget a set of techniques per phase ("name" or "name:play|transition|init"), or a GameDesign with --design: cycle range, left-out figures, unknowns, verdict, measured frame beside the prediction')
+    .option("--design <name>", "a GameDesign name; its composed techniques are budgeted by phase")
+    .addOption(new Option("--region <region>", "pal, ntsc or both (default: PAL unless every region-locked member is NTSC)").argParser(regionArg))
+    .addOption(new Option("--screen <state>", "display on or off").choices(["on", "off"]))
+    .addOption(new Option("--sprites <n>", "sprites displayed on each sprite line, 0-8").argParser(numberArg))
+    .addOption(new Option("--sprite-lines <n>", "raster lines with sprites on them (default 200)").argParser(numberArg))
+    .action(async (techniques, opts) => {
+    const { planBudgetTool, budgetRegion } = await import("./tools/query.js");
+    const region = budgetRegion(opts.region);
+    const result = await planBudgetTool({
+        techniques,
+        ...(opts.design !== undefined ? { design: opts.design } : {}),
+        ...(region !== undefined ? { region } : {}),
+        ...(opts.screen !== undefined ? { screen: opts.screen } : {}),
+        ...(opts.sprites !== undefined ? { sprites_per_line: opts.sprites } : {}),
+        ...(opts.spriteLines !== undefined ? { sprite_lines: opts.spriteLines } : {}),
+    });
+    emit(result);
+});
+program
+    .command("lint <file>")
+    .description("Run the pitfall rules over a C or assembly source file (language from the extension, or --language)")
+    .addOption(new Option("--language <lang>", "c, asm or auto").choices(["c", "asm", "auto"]).default("auto"))
+    .option("--toolchain <name>", "Toolchain name recorded in the output")
+    .action(async (file, opts) => {
+    const { lintSourceResult } = await import("./tools/lint.js");
+    const fs = await import("fs");
+    const source = fs.readFileSync(file, "utf-8");
+    let language = opts.language;
+    if (language === "auto") {
+        if (/\.(c|h)$/i.test(file))
+            language = "c";
+        else if (/\.(asm|s|a|inc)$/i.test(file))
+            language = "asm";
+    }
+    const result = lintSourceResult(source, { language, toolchain: opts.toolchain }, file);
+    emit(result);
+    process.exitCode = result.structured.findings.some((f) => f.certainty === "definite") ? 1 : 0;
+});
+program
+    .command("pitfalls-for <topic>")
+    .description("Look up pitfalls triggered by a register, KERNAL routine, or technique (for a technique, also the pitfalls it is the fix for)")
+    .action(async (topic) => {
+    const { pitfallsFor } = await import("./tools/pitfalls.js");
+    const result = await pitfallsFor(topic);
+    emit(result);
+});
+program
+    .command("failure-diagnose <symptom>")
+    .description("Diagnose a failure symptom against the crash-pattern catalog")
+    .action(async (symptom) => {
+    const { failureDiagnose } = await import("./tools/pitfalls.js");
+    const result = await failureDiagnose(symptom);
+    emit(result);
+});
+program
+    .command("demo-briefing <description>")
+    .description("Generate a structured C64 demo plan from a brief (Phase 5 anchor tool)")
+    .option("--archetype <name>", "Demo form from docs/demo-design/intro-cracktro-patterns.md (cracktro, demo_intro, pack_intro, dentro, party_intro_4k)")
+    .action(async (description, opts) => {
+    const { demoBriefing } = await import("./tools/briefings.js");
+    const result = await demoBriefing(description, opts.archetype);
+    if (program.opts().json) {
+        console.log(JSON.stringify(result.structured, null, 2));
+    }
+    else {
+        emit(result);
+    }
+});
+program
+    .command("game-briefing <description>")
+    .description("Generate a structured C64 game plan from a brief (Phase 5 anchor tool)")
+    .option("--archetype <name>", "Archetype name from docs/game-design/c64-game-archetypes.md (vertical_shmup, puzzle, racing, ...)")
+    .option("--genre <genre>", "Alias of --archetype")
+    .action(async (description, opts) => {
+    const { gameBriefing } = await import("./tools/briefings.js");
+    const result = await gameBriefing(description, opts.archetype ?? opts.genre);
+    if (program.opts().json) {
+        console.log(JSON.stringify(result.structured, null, 2));
+    }
+    else {
+        emit(result);
+    }
+});
+try {
+    await program.parseAsync(process.argv);
+}
+catch (err) {
+    console.error(err instanceof Error ? err.message : err);
+    await closeAll();
+    process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.js

@@ -0,0 +1,83 @@
+/**
+ * Centralized configuration. All service URLs and settings come from
+ * environment variables with sane defaults for local dev.
+ *
+ * In Docker: services are at their container names (qdrant, falkordb).
+ * Local dev: everything is at localhost.
+ *
+ * Ports are shifted off the Qdrant/FalkorDB defaults (6333/6379) to 7333/7379
+ * so another instance of either service can run on the same host.
+ *
+ * The environment is parsed once, here, and a bad value stops the process
+ * with the variable's name. `parseInt` used to turn FALKOR_PORT=abc into NaN
+ * and fail later at connect time.
+ */
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { z } from "zod";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * Where the analytics database, BM25 vocabulary, ingest hashes and ingest log
+ * live. A repository checkout keeps them in its own data/ as it always has.
+ * An npm install (the package sits under node_modules) must not: a global
+ * install may not be writable, and an upgrade replaces the folder. It uses
+ * $XDG_DATA_HOME/c64-kb, else ~/.local/share/c64-kb. C64_KB_DATA_DIR
+ * overrides both.
+ */
+function defaultDataDir() {
+    const installed = __dirname.split(path.sep).includes("node_modules");
+    if (!installed)
+        return path.resolve(__dirname, "../data");
+    const base = process.env.XDG_DATA_HOME ?? path.join(os.homedir(), ".local", "share");
+    return path.join(base, "c64-kb");
+}
+const Env = z.object({
+    QDRANT_URL: z.url().default("http://localhost:7333"),
+    QDRANT_COLLECTION: z.string().min(1).default("c64_docs"),
+    FALKOR_HOST: z.string().min(1).default("localhost"),
+    FALKOR_PORT: z.coerce.number().int().min(1).max(65535).default(7379),
+    FALKOR_GRAPH: z.string().min(1).default("c64"),
+    OLLAMA_URL: z.url().default("http://localhost:11434"),
+    EMBED_MODEL: z.string().min(1).default("mxbai-embed-large"),
+    EMBED_CONCURRENCY: z.coerce.number().int().min(1).default(8),
+    DOCS_DIR: z.string().min(1).default(path.resolve(__dirname, "../docs")),
+    C64_KB_DATA_DIR: z.string().min(1).default(defaultDataDir()),
+    ANALYTICS_DB: z.string().min(1).optional(),
+});
+const parsed = Env.safeParse(process.env);
+if (!parsed.success) {
+    throw new Error(`Invalid environment:\n${z.prettifyError(parsed.error)}`);
+}
+const env = parsed.data;
+export const config = {
+    // Qdrant vector store
+    qdrant: {
+        url: env.QDRANT_URL,
+        collection: env.QDRANT_COLLECTION,
+        vectorSize: 1024, // mxbai-embed-large
+    },
+    // FalkorDB graph
+    falkor: {
+        host: env.FALKOR_HOST,
+        port: env.FALKOR_PORT,
+        graphName: env.FALKOR_GRAPH,
+    },
+    // Ollama embeddings (a host-level service; other tools may share it)
+    ollama: {
+        url: env.OLLAMA_URL,
+        model: env.EMBED_MODEL,
+        concurrency: env.EMBED_CONCURRENCY,
+    },
+    // Knowledge base docs
+    docs: {
+        dir: env.DOCS_DIR,
+    },
+    // Per-machine state. The BM25 vocab, ingest hashes and log sit beside the
+    // analytics database, so ANALYTICS_DB (the tests set it) moves them too.
+    dataDir: env.C64_KB_DATA_DIR,
+    analytics: {
+        dbPath: env.ANALYTICS_DB ?? path.join(env.C64_KB_DATA_DIR, "analytics.db"),
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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