@ariso-ai/ivan 1.0.24 → 1.0.26

package/dist/learnings/paths.js

@@ -0,0 +1,11 @@
+import path from 'path';
+export const CANONICAL_LEARNINGS_ROOT = '.ivan';
+export const LESSONS_JSONL_RELATIVE_PATH = `${CANONICAL_LEARNINGS_ROOT}/lessons.jsonl`;
+export const LEARNINGS_DB_RELATIVE_PATH = `${CANONICAL_LEARNINGS_ROOT}/db.sqlite`;
+export function canonicalLearningsPath(...segments) {
+    return path.posix.join(CANONICAL_LEARNINGS_ROOT, ...segments);
+}
+export function resolveCanonicalLearningsPath(repoPath, ...segments) {
+    return path.join(path.resolve(repoPath), '.ivan', ...segments);
+}
+//# sourceMappingURL=paths.js.map

package/dist/learnings/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/learnings/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAChD,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,wBAAwB,gBAAgB,CAAC;AACvF,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,wBAAwB,YAAY,CAAC;AAElF,MAAM,UAAU,sBAAsB,CAAC,GAAG,QAAkB;IAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,EAAE,GAAG,QAAQ,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,QAAgB,EAChB,GAAG,QAAkB;IAErB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;AACjE,CAAC"}

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

@@ -0,0 +1,9 @@
+interface QueryCommandOptions {
+    repo: string;
+    text: string;
+    limit?: string;
+}
+/** Commander action handler: validates options, calls `queryLearnings`, and pretty-prints results. */
+export declare function runQueryCommand(options: QueryCommandOptions): Promise<void>;
+export {};
+//# sourceMappingURL=query-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-command.d.ts","sourceRoot":"","sources":["../../src/learnings/query-command.ts"],"names":[],"mappings":"AAMA,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sGAAsG;AACtG,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/learnings/query-command.js

@@ -0,0 +1,37 @@
+// CLI handler for `ivan learnings query`.
+// Searches the local `.ivan/db.sqlite` and prints each result with statement, metadata, and evidence links.
+import chalk from 'chalk';
+import { queryLearnings } from './query.js';
+/** Commander action handler: validates options, calls `queryLearnings`, and pretty-prints results. */
+export async function runQueryCommand(options) {
+    const limit = options.limit ? parseInt(options.limit, 10) : 5;
+    if (Number.isNaN(limit) || limit <= 0) {
+        throw new Error('Query limit must be a positive integer');
+    }
+    const results = await queryLearnings(options.repo, options.text, { limit });
+    if (results.length === 0) {
+        console.log(chalk.yellow('No learnings matched that query.'));
+        return;
+    }
+    results.forEach((result, index) => {
+        console.log(chalk.cyan(`${index + 1}. ${result.statement}`));
+        const metadata = [`id=${result.id}`, `kind=${result.kind}`];
+        if (result.confidence !== undefined) {
+            metadata.push(`confidence=${result.confidence.toFixed(2)}`);
+        }
+        console.log(chalk.gray(`   ${metadata.join(' | ')}`));
+        if (result.rationale) {
+            console.log(chalk.gray(`   Rationale: ${result.rationale}`));
+        }
+        if (result.applicability) {
+            console.log(chalk.gray(`   Applicability: ${result.applicability}`));
+        }
+        if (result.source_url) {
+            console.log(chalk.gray(`   Source: ${result.source_url}`));
+        }
+        if (index < results.length - 1) {
+            console.log('');
+        }
+    });
+}
+//# sourceMappingURL=query-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-command.js","sourceRoot":"","sources":["../../src/learnings/query-command.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,4GAA4G;AAE5G,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQ5C,sGAAsG;AACtG,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA4B;IAE5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAE5E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAE7D,MAAM,QAAQ,GAAG,CAAC,MAAM,MAAM,CAAC,EAAE,EAAE,EAAE,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAEtD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QACvE,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/learnings/query.d.ts

