bikky 0.3.1 → 0.3.3

package/dist/render.js

@@ -0,0 +1,185 @@
+/**
+ * `bikky render` — render a prompt to JSON without booting the MCP server.
+ *
+ * Designed for external evaluation harnesses (e.g. DeepEval-based test suites)
+ * and for debugging prompts manually. Prompts remain the single source of truth
+ * in src/prompts/; consumers shell out to this command instead of re-implementing
+ * the rendering logic.
+ *
+ * Usage:
+ *   bikky render <name>                  # reads input JSON from stdin
+ *   bikky render <name> --input <path>   # reads input JSON from file
+ *   bikky render --list                  # list available prompts
+ *
+ * Output (stdout): JSON object with promptName, messages, temperature, etc.
+ * Errors → stderr, exit 1.
+ */
+import fs from "node:fs";
+import { extractionPrompt, distillPrompt, contradictionPrompt, relationsPrompt, briefPrompt, episodeSummaryPrompt, workstreamSummaryPrompt, EXTRACTION_PROMPT_DESCRIPTOR, DISTILL_PROMPT_DESCRIPTOR, CONTRADICTION_PROMPT_DESCRIPTOR, RELATIONS_PROMPT_DESCRIPTOR, BRIEF_PROMPT_DESCRIPTOR, EPISODE_SUMMARY_PROMPT_DESCRIPTOR, WORKSTREAM_SUMMARY_PROMPT_DESCRIPTOR, } from "./prompts/index.js";
+export const PROMPT_REGISTRY = {
+    extraction: {
+        id: EXTRACTION_PROMPT_DESCRIPTOR.id,
+        version: EXTRACTION_PROMPT_DESCRIPTOR.version,
+        describe: 'Extract atomic facts from a session transcript. Input: { transcript: string, systemOverride?: string|null }',
+        build: (input) => extractionPrompt(input),
+    },
+    distill: {
+        id: DISTILL_PROMPT_DESCRIPTOR.id,
+        version: DISTILL_PROMPT_DESCRIPTOR.version,
+        describe: 'Consolidate >=3 session summaries into reusable patterns. Input: { summaries: [{ id, date, content, tasks_completed?, decisions_made? }] }',
+        build: (input) => distillPrompt(input),
+    },
+    contradiction: {
+        id: CONTRADICTION_PROMPT_DESCRIPTOR.id,
+        version: CONTRADICTION_PROMPT_DESCRIPTOR.version,
+        describe: 'Decide whether a new fact contradicts existing candidates. Input: { newFact: { content, category }, candidates: [{ id, content, category, score }] }',
+        build: (input) => contradictionPrompt(input),
+    },
+    relations: {
+        id: RELATIONS_PROMPT_DESCRIPTOR.id,
+        version: RELATIONS_PROMPT_DESCRIPTOR.version,
+        describe: 'Infer typed relations between two entities from shared facts. Input: { entityA, entityB, sharedFacts: [{ content, category }] }',
+        build: (input) => relationsPrompt(input),
+    },
+    brief: {
+        id: BRIEF_PROMPT_DESCRIPTOR.id,
+        version: BRIEF_PROMPT_DESCRIPTOR.version,
+        describe: 'Generate a session briefing from grouped fact sections. Input: { generatedAt: ISO date, sections: { <heading>: string[] } }',
+        build: (input) => briefPrompt(input),
+    },
+    "episode-summary": {
+        id: EPISODE_SUMMARY_PROMPT_DESCRIPTOR.id,
+        version: EPISODE_SUMMARY_PROMPT_DESCRIPTOR.version,
+        describe: 'Summarize one coherent work episode. Input: { transcript: string }',
+        build: (input) => episodeSummaryPrompt(input),
+    },
+    "workstream-summary": {
+        id: WORKSTREAM_SUMMARY_PROMPT_DESCRIPTOR.id,
+        version: WORKSTREAM_SUMMARY_PROMPT_DESCRIPTOR.version,
+        describe: 'Maintain a current-state workstream summary. Input: { workstreamKey, existingSummary?, episodeSummaries: string[] }',
+        build: (input) => workstreamSummaryPrompt(input),
+    },
+};
+export function listPrompts() {
+    return Object.entries(PROMPT_REGISTRY).map(([name, entry]) => ({
+        name,
+        id: entry.id,
+        version: entry.version,
+        describe: entry.describe,
+    }));
+}
+export function renderPrompt(name, input) {
+    const entry = PROMPT_REGISTRY[name];
+    if (!entry) {
+        const available = Object.keys(PROMPT_REGISTRY).join(", ");
+        throw new Error(`Unknown prompt: "${name}". Available: ${available}`);
+    }
+    return entry.build(input);
+}
+function readStdinSync() {
+    try {
+        return fs.readFileSync(0, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`Failed to read stdin: ${err.message}`);
+    }
+}
+export function parseRenderArgs(argv) {
+    const args = { name: null, inputPath: null, list: false, help: false };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--list" || a === "-l") {
+            args.list = true;
+        }
+        else if (a === "--help" || a === "-h") {
+            args.help = true;
+        }
+        else if (a === "--input" || a === "-i") {
+            args.inputPath = argv[++i] ?? null;
+            if (!args.inputPath) {
+                throw new Error("--input requires a path argument");
+            }
+        }
+        else if (a.startsWith("--input=")) {
+            args.inputPath = a.slice("--input=".length);
+        }
+        else if (a.startsWith("-")) {
+            throw new Error(`Unknown flag: ${a}`);
+        }
+        else if (args.name === null) {
+            args.name = a;
+        }
+        else {
+            throw new Error(`Unexpected positional argument: ${a}`);
+        }
+    }
+    return args;
+}
+function printHelp() {
+    console.log(`Usage:
+  bikky render <name>                  Render prompt; reads JSON input from stdin
+  bikky render <name> --input <path>   Render prompt; reads JSON input from file
+  bikky render --list                  List available prompts
+  bikky render --help                  Show this help
+
+Available prompts:`);
+    for (const p of listPrompts()) {
+        console.log(`  ${p.name.padEnd(15)} ${p.id}@${p.version}`);
+        console.log(`  ${"".padEnd(15)} ${p.describe}`);
+    }
+}
+export async function runRenderCli(argv) {
+    let parsed;
+    try {
+        parsed = parseRenderArgs(argv);
+    }
+    catch (err) {
+        console.error(err.message);
+        console.error("Run `bikky render --help` for usage.");
+        return 1;
+    }
+    if (parsed.help) {
+        printHelp();
+        return 0;
+    }
+    if (parsed.list) {
+        console.log(JSON.stringify(listPrompts(), null, 2));
+        return 0;
+    }
+    if (!parsed.name) {
+        console.error("Error: prompt name is required");
+        console.error("Run `bikky render --help` for usage.");
+        return 1;
+    }
+    let raw;
+    try {
+        raw = parsed.inputPath ? fs.readFileSync(parsed.inputPath, "utf-8") : readStdinSync();
+    }
+    catch (err) {
+        console.error(`Error reading input: ${err.message}`);
+        return 1;
+    }
+    if (!raw.trim()) {
+        console.error("Error: input JSON is empty (provide via stdin or --input)");
+        return 1;
+    }
+    let input;
+    try {
+        input = JSON.parse(raw);
+    }
+    catch (err) {
+        console.error(`Error parsing input JSON: ${err.message}`);
+        return 1;
+    }
+    let rendered;
+    try {
+        rendered = renderPrompt(parsed.name, input);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        return 1;
+    }
+    console.log(JSON.stringify(rendered, null, 2));
+    return 0;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/render.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tests for the `bikky render` CLI plumbing.
+ *
+ * We test the pure pieces (parseRenderArgs, renderPrompt, listPrompts) directly.
+ * The full runRenderCli is tested via stdout capture.
+ */
+export {};
+//# sourceMappingURL=render.test.d.ts.map

package/dist/render.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.test.d.ts","sourceRoot":"","sources":["../src/render.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/render.test.js

@@ -0,0 +1,243 @@
+/**
+ * Tests for the `bikky render` CLI plumbing.
+ *
+ * We test the pure pieces (parseRenderArgs, renderPrompt, listPrompts) directly.
+ * The full runRenderCli is tested via stdout capture.
+ */
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { PROMPT_REGISTRY, listPrompts, parseRenderArgs, renderPrompt, runRenderCli, } from "./render.js";
+// ── parseRenderArgs ─────────────────────────────────────────────────────────
+test("parseRenderArgs: bare name", () => {
+    const args = parseRenderArgs(["extraction"]);
+    assert.equal(args.name, "extraction");
+    assert.equal(args.inputPath, null);
+    assert.equal(args.list, false);
+});
+test("parseRenderArgs: --input <path>", () => {
+    const args = parseRenderArgs(["extraction", "--input", "case.json"]);
+    assert.equal(args.name, "extraction");
+    assert.equal(args.inputPath, "case.json");
+});
+test("parseRenderArgs: --input=path", () => {
+    const args = parseRenderArgs(["extraction", "--input=case.json"]);
+    assert.equal(args.inputPath, "case.json");
+});
+test("parseRenderArgs: --list", () => {
+    const args = parseRenderArgs(["--list"]);
+    assert.equal(args.list, true);
+    assert.equal(args.name, null);
+});
+test("parseRenderArgs: --help", () => {
+    const args = parseRenderArgs(["--help"]);
+    assert.equal(args.help, true);
+});
+test("parseRenderArgs: rejects unknown flag", () => {
+    assert.throws(() => parseRenderArgs(["--nope"]), /Unknown flag/);
+});
+test("parseRenderArgs: rejects extra positional", () => {
+    assert.throws(() => parseRenderArgs(["a", "b"]), /Unexpected positional/);
+});
+test("parseRenderArgs: --input requires a value", () => {
+    assert.throws(() => parseRenderArgs(["x", "--input"]), /requires a path/);
+});
+// ── listPrompts ─────────────────────────────────────────────────────────────
+test("listPrompts returns all prompts", () => {
+    const list = listPrompts();
+    const names = list.map((p) => p.name).sort();
+    assert.deepEqual(names, [
+        "brief",
+        "contradiction",
+        "distill",
+        "episode-summary",
+        "extraction",
+        "relations",
+        "workstream-summary",
+    ]);
+    for (const p of list) {
+        assert.ok(p.id, `${p.name} has no id`);
+        assert.ok(p.version, `${p.name} has no version`);
+        assert.ok(p.describe, `${p.name} has no description`);
+    }
+});
+test("PROMPT_REGISTRY ids match descriptors", () => {
+    // Stable ids; if a prompt rename happens, both this test and the registry must update.
+    assert.equal(PROMPT_REGISTRY.extraction.id, "extraction");
+    assert.equal(PROMPT_REGISTRY.distill.id, "distill");
+    assert.equal(PROMPT_REGISTRY.contradiction.id, "contradiction");
+    assert.equal(PROMPT_REGISTRY.relations.id, "relations");
+    assert.equal(PROMPT_REGISTRY.brief.id, "brief");
+    assert.equal(PROMPT_REGISTRY["episode-summary"].id, "episode-summary");
+    assert.equal(PROMPT_REGISTRY["workstream-summary"].id, "workstream-summary");
+});
+// ── renderPrompt ────────────────────────────────────────────────────────────
+test("renderPrompt: extraction renders with system+user messages", () => {
+    const out = renderPrompt("extraction", { transcript: "hello world" });
+    assert.match(out.promptName, /^extraction@/);
+    assert.equal(out.messages.length, 2);
+    assert.equal(out.messages[0].role, "system");
+    assert.equal(out.messages[1].role, "user");
+    assert.ok(out.messages[1].content.includes("hello world"), "user message must include input");
+    assert.ok(typeof out.temperature === "number");
+});
+test("renderPrompt: distill renders with summaries", () => {
+    const out = renderPrompt("distill", {
+        summaries: [
+            { id: 1, date: "2026-04-01", content: "first session", tasks_completed: ["a"], decisions_made: [] },
+            { id: 2, date: "2026-04-02", content: "second session", tasks_completed: [], decisions_made: ["b"] },
+            { id: 3, date: "2026-04-03", content: "third session", tasks_completed: [], decisions_made: [] },
+        ],
+    });
+    assert.match(out.promptName, /^distill@/);
+    assert.ok(out.messages[1].content.includes("first session"));
+    assert.ok(out.messages[1].content.includes("third session"));
+});
+test("renderPrompt: contradiction renders", () => {
+    const out = renderPrompt("contradiction", {
+        newFact: { content: "user lives in Berlin", category: "people" },
+        candidates: [{ id: "f1", content: "user lives in Paris", category: "people", score: 0.91 }],
+    });
+    assert.match(out.promptName, /^contradiction@/);
+    assert.ok(out.messages[1].content.includes("Berlin"));
+    assert.ok(out.messages[1].content.includes("Paris"));
+});
+test("renderPrompt: relations renders", () => {
+    const out = renderPrompt("relations", {
+        entityA: "alice",
+        entityB: "platform",
+        sharedFacts: [{ content: "alice deployed platform v2", category: "projects" }],
+    });
+    assert.match(out.promptName, /^relations@/);
+    assert.ok(out.messages[1].content.includes("alice"));
+    assert.ok(out.messages[1].content.includes("platform"));
+});
+test("renderPrompt: brief renders", () => {
+    const out = renderPrompt("brief", {
+        generatedAt: "2026-04-25",
+        sections: { "Open threads": ["thread one", "thread two"] },
+    });
+    assert.match(out.promptName, /^brief@/);
+    assert.ok(out.messages[1].content.includes("thread one"));
+});
+test("renderPrompt: episode-summary renders", () => {
+    const out = renderPrompt("episode-summary", {
+        transcript: "[USER] Implement episode summaries in src/daemon/episode-summary.ts.",
+    });
+    assert.match(out.promptName, /^episode-summary@/);
+    assert.ok(out.messages[1].content.includes("src/daemon/episode-summary.ts"));
+    assert.deepEqual(out.response_format, { type: "json_object" });
+});
+test("renderPrompt: workstream-summary renders", () => {
+    const out = renderPrompt("workstream-summary", {
+        workstreamKey: "231-bikky-evals-deepeval",
+        existingSummary: "Eval harness has ontology-v2 coverage.",
+        episodeSummaries: ["Added episode-summary eval cases.", "Added workstream-summary eval cases."],
+    });
+    assert.match(out.promptName, /^workstream-summary@/);
+    assert.ok(out.messages[1].content.includes("231-bikky-evals-deepeval"));
+    assert.ok(out.messages[1].content.includes("episode-summary eval cases"));
+    assert.deepEqual(out.response_format, { type: "json_object" });
+});
+test("renderPrompt: unknown name throws with helpful message", () => {
+    assert.throws(() => renderPrompt("nope", {}), /Unknown prompt: "nope".*Available:/s);
+});
+// ── runRenderCli (full integration via stdout capture) ──────────────────────
+function captureStdout(fn) {
+    const origLog = console.log;
+    const origErr = console.error;
+    let stdout = "";
+    let stderr = "";
+    console.log = (...args) => { stdout += args.join(" ") + "\n"; };
+    console.error = (...args) => { stderr += args.join(" ") + "\n"; };
+    try {
+        const result = fn();
+        if (result instanceof Promise) {
+            return result.then((code) => {
+                console.log = origLog;
+                console.error = origErr;
+                return { code, stdout, stderr };
+            }).catch((err) => {
+                console.log = origLog;
+                console.error = origErr;
+                throw err;
+            });
+        }
+        console.log = origLog;
+        console.error = origErr;
+        return { code: result, stdout, stderr };
+    }
+    catch (err) {
+        console.log = origLog;
+        console.error = origErr;
+        throw err;
+    }
+}
+test("runRenderCli: --list prints JSON list of prompts", async () => {
+    const result = await captureStdout(() => runRenderCli(["--list"]));
+    assert.equal(result.code, 0);
+    const parsed = JSON.parse(result.stdout);
+    assert.equal(parsed.length, 7);
+    assert.ok(parsed.find((p) => p.name === "extraction"));
+    assert.ok(parsed.find((p) => p.name === "episode-summary"));
+    assert.ok(parsed.find((p) => p.name === "workstream-summary"));
+});
+test("runRenderCli: --help exits 0", async () => {
+    const result = await captureStdout(() => runRenderCli(["--help"]));
+    assert.equal(result.code, 0);
+    assert.ok(result.stdout.includes("Usage:"));
+});
+test("runRenderCli: missing name returns 1", async () => {
+    const result = await captureStdout(() => runRenderCli([]));
+    assert.equal(result.code, 1);
+    assert.ok(result.stderr.includes("prompt name is required"));
+});
+test("runRenderCli: unknown prompt returns 1 with available list", async () => {
+    // Fake stdin via --input pointing at /dev/null trick — instead use a temp file
+    const fs = await import("node:fs");
+    const path = await import("node:path");
+    const os = await import("node:os");
+    const tmp = path.join(os.tmpdir(), `bikky-render-test-${Date.now()}.json`);
+    fs.writeFileSync(tmp, "{}");
+    try {
+        const result = await captureStdout(() => runRenderCli(["nope", "--input", tmp]));
+        assert.equal(result.code, 1);
+        assert.ok(result.stderr.includes("Unknown prompt"));
+        assert.ok(result.stderr.includes("extraction"), "should list available prompts");
+    }
+    finally {
+        fs.unlinkSync(tmp);
+    }
+});
+test("runRenderCli: malformed input JSON returns 1", async () => {
+    const fs = await import("node:fs");
+    const path = await import("node:path");
+    const os = await import("node:os");
+    const tmp = path.join(os.tmpdir(), `bikky-render-test-${Date.now()}.json`);
+    fs.writeFileSync(tmp, "not json {");
+    try {
+        const result = await captureStdout(() => runRenderCli(["extraction", "--input", tmp]));
+        assert.equal(result.code, 1);
+        assert.ok(result.stderr.includes("parsing input JSON"));
+    }
+    finally {
+        fs.unlinkSync(tmp);
+    }
+});
+test("runRenderCli: full render via --input file produces valid JSON", async () => {
+    const fs = await import("node:fs");
+    const path = await import("node:path");
+    const os = await import("node:os");
+    const tmp = path.join(os.tmpdir(), `bikky-render-test-${Date.now()}.json`);
+    fs.writeFileSync(tmp, JSON.stringify({ transcript: "test transcript" }));
+    try {
+        const result = await captureStdout(() => runRenderCli(["extraction", "--input", tmp]));
+        assert.equal(result.code, 0);
+        const parsed = JSON.parse(result.stdout);
+        assert.match(parsed.promptName, /^extraction@/);
+        assert.equal(parsed.messages.length, 2);
+    }
+    finally {
+        fs.unlinkSync(tmp);
+    }
+});
+//# sourceMappingURL=render.test.js.map

package/dist/render.test.js.map

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

package/docs/diagrams/architecture.svg

@@ -0,0 +1,87 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 620 380" width="620" height="380" fill="none">
+  <style>
+    .bg { fill: #fafbfc; }
+    .box { fill: #ffffff; stroke: #d1d5db; stroke-width: 1.5; rx: 10; }
+    .box-agent { fill: #eff6ff; stroke: #93c5fd; }
+    .box-mcp { fill: #f0fdf4; stroke: #86efac; }
+    .box-daemon { fill: #fefce8; stroke: #fde68a; }
+    .box-db { fill: #faf5ff; stroke: #c4b5fd; }
+    .box-logs { fill: #f8fafc; stroke: #cbd5e1; }
+    .title { font: 600 13px -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; fill: #1e293b; }
+    .subtitle { font: 400 11px -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; fill: #64748b; }
+    .label { font: 500 10px -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif; fill: #475569; }
+    .arrow { stroke: #94a3b8; stroke-width: 1.5; fill: none; marker-end: url(#arrowhead); }
+    .arrow-bi { stroke: #94a3b8; stroke-width: 1.5; fill: none; marker-start: url(#arrowhead-start); marker-end: url(#arrowhead); }
+    .icon { font: 400 18px -apple-system, sans-serif; }
+    @media (prefers-color-scheme: dark) {
+      .bg { fill: #0d1117; }
+      .box { fill: #161b22; stroke: #30363d; }
+      .box-agent { fill: #0d1b2a; stroke: #1f6feb; }
+      .box-mcp { fill: #0d1f12; stroke: #238636; }
+      .box-daemon { fill: #1c1a0d; stroke: #9e6a03; }
+      .box-db { fill: #170d22; stroke: #8957e5; }
+      .box-logs { fill: #111318; stroke: #30363d; }
+      .title { fill: #e6edf3; }
+      .subtitle { fill: #8b949e; }
+      .label { fill: #8b949e; }
+      .arrow, .arrow-bi { stroke: #484f58; }
+    }
+  </style>
+  <defs>
+    <marker id="arrowhead" markerWidth="8" markerHeight="6" refX="7" refY="3" orient="auto">
+      <path d="M0,0 L8,3 L0,6" fill="none" stroke="#94a3b8" stroke-width="1.2" stroke-linejoin="round"/>
+    </marker>
+    <marker id="arrowhead-start" markerWidth="8" markerHeight="6" refX="1" refY="3" orient="auto">
+      <path d="M8,0 L0,3 L8,6" fill="none" stroke="#94a3b8" stroke-width="1.2" stroke-linejoin="round"/>
+    </marker>
+  </defs>
+
+  <!-- Background -->
+  <rect class="bg" width="620" height="380" rx="0"/>
+
+  <!-- Agent box (top-left) -->
+  <rect class="box box-agent" x="30" y="30" width="200" height="64"/>
+  <text class="icon" x="50" y="70">🤖</text>
+  <text class="title" x="72" y="56">Copilot / Claude Code</text>
+  <text class="subtitle" x="72" y="72">AI coding agent</text>
+
+  <!-- Session logs box (top-right) -->
+  <rect class="box box-logs" x="390" y="30" width="200" height="64"/>
+  <text class="icon" x="410" y="70">📁</text>
+  <text class="title" x="432" y="56">Session Logs</text>
+  <text class="subtitle" x="432" y="72">~/.copilot/</text>
+
+  <!-- MCP Server box (mid-left) -->
+  <rect class="box box-mcp" x="30" y="160" width="200" height="64"/>
+  <text class="icon" x="50" y="200">⚡</text>
+  <text class="title" x="72" y="186">bikky MCP Server</text>
+  <text class="subtitle" x="72" y="202">12 memory tools</text>
+
+  <!-- Daemon box (mid-right) -->
+  <rect class="box box-daemon" x="390" y="160" width="200" height="64"/>
+  <text class="icon" x="410" y="200">👁</text>
+  <text class="title" x="432" y="186">bikky Daemon</text>
+  <text class="subtitle" x="432" y="202">background watcher</text>
+
+  <!-- Qdrant box (bottom-center) -->
+  <rect class="box box-db" x="195" y="296" width="230" height="64"/>
+  <text class="icon" x="215" y="336">🔮</text>
+  <text class="title" x="240" y="322">Qdrant Cloud</text>
+  <text class="subtitle" x="240" y="338">shared vector store</text>
+
+  <!-- Arrow: Agent ↔ MCP Server -->
+  <line class="arrow-bi" x1="130" y1="94" x2="130" y2="160"/>
+  <text class="label" x="140" y="132">MCP stdio</text>
+
+  <!-- Arrow: Logs → Daemon -->
+  <line class="arrow" x1="490" y1="94" x2="490" y2="160"/>
+  <text class="label" x="500" y="132">events.jsonl</text>
+
+  <!-- Arrow: MCP Server → Qdrant -->
+  <path class="arrow" d="M130,224 L130,310 Q130,328 148,328 L195,328"/>
+  <text class="label" x="80" y="270">store / recall</text>
+
+  <!-- Arrow: Daemon → Qdrant -->
+  <path class="arrow" d="M490,224 L490,310 Q490,328 472,328 L425,328"/>
+  <text class="label" x="496" y="270">embed + store</text>
+</svg>