@ariso-ai/ivan 1.0.23 → 1.0.25

package/dist/learnings/ingest-repo-command.js

@@ -0,0 +1,62 @@
+// CLI handler for `ivan learnings ingest-repo`.
+// Fetches all PRs for a repo, builds signals in memory, then runs a single extract + rebuild pass.
+import chalk from 'chalk';
+import { extractLearningsFromEvidence } from './extractor.js';
+import { fetchAllPullRequestNumbers } from './github-evidence.js';
+import { fetchPullRequestSignals } from './github-ingestion.js';
+import { ensureLearningsDirectories, resolveLearningsRepositoryContext } from './repository.js';
+/** Commander action handler: lists all PRs, fetches signals for each, then runs a single extract + rebuild. */
+export async function runIngestRepoCommand(options) {
+    const limit = options.limit ? parseInt(options.limit, 10) : 100;
+    if (Number.isNaN(limit) || limit <= 0) {
+        throw new Error('Limit must be a positive integer');
+    }
+    const rawState = options.state ?? 'merged';
+    if (rawState !== 'open' &&
+        rawState !== 'closed' &&
+        rawState !== 'merged' &&
+        rawState !== 'all') {
+        throw new Error('State must be one of: open, closed, merged, all');
+    }
+    const state = rawState;
+    const context = resolveLearningsRepositoryContext(options.repo);
+    ensureLearningsDirectories(context);
+    console.log(chalk.gray(`Fetching PR list (state=${state}, limit=${limit})...`));
+    const prNumbers = await fetchAllPullRequestNumbers(options.repo, {
+        state,
+        limit
+    });
+    if (prNumbers.length === 0) {
+        console.log(chalk.yellow('No PRs found.'));
+        return;
+    }
+    console.log(chalk.gray(`Found ${prNumbers.length} PRs. Fetching signals...`));
+    const allSignals = [];
+    const mergedCache = new Map();
+    let failed = 0;
+    for (let i = 0; i < prNumbers.length; i++) {
+        const prNumber = prNumbers[i];
+        process.stdout.write(chalk.gray(`  [${i + 1}/${prNumbers.length}] PR #${prNumber}... `));
+        try {
+            const { signals, contextCache } = await fetchPullRequestSignals(options.repo, prNumber);
+            allSignals.push(...signals);
+            for (const [id, ctx] of contextCache) {
+                mergedCache.set(id, ctx);
+            }
+            process.stdout.write(chalk.green(`${signals.length} signals\n`));
+        }
+        catch (err) {
+            failed++;
+            process.stdout.write(chalk.red(`failed (${err.message})\n`));
+        }
+    }
+    if (failed > 0) {
+        console.log(chalk.yellow(`${failed} PRs failed and were skipped.`));
+    }
+    console.log(chalk.gray('Extracting learnings...'));
+    const extraction = await extractLearningsFromEvidence(options.repo, allSignals, mergedCache);
+    console.log(chalk.green('✅ Repo ingestion complete'));
+    console.log(chalk.gray(`Learnings: ${extraction.writtenLearningCount}`));
+    console.log(chalk.gray(`DB: ${extraction.rebuild.dbPath}`));
+}
+//# sourceMappingURL=ingest-repo-command.js.map

package/dist/learnings/ingest-repo-command.js.map

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

package/dist/learnings/init-command.d.ts