@@ -0,0 +1,7 @@
+import type { LearningsQueryResult, LearningsSearchOptions } from './types.js';
+/**
+ * Searches the learnings database for records relevant to `text`.
+ * Opens the DB read-only and closes it before returning.
+ */
+export declare function queryLearnings(repoPath: string, text: string, options?: LearningsSearchOptions): Promise<LearningsQueryResult[]>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/learnings/query.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAmB/E;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA4BjC"}

package/dist/learnings/query.js

@@ -0,0 +1,65 @@
+// Vector search over the learnings SQLite database.
+import { sql } from 'kysely';
+import { openLearningsDatabase } from './database.js';
+import { embedText } from './embeddings.js';
+const MIN_VECTOR_SIMILARITY = 0.12;
+/**
+ * Searches the learnings database for records relevant to `text`.
+ * Opens the DB read-only and closes it before returning.
+ */
+export async function queryLearnings(repoPath, text, options = {}) {
+    const searchText = text.trim();
+    if (!searchText) {
+        throw new Error('Query text must not be empty');
+    }
+    const db = openLearningsDatabase(repoPath, { readonly: true });
+    try {
+        const rawLimit = options.limit ?? 5;
+        const limit = Number.isFinite(rawLimit) && rawLimit > 0 ? Math.min(rawLimit, 100) : 5;
+        const vectorRows = await runVectorSearch(db, searchText, limit);
+        return vectorRows.map(({ distance: _distance, ...row }) => ({
+            id: row.id,
+            kind: row.kind,
+            statement: row.statement,
+            status: row.status,
+            title: row.title ?? undefined,
+            rationale: row.rationale ?? undefined,
+            applicability: row.applicability ?? undefined,
+            confidence: row.confidence ?? undefined,
+            source_url: row.source_url ?? undefined
+        }));
+    }
+    finally {
+        await db.destroy();
+    }
+}
+async function runVectorSearch(db, text, limit) {
+    let queryVector;
+    try {
+        queryVector = Buffer.from(new Float32Array(await embedText(text)).buffer);
+    }
+    catch {
+        return [];
+    }
+    const { rows } = await sql `
+    SELECT
+      l.id,
+      l.title,
+      l.kind,
+      l.statement,
+      l.rationale,
+      l.applicability,
+      l.confidence,
+      l.status,
+      l.source_url,
+      distance
+    FROM learning_vectors lv
+    INNER JOIN learnings l ON l.id = lv.learning_id
+    WHERE lv.vector MATCH ${queryVector}
+      AND k = ${limit}
+      AND l.status = 'active'
+    ORDER BY distance
+  `.execute(db);
+    return rows.filter((row) => Number.isFinite(row.distance) && 1 - row.distance >= MIN_VECTOR_SIMILARITY);
+}
+//# sourceMappingURL=query.js.map

package/dist/learnings/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/learnings/query.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAA0B,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAkB5C,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAgB,EAChB,IAAY,EACZ,UAAkC,EAAE;IAEpC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,EAAE,GAAG,qBAAqB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACpC,MAAM,KAAK,GACT,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;QAEhE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1D,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS;YAC7B,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;YACrC,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,SAAS;YAC7C,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,SAAS;YACvC,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,SAAS;SACxC,CAAC,CAAC,CAAC;IACN,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,EAA6B,EAC7B,IAAY,EACZ,KAAa;IAEb,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAmB;;;;;;;;;;;;;;4BAcnB,WAAW;gBACvB,KAAK;;;GAGlB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEd,OAAO,IAAI,CAAC,MAAM,CAChB,CAAC,GAAG,EAAE,EAAE,CACN,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,QAAQ,IAAI,qBAAqB,CAC7E,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+interface RebuildCommandOptions {
+    repo: string;
+    ifStale?: boolean;
+}
+/** Commander action handler: calls `rebuildLearningsDatabase` and prints record counts. */
+export declare function runRebuildCommand(options: RebuildCommandOptions): Promise<void>;
+export {};
+//# sourceMappingURL=rebuild-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild-command.d.ts","sourceRoot":"","sources":["../../src/learnings/rebuild-command.ts"],"names":[],"mappings":"AASA,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,2FAA2F;AAC3F,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/learnings/rebuild-command.js

