@jamesaphoenix/tx-core 0.4.2 → 0.4.3

package/dist/services/validation-service.js

@@ -0,0 +1,289 @@
+import { Context, Effect, Layer } from "effect";
+import { SqliteClient } from "../db.js";
+import { DatabaseError } from "../errors.js";
+import { MIGRATIONS, getLatestVersion } from "./migration-service.js";
+import { TASK_STATUSES } from "@jamesaphoenix/tx-types";
+/**
+ * ValidationService performs pre-flight database checks.
+ * Follows Effect-TS patterns per DD-002.
+ */
+export class ValidationService extends Context.Tag("ValidationService")() {
+}
+export const ValidationServiceLive = Layer.effect(ValidationService, Effect.gen(function* () {
+    const db = yield* SqliteClient;
+    const checkIntegrity = () => Effect.try({
+        try: () => {
+            const rows = db.prepare("PRAGMA integrity_check").all();
+            const issues = [];
+            for (const row of rows) {
+                if (row.integrity_check !== "ok") {
+                    issues.push({
+                        check: "integrity",
+                        severity: "error",
+                        message: row.integrity_check
+                    });
+                }
+            }
+            return {
+                name: "Database Integrity",
+                passed: issues.length === 0,
+                issues,
+                fixable: false
+            };
+        },
+        catch: (cause) => new DatabaseError({ cause })
+    });
+    const checkSchemaVersion = () => Effect.try({
+        try: () => {
+            const issues = [];
+            const latestVersion = getLatestVersion();
+            // Get current schema version
+            let currentVersion = 0;
+            try {
+                const row = db.prepare("SELECT MAX(version) as version FROM schema_version").get();
+                currentVersion = row?.version ?? 0;
+            }
+            catch {
+                // Table doesn't exist
+                issues.push({
+                    check: "schema_version",
+                    severity: "error",
+                    message: "schema_version table does not exist"
+                });
+                return {
+                    name: "Schema Version",
+                    passed: false,
+                    issues,
+                    fixable: true
+                };
+            }
+            if (currentVersion < latestVersion) {
+                issues.push({
+                    check: "schema_version",
+                    severity: "warning",
+                    message: `Schema is outdated: current=${currentVersion}, latest=${latestVersion}`,
+                    details: {
+                        currentVersion,
+                        latestVersion,
+                        pendingMigrations: MIGRATIONS.filter(m => m.version > currentVersion).length
+                    }
+                });
+            }
+            if (currentVersion > latestVersion) {
+                issues.push({
+                    check: "schema_version",
+                    severity: "error",
+                    message: `Schema version is ahead of known migrations: current=${currentVersion}, latest=${latestVersion}`,
+                    details: { currentVersion, latestVersion }
+                });
+            }
+            return {
+                name: "Schema Version",
+                passed: issues.filter(i => i.severity === "error").length === 0,
+                issues,
+                fixable: currentVersion < latestVersion
+            };
+        },
+        catch: (cause) => new DatabaseError({ cause })
+    });
+    const checkForeignKeys = () => Effect.try({
+        try: () => {
+            const issues = [];
+            // Check if foreign keys are enabled
+            const fkEnabled = db.prepare("PRAGMA foreign_keys").get();
+            if (!fkEnabled || fkEnabled.foreign_keys !== 1) {
+                issues.push({
+                    check: "foreign_keys",
+                    severity: "warning",
+                    message: "Foreign keys are not enabled"
+                });
+            }
+            // Run foreign key check
+            const violations = db.prepare("PRAGMA foreign_key_check").all();
+            for (const violation of violations) {
+                issues.push({
+                    check: "foreign_keys",
+                    severity: "error",
+                    message: `Foreign key violation in ${violation.table} row ${violation.rowid} referencing ${violation.parent}`,
+                    details: violation
+                });
+            }
+            return {
+                name: "Foreign Key Constraints",
+                passed: violations.length === 0,
+                issues,
+                fixable: false
+            };
+        },
+        catch: (cause) => new DatabaseError({ cause })
+    });
+    const checkOrphanedDependencies = (fix = false) => Effect.try({
+        try: () => {
+            const issues = [];
+            let fixed = 0;
+            // Find dependencies where blocker or blocked task doesn't exist
+            // This shouldn't happen with ON DELETE CASCADE, but can occur from manual edits or corruption
+            const orphanedBlockers = db.prepare(`
+            SELECT td.id, td.blocker_id, td.blocked_id
+            FROM task_dependencies td
+            LEFT JOIN tasks t ON t.id = td.blocker_id
+            WHERE t.id IS NULL
+          `).all();
+            const orphanedBlocked = db.prepare(`
+            SELECT td.id, td.blocker_id, td.blocked_id
+            FROM task_dependencies td
+            LEFT JOIN tasks t ON t.id = td.blocked_id
+            WHERE t.id IS NULL
+          `).all();
+            for (const row of orphanedBlockers) {
+                issues.push({
+                    check: "orphaned_dependencies",
+                    severity: "error",
+                    message: `Dependency ${row.id} references non-existent blocker task ${row.blocker_id}`,
+                    details: row
+                });
+            }
+            for (const row of orphanedBlocked) {
+                issues.push({
+                    check: "orphaned_dependencies",
+                    severity: "error",
+                    message: `Dependency ${row.id} references non-existent blocked task ${row.blocked_id}`,
+                    details: row
+                });
+            }
+            if (fix && issues.length > 0) {
+                // Delete orphaned dependencies
+                const orphanedIds = [...orphanedBlockers, ...orphanedBlocked].map(r => r.id);
+                const uniqueIds = [...new Set(orphanedIds)];
+                if (uniqueIds.length > 0) {
+                    const result = db.prepare(`
+                DELETE FROM task_dependencies
+                WHERE id IN (${uniqueIds.map(() => "?").join(",")})
+              `).run(...uniqueIds);
+                    fixed = result.changes;
+                }
+            }
+            return {
+                name: "Orphaned Dependencies",
+                passed: issues.length === 0,
+                issues,
+                fixable: true,
+                fixed: fix ? fixed : undefined
+            };
+        },
+        catch: (cause) => new DatabaseError({ cause })
+    });
+    const checkInvalidStatuses = (fix = false) => Effect.try({
+        try: () => {
+            const issues = [];
+            let fixed = 0;
+            // Find tasks with invalid status values
+            const validStatuses = TASK_STATUSES;
+            const placeholders = validStatuses.map(() => "?").join(",");
+            const invalidTasks = db.prepare(`
+            SELECT id, status FROM tasks WHERE status NOT IN (${placeholders})
+          `).all(...validStatuses);
+            for (const task of invalidTasks) {
+                issues.push({
+                    check: "invalid_status",
+                    severity: "error",
+                    message: `Task ${task.id} has invalid status '${task.status}'`,
+                    details: { id: task.id, status: task.status, validStatuses }
+                });
+            }
+            if (fix && issues.length > 0) {
+                // Reset invalid statuses to 'backlog' (safe default)
+                const result = db.prepare(`
+              UPDATE tasks SET status = 'backlog', updated_at = datetime('now')
+              WHERE status NOT IN (${placeholders})
+            `).run(...validStatuses);
+                fixed = result.changes;
+            }
+            return {
+                name: "Task Status Values",
+                passed: issues.length === 0,
+                issues,
+                fixable: true,
+                fixed: fix ? fixed : undefined
+            };
+        },
+        catch: (cause) => new DatabaseError({ cause })
+    });
+    const checkMissingParentRefs = (fix = false) => Effect.try({
+        try: () => {
+            const issues = [];
+            let fixed = 0;
+            // Find tasks referencing non-existent parents
+            const orphanedChildren = db.prepare(`
+            SELECT t.id, t.parent_id
+            FROM tasks t
+            LEFT JOIN tasks p ON p.id = t.parent_id
+            WHERE t.parent_id IS NOT NULL AND p.id IS NULL
+          `).all();
+            for (const task of orphanedChildren) {
+                issues.push({
+                    check: "missing_parent_refs",
+                    severity: "error",
+                    message: `Task ${task.id} references non-existent parent ${task.parent_id}`,
+                    details: { id: task.id, parentId: task.parent_id }
+                });
+            }
+            if (fix && issues.length > 0) {
+                // Clear orphaned parent references
+                const result = db.prepare(`
+              UPDATE tasks SET parent_id = NULL, updated_at = datetime('now')
+              WHERE parent_id IS NOT NULL
+              AND parent_id NOT IN (SELECT id FROM tasks)
+            `).run();
+                fixed = result.changes;
+            }
+            return {
+                name: "Missing Parent References",
+                passed: issues.length === 0,
+                issues,
+                fixable: true,
+                fixed: fix ? fixed : undefined
+            };
+        },
+        catch: (cause) => new DatabaseError({ cause })
+    });
+    const validate = (options) => Effect.gen(function* () {
+        const fix = options?.fix ?? false;
+        // Run all checks
+        const checks = [];
+        checks.push(yield* checkIntegrity());
+        checks.push(yield* checkSchemaVersion());
+        checks.push(yield* checkForeignKeys());
+        checks.push(yield* checkOrphanedDependencies(fix));
+        checks.push(yield* checkInvalidStatuses(fix));
+        checks.push(yield* checkMissingParentRefs(fix));
+        // Count issues by severity
+        const issueCount = { error: 0, warning: 0, info: 0 };
+        let fixedCount = 0;
+        for (const check of checks) {
+            for (const issue of check.issues) {
+                issueCount[issue.severity]++;
+            }
+            if (check.fixed !== undefined) {
+                fixedCount += check.fixed;
+            }
+        }
+        const valid = issueCount.error === 0;
+        return {
+            valid,
+            checks,
+            issueCount,
+            fixedCount
+        };
+    });
+    return {
+        validate,
+        checkIntegrity,
+        checkSchemaVersion,
+        checkForeignKeys,
+        checkOrphanedDependencies,
+        checkInvalidStatuses,
+        checkMissingParentRefs
+    };
+}));
+//# sourceMappingURL=validation-service.js.map

