@cleocode/brain 2026.6.14 → 2026.6.17

package/dist/src/db-connections.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Read-only SQLite connection helpers for the Living Brain substrate adapters.
+ *
+ * Uses node:sqlite (Node.js built-in).
+ *
+ * Global databases (nexus.db, signaldock.db) are shared across all projects
+ * and use module-level caches — their path is fixed per machine and never
+ * changes between requests.
+ *
+ * Per-project databases (brain.db, tasks.db, conduit.db) are resolved from
+ * the active {@link ProjectContext} passed by the caller. No cross-request
+ * caching is performed: opening SQLite with `node:sqlite` is sub-millisecond,
+ * and caching across different ProjectContexts is the precise bug this
+ * module's Studio counterpart was rewritten to avoid.
+ *
+ * This file is a trimmed mirror of
+ * `packages/studio/src/lib/server/db/connections.ts`, containing only the
+ * getters required by the substrate adapters.
+ *
+ * ## E4-T5 transition (T11516 · SG-DB-SUBSTRATE-V2)
+ *
+ * This module now depends on `@cleocode/core` and delegates to
+ * {@link openDualScopeDb} for new consolidated `cleo.db` access.  The legacy
+ * per-domain DB getters ({@link getNexusDb}, {@link getBrainDb}, etc.) still
+ * open the old per-domain files via per-line-allowed raw opens because the
+ * substrate adapters in this package still target those legacy table schemas.
+ * The full exodus to the consolidated `cleo.db` schema happens in E6 (T11249),
+ * at which point the per-line `// db-open-allowed` markers and the legacy
+ * getters are removed.
+ *
+ * @task T969
+ * @task T11516 (E4-T5)
+ */
+import type { DatabaseSync as _DatabaseSyncType } from 'node:sqlite';
+import type { ProjectContext } from './project-context.js';
+/**
+ * Re-export of the dual-scope `cleo.db` chokepoint.
+ *
+ * Callers that target the new consolidated schema (E4+) should use
+ * `openDualScopeDb` directly rather than the legacy per-domain getters below.
+ *
+ * @see packages/core/src/store/dual-scope-db.ts
+ */
+export { openDualScopeDb } from '@cleocode/core/db';
+type DatabaseSync = _DatabaseSyncType;
+declare const DatabaseSync: new (path: import("fs").PathLike, options?: import("node:sqlite").DatabaseSyncOptions | undefined) => DatabaseSync;
+/**
+ * Minimal structural view of a `node:sqlite` prepared statement.
+ *
+ * `node:sqlite` returns rows as `Record<string, SQLOutputValue>[]` — a generic
+ * shape that's not directly assignable to the row interfaces defined by each
+ * substrate adapter. This type captures just the subset of `StatementSync`
+ * used by the typed-row helper below.
+ */
+interface PreparedStatementLike {
+    all(...params: unknown[]): unknown[];
+}
+/**
+ * Executes a prepared statement and returns rows typed as `T[]`.
+ *
+ * This helper consolidates the SQL-to-TypeScript boundary into a single,
+ * auditable location. Each adapter specifies the expected row shape via the
+ * type parameter; the unknown→T conversion happens exactly once per call
+ * site rather than being scattered across every query site.
+ *
+ * Callers remain responsible for validating that the SQL projection matches
+ * the declared type `T`.
+ *
+ * @param stmt - A prepared `node:sqlite` StatementSync.
+ * @param params - Anonymous parameter bindings for the statement.
+ * @returns Rows materialised as `T[]`.
+ */
+export declare function allTyped<T>(stmt: PreparedStatementLike, ...params: unknown[]): T[];
+/**
+ * Returns a read-only connection to the global nexus.db.
+ * Returns null when the file does not exist on disk.
+ *
+ * @remarks
+ * Uses `applyPerfPragmas` from `@cleocode/core` (SSoT, T9045).
+ * The raw open is per-line-allowed during the E4 → E6 transition; substrate
+ * adapters still target legacy nexus.db table names. Full exodus in E6 (T11249).
+ */
+export declare function getNexusDb(): DatabaseSync | null;
+/**
+ * Returns a read-only connection to the global signaldock.db.
+ * Returns null when the file does not exist on disk.
+ *
+ * @remarks
+ * Uses `applyPerfPragmas` from `@cleocode/core` (SSoT, T9045).
+ * The raw open is per-line-allowed during the E4 → E6 transition; substrate
+ * adapters still target legacy signaldock.db table names. Full exodus in E6 (T11249).
+ */
+export declare function getAgentRegistryDb(): DatabaseSync | null;
+/**
+ * Opens a connection to brain.db for the given project context.
+ *
+ * Each call opens a fresh DatabaseSync against the path stored in `ctx`.
+ * Returns null when brain.db does not exist for the project OR when the
+ * file is detected as malformed (T10303). Reader-side malformation is
+ * handled by returning null — recovery is owned by the writer side in
+ * `@cleocode/core/store/memory-sqlite.ts:getBrainDb`, which runs the
+ * `recoverMalformedBrainDb()` pipeline before the next process re-opens.
+ *
+ * @param ctx - The active project context.
+ *
+ * @remarks
+ * Uses `applyPerfPragmas` from `@cleocode/core` (SSoT, T9045).
+ * The raw open is per-line-allowed during the E4 → E6 transition; substrate
+ * adapters still target legacy brain.db table names. Full exodus in E6 (T11249).
+ */
+export declare function getBrainDb(ctx: ProjectContext): DatabaseSync | null;
+/**
+ * Opens a connection to tasks.db for the given project context.
+ *
+ * Each call opens a fresh DatabaseSync against the path stored in `ctx`.
+ * Returns null when tasks.db does not exist for the project.
+ *
+ * @param ctx - The active project context.
+ *
+ * @remarks
+ * Uses `applyPerfPragmas` from `@cleocode/core` (SSoT, T9045).
+ * The raw open is per-line-allowed during the E4 → E6 transition; substrate
+ * adapters still target legacy tasks.db table names. Full exodus in E6 (T11249).
+ */
+export declare function getTasksDb(ctx: ProjectContext): DatabaseSync | null;
+/**
+ * Opens a connection to conduit.db for the given project context.
+ *
+ * conduit.db lives alongside brain.db in the project's `.cleo/` directory.
+ * Its path is derived from the brain.db path since `ProjectContext` does not
+ * carry a dedicated `conduitDbPath` field.
+ *
+ * Returns null when conduit.db does not exist for the project.
+ *
+ * @param ctx - The active project context.
+ *
+ * @remarks
+ * Uses `applyPerfPragmas` from `@cleocode/core` (SSoT, T9045).
+ * The raw open is per-line-allowed during the E4 → E6 transition; substrate
+ * adapters still target legacy conduit.db table names. Full exodus in E6 (T11249).
+ */
+export declare function getConduitDb(ctx: ProjectContext): DatabaseSync | null;
+//# sourceMappingURL=db-connections.d.ts.map

