claudecode-omc 4.3.4

package/dist/team/task-file-ops.js

@@ -0,0 +1,348 @@
+// src/team/task-file-ops.ts
+/**
+ * Task File Operations for MCP Team Bridge
+ *
+ * Read/write/scan task JSON files with atomic writes (temp + rename).
+ * Tasks live at ~/.claude/tasks/{teamName}/{id}.json
+ */
+import { readFileSync, readdirSync, existsSync, openSync, closeSync, unlinkSync, writeSync, statSync, constants as fsConstants } from 'fs';
+import { join } from 'path';
+import { getClaudeConfigDir } from '../utils/paths.js';
+import { sanitizeName } from './tmux-session.js';
+import { atomicWriteJson, validateResolvedPath, ensureDirWithMode } from './fs-utils.js';
+/** Default age (ms) after which a lock file is considered stale. */
+const DEFAULT_STALE_LOCK_MS = 30_000;
+/**
+ * Check if a process with the given PID is alive.
+ * Returns false for PIDs <= 0 or if kill(pid, 0) throws ESRCH.
+ */
+function isPidAlive(pid) {
+    if (pid <= 0 || !Number.isFinite(pid))
+        return false;
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        // EPERM means the process exists but we don't have permission — still alive
+        if (e && typeof e === 'object' && 'code' in e && e.code === 'EPERM')
+            return true;
+        return false;
+    }
+}
+/**
+ * Try to acquire an exclusive lock file for a task.
+ *
+ * Uses O_CREAT|O_EXCL|O_WRONLY which atomically creates the file only if
+ * it doesn't already exist — the kernel guarantees no two openers succeed.
+ *
+ * If the lock file already exists, checks for staleness (age > staleLockMs
+ * AND owner PID is dead) and reaps if stale, retrying once.
+ *
+ * Returns a LockHandle on success, or null if the lock is held by another live worker.
+ */
+export function acquireTaskLock(teamName, taskId, opts) {
+    const staleLockMs = opts?.staleLockMs ?? DEFAULT_STALE_LOCK_MS;
+    const dir = tasksDir(teamName);
+    ensureDirWithMode(dir);
+    const lockPath = join(dir, `${sanitizeTaskId(taskId)}.lock`);
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            const fd = openSync(lockPath, fsConstants.O_CREAT | fsConstants.O_EXCL | fsConstants.O_WRONLY, 0o600);
+            // Write payload so stale-detection can read PID + timestamp
+            const payload = JSON.stringify({
+                pid: process.pid,
+                workerName: opts?.workerName ?? '',
+                timestamp: Date.now(),
+            });
+            writeSync(fd, payload, null, 'utf-8');
+            return { fd, path: lockPath };
+        }
+        catch (err) {
+            if (err && typeof err === 'object' && 'code' in err && err.code === 'EEXIST') {
+                // Lock file exists — check if stale
+                if (attempt === 0 && isLockStale(lockPath, staleLockMs)) {
+                    try {
+                        unlinkSync(lockPath);
+                    }
+                    catch { /* another worker reaped it */ }
+                    continue; // retry once
+                }
+                return null; // held by a live worker
+            }
+            throw err; // unexpected error — bubble up
+        }
+    }
+    return null;
+}
+/**
+ * Release a previously acquired task lock.
+ * Closes the file descriptor and removes the lock file.
+ */
+export function releaseTaskLock(handle) {
+    try {
+        closeSync(handle.fd);
+    }
+    catch { /* already closed */ }
+    try {
+        unlinkSync(handle.path);
+    }
+    catch { /* already removed */ }
+}
+/**
+ * Execute a function while holding an exclusive task lock.
+ * Returns the function's result, or null if the lock could not be acquired.
+ */
+export async function withTaskLock(teamName, taskId, fn, opts) {
+    const handle = acquireTaskLock(teamName, taskId, opts);
+    if (!handle)
+        return null;
+    try {
+        return await fn();
+    }
+    finally {
+        releaseTaskLock(handle);
+    }
+}
+/**
+ * Check if an existing lock file is stale.
+ * A lock is stale if it's older than staleLockMs AND the owning PID is dead.
+ */
+function isLockStale(lockPath, staleLockMs) {
+    try {
+        const stat = statSync(lockPath);
+        const ageMs = Date.now() - stat.mtimeMs;
+        if (ageMs < staleLockMs)
+            return false;
+        // Try to read PID from the lock payload
+        try {
+            const raw = readFileSync(lockPath, 'utf-8');
+            const payload = JSON.parse(raw);
+            if (payload.pid && isPidAlive(payload.pid))
+                return false;
+        }
+        catch {
+            // Malformed or unreadable — treat as stale if old enough
+        }
+        return true;
+    }
+    catch {
+        // Lock file disappeared between check and stat — not stale, just gone
+        return false;
+    }
+}
+// ─── End lock helpers ──────────────────────────────────────────────────────
+/** Validate task ID to prevent path traversal */
+function sanitizeTaskId(taskId) {
+    if (!/^[A-Za-z0-9._-]+$/.test(taskId)) {
+        throw new Error(`Invalid task ID: "${taskId}" contains unsafe characters`);
+    }
+    return taskId;
+}
+/** Paths helper */
+function tasksDir(teamName) {
+    const result = join(getClaudeConfigDir(), 'tasks', sanitizeName(teamName));
+    validateResolvedPath(result, join(getClaudeConfigDir(), 'tasks'));
+    return result;
+}
+function taskPath(teamName, taskId) {
+    return join(tasksDir(teamName), `${sanitizeTaskId(taskId)}.json`);
+}
+function failureSidecarPath(teamName, taskId) {
+    return join(tasksDir(teamName), `${sanitizeTaskId(taskId)}.failure.json`);
+}
+/** Read a single task file. Returns null if not found or malformed. */
+export function readTask(teamName, taskId) {
+    const filePath = taskPath(teamName, taskId);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Atomic update: reads full task JSON, patches specified fields, writes back.
+ * Preserves unknown fields to avoid data loss.
+ *
+ * When useLock is true (default), wraps the read-modify-write in an O_EXCL
+ * lock to prevent lost updates from concurrent writers. Falls back to
+ * unlocked write if the lock cannot be acquired within a single attempt
+ * (backward-compatible degradation with a console warning).
+ */
+export function updateTask(teamName, taskId, updates, opts) {
+    const useLock = opts?.useLock ?? true;
+    const doUpdate = () => {
+        const filePath = taskPath(teamName, taskId);
+        let task;
+        try {
+            const raw = readFileSync(filePath, 'utf-8');
+            task = JSON.parse(raw);
+        }
+        catch {
+            throw new Error(`Task file not found or malformed: ${taskId}`);
+        }
+        for (const [key, value] of Object.entries(updates)) {
+            if (value !== undefined) {
+                task[key] = value;
+            }
+        }
+        atomicWriteJson(filePath, task);
+    };
+    if (!useLock) {
+        doUpdate();
+        return;
+    }
+    const handle = acquireTaskLock(teamName, taskId);
+    if (!handle) {
+        // Fallback: another worker holds the lock — proceed without lock + warn
+        // This maintains backward compatibility while logging the degradation
+        if (typeof process !== 'undefined' && process.stderr) {
+            process.stderr.write(`[task-file-ops] WARN: could not acquire lock for task ${taskId}, updating without lock\n`);
+        }
+        doUpdate();
+        return;
+    }
+    try {
+        doUpdate();
+    }
+    finally {
+        releaseTaskLock(handle);
+    }
+}
+/**
+ * Find next executable task for this worker.
+ * Returns first task where:
+ *   - owner === workerName
+ *   - status === 'pending'
+ *   - all blockedBy tasks have status 'completed'
+ * Sorted by ID ascending.
+ *
+ * Uses O_EXCL lock files for atomic claiming — no sleep/jitter needed.
+ * The kernel guarantees only one worker can create the lock file.
+ */
+export async function findNextTask(teamName, workerName) {
+    const dir = tasksDir(teamName);
+    if (!existsSync(dir))
+        return null;
+    const taskIds = listTaskIds(teamName);
+    for (const id of taskIds) {
+        // Quick pre-check without lock (avoid lock overhead for obvious skips)
+        const task = readTask(teamName, id);
+        if (!task)
+            continue;
+        if (task.status !== 'pending')
+            continue;
+        if (task.owner !== workerName)
+            continue;
+        if (!areBlockersResolved(teamName, task.blockedBy))
+            continue;
+        // Attempt atomic lock
+        const handle = acquireTaskLock(teamName, id, { workerName });
+        if (!handle)
+            continue; // another worker holds the lock — skip
+        try {
+            // Re-read under lock to verify state hasn't changed
+            const freshTask = readTask(teamName, id);
+            if (!freshTask ||
+                freshTask.status !== 'pending' ||
+                freshTask.owner !== workerName ||
+                !areBlockersResolved(teamName, freshTask.blockedBy)) {
+                continue; // state changed between pre-check and lock acquisition
+            }
+            // Claim the task atomically
+            const filePath = join(tasksDir(teamName), `${sanitizeTaskId(id)}.json`);
+            let taskData;
+            try {
+                const raw = readFileSync(filePath, 'utf-8');
+                taskData = JSON.parse(raw);
+            }
+            catch {
+                continue;
+            }
+            taskData.claimedBy = workerName;
+            taskData.claimedAt = Date.now();
+            taskData.claimPid = process.pid;
+            taskData.status = 'in_progress';
+            atomicWriteJson(filePath, taskData);
+            return { ...freshTask, claimedBy: workerName, claimedAt: taskData.claimedAt, claimPid: process.pid, status: 'in_progress' };
+        }
+        finally {
+            releaseTaskLock(handle);
+        }
+    }
+    return null;
+}
+/** Check if all blocker task IDs have status 'completed' */
+export function areBlockersResolved(teamName, blockedBy) {
+    if (!blockedBy || blockedBy.length === 0)
+        return true;
+    for (const blockerId of blockedBy) {
+        const blocker = readTask(teamName, blockerId);
+        if (!blocker || blocker.status !== 'completed')
+            return false;
+    }
+    return true;
+}
+/**
+ * Write failure sidecar for a task.
+ * If sidecar already exists, increments retryCount.
+ */
+export function writeTaskFailure(teamName, taskId, error) {
+    const filePath = failureSidecarPath(teamName, taskId);
+    const existing = readTaskFailure(teamName, taskId);
+    const sidecar = {
+        taskId,
+        lastError: error,
+        retryCount: existing ? existing.retryCount + 1 : 1,
+        lastFailedAt: new Date().toISOString(),
+    };
+    atomicWriteJson(filePath, sidecar);
+}
+/** Read failure sidecar if it exists */
+export function readTaskFailure(teamName, taskId) {
+    const filePath = failureSidecarPath(teamName, taskId);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** Default maximum retries before a task is permanently failed */
+export const DEFAULT_MAX_TASK_RETRIES = 5;
+/** Check if a task has exhausted its retry budget */
+export function isTaskRetryExhausted(teamName, taskId, maxRetries = DEFAULT_MAX_TASK_RETRIES) {
+    const failure = readTaskFailure(teamName, taskId);
+    if (!failure)
+        return false;
+    return failure.retryCount >= maxRetries;
+}
+/** List all task IDs in a team directory, sorted ascending */
+export function listTaskIds(teamName) {
+    const dir = tasksDir(teamName);
+    if (!existsSync(dir))
+        return [];
+    try {
+        return readdirSync(dir)
+            .filter(f => f.endsWith('.json') && !f.includes('.tmp.') && !f.includes('.failure.'))
+            .map(f => f.replace('.json', ''))
+            .sort((a, b) => {
+            const numA = parseInt(a, 10);
+            const numB = parseInt(b, 10);
+            if (!isNaN(numA) && !isNaN(numB))
+                return numA - numB;
+            return a.localeCompare(b);
+        });
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=task-file-ops.js.map

package/dist/team/task-file-ops.js.map

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

package/dist/team/task-router.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Smart task routing based on worker capabilities and availability.
+ *
+ * Assigns unassigned tasks to the best available workers by combining:
+ * - Capability fitness scoring
+ * - Worker availability (not dead, not quarantined)
+ * - Current load (prefer idle workers)
+ */
+import type { TaskFile, WorkerCapability, WorkerBackend } from './types.js';
+export interface TaskRoutingDecision {
+    taskId: string;
+    assignedTo: string;
+    backend: WorkerBackend;
+    reason: string;
+    confidence: number;
+}
+/**
+ * Automatically assign tasks to the best available workers.
+ * Uses capability scoring + worker availability + current load.
+ *
+ * @param teamName - Team identifier
+ * @param workingDirectory - Working directory for team data
+ * @param unassignedTasks - Tasks without an owner
+ * @param requiredCapabilities - Optional map of taskId -> required capabilities
+ * @returns Array of routing decisions
+ */
+export declare function routeTasks(teamName: string, workingDirectory: string, unassignedTasks: TaskFile[], requiredCapabilities?: Record<string, WorkerCapability[]>): TaskRoutingDecision[];
+//# sourceMappingURL=task-router.d.ts.map

package/dist/team/task-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-router.d.ts","sourceRoot":"","sources":["../../src/team/task-router.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI5E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,QAAQ,EAAE,EAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,GACxD,mBAAmB,EAAE,CA2DvB"}

package/dist/team/task-router.js

@@ -0,0 +1,61 @@
+// src/team/task-router.ts
+import { getTeamMembers } from './unified-team.js';
+import { scoreWorkerFitness } from './capabilities.js';
+/**
+ * Automatically assign tasks to the best available workers.
+ * Uses capability scoring + worker availability + current load.
+ *
+ * @param teamName - Team identifier
+ * @param workingDirectory - Working directory for team data
+ * @param unassignedTasks - Tasks without an owner
+ * @param requiredCapabilities - Optional map of taskId -> required capabilities
+ * @returns Array of routing decisions
+ */
+export function routeTasks(teamName, workingDirectory, unassignedTasks, requiredCapabilities) {
+    if (unassignedTasks.length === 0)
+        return [];
+    const allMembers = getTeamMembers(teamName, workingDirectory);
+    // Filter to available workers (not dead, not quarantined)
+    const available = allMembers.filter(m => m.status !== 'dead' && m.status !== 'quarantined');
+    if (available.length === 0)
+        return [];
+    const decisions = [];
+    // Track assignments to balance load
+    const assignmentCounts = new Map();
+    for (const m of available) {
+        // Count existing in-progress tasks
+        assignmentCounts.set(m.name, m.currentTaskId ? 1 : 0);
+    }
+    for (const task of unassignedTasks) {
+        const caps = requiredCapabilities?.[task.id] || ['general'];
+        // Score each available worker
+        const scored = available
+            .map(worker => {
+            const fitnessScore = scoreWorkerFitness(worker, caps);
+            const currentLoad = assignmentCounts.get(worker.name) || 0;
+            // Penalize busy workers: each assigned task reduces score by 0.2
+            const loadPenalty = currentLoad * 0.2;
+            // Prefer idle workers
+            const idleBonus = worker.status === 'idle' ? 0.1 : 0;
+            // Ensure final score stays in 0-1 range
+            const finalScore = Math.min(1, Math.max(0, fitnessScore - loadPenalty + idleBonus));
+            return { worker, score: finalScore, fitnessScore };
+        })
+            .filter(s => s.fitnessScore > 0) // Must have at least some capability match
+            .sort((a, b) => b.score - a.score);
+        if (scored.length > 0) {
+            const best = scored[0];
+            decisions.push({
+                taskId: task.id,
+                assignedTo: best.worker.name,
+                backend: best.worker.backend,
+                reason: `Best fitness score (${best.fitnessScore.toFixed(2)}) for capabilities [${caps.join(', ')}]`,
+                confidence: best.score,
+            });
+            // Track the assignment
+            assignmentCounts.set(best.worker.name, (assignmentCounts.get(best.worker.name) || 0) + 1);
+        }
+    }
+    return decisions;
+}
+//# sourceMappingURL=task-router.js.map

package/dist/team/task-router.js.map

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

package/dist/team/team-registration.d.ts

@@ -0,0 +1,30 @@
+import type { McpWorkerMember, ConfigProbeResult } from './types.js';
+/** Read cached probe result. Returns null if not probed yet. */
+export declare function readProbeResult(workingDirectory: string): ConfigProbeResult | null;
+/** Write probe result cache */
+export declare function writeProbeResult(workingDirectory: string, result: ConfigProbeResult): void;
+/**
+ * Determine registration strategy: 'config' (direct) or 'shadow' (fallback).
+ * Based on cached probe result. Defaults to 'shadow' if not probed.
+ */
+export declare function getRegistrationStrategy(workingDirectory: string): 'config' | 'shadow';
+/**
+ * Register an MCP worker in the team.
+ *
+ * Strategy auto-selected based on cached probe result:
+ * - 'config': Write member to config.json (preferred)
+ * - 'shadow': Write member to .omc/state/team-mcp-workers.json (fallback)
+ *
+ * Both paths use atomic write (temp + rename) to prevent corruption.
+ */
+export declare function registerMcpWorker(teamName: string, workerName: string, provider: 'codex' | 'gemini', model: string, tmuxTarget: string, cwd: string, workingDirectory: string): void;
+/**
+ * Unregister an MCP worker from the team.
+ * Removes from config.json and shadow registry.
+ */
+export declare function unregisterMcpWorker(teamName: string, workerName: string, workingDirectory: string): void;
+/** Check if a member entry is an MCP worker */
+export declare function isMcpWorker(member: Record<string, unknown>): boolean;
+/** List all MCP workers for a team (reads from both config.json and shadow registry) */
+export declare function listMcpWorkers(teamName: string, workingDirectory: string): McpWorkerMember[];
+//# sourceMappingURL=team-registration.d.ts.map

package/dist/team/team-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-registration.d.ts","sourceRoot":"","sources":["../../src/team/team-registration.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAwBrE,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CASlF;AAED,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAE1F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAKrF;AAID;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,GAAG,QAAQ,EAC5B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,MAAM,GACvB,IAAI,CAqBN;AA+CD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,GACvB,IAAI,CAyBN;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEpE;AAED,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,eAAe,EAAE,CAiC5F"}