@@ -0,0 +1,15 @@
+interface InitCommandOptions {
+    repo: string;
+}
+/**
+ * Initialises the learnings store for `repoPath`: creates the `.ivan/` directory and canonical files.
+ */
+export declare function initLearningsStore(repoPath: string): {
+    createdDirectories: string[];
+    createdFiles: string[];
+    gitignoreUpdated: boolean;
+};
+/** Commander action handler: calls `initLearningsStore` and prints a formatted summary. */
+export declare function runInitCommand(options: InitCommandOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init-command.d.ts.map

package/dist/learnings/init-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-command.d.ts","sourceRoot":"","sources":["../../src/learnings/init-command.ts"],"names":[],"mappings":"AAWA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACpD,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,CAWA;AAED,2FAA2F;AAC3F,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/learnings/init-command.js

@@ -0,0 +1,36 @@
+// CLI handler for `ivan learnings init`.
+// Sets up the repo-local `.ivan/` structure. The derived SQLite file is tracked in git.
+import chalk from 'chalk';
+import { ensureCanonicalJsonlFiles, ensureGitignoreCoverage, ensureLearningsDirectories, resolveLearningsRepositoryContext } from './repository.js';
+/**
+ * Initialises the learnings store for `repoPath`: creates the `.ivan/` directory and canonical files.
+ */
+export function initLearningsStore(repoPath) {
+    const context = resolveLearningsRepositoryContext(repoPath);
+    const createdDirectories = ensureLearningsDirectories(context);
+    const createdFiles = ensureCanonicalJsonlFiles(context.repoPath);
+    const gitignoreUpdated = ensureGitignoreCoverage(context.repoPath);
+    return {
+        createdDirectories,
+        createdFiles,
+        gitignoreUpdated
+    };
+}
+/** Commander action handler: calls `initLearningsStore` and prints a formatted summary. */
+export async function runInitCommand(options) {
+    const result = initLearningsStore(options.repo);
+    console.log(chalk.green('✅ Learnings store initialized'));
+    if (result.createdDirectories.length > 0) {
+        console.log(chalk.gray('Created directories:'));
+        for (const directory of result.createdDirectories) {
+            console.log(chalk.gray(`  - ${directory}`));
+        }
+    }
+    if (result.createdFiles.length > 0) {
+        console.log(chalk.gray('Created files:'));
+        for (const filePath of result.createdFiles) {
+            console.log(chalk.gray(`  - ${filePath}`));
+        }
+    }
+}
+//# sourceMappingURL=init-command.js.map

package/dist/learnings/init-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-command.js","sourceRoot":"","sources":["../../src/learnings/init-command.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,wFAAwF;AAExF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,EAC1B,iCAAiC,EAClC,MAAM,iBAAiB,CAAC;AAMzB;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IAKjD,MAAM,OAAO,GAAG,iCAAiC,CAAC,QAAQ,CAAC,CAAC;IAC5D,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,yBAAyB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEnE,OAAO;QACL,kBAAkB;QAClB,YAAY;QACZ,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA2B;IAE3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;IAE1D,IAAI,MAAM,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAChD,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,SAAS,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC1C,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/learnings/install-hooks-command.d.ts

@@ -0,0 +1,17 @@
+interface InstallHooksCommandOptions {
+    repo: string;
+}
+/**
+ * Writes the two hook bash scripts, marks them executable, and upserts the hook entries
+ * into `.claude/settings.json`.  Safe to re-run; existing scripts and settings are replaced.
+ */
+export declare function installLearningsHooks(repoPath: string): {
+    settingsPath: string;
+    createdScripts: string[];
+    updatedScripts: boolean;
+    updatedSettings: boolean;
+};
+/** Commander action handler: calls `installLearningsHooks` and prints a formatted summary. */
+export declare function runInstallHooksCommand(options: InstallHooksCommandOptions): Promise<void>;
+export {};
+//# sourceMappingURL=install-hooks-command.d.ts.map

package/dist/learnings/install-hooks-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-hooks-command.d.ts","sourceRoot":"","sources":["../../src/learnings/install-hooks-command.ts"],"names":[],"mappings":"AASA,UAAU,0BAA0B;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AAqBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAmCA;AAED,8FAA8F;AAC9F,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/learnings/install-hooks-command.js

@@ -0,0 +1,241 @@
+// CLI handler for `ivan learnings install-hooks`.
+// Writes two bash scripts and wires them into `.claude/settings.json` so that
+// learnings are surfaced automatically on each prompt submission and tool use.
+import chalk from 'chalk';
+import { createHash } from 'crypto';
+import fs from 'fs';
+import path from 'path';
+/**
+ * Writes the two hook bash scripts, marks them executable, and upserts the hook entries
+ * into `.claude/settings.json`.  Safe to re-run; existing scripts and settings are replaced.
+ */
+export function installLearningsHooks(repoPath) {
+    const resolvedRepoPath = path.resolve(repoPath);
+    assertDirectoryExists(resolvedRepoPath);
+    const claudeDir = path.join(resolvedRepoPath, '.claude');
+    const hooksDir = path.join(claudeDir, 'hooks');
+    const logsDir = path.join(hooksDir, 'logs');
+    fs.mkdirSync(logsDir, { recursive: true });
+    const userPromptScriptPath = path.join(hooksDir, 'ivan-learnings-user-prompt.sh');
+    const postEditScriptPath = path.join(hooksDir, 'ivan-learnings-post-edit.sh');
+    const updatedScripts = writeScriptIfChanged(userPromptScriptPath, buildUserPromptScript());
+    writeScriptIfChanged(postEditScriptPath, buildPostEditScript());
+    const settingsPath = path.join(claudeDir, 'settings.json');
+    removeStaleHookFiles(hooksDir);
+    const updatedSettings = upsertClaudeSettings(settingsPath, resolvedRepoPath, {
+        userPromptScriptPath,
+        postEditScriptPath
+    });
+    return {
+        settingsPath,
+        createdScripts: [userPromptScriptPath, postEditScriptPath],
+        updatedScripts,
+        updatedSettings
+    };
+}
+/** Commander action handler: calls `installLearningsHooks` and prints a formatted summary. */
+export async function runInstallHooksCommand(options) {
+    const result = installLearningsHooks(options.repo);
+    console.log(chalk.green('✅ Claude hook integration installed'));
+    console.log(chalk.gray('Installed hooks: UserPromptSubmit, PostToolUse(Edit|Write|MultiEdit)'));
+    console.log(chalk.gray(`Settings file: ${result.settingsPath}`));
+    console.log(chalk.gray('Hook scripts:'));
+    for (const scriptPath of result.createdScripts) {
+        console.log(chalk.gray(`  - ${scriptPath}`));
+    }
+    console.log(chalk.gray(result.updatedScripts
+        ? 'Updated hook scripts'
+        : 'Hook scripts already up to date'));
+    console.log(chalk.gray(result.updatedSettings
+        ? 'Updated .claude/settings.json with Ivan learnings hooks'
+        : '.claude/settings.json already matched the Ivan learnings hooks'));
+}
+/**
+ * Reads `.claude/settings.json`, merges the two hook entries (replacing any existing
+ * ivan-learnings hooks by script name), and writes the file only if the content changed.
+ * Returns true when the file was written.
+ */
+/**
+ * Writes `content` to `scriptPath` only when the file is absent or its content
+ * differs. Marks the file executable. Returns true if the file was written.
+ */
+function sha256(content) {
+    return createHash('sha256').update(content, 'utf8').digest('hex');
+}
+function writeScriptIfChanged(scriptPath, content) {
+    if (fs.existsSync(scriptPath)) {
+        const existingHash = sha256(fs.readFileSync(scriptPath, 'utf8'));
+        if (existingHash === sha256(content)) {
+            return false;
+        }
+    }
+    fs.writeFileSync(scriptPath, content, 'utf8');
+    fs.chmodSync(scriptPath, 0o755);
+    return true;
+}
+function upsertClaudeSettings(settingsPath, repoPath, scriptPaths) {
+    const existingSettings = readClaudeSettings(settingsPath);
+    const existingHooks = existingSettings.hooks ?? {};
+    const nextSettings = {
+        ...existingSettings,
+        hooks: { ...existingHooks }
+    };
+    const userPromptCommand = buildHookCommand(repoPath, scriptPaths.userPromptScriptPath);
+    const postEditCommand = buildHookCommand(repoPath, scriptPaths.postEditScriptPath);
+    const updatedHooks = {
+        ...existingHooks,
+        UserPromptSubmit: upsertHookEntry(existingHooks.UserPromptSubmit ?? [], {
+            hooks: [{ type: 'command', command: userPromptCommand, timeout: 10 }]
+        }, ['ivan-learnings-user-prompt.sh']),
+        PostToolUse: upsertHookEntry(existingHooks.PostToolUse ?? [], {
+            matcher: 'Edit|Write|MultiEdit',
+            hooks: [{ type: 'command', command: postEditCommand, timeout: 10 }]
+        }, ['ivan-learnings-post-edit.sh'])
+    };
+    // Remove any stale Stop hook entries that reference ivan-learnings
+    if (updatedHooks.Stop) {
+        const filtered = updatedHooks.Stop.filter((entry) => !entry.hooks.some((hook) => hook.command.includes('ivan-learnings')));
+        if (filtered.length === 0) {
+            delete updatedHooks.Stop;
+        }
+        else {
+            updatedHooks.Stop = filtered;
+        }
+    }
+    nextSettings.hooks = updatedHooks;
+    const previous = JSON.stringify(existingSettings, null, 2);
+    const next = `${JSON.stringify(nextSettings, null, 2)}\n`;
+    if (previous === next.trimEnd()) {
+        return false;
+    }
+    fs.writeFileSync(settingsPath, next, 'utf8');
+    return true;
+}
+/**
+ * Removes any existing hook entries whose command contains one of `scriptNameMarkers`,
+ * then appends `nextEntry`.  This ensures exactly one ivan-learnings entry per hook type.
+ */
+function upsertHookEntry(existingEntries, nextEntry, scriptNameMarkers) {
+    const filtered = existingEntries.filter((entry) => !entry.hooks.some((hook) => scriptNameMarkers.some((marker) => hook.command.includes(marker))));
+    filtered.push(nextEntry);
+    return filtered;
+}
+/** Reads and parses `.claude/settings.json`; returns an empty object if the file is absent or empty. */
+function readClaudeSettings(settingsPath) {
+    if (!fs.existsSync(settingsPath)) {
+        return {};
+    }
+    const raw = fs.readFileSync(settingsPath, 'utf8').trim();
+    if (!raw) {
+        return {};
+    }
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`Expected ${settingsPath} to contain a JSON object`);
+    }
+    return parsed;
+}
+/**
+ * Builds the hook command string using a `$CLAUDE_PROJECT_DIR`-relative path so that
+ * the committed settings.json works on any machine without hardcoded absolute paths.
+ */
+function buildHookCommand(repoPath, scriptPath) {
+    const relative = path.relative(repoPath, scriptPath);
+    return `bash "$CLAUDE_PROJECT_DIR/${relative}"`;
+}
+/** Generates the `UserPromptSubmit` hook script that queries learnings using the user's prompt text. */
+function buildUserPromptScript() {
+    return `#!/usr/bin/env bash
+set -uo pipefail
+
+ivan_entry="$(command -v ivan || true)"
+
+payload="$(mktemp)"
+trap 'rm -f "$payload"' EXIT
+cat > "$payload"
+
+project_dir="\${CLAUDE_PROJECT_DIR:-$(jq -r '.cwd // empty' "$payload")}"
+if [[ -z "$project_dir" ]]; then
+  exit 0
+fi
+if [[ -z "$ivan_entry" ]]; then
+  exit 0
+fi
+log_dir="$project_dir/.claude/hooks/logs"
+mkdir -p "$log_dir"
+
+repo="$(jq -r '.cwd // empty' "$payload")"
+prompt="$(jq -r '.prompt // empty' "$payload")"
+
+if [[ -z "$repo" || -z "$prompt" ]]; then
+  exit 0
+fi
+
+output="$("$ivan_entry" learnings query --repo "$repo" --text "$prompt" --limit 3 2>>"$log_dir/query.stderr")" || true
+
+if [[ -z "$output" || "$output" == *"No learnings matched that query."* ]]; then
+  exit 0
+fi
+
+printf 'Local learnings relevant to this prompt:\\n%s\\n' "$output"
+`;
+}
+/** Generates the `PostToolUse` hook script that queries learnings after each Edit/Write/MultiEdit tool call. */
+function buildPostEditScript() {
+    return `#!/usr/bin/env bash
+set -uo pipefail
+
+ivan_entry="$(command -v ivan || true)"
+
+payload="$(mktemp)"
+trap 'rm -f "$payload"' EXIT
+cat > "$payload"
+
+project_dir="\${CLAUDE_PROJECT_DIR:-$(jq -r '.cwd // empty' "$payload")}"
+if [[ -z "$project_dir" ]]; then
+  exit 0
+fi
+if [[ -z "$ivan_entry" ]]; then
+  exit 0
+fi
+log_dir="$project_dir/.claude/hooks/logs"
+mkdir -p "$log_dir"
+
+repo="$(jq -r '.cwd // empty' "$payload")"
+tool_name="$(jq -r '.tool_name // empty' "$payload")"
+tool_input="$(jq -c '.tool_input // {}' "$payload")"
+
+if [[ -z "$repo" || -z "$tool_name" ]]; then
+  exit 0
+fi
+
+query_text="recent file changes after tool: $tool_name; input: $tool_input"
+
+output="$("$ivan_entry" learnings query --repo "$repo" --text "$query_text" --limit 3 2>>"$log_dir/query.stderr")" || true
+
+if [[ -z "$output" || "$output" == *"No learnings matched that query."* ]]; then
+  exit 0
+fi
+
+printf 'Local learnings relevant after edit:\\n%s\\n' "$output"
+`;
+}
+/** Deletes stale hook files that are no longer managed by install-hooks (e.g. ivan-learnings-stop.sh). */
+function removeStaleHookFiles(hooksDir) {
+    const stale = ['ivan-learnings-stop.sh'];
+    for (const name of stale) {
+        const filePath = path.join(hooksDir, name);
+        if (fs.existsSync(filePath)) {
+            fs.unlinkSync(filePath);
+        }
+    }
+}
+function assertDirectoryExists(repoPath) {
+    if (!fs.existsSync(repoPath)) {
+        throw new Error(`Repository path does not exist: ${repoPath}`);
+    }
+    if (!fs.statSync(repoPath).isDirectory()) {
+        throw new Error(`Repository path is not a directory: ${repoPath}`);
+    }
+}
+//# sourceMappingURL=install-hooks-command.js.map

