agentopology 0.2.5 → 0.3.0

package/dist/visualizer/__tests__/brain.test.js

@@ -0,0 +1,138 @@
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { parseBrainVault, renderBrainHtml } from "../brain.js";
+/**
+ * Builds a throwaway vault on disk, runs the parser against it, and tears it
+ * down. Exercises the real file-walking + link/tag extraction logic.
+ */
+describe("Brain visualizer — vault parser", () => {
+    let vault;
+    beforeAll(() => {
+        vault = fs.mkdtempSync(path.join(os.tmpdir(), "brain-test-"));
+        fs.writeFileSync(path.join(vault, "_brain.md"), `---\ntags:\n  - brain/index\n---\n\n# Brain\n\n- [[acme-corp]]\n- [[deal]]\n`);
+        fs.writeFileSync(path.join(vault, "acme-corp.md"), `---\ntags:\n  - client/enterprise\n  - status/active\n---\n\n# Acme Corp\n\nClosed the [[deal|Q3 deal]] with [[dana]]. On [[enterprise-pricing]].\n`);
+        fs.writeFileSync(path.join(vault, "deal.md"), `---\ntags: [deal/closed, client/enterprise]\n---\n\n# Q3 Deal\n\nWith [[acme-corp]]. Tagged #revenue inline.\n`);
+        // enterprise-pricing.md and dana.md intentionally NOT created → ghost nodes.
+    });
+    afterAll(() => {
+        fs.rmSync(vault, { recursive: true, force: true });
+    });
+    it("treats each .md file as a node and links as edges", () => {
+        const g = parseBrainVault(vault);
+        const realIds = g.nodes.filter((n) => n.kind !== "ghost").map((n) => n.id).sort();
+        expect(realIds).toEqual(["_brain", "acme-corp", "deal"]);
+        // acme-corp -> deal, acme-corp -> dana, acme-corp -> enterprise-pricing, etc.
+        expect(g.edges.some((e) => e.from === "acme-corp" && e.to === "deal")).toBe(true);
+        expect(g.edges.some((e) => e.from === "deal" && e.to === "acme-corp")).toBe(true);
+    });
+    it("detects ghost nodes (linked but no file)", () => {
+        const g = parseBrainVault(vault);
+        const ghosts = g.nodes.filter((n) => n.kind === "ghost").map((n) => n.id).sort();
+        expect(ghosts).toEqual(["dana", "enterprise-pricing"]);
+    });
+    it("marks index/hub notes (underscore prefix or brain/index tag)", () => {
+        const g = parseBrainVault(vault);
+        expect(g.nodes.find((n) => n.id === "_brain")?.kind).toBe("index");
+    });
+    it("parses list-form AND inline-array frontmatter tags, plus inline #tags", () => {
+        const g = parseBrainVault(vault);
+        const acme = g.nodes.find((n) => n.id === "acme-corp");
+        expect(acme?.tags).toContain("client/enterprise"); // list form
+        expect(acme?.tags).toContain("status/active");
+        const deal = g.nodes.find((n) => n.id === "deal");
+        expect(deal?.tags).toContain("deal/closed"); // inline-array form
+        expect(deal?.tags).toContain("revenue"); // inline #tag in body
+    });
+    it("dedupes repeated links within a note (one edge per pair)", () => {
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "brain-dup-"));
+        fs.writeFileSync(path.join(dir, "a.md"), `# A\n[[b]] and again [[b]] and [[b|once more]].\n`);
+        fs.writeFileSync(path.join(dir, "b.md"), `# B\n`);
+        const g = parseBrainVault(dir);
+        expect(g.edges.filter((e) => e.from === "a" && e.to === "b")).toHaveLength(1);
+        fs.rmSync(dir, { recursive: true, force: true });
+    });
+    it("uses the first # heading as the node title, falls back to the slug", () => {
+        const g = parseBrainVault(vault);
+        expect(g.nodes.find((n) => n.id === "acme-corp")?.title).toBe("Acme Corp");
+        expect(g.nodes.find((n) => n.id === "dana")?.title).toBe("dana"); // ghost → slug
+    });
+    it("renders a self-contained HTML page with the graph data inlined", () => {
+        const g = parseBrainVault(vault);
+        const html = renderBrainHtml(g);
+        expect(html).toContain("<!doctype html>");
+        expect(html).not.toContain("<script src"); // no external scripts — fully self-contained
+        expect(html).toContain('"acme-corp"'); // node data inlined
+    });
+    it("declares interaction state (drag) before the animation loop that reads it", () => {
+        // Regression: `let drag` is in a temporal dead zone until its line runs.
+        // step() reads `drag` every frame, so if the loop starts before `let drag`,
+        // the first frame throws "Cannot access 'drag' before initialization" and
+        // the canvas never renders. Guard the declaration order.
+        const html = renderBrainHtml(parseBrainVault(vault));
+        const dragDecl = html.indexOf("let drag");
+        const loopStart = html.indexOf("function loop()");
+        expect(dragDecl).toBeGreaterThan(-1);
+        expect(loopStart).toBeGreaterThan(-1);
+        expect(dragDecl).toBeLessThan(loopStart);
+    });
+    it("initializes center force at the integrator's scale (not the raw slider value)", () => {
+        // Regression: the slider stores value/1000; the initial value must match or
+        // the first frames fling every node off-screen before it settles.
+        const html = renderBrainHtml(parseBrainVault(vault));
+        expect(html).toContain("center:0.008");
+        expect(html).not.toMatch(/center:8\b/);
+    });
+    it("infers ghost CATEGORY from namespaced tags (a person stays a person)", () => {
+        // A note tagged person/x, org/y, topic/z tells us the category of the
+        // ghost slugs x, y, z even though their notes don't exist. This is what
+        // makes Amitai a 'person' node, not a generic 'ghost'.
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "brain-cat-"));
+        fs.writeFileSync(path.join(dir, "meeting.md"), `---\ntags:\n  - person/amitai\n  - org/acme\n  - topic/litigation-ai\n---\n# Meeting\n[[amitai]] from [[acme]] re [[litigation-ai]].\n`);
+        const g = parseBrainVault(dir);
+        const byId = Object.fromEntries(g.nodes.map((n) => [n.id, n]));
+        expect(byId["amitai"].kind).toBe("ghost");
+        expect(byId["amitai"].category).toBe("person"); // not a generic ghost — a person
+        expect(byId["acme"].category).toBe("org");
+        expect(byId["litigation-ai"].category).toBe("topic");
+        fs.rmSync(dir, { recursive: true, force: true });
+    });
+    it("inlines note content for offline click-to-open (no server needed)", () => {
+        const g = parseBrainVault(vault);
+        const acme = g.nodes.find((n) => n.id === "acme-corp");
+        expect(acme?.content).toContain("Acme Corp"); // body inlined into the node
+        const html = renderBrainHtml(g);
+        expect(html).toContain("openNode"); // the click-to-open handler is present
+    });
+    it("emits a topology back-link when given a topologyHref", () => {
+        const html = renderBrainHtml(parseBrainVault(vault), {
+            topologyHref: "company-brain-team-topology.html",
+            topologyName: "company-brain-team",
+        });
+        expect(html).toContain('class="back-link"');
+        expect(html).toContain("company-brain-team-topology.html");
+        expect(html).toContain("← company-brain-team");
+    });
+    it("omits the back-link when no topology owns the vault", () => {
+        const html = renderBrainHtml(parseBrainVault(vault));
+        expect(html).not.toContain('class="back-link"');
+    });
+    it("reads a note's `source:` frontmatter as a node property", () => {
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "brain-src-"));
+        fs.writeFileSync(path.join(dir, "deal.md"), `---\nsource: gmail\ntags:\n  - deal/closed\n---\n# Deal\nFrom email.\n`);
+        const g = parseBrainVault(dir);
+        expect(g.nodes.find((n) => n.id === "deal")?.source).toBe("gmail");
+        fs.rmSync(dir, { recursive: true, force: true });
+    });
+    it("passes the source style map into the rendered graph (presentation only)", () => {
+        const g = parseBrainVault(vault);
+        const html = renderBrainHtml(g, {
+            sources: { gmail: { color: "#EA4335", icon: "data:image/svg+xml;base64,AAA" } },
+        });
+        expect(html).toContain('"gmail":{"color":"#EA4335"');
+        expect(html).toContain("data:image/svg+xml;base64,AAA"); // icon arrives pre-inlined
+        expect(html).toContain("DATA.sources"); // the renderer consults the map
+    });
+});
+//# sourceMappingURL=brain.test.js.map

