@ariso-ai/ivan 1.0.23 → 1.0.25

package/dist/learnings/builder.js

@@ -0,0 +1,247 @@
+// Rebuilds the learnings SQLite database from scratch by reading all canonical JSONL files,
+// validating them, and inserting records inside a single transaction.
+// This is intentionally a full-replace build (not an incremental migration).
+import { createHash } from 'crypto';
+import fs from 'fs';
+import path from 'path';
+import { sql } from 'kysely';
+import { createFreshLearningsDatabase, getLearningsDbPath, openLearningsDatabase } from './database.js';
+import { buildEmbeddingInputString, EMBEDDING_MODEL, EMBEDDING_DIMENSIONS, embedTexts } from './embeddings.js';
+import { LESSONS_JSONL_RELATIVE_PATH, resolveCanonicalLearningsPath } from './paths.js';
+import { loadCanonicalRecords, sortByPathThenId } from './parser.js';
+import { validateLearningsDataset } from './validator.js';
+const EMBEDDING_BATCH_MAX_ITEMS = 64;
+const EMBEDDING_BATCH_MAX_CHARS = 200_000;
+/**
+ * Validates all canonical JSONL records, then creates a fresh SQLite database
+ * and bulk-inserts everything in one transaction.
+ */
+export async function rebuildLearningsDatabase(repoPath) {
+    const dataset = loadCanonicalRecords(repoPath);
+    validateLearningsDataset(dataset);
+    const { cached, generated, dirty } = await resolveEmbeddings(dataset.learnings);
+    console.log(`Embeddings: ${cached} cached, ${generated} generated`);
+    if (dirty)
+        writeBackEmbeddings(repoPath, dataset.learnings);
+    const dbPath = getLearningsDbPath(repoPath);
+    const tmpPath = `${dbPath}.tmp`;
+    const db = await createFreshLearningsDatabase(repoPath, tmpPath);
+    try {
+        await insertDataset(db, dataset);
+        await storeJsonlHash(db, computeJsonlHash(repoPath));
+        await db.destroy();
+        fs.renameSync(tmpPath, dbPath);
+        return {
+            dbPath,
+            learningCount: dataset.learnings.length,
+            embeddingsCached: cached,
+            embeddingsGenerated: generated
+        };
+    }
+    catch (err) {
+        await db.destroy();
+        if (fs.existsSync(tmpPath)) {
+            fs.unlinkSync(tmpPath);
+        }
+        throw err;
+    }
+}
+/**
+ * Returns true when `.ivan/db.sqlite` is absent or its stored JSONL hash does not match
+ * the current hash of the canonical JSONL files. Used by the pre-commit hook to skip
+ * unnecessary rebuilds.
+ */
+export async function isLearningsDatabaseStale(repoPath) {
+    const dbPath = getLearningsDbPath(repoPath);
+    if (!fs.existsSync(dbPath)) {
+        return true;
+    }
+    const currentHash = computeJsonlHash(repoPath);
+    try {
+        const db = openLearningsDatabase(repoPath, { readonly: true });
+        try {
+            const row = await db
+                .selectFrom('meta')
+                .select('value')
+                .where('key', '=', 'jsonl_hash')
+                .executeTakeFirst();
+            return !row || row.value !== currentHash;
+        }
+        finally {
+            await db.destroy();
+        }
+    }
+    catch {
+        return true;
+    }
+}
+/**
+ * Computes a SHA-256 digest over the sorted paths and contents of all canonical
+ * JSONL files (`evidence.jsonl`, `lessons.jsonl`). Returns an empty string when
+ * the `.ivan` directory does not exist.
+ */
+export function computeJsonlHash(repoPath) {
+    const resolved = path.resolve(repoPath);
+    const learningsDir = resolveCanonicalLearningsPath(resolved);
+    if (!fs.existsSync(learningsDir)) {
+        return '';
+    }
+    const files = [];
+    for (const relativePath of [LESSONS_JSONL_RELATIVE_PATH]) {
+        const file = path.join(resolved, relativePath);
+        if (fs.existsSync(file)) {
+            files.push(file);
+        }
+    }
+    const hash = createHash('sha256');
+    for (const file of files) {
+        hash.update(path.relative(resolved, file));
+        hash.update('\0');
+        hash.update(fs.readFileSync(file));
+        hash.update('\0');
+    }
+    return hash.digest('hex');
+}
+/**
+ * Checks each learning's cached embedding against a SHA-256 of the model version +
+ * embedding input string. Cache hits reuse the stored vector; cache misses are generated
+ * in bounded batches so a large rebuild does not exceed provider request limits.
+ * Mutates records in-place. Returns hit/miss counts.
+ */
+async function resolveEmbeddings(learnings) {
+    const dirty = [];
+    let cached = 0;
+    for (const learning of learnings) {
+        const inputString = buildEmbeddingInputString(learning);
+        const hash = createHash('sha256')
+            .update(`${EMBEDDING_MODEL}@${EMBEDDING_DIMENSIONS}\n`)
+            .update(inputString)
+            .digest('hex');
+        if (learning.embeddingInputHash === hash &&
+            learning.embedding?.length === EMBEDDING_DIMENSIONS) {
+            cached += 1;
+        }
+        else {
+            dirty.push({ learning, inputString, hash });
+        }
+    }
+    let generated = 0;
+    if (dirty.length > 0) {
+        for (const batch of chunkEmbeddingRequests(dirty)) {
+            try {
+                const vectors = await embedTexts(batch.map((item) => item.inputString));
+                for (let i = 0; i < batch.length; i++) {
+                    batch[i].learning.embedding = vectors[i];
+                    batch[i].learning.embeddingInputHash = batch[i].hash;
+                }
+                generated += batch.length;
+            }
+            catch (err) {
+                console.error(`Warning: could not generate embeddings for batch of ${batch.length} learning(s) (${err.message}). Those rows will be skipped for this rebuild.`);
+            }
+        }
+    }
+    return { cached, generated, dirty: generated > 0 };
+}
+function chunkEmbeddingRequests(items) {
+    const batches = [];
+    let currentBatch = [];
+    let currentChars = 0;
+    for (const item of items) {
+        const itemChars = item.inputString.length;
+        const wouldOverflowItems = currentBatch.length >= EMBEDDING_BATCH_MAX_ITEMS;
+        const wouldOverflowChars = currentBatch.length > 0 &&
+            currentChars + itemChars > EMBEDDING_BATCH_MAX_CHARS;
+        if (wouldOverflowItems || wouldOverflowChars) {
+            batches.push(currentBatch);
+            currentBatch = [];
+            currentChars = 0;
+        }
+        currentBatch.push(item);
+        currentChars += itemChars;
+    }
+    if (currentBatch.length > 0) {
+        batches.push(currentBatch);
+    }
+    return batches;
+}
+/**
+ * Rewrites the lessons JSONL file, merging the in-memory `embedding` and `embeddingInputHash`
+ * fields back onto each line that matches by `id`. Non-learning lines are preserved as-is.
+ */
+function writeBackEmbeddings(repoPath, learnings) {
+    const filePath = resolveCanonicalLearningsPath(path.resolve(repoPath), 'lessons.jsonl');
+    if (!fs.existsSync(filePath)) {
+        return;
+    }
+    const learningById = new Map();
+    for (const learning of learnings) {
+        learningById.set(learning.id, learning);
+    }
+    const lines = fs.readFileSync(filePath, 'utf8').split('\n');
+    const updatedLines = [];
+    for (const rawLine of lines) {
+        const trimmed = rawLine.trim();
+        if (!trimmed) {
+            continue;
+        }
+        const parsed = JSON.parse(trimmed);
+        const id = typeof parsed['id'] === 'string' ? parsed['id'] : undefined;
+        const learning = id !== undefined ? learningById.get(id) : undefined;
+        if (learning !== undefined) {
+            parsed['embedding'] = learning.embedding;
+            parsed['embeddingInputHash'] = learning.embeddingInputHash;
+        }
+        updatedLines.push(JSON.stringify(parsed));
+    }
+    const tmpPath = `${filePath}.tmp`;
+    fs.writeFileSync(tmpPath, updatedLines.map((l) => `${l}\n`).join(''), 'utf8');
+    fs.renameSync(tmpPath, filePath);
+}
+/**
+ * Inserts all evidence, learnings, embeddings, and tag/evidence join rows
+ * in a single transaction for atomicity and performance.
+ */
+async function insertDataset(db, dataset) {
+    await db.transaction().execute(async (trx) => {
+        for (const learning of [...dataset.learnings].sort(sortByPathThenId)) {
+            await trx
+                .insertInto('learnings')
+                .values({
+                id: learning.id,
+                kind: learning.kind,
+                source_type: learning.source_type ?? null,
+                source_url: learning.source_url ?? null,
+                title: learning.title ?? null,
+                statement: learning.statement,
+                rationale: learning.rationale ?? null,
+                applicability: learning.applicability ?? null,
+                confidence: learning.confidence ?? null,
+                status: learning.status,
+                created_at: learning.created_at,
+                updated_at: learning.updated_at
+            })
+                .execute();
+            if (learning.embedding && learning.embedding.length > 0) {
+                const vectorBuffer = Buffer.from(new Float32Array(learning.embedding).buffer);
+                await sql `INSERT INTO learning_vectors (learning_id, vector) VALUES (${learning.id}, ${vectorBuffer})`.execute(trx);
+            }
+        }
+    });
+}
+/** Writes the JSONL content hash into the `meta` table so staleness checks can compare it later. */
+async function storeJsonlHash(db, hash) {
+    await db
+        .insertInto('meta')
+        .values({
+        key: 'jsonl_hash',
+        value: hash,
+        updated_at: new Date().toISOString()
+    })
+        .onConflict((oc) => oc.column('key').doUpdateSet({
+        value: hash,
+        updated_at: new Date().toISOString()
+    }))
+        .execute();
+}
+//# sourceMappingURL=builder.js.map

