agentopology 0.2.5 → 0.4.0

package/dist/visualizer/brain.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Brain visualizer — renders a folder of Obsidian-format markdown as an
+ * interactive force-directed graph, the way Obsidian's graph view does, but as
+ * a single self-contained HTML file with zero dependencies. No 500MB Electron
+ * app needed to *see* the brain.
+ *
+ * The graph is a projection of the files (same model as Obsidian):
+ *   - each `.md` file is a NODE
+ *   - each `[[wikilink]]` is a directed EDGE
+ *   - a `[[link]]` to a file that doesn't exist is a GHOST node
+ *   - `#tags` / frontmatter tags are shown as tag nodes (hyperedges)
+ *
+ * Layout uses the same four forces Obsidian exposes: center pull, node repel,
+ * link spring, and link distance.
+ */
+/** A node in the brain graph. */
+export interface BrainNode {
+    /** Slug (filename without .md), used as the link target. */
+    id: string;
+    /** Display title (from first `# heading`, else the slug). */
+    title: string;
+    /**
+     * Existence status — orthogonal to category. "written" = a real .md file,
+     * "ghost" = linked but not yet written, "index" = a hub note.
+     */
+    kind: "written" | "ghost" | "index";
+    /**
+     * What KIND of thing this is, inferred from tag namespaces (person/org/topic)
+     * — NOT the same as existence. A person who has no note yet is category
+     * "person", kind "ghost". This is what makes the graph a knowledge graph
+     * rather than a bag of links: a person is colored like a person whether or
+     * not their note exists.
+     */
+    category: "person" | "org" | "topic" | "note";
+    /** Frontmatter + inline tags on this note. */
+    tags: string[];
+    /** Number of inbound links (for sizing). */
+    inbound: number;
+    /** Raw markdown body (written notes only) — inlined so click-to-open works offline. */
+    content?: string;
+    /**
+     * Provenance — the `source:` frontmatter value (e.g. "gmail", "slack"),
+     * stamped by the ingester that wrote the note. Drives source-coloring in the
+     * graph when the topology declares a `sources { ... }` style map.
+     */
+    source?: string;
+}
+/** A directed edge from one note to another (a `[[wikilink]]`). */
+export interface BrainEdge {
+    from: string;
+    to: string;
+}
+/** The parsed brain graph. */
+export interface BrainGraph {
+    nodes: BrainNode[];
+    edges: BrainEdge[];
+    /** Distinct tags across the vault, with how many notes carry each. */
+    tags: {
+        tag: string;
+        count: number;
+    }[];
+    vaultPath: string;
+}
+/**
+ * Parse a folder of Obsidian-format markdown into a brain graph.
+ *
+ * @param vaultPath - Directory containing the `.md` notes.
+ */
+export declare function parseBrainVault(vaultPath: string): BrainGraph;
+/** Options for rendering the brain HTML. */
+export interface RenderBrainOptions {
+    /**
+     * Relative href to the topology visualization for this brain, if known.
+     * When set, the brain view shows a "← Topology" link back to it.
+     */
+    topologyHref?: string;
+    /** Display name of the owning topology (shown on the back-link). */
+    topologyName?: string;
+    /**
+     * Provenance styling map: source key (e.g. "gmail") → { color, icon }, where
+     * `icon` is ALREADY a data: URI (the CLI inlines the file before calling this,
+     * so the renderer stays pure and the output stays self-contained). When a
+     * node's `source` matches a key, it is colored/iconed accordingly; otherwise
+     * it falls back to category coloring. Presentation only.
+     */
+    sources?: Record<string, {
+        color?: string;
+        icon?: string;
+    }>;
+}
+/**
+ * Render a brain graph as a self-contained, dependency-free HTML page with an
+ * Obsidian-style force-directed graph view, styled to match the AgentTopology
+ * visualizer.
+ */
+export declare function renderBrainHtml(graph: BrainGraph, opts?: RenderBrainOptions): string;
+//# sourceMappingURL=brain.d.ts.map

package/dist/visualizer/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../../src/visualizer/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,iCAAiC;AACjC,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,8CAA8C;IAC9C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,sEAAsE;IACtE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AA4ED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAuF7D;AAED,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,kBAAuB,GAAG,MAAM,CAwBxF"}

package/dist/visualizer/brain.js