package/dist/services/validation-service.js.map

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

package/dist/services/worker-process.d.ts

@@ -2,14 +2,31 @@
  * WorkerProcess - PRD-018
  *
  * Implements the worker process with heartbeat fiber, lease renewal,
- * Claude subprocess management, and graceful shutdown handling.
+ * agent subprocess management, and graceful shutdown handling.
  * Uses Effect-TS patterns per DD-002.
  */
 import { Effect } from "effect";
+import { type ChildProcess } from "child_process";
 import { WorkerService } from "./worker-service.js";
 import { ClaimService } from "./claim-service.js";
 import { ReadyService } from "./ready-service.js";
 import { TaskService } from "./task-service.js";
+import { AttemptService } from "./attempt-service.js";
+/**
+ * Timeout in milliseconds to wait after SIGTERM before escalating to SIGKILL.
+ * If the agent subprocess doesn't exit within this window, it will be forcefully killed.
+ */
+export declare const SIGKILL_ESCALATION_TIMEOUT_MS = 5000;
+/**
+ * Kill a child process with SIGTERM, escalating to SIGKILL after a timeout.
+ *
+ * If the process ignores SIGTERM (e.g., traps the signal), it would become orphaned.
+ * This function ensures cleanup by sending SIGKILL after SIGKILL_ESCALATION_TIMEOUT_MS.
+ *
+ * Uses setTimeout with .unref() so the escalation timer doesn't keep the event loop alive
+ * during graceful shutdown.
+ */
+export declare const killWithEscalation: (proc: ChildProcess) => void;
 /**
  * Configuration for the worker process.
  */