@@ -0,0 +1,16 @@
+// CLI handler for `ivan learnings rebuild`.
+// Drops and recreates `.ivan/db.sqlite` from the canonical JSONL files without touching GitHub.
+import chalk from 'chalk';
+import { isLearningsDatabaseStale, rebuildLearningsDatabase } from './builder.js';
+/** Commander action handler: calls `rebuildLearningsDatabase` and prints record counts. */
+export async function runRebuildCommand(options) {
+    if (options.ifStale && !(await isLearningsDatabaseStale(options.repo))) {
+        console.log(chalk.gray('.ivan/db.sqlite is up to date'));
+        return;
+    }
+    const result = await rebuildLearningsDatabase(options.repo);
+    console.log(chalk.green('✅ Learnings database rebuilt'));
+    console.log(chalk.gray(`DB: ${result.dbPath}`));
+    console.log(chalk.gray(`Learnings: ${result.learningCount}`));
+}
+//# sourceMappingURL=rebuild-command.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild-command.js","sourceRoot":"","sources":["../../src/learnings/rebuild-command.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,gGAAgG;AAEhG,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,cAAc,CAAC;AAOtB,2FAA2F;AAC3F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAA8B;IAE9B,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,wBAAwB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/learnings/record-types.d.ts

@@ -0,0 +1,98 @@
+/** Shared fields present on every record in the learnings store. */
+export interface CanonicalRecord {
+    id: string;
+    type: 'evidence' | 'learning';
+    created_at: string;
+    updated_at: string;
+}
+/** In-memory signal derived from a GitHub PR payload. Never written to disk. */
+export interface EvidenceSignal extends CanonicalRecord {
+    type: 'evidence';
+    source_system: string;
+    /** Narrows the evidence kind: `pull_request`, `pr_review_thread`, `pr_review`, `pr_issue_comment`, `pr_check`. */
+    source_type: string;
+    external_url?: string;
+    parent_url?: string;
+    author_name?: string;
+    author_type?: string;
+    occurred_at?: string;
+    /**
+     * Raw weight assigned by evidence type before boosts or penalties.
+     * See `weighting.ts` for the scoring functions that produce these values.
+     *
+     * | source_type / condition              | base_weight | Notes                              |
+     * |--------------------------------------|-------------|------------------------------------|
+     * | pr_review (CHANGES_REQUESTED)        | 6           | Actionable feedback                |
+     * | pr_review_thread (unresolved)        | 5           | Still-open issue                   |
+     * | pr_check (failure / error)           | 4           | CI failure signal                  |
+     * | pr_review_thread (resolved)          | 3           | Addressed inline thread            |
+     * | pr_issue_comment                     | 3           | General PR discussion              |
+     * | pr_review (APPROVED / COMMENTED)     | 2           | Verdict without actionable content |
+     * | pr_check (passing)                   | 1           | Low signal; not extracted          |
+     */
+    base_weight?: number;
+    /**
+     * Final weight after applying boosts and penalties.
+     * Evidence is extracted into a learning when `final_weight >= 3` (see `extractor.ts`).
+     * Confidence is derived as `0.35 + min(final_weight, 12) / 20` → [0.35, 0.95].
+     *
+     * **Boosts** (added to `base_weight`)
+     * | Label                  | Condition                                          |
+     * |------------------------|----------------------------------------------------|
+     * | `changes_requested`    | Review state is CHANGES_REQUESTED                  |
+     * | `approved`             | Review state is APPROVED                           |
+     * | `unresolved_thread`    | Review thread is not yet resolved                  |
+     * | `inline_code_comment`  | Thread is diff-anchored (has a file path)          |
+     *
+     * **Penalties** (subtracted from `base_weight`, floored at 0)
+     * | Label                  | Δ  | Condition                                        |
+     * |------------------------|----|--------------------------------------------------|
+     * | `low_signal_text`      | −2 | Body starts with `nit:`, `style:`, or `typo:`   |
+     * | `outdated_thread`      | —  | Thread marked outdated (label only, no Δ)        |
+     * | `review_comment_only`  | —  | Review state is COMMENTED (label only, no Δ)     |
+     */
+    final_weight?: number;
+    /** Labels that increased the signal value (e.g. `changes_requested`, `unresolved_thread`). */
+    boosts: string[];
+    /** Labels that decreased the signal value (e.g. `low_signal_text`, `outdated_thread`). */
+    penalties: string[];
+}
+/** In-memory content for an evidence signal. Never written to disk. */
+export interface EvidenceContext {
+    title?: string;
+    content: string;
+    diff_hunk?: string;
+    file_path?: string;
+    line_start?: number;
+    line_end?: number;
+}
+/** Maps evidence signal id to its in-memory content. */
+export type EvidenceContextCache = Map<string, EvidenceContext>;
+/** An extracted engineering insight derived from one or more evidence records. */
+export interface LearningRecord extends CanonicalRecord {
+    type: 'learning';
+    /** Relative path within the repo (e.g. `.ivan/lessons.jsonl#L3`). */
+    sourcePath: string;
+    /** `repo_convention` for project-specific rules; `engineering_lesson` for general patterns. */
+    kind: string;
+    source_type?: string;
+    title?: string;
+    /** The actionable statement distilled from the evidence. */
+    statement: string;
+    rationale?: string;
+    applicability?: string;
+    /** 0.35–0.95; derived from `final_weight` via `inferConfidence`. */
+    confidence?: number;
+    status: string;
+    /** GitHub URL of the PR that generated this learning. */
+    source_url?: string;
+    /** Cached 1536-dim embedding vector from `text-embedding-3-small`. */
+    embedding?: number[];
+    /** SHA-256 hex of the embedding input string; used to detect content changes. */
+    embeddingInputHash?: string;
+}
+/** The full in-memory view of all canonical JSONL data for one repo. */
+export interface LearningsDataset {
+    learnings: LearningRecord[];
+}
+//# sourceMappingURL=record-types.d.ts.map

