@cleocode/brain 2026.6.14 → 2026.6.17

package/dist/src/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,KAAK,EAEV,UAAU,EAEV,iBAAiB,EAElB,MAAM,aAAa,CAAC;AAgIrB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAuE5E"}

package/dist/src/adapters/index.js

@@ -0,0 +1,194 @@
+/**
+ * Barrel for all substrate adapters.
+ *
+ * Re-exports individual adapter functions and provides the unified
+ * `getAllSubstrates()` function that merges results from all five databases
+ * into a single BrainGraph.
+ */
+export { getAgentRegistrySubstrate } from './agent-registry.js';
+export { getBrainSubstrate } from './brain.js';
+export { getConduitSubstrate } from './conduit.js';
+export { getNexusSubstrate } from './nexus.js';
+export { getTasksSubstrate } from './tasks.js';
+import { allTyped, getNexusDb } from '../db-connections.js';
+import { getAgentRegistrySubstrate } from './agent-registry.js';
+import { getBrainSubstrate } from './brain.js';
+import { getConduitSubstrate } from './conduit.js';
+import { getNexusSubstrate } from './nexus.js';
+import { getTasksSubstrate } from './tasks.js';
+/** Substrate names ordered for iteration. */
+const ALL_SUBSTRATES = ['brain', 'nexus', 'tasks', 'conduit', 'agent-registry'];
+/** Maps substrate name to its adapter function. */
+const ADAPTER_MAP = {
+    brain: getBrainSubstrate,
+    nexus: getNexusSubstrate,
+    tasks: getTasksSubstrate,
+    conduit: getConduitSubstrate,
+    'agent-registry': getAgentRegistrySubstrate,
+};
+/**
+ * Loads minimal stub nodes for any edge target IDs not already loaded.
+ *
+ * This second-pass loader ensures that cross-substrate edges
+ * (particularly brain→nexus bridges) don't reference unloaded target nodes.
+ *
+ * Stub nodes carry only minimal metadata: {id, substrate, kind, label}.
+ * Full details defer to side-panel click or future full-load request.
+ *
+ * @param loadedNodeIds - Set of already-loaded node IDs (substrate-prefixed).
+ * @param edges - All edges collected from substrates (may reference unloaded targets).
+ * @returns Array of stub BrainNode objects for missing targets.
+ */
+function loadStubNodesForEdgeTargets(loadedNodeIds, edges) {
+    // Collect all target IDs referenced by edges but not yet loaded
+    const missingTargetIds = new Set();
+    for (const edge of edges) {
+        if (!loadedNodeIds.has(edge.target)) {
+            missingTargetIds.add(edge.target);
+        }
+    }
+    if (missingTargetIds.size === 0)
+        return [];
+    // Partition missing target IDs by substrate
+    const stubsBySubstrate = new Map();
+    for (const nodeId of missingTargetIds) {
+        const sep = nodeId.indexOf(':');
+        if (sep === -1)
+            continue;
+        const substrateStr = nodeId.slice(0, sep);
+        const substrate = substrateStr;
+        if (!['brain', 'nexus', 'tasks', 'conduit', 'agent-registry'].includes(substrate)) {
+            continue;
+        }
+        if (!stubsBySubstrate.has(substrate)) {
+            stubsBySubstrate.set(substrate, []);
+        }
+        stubsBySubstrate.get(substrate).push(nodeId);
+    }
+    const stubs = [];
+    // Load stubs for nexus targets (most common cross-substrate case)
+    const nexusStubs = stubsBySubstrate.get('nexus');
+    if (nexusStubs && nexusStubs.length > 0) {
+        const db = getNexusDb();
+        if (db) {
+            try {
+                const rawNexusIds = nexusStubs.map((id) => id.replace(/^nexus:/, ''));
+                const placeholders = rawNexusIds.map(() => '?').join(',');
+                // Query minimal node data: id, kind, name
+                const stubRows = allTyped(db.prepare(`SELECT id, kind, name
+             FROM nexus_nodes
+             WHERE id IN (${placeholders})`), ...rawNexusIds);
+                for (const row of stubRows) {
+                    const kind = row.kind === 'file' || row.kind === 'folder' || row.kind === 'module'
+                        ? 'file'
+                        : 'symbol';
+                    stubs.push({
+                        id: `nexus:${row.id}`,
+                        kind,
+                        substrate: 'nexus',
+                        label: row.name,
+                        weight: undefined,
+                        createdAt: null,
+                        meta: { nexus_kind: row.kind, isStub: true },
+                    });
+                }
+            }
+            catch {
+                // Silently continue on error; stubs are supplemental
+            }
+        }
+    }
+    // For other substrates (tasks, brain, conduit, signaldock), create minimal stubs
+    // without DB queries — they are rare as cross-substrate edge targets.
+    for (const [substrate, nodeIds] of stubsBySubstrate) {
+        if (substrate === 'nexus')
+            continue; // already handled above
+        for (const nodeId of nodeIds) {
+            const rawId = nodeId.replace(new RegExp(`^${substrate}:`), '');
+            stubs.push({
+                id: nodeId,
+                kind: 'observation', // generic fallback kind
+                substrate,
+                label: rawId,
+                weight: undefined,
+                createdAt: null,
+                meta: { isStub: true },
+            });
+        }
+    }
+    return stubs;
+}
+/**
+ * Queries all five substrates and merges the results into a unified BrainGraph.
+ *
+ * When `options.substrates` is provided, only those substrates are queried.
+ * Node IDs are substrate-prefixed, so deduplication is safe to perform
+ * by ID equality alone.
+ *
+ * After all substrates are loaded, performs a second-pass stub-node load:
+ * any edge target ID not yet in the loaded node set is fetched as a minimal
+ * stub (id, substrate, kind, label). This recovers cross-substrate edges
+ * that would otherwise be silently dropped.
+ *
+ * Stub nodes carry `meta.isStub: true` for optional UI differentiation.
+ *
+ * @param options - Query options forwarded to each substrate adapter.
+ * @returns Merged BrainGraph across all requested substrates, with stub nodes for unresolved edge targets.
+ */
+export function getAllSubstrates(options = {}) {
+    const substrates = options.substrates ?? ALL_SUBSTRATES;
+    const limit = options.limit ?? 500;
+    const allNodes = [];
+    const allEdges = [];
+    const nodeCounts = Object.fromEntries(ALL_SUBSTRATES.map((s) => [s, 0]));
+    const edgeCounts = Object.fromEntries([...ALL_SUBSTRATES, 'cross'].map((s) => [s, 0]));
+    for (const substrate of substrates) {
+        const adapter = ADAPTER_MAP[substrate];
+        if (!adapter)
+            continue;
+        const { nodes, edges } = adapter({ ...options, limit });
+        allNodes.push(...nodes);
+        allEdges.push(...edges);
+        nodeCounts[substrate] = nodes.length;
+        for (const edge of edges) {
+            edgeCounts[edge.substrate] = (edgeCounts[edge.substrate] ?? 0) + 1;
+        }
+    }
+    // Deduplicate nodes by ID (substrate-prefix guarantees uniqueness across
+    // substrates; duplicates can only occur within a substrate on malformed data)
+    const seenIds = new Set();
+    const uniqueNodes = [];
+    for (const node of allNodes) {
+        if (!seenIds.has(node.id)) {
+            seenIds.add(node.id);
+            uniqueNodes.push(node);
+        }
+    }
+    // Second pass: load stub nodes for any edge target IDs not yet loaded.
+    // This recovers cross-substrate edges that would otherwise be silently dropped
+    // (e.g. brain→nexus bridges to low-in-degree symbols).
+    //
+    // When a substrates filter is explicitly provided, only add stubs for substrates
+    // within the requested set — never inject nodes from excluded substrates, as that
+    // would violate the caller's filter contract.
+    const requestedSubstrateSet = options.substrates ? new Set(options.substrates) : null;
+    const stubNodes = loadStubNodesForEdgeTargets(seenIds, allEdges);
+    for (const stubNode of stubNodes) {
+        if (!seenIds.has(stubNode.id)) {
+            // Skip stubs from substrates not in the requested set
+            if (requestedSubstrateSet && !requestedSubstrateSet.has(stubNode.substrate)) {
+                continue;
+            }
+            seenIds.add(stubNode.id);
+            uniqueNodes.push(stubNode);
+        }
+    }
+    const truncated = uniqueNodes.length >= limit;
+    return {
+        nodes: truncated ? uniqueNodes.slice(0, limit) : uniqueNodes,
+        edges: allEdges,
+        counts: { nodes: nodeCounts, edges: edgeCounts },
+        truncated,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/src/adapters/index.js.map

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

package/dist/src/adapters/nexus.d.ts

@@ -0,0 +1,24 @@
+/**
+ * NEXUS substrate adapter for the Living Brain API.
+ *
+ * Queries nexus.db (global) and returns BrainNodes/BrainEdges for code symbols and files.
+ * Prioritises high-in-degree nodes (most-called functions, most-imported files)
+ * since the full nexus graph can exceed 10k nodes.
+ *
+ * Node IDs are prefixed with "nexus:" to prevent collisions.
+ */
+import type { BrainEdge, BrainNode, BrainQueryOptions } from '../types.js';
+/**
+ * Returns all BrainNodes and BrainEdges sourced from nexus.db.
+ *
+ * Fetches the highest in-degree nodes (capped at perSubstrateLimit) and
+ * all relations between those nodes.
+ *
+ * @param options - Query options (limit, minWeight).
+ * @returns Nodes and edges from the NEXUS substrate.
+ */
+export declare function getNexusSubstrate(options?: BrainQueryOptions): {
+    nodes: BrainNode[];
+    edges: BrainEdge[];
+};
+//# sourceMappingURL=nexus.d.ts.map

package/dist/src/adapters/nexus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus.d.ts","sourceRoot":"","sources":["../../../src/adapters/nexus.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAiB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAyB1F;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,GAAG;IAClE,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAyEA"}

package/dist/src/adapters/nexus.js

@@ -0,0 +1,83 @@
+/**
+ * NEXUS substrate adapter for the Living Brain API.
+ *
+ * Queries nexus.db (global) and returns BrainNodes/BrainEdges for code symbols and files.
+ * Prioritises high-in-degree nodes (most-called functions, most-imported files)
+ * since the full nexus graph can exceed 10k nodes.
+ *
+ * Node IDs are prefixed with "nexus:" to prevent collisions.
+ */
+import { allTyped, getNexusDb } from '../db-connections.js';
+/** Maps nexus node kinds to BrainNodeKind. */
+function mapKind(nexusKind) {
+    if (nexusKind === 'file' || nexusKind === 'folder' || nexusKind === 'module')
+        return 'file';
+    return 'symbol';
+}
+/**
+ * Returns all BrainNodes and BrainEdges sourced from nexus.db.
+ *
+ * Fetches the highest in-degree nodes (capped at perSubstrateLimit) and
+ * all relations between those nodes.
+ *
+ * @param options - Query options (limit, minWeight).
+ * @returns Nodes and edges from the NEXUS substrate.
+ */
+export function getNexusSubstrate(options = {}) {
+    const db = getNexusDb();
+    if (!db)
+        return { nodes: [], edges: [] };
+    const perSubstrateLimit = Math.ceil((options.limit ?? 500) / 5);
+    const nodes = [];
+    const edges = [];
+    try {
+        // Count in-degree for each node to use as weight
+        const nodeRows = allTyped(db.prepare(`SELECT n.id, n.kind, n.name, n.indexed_at,
+                COUNT(r.target_id) AS in_degree
+         FROM nexus_nodes n
+         LEFT JOIN nexus_relations r ON r.target_id = n.id
+         WHERE n.kind IN (
+           'file', 'function', 'method', 'class', 'interface',
+           'type_alias', 'constant', 'module', 'enum'
+         )
+         GROUP BY n.id
+         ORDER BY in_degree DESC
+         LIMIT ?`), perSubstrateLimit);
+        for (const row of nodeRows) {
+            nodes.push({
+                id: `nexus:${row.id}`,
+                kind: mapKind(row.kind),
+                substrate: 'nexus',
+                label: row.name,
+                weight: row.in_degree > 0 ? Math.min(1, row.in_degree / 50) : undefined,
+                createdAt: row.indexed_at ?? null,
+                meta: { nexus_kind: row.kind, in_degree: row.in_degree },
+            });
+        }
+        // Edges between loaded nodes only
+        const nodeIds = new Set(nodes.map((n) => n.id));
+        const rawIds = new Set([...nodeIds].map((id) => id.replace(/^nexus:/, '')));
+        // Fetch all relations touching these nodes (both directions)
+        const placeholders = [...rawIds].map(() => '?').join(',');
+        if (rawIds.size === 0)
+            return { nodes, edges };
+        const relRows = allTyped(db.prepare(`SELECT source_id, target_id, type, confidence
+         FROM nexus_relations
+         WHERE source_id IN (${placeholders})
+           AND target_id IN (${placeholders})`), ...rawIds, ...rawIds);
+        for (const row of relRows) {
+            edges.push({
+                source: `nexus:${row.source_id}`,
+                target: `nexus:${row.target_id}`,
+                type: row.type,
+                weight: row.confidence ?? 0.5,
+                substrate: 'nexus',
+            });
+        }
+    }
+    catch {
+        // Return partial results on error
+    }
+    return { nodes, edges };
+}
+//# sourceMappingURL=nexus.js.map

package/dist/src/adapters/nexus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus.js","sourceRoot":"","sources":["../../../src/adapters/nexus.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAoB5D,8CAA8C;AAC9C,SAAS,OAAO,CAAC,SAAiB;IAChC,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC5F,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAA6B,EAAE;IAI/D,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAEzC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,IAAI,CAAC;QACH,iDAAiD;QACjD,MAAM,QAAQ,GAAG,QAAQ,CACvB,EAAE,CAAC,OAAO,CACR;;;;;;;;;;iBAUS,CACV,EACD,iBAAiB,CAClB,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC;gBACT,EAAE,EAAE,SAAS,GAAG,CAAC,EAAE,EAAE;gBACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBACvB,SAAS,EAAE,OAAO;gBAClB,KAAK,EAAE,GAAG,CAAC,IAAI;gBACf,MAAM,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;gBACvE,SAAS,EAAE,GAAG,CAAC,UAAU,IAAI,IAAI;gBACjC,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE;aACzD,CAAC,CAAC;QACL,CAAC;QAED,kCAAkC;QAClC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAE5E,6DAA6D;QAC7D,MAAM,YAAY,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAE/C,MAAM,OAAO,GAAG,QAAQ,CACtB,EAAE,CAAC,OAAO,CACR;;+BAEuB,YAAY;+BACZ,YAAY,GAAG,CACvC,EACD,GAAG,MAAM,EACT,GAAG,MAAM,CACV,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC;gBACT,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,EAAE;gBAChC,MAAM,EAAE,SAAS,GAAG,CAAC,SAAS,EAAE;gBAChC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,MAAM,EAAE,GAAG,CAAC,UAAU,IAAI,GAAG;gBAC7B,SAAS,EAAE,OAAO;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,kCAAkC;IACpC,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC"}

package/dist/src/adapters/tasks.d.ts

@@ -0,0 +1,23 @@
+/**
+ * TASKS substrate adapter for the Living Brain API.
+ *
+ * Queries tasks.db and returns BrainNodes/BrainEdges for tasks and sessions.
+ * Prioritises critical/high priority tasks and active sessions.
+ *
+ * Node IDs are prefixed with "tasks:" to prevent collisions.
+ */
+import type { BrainEdge, BrainNode, BrainQueryOptions } from '../types.js';
+/**
+ * Returns all BrainNodes and BrainEdges sourced from tasks.db.
+ *
+ * Fetches tasks ordered by priority, plus recent sessions.
+ * Synthesizes parent→child, dependency, and relation edges.
+ *
+ * @param options - Query options (limit, minWeight).
+ * @returns Nodes and edges from the TASKS substrate.
+ */
+export declare function getTasksSubstrate(options?: BrainQueryOptions): {
+    nodes: BrainNode[];
+    edges: BrainEdge[];
+};
+//# sourceMappingURL=tasks.d.ts.map

package/dist/src/adapters/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/adapters/tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA6C3E;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,GAAG;IAClE,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CA+IA"}

package/dist/src/adapters/tasks.js

@@ -0,0 +1,143 @@
+/**
+ * TASKS substrate adapter for the Living Brain API.
+ *
+ * Queries tasks.db and returns BrainNodes/BrainEdges for tasks and sessions.
+ * Prioritises critical/high priority tasks and active sessions.
+ *
+ * Node IDs are prefixed with "tasks:" to prevent collisions.
+ */
+import { allTyped, getTasksDb } from '../db-connections.js';
+import { resolveDefaultProjectContext } from '../project-context.js';
+/** Maps priority string to numeric weight for BrainNode.weight. */
+function priorityWeight(priority) {
+    const map = {
+        critical: 1.0,
+        high: 0.75,
+        medium: 0.5,
+        low: 0.25,
+    };
+    return map[priority] ?? 0.25;
+}
+/**
+ * Returns all BrainNodes and BrainEdges sourced from tasks.db.
+ *
+ * Fetches tasks ordered by priority, plus recent sessions.
+ * Synthesizes parent→child, dependency, and relation edges.
+ *
+ * @param options - Query options (limit, minWeight).
+ * @returns Nodes and edges from the TASKS substrate.
+ */
+export function getTasksSubstrate(options = {}) {
+    const ctx = options.projectCtx ?? resolveDefaultProjectContext();
+    const db = getTasksDb(ctx);
+    if (!db)
+        return { nodes: [], edges: [] };
+    const perSubstrateLimit = Math.ceil((options.limit ?? 500) / 5);
+    const minWeight = options.minWeight ?? 0;
+    const nodes = [];
+    const edges = [];
+    try {
+        // Tasks (prioritised by severity, then recency)
+        const taskRows = allTyped(db.prepare(`SELECT id, title, status, priority, type, parent_id, created_at
+         FROM tasks
+         WHERE status NOT IN ('archived', 'cancelled')
+         ORDER BY
+           CASE priority
+             WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 ELSE 3
+           END,
+           created_at DESC
+         LIMIT ?`), Math.ceil(perSubstrateLimit * 0.8));
+        const taskIds = new Set();
+        for (const row of taskRows) {
+            const weight = priorityWeight(row.priority);
+            if (weight < minWeight)
+                continue;
+            taskIds.add(row.id);
+            nodes.push({
+                id: `tasks:${row.id}`,
+                kind: 'task',
+                substrate: 'tasks',
+                label: row.title,
+                weight,
+                createdAt: row.created_at,
+                meta: {
+                    status: row.status,
+                    priority: row.priority,
+                    type: row.type,
+                    parent_id: row.parent_id,
+                    created_at: row.created_at,
+                },
+            });
+        }
+        // Sessions (most recent)
+        const sessionRows = allTyped(db.prepare(`SELECT id, status, started_at, ended_at
+         FROM sessions
+         ORDER BY started_at DESC
+         LIMIT ?`), Math.ceil(perSubstrateLimit * 0.2));
+        const sessionIds = new Set();
+        for (const row of sessionRows) {
+            sessionIds.add(row.id);
+            nodes.push({
+                id: `tasks:${row.id}`,
+                kind: 'session',
+                substrate: 'tasks',
+                label: `Session ${row.id.slice(-8)}`,
+                weight: row.status === 'active' ? 0.9 : 0.4,
+                createdAt: row.started_at,
+                meta: {
+                    status: row.status,
+                    started_at: row.started_at,
+                    ended_at: row.ended_at,
+                },
+            });
+        }
+        // Parent → child task edges
+        for (const row of taskRows) {
+            if (row.parent_id && taskIds.has(row.parent_id)) {
+                edges.push({
+                    source: `tasks:${row.parent_id}`,
+                    target: `tasks:${row.id}`,
+                    type: 'parent_of',
+                    weight: 0.9,
+                    substrate: 'tasks',
+                });
+            }
+        }
+        // Task relations
+        if (taskIds.size > 0) {
+            const placeholders = [...taskIds].map(() => '?').join(',');
+            const relRows = allTyped(db.prepare(`SELECT task_id, related_task_id, relation_type
+           FROM task_relations
+           WHERE task_id IN (${placeholders})
+             AND related_task_id IN (${placeholders})`), ...taskIds, ...taskIds);
+            for (const row of relRows) {
+                edges.push({
+                    source: `tasks:${row.task_id}`,
+                    target: `tasks:${row.related_task_id}`,
+                    type: row.relation_type,
+                    weight: 0.7,
+                    substrate: 'tasks',
+                });
+            }
+            // Task dependencies
+            const depRows = allTyped(db.prepare(`SELECT task_id, depends_on_task_id
+           FROM task_dependencies
+           WHERE task_id IN (${placeholders})
+             AND depends_on_task_id IN (${placeholders})`), ...taskIds, ...taskIds);
+            for (const row of depRows) {
+                edges.push({
+                    source: `tasks:${row.task_id}`,
+                    target: `tasks:${row.depends_on_task_id}`,
+                    type: 'depends_on',
+                    weight: 0.85,
+                    substrate: 'tasks',
+                });
+            }
+        }
+    }
+    catch {
+        // Return partial results on error
+    }
+    return { nodes, edges };
+}
+//# sourceMappingURL=tasks.js.map

package/dist/src/adapters/tasks.js.map

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

package/dist/src/cleo-home.d.ts

@@ -0,0 +1,47 @@
+/**
+ * CLEO home + project DB path resolution for `@cleocode/brain`.
+ *
+ * Path resolution delegates to the `@cleocode/paths` SSoT
+ * ({@link getCleoHome}). Project data (tasks.db, brain.db, conduit.db) is
+ * resolved via projectId → nexus.db registry lookup
+ * ({@link resolveProjectByCwd} + {@link resolveCanonicalCleoDir}), with a
+ * `CLEO_ROOT` / `process.cwd()` fallback for non-project contexts.
+ *
+ * Previously this module imported `env-paths` directly which caused a Windows
+ * path mismatch with the rest of the CLEO ecosystem (the CLI used env-paths
+ * returning `%LOCALAPPDATA%\cleo\Data` while brain used a bare
+ * `%LOCALAPPDATA%\cleo`, looking up `nexus.db` one directory shallower than
+ * where it was written). Fixed in T1874 (Closes #102, supersedes #103).
+ *
+ * @task T1874 (original Windows fix)
+ * @task T1886 (migrated to @cleocode/paths SSoT)
+ * @task T11040 (verified 2026-05-27: projectId-based resolution confirmed; 72/72 tests pass)
+ */
+import { getCleoHome } from '@cleocode/paths';
+export { getCleoHome };
+/**
+ * Returns the project's `.cleo/` directory.
+ *
+ * Resolution order:
+ * 1. {@link resolveProjectByCwd} — reads `.cleo/project-info.json` for a stable
+ *    `projectId`, then resolves the canonical `.cleo/` path via
+ *    {@link resolveCanonicalCleoDir} (nexus.db registry lookup).
+ * 2. Fallback: `CLEO_ROOT` env var or `process.cwd()` + `'.cleo'` for
+ *    non-project contexts (e.g., before `cleo init`).
+ *
+ * @task T11040 — migrate from CWD-walk-up to projectId-based resolution
+ */
+export declare function getCleoProjectDir(): string;
+/** Returns the absolute path to the global nexus.db file. */
+export declare function getNexusDbPath(): string;
+/** Returns the absolute path to the project-scoped brain.db file. */
+export declare function getBrainDbPath(): string;
+/** Returns the absolute path to the project-scoped tasks.db file. */
+export declare function getTasksDbPath(): string;
+/** Returns the absolute path to the project-scoped conduit.db file. */
+export declare function getConduitDbPath(): string;
+/** Returns the absolute path to the global signaldock.db file. */
+export declare function getAgentRegistryDbPath(): string;
+/** Returns true when the given DB file exists on disk. */
+export declare function dbExists(dbPath: string): boolean;
+//# sourceMappingURL=cleo-home.d.ts.map

package/dist/src/cleo-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleo-home.d.ts","sourceRoot":"","sources":["../../src/cleo-home.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,WAAW,EAAgD,MAAM,iBAAiB,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAW1C;AAED,6DAA6D;AAC7D,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,qEAAqE;AACrE,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,kEAAkE;AAClE,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhD"}

package/dist/src/cleo-home.js

@@ -0,0 +1,73 @@
+/**
+ * CLEO home + project DB path resolution for `@cleocode/brain`.
+ *
+ * Path resolution delegates to the `@cleocode/paths` SSoT
+ * ({@link getCleoHome}). Project data (tasks.db, brain.db, conduit.db) is
+ * resolved via projectId → nexus.db registry lookup
+ * ({@link resolveProjectByCwd} + {@link resolveCanonicalCleoDir}), with a
+ * `CLEO_ROOT` / `process.cwd()` fallback for non-project contexts.
+ *
+ * Previously this module imported `env-paths` directly which caused a Windows
+ * path mismatch with the rest of the CLEO ecosystem (the CLI used env-paths
+ * returning `%LOCALAPPDATA%\cleo\Data` while brain used a bare
+ * `%LOCALAPPDATA%\cleo`, looking up `nexus.db` one directory shallower than
+ * where it was written). Fixed in T1874 (Closes #102, supersedes #103).
+ *
+ * @task T1874 (original Windows fix)
+ * @task T1886 (migrated to @cleocode/paths SSoT)
+ * @task T11040 (verified 2026-05-27: projectId-based resolution confirmed; 72/72 tests pass)
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCleoHome, resolveCanonicalCleoDir, resolveProjectByCwd } from '@cleocode/paths';
+export { getCleoHome };
+/**
+ * Returns the project's `.cleo/` directory.
+ *
+ * Resolution order:
+ * 1. {@link resolveProjectByCwd} — reads `.cleo/project-info.json` for a stable
+ *    `projectId`, then resolves the canonical `.cleo/` path via
+ *    {@link resolveCanonicalCleoDir} (nexus.db registry lookup).
+ * 2. Fallback: `CLEO_ROOT` env var or `process.cwd()` + `'.cleo'` for
+ *    non-project contexts (e.g., before `cleo init`).
+ *
+ * @task T11040 — migrate from CWD-walk-up to projectId-based resolution
+ */
+export function getCleoProjectDir() {
+    const project = resolveProjectByCwd();
+    if (project !== null) {
+        const canonical = resolveCanonicalCleoDir(project.projectId);
+        if (canonical !== null)
+            return canonical;
+        // Project found but not in nexus registry yet — use projectRoot fallback.
+        return join(project.projectRoot, '.cleo');
+    }
+    // Fallback for non-project contexts (pre-init, CLEO_ROOT override).
+    const root = process.env['CLEO_ROOT'] ?? process.cwd();
+    return join(root, '.cleo');
+}
+/** Returns the absolute path to the global nexus.db file. */
+export function getNexusDbPath() {
+    return join(getCleoHome(), 'nexus.db');
+}
+/** Returns the absolute path to the project-scoped brain.db file. */
+export function getBrainDbPath() {
+    return join(getCleoProjectDir(), 'brain.db');
+}
+/** Returns the absolute path to the project-scoped tasks.db file. */
+export function getTasksDbPath() {
+    return join(getCleoProjectDir(), 'tasks.db');
+}
+/** Returns the absolute path to the project-scoped conduit.db file. */
+export function getConduitDbPath() {
+    return join(getCleoProjectDir(), 'conduit.db');
+}
+/** Returns the absolute path to the global signaldock.db file. */
+export function getAgentRegistryDbPath() {
+    return join(getCleoHome(), 'signaldock.db');
+}
+/** Returns true when the given DB file exists on disk. */
+export function dbExists(dbPath) {
+    return existsSync(dbPath);
+}
+//# sourceMappingURL=cleo-home.js.map

package/dist/src/cleo-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleo-home.js","sourceRoot":"","sources":["../../src/cleo-home.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,SAAS,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACzC,0EAA0E;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,oEAAoE;IACpE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvD,OAAO,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,iBAAiB,EAAE,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,iBAAiB,EAAE,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,iBAAiB,EAAE,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC"}