limen-ai 1.0.0

package/dist/orchestration/checkpoints/drift_engine.js

@@ -0,0 +1,126 @@
+/**
+ * Drift Engine — Semantic drift detection at checkpoints.
+ * S ref: I-24 (Goal Anchoring), FM-14 (Semantic Drift), FM-16 (Mission Drift)
+ *
+ * Phase: Sprint 3 (Knowledge Graph)
+ *
+ * Algorithm:
+ *   1. Read goal anchor from core_mission_goals (NOT core_missions — T-S3-018)
+ *   2. Compute TF-IDF cosine similarity between objective and assessment text
+ *   3. driftScore = 1.0 - similarityScore
+ *   4. Threshold: > 0.7 escalated, 0.4-0.7 flagged, < 0.4 none
+ *   5. INSERT drift assessment record (append-only)
+ *
+ * Reuses computeSimilarity from technique_extractor.ts (D1: local TF-IDF cosine).
+ * FO-004: upgrade to embedding-based similarity when IC-08 ships.
+ *
+ * Safety constraints:
+ *   - Reads from core_mission_goals (trigger-protected, I-24)
+ *   - Tenant isolation via mission_id FK (core_mission_goals has no tenant_id;
+ *     isolation is enforced at the mission level — the mission owns the tenant scope)
+ *   - Append-only: core_drift_assessments has triggers blocking UPDATE/DELETE
+ *   - TimeProvider for all timestamps
+ *
+ * Spec trace: §4 I-24, §6 FM-14, §16 FM-16
+ */
+import { randomUUID } from 'node:crypto';
+import { computeSimilarity } from '../../learning/extractor/technique_extractor.js';
+/** Drift thresholds for action classification. */
+const DRIFT_ESCALATION_THRESHOLD = 0.7;
+const DRIFT_FLAG_THRESHOLD = 0.4;
+/**
+ * Generate a drift assessment ID.
+ * Uses TimeProvider for timestamp (I-25 deterministic replay) and
+ * crypto.randomUUID for uniqueness (consistency with codebase pattern).
+ */
+function generateDriftId(time) {
+    return `drift-${time.nowMs().toString(36)}-${randomUUID().slice(0, 8)}`;
+}
+/**
+ * Assess semantic drift between a checkpoint's assessment text and the mission's
+ * goal anchor objective.
+ *
+ * @param checkpointId - ID of the checkpoint being assessed
+ * @param missionId - Mission ID to read goal anchor from
+ * @param assessmentText - The checkpoint's assessment text to compare
+ * @param conn - Database connection
+ * @param tenantId - Tenant ID for isolation (null for single-tenant)
+ * @param audit - Audit trail
+ * @param time - TimeProvider for timestamps
+ * @returns DriftResult with scores and action
+ */
+export function assessDrift(checkpointId, missionId, assessmentText, conn, tenantId, audit, time) {
+    // Step 1: Read goal anchor from core_mission_goals (NOT core_missions — T-S3-018)
+    // Tenant isolation via mission_id FK (no tenant_id column on core_mission_goals)
+    const goalRow = conn.get(`SELECT objective
+     FROM core_mission_goals
+     WHERE mission_id = ?`, [missionId]);
+    // No goal anchor found: no drift can be detected — graceful fallback
+    if (!goalRow) {
+        return {
+            driftScore: 0,
+            similarityScore: 1,
+            actionTaken: 'none',
+            escalationReason: null,
+        };
+    }
+    // Step 2: Compute similarity using reused computeSimilarity (D1: TF-IDF cosine)
+    const similarityScore = computeSimilarity(goalRow.objective, assessmentText);
+    // Step 3: driftScore = 1.0 - similarityScore
+    const driftScore = 1.0 - similarityScore;
+    // Step 4: Classify action based on thresholds
+    let actionTaken;
+    let escalationReason = null;
+    if (driftScore > DRIFT_ESCALATION_THRESHOLD) {
+        actionTaken = 'escalated';
+        escalationReason = `goal_drift_detected: drift score ${driftScore.toFixed(3)} exceeds escalation threshold ${DRIFT_ESCALATION_THRESHOLD}`;
+    }
+    else if (driftScore >= DRIFT_FLAG_THRESHOLD) {
+        actionTaken = 'flagged';
+    }
+    else {
+        actionTaken = 'none';
+    }
+    // Step 5: INSERT drift assessment record (append-only)
+    const driftId = generateDriftId(time);
+    const now = time.nowISO();
+    conn.run(`INSERT INTO core_drift_assessments
+     (id, checkpoint_id, mission_id, tenant_id, drift_score, similarity_score,
+      original_objective, current_assessment, action_taken, escalation_reason, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+        driftId,
+        checkpointId,
+        missionId,
+        tenantId,
+        driftScore,
+        similarityScore,
+        goalRow.objective,
+        assessmentText,
+        actionTaken,
+        escalationReason,
+        now,
+    ]);
+    // I-03: Audit trail for drift assessment
+    audit.append(conn, {
+        tenantId,
+        actorType: 'system',
+        actorId: 'drift_engine',
+        operation: 'assess_drift',
+        resourceType: 'drift_assessment',
+        resourceId: driftId,
+        detail: {
+            checkpointId,
+            missionId,
+            driftScore,
+            similarityScore,
+            actionTaken,
+        },
+    });
+    return {
+        driftScore,
+        similarityScore,
+        actionTaken,
+        escalationReason,
+    };
+}
+//# sourceMappingURL=drift_engine.js.map

package/dist/orchestration/checkpoints/drift_engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift_engine.js","sourceRoot":"","sources":["../../../src/orchestration/checkpoints/drift_engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AAEpF,kDAAkD;AAClD,MAAM,0BAA0B,GAAG,GAAG,CAAC;AACvC,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAcjC;;;;GAIG;AACH,SAAS,eAAe,CAAC,IAAkB;IACzC,OAAO,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CACzB,YAAoB,EACpB,SAAoB,EACpB,cAAsB,EACtB,IAAwB,EACxB,QAAyB,EACzB,KAAiB,EACjB,IAAkB;IAElB,kFAAkF;IAClF,iFAAiF;IACjF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB;;0BAEsB,EACtB,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,qEAAqE;IACrE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,UAAU,EAAE,CAAC;YACb,eAAe,EAAE,CAAC;YAClB,WAAW,EAAE,MAAM;YACnB,gBAAgB,EAAE,IAAI;SACvB,CAAC;IACJ,CAAC;IAED,gFAAgF;IAChF,MAAM,eAAe,GAAG,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAE7E,6CAA6C;IAC7C,MAAM,UAAU,GAAG,GAAG,GAAG,eAAe,CAAC;IAEzC,8CAA8C;IAC9C,IAAI,WAA6C,CAAC;IAClD,IAAI,gBAAgB,GAAkB,IAAI,CAAC;IAE3C,IAAI,UAAU,GAAG,0BAA0B,EAAE,CAAC;QAC5C,WAAW,GAAG,WAAW,CAAC;QAC1B,gBAAgB,GAAG,oCAAoC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,0BAA0B,EAAE,CAAC;IAC5I,CAAC;SAAM,IAAI,UAAU,IAAI,oBAAoB,EAAE,CAAC;QAC9C,WAAW,GAAG,SAAS,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,uDAAuD;IACvD,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAE1B,IAAI,CAAC,GAAG,CACN;;;8CAG0C,EAC1C;QACE,OAAO;QACP,YAAY;QACZ,SAAS;QACT,QAAQ;QACR,UAAU;QACV,eAAe;QACf,OAAO,CAAC,SAAS;QACjB,cAAc;QACd,WAAW;QACX,gBAAgB;QAChB,GAAG;KACJ,CACF,CAAC;IAEF,yCAAyC;IACzC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;QACjB,QAAQ;QACR,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,cAAc;QACvB,SAAS,EAAE,cAAc;QACzB,YAAY,EAAE,kBAAkB;QAChC,UAAU,EAAE,OAAO;QACnB,MAAM,EAAE;YACN,YAAY;YACZ,SAAS;YACT,UAAU;YACV,eAAe;YACf,WAAW;SACZ;KACF,CAAC,CAAC;IAEH,OAAO;QACL,UAAU;QACV,eAAe;QACf,WAAW;QACX,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/orchestration/compaction/bounded_cognition.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Bounded Cognition -- Eager compaction of completed subtrees.
+ * S ref: I-21 (bounded cognitive state), S40 (operational failure defense),
+ *        S23 (submit_result triggers compaction), I-03 (atomic audit)
+ *
+ * Phase: 3 (Orchestration)
+ * Implements: On submit_result, compact completed subtrees IN THE SAME TRANSACTION.
+ *             Working-set query returns only non-compacted, active missions.
+ *             Compaction produces a summary artifact and archives the subtree.
+ *
+ * SD-20: Compaction is eager (same transaction as submit_result) not lazy.
+ *        This prevents the working set from growing unboundedly.
+ * SD-21: Compacted missions have compacted=1, their artifacts are ARCHIVED,
+ *        and a compaction_log entry records what was compacted.
+ */
+import type { CompactionEngine } from '../interfaces/orchestration.js';
+/**
+ * I-21: Create the compaction engine module.
+ * Factory function returns frozen object per C-07.
+ */
+export declare function createCompactionEngine(): CompactionEngine;
+//# sourceMappingURL=bounded_cognition.d.ts.map

package/dist/orchestration/compaction/bounded_cognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded_cognition.d.ts","sourceRoot":"","sources":["../../../src/orchestration/compaction/bounded_cognition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAqB,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAG1F;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CA8JzD"}

package/dist/orchestration/compaction/bounded_cognition.js

@@ -0,0 +1,124 @@
+/**
+ * Bounded Cognition -- Eager compaction of completed subtrees.
+ * S ref: I-21 (bounded cognitive state), S40 (operational failure defense),
+ *        S23 (submit_result triggers compaction), I-03 (atomic audit)
+ *
+ * Phase: 3 (Orchestration)
+ * Implements: On submit_result, compact completed subtrees IN THE SAME TRANSACTION.
+ *             Working-set query returns only non-compacted, active missions.
+ *             Compaction produces a summary artifact and archives the subtree.
+ *
+ * SD-20: Compaction is eager (same transaction as submit_result) not lazy.
+ *        This prevents the working set from growing unboundedly.
+ * SD-21: Compacted missions have compacted=1, their artifacts are ARCHIVED,
+ *        and a compaction_log entry records what was compacted.
+ */
+import { generateId } from '../interfaces/orchestration.js';
+/**
+ * I-21: Create the compaction engine module.
+ * Factory function returns frozen object per C-07.
+ */
+export function createCompactionEngine() {
+    /**
+     * I-21: Eagerly compact a completed subtree in same transaction.
+     * SD-20: Called from submit_result after mission transitions to COMPLETED.
+     *
+     * Compaction steps:
+     * 1. Find all completed children of the completed mission
+     * 2. Mark them as compacted (compacted=1)
+     * 3. Archive their artifacts (lifecycle_state='ARCHIVED')
+     * 4. Create a summary artifact with compaction details
+     * 5. Log the compaction
+     */
+    function compactSubtree(deps, completedMissionId) {
+        // Verify mission is completed
+        const mission = deps.conn.get('SELECT state, parent_id, tenant_id FROM core_missions WHERE id = ?', [completedMissionId]);
+        if (!mission || mission.state !== 'COMPLETED') {
+            // Not completed -- nothing to compact
+            return { ok: true, value: undefined };
+        }
+        // Find all completed children (direct children only for efficiency)
+        const completedChildren = deps.conn.query(`SELECT id FROM core_missions WHERE parent_id = ? AND state = 'COMPLETED' AND compacted = 0`, [completedMissionId]);
+        if (completedChildren.length === 0) {
+            // No children to compact -- just mark self if it's a leaf
+            return { ok: true, value: undefined };
+        }
+        const now = deps.time.nowISO();
+        const compactionId = generateId();
+        const childIds = completedChildren.map(c => c.id);
+        let totalArchived = 0;
+        deps.conn.transaction(() => {
+            // Mark children as compacted
+            for (const childId of childIds) {
+                deps.conn.run(`UPDATE core_missions SET compacted = 1, updated_at = ? WHERE id = ?`, [now, childId]);
+                // Archive their artifacts
+                const archiveResult = deps.conn.run(`UPDATE core_artifacts SET lifecycle_state = 'ARCHIVED' WHERE mission_id = ? AND lifecycle_state = 'ACTIVE'`, [childId]);
+                totalArchived += archiveResult.changes;
+                // Recursively compact grandchildren that are completed
+                const grandchildren = deps.conn.query(`SELECT id FROM core_missions WHERE parent_id = ? AND state = 'COMPLETED' AND compacted = 0`, [childId]);
+                for (const gc of grandchildren) {
+                    deps.conn.run(`UPDATE core_missions SET compacted = 1, updated_at = ? WHERE id = ?`, [now, gc.id]);
+                    const gcArchive = deps.conn.run(`UPDATE core_artifacts SET lifecycle_state = 'ARCHIVED' WHERE mission_id = ? AND lifecycle_state = 'ACTIVE'`, [gc.id]);
+                    totalArchived += gcArchive.changes;
+                    childIds.push(gc.id);
+                }
+            }
+            // Create summary artifact for the compaction
+            const summaryArtifactId = generateId();
+            const summaryContent = JSON.stringify({
+                compactedMissions: childIds,
+                totalArchived,
+                compactedAt: now,
+                parentMission: completedMissionId,
+            });
+            // FM-10: tenant_id inherited from mission
+            deps.conn.run(`INSERT INTO core_artifacts (id, version, mission_id, tenant_id, name, type, format, content, lifecycle_state, source_task_id, parent_artifact_id, relevance_decay, metadata_json, created_at)
+         VALUES (?, 1, ?, ?, 'compaction_summary', 'report', 'json', ?, 'ACTIVE', 'compaction', NULL, 0, ?, ?)`, [summaryArtifactId, completedMissionId, mission.tenant_id, Buffer.from(summaryContent, 'utf-8'), JSON.stringify({ compactionId }), now]);
+            // Log the compaction
+            // FM-10: tenant_id inherited from mission
+            deps.conn.run(`INSERT INTO core_compaction_log (id, mission_id, tenant_id, summary_artifact_id, missions_compacted, artifacts_archived, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`, [compactionId, completedMissionId, mission.tenant_id, summaryArtifactId, JSON.stringify(childIds), totalArchived, now]);
+            // I-03: Audit entry
+            deps.audit.append(deps.conn, {
+                tenantId: mission.tenant_id,
+                actorType: 'system',
+                actorId: 'compaction_engine',
+                operation: 'compact_subtree',
+                resourceType: 'mission',
+                resourceId: completedMissionId,
+                detail: { childIds, totalArchived, compactionId },
+            });
+        });
+        return { ok: true, value: undefined };
+    }
+    /**
+     * I-21: Get working set -- non-compacted, active missions in a tree.
+     * SD-07: Uses the working-set partial index for O(1) query.
+     */
+    function getWorkingSet(deps, rootMissionId) {
+        // Get all non-compacted, non-terminal missions in the tree
+        // Start from root and walk down
+        const working = [];
+        function walk(missionId) {
+            const mission = deps.conn.get('SELECT id, state, compacted FROM core_missions WHERE id = ?', [missionId]);
+            if (!mission)
+                return;
+            const terminalStates = ['COMPLETED', 'FAILED', 'CANCELLED'];
+            if (mission.compacted === 0 && !terminalStates.includes(mission.state)) {
+                working.push(mission.id);
+            }
+            // Walk children
+            const children = deps.conn.query('SELECT id FROM core_missions WHERE parent_id = ?', [missionId]);
+            for (const child of children) {
+                walk(child.id);
+            }
+        }
+        walk(rootMissionId);
+        return { ok: true, value: working };
+    }
+    return Object.freeze({
+        compactSubtree,
+        getWorkingSet,
+    });
+}
+//# sourceMappingURL=bounded_cognition.js.map

package/dist/orchestration/compaction/bounded_cognition.js.map

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

package/dist/orchestration/conversation/conversation_manager.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Conversation Manager -- Conversation history and auto-summarization.
+ * S ref: S26 (Conversation Model), I-27 (conversation integrity),
+ *        I-21 (bounded cognition via summarization), I-03 (atomic audit)
+ *
+ * Phase: 3 (Orchestration)
+ * Implements: Conversation CRUD, turn appending with monotonic numbering,
+ *             auto-summarization when context window threshold exceeded,
+ *             fork (copy-on-branch) for branching conversations,
+ *             learning-source exemption (turns marked is_learning_source
+ *             are never summarized away).
+ *
+ * SD-25: summarized_up_to tracks which turns have been summarized.
+ *        Only turns with turn_number <= summarized_up_to are eligible
+ *        for replacement by a summary turn.
+ * SD-26: Fork copies all turns up to atTurn into a new conversation
+ *        linked via parent_conversation_id.
+ */
+import type { ConversationManager } from '../interfaces/orchestration.js';
+/**
+ * S26: Create the conversation manager module.
+ * Factory function returns frozen object per C-07.
+ */
+export declare function createConversationManager(): ConversationManager;
+//# sourceMappingURL=conversation_manager.d.ts.map

package/dist/orchestration/conversation/conversation_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation_manager.d.ts","sourceRoot":"","sources":["../../../src/orchestration/conversation/conversation_manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EACS,mBAAmB,EACvC,MAAM,gCAAgC,CAAC;AAGxC;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,CAuV/D"}

package/dist/orchestration/conversation/conversation_manager.js

@@ -0,0 +1,260 @@
+/**
+ * Conversation Manager -- Conversation history and auto-summarization.
+ * S ref: S26 (Conversation Model), I-27 (conversation integrity),
+ *        I-21 (bounded cognition via summarization), I-03 (atomic audit)
+ *
+ * Phase: 3 (Orchestration)
+ * Implements: Conversation CRUD, turn appending with monotonic numbering,
+ *             auto-summarization when context window threshold exceeded,
+ *             fork (copy-on-branch) for branching conversations,
+ *             learning-source exemption (turns marked is_learning_source
+ *             are never summarized away).
+ *
+ * SD-25: summarized_up_to tracks which turns have been summarized.
+ *        Only turns with turn_number <= summarized_up_to are eligible
+ *        for replacement by a summary turn.
+ * SD-26: Fork copies all turns up to atTurn into a new conversation
+ *        linked via parent_conversation_id.
+ */
+import { generateId } from '../interfaces/orchestration.js';
+/**
+ * S26: Create the conversation manager module.
+ * Factory function returns frozen object per C-07.
+ */
+export function createConversationManager() {
+    /** S26: Create a new conversation */
+    function create(deps, sessionId, agentId, tenantId) {
+        const conversationId = generateId();
+        const now = deps.time.nowISO();
+        deps.conn.transaction(() => {
+            deps.conn.run(`INSERT INTO core_conversations (id, session_id, tenant_id, agent_id, parent_conversation_id, fork_at_turn, total_turns, total_tokens, summarized_up_to, created_at, updated_at)
+         VALUES (?, ?, ?, ?, NULL, NULL, 0, 0, 0, ?, ?)`, [conversationId, sessionId, tenantId, agentId, now, now]);
+            // F-05 fix: I-03 audit entry for conversation creation
+            deps.audit.append(deps.conn, {
+                tenantId,
+                actorType: 'system',
+                actorId: agentId,
+                operation: 'create_conversation',
+                resourceType: 'conversation',
+                resourceId: conversationId,
+                detail: { sessionId },
+            });
+        });
+        return { ok: true, value: conversationId };
+    }
+    /** S26.1: Append a turn to conversation. Returns the new turn number. */
+    function appendTurn(deps, conversationId, turn) {
+        // Get current conversation state
+        const conv = deps.conn.get('SELECT total_turns, total_tokens, tenant_id FROM core_conversations WHERE id = ?', [conversationId]);
+        if (!conv) {
+            return { ok: false, error: { code: 'NOT_FOUND', message: `Conversation ${conversationId} not found`, spec: 'S26' } };
+        }
+        const turnNumber = conv.total_turns + 1;
+        const turnId = generateId();
+        const now = deps.time.nowISO();
+        deps.conn.transaction(() => {
+            // FM-10: tenant_id inherited from parent conversation
+            deps.conn.run(`INSERT INTO core_conversation_turns (id, conversation_id, tenant_id, turn_number, role, content, token_count, model_used, is_summary, is_learning_source, participant_id, metadata_json, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, 0, ?, ?, NULL, ?)`, [
+                turnId,
+                conversationId,
+                conv.tenant_id,
+                turnNumber,
+                turn.role,
+                turn.content,
+                turn.tokenCount,
+                turn.modelUsed ?? null,
+                (turn.isLearningSource ?? false) ? 1 : 0,
+                turn.participantId ?? null,
+                now,
+            ]);
+            // Update conversation metadata
+            deps.conn.run(`UPDATE core_conversations SET total_turns = ?, total_tokens = total_tokens + ?, updated_at = ? WHERE id = ?`, [turnNumber, turn.tokenCount, now, conversationId]);
+            // F-05 fix: I-03 audit entry for turn append
+            deps.audit.append(deps.conn, {
+                tenantId: conv.tenant_id,
+                actorType: 'system',
+                actorId: turn.participantId ?? 'system',
+                operation: 'append_turn',
+                resourceType: 'conversation_turn',
+                resourceId: turnId,
+                detail: { conversationId, turnNumber, role: turn.role },
+            });
+        });
+        return { ok: true, value: turnNumber };
+    }
+    /**
+     * S26.2: Auto-summarize if context window threshold exceeded.
+     * SD-25: Only turns with turn_number > summarized_up_to and
+     *        is_learning_source = 0 are eligible for summarization.
+     *        Replaces eligible turns with a single summary turn.
+     * Returns true if summarization occurred, false if not needed.
+     */
+    function autoSummarize(deps, conversationId, contextWindowTokens) {
+        const conv = deps.conn.get('SELECT total_tokens, summarized_up_to, total_turns, tenant_id FROM core_conversations WHERE id = ?', [conversationId]);
+        if (!conv) {
+            return { ok: false, error: { code: 'NOT_FOUND', message: `Conversation ${conversationId} not found`, spec: 'S26' } };
+        }
+        // Check if we exceed the context window threshold (80% triggers summarization)
+        const threshold = Math.floor(contextWindowTokens * 0.8);
+        if (conv.total_tokens <= threshold) {
+            return { ok: true, value: false };
+        }
+        // Get eligible turns (not already summarized, not learning-source, not summary)
+        // CF-034b: Include role for semantic-preserving summaries
+        const eligibleTurns = deps.conn.query(`SELECT turn_number, role, content, token_count FROM core_conversation_turns
+       WHERE conversation_id = ? AND turn_number > ? AND is_learning_source = 0 AND is_summary = 0
+       ORDER BY turn_number ASC`, [conversationId, conv.summarized_up_to]);
+        if (eligibleTurns.length <= 2) {
+            // Too few turns to summarize meaningfully
+            return { ok: true, value: false };
+        }
+        // Determine how many turns to summarize (keep last 2 eligible)
+        const turnsToSummarize = eligibleTurns.slice(0, -2);
+        if (turnsToSummarize.length === 0) {
+            return { ok: true, value: false };
+        }
+        // CF-034b: Improved summary that preserves semantic content (I-27).
+        // Keep the first turn's content more fully (it often sets the context),
+        // and extract key sentences from middle turns rather than blind truncation.
+        const summaryContent = turnsToSummarize.map((t, idx) => {
+            const maxLen = idx === 0 ? 500 : 300; // First turn gets more space
+            const truncated = t.content.length > maxLen
+                ? t.content.substring(0, maxLen) + '...'
+                : t.content;
+            return `[Turn ${t.turn_number} (${t.role})]: ${truncated}`;
+        }).join('\n');
+        const summarizedTokens = turnsToSummarize.reduce((sum, t) => sum + t.token_count, 0);
+        // Summary is roughly 20% of the original
+        const summaryTokens = Math.max(Math.floor(summarizedTokens * 0.2), 10);
+        const lastSummarizedTurn = turnsToSummarize[turnsToSummarize.length - 1].turn_number;
+        const now = deps.time.nowISO();
+        const summaryTurnId = generateId();
+        deps.conn.transaction(() => {
+            // Insert summary turn at the next turn number
+            const nextTurn = conv.total_turns + 1;
+            // FM-10: tenant_id inherited from parent conversation
+            deps.conn.run(`INSERT INTO core_conversation_turns (id, conversation_id, tenant_id, turn_number, role, content, token_count, model_used, is_summary, is_learning_source, participant_id, metadata_json, created_at)
+         VALUES (?, ?, ?, ?, 'system', ?, ?, NULL, 1, 0, NULL, ?, ?)`, [summaryTurnId, conversationId, conv.tenant_id, nextTurn, `[Summary of turns ${conv.summarized_up_to + 1}-${lastSummarizedTurn}]\n${summaryContent}`, summaryTokens, JSON.stringify({ summarizedTurns: turnsToSummarize.length, originalTokens: summarizedTokens }), now]);
+            // Update conversation metadata
+            deps.conn.run(`UPDATE core_conversations SET summarized_up_to = ?, total_turns = ?, total_tokens = total_tokens - ? + ?, updated_at = ? WHERE id = ?`, [lastSummarizedTurn, nextTurn, summarizedTokens, summaryTokens, now, conversationId]);
+            // F-05 fix: I-03 audit entry for auto-summarization
+            deps.audit.append(deps.conn, {
+                tenantId: conv.tenant_id,
+                actorType: 'system',
+                actorId: 'conversation_manager',
+                operation: 'auto_summarize',
+                resourceType: 'conversation',
+                resourceId: conversationId,
+                detail: { summarizedTurns: turnsToSummarize.length, originalTokens: summarizedTokens, summaryTokens, summarizedUpTo: lastSummarizedTurn },
+            });
+        });
+        return { ok: true, value: true };
+    }
+    /**
+     * S26.3: Fork a conversation at a turn (copy-on-branch).
+     * SD-26: Copies all turns up to atTurn into a new conversation
+     *        linked via parent_conversation_id.
+     */
+    function fork(deps, conversationId, atTurn, tenantId) {
+        // F-09 fix: Include tenant_id in query to prevent cross-tenant fork (T-4)
+        // If tenantId is provided, verify source conversation belongs to same tenant.
+        // If tenantId is null (single-tenant mode), skip tenant check.
+        let conv;
+        if (tenantId !== null) {
+            conv = deps.conn.get('SELECT session_id, agent_id, total_turns FROM core_conversations WHERE id = ? AND tenant_id = ?', [conversationId, tenantId]);
+        }
+        else {
+            conv = deps.conn.get('SELECT session_id, agent_id, total_turns FROM core_conversations WHERE id = ?', [conversationId]);
+        }
+        if (!conv) {
+            return { ok: false, error: { code: 'NOT_FOUND', message: `Conversation ${conversationId} not found`, spec: 'S26' } };
+        }
+        if (atTurn > conv.total_turns || atTurn < 0) {
+            return { ok: false, error: { code: 'NOT_FOUND', message: `Turn ${atTurn} out of range (max ${conv.total_turns})`, spec: 'S26' } };
+        }
+        const forkedId = generateId();
+        const now = deps.time.nowISO();
+        deps.conn.transaction(() => {
+            // Get turns to copy
+            const turns = deps.conn.query(`SELECT turn_number, role, content, token_count, model_used, is_summary, is_learning_source, participant_id, metadata_json
+         FROM core_conversation_turns WHERE conversation_id = ? AND turn_number <= ? ORDER BY turn_number ASC`, [conversationId, atTurn]);
+            const totalTokens = turns.reduce((sum, t) => sum + t['token_count'], 0);
+            // Create forked conversation
+            deps.conn.run(`INSERT INTO core_conversations (id, session_id, tenant_id, agent_id, parent_conversation_id, fork_at_turn, total_turns, total_tokens, summarized_up_to, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, 0, ?, ?)`, [forkedId, conv.session_id, tenantId, conv.agent_id, conversationId, atTurn, turns.length, totalTokens, now, now]);
+            // Copy turns
+            // FM-10: tenant_id inherited from parent conversation
+            for (const turn of turns) {
+                const turnId = generateId();
+                deps.conn.run(`INSERT INTO core_conversation_turns (id, conversation_id, tenant_id, turn_number, role, content, token_count, model_used, is_summary, is_learning_source, participant_id, metadata_json, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+                    turnId,
+                    forkedId,
+                    tenantId,
+                    turn['turn_number'],
+                    turn['role'],
+                    turn['content'],
+                    turn['token_count'],
+                    turn['model_used'],
+                    turn['is_summary'],
+                    turn['is_learning_source'],
+                    turn['participant_id'],
+                    turn['metadata_json'],
+                    now,
+                ]);
+            }
+            // F-05 fix: I-03 audit entry for conversation fork
+            deps.audit.append(deps.conn, {
+                tenantId,
+                actorType: 'system',
+                actorId: 'conversation_manager',
+                operation: 'fork_conversation',
+                resourceType: 'conversation',
+                resourceId: forkedId,
+                detail: { sourceConversationId: conversationId, atTurn, turnsCopied: turns.length },
+            });
+        });
+        return { ok: true, value: forkedId };
+    }
+    /**
+     * S26: Get conversation turns for context assembly.
+     * CF-034b: Filters out turns that have been superseded by summarization.
+     * Only returns: summary turns + unsummarized turns (turn_number > summarized_up_to).
+     * This ensures that summarization actually reduces the context window.
+     */
+    function getTurns(deps, conversationId) {
+        // Look up summarized_up_to to filter out superseded turns
+        const conv = deps.conn.get('SELECT summarized_up_to FROM core_conversations WHERE id = ?', [conversationId]);
+        const summarizedUpTo = conv?.summarized_up_to ?? 0;
+        // Return: summary turns (is_summary=1) + turns after the summarization boundary
+        // This excludes original turns that were replaced by summaries.
+        const rows = deps.conn.query(`SELECT id, conversation_id, turn_number, role, content, token_count, model_used, is_summary, is_learning_source, participant_id, created_at
+       FROM core_conversation_turns
+       WHERE conversation_id = ?
+         AND (is_summary = 1 OR turn_number > ? OR is_learning_source = 1)
+       ORDER BY turn_number ASC`, [conversationId, summarizedUpTo]);
+        const turns = rows.map(row => ({
+            id: row['id'],
+            conversationId: row['conversation_id'],
+            turnNumber: row['turn_number'],
+            role: row['role'],
+            content: row['content'],
+            tokenCount: row['token_count'],
+            modelUsed: (row['model_used'] ?? null),
+            isSummary: row['is_summary'] === 1,
+            isLearningSource: row['is_learning_source'] === 1,
+            participantId: (row['participant_id'] ?? null),
+            createdAt: row['created_at'],
+        }));
+        return { ok: true, value: turns };
+    }
+    return Object.freeze({
+        create,
+        appendTurn,
+        autoSummarize,
+        fork,
+        getTurns,
+    });
+}
+//# sourceMappingURL=conversation_manager.js.map