package/dist/learnings/install-hooks-command.js.map

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

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

@@ -0,0 +1,6 @@
+import type { LearningRecord } from './record-types.js';
+/**
+ * Replaces this repository's records inside `.ivan/lessons.jsonl` and returns the `{file}#L{n}` paths.
+ */
+export declare function writeLearningRecords(repoPath: string, records: LearningRecord[]): string[];
+//# sourceMappingURL=learning-writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"learning-writer.d.ts","sourceRoot":"","sources":["../../src/learnings/learning-writer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EAAE,GACxB,MAAM,EAAE,CAYV"}

package/dist/learnings/learning-writer.js

@@ -0,0 +1,42 @@
+// Persists extracted LearningRecord objects to `.ivan/lessons.jsonl`.
+// This is a full-replace write: the entire file is rewritten on each call.
+import fs from 'fs';
+import { LESSONS_JSONL_RELATIVE_PATH, resolveCanonicalLearningsPath } from './paths.js';
+/**
+ * Replaces this repository's records inside `.ivan/lessons.jsonl` and returns the `{file}#L{n}` paths.
+ */
+export function writeLearningRecords(repoPath, records) {
+    const filePath = resolveCanonicalLearningsPath(repoPath, 'lessons.jsonl');
+    const normalizedRecords = [...records]
+        .sort((left, right) => left.id.localeCompare(right.id))
+        .map((record) => ({ ...record, sourcePath: learningSourcePath() }));
+    const nextContent = normalizedRecords
+        .map((record) => `${JSON.stringify(serializeLearningRecord(record))}\n`)
+        .join('');
+    fs.writeFileSync(filePath, nextContent, 'utf8');
+    return normalizedRecords.map((_, index) => `${filePath}#L${index + 1}`);
+}
+/** Produces the plain-object form of a `LearningRecord` for JSON serialization, omitting `type` and `sourcePath`. */
+function serializeLearningRecord(record) {
+    return {
+        id: record.id,
+        kind: record.kind,
+        statement: record.statement,
+        status: record.status,
+        created_at: record.created_at,
+        updated_at: record.updated_at,
+        source_type: record.source_type,
+        source_url: record.source_url,
+        title: record.title,
+        rationale: record.rationale,
+        applicability: record.applicability,
+        confidence: record.confidence,
+        embedding: record.embedding,
+        embeddingInputHash: record.embeddingInputHash
+    };
+}
+/** Returns the canonical relative path for the lessons JSONL file (without a line number). */
+function learningSourcePath() {
+    return LESSONS_JSONL_RELATIVE_PATH;
+}
+//# sourceMappingURL=learning-writer.js.map