package/dist/src/db-connections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-connections.d.ts","sourceRoot":"","sources":["../../src/db-connections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,OAAO,KAAK,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGpD,KAAK,YAAY,GAAG,iBAAiB,CAAC;AACtC,QAAA,MAAQ,YAAY,wGAC8D,YACjF,CAAC;AAMF;;;;;;;GAOG;AACH,UAAU,qBAAqB;IAC7B,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;CACtC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAElF;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,IAAI,YAAY,GAAG,IAAI,CAOhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,GAAG,IAAI,CAOxD;AAwBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAWnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAMnE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,YAAY,GAAG,IAAI,CAMrE"}

package/dist/src/db-connections.js

@@ -0,0 +1,215 @@
+/**
+ * Read-only SQLite connection helpers for the Living Brain substrate adapters.
+ *
+ * Uses node:sqlite (Node.js built-in).
+ *
+ * Global databases (nexus.db, signaldock.db) are shared across all projects
+ * and use module-level caches — their path is fixed per machine and never
+ * changes between requests.
+ *
+ * Per-project databases (brain.db, tasks.db, conduit.db) are resolved from
+ * the active {@link ProjectContext} passed by the caller. No cross-request
+ * caching is performed: opening SQLite with `node:sqlite` is sub-millisecond,
+ * and caching across different ProjectContexts is the precise bug this
+ * module's Studio counterpart was rewritten to avoid.
+ *
+ * This file is a trimmed mirror of
+ * `packages/studio/src/lib/server/db/connections.ts`, containing only the
+ * getters required by the substrate adapters.
+ *
+ * ## E4-T5 transition (T11516 · SG-DB-SUBSTRATE-V2)
+ *
+ * This module now depends on `@cleocode/core` and delegates to
+ * {@link openDualScopeDb} for new consolidated `cleo.db` access.  The legacy
+ * per-domain DB getters ({@link getNexusDb}, {@link getBrainDb}, etc.) still
+ * open the old per-domain files via per-line-allowed raw opens because the
+ * substrate adapters in this package still target those legacy table schemas.
+ * The full exodus to the consolidated `cleo.db` schema happens in E6 (T11249),
+ * at which point the per-line `// db-open-allowed` markers and the legacy
+ * getters are removed.
+ *
+ * @task T969
+ * @task T11516 (E4-T5)
+ */
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { applyPerfPragmas } from '@cleocode/core/store/sqlite-pragmas.js';
+import { dbExists, getAgentRegistryDbPath, getNexusDbPath } from './cleo-home.js';
+/**
+ * Re-export of the dual-scope `cleo.db` chokepoint.
+ *
+ * Callers that target the new consolidated schema (E4+) should use
+ * `openDualScopeDb` directly rather than the legacy per-domain getters below.
+ *
+ * @see packages/core/src/store/dual-scope-db.ts
+ */
+export { openDualScopeDb } from '@cleocode/core/db';
+const _require = createRequire(import.meta.url);
+const { DatabaseSync } = _require('node:sqlite');
+/**
+ * Executes a prepared statement and returns rows typed as `T[]`.
+ *
+ * This helper consolidates the SQL-to-TypeScript boundary into a single,
+ * auditable location. Each adapter specifies the expected row shape via the
+ * type parameter; the unknown→T conversion happens exactly once per call
+ * site rather than being scattered across every query site.
+ *
+ * Callers remain responsible for validating that the SQL projection matches
+ * the declared type `T`.
+ *
+ * @param stmt - A prepared `node:sqlite` StatementSync.
+ * @param params - Anonymous parameter bindings for the statement.
+ * @returns Rows materialised as `T[]`.
+ */
+export function allTyped(stmt, ...params) {
+    return stmt.all(...params);
+}
+// ---------------------------------------------------------------------------
+// Global singleton caches (path never changes per process)
+// ---------------------------------------------------------------------------
+/** Cached nexus.db connection — global, path is machine-scoped. */
+let nexusDb = null;
+/** Cached signaldock.db connection — global, path is machine-scoped. */
+let signaldockDb = null;
+// ---------------------------------------------------------------------------
+// Global DB getters (cached per process)
+// ---------------------------------------------------------------------------
+/**
+ * Returns a read-only connection to the global nexus.db.
+ * Returns null when the file does not exist on disk.
+ *
+ * @remarks
+ * Uses `applyPerfPragmas` from `@cleocode/core` (SSoT, T9045).
+ * The raw open is per-line-allowed during the E4 → E6 transition; substrate
+ * adapters still target legacy nexus.db table names. Full exodus in E6 (T11249).
+ */
+export function getNexusDb() {
+    if (nexusDb)
+        return nexusDb;
+    const path = getNexusDbPath();
+    if (!dbExists(path))
+        return null;
+    nexusDb = new DatabaseSync(path, { open: true }); // db-open-allowed: E4-T5 coexistence — adapters target legacy nexus.db schema; full exodus in E6 (T11249)
+    applyPerfPragmas(nexusDb);
+    return nexusDb;
+}
+/**
+ * Returns a read-only connection to the global signaldock.db.
+ * Returns null when the file does not exist on disk.
+ *
+ * @remarks
+ * Uses `applyPerfPragmas` from `@cleocode/core` (SSoT, T9045).
+ * The raw open is per-line-allowed during the E4 → E6 transition; substrate
+ * adapters still target legacy signaldock.db table names. Full exodus in E6 (T11249).
+ */
+export function getAgentRegistryDb() {
+    if (signaldockDb)
+        return signaldockDb;
+    const path = getAgentRegistryDbPath();
+    if (!dbExists(path))
+        return null;
+    signaldockDb = new DatabaseSync(path, { open: true }); // db-open-allowed: E4-T5 coexistence — adapters target legacy signaldock.db schema; full exodus in E6 (T11249)
+    applyPerfPragmas(signaldockDb);
+    return signaldockDb;
+}
+// ---------------------------------------------------------------------------
+// Per-project DB getters (NOT cached — resolved from ProjectContext)
+// ---------------------------------------------------------------------------
+/**
+ * Detect the brain.db malformation signature (T10303) without taking a
+ * dependency on `@cleocode/core`. The reader side does NOT auto-recover —
+ * recovery is owned by the writer side in `@cleocode/core/store/memory-sqlite.ts`.
+ * Reader-side detection returns `null` so substrate adapters degrade
+ * gracefully (matches the existing "DB doesn't exist" semantics).
+ *
+ * @internal — brain-package-local.
+ * @task T10303
+ */
+function isMalformationError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const code = err.code;
+    const errcode = err.errcode;
+    if (code === 'ERR_SQLITE_ERROR' && errcode === 11)
+        return true;
+    return /malformed/i.test(err.message ?? '');
+}
+/**
+ * Opens a connection to brain.db for the given project context.
+ *
+ * Each call opens a fresh DatabaseSync against the path stored in `ctx`.
+ * Returns null when brain.db does not exist for the project OR when the
+ * file is detected as malformed (T10303). Reader-side malformation is
+ * handled by returning null — recovery is owned by the writer side in
+ * `@cleocode/core/store/memory-sqlite.ts:getBrainDb`, which runs the
+ * `recoverMalformedBrainDb()` pipeline before the next process re-opens.
+ *
+ * @param ctx - The active project context.
+ *
+ * @remarks
+ * Uses `applyPerfPragmas` from `@cleocode/core` (SSoT, T9045).
+ * The raw open is per-line-allowed during the E4 → E6 transition; substrate
+ * adapters still target legacy brain.db table names. Full exodus in E6 (T11249).
+ */
+export function getBrainDb(ctx) {
+    const path = ctx.brainDbPath;
+    if (!existsSync(path))
+        return null;
+    try {
+        const __db = new DatabaseSync(path, { open: true }); // db-open-allowed: E4-T5 coexistence — adapters target legacy brain.db schema; full exodus in E6 (T11249)
+        applyPerfPragmas(__db);
+        return __db;
+    }
+    catch (err) {
+        if (isMalformationError(err))
+            return null;
+        throw err;
+    }
+}
+/**
+ * Opens a connection to tasks.db for the given project context.
+ *
+ * Each call opens a fresh DatabaseSync against the path stored in `ctx`.
+ * Returns null when tasks.db does not exist for the project.
+ *
+ * @param ctx - The active project context.
+ *
+ * @remarks
+ * Uses `applyPerfPragmas` from `@cleocode/core` (SSoT, T9045).
+ * The raw open is per-line-allowed during the E4 → E6 transition; substrate
+ * adapters still target legacy tasks.db table names. Full exodus in E6 (T11249).
+ */
+export function getTasksDb(ctx) {
+    const path = ctx.tasksDbPath;
+    if (!existsSync(path))
+        return null;
+    const __db = new DatabaseSync(path, { open: true }); // db-open-allowed: E4-T5 coexistence — adapters target legacy tasks.db schema; full exodus in E6 (T11249)
+    applyPerfPragmas(__db);
+    return __db;
+}
+/**
+ * Opens a connection to conduit.db for the given project context.
+ *
+ * conduit.db lives alongside brain.db in the project's `.cleo/` directory.
+ * Its path is derived from the brain.db path since `ProjectContext` does not
+ * carry a dedicated `conduitDbPath` field.
+ *
+ * Returns null when conduit.db does not exist for the project.
+ *
+ * @param ctx - The active project context.
+ *
+ * @remarks
+ * Uses `applyPerfPragmas` from `@cleocode/core` (SSoT, T9045).
+ * The raw open is per-line-allowed during the E4 → E6 transition; substrate
+ * adapters still target legacy conduit.db table names. Full exodus in E6 (T11249).
+ */
+export function getConduitDb(ctx) {
+    const path = join(dirname(ctx.brainDbPath), 'conduit.db');
+    if (!existsSync(path))
+        return null;
+    const __db = new DatabaseSync(path, { open: true }); // db-open-allowed: E4-T5 coexistence — adapters target legacy conduit.db schema; full exodus in E6 (T11249)
+    applyPerfPragmas(__db);
+    return __db;
+}
+//# sourceMappingURL=db-connections.js.map

