@jamesaphoenix/tx-core 0.4.1

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

@@ -0,0 +1,41 @@
+/**
+ * WorkerProcess - PRD-018
+ *
+ * Implements the worker process with heartbeat fiber, lease renewal,
+ * Claude subprocess management, and graceful shutdown handling.
+ * Uses Effect-TS patterns per DD-002.
+ */
+import { Effect } from "effect";
+import { WorkerService } from "./worker-service.js";
+import { ClaimService } from "./claim-service.js";
+import { ReadyService } from "./ready-service.js";
+import { TaskService } from "./task-service.js";
+/**
+ * Configuration for the worker process.
+ */
+export interface WorkerProcessConfig {
+    /** Optional worker name. Defaults to worker-{timestamp} */
+    readonly name?: string;
+    /** List of agent capabilities (e.g., ['tx-implementer', 'tx-tester']) */
+    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. */
+    readonly leaseRenewalIntervalSeconds?: number;
+    /** Working directory for Claude subprocess. Defaults to process.cwd() */
+    readonly workingDirectory?: string;
+}
+/**
+ * Run the worker process.
+ *
+ * This function:
+ * 1. Registers the worker with the orchestrator
+ * 2. Starts a background heartbeat fiber
+ * 3. Runs a work loop that claims and processes tasks
+ * 4. Handles graceful shutdown via SIGTERM/SIGINT
+ *
+ * @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>;
+//# sourceMappingURL=worker-process.d.ts.map

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

@@ -0,0 +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"}

package/dist/services/worker-process.js

@@ -0,0 +1,280 @@
+/**
+ * WorkerProcess - PRD-018
+ *
+ * Implements the worker process with heartbeat fiber, lease renewal,
+ * Claude subprocess management, and graceful shutdown handling.
+ * Uses Effect-TS patterns per DD-002.
+ */
+import { Effect, Duration, Fiber, Ref } from "effect";
+import { spawn } from "child_process";
+import * as os from "os";
+import { WorkerService } from "./worker-service.js";
+import { ClaimService } from "./claim-service.js";
+import { ReadyService } from "./ready-service.js";
+import { TaskService } from "./task-service.js";
+/**
+ * Run the worker process.
+ *
+ * This function:
+ * 1. Registers the worker with the orchestrator
+ * 2. Starts a background heartbeat fiber
+ * 3. Runs a work loop that claims and processes tasks
+ * 4. Handles graceful shutdown via SIGTERM/SIGINT
+ *
+ * @param config Worker process configuration
+ * @returns Effect that runs until shutdown is requested
+ */
+export const runWorkerProcess = (config) => Effect.gen(function* () {
+    const workerService = yield* WorkerService;
+    const claimService = yield* ClaimService;
+    const readyService = yield* ReadyService;
+    const taskService = yield* TaskService;
+    // Shutdown state ref (mutable, shared with signal handlers)
+    const shutdownState = yield* Ref.make({
+        requested: false,
+        claudeProcess: null
+    });
+    // Register with orchestrator
+    const worker = yield* workerService.register({
+        name: config.name,
+        hostname: os.hostname(),
+        pid: process.pid,
+        capabilities: config.capabilities
+    });
+    const workerId = worker.id;
+    yield* Effect.log(`Worker ${workerId} registered`);
+    // Set up signal handlers for graceful shutdown
+    const handleSignal = (signal) => {
+        console.log(`Worker ${workerId} received ${signal}`);
+        // Mark shutdown as requested (sync since signal handlers can't use async)
+        Effect.runSync(Ref.update(shutdownState, (state) => ({
+            ...state,
+            requested: true
+        })));
+        // Try to terminate Claude subprocess if running
+        Effect.runSync(Ref.get(shutdownState).pipe(Effect.map((state) => {
+            if (state.claudeProcess && !state.claudeProcess.killed) {
+                state.claudeProcess.kill("SIGTERM");
+            }
+        })));
+    };
+    process.on("SIGTERM", () => handleSignal("SIGTERM"));
+    process.on("SIGINT", () => handleSignal("SIGINT"));
+    // Completed tasks counter for metrics (shared with heartbeat loop)
+    const tasksCompletedRef = yield* Ref.make(0);
+    // Heartbeat fiber - runs continuously in background
+    const heartbeatFiber = yield* Effect.fork(runHeartbeatLoop(workerId, config.heartbeatIntervalSeconds, shutdownState, tasksCompletedRef));
+    try {
+        // Main work loop
+        while (true) {
+            // Check if shutdown was requested
+            const state = yield* Ref.get(shutdownState);
+            if (state.requested) {
+                yield* Effect.log(`Worker ${workerId} shutting down gracefully`);
+                break;
+            }
+            // Update status to idle
+            yield* workerService.updateStatus(workerId, "idle");
+            // Check for available work
+            const readyTasks = yield* readyService.getReady(1);
+            if (readyTasks.length === 0) {
+                // No work available, wait and try again
+                yield* Effect.sleep(Duration.seconds(5));
+                continue;
+            }
+            const task = readyTasks[0];
+            // Try to claim the task
+            const claimResult = yield* claimService.claim(task.id, workerId).pipe(Effect.either);
+            if (claimResult._tag === "Left") {
+                // Someone else claimed it, try again
+                yield* Effect.log(`Worker ${workerId} failed to claim task ${task.id}: ${claimResult.left._tag}`);
+                continue;
+            }
+            const _claim = claimResult.right;
+            yield* Effect.log(`Worker ${workerId} claimed task ${task.id}`);
+            const tasksCompleted = yield* Ref.get(tasksCompletedRef);
+            // Update worker status to busy with current task
+            yield* workerService.heartbeat({
+                workerId,
+                timestamp: new Date(),
+                status: "busy",
+                currentTaskId: task.id,
+                metrics: {
+                    cpuPercent: process.cpuUsage().user / 1000000,
+                    memoryMb: process.memoryUsage().heapUsed / 1024 / 1024,
+                    tasksCompleted
+                }
+            });
+            // Select appropriate agent for the task
+            const agent = selectAgent(task);
+            // Start lease renewal fiber
+            const renewalInterval = config.leaseRenewalIntervalSeconds ??
+                config.heartbeatIntervalSeconds * 10; // Default: 10x heartbeat interval
+            const renewFiber = yield* Effect.fork(runLeaseRenewalLoop(task.id, workerId, renewalInterval, shutdownState));
+            try {
+                // Run Claude subprocess
+                const result = yield* runClaude(agent, task, workerId, config.workingDirectory ?? process.cwd(), shutdownState);
+                if (result.success) {
+                    // Mark task as done
+                    yield* taskService.update(task.id, { status: "done" });
+                    yield* Ref.update(tasksCompletedRef, (n) => n + 1);
+                    yield* Effect.log(`Task ${task.id} completed successfully`);
+                }
+                else {
+                    yield* Effect.log(`Task ${task.id} failed: ${result.error ?? "Unknown error"}`);
+                }
+                // Release the claim
+                yield* claimService.release(task.id, workerId).pipe(Effect.catchAll((error) => Effect.log(`Failed to release claim for task ${task.id}: ${error.message}`)));
+            }
+            finally {
+                // Stop renewal fiber
+                yield* Fiber.interrupt(renewFiber);
+            }
+        }
+        // Graceful shutdown: mark as stopping
+        yield* workerService.updateStatus(workerId, "stopping");
+    }
+    finally {
+        // Cleanup: stop heartbeat fiber and deregister
+        yield* Fiber.interrupt(heartbeatFiber);
+        // Release any active claims before deregistering
+        yield* claimService.releaseByWorker(workerId).pipe(Effect.catchAll((error) => Effect.log(`Failed to release claims for worker ${workerId}: ${error.message}`).pipe(Effect.as(0))));
+        yield* workerService.deregister(workerId).pipe(Effect.catchAll((error) => Effect.log(`Failed to deregister worker ${workerId}: ${error.message}`)));
+        yield* Effect.log(`Worker ${workerId} shutdown complete`);
+    }
+});
+/**
+ * Run the heartbeat loop.
+ * Sends periodic heartbeats to the orchestrator.
+ */
+const runHeartbeatLoop = (workerId, intervalSeconds, shutdownState, tasksCompletedRef) => Effect.gen(function* () {
+    const workerService = yield* WorkerService;
+    while (true) {
+        // Check shutdown before heartbeat
+        const state = yield* Ref.get(shutdownState);
+        if (state.requested)
+            break;
+        // Determine current status based on whether Claude is running
+        const status = state.claudeProcess ? "busy" : "idle";
+        // Read current completed count from shared ref
+        const tasksCompleted = yield* Ref.get(tasksCompletedRef);
+        yield* workerService
+            .heartbeat({
+            workerId,
+            timestamp: new Date(),
+            status,
+            currentTaskId: undefined, // The main loop sets this
+            metrics: {
+                cpuPercent: process.cpuUsage().user / 1000000,
+                memoryMb: process.memoryUsage().heapUsed / 1024 / 1024,
+                tasksCompleted
+            }
+        })
+            .pipe(Effect.catchAll((error) => Effect.log(`Heartbeat failed for ${workerId}: ${error.message}`)));
+        yield* Effect.sleep(Duration.seconds(intervalSeconds));
+    }
+});
+/**
+ * Run the lease renewal loop.
+ * Periodically renews the lease on a claimed task.
+ */
+const runLeaseRenewalLoop = (taskId, workerId, intervalSeconds, shutdownState) => Effect.gen(function* () {
+    const claimService = yield* ClaimService;
+    while (true) {
+        // Wait before first renewal
+        yield* Effect.sleep(Duration.seconds(intervalSeconds));
+        // Check shutdown before renewal
+        const state = yield* Ref.get(shutdownState);
+        if (state.requested)
+            break;
+        yield* claimService
+            .renew(taskId, workerId)
+            .pipe(Effect.tap(() => Effect.log(`Renewed lease on task ${taskId}`)), Effect.catchAll((error) => Effect.log(`Lease renewal failed for task ${taskId}: ${error.message}`)));
+    }
+});
+/**
+ * Run a Claude subprocess to work on a task.
+ */
+const runClaude = (agent, task, workerId, workingDirectory, shutdownState) => Effect.async((resume) => {
+    const prompt = buildPrompt(agent, task);
+    const proc = spawn("claude", ["--dangerously-skip-permissions", "--print", prompt], {
+        cwd: workingDirectory,
+        env: { ...process.env, TX_WORKER_ID: workerId },
+        stdio: ["pipe", "pipe", "pipe"]
+    });
+    // Store the process reference for signal handling
+    Effect.runSync(Ref.update(shutdownState, (state) => ({
+        ...state,
+        claudeProcess: proc
+    })));
+    let stderr = "";
+    proc.stderr?.on("data", (data) => {
+        stderr += data.toString();
+    });
+    proc.on("close", (code) => {
+        // Clear the process reference
+        Effect.runSync(Ref.update(shutdownState, (state) => ({
+            ...state,
+            claudeProcess: null
+        })));
+        if (code === 0) {
+            resume(Effect.succeed({ success: true, exitCode: code ?? 0 }));
+        }
+        else {
+            resume(Effect.succeed({
+                success: false,
+                error: stderr || `Exit code ${code}`,
+                exitCode: code ?? 1
+            }));
+        }
+    });
+    proc.on("error", (err) => {
+        // Clear the process reference
+        Effect.runSync(Ref.update(shutdownState, (state) => ({
+            ...state,
+            claudeProcess: null
+        })));
+        resume(Effect.succeed({
+            success: false,
+            error: err.message,
+            exitCode: 1
+        }));
+    });
+});
+/**
+ * Build the prompt for the Claude subprocess.
+ */
+const buildPrompt = (agent, task) => `Read .claude/agents/${agent}.md for your instructions.
+
+Your assigned task: ${task.id}
+Task title: ${task.title}
+
+Run \`tx show ${task.id}\` to get full details, then follow your agent instructions.
+When done, run \`tx done ${task.id}\` to mark the task complete.
+If you discover new work, create subtasks with \`tx add\`.
+If you hit a blocker, update the task status: \`tx update ${task.id} --status blocked\`.`;
+/**
+ * Select the appropriate agent based on task characteristics.
+ */
+const selectAgent = (task) => {
+    const title = task.title.toLowerCase();
+    // Test/integration tasks go to tester
+    if (title.includes("test") ||
+        title.includes("integration") ||
+        title.includes("fixture")) {
+        return "tx-tester";
+    }
+    // Review/audit tasks go to reviewer
+    if (title.includes("review") ||
+        title.includes("audit") ||
+        title.includes("check")) {
+        return "tx-reviewer";
+    }
+    // High-priority tasks without children may need decomposition
+    if (task.score >= 800 && task.children.length === 0) {
+        return "tx-decomposer";
+    }
+    // Default to implementer
+    return "tx-implementer";
+};
+//# sourceMappingURL=worker-process.js.map