package/dist/learnings/learning-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-writer.js","sourceRoot":"","sources":["../../src/learnings/learning-writer.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,2EAA2E;AAE3E,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,OAAyB;IAEzB,MAAM,QAAQ,GAAG,6BAA6B,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC1E,MAAM,iBAAiB,GAAG,CAAC,GAAG,OAAO,CAAC;SACnC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;SACtD,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC,CAAC;IAEtE,MAAM,WAAW,GAAG,iBAAiB;SAClC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;SACvE,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAEhD,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,QAAQ,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,qHAAqH;AACrH,SAAS,uBAAuB,CAC9B,MAAsB;IAEtB,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;KAC9C,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,SAAS,kBAAkB;IACzB,OAAO,2BAA2B,CAAC;AACrC,CAAC"}

package/dist/learnings/parser.d.ts

@@ -0,0 +1,12 @@
+import type { LearningsDataset } from './record-types.js';
+/** Reads and sorts the canonical lessons JSONL for `repoPath`, returning a `LearningsDataset`. */
+export declare function loadCanonicalRecords(repoPath: string): LearningsDataset;
+/** Comparator that orders by `sourcePath` first, then `id`, both lexicographically. */
+export declare function sortByPathThenId(left: {
+    sourcePath: string;
+    id: string;
+}, right: {
+    sourcePath: string;
+    id: string;
+}): number;
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/learnings/parser.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,mBAAmB,CAAC;AAI1E,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAKvE;AAqJD,uFAAuF;AACvF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EACxC,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxC,MAAM,CAKR"}