package/dist/visualizer/__tests__/brain.test.js.map

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

package/dist/visualizer/__tests__/topology-brain-link.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=topology-brain-link.test.d.ts.map

package/dist/visualizer/__tests__/topology-brain-link.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-brain-link.test.d.ts","sourceRoot":"","sources":["../../../src/visualizer/__tests__/topology-brain-link.test.ts"],"names":[],"mappings":""}

package/dist/visualizer/__tests__/topology-brain-link.test.js

@@ -0,0 +1,41 @@
+import { describe, it, expect } from "vitest";
+import { parse } from "../../parser/index.js";
+import { generateVisualization } from "../index.js";
+/** A minimal topology with one brain store. */
+const ONE_BRAIN = `topology cb : [brain] {
+  meta { version: "1.0.0" description: "x" }
+  memory { store brain { type: brain path: "brain/" format: obsidian } }
+  agent lib { model: sonnet description: "k" tools: [Read, Write] custodian-of: [brain] }
+  action intake { kind: inline description: "in" }
+  flow { intake -> lib }
+}`;
+describe("Topology visualizer — brain cross-link", () => {
+    // Note: `brain-link` / `brain-menu-list` appear as CSS class definitions in
+    // the stylesheet regardless. Assert on the actual RENDERED anchors instead.
+    it("renders no brain anchor when no brains are passed", () => {
+        const html = generateVisualization(parse(ONE_BRAIN));
+        expect(html).not.toContain("Open Brain");
+        expect(html).not.toMatch(/\d+ Brains ▾/);
+    });
+    it("renders a single 'Open Brain →' button for one brain", () => {
+        const html = generateVisualization(parse(ONE_BRAIN), {
+            brains: [{ id: "brain", href: "cb-brain-brain.html" }],
+        });
+        expect(html).toContain("Open Brain");
+        expect(html).toContain('href="cb-brain-brain.html"');
+        expect(html).not.toMatch(/\d+ Brains ▾/); // single → button, not dropdown
+    });
+    it("renders a dropdown listing each brain when there are several", () => {
+        const html = generateVisualization(parse(ONE_BRAIN), {
+            brains: [
+                { id: "client-brain", href: "cb-brain-client-brain.html" },
+                { id: "internal-brain", href: "cb-brain-internal-brain.html" },
+            ],
+        });
+        expect(html).toContain("2 Brains ▾");
+        expect(html).toContain('href="cb-brain-client-brain.html"');
+        expect(html).toContain('href="cb-brain-internal-brain.html"');
+        expect(html).not.toContain("Open Brain"); // dropdown, not single button
+    });
+});
+//# sourceMappingURL=topology-brain-link.test.js.map

package/dist/visualizer/__tests__/topology-brain-link.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-brain-link.test.js","sourceRoot":"","sources":["../../../src/visualizer/__tests__/topology-brain-link.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,+CAA+C;AAC/C,MAAM,SAAS,GAAG;;;;;;EAMhB,CAAC;AAEH,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,4EAA4E;IAC5E,4EAA4E;IAC5E,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;YACnD,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;SACvD,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,gCAAgC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACtE,MAAM,IAAI,GAAG,qBAAqB,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;YACnD,MAAM,EAAE;gBACN,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,4BAA4B,EAAE;gBAC1D,EAAE,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,8BAA8B,EAAE;aAC/D;SACF,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,mCAAmC,CAAC,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,8BAA8B;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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"}