package/dist/services/worker-process.js.map

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

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

@@ -0,0 +1,74 @@
+/**
+ * WorkerService - PRD-018
+ *
+ * Manages worker registration, heartbeats, and lifecycle.
+ * Uses Effect-TS patterns per DD-002.
+ */
+import { Context, Effect, Layer } from "effect";
+import { WorkerRepository } from "../repo/worker-repo.js";
+import { OrchestratorStateRepository } from "../repo/orchestrator-state-repo.js";
+import { DatabaseError, RegistrationError, WorkerNotFoundError } from "../errors.js";
+import type { Worker, WorkerStatus, Heartbeat } from "../schemas/worker.js";
+/**
+ * Input for worker registration.
+ */
+export interface WorkerRegistration {
+    readonly workerId?: string;
+    readonly name?: string;
+    readonly hostname?: string;
+    readonly pid?: number;
+    readonly capabilities?: readonly string[];
+}
+/**
+ * Filter options for listing workers.
+ */
+export interface WorkerFilter {
+    readonly status?: readonly WorkerStatus[];
+    readonly noCurrentTask?: boolean;
+}
+/**
+ * Configuration for finding dead workers.
+ */
+export interface FindDeadConfig {
+    readonly missedHeartbeats: number;
+}
+declare const WorkerService_base: Context.TagClass<WorkerService, "WorkerService", {
+    /**
+     * Register a new worker with the orchestrator.
+     * Checks orchestrator state and pool capacity before registration.
+     */
+    readonly register: (registration: WorkerRegistration) => Effect.Effect<Worker, RegistrationError | DatabaseError>;
+    /**
+     * Process a heartbeat from a worker.
+     * Updates last heartbeat time, status, and optional metrics.
+     */
+    readonly heartbeat: (heartbeat: Heartbeat) => Effect.Effect<void, WorkerNotFoundError | DatabaseError>;
+    /**
+     * Deregister a worker.
+     * Removes the worker from the registry.
+     * Note: Active claims should be released by ClaimService before calling this.
+     */
+    readonly deregister: (workerId: string) => Effect.Effect<void, WorkerNotFoundError | DatabaseError>;
+    /**
+     * List workers with optional filtering.
+     */
+    readonly list: (filter?: WorkerFilter) => Effect.Effect<readonly Worker[], DatabaseError>;
+    /**
+     * Find workers that have missed heartbeats.
+     * Uses the orchestrator's configured heartbeat interval.
+     */
+    readonly findDead: (config: FindDeadConfig) => Effect.Effect<readonly Worker[], DatabaseError>;
+    /**
+     * Mark a worker as dead.
+     */
+    readonly markDead: (workerId: string) => Effect.Effect<void, WorkerNotFoundError | DatabaseError>;
+    /**
+     * Update a worker's status.
+     */
+    readonly updateStatus: (workerId: string, status: WorkerStatus) => Effect.Effect<void, WorkerNotFoundError | DatabaseError>;
+}>;
+export declare class WorkerService extends WorkerService_base {
+}
+export declare const WorkerServiceLive: Layer.Layer<WorkerService, never, WorkerRepository | OrchestratorStateRepository>;
+export {};
+//# sourceMappingURL=worker-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-service.d.ts","sourceRoot":"","sources":["../../src/services/worker-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAA;AAChF,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,cAAc,CAAA;AACrB,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAE3E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAClC;;IAkBG;;;OAGG;uBACgB,CACjB,YAAY,EAAE,kBAAkB,KAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,aAAa,CAAC;IAE7D;;;OAGG;wBACiB,CAClB,SAAS,EAAE,SAAS,KACjB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,CAAC;IAE7D;;;;OAIG;yBACkB,CACnB,QAAQ,EAAE,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,CAAC;IAE7D;;OAEG;mBACY,CACb,MAAM,CAAC,EAAE,YAAY,KAClB,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,aAAa,CAAC;IAEpD;;;OAGG;uBACgB,CACjB,MAAM,EAAE,cAAc,KACnB,MAAM,CAAC,MAAM,CAAC,SAAS,MAAM,EAAE,EAAE,aAAa,CAAC;IAEpD;;OAEG;uBACgB,CACjB,QAAQ,EAAE,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,CAAC;IAE7D;;OAEG;2BACoB,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,KACjB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,aAAa,CAAC;;AAxDjE,qBAAa,aAAc,SAAQ,kBA0DhC;CAAG;AAEN,eAAO,MAAM,iBAAiB,mFAqK7B,CAAA"}