package/dist/learnings/parser.js

@@ -0,0 +1,133 @@
+// Reads the canonical JSONL file from a repository's `.ivan/` directory and
+// deserializes it into typed in-memory records.  The parser is additive: missing
+// optional fields are silently dropped rather than treated as errors.
+import fs from 'fs';
+import path from 'path';
+import { resolveCanonicalLearningsPath } from './paths.js';
+/** Reads and sorts the canonical lessons JSONL for `repoPath`, returning a `LearningsDataset`. */
+export function loadCanonicalRecords(repoPath) {
+    const resolvedRepoPath = path.resolve(repoPath);
+    return {
+        learnings: readLearningRecords(resolvedRepoPath).sort(sortByPathThenId)
+    };
+}
+/** Reads `.ivan/lessons.jsonl` and parses it into `LearningRecord[]`. */
+function readLearningRecords(repoPath) {
+    const filePath = resolveCanonicalLearningsPath(repoPath, 'lessons.jsonl');
+    return readJsonlFile(filePath, repoPath, (sourcePath, record) => ({
+        type: 'learning',
+        sourcePath,
+        id: getRequiredString(record, 'id', sourcePath),
+        kind: getRequiredString(record, 'kind', sourcePath),
+        statement: getRequiredString(record, 'statement', sourcePath),
+        status: getOptionalString(record, 'status') ?? 'active',
+        tags: getStringArray(record, 'tags'),
+        created_at: getRequiredString(record, 'created_at', sourcePath),
+        updated_at: getRequiredString(record, 'updated_at', sourcePath),
+        ...omitUndefined({
+            source_type: getOptionalString(record, 'source_type'),
+            source_url: getOptionalString(record, 'source_url'),
+            title: getOptionalString(record, 'title'),
+            rationale: getOptionalString(record, 'rationale'),
+            applicability: getOptionalString(record, 'applicability'),
+            confidence: getOptionalNumber(record, 'confidence'),
+            embedding: getOptionalNumberArray(record, 'embedding'),
+            embeddingInputHash: getOptionalString(record, 'embeddingInputHash')
+        })
+    }));
+}
+/**
+ * Reads a JSONL file line by line, calls `parser` with a `{file}#L{n}` source path per line,
+ * and accumulates results.  Empty lines and absent files are silently skipped.
+ */
+function readJsonlFile(filePath, repoPath, parser) {
+    if (!fs.existsSync(filePath)) {
+        return [];
+    }
+    const sourceFile = toCanonicalPath(repoPath, filePath);
+    const lines = fs.readFileSync(filePath, 'utf8').split('\n');
+    const records = [];
+    for (let index = 0; index < lines.length; index += 1) {
+        const rawLine = lines[index].trim();
+        if (!rawLine) {
+            continue;
+        }
+        const parsed = JSON.parse(rawLine);
+        records.push(parser(`${sourceFile}#L${index + 1}`, parsed));
+    }
+    return records;
+}
+/** Reads a string field that must be present and non-empty; throws with `sourcePath` context if missing. */
+function getRequiredString(record, key, sourcePath) {
+    const value = getOptionalString(record, key);
+    if (!value) {
+        throw new Error(`Missing required field "${key}" in ${sourcePath}`);
+    }
+    return value;
+}
+/** Returns a trimmed string value or `undefined` when the field is absent, null, an array, or blank. */
+function getOptionalString(record, key) {
+    const value = record[key];
+    if (value === undefined || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    return String(value).trim() || undefined;
+}
+/** Coerces a JSON value to a number; returns `undefined` for absent, null, blank, or non-finite values. */
+function getOptionalNumber(record, key) {
+    const value = record[key];
+    if (value === undefined || value === null || Array.isArray(value)) {
+        return undefined;
+    }
+    if (typeof value === 'number') {
+        return Number.isFinite(value) ? value : undefined;
+    }
+    const str = String(value).trim();
+    if (str === '') {
+        return undefined;
+    }
+    const parsed = Number(str);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+/** Returns a `number[]` from a JSON field, or `undefined` when the field is absent or null. */
+function getOptionalNumberArray(record, key) {
+    const value = record[key];
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (!Array.isArray(value)) {
+        return undefined;
+    }
+    return value.map((item) => (typeof item === 'number' ? item : Number(item)));
+}
+/** Returns a `string[]` from a JSON field, gracefully handling missing, scalar, or array values. */
+function getStringArray(record, key) {
+    const value = record[key];
+    if (value === undefined || value === null || value === '') {
+        return [];
+    }
+    if (!Array.isArray(value)) {
+        return [String(value).trim()].filter(Boolean);
+    }
+    return value.map((item) => String(item).trim()).filter(Boolean);
+}
+/** Converts an absolute file path to a forward-slash relative path from `repoPath`. */
+function toCanonicalPath(repoPath, filePath) {
+    return path.relative(repoPath, filePath).split(path.sep).join('/');
+}
+/** Comparator that orders by `sourcePath` first, then `id`, both lexicographically. */
+export function sortByPathThenId(left, right) {
+    return (left.sourcePath.localeCompare(right.sourcePath) ||
+        left.id.localeCompare(right.id));
+}
+/** Returns a copy of `obj` with all `undefined` values removed. */
+function omitUndefined(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=parser.js.map

package/dist/learnings/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/learnings/parser.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,iFAAiF;AACjF,sEAAsE;AAEtE,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAK3D,kGAAkG;AAClG,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO;QACL,SAAS,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;KACxE,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,MAAM,QAAQ,GAAG,6BAA6B,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC1E,OAAO,aAAa,CAClB,QAAQ,EACR,QAAQ,EACR,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CACrB,CAAC;QACC,IAAI,EAAE,UAAmB;QACzB,UAAU;QACV,EAAE,EAAE,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC;QAC/C,IAAI,EAAE,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC;QACnD,SAAS,EAAE,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC;QAC7D,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,QAAQ;QACvD,IAAI,EAAE,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC;QACpC,UAAU,EAAE,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC;QAC/D,UAAU,EAAE,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,CAAC;QAC/D,GAAG,aAAa,CAAC;YACf,WAAW,EAAE,iBAAiB,CAAC,MAAM,EAAE,aAAa,CAAC;YACrD,UAAU,EAAE,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC;YACnD,KAAK,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC;YACzC,SAAS,EAAE,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC;YACjD,aAAa,EAAE,iBAAiB,CAAC,MAAM,EAAE,eAAe,CAAC;YACzD,UAAU,EAAE,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC;YACnD,SAAS,EAAE,sBAAsB,CAAC,MAAM,EAAE,WAAW,CAAC;YACtD,kBAAkB,EAAE,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,CAAC;SACpE,CAAC;KACH,CAAmB,CACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CACpB,QAAgB,EAChB,QAAgB,EAChB,MAAsD;IAEtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,UAAU,GAAG,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAgB,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,UAAU,KAAK,KAAK,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4GAA4G;AAC5G,SAAS,iBAAiB,CACxB,MAAmB,EACnB,GAAW,EACX,UAAkB;IAElB,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,QAAQ,UAAU,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wGAAwG;AACxG,SAAS,iBAAiB,CACxB,MAAmB,EACnB,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AAC3C,CAAC;AAED,2GAA2G;AAC3G,SAAS,iBAAiB,CACxB,MAAmB,EACnB,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,+FAA+F;AAC/F,SAAS,sBAAsB,CAC7B,MAAmB,EACnB,GAAW;IAEX,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,oGAAoG;AACpG,SAAS,cAAc,CAAC,MAAmB,EAAE,GAAW;IACtD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAClE,CAAC;AAED,uFAAuF;AACvF,SAAS,eAAe,CAAC,QAAgB,EAAE,QAAgB;IACzD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrE,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAC9B,IAAwC,EACxC,KAAyC;IAEzC,OAAO,CACL,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC;QAC/C,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,SAAS,aAAa,CAAoC,GAAM;IAC9D,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACvB,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/learnings/paths.d.ts

@@ -0,0 +1,6 @@
+export declare const CANONICAL_LEARNINGS_ROOT = ".ivan";
+export declare const LESSONS_JSONL_RELATIVE_PATH = ".ivan/lessons.jsonl";
+export declare const LEARNINGS_DB_RELATIVE_PATH = ".ivan/db.sqlite";
+export declare function canonicalLearningsPath(...segments: string[]): string;
+export declare function resolveCanonicalLearningsPath(repoPath: string, ...segments: string[]): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/learnings/paths.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,UAAU,CAAC;AAChD,eAAO,MAAM,2BAA2B,wBAA8C,CAAC;AACvF,eAAO,MAAM,0BAA0B,oBAA0C,CAAC;AAElF,wBAAgB,sBAAsB,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEpE;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,MAAM,EAChB,GAAG,QAAQ,EAAE,MAAM,EAAE,GACpB,MAAM,CAER"}