opentasks 0.0.1 → 0.0.2

package/dist/daemon/entire-linker.js

@@ -0,0 +1,439 @@
+/**
+ * Entire Auto-Linker
+ *
+ * Correlation engine that automatically creates edges between OpenTasks
+ * tasks and Entire sessions/checkpoints. Matches sessions to tasks via
+ * claims, in-progress status, and branch association.
+ */
+// ============================================================================
+// Confidence Ordering
+// ============================================================================
+const CONFIDENCE_ORDER = {
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+function meetsConfidenceThreshold(confidence, minimum) {
+    return CONFIDENCE_ORDER[confidence] >= CONFIDENCE_ORDER[minimum];
+}
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Create an Entire auto-linker
+ */
+export function createEntireAutoLinker(config) {
+    const { store, flushManager, archiver } = config;
+    const minConfidence = config.minConfidence ?? 'medium';
+    // Track which sessions have been linked to avoid duplicates
+    const correlations = new Map();
+    // Track created external nodes: URI → node ID mapping
+    const createdNodes = new Map();
+    /**
+     * Find tasks correlated with a session
+     */
+    async function findCorrelatedTasks(session) {
+        const matched = [];
+        // Strategy 1: Claimed tasks (high confidence)
+        try {
+            const allIssues = await store.query.nodes({
+                type: 'task',
+                status: 'in_progress',
+                archived: false,
+            });
+            for (const issue of allIssues) {
+                const raw = issue;
+                const claimedBy = raw.claimed_by;
+                const lockUntil = raw.lock_until;
+                if (claimedBy && (!lockUntil || new Date(lockUntil) > new Date())) {
+                    matched.push({
+                        nodeId: issue.id,
+                        uri: raw.uri,
+                        matchReason: 'claimed-task',
+                        confidence: 'high',
+                    });
+                }
+            }
+        }
+        catch {
+            // Continue to next strategy
+        }
+        if (matched.length > 0)
+            return matched;
+        // Strategy 2: In-progress tasks on same branch (medium confidence)
+        if (session.branch) {
+            try {
+                const allIssues = await store.query.nodes({
+                    type: 'task',
+                    status: 'in_progress',
+                    archived: false,
+                });
+                for (const issue of allIssues) {
+                    const raw = issue;
+                    if (raw.branch === session.branch) {
+                        matched.push({
+                            nodeId: issue.id,
+                            uri: raw.uri,
+                            matchReason: 'in-progress-branch',
+                            confidence: 'medium',
+                        });
+                    }
+                }
+            }
+            catch {
+                // Continue to next strategy
+            }
+        }
+        if (matched.length > 0)
+            return matched;
+        // Strategy 3: Any in-progress task (low confidence)
+        // Only if exactly one in-progress task exists (ambiguity guard)
+        try {
+            const allInProgress = await store.query.nodes({
+                type: 'task',
+                status: 'in_progress',
+                archived: false,
+            });
+            if (allInProgress.length === 1) {
+                const raw = allInProgress[0];
+                matched.push({
+                    nodeId: allInProgress[0].id,
+                    uri: raw.uri,
+                    matchReason: 'in-progress-any',
+                    confidence: 'low',
+                });
+            }
+        }
+        catch {
+            // No matches
+        }
+        return matched;
+    }
+    /**
+     * Ensure an external node exists for an Entire session.
+     * Returns the node's actual graph ID (not the URI).
+     */
+    async function ensureSessionNode(session) {
+        const uri = `entire://session/${session.id}`;
+        const cachedId = createdNodes.get(uri);
+        if (cachedId)
+            return cachedId;
+        // Check if node already exists
+        const existing = await store.query.nodes({
+            type: 'external',
+            search: uri,
+            limit: 1,
+        });
+        if (existing.length > 0) {
+            const nodeId = existing[0].id;
+            createdNodes.set(uri, nodeId);
+            return nodeId;
+        }
+        try {
+            const node = await store.createNode({
+                type: 'external',
+                title: `Session: ${session.id}`,
+                uri,
+                source: 'entire',
+                metadata: {
+                    entityType: 'session',
+                    agent: session.agent,
+                    phase: session.phase,
+                    baseCommit: session.baseCommit,
+                    branch: session.branch,
+                    startedAt: session.startedAt,
+                },
+            });
+            const nodeId = node.id;
+            createdNodes.set(uri, nodeId);
+            flushManager.markDirty(nodeId);
+            flushManager.schedule();
+            return nodeId;
+        }
+        catch {
+            // Node may already exist from a concurrent operation — re-query
+            const retryExisting = await store.query.nodes({
+                type: 'external',
+                search: uri,
+                limit: 1,
+            });
+            if (retryExisting.length > 0) {
+                const nodeId = retryExisting[0].id;
+                createdNodes.set(uri, nodeId);
+                return nodeId;
+            }
+            // Fallback: use URI as ID (should not happen in practice)
+            createdNodes.set(uri, uri);
+            return uri;
+        }
+    }
+    /**
+     * Ensure an external node exists for an Entire checkpoint.
+     * Returns the node's actual graph ID (not the URI).
+     */
+    async function ensureCheckpointNode(checkpointId, session) {
+        const uri = `entire://checkpoint/${checkpointId}`;
+        const cachedId = createdNodes.get(uri);
+        if (cachedId)
+            return cachedId;
+        // Check if node already exists
+        const existing = await store.query.nodes({
+            type: 'external',
+            search: uri,
+            limit: 1,
+        });
+        if (existing.length > 0) {
+            const nodeId = existing[0].id;
+            createdNodes.set(uri, nodeId);
+            return nodeId;
+        }
+        try {
+            const node = await store.createNode({
+                type: 'external',
+                title: `Checkpoint: ${checkpointId}`,
+                uri,
+                source: 'entire',
+                metadata: {
+                    entityType: 'checkpoint',
+                    sessionId: session.id,
+                },
+            });
+            const nodeId = node.id;
+            createdNodes.set(uri, nodeId);
+            flushManager.markDirty(nodeId);
+            flushManager.schedule();
+            return nodeId;
+        }
+        catch {
+            // Re-query in case of concurrent creation
+            const retryExisting = await store.query.nodes({
+                type: 'external',
+                search: uri,
+                limit: 1,
+            });
+            if (retryExisting.length > 0) {
+                const nodeId = retryExisting[0].id;
+                createdNodes.set(uri, nodeId);
+                return nodeId;
+            }
+            createdNodes.set(uri, uri);
+            return uri;
+        }
+    }
+    /**
+     * Create an edge if it doesn't already exist
+     */
+    async function createEdgeIfNotExists(fromId, toId, type, metadata) {
+        // Check for existing edge
+        try {
+            const existingEdges = await store.query.edges({
+                from_id: fromId,
+                to_id: toId,
+                type,
+            });
+            if (existingEdges.length > 0) {
+                return existingEdges[0].id;
+            }
+        }
+        catch {
+            // Continue to create
+        }
+        try {
+            const edge = await store.createEdge({
+                from_id: fromId,
+                to_id: toId,
+                type,
+                metadata: {
+                    ...metadata,
+                    _context: {
+                        source: 'entire-auto-linker',
+                        timestamp: new Date().toISOString(),
+                        ...metadata?._context,
+                    },
+                },
+            });
+            flushManager.markDirty(fromId);
+            flushManager.markDirty(toId);
+            flushManager.schedule();
+            return edge.id;
+        }
+        catch {
+            return null;
+        }
+    }
+    return {
+        async handleSessionEvent(event) {
+            const { type, sessionId, session } = event;
+            switch (type) {
+                case 'started': {
+                    // Create session node — returns the node's graph ID
+                    const sessionNodeId = await ensureSessionNode(session);
+                    // Correlate with tasks
+                    const tasks = await findCorrelatedTasks(session);
+                    const edgesCreated = [];
+                    const matchedForResult = [];
+                    for (const task of tasks) {
+                        if (!meetsConfidenceThreshold(task.confidence, minConfidence))
+                            continue;
+                        matchedForResult.push(task);
+                        const edgeId = await createEdgeIfNotExists(task.nodeId, sessionNodeId, 'worked-on', {
+                            _context: {
+                                correlation: task.matchReason,
+                                confidence: task.confidence,
+                                sessionAgent: session.agent,
+                            },
+                        });
+                        if (edgeId)
+                            edgesCreated.push(edgeId);
+                    }
+                    correlations.set(sessionId, {
+                        sessionId,
+                        matchedTasks: matchedForResult,
+                        edgesCreated,
+                        nodesCreated: [sessionNodeId],
+                        strategy: matchedForResult[0]?.matchReason ?? 'none',
+                        timestamp: new Date().toISOString(),
+                    });
+                    // Archive if configured
+                    if (archiver) {
+                        const sessionUri = `entire://session/${session.id}`;
+                        void archiver.onSessionEvent('started', sessionUri, store).catch(() => { });
+                    }
+                    break;
+                }
+                case 'checkpoint': {
+                    if (!event.checkpointId)
+                        break;
+                    // Ensure session and checkpoint nodes exist — returns graph IDs
+                    const sessionNodeId = await ensureSessionNode(session);
+                    const checkpointNodeId = await ensureCheckpointNode(event.checkpointId, session);
+                    const edgesCreated = [];
+                    // Create contains edge (session → checkpoint)
+                    const containsId = await createEdgeIfNotExists(sessionNodeId, checkpointNodeId, 'contains');
+                    if (containsId)
+                        edgesCreated.push(containsId);
+                    // Create implemented-by edges (tasks → checkpoint)
+                    const tasks = await findCorrelatedTasks(session);
+                    const matchedForResult = [];
+                    for (const task of tasks) {
+                        if (!meetsConfidenceThreshold(task.confidence, minConfidence))
+                            continue;
+                        matchedForResult.push(task);
+                        const edgeId = await createEdgeIfNotExists(task.nodeId, checkpointNodeId, 'implemented-by', {
+                            _context: {
+                                correlation: task.matchReason,
+                                confidence: task.confidence,
+                                checkpointId: event.checkpointId,
+                            },
+                        });
+                        if (edgeId)
+                            edgesCreated.push(edgeId);
+                    }
+                    // Update existing correlation record
+                    const existing = correlations.get(sessionId);
+                    if (existing) {
+                        existing.edgesCreated.push(...edgesCreated);
+                        existing.nodesCreated.push(checkpointNodeId);
+                    }
+                    // Archive checkpoint if configured
+                    if (archiver) {
+                        const sessionUri = `entire://session/${session.id}`;
+                        void archiver.onSessionEvent('checkpoint', sessionUri, store).catch(() => { });
+                    }
+                    break;
+                }
+                case 'ended': {
+                    // Update session node status if it exists
+                    try {
+                        const nodes = await store.query.nodes({
+                            type: 'external',
+                            search: `entire://session/${sessionId}`,
+                            limit: 1,
+                        });
+                        if (nodes.length > 0) {
+                            await store.updateNode(nodes[0].id, {
+                                status: 'closed',
+                                metadata: { phase: 'ENDED', endedAt: session.endedAt },
+                            });
+                            flushManager.markDirty(nodes[0].id);
+                            flushManager.schedule();
+                            // Archive final session state if configured
+                            if (archiver) {
+                                const sessionUri = `entire://session/${sessionId}`;
+                                void archiver.onSessionEvent('ended', sessionUri, store).catch(() => { });
+                            }
+                        }
+                    }
+                    catch {
+                        // Best-effort update
+                    }
+                    break;
+                }
+                case 'updated': {
+                    // Update session node metadata if it exists
+                    try {
+                        const nodes = await store.query.nodes({
+                            type: 'external',
+                            search: `entire://session/${sessionId}`,
+                            limit: 1,
+                        });
+                        if (nodes.length > 0) {
+                            await store.updateNode(nodes[0].id, {
+                                metadata: {
+                                    phase: session.phase,
+                                    lastPromptAt: session.lastPromptAt,
+                                },
+                            });
+                            flushManager.markDirty(nodes[0].id);
+                            flushManager.schedule();
+                        }
+                    }
+                    catch {
+                        // Best-effort update
+                    }
+                    break;
+                }
+                case 'deleted': {
+                    // Preserve history — don't delete nodes or edges
+                    break;
+                }
+            }
+        },
+        async correlate(sessionId, session) {
+            // Create session node
+            const sessionNodeId = await ensureSessionNode(session);
+            // Correlate with tasks
+            const tasks = await findCorrelatedTasks(session);
+            const edgesCreated = [];
+            const matchedForResult = [];
+            for (const task of tasks) {
+                if (!meetsConfidenceThreshold(task.confidence, minConfidence))
+                    continue;
+                matchedForResult.push(task);
+                const edgeId = await createEdgeIfNotExists(task.nodeId, sessionNodeId, 'worked-on', {
+                    _context: {
+                        correlation: task.matchReason,
+                        confidence: task.confidence,
+                        sessionAgent: session.agent,
+                    },
+                });
+                if (edgeId)
+                    edgesCreated.push(edgeId);
+            }
+            const result = {
+                sessionId,
+                matchedTasks: matchedForResult,
+                edgesCreated,
+                nodesCreated: [sessionNodeId],
+                strategy: matchedForResult[0]?.matchReason ?? 'none',
+                timestamp: new Date().toISOString(),
+            };
+            correlations.set(sessionId, result);
+            return result;
+        },
+        getCorrelations() {
+            return new Map(correlations);
+        },
+    };
+}
+//# sourceMappingURL=entire-linker.js.map

package/dist/daemon/entire-linker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entire-linker.js","sourceRoot":"","sources":["../../src/daemon/entire-linker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA0EH,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,MAAM,gBAAgB,GAA0C;IAC9D,IAAI,EAAE,CAAC;IACP,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;CACP,CAAC;AAEF,SAAS,wBAAwB,CAC/B,UAAiC,EACjC,OAA8B;IAE9B,OAAO,gBAAgB,CAAC,UAAU,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;AACnE,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA8B;IACnE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IACjD,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,QAAQ,CAAC;IAEvD,4DAA4D;IAC5D,MAAM,YAAY,GAAG,IAAI,GAAG,EAA6B,CAAC;IAE1D,sDAAsD;IACtD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE/C;;OAEG;IACH,KAAK,UAAU,mBAAmB,CAAC,OAA2B;QAC5D,MAAM,OAAO,GAAkB,EAAE,CAAC;QAElC,8CAA8C;QAC9C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;gBACxC,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,aAAa;gBACrB,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;YAEH,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;gBAC9B,MAAM,GAAG,GAAG,KAA2C,CAAC;gBACxD,MAAM,SAAS,GAAG,GAAG,CAAC,UAAgC,CAAC;gBACvD,MAAM,SAAS,GAAG,GAAG,CAAC,UAAgC,CAAC;gBAEvD,IAAI,SAAS,IAAI,CAAC,CAAC,SAAS,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;oBAClE,OAAO,CAAC,IAAI,CAAC;wBACX,MAAM,EAAE,KAAK,CAAC,EAAE;wBAChB,GAAG,EAAE,GAAG,CAAC,GAAyB;wBAClC,WAAW,EAAE,cAAc;wBAC3B,UAAU,EAAE,MAAM;qBACnB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC;QAEvC,mEAAmE;QACnE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;oBACxC,IAAI,EAAE,MAAM;oBACZ,MAAM,EAAE,aAAa;oBACrB,QAAQ,EAAE,KAAK;iBAChB,CAAC,CAAC;gBAEH,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;oBAC9B,MAAM,GAAG,GAAG,KAA2C,CAAC;oBACxD,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;wBAClC,OAAO,CAAC,IAAI,CAAC;4BACX,MAAM,EAAE,KAAK,CAAC,EAAE;4BAChB,GAAG,EAAE,GAAG,CAAC,GAAyB;4BAClC,WAAW,EAAE,oBAAoB;4BACjC,UAAU,EAAE,QAAQ;yBACrB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,4BAA4B;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC;QAEvC,oDAAoD;QACpD,gEAAgE;QAChE,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC5C,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,aAAa;gBACrB,QAAQ,EAAE,KAAK;aAChB,CAAC,CAAC;YAEH,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,CAAuC,CAAC;gBACnE,OAAO,CAAC,IAAI,CAAC;oBACX,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE;oBAC3B,GAAG,EAAE,GAAG,CAAC,GAAyB;oBAClC,WAAW,EAAE,iBAAiB;oBAC9B,UAAU,EAAE,KAAK;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,KAAK,UAAU,iBAAiB,CAAC,OAA2B;QAC1D,MAAM,GAAG,GAAG,oBAAoB,OAAO,CAAC,EAAE,EAAE,CAAC;QAE7C,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;YACvC,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,GAAG;YACX,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,MAAM,GAAI,QAAQ,CAAC,CAAC,CAAwC,CAAC,EAAY,CAAC;YAChF,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC9B,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC;gBAClC,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,YAAY,OAAO,CAAC,EAAE,EAAE;gBAC/B,GAAG;gBACH,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,UAAU,EAAE,SAAS;oBACrB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,SAAS,EAAE,OAAO,CAAC,SAAS;iBAC7B;aACF,CAAC,CAAC;YAEH,MAAM,MAAM,GAAI,IAA2C,CAAC,EAAY,CAAC;YACzE,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC9B,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/B,YAAY,CAAC,QAAQ,EAAE,CAAC;YAExB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;YAChE,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC5C,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,GAAG;gBACX,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YACH,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAI,aAAa,CAAC,CAAC,CAAwC,CAAC,EAAY,CAAC;gBACrF,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAC9B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,0DAA0D;YAC1D,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3B,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,UAAU,oBAAoB,CACjC,YAAoB,EACpB,OAA2B;QAE3B,MAAM,GAAG,GAAG,uBAAuB,YAAY,EAAE,CAAC;QAElD,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,+BAA+B;QAC/B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;YACvC,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,GAAG;YACX,KAAK,EAAE,CAAC;SACT,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,MAAM,GAAI,QAAQ,CAAC,CAAC,CAAwC,CAAC,EAAY,CAAC;YAChF,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC9B,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC;gBAClC,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,eAAe,YAAY,EAAE;gBACpC,GAAG;gBACH,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE;oBACR,UAAU,EAAE,YAAY;oBACxB,SAAS,EAAE,OAAO,CAAC,EAAE;iBACtB;aACF,CAAC,CAAC;YAEH,MAAM,MAAM,GAAI,IAA2C,CAAC,EAAY,CAAC;YACzE,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAC9B,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/B,YAAY,CAAC,QAAQ,EAAE,CAAC;YAExB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,0CAA0C;YAC1C,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC5C,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,GAAG;gBACX,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YACH,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAI,aAAa,CAAC,CAAC,CAAwC,CAAC,EAAY,CAAC;gBACrF,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAC9B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC3B,OAAO,GAAG,CAAC;QACb,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,UAAU,qBAAqB,CAClC,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,QAAkC;QAElC,0BAA0B;QAC1B,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;gBAC5C,OAAO,EAAE,MAAM;gBACf,KAAK,EAAE,IAAI;gBACX,IAAI;aACL,CAAC,CAAC;YAEH,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC;gBAClC,OAAO,EAAE,MAAM;gBACf,KAAK,EAAE,IAAI;gBACX,IAAI;gBACJ,QAAQ,EAAE;oBACR,GAAG,QAAQ;oBACX,QAAQ,EAAE;wBACR,MAAM,EAAE,oBAAoB;wBAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,GAAI,QAAQ,EAAE,QAA2D;qBAC1E;iBACF;aACF,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/B,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7B,YAAY,CAAC,QAAQ,EAAE,CAAC;YAExB,OAAO,IAAI,CAAC,EAAE,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,kBAAkB,CAAC,KAAyB;YAChD,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;YAE3C,QAAQ,IAAI,EAAE,CAAC;gBACb,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,oDAAoD;oBACpD,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;oBAEvD,uBAAuB;oBACvB,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;oBACjD,MAAM,YAAY,GAAa,EAAE,CAAC;oBAClC,MAAM,gBAAgB,GAAkB,EAAE,CAAC;oBAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;4BAAE,SAAS;wBAExE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAC5B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE;4BAClF,QAAQ,EAAE;gCACR,WAAW,EAAE,IAAI,CAAC,WAAW;gCAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;gCAC3B,YAAY,EAAE,OAAO,CAAC,KAAK;6BAC5B;yBACF,CAAC,CAAC;wBACH,IAAI,MAAM;4BAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACxC,CAAC;oBAED,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE;wBAC1B,SAAS;wBACT,YAAY,EAAE,gBAAgB;wBAC9B,YAAY;wBACZ,YAAY,EAAE,CAAC,aAAa,CAAC;wBAC7B,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,MAAM;wBACpD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC,CAAC,CAAC;oBAEH,wBAAwB;oBACxB,IAAI,QAAQ,EAAE,CAAC;wBACb,MAAM,UAAU,GAAG,oBAAoB,OAAO,CAAC,EAAE,EAAE,CAAC;wBACpD,KAAK,QAAQ,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBAC7E,CAAC;oBACD,MAAM;gBACR,CAAC;gBAED,KAAK,YAAY,CAAC,CAAC,CAAC;oBAClB,IAAI,CAAC,KAAK,CAAC,YAAY;wBAAE,MAAM;oBAE/B,gEAAgE;oBAChE,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;oBACvD,MAAM,gBAAgB,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBAEjF,MAAM,YAAY,GAAa,EAAE,CAAC;oBAElC,8CAA8C;oBAC9C,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAC5C,aAAa,EACb,gBAAgB,EAChB,UAAU,CACX,CAAC;oBACF,IAAI,UAAU;wBAAE,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;oBAE9C,mDAAmD;oBACnD,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;oBACjD,MAAM,gBAAgB,GAAkB,EAAE,CAAC;oBAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;wBACzB,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;4BAAE,SAAS;wBAExE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAC5B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CACxC,IAAI,CAAC,MAAM,EACX,gBAAgB,EAChB,gBAAgB,EAChB;4BACE,QAAQ,EAAE;gCACR,WAAW,EAAE,IAAI,CAAC,WAAW;gCAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;gCAC3B,YAAY,EAAE,KAAK,CAAC,YAAY;6BACjC;yBACF,CACF,CAAC;wBACF,IAAI,MAAM;4BAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACxC,CAAC;oBAED,qCAAqC;oBACrC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;oBAC7C,IAAI,QAAQ,EAAE,CAAC;wBACb,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;wBAC5C,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;oBAC/C,CAAC;oBAED,mCAAmC;oBACnC,IAAI,QAAQ,EAAE,CAAC;wBACb,MAAM,UAAU,GAAG,oBAAoB,OAAO,CAAC,EAAE,EAAE,CAAC;wBACpD,KAAK,QAAQ,CAAC,cAAc,CAAC,YAAY,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBAChF,CAAC;oBACD,MAAM;gBACR,CAAC;gBAED,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,0CAA0C;oBAC1C,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;4BACpC,IAAI,EAAE,UAAU;4BAChB,MAAM,EAAE,oBAAoB,SAAS,EAAE;4BACvC,KAAK,EAAE,CAAC;yBACT,CAAC,CAAC;wBAEH,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACrB,MAAM,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE;gCAClC,MAAM,EAAE,QAAQ;gCAChB,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE;6BACvD,CAAC,CAAC;4BACH,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;4BACpC,YAAY,CAAC,QAAQ,EAAE,CAAC;4BAExB,4CAA4C;4BAC5C,IAAI,QAAQ,EAAE,CAAC;gCACb,MAAM,UAAU,GAAG,oBAAoB,SAAS,EAAE,CAAC;gCACnD,KAAK,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;4BAC3E,CAAC;wBACH,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,qBAAqB;oBACvB,CAAC;oBACD,MAAM;gBACR,CAAC;gBAED,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,4CAA4C;oBAC5C,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;4BACpC,IAAI,EAAE,UAAU;4BAChB,MAAM,EAAE,oBAAoB,SAAS,EAAE;4BACvC,KAAK,EAAE,CAAC;yBACT,CAAC,CAAC;wBAEH,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACrB,MAAM,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE;gCAClC,QAAQ,EAAE;oCACR,KAAK,EAAE,OAAO,CAAC,KAAK;oCACpB,YAAY,EAAE,OAAO,CAAC,YAAY;iCACnC;6BACF,CAAC,CAAC;4BACH,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;4BACpC,YAAY,CAAC,QAAQ,EAAE,CAAC;wBAC1B,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,qBAAqB;oBACvB,CAAC;oBACD,MAAM;gBACR,CAAC;gBAED,KAAK,SAAS,CAAC,CAAC,CAAC;oBACf,iDAAiD;oBACjD,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,SAAiB,EAAE,OAA2B;YAC5D,sBAAsB;YACtB,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAEvD,uBAAuB;YACvB,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACjD,MAAM,YAAY,GAAa,EAAE,CAAC;YAClC,MAAM,gBAAgB,GAAkB,EAAE,CAAC;YAE3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;oBAAE,SAAS;gBAExE,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC5B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE;oBAClF,QAAQ,EAAE;wBACR,WAAW,EAAE,IAAI,CAAC,WAAW;wBAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;wBAC3B,YAAY,EAAE,OAAO,CAAC,KAAK;qBAC5B;iBACF,CAAC,CAAC;gBACH,IAAI,MAAM;oBAAE,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC;YAED,MAAM,MAAM,GAAsB;gBAChC,SAAS;gBACT,YAAY,EAAE,gBAAgB;gBAC9B,YAAY;gBACZ,YAAY,EAAE,CAAC,aAAa,CAAC;gBAC7B,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,MAAM;gBACpD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC;YAEF,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACpC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,eAAe;YACb,OAAO,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/daemon/entire-watcher.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Entire Session Watcher
+ *
+ * Watches .git/entire-sessions/ for session state changes and emits
+ * structured events. Used by the auto-linker to correlate sessions
+ * with OpenTasks tasks.
+ */
+/**
+ * Entire session state from a session file
+ */
+export interface EntireSessionState {
+    id: string;
+    agent: string;
+    phase: 'ACTIVE' | 'IDLE' | 'ENDED';
+    baseCommit?: string;
+    branch?: string;
+    startedAt?: string;
+    endedAt?: string;
+    checkpoints: string[];
+    lastPromptAt?: string;
+}
+/**
+ * Event emitted when a session changes
+ */
+export interface EntireSessionEvent {
+    type: 'started' | 'updated' | 'checkpoint' | 'ended' | 'deleted';
+    sessionId: string;
+    session: EntireSessionState;
+    previousPhase?: string;
+    checkpointId?: string;
+    timestamp: string;
+}
+export type SessionEventHandler = (event: EntireSessionEvent) => void;
+/**
+ * Configuration for the Entire watcher
+ */
+export interface EntireWatcherConfig {
+    /** Path to .opentasks/ directory (used to resolve .git) */
+    locationPath: string;
+    /** Override the git directory path (for testing) */
+    gitDir?: string;
+    /** Debounce delay in milliseconds (default: 200) */
+    debounceMs?: number;
+    /** Use polling instead of native fs events (useful for containers/tests) */
+    usePolling?: boolean;
+}
+/**
+ * Entire session watcher interface
+ */
+export interface EntireWatcher {
+    /** Start watching for session changes */
+    start(): Promise<void>;
+    /** Stop watching */
+    stop(): Promise<void>;
+    /** Register event handler */
+    onSessionEvent(handler: SessionEventHandler): void;
+    /** Check if watching */
+    readonly isWatching: boolean;
+    /** Get the resolved sessions directory path */
+    readonly sessionsDir: string;
+}
+/**
+ * Create an Entire session watcher
+ */
+export declare function createEntireWatcher(config: EntireWatcherConfig): EntireWatcher;
+//# sourceMappingURL=entire-watcher.d.ts.map

package/dist/daemon/entire-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entire-watcher.d.ts","sourceRoot":"","sources":["../../src/daemon/entire-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IAErB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB,oBAAoB;IACpB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,6BAA6B;IAC7B,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAEnD,wBAAwB;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAoFD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,aAAa,CA2M9E"}