package/dist/services/worker-service.js

@@ -0,0 +1,148 @@
+/**
+ * WorkerService - PRD-018
+ *
+ * Manages worker registration, heartbeats, and lifecycle.
+ * Uses Effect-TS patterns per DD-002.
+ */
+import { Context, Effect, Layer } from "effect";
+import { createHash, randomBytes } from "crypto";
+import * as os from "os";
+import { WorkerRepository } from "../repo/worker-repo.js";
+import { OrchestratorStateRepository } from "../repo/orchestrator-state-repo.js";
+import { RegistrationError, WorkerNotFoundError } from "../errors.js";
+/**
+ * Generate a unique worker ID.
+ */
+const generateWorkerId = () => {
+    const random = randomBytes(16).toString("hex");
+    const timestamp = Date.now().toString(36);
+    const hash = createHash("sha256")
+        .update(timestamp + random)
+        .digest("hex")
+        .substring(0, 8);
+    return `worker-${hash}`;
+};
+export class WorkerService extends Context.Tag("WorkerService")() {
+}
+export const WorkerServiceLive = Layer.effect(WorkerService, Effect.gen(function* () {
+    const workerRepo = yield* WorkerRepository;
+    const orchestratorRepo = yield* OrchestratorStateRepository;
+    return {
+        register: (registration) => Effect.gen(function* () {
+            // Verify orchestrator is running
+            const state = yield* orchestratorRepo.get();
+            if (state.status !== "running") {
+                return yield* Effect.fail(new RegistrationError({
+                    reason: "Orchestrator is not running"
+                }));
+            }
+            // Count active workers (starting, idle, busy)
+            const startingCount = yield* workerRepo.countByStatus("starting");
+            const idleCount = yield* workerRepo.countByStatus("idle");
+            const busyCount = yield* workerRepo.countByStatus("busy");
+            const activeWorkers = startingCount + idleCount + busyCount;
+            // Check pool capacity
+            if (activeWorkers >= state.workerPoolSize) {
+                return yield* Effect.fail(new RegistrationError({
+                    reason: `Worker pool at capacity (${state.workerPoolSize})`
+                }));
+            }
+            const now = new Date();
+            const worker = {
+                id: registration.workerId ?? generateWorkerId(),
+                name: registration.name ?? `worker-${Date.now()}`,
+                hostname: registration.hostname ?? os.hostname(),
+                pid: registration.pid ?? process.pid,
+                status: "starting",
+                registeredAt: now,
+                lastHeartbeatAt: now,
+                currentTaskId: null,
+                capabilities: [...(registration.capabilities ?? ["tx-implementer"])],
+                metadata: {}
+            };
+            yield* workerRepo.insert(worker);
+            yield* Effect.log(`Worker ${worker.id} registered`);
+            return worker;
+        }),
+        heartbeat: (heartbeat) => Effect.gen(function* () {
+            const worker = yield* workerRepo.findById(heartbeat.workerId);
+            if (!worker) {
+                return yield* Effect.fail(new WorkerNotFoundError({ workerId: heartbeat.workerId }));
+            }
+            // Build updated worker
+            const updated = {
+                ...worker,
+                lastHeartbeatAt: heartbeat.timestamp,
+                status: heartbeat.status,
+                currentTaskId: heartbeat.currentTaskId ?? null,
+                metadata: heartbeat.metrics
+                    ? { ...worker.metadata, lastMetrics: heartbeat.metrics }
+                    : worker.metadata
+            };
+            yield* workerRepo.update(updated);
+        }),
+        deregister: (workerId) => Effect.gen(function* () {
+            const worker = yield* workerRepo.findById(workerId);
+            if (!worker) {
+                return yield* Effect.fail(new WorkerNotFoundError({ workerId }));
+            }
+            // Note: Active claims should be released by ClaimService before calling this.
+            // The ClaimService.releaseByWorker call is handled by the orchestrator/caller.
+            const deleted = yield* workerRepo.delete(workerId);
+            if (deleted) {
+                yield* Effect.log(`Worker ${workerId} deregistered`);
+            }
+        }),
+        list: (filter) => Effect.gen(function* () {
+            // Get all workers in a single query
+            const allWorkers = yield* workerRepo.findAll();
+            if (!filter) {
+                return allWorkers;
+            }
+            let results = [...allWorkers];
+            // Filter by status if specified
+            if (filter.status && filter.status.length > 0) {
+                const statusSet = new Set(filter.status);
+                results = results.filter((w) => statusSet.has(w.status));
+            }
+            // Filter by noCurrentTask if specified
+            if (filter.noCurrentTask) {
+                results = results.filter((w) => w.currentTaskId === null);
+            }
+            return results;
+        }),
+        findDead: (config) => Effect.gen(function* () {
+            const state = yield* orchestratorRepo.get();
+            const heartbeatTimeoutSeconds = state.heartbeatIntervalSeconds * config.missedHeartbeats;
+            const cutoff = new Date(Date.now() - heartbeatTimeoutSeconds * 1000);
+            // Get workers with old heartbeats
+            const staleWorkers = yield* workerRepo.findByLastHeartbeatBefore(cutoff);
+            // Exclude workers that are already dead or stopping
+            return staleWorkers.filter((w) => w.status !== "dead" && w.status !== "stopping");
+        }),
+        markDead: (workerId) => Effect.gen(function* () {
+            const worker = yield* workerRepo.findById(workerId);
+            if (!worker) {
+                return yield* Effect.fail(new WorkerNotFoundError({ workerId }));
+            }
+            const updated = {
+                ...worker,
+                status: "dead"
+            };
+            yield* workerRepo.update(updated);
+            yield* Effect.log(`Worker ${workerId} marked as dead`);
+        }),
+        updateStatus: (workerId, status) => Effect.gen(function* () {
+            const worker = yield* workerRepo.findById(workerId);
+            if (!worker) {
+                return yield* Effect.fail(new WorkerNotFoundError({ workerId }));
+            }
+            const updated = {
+                ...worker,
+                status
+            };
+            yield* workerRepo.update(updated);
+        })
+    };
+}));
+//# sourceMappingURL=worker-service.js.map

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

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