@@ -20,9 +37,11 @@ export interface WorkerProcessConfig {
     readonly capabilities: readonly string[];
     /** Heartbeat interval in seconds. Should match orchestrator config. */
     readonly heartbeatIntervalSeconds: number;
-    /** How often to renew the lease (in seconds). Should be < lease duration. */
+    /** Lease duration in minutes. Should match orchestrator config. Defaults to 30. */
+    readonly leaseDurationMinutes?: number;
+    /** How often to renew the lease (in seconds). Should be < lease duration. Defaults to 1/3 of leaseDurationMinutes. */
     readonly leaseRenewalIntervalSeconds?: number;
-    /** Working directory for Claude subprocess. Defaults to process.cwd() */
+    /** Working directory for agent subprocess. Defaults to process.cwd() */
     readonly workingDirectory?: string;
 }
 /**
@@ -37,5 +56,5 @@ export interface WorkerProcessConfig {
  * @param config Worker process configuration
  * @returns Effect that runs until shutdown is requested
  */
-export declare const runWorkerProcess: (config: WorkerProcessConfig) => Effect.Effect<void, import("../errors.js").TaskNotFoundError | import("../errors.js").ValidationError | import("../errors.js").DatabaseError | import("../errors.js").RegistrationError | import("../errors.js").WorkerNotFoundError, TaskService | ReadyService | WorkerService | ClaimService>;
+export declare const runWorkerProcess: (config: WorkerProcessConfig) => Effect.Effect<void, import("../errors.js").DatabaseError | import("../errors.js").TaskNotFoundError | import("../errors.js").StaleDataError | import("../errors.js").ValidationError | import("../errors.js").RegistrationError | import("../errors.js").WorkerNotFoundError, TaskService | ReadyService | AttemptService | ClaimService | WorkerService>;
 //# sourceMappingURL=worker-process.d.ts.map

package/dist/services/worker-process.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-process.d.ts","sourceRoot":"","sources":["../../src/services/worker-process.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAwB,MAAM,QAAQ,CAAA;AAGrD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,uEAAuE;IACvE,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAA;IACzC,6EAA6E;IAC7E,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAA;IAC7C,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAmBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,mBAAmB,qSAwLxD,CAAA"}
+{"version":3,"file":"worker-process.d.ts","sourceRoot":"","sources":["../../src/services/worker-process.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAkC,MAAM,QAAQ,CAAA;AAC/D,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,eAAe,CAAA;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AASrD;;;GAGG;AACH,eAAO,MAAM,6BAA6B,OAAQ,CAAA;AAElD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,MAAM,YAAY,KAAG,IAoBvD,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,uEAAuE;IACvE,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAA;IACzC,mFAAmF;IACnF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;IACtC,sHAAsH;IACtH,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAA;IAC7C,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAoCD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,GAAI,QAAQ,mBAAmB,8VAkPxD,CAAA"}