package/dist/src/db-connections.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Public entry point for `@cleocode/brain` — the unified-graph substrate for CLEO.
+ *
+ * Exports:
+ * - Wire-format types (BrainNode, BrainEdge, BrainGraph, BrainQueryOptions, BrainStreamEvent, BrainConnectionStatus, BrainNodeKind, BrainSubstrate)
+ * - Unified query function (`getAllSubstrates`)
+ * - Individual substrate adapters (`getBrainSubstrate`, `getNexusSubstrate`, `getTasksSubstrate`, `getConduitSubstrate`, `getAgentRegistrySubstrate`)
+ * - Project context helpers (`ProjectContext`, `resolveDefaultProjectContext`)
+ * - Path helpers (`getCleoHome`, `getCleoProjectDir`, `getBrainDbPath`, etc.)
+ *
+ * @remarks
+ * T973 renamed the `LB*` prefix to `Brain*` to align the runtime naming with
+ * the `@cleocode/contracts/operations/brain` wire format and the operator's
+ * BRAIN super-graph mental model. The runtime shapes (fields, unions) remain
+ * intentionally distinct from the contracts shapes — these are the types
+ * produced by the substrate adapters in this package.
+ *
+ * @task T969 (original extraction) · T973 (LB* → Brain* rename)
+ */
+export { getAgentRegistrySubstrate, getAllSubstrates, getBrainSubstrate, getConduitSubstrate, getNexusSubstrate, getTasksSubstrate, } from './adapters/index.js';
+export { dbExists, getAgentRegistryDbPath, getBrainDbPath, getCleoHome, getCleoProjectDir, getConduitDbPath, getNexusDbPath, getTasksDbPath, } from './cleo-home.js';
+export { getAgentRegistryDb, getBrainDb, getConduitDb, getNexusDb, getTasksDb, } from './db-connections.js';
+export type { ProjectContext } from './project-context.js';
+export { resolveDefaultProjectContext } from './project-context.js';
+export type { BrainConnectionStatus, BrainEdge, BrainGraph, BrainNode, BrainNodeKind, BrainProjectContext, BrainQueryOptions, BrainStreamEvent, BrainSubstrate, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAGpE,YAAY,EACV,qBAAqB,EACrB,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,29 @@
+/**
+ * Public entry point for `@cleocode/brain` — the unified-graph substrate for CLEO.
+ *
+ * Exports:
+ * - Wire-format types (BrainNode, BrainEdge, BrainGraph, BrainQueryOptions, BrainStreamEvent, BrainConnectionStatus, BrainNodeKind, BrainSubstrate)
+ * - Unified query function (`getAllSubstrates`)
+ * - Individual substrate adapters (`getBrainSubstrate`, `getNexusSubstrate`, `getTasksSubstrate`, `getConduitSubstrate`, `getAgentRegistrySubstrate`)
+ * - Project context helpers (`ProjectContext`, `resolveDefaultProjectContext`)
+ * - Path helpers (`getCleoHome`, `getCleoProjectDir`, `getBrainDbPath`, etc.)
+ *
+ * @remarks
+ * T973 renamed the `LB*` prefix to `Brain*` to align the runtime naming with
+ * the `@cleocode/contracts/operations/brain` wire format and the operator's
+ * BRAIN super-graph mental model. The runtime shapes (fields, unions) remain
+ * intentionally distinct from the contracts shapes — these are the types
+ * produced by the substrate adapters in this package.
+ *
+ * @task T969 (original extraction) · T973 (LB* → Brain* rename)
+ */
+// Substrate adapters and unified query
+export { getAgentRegistrySubstrate, getAllSubstrates, getBrainSubstrate, getConduitSubstrate, getNexusSubstrate, getTasksSubstrate, } from './adapters/index.js';
+// Path helpers (re-exported for downstream consumers that need to resolve
+// DB paths without importing the connection helpers directly)
+export { dbExists, getAgentRegistryDbPath, getBrainDbPath, getCleoHome, getCleoProjectDir, getConduitDbPath, getNexusDbPath, getTasksDbPath, } from './cleo-home.js';
+// Low-level connection getters (for advanced consumers; studio typically uses
+// its own connection helpers and passes ProjectContext to the adapters instead)
+export { getAgentRegistryDb, getBrainDb, getConduitDb, getNexusDb, getTasksDb, } from './db-connections.js';
+export { resolveDefaultProjectContext } from './project-context.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,uCAAuC;AACvC,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,0EAA0E;AAC1E,8DAA8D;AAC9D,OAAO,EACL,QAAQ,EACR,sBAAsB,EACtB,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,gBAAgB,CAAC;AACxB,8EAA8E;AAC9E,gFAAgF;AAChF,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/src/project-context.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Project context resolution for the Living Brain substrate.
+ *
+ * `ProjectContext` carries the resolved absolute paths for the per-project
+ * databases (brain.db, tasks.db) so substrate adapters can route queries to
+ * the correct project without depending on SvelteKit request locals.
+ *
+ * The `ProjectContext` shape defined here is structurally compatible with
+ * (i.e. a subtype of) the studio's richer `ProjectContext` in
+ * `packages/studio/src/lib/server/project-context.ts`. Studio callers may
+ * pass their full context directly; it will satisfy this interface via
+ * structural typing.
+ *
+ * `resolveDefaultProjectContext` derives a fallback context from
+ * `CLEO_ROOT` / `process.cwd()` when no explicit context is supplied.
+ *
+ * @task T969
+ * @task T11040 (verified 2026-05-27: resolveProjectByCwd used for projectPath; 72/72 tests pass)
+ */
+/**
+ * Resolved paths for the active project context.
+ *
+ * Studio's `ProjectContext` type carries additional fields (projectId, name,
+ * brainDbExists, tasksDbExists). TypeScript structural typing allows Studio to
+ * pass its richer type wherever this interface is expected.
+ */
+export interface ProjectContext {
+    /** Absolute path to the project root. */
+    projectPath: string;
+    /** Absolute path to brain.db for this project. */
+    brainDbPath: string;
+    /** Absolute path to tasks.db for this project. */
+    tasksDbPath: string;
+}
+/**
+ * Resolve the default project context using projectId-based resolution.
+ *
+ * Derives `projectPath` from {@link resolveProjectByCwd} (canonical project
+ * root), falling back to the `.cleo`-relative path for non-project contexts.
+ * DB paths flow through {@link getCleoProjectDir}, which now uses
+ * projectId→nexus.db resolution instead of CWD-walk-up (T11040).
+ *
+ * @returns A context whose paths derive from projectId resolution where possible.
+ * @task T11040 — migrate from CWD-walk-up to projectId-based resolution
+ */
+export declare function resolveDefaultProjectContext(): ProjectContext;
+//# sourceMappingURL=project-context.d.ts.map

package/dist/src/project-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.d.ts","sourceRoot":"","sources":["../../src/project-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,IAAI,cAAc,CAgB7D"}

package/dist/src/project-context.js

@@ -0,0 +1,52 @@
+/**
+ * Project context resolution for the Living Brain substrate.
+ *
+ * `ProjectContext` carries the resolved absolute paths for the per-project
+ * databases (brain.db, tasks.db) so substrate adapters can route queries to
+ * the correct project without depending on SvelteKit request locals.
+ *
+ * The `ProjectContext` shape defined here is structurally compatible with
+ * (i.e. a subtype of) the studio's richer `ProjectContext` in
+ * `packages/studio/src/lib/server/project-context.ts`. Studio callers may
+ * pass their full context directly; it will satisfy this interface via
+ * structural typing.
+ *
+ * `resolveDefaultProjectContext` derives a fallback context from
+ * `CLEO_ROOT` / `process.cwd()` when no explicit context is supplied.
+ *
+ * @task T969
+ * @task T11040 (verified 2026-05-27: resolveProjectByCwd used for projectPath; 72/72 tests pass)
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveProjectByCwd } from '@cleocode/paths';
+import { getCleoProjectDir } from './cleo-home.js';
+/**
+ * Resolve the default project context using projectId-based resolution.
+ *
+ * Derives `projectPath` from {@link resolveProjectByCwd} (canonical project
+ * root), falling back to the `.cleo`-relative path for non-project contexts.
+ * DB paths flow through {@link getCleoProjectDir}, which now uses
+ * projectId→nexus.db resolution instead of CWD-walk-up (T11040).
+ *
+ * @returns A context whose paths derive from projectId resolution where possible.
+ * @task T11040 — migrate from CWD-walk-up to projectId-based resolution
+ */
+export function resolveDefaultProjectContext() {
+    const project = resolveProjectByCwd();
+    const projectDir = getCleoProjectDir();
+    // Use canonical project root from projectId resolution when available;
+    // fall back to regex-stripping .cleo/ for non-project contexts.
+    const projectPath = project !== null ? project.projectRoot : projectDir.replace(/\/.cleo$/, '');
+    const brainDbPath = join(projectDir, 'brain.db');
+    const tasksDbPath = join(projectDir, 'tasks.db');
+    // existsSync is referenced to match the studio surface, and documents intent;
+    // adapters re-check existence before opening to avoid stale races.
+    void existsSync;
+    return {
+        projectPath,
+        brainDbPath,
+        tasksDbPath,
+    };
+}
+//# sourceMappingURL=project-context.js.map

package/dist/src/project-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.js","sourceRoot":"","sources":["../../src/project-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAkBnD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,uEAAuE;IACvE,gEAAgE;IAChE,MAAM,WAAW,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAChG,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjD,8EAA8E;IAC9E,mEAAmE;IACnE,KAAK,UAAU,CAAC;IAChB,OAAO;QACL,WAAW;QACX,WAAW;QACX,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Brain unified-graph runtime types — re-exported from `@cleocode/contracts`.
+ *
+ * The canonical definitions live in
+ * `packages/contracts/src/brain-graph.ts`. This file re-exports them so
+ * existing imports of `'../types.js'` within `@cleocode/brain` continue to
+ * resolve without change, and external consumers that `import from
+ * '@cleocode/brain'` also receive the same canonical shapes.
+ *
+ * @remarks
+ * T989 unified the three duplicate copies of BrainNode/BrainEdge/BrainGraph:
+ * - `packages/brain/src/types.ts` (this file — was the runtime definition)
+ * - `packages/contracts/src/operations/brain.ts` (wire-format, now renamed)
+ * - `packages/studio/src/routes/api/memory/graph/+server.ts` (raw-DB types, renamed)
+ *
+ * @task T989 — Unify BrainNode / BrainEdge types (single canonical shape)
+ * @task T973 — LB* → Brain* rename
+ * @task T969 — `@cleocode/brain` package extraction
+ * @see packages/contracts/src/brain-graph.ts (canonical source)
+ */
+export type { BrainConnectionStatus, BrainEdge, BrainGraph, BrainNode, BrainNodeKind, BrainProjectContext, BrainQueryOptions, BrainStreamEvent, BrainSubstrate, } from '@cleocode/contracts';
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,YAAY,EACV,qBAAqB,EACrB,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,GACf,MAAM,qBAAqB,CAAC"}

package/dist/src/types.js

@@ -0,0 +1,22 @@
+/**
+ * Brain unified-graph runtime types — re-exported from `@cleocode/contracts`.
+ *
+ * The canonical definitions live in
+ * `packages/contracts/src/brain-graph.ts`. This file re-exports them so
+ * existing imports of `'../types.js'` within `@cleocode/brain` continue to
+ * resolve without change, and external consumers that `import from
+ * '@cleocode/brain'` also receive the same canonical shapes.
+ *
+ * @remarks
+ * T989 unified the three duplicate copies of BrainNode/BrainEdge/BrainGraph:
+ * - `packages/brain/src/types.ts` (this file — was the runtime definition)
+ * - `packages/contracts/src/operations/brain.ts` (wire-format, now renamed)
+ * - `packages/studio/src/routes/api/memory/graph/+server.ts` (raw-DB types, renamed)
+ *
+ * @task T989 — Unify BrainNode / BrainEdge types (single canonical shape)
+ * @task T973 — LB* → Brain* rename
+ * @task T969 — `@cleocode/brain` package extraction
+ * @see packages/contracts/src/brain-graph.ts (canonical source)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}