limen-ai 1.0.0

package/dist/learning/store/technique_store.js

@@ -0,0 +1,369 @@
+/**
+ * Limen — TechniqueStore Implementation
+ * Phase 4E-2a: Learning System Storage Foundation
+ *
+ * Implements the TechniqueStore interface from learning_types.ts.
+ * All queries manually scoped by tenant_id + agent_id (belt).
+ * TenantScopedConnection at API layer provides suspenders.
+ *
+ * S ref: S29.2 (schema), S29.3 Step 4 (provenance), S29.6 (retirement),
+ *        S29.7 (quarantine/suspend/reactivate), I-03 (audit), I-07 (agent isolation),
+ *        I-10 (retirement permanence), FM-01 (quarantine cascade via getBySourceMemory)
+ */
+import { randomUUID } from 'node:crypto';
+// ─── State Machine ───
+/** Valid state transitions per S29.2, S29.6, S29.7, I-10 */
+const VALID_TRANSITIONS = {
+    active: ['suspended', 'retired'],
+    suspended: ['active', 'retired'],
+    retired: [], // Terminal state (I-10: retirement is permanent)
+};
+function rowToTechnique(row) {
+    return {
+        id: row.id,
+        tenantId: row.tenant_id,
+        agentId: row.agent_id,
+        type: row.type,
+        content: row.content,
+        sourceMemoryIds: JSON.parse(row.source_memory_ids),
+        confidence: row.confidence,
+        successRate: row.success_rate,
+        applicationCount: row.application_count,
+        lastApplied: row.last_applied,
+        lastUpdated: row.last_updated,
+        status: row.status,
+        createdAt: row.created_at,
+    };
+}
+// ─── Audit Helpers ───
+function actorType(ctx) {
+    if (ctx.userId)
+        return 'user';
+    if (ctx.agentId)
+        return 'agent';
+    return 'system';
+}
+function actorId(ctx) {
+    return (ctx.userId ?? ctx.agentId ?? 'system');
+}
+// ─── Factory ───
+/**
+ * Create a TechniqueStore implementation.
+ * Follows the Limen store pattern: factory → Object.freeze.
+ *
+ * All mutations are wrapped in transactions with audit entries (I-03).
+ * All queries enforce tenant_id + agent_id isolation.
+ */
+export function createTechniqueStore(deps) {
+    // ─── create ───
+    function create(conn, ctx, input) {
+        // Validate provenance (S29.3 Step 4: sourceMemoryIds MUST be non-empty)
+        if (!input.sourceMemoryIds || input.sourceMemoryIds.length === 0) {
+            return {
+                ok: false,
+                error: {
+                    code: 'PROVENANCE_REQUIRED',
+                    message: 'sourceMemoryIds must be non-empty — provenance is required (S29.3 Step 4)',
+                    spec: 'S29.3',
+                },
+            };
+        }
+        const id = randomUUID();
+        const now = deps.time.nowISO();
+        const sourceMemoryIdsJson = JSON.stringify(input.sourceMemoryIds);
+        const technique = {
+            id,
+            tenantId: input.tenantId,
+            agentId: input.agentId,
+            type: input.type,
+            content: input.content,
+            sourceMemoryIds: input.sourceMemoryIds,
+            confidence: input.initialConfidence,
+            successRate: 0,
+            applicationCount: 0,
+            lastApplied: null,
+            lastUpdated: now,
+            status: 'active',
+            createdAt: now,
+        };
+        conn.transaction(() => {
+            conn.run(`INSERT INTO learning_techniques
+          (id, tenant_id, agent_id, type, content, source_memory_ids,
+           confidence, success_rate, application_count, last_applied,
+           last_updated, status, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+                id, input.tenantId, input.agentId, input.type, input.content,
+                sourceMemoryIdsJson, input.initialConfidence, 0, 0, null,
+                now, 'active', now,
+            ]);
+            deps.audit.append(conn, {
+                tenantId: input.tenantId,
+                actorType: actorType(ctx),
+                actorId: actorId(ctx),
+                operation: 'technique.create',
+                resourceType: 'technique',
+                resourceId: id,
+            });
+        });
+        return { ok: true, value: technique };
+    }
+    // ─── get ───
+    function get(conn, id, tenantId, agentId) {
+        const row = conn.get(`SELECT * FROM learning_techniques WHERE id = ? AND tenant_id = ? AND agent_id = ?`, [id, tenantId, agentId]);
+        if (!row) {
+            return {
+                ok: false,
+                error: {
+                    code: 'TECHNIQUE_NOT_FOUND',
+                    message: `Technique ${id} not found for tenant ${tenantId} and agent ${agentId}`,
+                    spec: 'S29.2',
+                },
+            };
+        }
+        return { ok: true, value: rowToTechnique(row) };
+    }
+    // ─── getByAgent ───
+    function getByAgent(conn, agentId, tenantId, status) {
+        let sql = `SELECT * FROM learning_techniques WHERE agent_id = ? AND tenant_id = ?`;
+        const params = [agentId, tenantId];
+        if (status) {
+            sql += ` AND status = ?`;
+            params.push(status);
+        }
+        const rows = conn.query(sql, params);
+        return { ok: true, value: rows.map(rowToTechnique) };
+    }
+    // ─── getBySourceMemory ───
+    function getBySourceMemory(conn, memoryId, tenantId) {
+        // Use json_each to search within the JSON array of source memory IDs
+        // Comma-join with json_each (no JOIN keyword — compatible with TenantScopedConnection)
+        const rows = conn.query(`SELECT DISTINCT lt.id, lt.tenant_id, lt.agent_id, lt.type, lt.content,
+              lt.source_memory_ids, lt.confidence, lt.success_rate,
+              lt.application_count, lt.last_applied, lt.last_updated,
+              lt.status, lt.created_at
+       FROM learning_techniques lt, json_each(lt.source_memory_ids) je
+       WHERE lt.tenant_id = ? AND je.value = ?`, [tenantId, memoryId]);
+        return { ok: true, value: rows.map(rowToTechnique) };
+    }
+    // ─── update ───
+    function update(conn, ctx, id, tenantId, updates) {
+        // Fetch current technique (tenant-scoped)
+        const current = conn.get(`SELECT * FROM learning_techniques WHERE id = ? AND tenant_id = ?`, [id, tenantId]);
+        if (!current) {
+            return {
+                ok: false,
+                error: {
+                    code: 'TECHNIQUE_NOT_FOUND',
+                    message: `Technique ${id} not found for tenant ${tenantId}`,
+                    spec: 'S29.2',
+                },
+            };
+        }
+        // Defense-in-depth: verify ctx.agentId matches (OBS-3)
+        if (ctx.agentId && current.agent_id !== ctx.agentId) {
+            return {
+                ok: false,
+                error: {
+                    code: 'AGENT_MISMATCH',
+                    message: `Context agent ${ctx.agentId} does not own technique ${id}`,
+                    spec: 'I-07',
+                },
+            };
+        }
+        // State machine validation: retired is terminal (I-10)
+        if (updates.status && current.status === 'retired') {
+            return {
+                ok: false,
+                error: {
+                    code: 'INVALID_TRANSITION',
+                    message: `Cannot transition from retired — retirement is permanent (I-10)`,
+                    spec: 'I-10',
+                },
+            };
+        }
+        // Validate state transition if status change requested
+        if (updates.status && updates.status !== current.status) {
+            const validTargets = VALID_TRANSITIONS[current.status];
+            if (!validTargets.includes(updates.status)) {
+                return {
+                    ok: false,
+                    error: {
+                        code: 'INVALID_TRANSITION',
+                        message: `Cannot transition from ${current.status} to ${updates.status}`,
+                        spec: 'S29.2',
+                    },
+                };
+            }
+        }
+        // Build SET clause dynamically from provided updates
+        const setClauses = [];
+        const setParams = [];
+        if (updates.confidence !== undefined) {
+            setClauses.push('confidence = ?');
+            setParams.push(updates.confidence);
+        }
+        if (updates.successRate !== undefined) {
+            setClauses.push('success_rate = ?');
+            setParams.push(updates.successRate);
+        }
+        if (updates.applicationCount !== undefined) {
+            setClauses.push('application_count = ?');
+            setParams.push(updates.applicationCount);
+        }
+        if (updates.lastApplied !== undefined) {
+            setClauses.push('last_applied = ?');
+            setParams.push(updates.lastApplied);
+        }
+        if (updates.status !== undefined) {
+            setClauses.push('status = ?');
+            setParams.push(updates.status);
+        }
+        if (setClauses.length === 0) {
+            // No updates — return current state
+            return { ok: true, value: rowToTechnique(current) };
+        }
+        const now = deps.time.nowISO();
+        setClauses.push('last_updated = ?');
+        setParams.push(now);
+        conn.transaction(() => {
+            conn.run(`UPDATE learning_techniques SET ${setClauses.join(', ')} WHERE id = ? AND tenant_id = ?`, [...setParams, id, tenantId]);
+            deps.audit.append(conn, {
+                tenantId: tenantId,
+                actorType: actorType(ctx),
+                actorId: actorId(ctx),
+                operation: 'technique.update',
+                resourceType: 'technique',
+                resourceId: id,
+            });
+        });
+        // Fetch updated row
+        const updated = conn.get(`SELECT * FROM learning_techniques WHERE id = ? AND tenant_id = ?`, [id, tenantId]);
+        return { ok: true, value: rowToTechnique(updated) };
+    }
+    // ─── retire ───
+    function retire(conn, ctx, id, tenantId, reason) {
+        const current = conn.get(`SELECT * FROM learning_techniques WHERE id = ? AND tenant_id = ?`, [id, tenantId]);
+        if (!current) {
+            return {
+                ok: false,
+                error: {
+                    code: 'TECHNIQUE_NOT_FOUND',
+                    message: `Technique ${id} not found for tenant ${tenantId}`,
+                    spec: 'S29.6',
+                },
+            };
+        }
+        // I-10: Cannot retire an already-retired technique
+        if (current.status === 'retired') {
+            return {
+                ok: false,
+                error: {
+                    code: 'ALREADY_RETIRED',
+                    message: `Technique ${id} is already retired`,
+                    spec: 'I-10',
+                },
+            };
+        }
+        const now = deps.time.nowISO();
+        conn.transaction(() => {
+            conn.run(`UPDATE learning_techniques SET status = 'retired', last_updated = ? WHERE id = ? AND tenant_id = ?`, [now, id, tenantId]);
+            deps.audit.append(conn, {
+                tenantId: tenantId,
+                actorType: actorType(ctx),
+                actorId: actorId(ctx),
+                operation: `technique.retire:${reason}`,
+                resourceType: 'technique',
+                resourceId: id,
+            });
+        });
+        return { ok: true, value: undefined };
+    }
+    // ─── suspend ───
+    function suspend(conn, ctx, id, tenantId) {
+        const current = conn.get(`SELECT * FROM learning_techniques WHERE id = ? AND tenant_id = ?`, [id, tenantId]);
+        if (!current) {
+            return {
+                ok: false,
+                error: {
+                    code: 'TECHNIQUE_NOT_FOUND',
+                    message: `Technique ${id} not found for tenant ${tenantId}`,
+                    spec: 'S29.7',
+                },
+            };
+        }
+        // Can only suspend from 'active' state
+        if (current.status !== 'active') {
+            return {
+                ok: false,
+                error: {
+                    code: 'INVALID_TRANSITION',
+                    message: `Cannot suspend technique in state ${current.status} — only active techniques can be suspended`,
+                    spec: 'S29.7',
+                },
+            };
+        }
+        const now = deps.time.nowISO();
+        conn.transaction(() => {
+            conn.run(`UPDATE learning_techniques SET status = 'suspended', last_updated = ? WHERE id = ? AND tenant_id = ?`, [now, id, tenantId]);
+            deps.audit.append(conn, {
+                tenantId: tenantId,
+                actorType: actorType(ctx),
+                actorId: actorId(ctx),
+                operation: 'technique.suspend',
+                resourceType: 'technique',
+                resourceId: id,
+            });
+        });
+        return { ok: true, value: undefined };
+    }
+    // ─── reactivate ───
+    function reactivate(conn, ctx, id, tenantId, resetConfidence) {
+        const current = conn.get(`SELECT * FROM learning_techniques WHERE id = ? AND tenant_id = ?`, [id, tenantId]);
+        if (!current) {
+            return {
+                ok: false,
+                error: {
+                    code: 'TECHNIQUE_NOT_FOUND',
+                    message: `Technique ${id} not found for tenant ${tenantId}`,
+                    spec: 'S29.7',
+                },
+            };
+        }
+        // Can only reactivate from 'suspended' state (I-10: retired is terminal)
+        if (current.status !== 'suspended') {
+            return {
+                ok: false,
+                error: {
+                    code: 'INVALID_TRANSITION',
+                    message: `Cannot reactivate technique in state ${current.status} — only suspended techniques can be reactivated (I-10)`,
+                    spec: 'I-10',
+                },
+            };
+        }
+        const now = deps.time.nowISO();
+        conn.transaction(() => {
+            conn.run(`UPDATE learning_techniques SET status = 'active', confidence = ?, last_updated = ? WHERE id = ? AND tenant_id = ?`, [resetConfidence, now, id, tenantId]);
+            deps.audit.append(conn, {
+                tenantId: tenantId,
+                actorType: actorType(ctx),
+                actorId: actorId(ctx),
+                operation: 'technique.reactivate',
+                resourceType: 'technique',
+                resourceId: id,
+            });
+        });
+        return { ok: true, value: undefined };
+    }
+    // ─── Return frozen store ───
+    return Object.freeze({
+        create,
+        get,
+        getByAgent,
+        getBySourceMemory,
+        update,
+        retire,
+        suspend,
+        reactivate,
+    });
+}
+//# sourceMappingURL=technique_store.js.map

package/dist/learning/store/technique_store.js.map

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

package/dist/learning/tracker/effectiveness_tracker.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Limen — EffectivenessTracker Implementation
+ * Phase 4E-2d: Learning System Effectiveness Tracking
+ *
+ * Implements the EffectivenessTracker interface from learning_types.ts.
+ * Tracks technique outcomes, computes success rates, and updates
+ * confidence via EMA formula.
+ *
+ * S ref: S29.5 (EMA confidence, rolling window success rate),
+ *        I-03 (audit trail), I-07 (agent isolation)
+ *
+ * CRITICAL DATA OWNERSHIP (R-04):
+ *   updateConfidence OWNS persistence of both confidence and successRate.
+ *   It computes these from outcomes and writes them to the technique
+ *   via store.update(). Without this write, retirement reads stale zeros.
+ */
+import type { EffectivenessTracker, TechniqueStore, LearningDeps } from '../interfaces/index.js';
+/**
+ * Create an EffectivenessTracker implementation.
+ * Follows the Limen store pattern: factory -> Object.freeze.
+ *
+ * @param deps - Learning system dependencies (getConnection, audit, etc.)
+ * @param store - TechniqueStore reference for persisting computed metrics
+ */
+export declare function createEffectivenessTracker(deps: LearningDeps, store: TechniqueStore): EffectivenessTracker;
+//# sourceMappingURL=effectiveness_tracker.d.ts.map

package/dist/learning/tracker/effectiveness_tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectiveness_tracker.d.ts","sourceRoot":"","sources":["../../../src/learning/tracker/effectiveness_tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EACV,oBAAoB,EAAE,cAAc,EACb,YAAY,EACpC,MAAM,wBAAwB,CAAC;AAsChC;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,cAAc,GACpB,oBAAoB,CAiLtB"}

package/dist/learning/tracker/effectiveness_tracker.js

@@ -0,0 +1,158 @@
+/**
+ * Limen — EffectivenessTracker Implementation
+ * Phase 4E-2d: Learning System Effectiveness Tracking
+ *
+ * Implements the EffectivenessTracker interface from learning_types.ts.
+ * Tracks technique outcomes, computes success rates, and updates
+ * confidence via EMA formula.
+ *
+ * S ref: S29.5 (EMA confidence, rolling window success rate),
+ *        I-03 (audit trail), I-07 (agent isolation)
+ *
+ * CRITICAL DATA OWNERSHIP (R-04):
+ *   updateConfidence OWNS persistence of both confidence and successRate.
+ *   It computes these from outcomes and writes them to the technique
+ *   via store.update(). Without this write, retirement reads stale zeros.
+ */
+import { randomUUID } from 'node:crypto';
+import { EMA_WEIGHT_OLD, EMA_WEIGHT_RECENT, SUCCESS_RATE_WINDOW, } from '../interfaces/index.js';
+// ─── Audit Helpers ───
+function actorType(ctx) {
+    if (ctx.userId)
+        return 'user';
+    if (ctx.agentId)
+        return 'agent';
+    return 'system';
+}
+function actorId(ctx) {
+    return (ctx.userId ?? ctx.agentId ?? 'system');
+}
+// ─── Factory ───
+/**
+ * Create an EffectivenessTracker implementation.
+ * Follows the Limen store pattern: factory -> Object.freeze.
+ *
+ * @param deps - Learning system dependencies (getConnection, audit, etc.)
+ * @param store - TechniqueStore reference for persisting computed metrics
+ */
+export function createEffectivenessTracker(deps, store) {
+    // ─── recordOutcome ───
+    function recordOutcome(conn, ctx, techniqueId, tenantId, outcome) {
+        // Verify technique exists for this tenant (tenant isolation)
+        const technique = conn.get(`SELECT id FROM learning_techniques WHERE id = ? AND tenant_id = ?`, [techniqueId, tenantId]);
+        if (!technique) {
+            return {
+                ok: false,
+                error: {
+                    code: 'TECHNIQUE_NOT_FOUND',
+                    message: `Technique ${techniqueId} not found for tenant ${tenantId}`,
+                    spec: 'S29.5',
+                },
+            };
+        }
+        const id = randomUUID();
+        const now = deps.time.nowISO();
+        conn.transaction(() => {
+            conn.run(`INSERT INTO learning_outcomes (id, technique_id, tenant_id, outcome, created_at)
+         VALUES (?, ?, ?, ?, ?)`, [id, techniqueId, tenantId, outcome, now]);
+            deps.audit.append(conn, {
+                tenantId,
+                actorType: actorType(ctx),
+                actorId: actorId(ctx),
+                operation: `tracker.recordOutcome:${outcome}`,
+                resourceType: 'technique',
+                resourceId: techniqueId,
+            });
+        });
+        return { ok: true, value: undefined };
+    }
+    // ─── getSuccessRate ───
+    function getSuccessRate(conn, techniqueId, tenantId) {
+        // Verify technique exists for this tenant (tenant isolation — BRK-S29-019)
+        const technique = conn.get(`SELECT id FROM learning_techniques WHERE id = ? AND tenant_id = ?`, [techniqueId, tenantId]);
+        if (!technique) {
+            return {
+                ok: false,
+                error: {
+                    code: 'TECHNIQUE_NOT_FOUND',
+                    message: `Technique ${techniqueId} not found for tenant ${tenantId}`,
+                    spec: 'S29.5',
+                },
+            };
+        }
+        // Rolling window: last SUCCESS_RATE_WINDOW (50) outcomes of any type,
+        // then compute ratio excluding neutral (S29.5).
+        // ORDER BY created_at DESC, rowid DESC: rowid is tiebreaker for
+        // outcomes inserted within the same timestamp (deterministic ordering).
+        const outcomes = conn.query(`SELECT outcome FROM learning_outcomes
+       WHERE technique_id = ? AND tenant_id = ?
+       ORDER BY created_at DESC, rowid DESC
+       LIMIT ?`, [techniqueId, tenantId, SUCCESS_RATE_WINDOW]);
+        let positive = 0;
+        let negative = 0;
+        for (const row of outcomes) {
+            if (row.outcome === 'positive')
+                positive++;
+            else if (row.outcome === 'negative')
+                negative++;
+            // neutral: excluded from ratio (S29.5)
+        }
+        const denominator = positive + negative;
+        // Zero non-neutral outcomes: success rate is 0.0 (no evidence of success).
+        // This is a defined boundary: no data = 0.0, not undefined/NaN.
+        if (denominator === 0) {
+            return { ok: true, value: 0.0 };
+        }
+        return { ok: true, value: positive / denominator };
+    }
+    // ─── updateConfidence ───
+    function updateConfidence(conn, ctx, techniqueId, tenantId) {
+        // Read current technique confidence
+        const technique = conn.get(`SELECT id, tenant_id, confidence FROM learning_techniques WHERE id = ? AND tenant_id = ?`, [techniqueId, tenantId]);
+        if (!technique) {
+            return {
+                ok: false,
+                error: {
+                    code: 'TECHNIQUE_NOT_FOUND',
+                    message: `Technique ${techniqueId} not found for tenant ${tenantId}`,
+                    spec: 'S29.5',
+                },
+            };
+        }
+        // Check if any non-neutral outcomes exist.
+        // If zero outcomes, EMA has no input — skip update, return current confidence.
+        // Rationale: 0.8*old + 0.2*undefined = undefined. No evidence = no change.
+        const nonNeutralCount = conn.get(`SELECT COUNT(*) as cnt FROM learning_outcomes
+       WHERE technique_id = ? AND tenant_id = ? AND outcome != 'neutral'`, [techniqueId, tenantId]);
+        if (!nonNeutralCount || nonNeutralCount.cnt === 0) {
+            return { ok: true, value: technique.confidence };
+        }
+        // Compute recent success rate via getSuccessRate (rolling window)
+        const srResult = getSuccessRate(conn, techniqueId, tenantId);
+        if (!srResult.ok)
+            return srResult;
+        const recentSuccessRate = srResult.value;
+        const oldConfidence = technique.confidence;
+        // EMA formula (S29.5): new = 0.8 * old + 0.2 * recent
+        const newConfidence = EMA_WEIGHT_OLD * oldConfidence + EMA_WEIGHT_RECENT * recentSuccessRate;
+        // R-04: PERSIST both confidence and successRate to the technique.
+        // This is the critical integration seam. Without this write:
+        //   - confidence stays at initial 0.5 forever
+        //   - successRate stays at 0.0 forever
+        //   - retirement reads stale zeros and makes wrong decisions
+        const updateResult = store.update(conn, ctx, techniqueId, tenantId, {
+            confidence: newConfidence,
+            successRate: recentSuccessRate,
+        });
+        if (!updateResult.ok)
+            return updateResult;
+        return { ok: true, value: newConfidence };
+    }
+    // ─── Return frozen tracker ───
+    return Object.freeze({
+        recordOutcome,
+        updateConfidence,
+        getSuccessRate,
+    });
+}
+//# sourceMappingURL=effectiveness_tracker.js.map

package/dist/learning/tracker/effectiveness_tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectiveness_tracker.js","sourceRoot":"","sources":["../../../src/learning/tracker/effectiveness_tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,OAAO,EACL,cAAc,EAAE,iBAAiB,EAAE,mBAAmB,GACvD,MAAM,wBAAwB,CAAC;AAqBhC,wBAAwB;AAExB,SAAS,SAAS,CAAC,GAAqB;IACtC,IAAI,GAAG,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,GAAG,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAChC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,OAAO,CAAC,GAAqB;IACpC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,QAAQ,CAAW,CAAC;AAC3D,CAAC;AAED,kBAAkB;AAElB;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAkB,EAClB,KAAqB;IAGrB,wBAAwB;IAExB,SAAS,aAAa,CACpB,IAAwB,EACxB,GAAqB,EACrB,WAAwB,EACxB,QAAkB,EAClB,OAA8B;QAE9B,6DAA6D;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,mEAAmE,EACnE,CAAC,WAAW,EAAE,QAAQ,CAAC,CACxB,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE,aAAa,WAAW,yBAAyB,QAAQ,EAAE;oBACpE,IAAI,EAAE,OAAO;iBACd;aACF,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAE/B,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE;YACpB,IAAI,CAAC,GAAG,CACN;gCACwB,EACxB,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,CAC1C,CAAC;YAEF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;gBACtB,QAAQ;gBACR,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC;gBACzB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC;gBACrB,SAAS,EAAE,yBAAyB,OAAO,EAAE;gBAC7C,YAAY,EAAE,WAAW;gBACzB,UAAU,EAAE,WAAW;aACxB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACxC,CAAC;IAED,yBAAyB;IAEzB,SAAS,cAAc,CACrB,IAAwB,EACxB,WAAwB,EACxB,QAAkB;QAElB,2EAA2E;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,mEAAmE,EACnE,CAAC,WAAW,EAAE,QAAQ,CAAC,CACxB,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE,aAAa,WAAW,yBAAyB,QAAQ,EAAE;oBACpE,IAAI,EAAE,OAAO;iBACd;aACF,CAAC;QACJ,CAAC;QAED,sEAAsE;QACtE,gDAAgD;QAChD,gEAAgE;QAChE,wEAAwE;QACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB;;;eAGS,EACT,CAAC,WAAW,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAC7C,CAAC;QAEF,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,GAAG,CAAC,OAAO,KAAK,UAAU;gBAAE,QAAQ,EAAE,CAAC;iBACtC,IAAI,GAAG,CAAC,OAAO,KAAK,UAAU;gBAAE,QAAQ,EAAE,CAAC;YAChD,uCAAuC;QACzC,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;QAExC,2EAA2E;QAC3E,gEAAgE;QAChE,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAClC,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,GAAG,WAAW,EAAE,CAAC;IACrD,CAAC;IAED,2BAA2B;IAE3B,SAAS,gBAAgB,CACvB,IAAwB,EACxB,GAAqB,EACrB,WAAwB,EACxB,QAAkB;QAElB,oCAAoC;QACpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,0FAA0F,EAC1F,CAAC,WAAW,EAAE,QAAQ,CAAC,CACxB,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE;oBACL,IAAI,EAAE,qBAAqB;oBAC3B,OAAO,EAAE,aAAa,WAAW,yBAAyB,QAAQ,EAAE;oBACpE,IAAI,EAAE,OAAO;iBACd;aACF,CAAC;QACJ,CAAC;QAED,2CAA2C;QAC3C,+EAA+E;QAC/E,2EAA2E;QAC3E,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAC9B;yEACmE,EACnE,CAAC,WAAW,EAAE,QAAQ,CAAC,CACxB,CAAC;QAEF,IAAI,CAAC,eAAe,IAAI,eAAe,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC;YAClD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC;QACnD,CAAC;QAED,kEAAkE;QAClE,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,QAAQ,CAAC;QAElC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,KAAK,CAAC;QACzC,MAAM,aAAa,GAAG,SAAS,CAAC,UAAU,CAAC;QAE3C,sDAAsD;QACtD,MAAM,aAAa,GAAG,cAAc,GAAG,aAAa,GAAG,iBAAiB,GAAG,iBAAiB,CAAC;QAE7F,kEAAkE;QAClE,6DAA6D;QAC7D,8CAA8C;QAC9C,uCAAuC;QACvC,6DAA6D;QAC7D,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE;YAClE,UAAU,EAAE,aAAa;YACzB,WAAW,EAAE,iBAAiB;SAC/B,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,EAAE;YAAE,OAAO,YAA8B,CAAC;QAE5D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAC5C,CAAC;IAED,gCAAgC;IAEhC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa;QACb,gBAAgB;QAChB,cAAc;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/learning/transfer/cross_agent_transfer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Limen — CrossAgentTransfer Implementation
+ * Phase 4E-2e: Learning System Convergence Subsystems
+ *
+ * Implements the CrossAgentTransfer interface from learning_types.ts.
+ * Human gate required. Confidence resets to 0.4 on transfer.
+ * Source provenance chain preserved.
+ *
+ * S ref: S29.8 (cross-agent transfer protocol), I-07 (agent isolation),
+ *        I-03 (audit atomicity), DEC-4E-002 (cross-tenant blocked)
+ *
+ * Engineering decisions:
+ *   D1: Qualification gate enforced at requestTransfer (§29.8 Step 1, BRK-S29-002).
+ *       Source technique must have confidence > 0.8, success_rate > 0.7,
+ *       applicationCount > 50. This prevents low-quality techniques from being
+ *       proposed for transfer.
+ *   D2: Clone mechanics: approveTransfer creates a NEW technique via store.create()
+ *       with the target agent's ID. Source technique is unaffected (clone, not move).
+ *   D3: Provenance preservation: the cloned technique's sourceMemoryIds = the source
+ *       technique's sourceMemoryIds. Full provenance chain maintained.
+ *   D4: DEC-4E-002 enforcement: TransferRequest has single tenantId field. The
+ *       implementation uses this tenantId for all queries — no cross-tenant path exists.
+ *   D5: Self-transfer (sourceAgentId === targetAgentId) is rejected immediately.
+ *       No request record created (§29.8, I-07).
+ */
+import type { CrossAgentTransfer, TechniqueStore, LearningDeps } from '../interfaces/index.js';
+/**
+ * Create a CrossAgentTransfer implementation.
+ * Follows the Limen store pattern: factory → Object.freeze.
+ *
+ * S29.8: Transfer lifecycle: request → pending → approved/rejected.
+ * Human gate required. Confidence resets to 0.4.
+ */
+export declare function createCrossAgentTransfer(deps: LearningDeps, store: TechniqueStore): CrossAgentTransfer;
+//# sourceMappingURL=cross_agent_transfer.d.ts.map

package/dist/learning/transfer/cross_agent_transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross_agent_transfer.d.ts","sourceRoot":"","sources":["../../../src/learning/transfer/cross_agent_transfer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EAAE,YAAY,EAC7B,MAAM,wBAAwB,CAAC;AAmDhC;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,GAAG,kBAAkB,CAuQtG"}