package/dist/utils/glob.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Simple glob matching - checks if file path matches pattern.
+ * Supports: *, **, ?
+ *
+ * - `*` matches any characters except /
+ * - `**` matches any characters including /
+ * - `?` matches a single character
+ *
+ * @example
+ * matchesGlob("src/utils/math.ts", "src/**\/*.ts") // true
+ * matchesGlob("src/index.ts", "*.ts") // false (no / in *)
+ * matchesGlob("file.ts", "file.??") // true
+ */
+export declare const matchesGlob: (filePath: string, pattern: string) => boolean;
+//# sourceMappingURL=glob.d.ts.map

package/dist/utils/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/utils/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,KAAG,OAa/D,CAAA"}

package/dist/utils/glob.js

@@ -0,0 +1,27 @@
+/**
+ * Simple glob matching - checks if file path matches pattern.
+ * Supports: *, **, ?
+ *
+ * - `*` matches any characters except /
+ * - `**` matches any characters including /
+ * - `?` matches a single character
+ *
+ * @example
+ * matchesGlob("src/utils/math.ts", "src/**\/*.ts") // true
+ * matchesGlob("src/index.ts", "*.ts") // false (no / in *)
+ * matchesGlob("file.ts", "file.??") // true
+ */
+export const matchesGlob = (filePath, pattern) => {
+    // Simple glob matching without external dependencies
+    // Order matters: protect glob patterns, escape dots, then restore patterns
+    const regexPattern = pattern
+        .replace(/\*\*/g, "<<<GLOBSTAR>>>") // Protect ** (will become .*)
+        .replace(/\?/g, "<<<QUESTION>>>") // Protect ? (will become .)
+        .replace(/\*/g, "[^/]*") // Replace * with segment matcher
+        .replace(/\./g, "\\.") // Escape literal dots (e.g., .ts → \\.ts)
+        .replace(/<<<GLOBSTAR>>>/g, ".*") // Restore ** as .* (matches any path)
+        .replace(/<<<QUESTION>>>/g, "."); // Restore ? as . (matches single char)
+    const regex = new RegExp(`^${regexPattern}$`);
+    return regex.test(filePath);
+};
+//# sourceMappingURL=glob.js.map

package/dist/utils/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/utils/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,OAAe,EAAW,EAAE;IACxE,qDAAqD;IACrD,2EAA2E;IAC3E,MAAM,YAAY,GAAG,OAAO;SACzB,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,8BAA8B;SACjE,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,4BAA4B;SAC7D,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,iCAAiC;SACzD,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,0CAA0C;SAChE,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,sCAAsC;SACvE,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAA,CAAC,uCAAuC;IAE1E,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAA;IAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AAC7B,CAAC,CAAA"}

package/dist/utils/math.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Calculate cosine similarity between two vectors.
+ * Returns a value between -1 and 1, where 1 means identical direction.
+ */
+export declare const cosineSimilarity: (a: Float32Array, b: Float32Array) => number;
+//# sourceMappingURL=math.d.ts.map

package/dist/utils/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../src/utils/math.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,GAAG,YAAY,EAAE,GAAG,YAAY,KAAG,MAiBnE,CAAA"}