anantham-v2 2.0.0-alpha.1

package/dist/recovery/crash-recovery-engine.js

@@ -0,0 +1,200 @@
+import { LeaseManager } from "./lease-manager.js";
+import { OrphanDetector } from "./orphan-detector.js";
+import { CheckpointValidator } from "./checkpoint-validator.js";
+import { RecoveryRecordSchema, } from "./recovery-record.js";
+export class CrashRecoveryEngine {
+    engine;
+    eventStore;
+    projectionManager;
+    leaseManager;
+    orphanDetector;
+    checkpointRepo;
+    artifactRepo;
+    constructor(options) {
+        this.engine = options.engine;
+        this.eventStore = options.eventStore;
+        this.projectionManager = options.projectionManager;
+        this.leaseManager = options.leaseManager ?? new LeaseManager();
+        this.orphanDetector = new OrphanDetector(this.engine);
+        this.checkpointRepo = options.checkpointRepo;
+        this.artifactRepo = options.artifactRepo;
+    }
+    /**
+     * Executes the full deterministic startup and crash recovery pipeline.
+     * PRD Part 1 Section 47 & Engineering Playbook Rule 20.
+     */
+    async executeRecovery() {
+        const recoveryId = `rec_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`;
+        const startedAt = new Date().toISOString();
+        const anomalies = [];
+        let status = "SUCCESS";
+        // 1. SQLite Physical Integrity Check
+        const integrityStmt = this.engine.raw.prepare("PRAGMA integrity_check;");
+        const integrityRows = integrityStmt.all();
+        const firstRow = integrityRows[0];
+        const isIntegrityOk = Boolean(firstRow && firstRow.integrity_check === "ok");
+        if (!isIntegrityOk) {
+            status = "CRITICAL_ERROR";
+            anomalies.push({
+                type: "INTEGRITY_VIOLATION",
+                entityId: "sqlite_database",
+                description: `SQLite integrity check failed: ${JSON.stringify(integrityRows)}`,
+                actionTaken: "FLAGGED",
+                timestamp: new Date().toISOString(),
+            });
+        }
+        // 2. Foreign Key Consistency Check
+        const fkStmt = this.engine.raw.prepare("PRAGMA foreign_key_check;");
+        const fkRows = fkStmt.all();
+        if (fkRows.length > 0) {
+            status = status === "CRITICAL_ERROR" ? "CRITICAL_ERROR" : "WARNING";
+            for (const fk of fkRows) {
+                anomalies.push({
+                    type: "INTEGRITY_VIOLATION",
+                    entityId: `${fk.table}:${fk.rowid}`,
+                    description: `Foreign key violation in table '${fk.table}' referencing parent '${fk.parent}'`,
+                    actionTaken: "FLAGGED",
+                    timestamp: new Date().toISOString(),
+                });
+            }
+        }
+        // 3. Stale Lease Reclamation (Authoritative SQLite persistent leases)
+        const nowIso = new Date().toISOString();
+        let evictedLeaseCount = 0;
+        try {
+            const expiredLeasesStmt = this.engine.raw.prepare("SELECT id, task_id, agent_id, expires_at FROM leases WHERE status = 'ACTIVE' AND expires_at <= ?;");
+            const expiredLeaseRows = expiredLeasesStmt.all(nowIso);
+            if (expiredLeaseRows.length > 0) {
+                const updateLeaseStmt = this.engine.raw.prepare("UPDATE leases SET status = 'EXPIRED' WHERE id = ?;");
+                this.engine.transaction(() => {
+                    for (const row of expiredLeaseRows) {
+                        updateLeaseStmt.run(row.id);
+                    }
+                });
+                evictedLeaseCount = expiredLeaseRows.length;
+                for (const evicted of expiredLeaseRows) {
+                    anomalies.push({
+                        type: "STALE_LEASE",
+                        entityId: evicted.id,
+                        description: `Evicted expired persistent task lease '${evicted.id}' for task '${evicted.task_id}' assigned to agent '${evicted.agent_id}'`,
+                        actionTaken: "EVICTED",
+                        timestamp: nowIso,
+                    });
+                }
+            }
+        }
+        catch {
+            // Table may not exist in early tests
+        }
+        // Also run in-memory LeaseManager check for backwards compatibility
+        const leaseResult = this.leaseManager.reclaimStaleLeases();
+        evictedLeaseCount += leaseResult.evictedCount;
+        for (const evicted of leaseResult.evictedLeases) {
+            anomalies.push({
+                type: "STALE_LEASE",
+                entityId: evicted.leaseId,
+                description: `Evicted expired in-memory task lease for task '${evicted.taskId}' assigned to agent '${evicted.agentId}'`,
+                actionTaken: "EVICTED",
+                timestamp: nowIso,
+            });
+        }
+        // 4. Interrupted Task Recovery (Sweep stuck running/claimed tasks)
+        try {
+            const interruptedTasksStmt = this.engine.raw.prepare(`
+        SELECT t.id, t.status, t.project_id, t.session_id
+        FROM tasks t
+        WHERE t.status IN ('running', 'claimed', 'verifying')
+        AND NOT EXISTS (
+          SELECT 1 FROM leases l
+          WHERE l.task_id = t.id AND l.status = 'ACTIVE' AND l.expires_at > ?
+        );
+      `);
+            const interruptedRows = interruptedTasksStmt.all(nowIso);
+            if (interruptedRows.length > 0) {
+                const resetTaskStmt = this.engine.raw.prepare("UPDATE tasks SET status = 'queued', updated_at = ? WHERE id = ?;");
+                this.engine.transaction(() => {
+                    for (const row of interruptedRows) {
+                        resetTaskStmt.run(nowIso, row.id);
+                    }
+                });
+                for (const row of interruptedRows) {
+                    anomalies.push({
+                        type: "UNCOMMITTED_TASK",
+                        entityId: row.id,
+                        description: `Reset interrupted task '${row.id}' from status '${row.status}' back to 'queued'.`,
+                        actionTaken: "REPAIRED",
+                        timestamp: nowIso,
+                    });
+                }
+            }
+        }
+        catch {
+            // Tasks table may not exist in early mock tests
+        }
+        // 5. Orphan Entity Detection
+        const orphanReport = this.orphanDetector.detectOrphans();
+        anomalies.push(...orphanReport.anomalies);
+        if (orphanReport.totalOrphansCount > 0 && status === "SUCCESS") {
+            status = "WARNING";
+        }
+        // 6. Checkpoint Verification (if checkpointRepo available)
+        if (this.checkpointRepo) {
+            const allCheckpointsStmt = this.engine.raw.prepare("SELECT id, manifest_json, sha256, validation_checksum, type, project_id, session_id, created_at FROM checkpoints ORDER BY created_at DESC LIMIT 50;");
+            const rows = allCheckpointsStmt.all();
+            for (const row of rows) {
+                const chk = {
+                    id: row.id,
+                    type: row.type,
+                    projectId: row.project_id,
+                    sessionId: row.session_id,
+                    manifest: JSON.parse(row.manifest_json),
+                    sha256: row.sha256,
+                    createdAt: row.created_at,
+                    validationChecksum: row.validation_checksum,
+                };
+                const validation = await CheckpointValidator.validateComplete(chk, {
+                    artifactRepo: this.artifactRepo,
+                });
+                if (!validation.isValid) {
+                    status = "CRITICAL_ERROR";
+                    anomalies.push({
+                        type: "CORRUPTED_CHECKPOINT",
+                        entityId: row.id,
+                        description: `Checkpoint '${row.id}' integrity validation failed: ${validation.errors.join("; ")}`,
+                        actionTaken: "FLAGGED",
+                        timestamp: new Date().toISOString(),
+                    });
+                }
+            }
+        }
+        // 6. Projections Rebuild & Sync (if projectionManager and eventStore provided)
+        let projectionsRebuiltCount = 0;
+        let eventsValidatedCount = 0;
+        if (this.projectionManager && this.eventStore) {
+            const eventCountStmt = this.engine.raw.prepare("SELECT COUNT(*) as count FROM events;");
+            const eventCountRow = eventCountStmt.get();
+            eventsValidatedCount = eventCountRow?.count ?? 0;
+            // Rebuild all projections from event log
+            this.projectionManager.rebuildAll();
+            projectionsRebuiltCount = 2; // SessionSummaryProjection and TaskBoardProjection
+        }
+        const completedAt = new Date().toISOString();
+        const record = {
+            recoveryId,
+            startedAt,
+            completedAt,
+            status,
+            databaseIntegrityPassed: isIntegrityOk && fkRows.length === 0,
+            eventsValidatedCount,
+            projectionsRebuiltCount,
+            staleLeasesEvictedCount: evictedLeaseCount,
+            orphansDetectedCount: orphanReport.totalOrphansCount,
+            anomalies,
+            message: status === "SUCCESS"
+                ? "Startup recovery completed cleanly with 0 integrity violations."
+                : `Startup recovery completed with status ${status}. Found ${anomalies.length} anomalies.`,
+        };
+        return RecoveryRecordSchema.parse(record);
+    }
+}
+//# sourceMappingURL=crash-recovery-engine.js.map