package/dist/learnings/builder.js.map

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

package/dist/learnings/database.d.ts

@@ -0,0 +1,45 @@
+import { Kysely } from 'kysely';
+/** Kysely schema type for the learnings SQLite database. */
+export interface LearningsDatabase {
+    learnings: {
+        id: string;
+        kind: string;
+        source_type: string | null;
+        source_url: string | null;
+        title: string | null;
+        statement: string;
+        rationale: string | null;
+        applicability: string | null;
+        confidence: number | null;
+        status: string;
+        created_at: string;
+        updated_at: string;
+    };
+    meta: {
+        key: string;
+        value: string;
+        updated_at: string;
+    };
+    migrations: {
+        id: number;
+        name: string;
+        executed_at: string;
+    };
+}
+/** Returns the absolute path to the learnings SQLite database for the given repo root. */
+export declare function getLearningsDbPath(repoPath: string): string;
+/**
+ * Deletes any existing database (including WAL/SHM files), creates a fresh one,
+ * applies migrations, and returns an open Kysely connection.
+ * Uses `DELETE` journal mode so no WAL files are created during the bulk rebuild.
+ * Pass an explicit `dbPath` to write to a non-default location (e.g. a `.tmp` file).
+ */
+export declare function createFreshLearningsDatabase(repoPath: string, dbPath?: string): Promise<Kysely<LearningsDatabase>>;
+/**
+ * Opens an existing learnings database for reading or writing.
+ * Throws a descriptive error (with the rebuild command) if the file does not exist.
+ */
+export declare function openLearningsDatabase(repoPath: string, options?: {
+    readonly?: boolean;
+}): Kysely<LearningsDatabase>;
+//# sourceMappingURL=database.d.ts.map