@@ -0,0 +1,473 @@
+/**
+ * Brain visualizer — renders a folder of Obsidian-format markdown as an
+ * interactive force-directed graph, the way Obsidian's graph view does, but as
+ * a single self-contained HTML file with zero dependencies. No 500MB Electron
+ * app needed to *see* the brain.
+ *
+ * The graph is a projection of the files (same model as Obsidian):
+ *   - each `.md` file is a NODE
+ *   - each `[[wikilink]]` is a directed EDGE
+ *   - a `[[link]]` to a file that doesn't exist is a GHOST node
+ *   - `#tags` / frontmatter tags are shown as tag nodes (hyperedges)
+ *
+ * Layout uses the same four forces Obsidian exposes: center pull, node repel,
+ * link spring, and link distance.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+/** Map a tag namespace prefix to a node category. */
+function categoryFromTags(tags) {
+    for (const t of tags) {
+        const ns = t.split("/")[0];
+        if (ns === "person" || ns === "people")
+            return "person";
+        if (ns === "org" || ns === "client" || ns === "company")
+            return "org";
+        if (ns === "topic" || ns === "tag")
+            return "topic";
+    }
+    return "note";
+}
+const WIKILINK_RE = /\[\[([^\]]+)\]\]/g;
+const INLINE_TAG_RE = /(?:^|\s)#([a-z0-9][a-z0-9_-]*(?:\/[a-z0-9][a-z0-9_-]*)*)/gi;
+/** Normalize a wikilink target: strip alias (`|...`), heading (`#...`), block (`^...`). */
+function linkTarget(raw) {
+    let t = raw.split("|")[0];
+    t = t.split("#")[0];
+    t = t.split("^")[0];
+    return t.trim().replace(/\.md$/i, "");
+}
+/** Extract `tags:` from simple YAML frontmatter (list or inline array form). */
+function frontmatterTags(content) {
+    const fm = /^---\n([\s\S]*?)\n---/.exec(content);
+    if (!fm)
+        return [];
+    const body = fm[1];
+    const tags = [];
+    // Inline array: `tags: [a, b, c]`
+    const inline = /^tags:\s*\[([^\]]*)\]/m.exec(body);
+    if (inline) {
+        for (const t of inline[1].split(",")) {
+            const v = t.trim().replace(/^["']|["']$/g, "");
+            if (v)
+                tags.push(v);
+        }
+        return tags;
+    }
+    // List form:
+    //   tags:
+    //     - a
+    //     - b
+    const listHeader = /^tags:\s*$/m.exec(body);
+    if (listHeader) {
+        const after = body.slice(listHeader.index + listHeader[0].length);
+        for (const line of after.split("\n")) {
+            if (line.trim() === "")
+                continue; // skip the blank line right after `tags:`
+            const m = /^\s*-\s*(.+)$/.exec(line);
+            if (!m)
+                break; // list ends at first non-item, non-blank line
+            const v = m[1].trim().replace(/^["']|["']$/g, "");
+            if (v)
+                tags.push(v);
+        }
+    }
+    return tags;
+}
+/** First `# Heading` in the body, else null. */
+/** Read a single scalar field (e.g. `source:`) from YAML frontmatter. */
+function frontmatterField(content, key) {
+    const fm = /^---\n([\s\S]*?)\n---/.exec(content);
+    if (!fm)
+        return undefined;
+    const m = new RegExp(`^${key}:\\s*(.+)$`, "m").exec(fm[1]);
+    if (!m)
+        return undefined;
+    const v = m[1].trim().replace(/^["']|["']$/g, "");
+    return v || undefined;
+}
+function firstHeading(content) {
+    const m = /^#\s+(.+)$/m.exec(content.replace(/^---\n[\s\S]*?\n---\n?/, ""));
+    return m ? m[1].trim() : null;
+}
+/** Recursively collect `.md` files under a directory. */
+function walkMarkdown(dir) {
+    const out = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.name.startsWith("."))
+            continue;
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            out.push(...walkMarkdown(full));
+        else if (entry.isFile() && entry.name.toLowerCase().endsWith(".md"))
+            out.push(full);
+    }
+    return out;
+}
+/**
+ * Parse a folder of Obsidian-format markdown into a brain graph.
+ *
+ * @param vaultPath - Directory containing the `.md` notes.
+ */
+export function parseBrainVault(vaultPath) {
+    const files = walkMarkdown(vaultPath);
+    const realIds = new Set(files.map((f) => path.basename(f, path.extname(f))));
+    const nodes = new Map();
+    const edges = [];
+    const tagCounts = new Map();
+    // slug -> inferred category, learned from `person/x` / `org/x` / `topic/x` tags.
+    const ghostCategory = new Map();
+    for (const file of files) {
+        const id = path.basename(file, ".md");
+        const content = fs.readFileSync(file, "utf-8");
+        const fmTags = frontmatterTags(content);
+        const inlineTags = [];
+        let m;
+        INLINE_TAG_RE.lastIndex = 0;
+        while ((m = INLINE_TAG_RE.exec(content)) !== null)
+            inlineTags.push(m[1]);
+        const tags = Array.from(new Set([...fmTags, ...inlineTags]));
+        for (const t of tags)
+            tagCounts.set(t, (tagCounts.get(t) ?? 0) + 1);
+        // Index notes are hubs: filename starting with `_` or tagged brain/index.
+        const isIndex = id.startsWith("_") || tags.some((t) => t === "brain/index");
+        nodes.set(id, {
+            id,
+            title: firstHeading(content) ?? id,
+            kind: isIndex ? "index" : "written",
+            category: categoryFromTags(tags),
+            tags,
+            inbound: 0,
+            content,
+            source: frontmatterField(content, "source"),
+        });
+        // A tag like `person/amitai-eliram` tells us the SLUG `amitai-eliram` is a
+        // person — even if its note doesn't exist yet. Record that so ghosts get the
+        // right category (a person stays a person whether or not their note exists).
+        for (const t of tags) {
+            const [ns, slug] = t.split("/");
+            if (!slug)
+                continue;
+            const cat = ns === "person" || ns === "people" ? "person" :
+                ns === "org" || ns === "client" || ns === "company" ? "org" :
+                    ns === "topic" ? "topic" : null;
+            if (cat && !ghostCategory.has(slug))
+                ghostCategory.set(slug, cat);
+        }
+        // Extract wikilink edges — dedupe within a note (Obsidian's graph draws one
+        // edge per (source, target) pair, however many times the link is repeated).
+        const seenTargets = new Set();
+        WIKILINK_RE.lastIndex = 0;
+        while ((m = WIKILINK_RE.exec(content)) !== null) {
+            const target = linkTarget(m[1]);
+            if (!target || target === id || seenTargets.has(target))
+                continue;
+            seenTargets.add(target);
+            edges.push({ from: id, to: target });
+            // Ghost node: linked but no file exists.
+            if (!realIds.has(target) && !nodes.has(target)) {
+                nodes.set(target, {
+                    id: target, title: target, kind: "ghost",
+                    category: "note", tags: [], inbound: 0,
+                });
+            }
+        }
+    }
+    // Apply inferred categories to ghost nodes (and any node still "note" that we
+    // learned about from another note's namespaced tags).
+    for (const n of nodes.values()) {
+        if (n.category === "note" && ghostCategory.has(n.id)) {
+            n.category = ghostCategory.get(n.id);
+        }
+    }
+    // Compute inbound counts for sizing.
+    for (const e of edges) {
+        const n = nodes.get(e.to);
+        if (n)
+            n.inbound++;
+    }
+    const tags = Array.from(tagCounts.entries())
+        .map(([tag, count]) => ({ tag, count }))
+        .sort((a, b) => b.count - a.count);
+    return { nodes: Array.from(nodes.values()), edges, tags, vaultPath };
+}
+/**
+ * Render a brain graph as a self-contained, dependency-free HTML page with an
+ * Obsidian-style force-directed graph view, styled to match the AgentTopology
+ * visualizer.
+ */
+export function renderBrainHtml(graph, opts = {}) {
+    const vaultName = path.basename(graph.vaultPath.replace(/\/+$/, "")) || "brain";
+    const realCount = graph.nodes.filter((n) => n.kind !== "ghost").length;
+    const ghostCount = graph.nodes.filter((n) => n.kind === "ghost").length;
+    const data = JSON.stringify({
+        nodes: graph.nodes,
+        edges: graph.edges,
+        tags: graph.tags.slice(0, 24),
+        sources: opts.sources ?? {},
+    });
+    const backLink = opts.topologyHref
+        ? `<a class="back-link" href="${escapeHtml(opts.topologyHref)}">← ${escapeHtml(opts.topologyName ?? "Topology")}</a>`
+        : "";
+    return BRAIN_HTML
+        .replace(/__VAULT__/g, escapeHtml(vaultName))
+        .replace("__NOTES__", String(realCount))
+        .replace("__LINKS__", String(graph.edges.length))
+        .replace("__GHOSTS__", String(ghostCount))
+        .replace("__TAGS__", String(graph.tags.length))
+        .replace("__BACKLINK__", backLink)
+        .replace("__DATA__", data);
+}
+function escapeHtml(s) {
+    return s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c]));
+}
+/**
+ * The HTML shell. Self-contained: inline CSS + a tiny force-directed canvas
+ * renderer using the same four forces Obsidian exposes (center, repel, link
+ * spring, link distance). Styled to match the AgentTopology visualizer.
+ * Nodes are colored by CATEGORY (person/org/topic/note); ghosts are drawn
+ * hollow (same color, dashed, unfilled) — "not written yet" is a status, not
+ * a category. Click a node to open its note in the side panel.
+ */
+const BRAIN_HTML = String.raw `<!doctype html>
+<html lang="en"><head>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>__VAULT__ — Brain Graph</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Noto+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+<style>
+  :root{
+    --bg:#0A0A0A;--s:#111111;--s2:#161616;--b:#1e1e1e;--b2:#2a2a2a;
+    --t:#e4e4ef;--t2:#878593;--t3:#56545e;
+    --person:#60a5fa;--org:#4ade80;--topic:#fbbf24;--note:#a78bfa;--index:#22d3ee;
+    --accent:#a78bfa;
+    --font-mono:'JetBrains Mono',monospace;--font-body:'Noto Sans',sans-serif;
+  }
+  *{box-sizing:border-box}
+  html,body{margin:0;height:100%;background:var(--bg);color:var(--t);
+    font-family:var(--font-body);font-size:13px;line-height:1.5;overflow:hidden}
+  #app{display:flex;height:100vh}
+  #stage{flex:1;position:relative;overflow:hidden}
+  #header{position:fixed;top:0;left:0;right:0;height:46px;z-index:15;display:flex;align-items:center;gap:14px;
+    padding:0 18px;background:var(--s);border-bottom:1px solid var(--b)}
+  #header .brand{display:flex;align-items:center;gap:8px;font-weight:600;font-size:14px}
+  #header .vault{font-family:var(--font-mono);font-size:12px;color:var(--t2);background:var(--s2);
+    padding:3px 10px;border-radius:6px;border:1px solid var(--b)}
+  #header .spacer{flex:1}
+  #header .stats{display:flex;gap:14px;font-family:var(--font-mono);font-size:11px;color:var(--t3)}
+  #header .stats b{color:var(--t2);font-weight:500}
+  .back-link{font-family:var(--font-mono);font-size:11px;color:var(--accent);text-decoration:none;
+    border:1px solid var(--b2);border-radius:6px;padding:4px 10px;transition:.15s}
+  .back-link:hover{background:rgba(167,139,250,.1);border-color:var(--accent)}
+  #search input{background:var(--s2);border:1px solid var(--b);color:var(--t);border-radius:7px;
+    padding:6px 11px;width:180px;font-size:12px;font-family:var(--font-body);outline:none}
+  #search input:focus{border-color:var(--accent)}
+  #legend{position:fixed;left:14px;bottom:14px;z-index:12;background:var(--s);border:1px solid var(--b);
+    border-radius:10px;padding:10px 14px}
+  #legend .row{display:flex;align-items:center;gap:7px;font-size:11px;color:var(--t2);padding:2px 0}
+  #legend .dot{width:9px;height:9px;border-radius:50%;flex:none}
+  #legend .hr{height:1px;background:var(--b);margin:7px 0}
+  #legend .hollow{font-size:10px;color:var(--t3)}
+  #controls{position:fixed;right:14px;bottom:14px;z-index:12;background:var(--s);border:1px solid var(--b);
+    border-radius:10px;padding:10px 14px;display:flex;gap:16px;font-size:10px;font-family:var(--font-mono)}
+  #controls label{display:flex;flex-direction:column;gap:4px;color:var(--t3);text-transform:uppercase;letter-spacing:.5px}
+  #controls input[type=range]{width:78px;accent-color:var(--accent)}
+  #tip{position:fixed;z-index:20;background:var(--s);border:1px solid var(--b2);border-radius:8px;
+    padding:7px 11px;font-size:11px;pointer-events:none;opacity:0;transition:opacity .12s;max-width:260px}
+  #tip.show{opacity:1}
+  #tip .t{color:var(--t);font-weight:600}
+  #tip .cat{font-family:var(--font-mono);font-size:9px;text-transform:uppercase;letter-spacing:1px}
+  #tip .tags{color:var(--topic);font-size:10px;margin-top:3px;font-family:var(--font-mono)}
+  canvas{display:block;cursor:grab}
+  #panel{width:0;background:var(--s);border-left:1px solid var(--b);overflow:hidden;transition:width .2s;flex:none}
+  #panel.open{width:400px}
+  #panel-in{width:400px;height:100vh;padding:54px 22px 22px;overflow-y:auto;position:relative}
+  .p-head{display:flex;align-items:center;gap:10px;margin-bottom:6px}
+  .p-dot{width:13px;height:13px;border-radius:50%;flex:none}
+  .p-title{font-size:17px;font-weight:600}
+  .p-cat{font-family:var(--font-mono);font-size:9px;text-transform:uppercase;letter-spacing:1px;padding:2px 7px;border-radius:4px}
+  .p-ghost{font-family:var(--font-mono);font-size:11px;color:var(--topic);margin:8px 0 12px}
+  .p-tags{display:flex;flex-wrap:wrap;gap:5px;margin:10px 0 16px}
+  .p-tag{font-family:var(--font-mono);font-size:10px;color:var(--t2);background:var(--s2);border:1px solid var(--b);border-radius:4px;padding:2px 7px}
+  .p-md{font-size:13px;line-height:1.7;color:var(--t)}
+  .p-md h1,.p-md h2,.p-md h3{font-size:15px;margin:16px 0 6px}
+  .p-md a{color:var(--accent);text-decoration:none;cursor:pointer}
+  .p-md a:hover{text-decoration:underline}
+  .p-md code{font-family:var(--font-mono);font-size:11px;background:var(--s2);padding:1px 5px;border-radius:3px}
+  .p-md blockquote{border-left:2px solid var(--b2);margin:8px 0;padding:2px 0 2px 12px;color:var(--t2)}
+  .p-md hr{border:none;border-top:1px solid var(--b);margin:14px 0}
+  .p-close{position:absolute;top:54px;right:18px;cursor:pointer;color:var(--t3);font-size:18px}
+  .p-close:hover{color:var(--t)}
+  .p-links{margin-top:18px;border-top:1px solid var(--b);padding-top:12px}
+  .p-links h4{font-family:var(--font-mono);font-size:10px;text-transform:uppercase;letter-spacing:1px;color:var(--t3);margin:0 0 8px}
+  .p-links a{display:block;color:var(--accent);text-decoration:none;font-size:12px;padding:2px 0;cursor:pointer}
+  .p-links a:hover{text-decoration:underline}
+</style></head>
+<body>
+<div id="header">
+  <div class="brand">🧠 <span>Brain</span></div>
+  <div class="vault">__VAULT__</div>
+  __BACKLINK__
+  <div class="spacer"></div>
+  <div class="stats">
+    <span><b>__NOTES__</b> notes</span><span><b>__LINKS__</b> links</span>
+    <span><b>__GHOSTS__</b> ghosts</span><span><b>__TAGS__</b> tags</span>
+  </div>
+  <div id="search"><input id="q" placeholder="Search…" autocomplete="off"></div>
+</div>
+<div id="app">
+  <div id="stage">
+    <canvas id="c"></canvas>
+    <div id="legend">
+      <div class="row"><span class="dot" style="background:var(--person)"></span>person</div>
+      <div class="row"><span class="dot" style="background:var(--org)"></span>org</div>
+      <div class="row"><span class="dot" style="background:var(--topic)"></span>topic</div>
+      <div class="row"><span class="dot" style="background:var(--note)"></span>note</div>
+      <div class="row"><span class="dot" style="background:var(--index)"></span>index / hub</div>
+      <div class="hr"></div>
+      <div class="row hollow"><span class="dot" style="background:transparent;border:1.5px dashed var(--t3)"></span>hollow = not written yet</div>
+    </div>
+    <div id="controls">
+      <label>Repel<input type="range" id="repel" min="200" max="6000" value="2200"></label>
+      <label>Dist<input type="range" id="dist" min="40" max="300" value="120"></label>
+      <label>Center<input type="range" id="center" min="0" max="30" value="8"></label>
+    </div>
+    <div id="tip"></div>
+  </div>
+  <div id="panel"><div id="panel-in"></div></div>
+</div>
+<script>
+const DATA = __DATA__;
+const c = document.getElementById('c'), x = c.getContext('2d');
+let W, H, DPR = Math.min(devicePixelRatio||1, 2);
+function size(){ const st=document.getElementById('stage').getBoundingClientRect();
+  W=st.width; H=st.height; c.width=W*DPR; c.height=H*DPR; c.style.width=W+'px'; c.style.height=H+'px'; x.setTransform(DPR,0,0,DPR,0,0); }
+size(); addEventListener('resize', size);
+
+const CAT = { person:'#60a5fa', org:'#4ade80', topic:'#fbbf24', note:'#a78bfa' };
+const SRC = DATA.sources || {};
+// Color priority: declared source color (provenance) > category > default.
+// Index/hub nodes always use the index color.
+function nodeColor(n){
+  if (n.kind==='index') return '#22d3ee';
+  if (n.source && SRC[n.source] && SRC[n.source].color) return SRC[n.source].color;
+  return CAT[n.category]||CAT.note;
+}
+function nodeIcon(n){ return n.source && SRC[n.source] && SRC[n.source].icon ? SRC[n.source].icon : null; }
+// Lazy image cache for source icons (data: URIs). Decoded once, reused.
+const ICONS = {};
+function getIcon(src){ if(!ICONS[src]){ const im=new Image(); im.src=src; ICONS[src]=im; } return ICONS[src]; }
+
+const N = new Map();
+for (const n of DATA.nodes){
+  N.set(n.id, Object.assign({}, n, { x: W/2+(Math.random()-.5)*Math.min(W,600), y: H/2+(Math.random()-.5)*Math.min(H,600), vx:0, vy:0 }));
+}
+const E = DATA.edges.filter(e => N.has(e.from) && N.has(e.to));
+
+let cam = { x:0, y:0, z:1 };
+let forces = { repel:2200, dist:120, center:0.008 };
+document.getElementById('repel').oninput  = e => forces.repel  = +e.target.value;
+document.getElementById('dist').oninput   = e => forces.dist   = +e.target.value;
+document.getElementById('center').oninput = e => forces.center = +e.target.value / 1000;
+
+let drag=null, hover=null, panning=false, last={x:0,y:0}, query='', selected=null;
+function radius(n){ return (n.kind==='index'?7:5) + Math.min(n.inbound*1.4, 10); }
+
+function step(){
+  const nodes = [...N.values()];
+  for (let i=0;i<nodes.length;i++){ const a=nodes[i];
+    for (let j=i+1;j<nodes.length;j++){ const b=nodes[j];
+      let dx=a.x-b.x, dy=a.y-b.y, d2=dx*dx+dy*dy||1, d=Math.sqrt(d2);
+      const f=forces.repel/d2, fx=dx/d*f, fy=dy/d*f; a.vx+=fx; a.vy+=fy; b.vx-=fx; b.vy-=fy; } }
+  for (const e of E){ const a=N.get(e.from), b=N.get(e.to);
+    let dx=b.x-a.x, dy=b.y-a.y, d=Math.hypot(dx,dy)||1;
+    const f=(d-forces.dist)*0.015, fx=dx/d*f, fy=dy/d*f; a.vx+=fx; a.vy+=fy; b.vx-=fx; b.vy-=fy; }
+  for (const n of nodes){ if(n===drag)continue;
+    n.vx+=(W/2-n.x)*forces.center; n.vy+=(H/2-n.y)*forces.center; n.x+=(n.vx*=0.82); n.y+=(n.vy*=0.82); }
+}
+function toScreen(n){ return { x:(n.x-W/2)*cam.z+W/2+cam.x, y:(n.y-H/2)*cam.z+H/2+cam.y }; }
+function fromScreen(px,py){ return { x:(px-W/2-cam.x)/cam.z+W/2, y:(py-H/2-cam.y)/cam.z+H/2 }; }
+
+function draw(){
+  x.clearRect(0,0,W,H); x.lineWidth=1;
+  for (const e of E){ const na=N.get(e.from), nb=N.get(e.to), a=toScreen(na), b=toScreen(nb);
+    const hot=selected&&(e.from===selected.id||e.to===selected.id);
+    const g=na.kind==='ghost'||nb.kind==='ghost';
+    x.strokeStyle = hot?'rgba(167,139,250,.55)':(g?'rgba(135,133,147,.16)':'rgba(135,133,147,.30)');
+    x.beginPath(); x.moveTo(a.x,a.y); x.lineTo(b.x,b.y); x.stroke(); }
+  for (const n of N.values()){
+    const p=toScreen(n), r=radius(n)*cam.z, col=nodeColor(n);
+    const match=query&&(n.title.toLowerCase().includes(query)||n.id.toLowerCase().includes(query));
+    const active=n===hover||n===selected||match;
+    if (n.kind==='ghost'){
+      x.beginPath(); x.arc(p.x,p.y,r,0,7); x.fillStyle='rgba(10,10,10,.6)'; x.fill();
+      x.lineWidth=1.5; x.setLineDash([3,3]); x.strokeStyle=col; x.globalAlpha=.85; x.stroke(); x.setLineDash([]); x.globalAlpha=1;
+    } else { x.beginPath(); x.arc(p.x,p.y,r,0,7); x.fillStyle=col; x.fill(); }
+    if (active){ x.lineWidth=2; x.strokeStyle='#fff'; x.beginPath(); x.arc(p.x,p.y,r+1.5,0,7); x.stroke(); }
+    // Source logo (data: URI) drawn inside the node when zoomed in and loaded.
+    const iconSrc=nodeIcon(n);
+    if (iconSrc && cam.z>0.5 && n.kind!=='ghost'){
+      const img=getIcon(iconSrc);
+      if (img && img.complete && img.naturalWidth){ const s=r*1.3; x.save(); x.beginPath(); x.arc(p.x,p.y,r,0,7); x.clip(); x.drawImage(img,p.x-s/2,p.y-s/2,s,s); x.restore(); }
+    }
+    if (cam.z>0.6 || active){
+      x.fillStyle = active?'#fff':'#878593';
+      x.font = (n.kind==='index'?'600 ':'')+(11*Math.min(cam.z,1.3))+'px "Noto Sans",sans-serif';
+      x.textAlign='center'; x.fillText(n.title, p.x, p.y+r+12); }
+  }
+}
+(function loop(){ step(); draw(); requestAnimationFrame(loop); })();
+
+const panel=document.getElementById('panel'), panelIn=document.getElementById('panel-in');
+function mdToHtml(md){
+  md = md.replace(/^---\n[\s\S]*?\n---\n?/, '');
+  return md.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;')
+    .replace(/^### (.*)$/gm,'<h3>$1</h3>').replace(/^## (.*)$/gm,'<h2>$1</h2>').replace(/^# (.*)$/gm,'<h1>$1</h1>')
+    .replace(/^&gt; (.*)$/gm,'<blockquote>$1</blockquote>').replace(/^---$/gm,'<hr>')
+    .replace(/\*\*([^*]+)\*\*/g,'<b>$1</b>').replace(/` + "`([^`]+)`" + String.raw `/g,'<code>$1</code>')
+    .replace(/\[\[([^\]|]+)(?:\|([^\]]+))?\]\]/g,(m,t,a)=>'<a data-link="'+t.trim()+'">'+(a||t).trim()+'</a>')
+    .replace(/\n\n/g,'<br><br>').replace(/\n/g,'<br>');
+}
+function openNode(n){
+  selected=n; const col=nodeColor(n);
+  const catLabel = n.kind==='index'?'INDEX':(n.category||'note').toUpperCase();
+  let h='<div class="p-close" onclick="closePanel()">×</div>';
+  h+='<div class="p-head"><span class="p-dot" style="'+(n.kind==='ghost'?'background:transparent;border:1.5px dashed '+col:'background:'+col)+'"></span><span class="p-title">'+n.title+'</span></div>';
+  h+='<span class="p-cat" style="color:'+col+';background:'+col+'22">'+catLabel+'</span>';
+  if(n.kind==='ghost') h+='<div class="p-ghost">⊘ Not written yet — a [[link]] points here, but no note exists. A gap to fill.</div>';
+  if(n.tags&&n.tags.length) h+='<div class="p-tags">'+n.tags.map(t=>'<span class="p-tag">#'+t+'</span>').join('')+'</div>';
+  if(n.content) h+='<div class="p-md">'+mdToHtml(n.content)+'</div>';
+  const out=E.filter(e=>e.from===n.id).map(e=>e.to), inc=E.filter(e=>e.to===n.id).map(e=>e.from);
+  if(out.length||inc.length){ h+='<div class="p-links">';
+    if(out.length) h+='<h4>Links to</h4>'+out.map(id=>'<a data-link="'+id+'">'+(N.get(id)?N.get(id).title:id)+'</a>').join('');
+    if(inc.length) h+='<h4 style="margin-top:12px">Linked from</h4>'+inc.map(id=>'<a data-link="'+id+'">'+(N.get(id)?N.get(id).title:id)+'</a>').join('');
+    h+='</div>'; }
+  panelIn.innerHTML=h; panel.classList.add('open'); setTimeout(size,210);
+  panelIn.querySelectorAll('a[data-link]').forEach(a=>{ a.onclick=()=>{ const t=N.get(a.getAttribute('data-link')); if(t)openNode(t); }; });
+}
+function closePanel(){ selected=null; panel.classList.remove('open'); setTimeout(size,210); }
+window.closePanel=closePanel;
+
+const tip=document.getElementById('tip');
+let downAt=null, moved=false;
+function pick(px,py){ const w=fromScreen(px,py); let best=null,bd=1e9;
+  for (const n of N.values()){ const d=Math.hypot(n.x-w.x,n.y-w.y); if(d<bd&&d<radius(n)/cam.z+8){bd=d;best=n;} } return best; }
+c.addEventListener('mousedown', e=>{ const n=pick(e.clientX,e.clientY); moved=false; downAt={x:e.clientX,y:e.clientY};
+  if(n){drag=n;}else{panning=true; last={x:e.clientX,y:e.clientY};} });
+addEventListener('mousemove', e=>{
+  if(downAt && Math.hypot(e.clientX-downAt.x,e.clientY-downAt.y)>4) moved=true;
+  if(drag){ const w=fromScreen(e.clientX,e.clientY); drag.x=w.x; drag.y=w.y; drag.vx=drag.vy=0; }
+  else if(panning){ cam.x+=e.clientX-last.x; cam.y+=e.clientY-last.y; last={x:e.clientX,y:e.clientY}; }
+  else { hover=pick(e.clientX,e.clientY);
+    if(hover){ const col=nodeColor(hover); tip.classList.add('show'); tip.style.left=(e.clientX+14)+'px'; tip.style.top=(e.clientY+14)+'px';
+      tip.innerHTML='<div class="t">'+hover.title+'</div><div class="cat" style="color:'+col+'">'+(hover.kind==='index'?'index':(hover.category||'note'))+(hover.kind==='ghost'?' · not written':'')+'</div>'+(hover.tags&&hover.tags.length?'<div class="tags">#'+hover.tags.slice(0,6).join(' #')+'</div>':'');
+      c.style.cursor='pointer';
+    } else { tip.classList.remove('show'); c.style.cursor='grab'; } }
+});
+addEventListener('mouseup', e=>{ if(drag&&!moved) openNode(drag); drag=null; panning=false; downAt=null; });
+c.addEventListener('wheel', e=>{ e.preventDefault(); const f=e.deltaY<0?1.1:0.9; cam.z=Math.max(0.2,Math.min(4,cam.z*f)); }, {passive:false});
+document.getElementById('q').addEventListener('input', e=>{ query=e.target.value.toLowerCase().trim(); });
+</script>
+</body></html>`;
+//# sourceMappingURL=brain.js.map