package/dist/recovery/crash-recovery-engine.js.map

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

package/dist/recovery/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./recovery-record.js";
+export * from "./checkpoint-manifest.js";
+export * from "./checkpoint-validator.js";
+export * from "./lease-manager.js";
+export * from "./orphan-detector.js";
+export * from "./crash-recovery-engine.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/recovery/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/recovery/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC"}

package/dist/recovery/index.js

@@ -0,0 +1,7 @@
+export * from "./recovery-record.js";
+export * from "./checkpoint-manifest.js";
+export * from "./checkpoint-validator.js";
+export * from "./lease-manager.js";
+export * from "./orphan-detector.js";
+export * from "./crash-recovery-engine.js";
+//# sourceMappingURL=index.js.map

package/dist/recovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recovery/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC"}

package/dist/recovery/lease-manager.d.ts

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import type { TaskRepository } from "../persistence/repositories/task-repository.js";
+export declare const RecoveryLeaseSchema: z.ZodObject<{
+    leaseId: z.ZodString;
+    taskId: z.ZodString;
+    agentId: z.ZodString;
+    acquiredAt: z.ZodNumber;
+    expiresAt: z.ZodNumber;
+    lastHeartbeatAt: z.ZodNumber;
+    ttlMs: z.ZodNumber;
+    status: z.ZodEnum<["ACTIVE", "RELEASED", "EXPIRED", "REVOKED"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "ACTIVE" | "RELEASED" | "EXPIRED" | "REVOKED";
+    taskId: string;
+    agentId: string;
+    expiresAt: number;
+    leaseId: string;
+    acquiredAt: number;
+    lastHeartbeatAt: number;
+    ttlMs: number;
+}, {
+    status: "ACTIVE" | "RELEASED" | "EXPIRED" | "REVOKED";
+    taskId: string;
+    agentId: string;
+    expiresAt: number;
+    leaseId: string;
+    acquiredAt: number;
+    lastHeartbeatAt: number;
+    ttlMs: number;
+}>;
+export type RecoveryLease = z.infer<typeof RecoveryLeaseSchema>;
+export declare class LeaseManager {
+    private readonly leases;
+    private readonly taskToLease;
+    private readonly taskRepo?;
+    private readonly defaultTtlMs;
+    constructor(options?: {
+        taskRepo?: TaskRepository;
+        defaultTtlMs?: number;
+    });
+    /**
+     * Attempts to acquire an exclusive execution lease for a task.
+     */
+    acquireLease(taskId: string, agentId: string, ttlMs?: number): {
+        success: boolean;
+        lease?: RecoveryLease;
+        reason?: string;
+    };
+    /**
+     * Heartbeat to extend an active lease.
+     */
+    heartbeat(leaseId: string, extensionMs?: number): {
+        success: boolean;
+        lease?: RecoveryLease;
+        reason?: string;
+    };
+    /**
+     * Explicitly releases a lease upon task completion, failure, or cancellation.
+     */
+    releaseLease(leaseId: string): boolean;
+    /**
+     * Gets the active lease for a task if one exists and is unexpired.
+     */
+    getActiveLease(taskId: string): RecoveryLease | null;
+    /**
+     * Scans and evicts all expired leases, resetting task states if taskRepo is provided.
+     */
+    reclaimStaleLeases(): {
+        evictedCount: number;
+        evictedLeases: RecoveryLease[];
+    };
+}
+//# sourceMappingURL=lease-manager.d.ts.map

package/dist/recovery/lease-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-manager.d.ts","sourceRoot":"","sources":["../../src/recovery/lease-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAErF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE;IAK1E;;OAEG;IACI,YAAY,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,MAA0B,GAChC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,aAAa,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IA4C/D;;OAEG;IACI,SAAS,CACd,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,aAAa,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAmB/D;;OAEG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAW7C;;OAEG;IACI,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAgB3D;;OAEG;IACI,kBAAkB,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,aAAa,EAAE,CAAA;KAAE;CA8BtF"}

package/dist/recovery/lease-manager.js

@@ -0,0 +1,141 @@
+import { z } from "zod";
+export const RecoveryLeaseSchema = z.object({
+    leaseId: z.string().min(1),
+    taskId: z.string().min(1),
+    agentId: z.string().min(1),
+    acquiredAt: z.number().int().positive(),
+    expiresAt: z.number().int().positive(),
+    lastHeartbeatAt: z.number().int().positive(),
+    ttlMs: z.number().int().positive(),
+    status: z.enum(["ACTIVE", "RELEASED", "EXPIRED", "REVOKED"]),
+});
+export class LeaseManager {
+    leases = new Map(); // leaseId -> RecoveryLease
+    taskToLease = new Map(); // taskId -> leaseId
+    taskRepo;
+    defaultTtlMs;
+    constructor(options) {
+        this.taskRepo = options?.taskRepo;
+        this.defaultTtlMs = options?.defaultTtlMs ?? 30_000; // 30s default TTL
+    }
+    /**
+     * Attempts to acquire an exclusive execution lease for a task.
+     */
+    acquireLease(taskId, agentId, ttlMs = this.defaultTtlMs) {
+        const now = Date.now();
+        // Check if there is an existing lease for this task
+        const existingLeaseId = this.taskToLease.get(taskId);
+        if (existingLeaseId) {
+            const existing = this.leases.get(existingLeaseId);
+            if (existing && existing.status === "ACTIVE") {
+                if (existing.expiresAt > now) {
+                    if (existing.agentId === agentId) {
+                        // Re-entrant renewal by same agent
+                        return this.heartbeat(existing.leaseId, ttlMs);
+                    }
+                    return {
+                        success: false,
+                        reason: `Task '${taskId}' is actively leased to agent '${existing.agentId}' until ${new Date(existing.expiresAt).toISOString()}`,
+                    };
+                }
+                else {
+                    // Expired lease - revoke it
+                    existing.status = "EXPIRED";
+                }
+            }
+        }
+        const leaseId = `lease_${taskId}_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`;
+        const lease = {
+            leaseId,
+            taskId,
+            agentId,
+            acquiredAt: now,
+            expiresAt: now + ttlMs,
+            lastHeartbeatAt: now,
+            ttlMs,
+            status: "ACTIVE",
+        };
+        this.leases.set(leaseId, lease);
+        this.taskToLease.set(taskId, leaseId);
+        return { success: true, lease };
+    }
+    /**
+     * Heartbeat to extend an active lease.
+     */
+    heartbeat(leaseId, extensionMs) {
+        const lease = this.leases.get(leaseId);
+        if (!lease) {
+            return { success: false, reason: `Lease '${leaseId}' not found.` };
+        }
+        if (lease.status !== "ACTIVE") {
+            return { success: false, reason: `Lease '${leaseId}' is not active (status: ${lease.status}).` };
+        }
+        const now = Date.now();
+        const ttl = extensionMs ?? lease.ttlMs;
+        lease.lastHeartbeatAt = now;
+        lease.expiresAt = now + ttl;
+        return { success: true, lease };
+    }
+    /**
+     * Explicitly releases a lease upon task completion, failure, or cancellation.
+     */
+    releaseLease(leaseId) {
+        const lease = this.leases.get(leaseId);
+        if (!lease)
+            return false;
+        lease.status = "RELEASED";
+        if (this.taskToLease.get(lease.taskId) === leaseId) {
+            this.taskToLease.delete(lease.taskId);
+        }
+        return true;
+    }
+    /**
+     * Gets the active lease for a task if one exists and is unexpired.
+     */
+    getActiveLease(taskId) {
+        const leaseId = this.taskToLease.get(taskId);
+        if (!leaseId)
+            return null;
+        const lease = this.leases.get(leaseId);
+        if (!lease || lease.status !== "ACTIVE")
+            return null;
+        if (lease.expiresAt <= Date.now()) {
+            lease.status = "EXPIRED";
+            this.taskToLease.delete(taskId);
+            return null;
+        }
+        return lease;
+    }
+    /**
+     * Scans and evicts all expired leases, resetting task states if taskRepo is provided.
+     */
+    reclaimStaleLeases() {
+        const now = Date.now();
+        const evictedLeases = [];
+        for (const lease of this.leases.values()) {
+            if (lease.status === "ACTIVE" && lease.expiresAt <= now) {
+                lease.status = "EXPIRED";
+                this.taskToLease.delete(lease.taskId);
+                evictedLeases.push(lease);
+                // If repository is connected and task is running/claimed, reset to queued for recovery
+                if (this.taskRepo) {
+                    const task = this.taskRepo.findById(lease.taskId);
+                    if (task) {
+                        if (task.status === "running") {
+                            this.taskRepo.updateStatus(task.id, "blocked");
+                            this.taskRepo.updateStatus(task.id, "queued");
+                        }
+                        else if (task.status === "claimed") {
+                            this.taskRepo.updateStatus(task.id, "queued");
+                        }
+                    }
+                }
+            }
+        }
+        return {
+            evictedCount: evictedLeases.length,
+            evictedLeases,
+        };
+    }
+}
+//# sourceMappingURL=lease-manager.js.map

package/dist/recovery/lease-manager.js.map

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

package/dist/recovery/orphan-detector.d.ts

@@ -0,0 +1,20 @@
+import type { SqliteEngine } from "../persistence/sqlite-engine.js";
+import type { RecoveryAnomaly } from "./recovery-record.js";
+export interface OrphanDetectionReport {
+    orphanTasks: string[];
+    orphanSessions: string[];
+    orphanArtifacts: string[];
+    orphanAttachments: string[];
+    orphanCheckpoints: string[];
+    anomalies: RecoveryAnomaly[];
+    totalOrphansCount: number;
+}
+export declare class OrphanDetector {
+    private readonly engine;
+    constructor(engine: SqliteEngine);
+    /**
+     * Scans SQLite relational tables for referential orphans and consistency gaps.
+     */
+    detectOrphans(): OrphanDetectionReport;
+}
+//# sourceMappingURL=orphan-detector.d.ts.map

package/dist/recovery/orphan-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orphan-detector.d.ts","sourceRoot":"","sources":["../../src/recovery/orphan-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAE1B,MAAM,EAAE,YAAY;IAIhC;;OAEG;IACI,aAAa,IAAI,qBAAqB;CA+G9C"}

package/dist/recovery/orphan-detector.js

@@ -0,0 +1,113 @@
+export class OrphanDetector {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    /**
+     * Scans SQLite relational tables for referential orphans and consistency gaps.
+     */
+    detectOrphans() {
+        const anomalies = [];
+        const timestamp = new Date().toISOString();
+        // 1. Orphan tasks (tasks where session_id does not exist in sessions)
+        const orphanTaskStmt = this.engine.raw.prepare(`
+      SELECT t.id FROM tasks t
+      LEFT JOIN sessions s ON t.session_id = s.id
+      WHERE s.id IS NULL;
+    `);
+        const orphanTaskRows = orphanTaskStmt.all();
+        const orphanTasks = orphanTaskRows.map((r) => r.id);
+        for (const taskId of orphanTasks) {
+            anomalies.push({
+                type: "UNCOMMITTED_TASK",
+                entityId: taskId,
+                description: `Task '${taskId}' references non-existent session.`,
+                actionTaken: "FLAGGED",
+                timestamp,
+            });
+        }
+        // 2. Orphan sessions (child sessions where parent_session_id is non-null but does not exist)
+        const orphanSessionStmt = this.engine.raw.prepare(`
+      SELECT s.id, s.parent_session_id FROM sessions s
+      LEFT JOIN sessions p ON s.parent_session_id = p.id
+      WHERE s.parent_session_id IS NOT NULL AND p.id IS NULL;
+    `);
+        const orphanSessionRows = orphanSessionStmt.all();
+        const orphanSessions = orphanSessionRows.map((r) => r.id);
+        for (const row of orphanSessionRows) {
+            anomalies.push({
+                type: "INTEGRITY_VIOLATION",
+                entityId: row.id,
+                description: `Session '${row.id}' references non-existent parentSessionId '${row.parent_session_id}'.`,
+                actionTaken: "FLAGGED",
+                timestamp,
+            });
+        }
+        // 3. Orphan artifacts (artifacts referencing non-existent session)
+        const orphanArtifactStmt = this.engine.raw.prepare(`
+      SELECT a.id FROM artifacts a
+      LEFT JOIN sessions s ON a.session_id = s.id
+      WHERE s.id IS NULL;
+    `);
+        const orphanArtifactRows = orphanArtifactStmt.all();
+        const orphanArtifacts = orphanArtifactRows.map((r) => r.id);
+        for (const artifactId of orphanArtifacts) {
+            anomalies.push({
+                type: "ORPHAN_ARTIFACT",
+                entityId: artifactId,
+                description: `Artifact '${artifactId}' references non-existent session.`,
+                actionTaken: "PRESERVED",
+                timestamp,
+            });
+        }
+        // 4. Orphan attachments (attachments referencing non-existent session)
+        const orphanAttachmentStmt = this.engine.raw.prepare(`
+      SELECT att.id FROM attachments att
+      LEFT JOIN sessions s ON att.session_id = s.id
+      WHERE s.id IS NULL;
+    `);
+        const orphanAttachmentRows = orphanAttachmentStmt.all();
+        const orphanAttachments = orphanAttachmentRows.map((r) => r.id);
+        for (const attachmentId of orphanAttachments) {
+            anomalies.push({
+                type: "ORPHAN_ARTIFACT",
+                entityId: attachmentId,
+                description: `Attachment '${attachmentId}' references non-existent session.`,
+                actionTaken: "PRESERVED",
+                timestamp,
+            });
+        }
+        // 5. Orphan checkpoints (checkpoints referencing non-existent session)
+        const orphanCheckpointStmt = this.engine.raw.prepare(`
+      SELECT chk.id FROM checkpoints chk
+      LEFT JOIN sessions s ON chk.session_id = s.id
+      WHERE s.id IS NULL;
+    `);
+        const orphanCheckpointRows = orphanCheckpointStmt.all();
+        const orphanCheckpoints = orphanCheckpointRows.map((r) => r.id);
+        for (const chkId of orphanCheckpoints) {
+            anomalies.push({
+                type: "CORRUPTED_CHECKPOINT",
+                entityId: chkId,
+                description: `Checkpoint '${chkId}' references non-existent session.`,
+                actionTaken: "FLAGGED",
+                timestamp,
+            });
+        }
+        const totalOrphansCount = orphanTasks.length +
+            orphanSessions.length +
+            orphanArtifacts.length +
+            orphanAttachments.length +
+            orphanCheckpoints.length;
+        return {
+            orphanTasks,
+            orphanSessions,
+            orphanArtifacts,
+            orphanAttachments,
+            orphanCheckpoints,
+            anomalies,
+            totalOrphansCount,
+        };
+    }
+}
+//# sourceMappingURL=orphan-detector.js.map

package/dist/recovery/orphan-detector.js.map

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