package/dist/learnings/record-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-types.d.ts","sourceRoot":"","sources":["../../src/learnings/record-types.ts"],"names":[],"mappings":"AAIA,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,IAAI,EAAE,UAAU,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,kHAAkH;IAClH,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,0FAA0F;IAC1F,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEhE,kFAAkF;AAClF,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,IAAI,EAAE,UAAU,CAAC;IACjB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B"}

package/dist/learnings/record-types.js

@@ -0,0 +1,5 @@
+// Canonical record types persisted as JSONL files under `.ivan/`.
+// These are the source-of-truth data structures; the SQLite database is a
+// derived, rebuilable index built from these files.
+export {};
+//# sourceMappingURL=record-types.js.map

package/dist/learnings/record-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-types.js","sourceRoot":"","sources":["../../src/learnings/record-types.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,0EAA0E;AAC1E,oDAAoD"}

package/dist/learnings/repository.d.ts

@@ -0,0 +1,18 @@
+/** Resolved path context for the repository being tracked. */
+export interface LearningsRepositoryContext {
+    repoPath: string;
+    remoteUrl?: string;
+}
+/** Resolves and validates the repository path. */
+export declare function resolveLearningsRepositoryContext(repoPath: string): LearningsRepositoryContext;
+/** Creates `.ivan/` if it doesn't exist; returns the list of paths actually created. */
+export declare function ensureLearningsDirectories(context: LearningsRepositoryContext): string[];
+/** Creates empty canonical JSONL files when they do not already exist. */
+export declare function ensureCanonicalJsonlFiles(repoPath: string): string[];
+/**
+ * No-op: `.ivan/db.sqlite` is intentionally tracked in git so the database is
+ * available to all collaborators without requiring a rebuild.
+ * Always returns false (no changes made).
+ */
+export declare function ensureGitignoreCoverage(_repoPath: string): boolean;
+//# sourceMappingURL=repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../src/learnings/repository.ts"],"names":[],"mappings":"AASA,8DAA8D;AAC9D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kDAAkD;AAClD,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,MAAM,GACf,0BAA0B,CAS5B;AAED,wFAAwF;AACxF,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,0BAA0B,GAClC,MAAM,EAAE,CAQV;AAED,0EAA0E;AAC1E,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAepE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAElE"}