package/dist/orchestration/conversation/conversation_manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation_manager.js","sourceRoot":"","sources":["../../../src/orchestration/conversation/conversation_manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IAEvC,qCAAqC;IACrC,SAAS,MAAM,CACb,IAAuB,EACvB,SAAoB,EACpB,OAAgB,EAChB,QAAyB;QAEzB,MAAM,cAAc,GAAG,UAAU,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAE/B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE;YACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CACX;wDACgD,EAChD,CAAC,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,CACzD,CAAC;YAEF,uDAAuD;YACvD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;gBAC3B,QAAQ;gBACR,SAAS,EAAE,QAAQ;gBACnB,OAAO,EAAE,OAAiB;gBAC1B,SAAS,EAAE,qBAAqB;gBAChC,YAAY,EAAE,cAAc;gBAC5B,UAAU,EAAE,cAAc;gBAC1B,MAAM,EAAE,EAAE,SAAS,EAAE;aACtB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAC7C,CAAC;IAED,yEAAyE;IACzE,SAAS,UAAU,CACjB,IAAuB,EACvB,cAAsB,EACtB,IAOC;QAED,iCAAiC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CACxB,kFAAkF,EAClF,CAAC,cAAc,CAAC,CACjB,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,cAAc,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvH,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAE/B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE;YACzB,sDAAsD;YACtD,IAAI,CAAC,IAAI,CAAC,GAAG,CACX;2DACmD,EACnD;gBACE,MAAM;gBACN,cAAc;gBACd,IAAI,CAAC,SAAS;gBACd,UAAU;gBACV,IAAI,CAAC,IAAI;gBACT,IAAI,CAAC,OAAO;gBACZ,IAAI,CAAC,UAAU;gBACf,IAAI,CAAC,SAAS,IAAI,IAAI;gBACtB,CAAC,IAAI,CAAC,gBAAgB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxC,IAAI,CAAC,aAAa,IAAI,IAAI;gBAC1B,GAAG;aACJ,CACF,CAAC;YAEF,+BAA+B;YAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CACX,6GAA6G,EAC7G,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE,cAAc,CAAC,CACnD,CAAC;YAEF,6CAA6C;YAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;gBAC3B,QAAQ,EAAE,IAAI,CAAC,SAAS;gBACxB,SAAS,EAAE,QAAQ;gBACnB,OAAO,EAAE,IAAI,CAAC,aAAa,IAAI,QAAQ;gBACvC,SAAS,EAAE,aAAa;gBACxB,YAAY,EAAE,mBAAmB;gBACjC,UAAU,EAAE,MAAM;gBAClB,MAAM,EAAE,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;aACxD,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IACzC,CAAC;IAED;;;;;;OAMG;IACH,SAAS,aAAa,CACpB,IAAuB,EACvB,cAAsB,EACtB,mBAA2B;QAE3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CACxB,oGAAoG,EACpG,CAAC,cAAc,CAAC,CACjB,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,cAAc,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvH,CAAC;QAED,+EAA+E;QAC/E,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,GAAG,CAAC,CAAC;QACxD,IAAI,IAAI,CAAC,YAAY,IAAI,SAAS,EAAE,CAAC;YACnC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC;QAED,gFAAgF;QAChF,0DAA0D;QAC1D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CACnC;;gCAE0B,EAC1B,CAAC,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,CACxC,CAAC;QAEF,IAAI,aAAa,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC9B,0CAA0C;YAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC;QAED,+DAA+D;QAC/D,MAAM,gBAAgB,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACpD,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC;QAED,oEAAoE;QACpE,wEAAwE;QACxE,4EAA4E;QAC5E,MAAM,cAAc,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;YACrD,MAAM,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,6BAA6B;YACnE,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM;gBACzC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,KAAK;gBACxC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YACd,OAAO,SAAS,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,IAAI,OAAO,SAAS,EAAE,CAAC;QAC7D,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACrF,yCAAyC;QACzC,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,WAAW,CAAC;QAEtF,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAC/B,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC;QAEnC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE;YACzB,8CAA8C;YAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;YACtC,sDAAsD;YACtD,IAAI,CAAC,IAAI,CAAC,GAAG,CACX;qEAC6D,EAC7D,CAAC,aAAa,EAAE,cAAc,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,qBAAqB,IAAI,CAAC,gBAAgB,GAAG,CAAC,IAAI,kBAAkB,MAAM,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,EAAE,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC,EAAE,GAAG,CAAC,CAC1Q,CAAC;YAEF,+BAA+B;YAC/B,IAAI,CAAC,IAAI,CAAC,GAAG,CACX,uIAAuI,EACvI,CAAC,kBAAkB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,GAAG,EAAE,cAAc,CAAC,CACrF,CAAC;YAEF,oDAAoD;YACpD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;gBAC3B,QAAQ,EAAE,IAAI,CAAC,SAAS;gBACxB,SAAS,EAAE,QAAQ;gBACnB,OAAO,EAAE,sBAAsB;gBAC/B,SAAS,EAAE,gBAAgB;gBAC3B,YAAY,EAAE,cAAc;gBAC5B,UAAU,EAAE,cAAc;gBAC1B,MAAM,EAAE,EAAE,eAAe,EAAE,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,kBAAkB,EAAE;aAC1I,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;IAED;;;;OAIG;IACH,SAAS,IAAI,CACX,IAAuB,EACvB,cAAsB,EACtB,MAAc,EACd,QAAyB;QAEzB,0EAA0E;QAC1E,8EAA8E;QAC9E,+DAA+D;QAC/D,IAAI,IAA+E,CAAC;QACpF,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,iGAAiG,EACjG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAC3B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAClB,+EAA+E,EAC/E,CAAC,cAAc,CAAC,CACjB,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,cAAc,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACvH,CAAC;QAED,IAAI,MAAM,GAAG,IAAI,CAAC,WAAW,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,MAAM,sBAAsB,IAAI,CAAC,WAAW,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpI,CAAC;QAED,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAE/B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE;YACzB,oBAAoB;YACpB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAC3B;8GACsG,EACtG,CAAC,cAAc,EAAE,MAAM,CAAC,CACzB,CAAC;YAEF,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAI,CAAC,CAAC,aAAa,CAAY,EAAE,CAAC,CAAC,CAAC;YAEpF,6BAA6B;YAC7B,IAAI,CAAC,IAAI,CAAC,GAAG,CACX;kDAC0C,EAC1C,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,CAAC,CAClH,CAAC;YAEF,aAAa;YACb,sDAAsD;YACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CACX;0DACgD,EAChD;oBACE,MAAM;oBACN,QAAQ;oBACR,QAAQ;oBACR,IAAI,CAAC,aAAa,CAAC;oBACnB,IAAI,CAAC,MAAM,CAAC;oBACZ,IAAI,CAAC,SAAS,CAAC;oBACf,IAAI,CAAC,aAAa,CAAC;oBACnB,IAAI,CAAC,YAAY,CAAC;oBAClB,IAAI,CAAC,YAAY,CAAC;oBAClB,IAAI,CAAC,oBAAoB,CAAC;oBAC1B,IAAI,CAAC,gBAAgB,CAAC;oBACtB,IAAI,CAAC,eAAe,CAAC;oBACrB,GAAG;iBACJ,CACF,CAAC;YACJ,CAAC;YAED,mDAAmD;YACnD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;gBAC3B,QAAQ;gBACR,SAAS,EAAE,QAAQ;gBACnB,OAAO,EAAE,sBAAsB;gBAC/B,SAAS,EAAE,mBAAmB;gBAC9B,YAAY,EAAE,cAAc;gBAC5B,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,EAAE;aACpF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,SAAS,QAAQ,CACf,IAAuB,EACvB,cAAsB;QAEtB,0DAA0D;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CACxB,8DAA8D,EAC9D,CAAC,cAAc,CAAC,CACjB,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,EAAE,gBAAgB,IAAI,CAAC,CAAC;QAEnD,gFAAgF;QAChF,gEAAgE;QAChE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAC1B;;;;gCAI0B,EAC1B,CAAC,cAAc,EAAE,cAAc,CAAC,CACjC,CAAC;QAEF,MAAM,KAAK,GAAuB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACjD,EAAE,EAAE,GAAG,CAAC,IAAI,CAAW;YACvB,cAAc,EAAE,GAAG,CAAC,iBAAiB,CAAW;YAChD,UAAU,EAAE,GAAG,CAAC,aAAa,CAAW;YACxC,IAAI,EAAE,GAAG,CAAC,MAAM,CAA6B;YAC7C,OAAO,EAAE,GAAG,CAAC,SAAS,CAAW;YACjC,UAAU,EAAE,GAAG,CAAC,aAAa,CAAW;YACxC,SAAS,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,IAAI,CAAkB;YACvD,SAAS,EAAG,GAAG,CAAC,YAAY,CAAY,KAAK,CAAC;YAC9C,gBAAgB,EAAG,GAAG,CAAC,oBAAoB,CAAY,KAAK,CAAC;YAC7D,aAAa,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAkB;YAC/D,SAAS,EAAE,GAAG,CAAC,YAAY,CAAW;SACvC,CAAC,CAAC,CAAC;QAEJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM;QACN,UAAU;QACV,aAAa;QACb,IAAI;QACJ,QAAQ;KACT,CAAC,CAAC;AACL,CAAC"}

package/dist/orchestration/events/event_propagation.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Event Propagation -- Event routing through mission trees.
+ * S ref: S10 (Event), S20 (emit_event), FM-13 (unbounded autonomy),
+ *        I-03 (atomic audit)
+ *
+ * Phase: 3 (Orchestration)
+ * Implements: Event emission with namespace validation, propagation
+ *             direction (up/down/local), lifecycle event restriction,
+ *             rate limiting per agent (10/minute per S36).
+ *
+ * SD-09: Reserved namespaces (system.*, lifecycle.*) are rejected from agent emission.
+ * SD-16: Rate limiting is enforced per agent, not per mission.
+ */
+import type { EventPropagator } from '../interfaces/orchestration.js';
+/**
+ * S10: Create the event propagation module.
+ * Factory function returns frozen object per C-07.
+ */
+export declare function createEventPropagator(): EventPropagator;
+//# sourceMappingURL=event_propagation.d.ts.map

package/dist/orchestration/events/event_propagation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event_propagation.d.ts","sourceRoot":"","sources":["../../../src/orchestration/events/event_propagation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EACS,eAAe,EAEnC,MAAM,gCAAgC,CAAC;AASxC;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAsLvD"}