package/dist/learnings/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/learnings/database.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,MAAM,EAAiB,MAAM,QAAQ,CAAC;AAM/C,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;GAKG;AACH,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAepC;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,MAAM,CAAC,iBAAiB,CAAC,CAkB3B"}

package/dist/learnings/database.js

@@ -0,0 +1,63 @@
+// SQLite database lifecycle helpers for the learnings store.
+// The DB is a derived artifact rebuilt from JSONL source files—never edit it directly.
+// WAL files (.db-shm, .db-wal) are removed alongside the main file to avoid stale state.
+import fs from 'fs';
+import path from 'path';
+import BetterSqlite3 from 'better-sqlite3';
+import { Kysely, SqliteDialect } from 'kysely';
+import * as sqliteVec from 'sqlite-vec';
+import { LEARNINGS_DB_RELATIVE_PATH } from './paths.js';
+import { MigrationManager } from '../database/migration.js';
+import { learningsMigrations } from '../database/migrations/index.js';
+/** Returns the absolute path to the learnings SQLite database for the given repo root. */
+export function getLearningsDbPath(repoPath) {
+    return path.join(path.resolve(repoPath), LEARNINGS_DB_RELATIVE_PATH);
+}
+/**
+ * Deletes any existing database (including WAL/SHM files), creates a fresh one,
+ * applies migrations, and returns an open Kysely connection.
+ * Uses `DELETE` journal mode so no WAL files are created during the bulk rebuild.
+ * Pass an explicit `dbPath` to write to a non-default location (e.g. a `.tmp` file).
+ */
+export async function createFreshLearningsDatabase(repoPath, dbPath) {
+    const resolvedDbPath = dbPath ?? getLearningsDbPath(repoPath);
+    removeLearningsDatabaseFiles(resolvedDbPath);
+    fs.mkdirSync(path.dirname(resolvedDbPath), { recursive: true });
+    const sqlite = new BetterSqlite3(resolvedDbPath);
+    sqliteVec.load(sqlite);
+    sqlite.pragma('journal_mode = DELETE');
+    sqlite.pragma('foreign_keys = ON');
+    const db = new Kysely({
+        dialect: new SqliteDialect({ database: sqlite })
+    });
+    await new MigrationManager(db, learningsMigrations).runMigrations();
+    return db;
+}
+/**
+ * Opens an existing learnings database for reading or writing.
+ * Throws a descriptive error (with the rebuild command) if the file does not exist.
+ */
+export function openLearningsDatabase(repoPath, options = {}) {
+    const dbPath = getLearningsDbPath(repoPath);
+    if (!fs.existsSync(dbPath)) {
+        throw new Error(`Missing ${dbPath}. Run "ivan learnings rebuild --repo ${path.resolve(repoPath)}" first.`);
+    }
+    const sqlite = new BetterSqlite3(dbPath, {
+        readonly: options.readonly ?? false,
+        fileMustExist: true
+    });
+    sqliteVec.load(sqlite);
+    sqlite.pragma('foreign_keys = ON');
+    return new Kysely({
+        dialect: new SqliteDialect({ database: sqlite })
+    });
+}
+/** Removes the `.db`, `.db-shm`, and `.db-wal` files if they exist (safe to call when none are present). */
+function removeLearningsDatabaseFiles(dbPath) {
+    for (const candidate of [dbPath, `${dbPath}-shm`, `${dbPath}-wal`]) {
+        if (fs.existsSync(candidate)) {
+            fs.unlinkSync(candidate);
+        }
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/learnings/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/learnings/database.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,uFAAuF;AACvF,yFAAyF;AAEzF,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,aAAa,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,KAAK,SAAS,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AA8BtE,0FAA0F;AAC1F,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,0BAA0B,CAAC,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,QAAgB,EAChB,MAAe;IAEf,MAAM,cAAc,GAAG,MAAM,IAAI,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9D,4BAA4B,CAAC,cAAc,CAAC,CAAC;IAE7C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,cAAc,CAAC,CAAC;IACjD,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IACvC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAEnC,MAAM,EAAE,GAAG,IAAI,MAAM,CAAoB;QACvC,OAAO,EAAE,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;KACjD,CAAC,CAAC;IACH,MAAM,IAAI,gBAAgB,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC,aAAa,EAAE,CAAC;IACpE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,UAAkC,EAAE;IAEpC,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,WAAW,MAAM,wCAAwC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAC1F,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE;QACvC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,KAAK;QACnC,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;IACH,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAEnC,OAAO,IAAI,MAAM,CAAoB;QACnC,OAAO,EAAE,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;KACjD,CAAC,CAAC;AACL,CAAC;AAED,4GAA4G;AAC5G,SAAS,4BAA4B,CAAC,MAAc;IAClD,KAAK,MAAM,SAAS,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC;QACnE,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/learnings/embeddings.d.ts

@@ -0,0 +1,20 @@
+import type { LearningRecord } from './record-types.js';
+export declare const EMBEDDING_MODEL = "text-embedding-3-small";
+export declare const EMBEDDING_DIMENSIONS = 1536;
+/**
+ * Returns the text string fed to the embedding model for a given learning.
+ * Exported so callers can SHA-256 hash it for cache invalidation without calling the API.
+ */
+export declare function buildEmbeddingInputString(learning: LearningRecord): string;
+/**
+ * Embeds a single text string. Used at query time to embed the search prompt.
+ * Requires OPENAI_API_KEY.
+ */
+export declare function embedText(text: string): Promise<number[]>;
+/**
+ * Embeds multiple texts in a single API call. Used during rebuild to batch all
+ * cache-missed learnings into one request.
+ * Requires OPENAI_API_KEY.
+ */
+export declare function embedTexts(texts: string[]): Promise<number[][]>;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/learnings/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/learnings/embeddings.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,eAAO,MAAM,eAAe,2BAA2B,CAAC;AACxD,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAQzC;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAU1E;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAM/D;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CASrE"}

package/dist/learnings/embeddings.js

@@ -0,0 +1,54 @@
+// Semantic text embedding using OpenAI text-embedding-3-small.
+// Requires OPENAI_API_KEY in the environment.
+// Embeddings are cached in JSONL source files so the API is only called once per record.
+import OpenAI from 'openai';
+export const EMBEDDING_MODEL = 'text-embedding-3-small';
+export const EMBEDDING_DIMENSIONS = 1536;
+let _client;
+function getClient() {
+    if (!_client)
+        _client = new OpenAI();
+    return _client;
+}
+/**
+ * Returns the text string fed to the embedding model for a given learning.
+ * Exported so callers can SHA-256 hash it for cache invalidation without calling the API.
+ */
+export function buildEmbeddingInputString(learning) {
+    const textParts = [
+        learning.kind,
+        learning.title,
+        learning.statement,
+        learning.rationale,
+        learning.applicability
+    ].filter(Boolean);
+    return textParts.join('\n');
+}
+/**
+ * Embeds a single text string. Used at query time to embed the search prompt.
+ * Requires OPENAI_API_KEY.
+ */
+export async function embedText(text) {
+    const response = await getClient().embeddings.create({
+        model: EMBEDDING_MODEL,
+        input: text
+    });
+    return response.data[0].embedding;
+}
+/**
+ * Embeds multiple texts in a single API call. Used during rebuild to batch all
+ * cache-missed learnings into one request.
+ * Requires OPENAI_API_KEY.
+ */
+export async function embedTexts(texts) {
+    if (texts.length === 0)
+        return [];
+    const response = await getClient().embeddings.create({
+        model: EMBEDDING_MODEL,
+        input: texts
+    });
+    return response.data
+        .sort((a, b) => a.index - b.index)
+        .map((d) => d.embedding);
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/learnings/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../../src/learnings/embeddings.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,8CAA8C;AAC9C,yFAAyF;AAEzF,OAAO,MAAM,MAAM,QAAQ,CAAC;AAG5B,MAAM,CAAC,MAAM,eAAe,GAAG,wBAAwB,CAAC;AACxD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAEzC,IAAI,OAA2B,CAAC;AAChC,SAAS,SAAS;IAChB,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,IAAI,MAAM,EAAE,CAAC;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAwB;IAChE,MAAM,SAAS,GAAG;QAChB,QAAQ,CAAC,IAAI;QACb,QAAQ,CAAC,KAAK;QACd,QAAQ,CAAC,SAAS;QAClB,QAAQ,CAAC,SAAS;QAClB,QAAQ,CAAC,aAAa;KACvB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY;IAC1C,MAAM,QAAQ,GAAG,MAAM,SAAS,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QACnD,KAAK,EAAE,eAAe;QACtB,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,KAAe;IAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,MAAM,SAAS,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QACnD,KAAK,EAAE,eAAe;QACtB,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI;SACjB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC"}

package/dist/learnings/evidence-writer.d.ts

@@ -0,0 +1,13 @@
+import type { EvidenceSignal, EvidenceContextCache } from './record-types.js';
+import type { GitHubPullRequestEvidence } from './github-evidence.js';
+/** Result of building signals from a PR payload. */
+export interface BuildSignalsResult {
+    signals: EvidenceSignal[];
+    contextCache: EvidenceContextCache;
+}
+/**
+ * Converts a `GitHubPullRequestEvidence` payload into lean `EvidenceSignal` objects
+ * and a parallel `EvidenceContextCache` mapping signal IDs to their in-memory content.
+ */
+export declare function buildEvidenceSignalsFromPullRequest(payload: GitHubPullRequestEvidence): BuildSignalsResult;
+//# sourceMappingURL=evidence-writer.d.ts.map

package/dist/learnings/evidence-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-writer.d.ts","sourceRoot":"","sources":["../../src/learnings/evidence-writer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,cAAc,EAEd,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAStE,oDAAoD;AACpD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,YAAY,EAAE,oBAAoB,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAyKpB"}

package/dist/learnings/evidence-writer.js

@@ -0,0 +1,182 @@
+// Builds in-memory EvidenceSignal objects from raw GitHub PR payloads.
+// Signals are purely in-memory — they flow through the extraction pipeline
+// and are never written to disk.
+import { createDeterministicId } from './id.js';
+import { inferAuthorFields, weightCheck, weightIssueComment, weightReview, weightReviewThread } from './weighting.js';
+/**
+ * Converts a `GitHubPullRequestEvidence` payload into lean `EvidenceSignal` objects
+ * and a parallel `EvidenceContextCache` mapping signal IDs to their in-memory content.
+ */
+export function buildEvidenceSignalsFromPullRequest(payload) {
+    const signals = [];
+    const contextCache = new Map();
+    const now = new Date().toISOString();
+    const baseExternalId = `github:${payload.repository.owner}/${payload.repository.name}:pr:${payload.pullRequest.number}`;
+    const parentUrl = payload.pullRequest.url;
+    // PR summary
+    {
+        const id = createDeterministicId('ev', `${baseExternalId}:summary`);
+        signals.push({
+            type: 'evidence',
+            id,
+            source_system: 'github',
+            source_type: 'pull_request',
+            external_url: payload.pullRequest.url,
+            ...(payload.pullRequest.author?.login && {
+                author_type: 'human',
+                author_name: payload.pullRequest.author.login
+            }),
+            base_weight: 5,
+            final_weight: 5,
+            boosts: ['pr_summary'],
+            penalties: [],
+            occurred_at: now,
+            created_at: now,
+            updated_at: now
+        });
+        contextCache.set(id, {
+            title: payload.pullRequest.title,
+            content: buildPullRequestSummaryBody(payload)
+        });
+    }
+    // Issue comments
+    for (const comment of payload.issueComments) {
+        const id = createDeterministicId('ev', `${baseExternalId}:issue-comment:${comment.id}`);
+        const weight = weightIssueComment(comment);
+        const author = inferAuthorFields(comment.author?.login);
+        signals.push({
+            type: 'evidence',
+            id,
+            source_system: 'github',
+            source_type: 'pr_issue_comment',
+            external_url: comment.url,
+            parent_url: parentUrl,
+            ...author,
+            base_weight: weight.baseWeight,
+            final_weight: weight.finalWeight,
+            boosts: weight.boosts,
+            penalties: weight.penalties,
+            occurred_at: comment.createdAt,
+            created_at: now,
+            updated_at: now
+        });
+        contextCache.set(id, {
+            title: `PR issue comment by ${comment.author?.login ?? 'unknown'}`,
+            content: comment.body.trim()
+        });
+    }
+    // Reviews
+    for (const review of payload.reviews) {
+        const id = createDeterministicId('ev', `${baseExternalId}:review:${review.id}`);
+        const weight = weightReview(review);
+        const author = inferAuthorFields(review.author?.login);
+        signals.push({
+            type: 'evidence',
+            id,
+            source_system: 'github',
+            source_type: 'pr_review',
+            external_url: review.url,
+            parent_url: parentUrl,
+            ...author,
+            base_weight: weight.baseWeight,
+            final_weight: weight.finalWeight,
+            boosts: weight.boosts,
+            penalties: weight.penalties,
+            occurred_at: review.submittedAt,
+            created_at: now,
+            updated_at: now
+        });
+        contextCache.set(id, {
+            title: `Review ${review.state} by ${review.author?.login ?? 'unknown'}`,
+            content: review.body.trim() || review.state
+        });
+    }
+    // Review threads
+    for (const thread of payload.reviewThreads) {
+        const firstComment = thread.comments[0];
+        if (!firstComment)
+            continue;
+        const threadId = thread.id ?? firstComment.id;
+        const id = createDeterministicId('ev', `${baseExternalId}:thread:${threadId}`);
+        const weight = weightReviewThread(thread);
+        const author = inferAuthorFields(firstComment.author?.login);
+        signals.push({
+            type: 'evidence',
+            id,
+            source_system: 'github',
+            source_type: 'pr_review_thread',
+            external_url: firstComment.url,
+            parent_url: parentUrl,
+            ...author,
+            base_weight: weight.baseWeight,
+            final_weight: weight.finalWeight,
+            boosts: weight.boosts,
+            penalties: weight.penalties,
+            occurred_at: firstComment.createdAt,
+            created_at: now,
+            updated_at: now
+        });
+        const context = {
+            title: buildThreadTitle(firstComment.path, firstComment.line),
+            content: firstComment.body.trim(),
+            file_path: firstComment.path,
+            line_start: firstComment.line,
+            line_end: firstComment.line,
+            diff_hunk: firstComment.diffHunk
+        };
+        contextCache.set(id, context);
+    }
+    // Checks
+    for (const check of payload.checks) {
+        const id = createDeterministicId('ev', `${baseExternalId}:check:${check.name}:${check.state}`);
+        const weight = weightCheck(check);
+        signals.push({
+            type: 'evidence',
+            id,
+            source_system: 'github',
+            source_type: 'pr_check',
+            external_url: check.link,
+            parent_url: parentUrl,
+            base_weight: weight.baseWeight,
+            final_weight: weight.finalWeight,
+            boosts: weight.boosts,
+            penalties: weight.penalties,
+            occurred_at: now,
+            created_at: now,
+            updated_at: now
+        });
+        contextCache.set(id, {
+            title: `Check ${check.state}: ${check.name}`,
+            content: `${check.name} -> ${check.state}`
+        });
+    }
+    return {
+        signals: signals.sort((left, right) => left.source_type.localeCompare(right.source_type)),
+        contextCache
+    };
+}
+/** Assembles a human-readable summary of the PR (number + title + body + changed files) as the evidence content. */
+function buildPullRequestSummaryBody(payload) {
+    const sections = [];
+    sections.push(`PR #${payload.pullRequest.number}: ${payload.pullRequest.title}`);
+    if (payload.pullRequest.body.trim()) {
+        sections.push(payload.pullRequest.body.trim());
+    }
+    if (payload.files.length > 0) {
+        sections.push(`Changed files:\n${payload.files
+            .map((file) => `- ${file.path}`)
+            .join('\n')}`);
+    }
+    return sections.join('\n\n');
+}
+/** Formats a human-readable title for a review thread, including file path and line number when available. */
+function buildThreadTitle(filePath, line) {
+    if (!filePath) {
+        return 'Review thread';
+    }
+    if (line === undefined) {
+        return `Review thread on ${filePath}`;
+    }
+    return `Review thread on ${filePath}:${line}`;
+}
+//# sourceMappingURL=evidence-writer.js.map