package/dist/visualizer/brain.js.map

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

package/dist/visualizer/index.d.ts

@@ -13,5 +13,23 @@ import type { TopologyAST } from "../parser/ast.js";
  *
  * Save the returned string to a `.html` file and open it in any browser.
  */
-export declare function generateVisualization(ast: TopologyAST): string;
+/** A brain store this topology owns, with where its graph was rendered. */
+export interface BrainLinkRef {
+    /** The store id (e.g. "brain", "client-brain"). */
+    id: string;
+    /** Relative href to the brain graph HTML. */
+    href: string;
+}
+/**
+ * Options for the topology visualization.
+ */
+export interface VisualizationOptions {
+    /**
+     * Brain stores this topology declares (`type: brain`) that were visualized
+     * alongside it. One → an "Open Brain →" button; several → a dropdown listing
+     * each brain by name. A topology can own multiple brains.
+     */
+    brains?: BrainLinkRef[];
+}
+export declare function generateVisualization(ast: TopologyAST, opts?: VisualizationOptions): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/visualizer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/visualizer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,WAAW,EASZ,MAAM,kBAAkB,CAAC;AA8C1B;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAK9D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/visualizer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EACV,WAAW,EASZ,MAAM,kBAAkB,CAAC;AA8C1B;;;;GAIG;AACH,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,WAAW,EAAE,IAAI,GAAE,oBAAyB,GAAG,MAAM,CAK/F"}