package/dist/learnings/repository.js

@@ -0,0 +1,73 @@
+// Repository identity resolution and learnings directory management.
+// Responsible for identifying which repo is being tracked and creating the local
+// `.ivan/` storage directory.
+import { execFileSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { resolveCanonicalLearningsPath } from './paths.js';
+/** Resolves and validates the repository path. */
+export function resolveLearningsRepositoryContext(repoPath) {
+    const resolvedRepoPath = path.resolve(repoPath);
+    assertDirectoryExists(resolvedRepoPath);
+    const remoteUrl = readRemoteUrl(resolvedRepoPath);
+    return {
+        repoPath: resolvedRepoPath,
+        ...(remoteUrl !== undefined ? { remoteUrl } : {})
+    };
+}
+/** Creates `.ivan/` if it doesn't exist; returns the list of paths actually created. */
+export function ensureLearningsDirectories(context) {
+    const directory = resolveCanonicalLearningsPath(context.repoPath);
+    if (fs.existsSync(directory)) {
+        return [];
+    }
+    fs.mkdirSync(directory, { recursive: true });
+    return [directory];
+}
+/** Creates empty canonical JSONL files when they do not already exist. */
+export function ensureCanonicalJsonlFiles(repoPath) {
+    const files = [
+        resolveCanonicalLearningsPath(repoPath, 'evidence.jsonl'),
+        resolveCanonicalLearningsPath(repoPath, 'lessons.jsonl')
+    ];
+    const created = [];
+    for (const filePath of files) {
+        if (!fs.existsSync(filePath)) {
+            fs.writeFileSync(filePath, '', 'utf8');
+            created.push(filePath);
+        }
+    }
+    return created;
+}
+/**
+ * No-op: `.ivan/db.sqlite` is intentionally tracked in git so the database is
+ * available to all collaborators without requiring a rebuild.
+ * Always returns false (no changes made).
+ */
+export function ensureGitignoreCoverage(_repoPath) {
+    return false;
+}
+/** Throws a descriptive error if `repoPath` does not exist or is not a directory. */
+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}`);
+    }
+}
+/** Reads `remote.origin.url` from git config; returns `undefined` silently if the repo has no remote. */
+function readRemoteUrl(repoPath) {
+    try {
+        const remoteUrl = execFileSync('git', ['config', '--get', 'remote.origin.url'], {
+            cwd: repoPath,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore']
+        }).trim();
+        return remoteUrl || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=repository.js.map

package/dist/learnings/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/learnings/repository.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,iFAAiF;AACjF,8BAA8B;AAE9B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAQ3D,kDAAkD;AAClD,MAAM,UAAU,iCAAiC,CAC/C,QAAgB;IAEhB,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;IAExC,MAAM,SAAS,GAAG,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,OAAO;QACL,QAAQ,EAAE,gBAAgB;QAC1B,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,0BAA0B,CACxC,OAAmC;IAEnC,MAAM,SAAS,GAAG,6BAA6B,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClE,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAC;AACrB,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,MAAM,KAAK,GAAG;QACZ,6BAA6B,CAAC,QAAQ,EAAE,gBAAgB,CAAC;QACzD,6BAA6B,CAAC,QAAQ,EAAE,eAAe,CAAC;KACzD,CAAC;IACF,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qFAAqF;AACrF,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,uCAAuC,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,yGAAyG;AACzG,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,YAAY,CAC5B,KAAK,EACL,CAAC,QAAQ,EAAE,OAAO,EAAE,mBAAmB,CAAC,EACxC;YACE,GAAG,EAAE,QAAQ;YACb,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CACF,CAAC,IAAI,EAAE,CAAC;QAET,OAAO,SAAS,IAAI,SAAS,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/learnings/types.d.ts

@@ -0,0 +1,17 @@
+/** Controls how many results `queryLearnings` returns. */
+export interface LearningsSearchOptions {
+    limit?: number;
+}
+/** A fully hydrated learning returned by `queryLearnings`. */
+export interface LearningsQueryResult {
+    id: string;
+    title?: string;
+    kind: string;
+    statement: string;
+    rationale?: string;
+    applicability?: string;
+    confidence?: number;
+    status: string;
+    source_url?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/learnings/types.ts"],"names":[],"mappings":"AAGA,0DAA0D;AAC1D,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/learnings/types.js

@@ -0,0 +1,4 @@
+// Public-facing query types returned by `queryLearnings`. These are read-only
+// projections of the SQLite data—separate from the canonical JSONL record types.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/learnings/types.js.map

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

package/dist/learnings/validator.d.ts

@@ -0,0 +1,14 @@
+import type { LearningsDataset } from './record-types.js';
+/** Thrown by `validateLearningsDataset` when the dataset contains one or more structural problems. */
+export declare class LearningsValidationError extends Error {
+    /** Each string describes one broken invariant, formatted as `{sourcePath}: {reason}`. */
+    issues: string[];
+    constructor(issues: string[]);
+}
+/**
+ * Validates all records in `dataset` against the schema rules:
+ * correct ID prefixes, no duplicates, and correct file locations.
+ * Throws `LearningsValidationError` listing every issue found; returns void on success.
+ */
+export declare function validateLearningsDataset(dataset: LearningsDataset): void;
+//# sourceMappingURL=validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/learnings/validator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D,sGAAsG;AACtG,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,yFAAyF;IACzF,MAAM,EAAE,MAAM,EAAE,CAAC;gBAEL,MAAM,EAAE,MAAM,EAAE;CAK7B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAmCxE"}

package/dist/learnings/validator.js

@@ -0,0 +1,44 @@
+// Structural validation for the canonical JSONL dataset before it is used to build
+// or query the SQLite database.  Throws early with a human-readable list of all
+// issues so users can fix everything in one pass rather than one error at a time.
+import { isStableRecordId } from './id.js';
+import { LESSONS_JSONL_RELATIVE_PATH } from './paths.js';
+/** Thrown by `validateLearningsDataset` when the dataset contains one or more structural problems. */
+export class LearningsValidationError extends Error {
+    /** Each string describes one broken invariant, formatted as `{sourcePath}: {reason}`. */
+    issues;
+    constructor(issues) {
+        super(`Invalid learnings records:\n- ${issues.join('\n- ')}`);
+        this.name = 'LearningsValidationError';
+        this.issues = issues;
+    }
+}
+/**
+ * Validates all records in `dataset` against the schema rules:
+ * correct ID prefixes, no duplicates, and correct file locations.
+ * Throws `LearningsValidationError` listing every issue found; returns void on success.
+ */
+export function validateLearningsDataset(dataset) {
+    const issues = [];
+    const learningIds = new Set();
+    for (const learning of dataset.learnings) {
+        if (!isStableRecordId(learning.id, 'lrn')) {
+            issues.push(`${learning.sourcePath}: learning id "${learning.id}" must start with "lrn_"`);
+        }
+        if (learningIds.has(learning.id)) {
+            issues.push(`${learning.sourcePath}: duplicate learning id "${learning.id}"`);
+        }
+        learningIds.add(learning.id);
+        if (!learning.statement.trim()) {
+            issues.push(`${learning.sourcePath}: learning statement must not be empty`);
+        }
+        const learningSourceFile = learning.sourcePath.split('#')[0];
+        if (learningSourceFile !== LESSONS_JSONL_RELATIVE_PATH) {
+            issues.push(`${learning.sourcePath}: learning must live in ${LESSONS_JSONL_RELATIVE_PATH}`);
+        }
+    }
+    if (issues.length > 0) {
+        throw new LearningsValidationError(issues);
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/learnings/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/learnings/validator.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,gFAAgF;AAChF,kFAAkF;AAGlF,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAEzD,sGAAsG;AACtG,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,yFAAyF;IACzF,MAAM,CAAW;IAEjB,YAAY,MAAgB;QAC1B,KAAK,CAAC,iCAAiC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAyB;IAChE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IAEtC,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACzC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CACT,GAAG,QAAQ,CAAC,UAAU,kBAAkB,QAAQ,CAAC,EAAE,0BAA0B,CAC9E,CAAC;QACJ,CAAC;QAED,IAAI,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CACT,GAAG,QAAQ,CAAC,UAAU,4BAA4B,QAAQ,CAAC,EAAE,GAAG,CACjE,CAAC;QACJ,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAE7B,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CACT,GAAG,QAAQ,CAAC,UAAU,wCAAwC,CAC/D,CAAC;QACJ,CAAC;QAED,MAAM,kBAAkB,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,IAAI,kBAAkB,KAAK,2BAA2B,EAAE,CAAC;YACvD,MAAM,CAAC,IAAI,CACT,GAAG,QAAQ,CAAC,UAAU,2BAA2B,2BAA2B,EAAE,CAC/E,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/learnings/weighting.d.ts

@@ -0,0 +1,33 @@
+import type { GitHubCheckEvidence, GitHubIssueCommentEvidence, GitHubReviewEvidence, GitHubReviewThreadEvidence } from './github-evidence.js';
+/** The computed signal strength for a single piece of evidence, with audit trail labels. */
+export interface EvidenceWeight {
+    baseWeight: number;
+    finalWeight: number;
+    /** Labels that raised the signal (e.g. `changes_requested`, `unresolved_thread`). */
+    boosts: string[];
+    /** Labels that reduced the signal (e.g. `low_signal_text`, `outdated_thread`). */
+    penalties: string[];
+}
+/** Scores a plain PR issue comment; base weight 3 before text-quality adjustment. */
+export declare function weightIssueComment(comment: GitHubIssueCommentEvidence): EvidenceWeight;
+/**
+ * Scores a PR review.  `CHANGES_REQUESTED` starts at 6 (actionable feedback);
+ * other states start at 2.  Low-signal text reduces either by 2.
+ */
+export declare function weightReview(review: GitHubReviewEvidence): EvidenceWeight;
+/**
+ * Scores a review thread.  Unresolved threads start at 5 (still open issue),
+ * resolved at 3.  Inline code comments get a boost; outdated threads get a penalty.
+ */
+export declare function weightReviewThread(thread: GitHubReviewThreadEvidence): EvidenceWeight;
+/**
+ * Scores a CI check.  Failures/errors are high-signal (weight 4); passing checks
+ * are low-signal (weight 1) and bypass the text-quality computation entirely.
+ */
+export declare function weightCheck(check: GitHubCheckEvidence): EvidenceWeight;
+/** Wraps `classifyAuthorType` into the `{ author_type, author_name }` shape expected by `EvidenceRecord`. */
+export declare function inferAuthorFields(authorName?: string): {
+    author_type?: string;
+    author_name?: string;
+};
+//# sourceMappingURL=weighting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"weighting.d.ts","sourceRoot":"","sources":["../../src/learnings/weighting.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC3B,MAAM,sBAAsB,CAAC;AAO9B,4FAA4F;AAC5F,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kFAAkF;IAClF,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,0BAA0B,GAClC,cAAc,CAMhB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,cAAc,CAiBzE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,0BAA0B,GACjC,cAAc,CAsBhB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc,CAkBtE;AAED,6GAA6G;AAC7G,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAMA"}