@dzhechkov/harness-core 0.3.47 → 0.3.48

package/dist/brain.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Knowledge Brain (ADR-001 `features/book-brain`, Phase P0) — the durable, cross-project home that
+ * accretes digitized-book Knowledge Units from many projects into ONE shared, queryable brain.
+ *
+ * **Reuse-first by design (P0's whole point):** this module does NOT reimplement storage. It
+ * repoints the already-shipped primitives at a global brain home:
+ * - lexical mirror + idempotent upsert → {@link putBookKnowledge} (`dbPath` = brain books.sqlite)
+ * - lexical cross-source query           → {@link queryBookKnowledge} (`dbPath` = brain books.sqlite)
+ * - vector re-embed + index              → {@link indexPatternsToAgentdb} (`dbPath` = brain agentdb.db)
+ *
+ * All functions are pure/best-effort: they never throw uncontrolled and return honest `error`
+ * strings when a store is absent or a dependency cannot be resolved. `addedTs` is passed IN by the
+ * caller — core stays clock-free and deterministic-friendly.
+ *
+ * @packageDocumentation
+ */
+import { type BookKUHit } from './book-kb.js';
+/** The durable, cross-project brain home. `DZ_BRAIN_HOME` overrides `~/.dz/brain`. */
+export declare function brainHome(): string;
+/** Lexical (FTS5) store for the whole brain — all sources, source-tagged. */
+export declare function brainBooksPath(home: string): string;
+/** Vector (ReasoningBank schema + HNSW) store for the whole brain — all sources, source-tagged. */
+export declare function brainAgentdbPath(home: string): string;
+/** Registry manifest — every ingested source with metadata. */
+export declare function brainRegistryPath(home: string): string;
+/** One registered source in the brain (a book, repo, or paper). */
+export interface BrainSource {
+    readonly slug: string;
+    readonly kind: 'book' | 'repo' | 'paper';
+    readonly kuCount: number;
+    readonly corpusVersion?: string;
+    readonly lang?: string;
+    readonly isbn?: string;
+    readonly addedTs: string;
+}
+/** The brain registry — the durable list of everything ingested. */
+export interface BrainRegistry {
+    readonly version: 1;
+    readonly sources: Record<string, BrainSource>;
+}
+/**
+ * Read the registry from `brain.json`. Returns the empty default if the file is absent or corrupt
+ * — never throws (a corrupt/half-written registry must not brick the brain).
+ */
+export declare function readRegistry(home: string): BrainRegistry;
+/** Write the registry to `brain.json`, creating the brain home if absent. Best-effort. */
+export declare function writeRegistry(home: string, reg: BrainRegistry): void;
+/** List every registered source. `home` defaults to {@link brainHome}. */
+export declare function listBrain(home?: string): BrainSource[];
+/**
+ * Promote a PROJECT's digitized book KB into the durable cross-project brain (ADR-001 P0
+ * `book-brain-register`). Reads the project's lexical `books.sqlite`, groups KUs by book, and for
+ * each book mirrors them into the brain's lexical store ({@link putBookKnowledge}) and re-embeds
+ * them into the brain's vector store ({@link indexPatternsToAgentdb}), then refreshes the registry.
+ *
+ * **Non-clobbering:** promoting the same book twice does not duplicate — the lexical upsert keys on
+ * `(book, ku_id, corpus_version)` and the vector rows are pre-deleted before re-index.
+ */
+export declare function promoteProjectToBrain(opts: {
+    projectRoot: string;
+    depsRoot?: string;
+    brainHome?: string;
+    source?: string;
+    addedTs: string;
+}): Promise<{
+    sources: string[];
+    kus: number;
+    error?: string;
+}>;
+/**
+ * Cross-source lexical recall over the whole brain — a thin, brain-home-scoped wrapper over
+ * {@link queryBookKnowledge}. `source` narrows to one source; default is cross-source. Never throws.
+ */
+export declare function queryBrain(opts: {
+    query: string;
+    brainHome?: string;
+    depsRoot?: string;
+    source?: string;
+    limit?: number;
+}): Promise<{
+    hits: BookKUHit[];
+    error?: string;
+}>;
+//# sourceMappingURL=brain.d.ts.map

package/dist/brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.d.ts","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,EAAiE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAK7G,sFAAsF;AACtF,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,mGAAmG;AACnG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAID,mEAAmE;AACnE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC/C;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAgBxD;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAGpE;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAEtD;AAwHD;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAuF9D;AAID;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAOjD"}

package/dist/brain.js

@@ -0,0 +1,283 @@
+/**
+ * Knowledge Brain (ADR-001 `features/book-brain`, Phase P0) — the durable, cross-project home that
+ * accretes digitized-book Knowledge Units from many projects into ONE shared, queryable brain.
+ *
+ * **Reuse-first by design (P0's whole point):** this module does NOT reimplement storage. It
+ * repoints the already-shipped primitives at a global brain home:
+ * - lexical mirror + idempotent upsert → {@link putBookKnowledge} (`dbPath` = brain books.sqlite)
+ * - lexical cross-source query           → {@link queryBookKnowledge} (`dbPath` = brain books.sqlite)
+ * - vector re-embed + index              → {@link indexPatternsToAgentdb} (`dbPath` = brain agentdb.db)
+ *
+ * All functions are pure/best-effort: they never throw uncontrolled and return honest `error`
+ * strings when a store is absent or a dependency cannot be resolved. `addedTs` is passed IN by the
+ * caller — core stays clock-free and deterministic-friendly.
+ *
+ * @packageDocumentation
+ */
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+import { createRequire } from 'node:module';
+import { putBookKnowledge, queryBookKnowledge, bookKbPath } from './book-kb.js';
+import { indexPatternsToAgentdb } from './agentdb-index.js';
+// ─────────────────────────────────────── Home & paths ───────────────────────────────────────
+/** The durable, cross-project brain home. `DZ_BRAIN_HOME` overrides `~/.dz/brain`. */
+export function brainHome() {
+    const env = process.env['DZ_BRAIN_HOME'];
+    return env !== undefined && env !== '' ? env : join(homedir(), '.dz', 'brain');
+}
+/** Lexical (FTS5) store for the whole brain — all sources, source-tagged. */
+export function brainBooksPath(home) {
+    return join(home, 'books.sqlite');
+}
+/** Vector (ReasoningBank schema + HNSW) store for the whole brain — all sources, source-tagged. */
+export function brainAgentdbPath(home) {
+    return join(home, 'agentdb.db');
+}
+/** Registry manifest — every ingested source with metadata. */
+export function brainRegistryPath(home) {
+    return join(home, 'brain.json');
+}
+function defaultRegistry() {
+    return { version: 1, sources: {} };
+}
+/**
+ * Read the registry from `brain.json`. Returns the empty default if the file is absent or corrupt
+ * — never throws (a corrupt/half-written registry must not brick the brain).
+ */
+export function readRegistry(home) {
+    const path = brainRegistryPath(home);
+    if (!existsSync(path))
+        return defaultRegistry();
+    try {
+        const parsed = JSON.parse(readFileSync(path, 'utf8'));
+        if (parsed !== null && typeof parsed === 'object' &&
+            typeof parsed.sources === 'object' &&
+            parsed.sources !== null) {
+            return { version: 1, sources: parsed.sources };
+        }
+        return defaultRegistry();
+    }
+    catch {
+        return defaultRegistry();
+    }
+}
+/** Write the registry to `brain.json`, creating the brain home if absent. Best-effort. */
+export function writeRegistry(home, reg) {
+    mkdirSync(home, { recursive: true });
+    writeFileSync(brainRegistryPath(home), `${JSON.stringify(reg, null, 2)}\n`);
+}
+/** List every registered source. `home` defaults to {@link brainHome}. */
+export function listBrain(home) {
+    return Object.values(readRegistry(home ?? brainHome()).sources);
+}
+/** Resolve the project's `better-sqlite3` from `depsRoot` (matches the reused primitives). */
+function resolveSqlite(depsRoot) {
+    try {
+        const req = createRequire(join(depsRoot, 'package.json'));
+        return { url: pathToFileURL(req.resolve('better-sqlite3')).href };
+    }
+    catch {
+        return { error: 'better-sqlite3 not installed (run: dz setup --memory agentdb)' };
+    }
+}
+/** Read the project's lexical book KB (all rows, or one `source`). Best-effort; honest errors. */
+async function readProjectRows(depsRoot, projectDbPath, source) {
+    const sqlite = resolveSqlite(depsRoot);
+    if ('error' in sqlite)
+        return { error: sqlite.error };
+    try {
+        const { default: Database } = (await import(sqlite.url));
+        const db = new Database(projectDbPath, { readonly: true });
+        try {
+            const cols = 'book, ku_id, corpus_version, type, name, problem, content, chapter, pages, metadata';
+            const rows = (source !== undefined
+                ? db.prepare(`SELECT ${cols} FROM book_knowledge WHERE book = ?`).all(source)
+                : db.prepare(`SELECT ${cols} FROM book_knowledge`).all());
+            return { rows };
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch (err) {
+        return { error: `read project book KB failed: ${err instanceof Error ? err.message : String(err)}` };
+    }
+}
+/**
+ * The vector primitive is insert-only, so before re-indexing a book we delete its existing brain
+ * vector rows — mirroring the reindex approach. Best-effort: a missing store/table is a no-op.
+ * `foreign_keys = ON` makes the embeddings cascade with the pattern rows.
+ */
+async function deleteBrainVectors(depsRoot, agentdbPath, book) {
+    if (!existsSync(agentdbPath))
+        return; // nothing indexed yet
+    const sqlite = resolveSqlite(depsRoot);
+    if ('error' in sqlite)
+        return;
+    try {
+        const { default: Database } = (await import(sqlite.url));
+        const db = new Database(agentdbPath);
+        try {
+            db.pragma('busy_timeout = 5000');
+            db.pragma('foreign_keys = ON');
+            db.prepare("DELETE FROM reasoning_patterns WHERE task_type = 'book-knowledge' AND tags LIKE ?").run(`%"${book}"%`);
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch {
+        /* best-effort: table may not exist yet, or store is cold */
+    }
+}
+// ──────────────────────────────────────── Promote ───────────────────────────────────────────
+function jsonObj(s) {
+    if (s === null)
+        return {};
+    try {
+        const v = JSON.parse(s);
+        return v !== null && typeof v === 'object' ? v : {};
+    }
+    catch {
+        return {};
+    }
+}
+function jsonPages(s) {
+    if (s === null)
+        return undefined;
+    try {
+        const v = JSON.parse(s);
+        return Array.isArray(v) ? v : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Map a KU's declared `worth` to an honest vector score. Unknown/absent → 0.5 (no fabrication). */
+function worthScore(meta) {
+    switch (meta['worth']) {
+        case 'high':
+            return 0.9;
+        case 'medium':
+            return 0.6;
+        case 'low':
+            return 0.3;
+        default:
+            return 0.5;
+    }
+}
+/**
+ * Promote a PROJECT's digitized book KB into the durable cross-project brain (ADR-001 P0
+ * `book-brain-register`). Reads the project's lexical `books.sqlite`, groups KUs by book, and for
+ * each book mirrors them into the brain's lexical store ({@link putBookKnowledge}) and re-embeds
+ * them into the brain's vector store ({@link indexPatternsToAgentdb}), then refreshes the registry.
+ *
+ * **Non-clobbering:** promoting the same book twice does not duplicate — the lexical upsert keys on
+ * `(book, ku_id, corpus_version)` and the vector rows are pre-deleted before re-index.
+ */
+export async function promoteProjectToBrain(opts) {
+    const home = opts.brainHome ?? brainHome();
+    const depsRoot = opts.depsRoot ?? opts.projectRoot;
+    const projectDbPath = bookKbPath(opts.projectRoot);
+    if (!existsSync(projectDbPath))
+        return { sources: [], kus: 0, error: 'no project book KB' };
+    const read = await readProjectRows(depsRoot, projectDbPath, opts.source);
+    if ('error' in read)
+        return { sources: [], kus: 0, error: read.error };
+    if (read.rows.length === 0)
+        return { sources: [], kus: 0 };
+    // Group rows by book (each book is one promote unit + one registry entry).
+    const byBook = new Map();
+    for (const r of read.rows) {
+        const bucket = byBook.get(r.book);
+        if (bucket)
+            bucket.push(r);
+        else
+            byBook.set(r.book, [r]);
+    }
+    const reg = readRegistry(home);
+    const sources = { ...reg.sources };
+    const promoted = [];
+    let totalKus = 0;
+    let firstError;
+    for (const [book, rows] of byBook) {
+        // 1. Lexical mirror — reuse the idempotent upsert, pointed at the brain store.
+        const kus = rows.map((r) => {
+            const pages = jsonPages(r.pages);
+            const meta = jsonObj(r.metadata);
+            return {
+                book: r.book,
+                kuId: r.ku_id,
+                corpusVersion: r.corpus_version,
+                type: r.type,
+                name: r.name,
+                problem: r.problem,
+                content: r.content,
+                ...(r.chapter !== null ? { chapter: r.chapter } : {}),
+                ...(pages !== undefined ? { pages } : {}),
+                ...(Object.keys(meta).length > 0 ? { metadata: meta } : {}),
+            };
+        });
+        const lex = await putBookKnowledge(depsRoot, kus, { dbPath: brainBooksPath(home) });
+        if (lex.error !== undefined && firstError === undefined)
+            firstError = lex.error;
+        // 2. Vector re-embed — pre-delete this book's stale vectors (insert-only primitive), then index.
+        await deleteBrainVectors(depsRoot, brainAgentdbPath(home), book);
+        const vecRows = rows.map((r) => {
+            const meta = jsonObj(r.metadata);
+            return {
+                taskType: 'book-knowledge',
+                text: `${r.name}: ${r.problem}`,
+                score: worthScore(meta),
+                tags: ['book', r.book, r.type],
+                metadata: {
+                    chapter: r.chapter,
+                    pages: jsonPages(r.pages) ?? null,
+                    ku_id: r.ku_id,
+                    corpus_version: r.corpus_version,
+                },
+            };
+        });
+        const vec = await indexPatternsToAgentdb(depsRoot, vecRows, { dbPath: brainAgentdbPath(home) });
+        if (vec.error !== undefined && firstError === undefined)
+            firstError = vec.error;
+        // 3. Registry entry for this book — corpus_version/lang/isbn from the first row's metadata.
+        const meta0 = jsonObj(rows[0].metadata);
+        const corpusVersion = rows[0].corpus_version;
+        const lang = typeof meta0['lang'] === 'string' ? meta0['lang'] : undefined;
+        const isbn = typeof meta0['isbn'] === 'string' ? meta0['isbn'] : undefined;
+        sources[book] = {
+            slug: book,
+            kind: 'book',
+            kuCount: rows.length,
+            addedTs: opts.addedTs,
+            ...(corpusVersion !== undefined && corpusVersion !== '' ? { corpusVersion } : {}),
+            ...(lang !== undefined ? { lang } : {}),
+            ...(isbn !== undefined ? { isbn } : {}),
+        };
+        promoted.push(book);
+        totalKus += rows.length;
+    }
+    writeRegistry(home, { version: 1, sources });
+    return firstError !== undefined
+        ? { sources: promoted, kus: totalKus, error: firstError }
+        : { sources: promoted, kus: totalKus };
+}
+// ───────────────────────────────────────── Query ────────────────────────────────────────────
+/**
+ * Cross-source lexical recall over the whole brain — a thin, brain-home-scoped wrapper over
+ * {@link queryBookKnowledge}. `source` narrows to one source; default is cross-source. Never throws.
+ */
+export async function queryBrain(opts) {
+    const home = opts.brainHome ?? brainHome();
+    const depsRoot = opts.depsRoot ?? process.cwd();
+    const qopts = { dbPath: brainBooksPath(home) };
+    if (opts.source !== undefined)
+        qopts.book = opts.source;
+    if (opts.limit !== undefined)
+        qopts.limit = opts.limit;
+    return queryBookKnowledge(depsRoot, opts.query, qopts);
+}
+//# sourceMappingURL=brain.js.map

package/dist/brain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain.js","sourceRoot":"","sources":["../src/brain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAA+B,MAAM,cAAc,CAAC;AAC7G,OAAO,EAAE,sBAAsB,EAAmB,MAAM,oBAAoB,CAAC;AAE7E,+FAA+F;AAE/F,sFAAsF;AACtF,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACzC,OAAO,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACjF,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;AACpC,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AAClC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AAClC,CAAC;AAqBD,SAAS,eAAe;IACtB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,eAAe,EAAE,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;QACjE,IACE,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ;YAC7C,OAAQ,MAAgC,CAAC,OAAO,KAAK,QAAQ;YAC5D,MAAgC,CAAC,OAAO,KAAK,IAAI,EAClD,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAG,MAAwB,CAAC,OAAO,EAAE,CAAC;QACpE,CAAC;QACD,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,GAAkB;IAC5D,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,aAAa,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAClE,CAAC;AAUD,8FAA8F;AAC9F,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;QAC1D,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,+DAA+D,EAAE,CAAC;IACpF,CAAC;AACH,CAAC;AAeD,kGAAkG;AAClG,KAAK,UAAU,eAAe,CAC5B,QAAgB,EAChB,aAAqB,EACrB,MAA0B;IAE1B,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,OAAO,IAAI,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAyD,CAAC;QACjH,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,qFAAqF,CAAC;YACnG,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;gBAChC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,IAAI,qCAAqC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;gBAC7E,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,UAAU,IAAI,sBAAsB,CAAC,CAAC,GAAG,EAAE,CAAc,CAAC;YACzE,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,KAAK,EAAE,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;IACvG,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,WAAmB,EAAE,IAAY;IACnF,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,CAAC,sBAAsB;IAC5D,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,OAAO,IAAI,MAAM;QAAE,OAAO;IAC9B,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAA6C,CAAC;QACrG,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;YACjC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;YAC/B,EAAE,CAAC,OAAO,CACR,mFAAmF,CACpF,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;QACvB,CAAC;gBAAS,CAAC;YACT,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;IAC9D,CAAC;AACH,CAAC;AAED,+FAA+F;AAE/F,SAAS,OAAO,CAAC,CAAgB;IAC/B,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC1B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAY,CAAC;QACnC,OAAO,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,CAAgB;IACjC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAY,CAAC;QACnC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,oGAAoG;AACpG,SAAS,UAAU,CAAC,IAA6B;IAC/C,QAAQ,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACtB,KAAK,MAAM;YACT,OAAO,GAAG,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,GAAG,CAAC;QACb,KAAK,KAAK;YACR,OAAO,GAAG,CAAC;QACb;YACE,OAAO,GAAG,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAM3C;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC;IACnD,MAAM,aAAa,GAAG,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAE5F,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,IAAI,OAAO,IAAI,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IACvE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IAE3D,2EAA2E;IAC3E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;;YACtB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAgC,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IAChE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,UAA8B,CAAC;IAEnC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;QAClC,+EAA+E;QAC/E,MAAM,GAAG,GAAa,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACnC,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACjC,OAAO;gBACL,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,KAAK;gBACb,aAAa,EAAE,CAAC,CAAC,cAAc;gBAC/B,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,GAAG,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrD,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5D,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpF,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS;YAAE,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC;QAEhF,iGAAiG;QACjG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,OAAO,GAAiB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACjC,OAAO;gBACL,QAAQ,EAAE,gBAAgB;gBAC1B,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE;gBAC/B,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC;gBACvB,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;gBAC9B,QAAQ,EAAE;oBACR,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI;oBACjC,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,cAAc,EAAE,CAAC,CAAC,cAAc;iBACjC;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChG,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS;YAAE,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC;QAEhF,4FAA4F;QAC5F,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC;QACzC,MAAM,aAAa,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC,cAAc,CAAC;QAC9C,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAK,CAAC,MAAM,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QACvF,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAK,CAAC,MAAM,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,GAAG;YACd,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,IAAI,CAAC,MAAM;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,CAAC,aAAa,KAAK,SAAS,IAAI,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC;QACF,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7C,OAAO,UAAU,KAAK,SAAS;QAC7B,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE;QACzD,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3C,CAAC;AAED,+FAA+F;AAE/F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAMhC;IACC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAChD,MAAM,KAAK,GAAsD,EAAE,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;IAClG,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;IACxD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACvD,OAAO,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACzD,CAAC"}

package/dist/index.d.ts

@@ -26,6 +26,8 @@ export { runSetup, generateHooksConfig, generateAgentdbWriter, writerVersionOf,
 export { indexPatternsToAgentdb, resolveAgentdbPath } from './agentdb-index.js';
 export { putBookKnowledge, queryBookKnowledge, bookKbPath } from './book-kb.js';
 export type { BookKU, BookKUHit } from './book-kb.js';
+export { brainHome, brainBooksPath, brainAgentdbPath, brainRegistryPath, readRegistry, writeRegistry, listBrain, promoteProjectToBrain, queryBrain, } from './brain.js';
+export type { BrainRegistry, BrainSource } from './brain.js';
 export type { AgentdbRow, AgentdbIndexResult } from './agentdb-index.js';
 export { generatePlugin } from './plugin.js';
 export type { PluginManifest } from './plugin.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -22,6 +22,7 @@ export { loadPatterns, loadSessions, computePatternBoost, readLearningConfig, BO
 export { runSetup, generateHooksConfig, generateAgentdbWriter, writerVersionOf, AGENTDB_WRITER_VERSION } from './setup.js';
 export { indexPatternsToAgentdb, resolveAgentdbPath } from './agentdb-index.js';
 export { putBookKnowledge, queryBookKnowledge, bookKbPath } from './book-kb.js';
+export { brainHome, brainBooksPath, brainAgentdbPath, brainRegistryPath, readRegistry, writeRegistry, listBrain, promoteProjectToBrain, queryBrain, } from './brain.js';
 export { generatePlugin } from './plugin.js';
 export { discoverPackages, publishPackages, bumpPatch, compareVersions, findUnpackagedSkills, orderByDependencies, syncReadmeVersion } from './publish.js';
 export { fetchAllDownloads } from './downloads.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAC9B,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAErF,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC1H,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEhP,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC3H,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGhF,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC3J,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAS3B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,mFAAmF;AACnF,MAAM,CAAC,MAAM,oBAAoB,GAC9B,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAErF,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAElH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAC1H,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEhP,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC3H,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEhF,OAAO,EACL,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,UAAU,GACX,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAK7C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC3J,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAS3B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EACnB,cAAc,EACd,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dzhechkov/harness-core",
-  "version": "0.3.47",
+  "version": "0.3.48",
   "description": "Shared harness logic - skill loading, additive apply, and the init/sync/verify/doctor operations.",
   "type": "module",
   "license": "MIT",

package/src/brain.ts

@@ -0,0 +1,346 @@
+/**
+ * Knowledge Brain (ADR-001 `features/book-brain`, Phase P0) — the durable, cross-project home that
+ * accretes digitized-book Knowledge Units from many projects into ONE shared, queryable brain.
+ *
+ * **Reuse-first by design (P0's whole point):** this module does NOT reimplement storage. It
+ * repoints the already-shipped primitives at a global brain home:
+ * - lexical mirror + idempotent upsert → {@link putBookKnowledge} (`dbPath` = brain books.sqlite)
+ * - lexical cross-source query           → {@link queryBookKnowledge} (`dbPath` = brain books.sqlite)
+ * - vector re-embed + index              → {@link indexPatternsToAgentdb} (`dbPath` = brain agentdb.db)
+ *
+ * All functions are pure/best-effort: they never throw uncontrolled and return honest `error`
+ * strings when a store is absent or a dependency cannot be resolved. `addedTs` is passed IN by the
+ * caller — core stays clock-free and deterministic-friendly.
+ *
+ * @packageDocumentation
+ */
+
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { pathToFileURL } from 'node:url';
+import { createRequire } from 'node:module';
+import { putBookKnowledge, queryBookKnowledge, bookKbPath, type BookKU, type BookKUHit } from './book-kb.js';
+import { indexPatternsToAgentdb, type AgentdbRow } from './agentdb-index.js';
+
+// ─────────────────────────────────────── Home & paths ───────────────────────────────────────
+
+/** The durable, cross-project brain home. `DZ_BRAIN_HOME` overrides `~/.dz/brain`. */
+export function brainHome(): string {
+  const env = process.env['DZ_BRAIN_HOME'];
+  return env !== undefined && env !== '' ? env : join(homedir(), '.dz', 'brain');
+}
+
+/** Lexical (FTS5) store for the whole brain — all sources, source-tagged. */
+export function brainBooksPath(home: string): string {
+  return join(home, 'books.sqlite');
+}
+
+/** Vector (ReasoningBank schema + HNSW) store for the whole brain — all sources, source-tagged. */
+export function brainAgentdbPath(home: string): string {
+  return join(home, 'agentdb.db');
+}
+
+/** Registry manifest — every ingested source with metadata. */
+export function brainRegistryPath(home: string): string {
+  return join(home, 'brain.json');
+}
+
+// ──────────────────────────────────────── Registry ──────────────────────────────────────────
+
+/** One registered source in the brain (a book, repo, or paper). */
+export interface BrainSource {
+  readonly slug: string;
+  readonly kind: 'book' | 'repo' | 'paper';
+  readonly kuCount: number;
+  readonly corpusVersion?: string;
+  readonly lang?: string;
+  readonly isbn?: string;
+  readonly addedTs: string;
+}
+
+/** The brain registry — the durable list of everything ingested. */
+export interface BrainRegistry {
+  readonly version: 1;
+  readonly sources: Record<string, BrainSource>;
+}
+
+function defaultRegistry(): BrainRegistry {
+  return { version: 1, sources: {} };
+}
+
+/**
+ * Read the registry from `brain.json`. Returns the empty default if the file is absent or corrupt
+ * — never throws (a corrupt/half-written registry must not brick the brain).
+ */
+export function readRegistry(home: string): BrainRegistry {
+  const path = brainRegistryPath(home);
+  if (!existsSync(path)) return defaultRegistry();
+  try {
+    const parsed = JSON.parse(readFileSync(path, 'utf8')) as unknown;
+    if (
+      parsed !== null && typeof parsed === 'object' &&
+      typeof (parsed as { sources?: unknown }).sources === 'object' &&
+      (parsed as { sources?: unknown }).sources !== null
+    ) {
+      return { version: 1, sources: (parsed as BrainRegistry).sources };
+    }
+    return defaultRegistry();
+  } catch {
+    return defaultRegistry();
+  }
+}
+
+/** Write the registry to `brain.json`, creating the brain home if absent. Best-effort. */
+export function writeRegistry(home: string, reg: BrainRegistry): void {
+  mkdirSync(home, { recursive: true });
+  writeFileSync(brainRegistryPath(home), `${JSON.stringify(reg, null, 2)}\n`);
+}
+
+/** List every registered source. `home` defaults to {@link brainHome}. */
+export function listBrain(home?: string): BrainSource[] {
+  return Object.values(readRegistry(home ?? brainHome()).sources);
+}
+
+// ─────────────────────────────────── Native SQLite helpers ──────────────────────────────────
+
+interface NativeDb {
+  pragma: (s: string) => void;
+  prepare: (q: string) => { run: (...a: unknown[]) => unknown; all: (...a: unknown[]) => unknown[] };
+  close: () => void;
+}
+
+/** Resolve the project's `better-sqlite3` from `depsRoot` (matches the reused primitives). */
+function resolveSqlite(depsRoot: string): { url: string } | { error: string } {
+  try {
+    const req = createRequire(join(depsRoot, 'package.json'));
+    return { url: pathToFileURL(req.resolve('better-sqlite3')).href };
+  } catch {
+    return { error: 'better-sqlite3 not installed (run: dz setup --memory agentdb)' };
+  }
+}
+
+interface ProjRow {
+  book: string;
+  ku_id: string;
+  corpus_version: string;
+  type: string;
+  name: string;
+  problem: string;
+  content: string;
+  chapter: string | null;
+  pages: string | null;
+  metadata: string | null;
+}
+
+/** Read the project's lexical book KB (all rows, or one `source`). Best-effort; honest errors. */
+async function readProjectRows(
+  depsRoot: string,
+  projectDbPath: string,
+  source: string | undefined,
+): Promise<{ rows: ProjRow[] } | { error: string }> {
+  const sqlite = resolveSqlite(depsRoot);
+  if ('error' in sqlite) return { error: sqlite.error };
+  try {
+    const { default: Database } = (await import(sqlite.url)) as { default: new (p: string, o?: object) => NativeDb };
+    const db = new Database(projectDbPath, { readonly: true });
+    try {
+      const cols = 'book, ku_id, corpus_version, type, name, problem, content, chapter, pages, metadata';
+      const rows = (source !== undefined
+        ? db.prepare(`SELECT ${cols} FROM book_knowledge WHERE book = ?`).all(source)
+        : db.prepare(`SELECT ${cols} FROM book_knowledge`).all()) as ProjRow[];
+      return { rows };
+    } finally {
+      db.close();
+    }
+  } catch (err) {
+    return { error: `read project book KB failed: ${err instanceof Error ? err.message : String(err)}` };
+  }
+}
+
+/**
+ * The vector primitive is insert-only, so before re-indexing a book we delete its existing brain
+ * vector rows — mirroring the reindex approach. Best-effort: a missing store/table is a no-op.
+ * `foreign_keys = ON` makes the embeddings cascade with the pattern rows.
+ */
+async function deleteBrainVectors(depsRoot: string, agentdbPath: string, book: string): Promise<void> {
+  if (!existsSync(agentdbPath)) return; // nothing indexed yet
+  const sqlite = resolveSqlite(depsRoot);
+  if ('error' in sqlite) return;
+  try {
+    const { default: Database } = (await import(sqlite.url)) as { default: new (p: string) => NativeDb };
+    const db = new Database(agentdbPath);
+    try {
+      db.pragma('busy_timeout = 5000');
+      db.pragma('foreign_keys = ON');
+      db.prepare(
+        "DELETE FROM reasoning_patterns WHERE task_type = 'book-knowledge' AND tags LIKE ?",
+      ).run(`%"${book}"%`);
+    } finally {
+      db.close();
+    }
+  } catch {
+    /* best-effort: table may not exist yet, or store is cold */
+  }
+}
+
+// ──────────────────────────────────────── Promote ───────────────────────────────────────────
+
+function jsonObj(s: string | null): Record<string, unknown> {
+  if (s === null) return {};
+  try {
+    const v = JSON.parse(s) as unknown;
+    return v !== null && typeof v === 'object' ? (v as Record<string, unknown>) : {};
+  } catch {
+    return {};
+  }
+}
+
+function jsonPages(s: string | null): number[] | undefined {
+  if (s === null) return undefined;
+  try {
+    const v = JSON.parse(s) as unknown;
+    return Array.isArray(v) ? (v as number[]) : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+/** Map a KU's declared `worth` to an honest vector score. Unknown/absent → 0.5 (no fabrication). */
+function worthScore(meta: Record<string, unknown>): number {
+  switch (meta['worth']) {
+    case 'high':
+      return 0.9;
+    case 'medium':
+      return 0.6;
+    case 'low':
+      return 0.3;
+    default:
+      return 0.5;
+  }
+}
+
+/**
+ * Promote a PROJECT's digitized book KB into the durable cross-project brain (ADR-001 P0
+ * `book-brain-register`). Reads the project's lexical `books.sqlite`, groups KUs by book, and for
+ * each book mirrors them into the brain's lexical store ({@link putBookKnowledge}) and re-embeds
+ * them into the brain's vector store ({@link indexPatternsToAgentdb}), then refreshes the registry.
+ *
+ * **Non-clobbering:** promoting the same book twice does not duplicate — the lexical upsert keys on
+ * `(book, ku_id, corpus_version)` and the vector rows are pre-deleted before re-index.
+ */
+export async function promoteProjectToBrain(opts: {
+  projectRoot: string;
+  depsRoot?: string;
+  brainHome?: string;
+  source?: string;
+  addedTs: string;
+}): Promise<{ sources: string[]; kus: number; error?: string }> {
+  const home = opts.brainHome ?? brainHome();
+  const depsRoot = opts.depsRoot ?? opts.projectRoot;
+  const projectDbPath = bookKbPath(opts.projectRoot);
+  if (!existsSync(projectDbPath)) return { sources: [], kus: 0, error: 'no project book KB' };
+
+  const read = await readProjectRows(depsRoot, projectDbPath, opts.source);
+  if ('error' in read) return { sources: [], kus: 0, error: read.error };
+  if (read.rows.length === 0) return { sources: [], kus: 0 };
+
+  // Group rows by book (each book is one promote unit + one registry entry).
+  const byBook = new Map<string, ProjRow[]>();
+  for (const r of read.rows) {
+    const bucket = byBook.get(r.book);
+    if (bucket) bucket.push(r);
+    else byBook.set(r.book, [r]);
+  }
+
+  const reg = readRegistry(home);
+  const sources: Record<string, BrainSource> = { ...reg.sources };
+  const promoted: string[] = [];
+  let totalKus = 0;
+  let firstError: string | undefined;
+
+  for (const [book, rows] of byBook) {
+    // 1. Lexical mirror — reuse the idempotent upsert, pointed at the brain store.
+    const kus: BookKU[] = rows.map((r) => {
+      const pages = jsonPages(r.pages);
+      const meta = jsonObj(r.metadata);
+      return {
+        book: r.book,
+        kuId: r.ku_id,
+        corpusVersion: r.corpus_version,
+        type: r.type,
+        name: r.name,
+        problem: r.problem,
+        content: r.content,
+        ...(r.chapter !== null ? { chapter: r.chapter } : {}),
+        ...(pages !== undefined ? { pages } : {}),
+        ...(Object.keys(meta).length > 0 ? { metadata: meta } : {}),
+      };
+    });
+    const lex = await putBookKnowledge(depsRoot, kus, { dbPath: brainBooksPath(home) });
+    if (lex.error !== undefined && firstError === undefined) firstError = lex.error;
+
+    // 2. Vector re-embed — pre-delete this book's stale vectors (insert-only primitive), then index.
+    await deleteBrainVectors(depsRoot, brainAgentdbPath(home), book);
+    const vecRows: AgentdbRow[] = rows.map((r) => {
+      const meta = jsonObj(r.metadata);
+      return {
+        taskType: 'book-knowledge',
+        text: `${r.name}: ${r.problem}`,
+        score: worthScore(meta),
+        tags: ['book', r.book, r.type],
+        metadata: {
+          chapter: r.chapter,
+          pages: jsonPages(r.pages) ?? null,
+          ku_id: r.ku_id,
+          corpus_version: r.corpus_version,
+        },
+      };
+    });
+    const vec = await indexPatternsToAgentdb(depsRoot, vecRows, { dbPath: brainAgentdbPath(home) });
+    if (vec.error !== undefined && firstError === undefined) firstError = vec.error;
+
+    // 3. Registry entry for this book — corpus_version/lang/isbn from the first row's metadata.
+    const meta0 = jsonObj(rows[0]!.metadata);
+    const corpusVersion = rows[0]!.corpus_version;
+    const lang = typeof meta0['lang'] === 'string' ? (meta0['lang'] as string) : undefined;
+    const isbn = typeof meta0['isbn'] === 'string' ? (meta0['isbn'] as string) : undefined;
+    sources[book] = {
+      slug: book,
+      kind: 'book',
+      kuCount: rows.length,
+      addedTs: opts.addedTs,
+      ...(corpusVersion !== undefined && corpusVersion !== '' ? { corpusVersion } : {}),
+      ...(lang !== undefined ? { lang } : {}),
+      ...(isbn !== undefined ? { isbn } : {}),
+    };
+    promoted.push(book);
+    totalKus += rows.length;
+  }
+
+  writeRegistry(home, { version: 1, sources });
+  return firstError !== undefined
+    ? { sources: promoted, kus: totalKus, error: firstError }
+    : { sources: promoted, kus: totalKus };
+}
+
+// ───────────────────────────────────────── Query ────────────────────────────────────────────
+
+/**
+ * Cross-source lexical recall over the whole brain — a thin, brain-home-scoped wrapper over
+ * {@link queryBookKnowledge}. `source` narrows to one source; default is cross-source. Never throws.
+ */
+export async function queryBrain(opts: {
+  query: string;
+  brainHome?: string;
+  depsRoot?: string;
+  source?: string;
+  limit?: number;
+}): Promise<{ hits: BookKUHit[]; error?: string }> {
+  const home = opts.brainHome ?? brainHome();
+  const depsRoot = opts.depsRoot ?? process.cwd();
+  const qopts: { dbPath: string; book?: string; limit?: number } = { dbPath: brainBooksPath(home) };
+  if (opts.source !== undefined) qopts.book = opts.source;
+  if (opts.limit !== undefined) qopts.limit = opts.limit;
+  return queryBookKnowledge(depsRoot, opts.query, qopts);
+}

package/src/index.ts

@@ -31,6 +31,18 @@ export { runSetup, generateHooksConfig, generateAgentdbWriter, writerVersionOf,
 export { indexPatternsToAgentdb, resolveAgentdbPath } from './agentdb-index.js';
 export { putBookKnowledge, queryBookKnowledge, bookKbPath } from './book-kb.js';
 export type { BookKU, BookKUHit } from './book-kb.js';
+export {
+  brainHome,
+  brainBooksPath,
+  brainAgentdbPath,
+  brainRegistryPath,
+  readRegistry,
+  writeRegistry,
+  listBrain,
+  promoteProjectToBrain,
+  queryBrain,
+} from './brain.js';
+export type { BrainRegistry, BrainSource } from './brain.js';
 export type { AgentdbRow, AgentdbIndexResult } from './agentdb-index.js';
 export { generatePlugin } from './plugin.js';
 export type { PluginManifest } from './plugin.js';