claudecode-omc 4.5.7 → 4.7.4

package/dist/team/scaling.js

@@ -0,0 +1,311 @@
+/**
+ * Dynamic worker scaling for team mode — Phase 1: Manual Scaling.
+ *
+ * Provides scale_up (add workers mid-session) and scale_down (drain + remove idle workers).
+ * Gated behind the OMC_TEAM_SCALING_ENABLED environment variable.
+ *
+ * Key design decisions:
+ * - Monotonic worker index counter (next_worker_index in config) ensures unique names
+ * - File-based scaling lock prevents concurrent scale operations
+ * - 'draining' worker status for graceful transitions during scale_down
+ */
+import { resolve } from 'path';
+import { mkdir } from 'fs/promises';
+import { execFileSync, spawnSync } from 'child_process';
+import { teamReadConfig, teamWriteWorkerIdentity, teamReadWorkerStatus, teamAppendEvent, writeAtomic, } from './team-ops.js';
+import { withScalingLock, saveTeamConfig } from './monitor.js';
+import { sanitizeName, isWorkerAlive, killWorkerPanes, buildWorkerStartCommand, waitForPaneReady, } from './tmux-session.js';
+import { TeamPaths, absPath } from './state-paths.js';
+// ── Environment gate ──────────────────────────────────────────────────────────
+const OMC_TEAM_SCALING_ENABLED_ENV = 'OMC_TEAM_SCALING_ENABLED';
+export function isScalingEnabled(env = process.env) {
+    const raw = env[OMC_TEAM_SCALING_ENABLED_ENV];
+    if (!raw)
+        return false;
+    const normalized = raw.trim().toLowerCase();
+    return ['1', 'true', 'yes', 'on', 'enabled'].includes(normalized);
+}
+function assertScalingEnabled(env = process.env) {
+    if (!isScalingEnabled(env)) {
+        throw new Error(`Dynamic scaling is disabled. Set ${OMC_TEAM_SCALING_ENABLED_ENV}=1 to enable.`);
+    }
+}
+// ── Scale Up ──────────────────────────────────────────────────────────────────
+/**
+ * Add workers to a running team mid-session.
+ *
+ * Acquires the file-based scaling lock, reads the current config,
+ * validates capacity, creates new tmux panes, and bootstraps workers.
+ */
+export async function scaleUp(teamName, count, agentType, tasks, cwd, env = process.env) {
+    assertScalingEnabled(env);
+    if (!Number.isInteger(count) || count < 1) {
+        return { ok: false, error: `count must be a positive integer (got ${count})` };
+    }
+    const sanitized = sanitizeName(teamName);
+    const leaderCwd = resolve(cwd);
+    return await withScalingLock(sanitized, leaderCwd, async () => {
+        const config = await teamReadConfig(sanitized, leaderCwd);
+        if (!config) {
+            return { ok: false, error: `Team ${sanitized} not found` };
+        }
+        const maxWorkers = config.max_workers ?? 20;
+        const currentCount = config.workers.length;
+        if (currentCount + count > maxWorkers) {
+            return {
+                ok: false,
+                error: `Cannot add ${count} workers: would exceed max_workers (${currentCount} + ${count} > ${maxWorkers})`,
+            };
+        }
+        const teamStateRoot = config.team_state_root ?? `${leaderCwd}/.omc/state`;
+        const sessionName = config.tmux_session ?? `omc-team-${sanitized}`;
+        // Resolve the monotonic worker index counter
+        let nextIndex = config.next_worker_index ?? (currentCount + 1);
+        const initialNextIndex = nextIndex;
+        const addedWorkers = [];
+        const rollbackScaleUp = async (error, paneId) => {
+            for (const w of addedWorkers) {
+                const idx = config.workers.findIndex((worker) => worker.name === w.name);
+                if (idx >= 0) {
+                    config.workers.splice(idx, 1);
+                }
+                try {
+                    if (w.pane_id) {
+                        execFileSync('tmux', ['kill-pane', '-t', w.pane_id], { stdio: 'pipe' });
+                    }
+                }
+                catch { /* best-effort pane cleanup */ }
+            }
+            if (paneId) {
+                try {
+                    execFileSync('tmux', ['kill-pane', '-t', paneId], { stdio: 'pipe' });
+                }
+                catch { /* best-effort pane cleanup */ }
+            }
+            config.worker_count = config.workers.length;
+            config.next_worker_index = initialNextIndex;
+            await saveTeamConfig(config, leaderCwd);
+            return { ok: false, error };
+        };
+        for (let i = 0; i < count; i++) {
+            const workerIndex = nextIndex;
+            nextIndex++;
+            const workerName = `worker-${workerIndex}`;
+            // Create worker directory
+            const workerDirPath = absPath(leaderCwd, TeamPaths.workerDir(sanitized, workerName));
+            await mkdir(workerDirPath, { recursive: true });
+            // Build startup command and create tmux pane
+            const extraEnv = {
+                OMC_TEAM_STATE_ROOT: teamStateRoot,
+                OMC_TEAM_LEADER_CWD: leaderCwd,
+                OMC_TEAM_WORKER: `${sanitized}/${workerName}`,
+            };
+            const cmd = buildWorkerStartCommand({
+                teamName: sanitized,
+                workerName,
+                envVars: extraEnv,
+                launchArgs: [],
+                launchBinary: 'claude',
+                launchCmd: '',
+                cwd: leaderCwd,
+            });
+            // Split from the rightmost worker pane or the leader pane
+            const splitTarget = config.workers.length > 0
+                ? (config.workers[config.workers.length - 1]?.pane_id ?? config.leader_pane_id ?? '')
+                : (config.leader_pane_id ?? '');
+            const splitDirection = splitTarget === (config.leader_pane_id ?? '') ? '-h' : '-v';
+            const result = spawnSync('tmux', [
+                'split-window', splitDirection, '-t', splitTarget, '-d', '-P', '-F', '#{pane_id}', '-c', leaderCwd, cmd,
+            ], { encoding: 'utf-8' });
+            if (result.status !== 0) {
+                return await rollbackScaleUp(`Failed to create tmux pane for ${workerName}: ${(result.stderr || '').trim()}`);
+            }
+            const paneId = (result.stdout || '').trim().split('\n')[0]?.trim();
+            if (!paneId || !paneId.startsWith('%')) {
+                return await rollbackScaleUp(`Failed to capture pane ID for ${workerName}`);
+            }
+            // Get PID
+            let panePid;
+            try {
+                const pidResult = spawnSync('tmux', ['display-message', '-t', paneId, '-p', '#{pane_pid}'], { encoding: 'utf-8' });
+                const pidStr = (pidResult.stdout || '').trim();
+                const parsed = Number.parseInt(pidStr, 10);
+                if (Number.isFinite(parsed))
+                    panePid = parsed;
+            }
+            catch { /* best-effort pid lookup */ }
+            // Resolve per-worker role from assigned task roles
+            const workerTaskRoles = tasks.filter(t => t.owner === workerName).map(t => t.role).filter(Boolean);
+            const uniqueTaskRoles = new Set(workerTaskRoles);
+            const workerRole = workerTaskRoles.length > 0 && uniqueTaskRoles.size === 1
+                ? workerTaskRoles[0]
+                : agentType;
+            const workerInfo = {
+                name: workerName,
+                index: workerIndex,
+                role: workerRole,
+                assigned_tasks: [],
+                pid: panePid,
+                pane_id: paneId,
+                working_dir: leaderCwd,
+                team_state_root: teamStateRoot,
+            };
+            await teamWriteWorkerIdentity(sanitized, workerName, workerInfo, leaderCwd);
+            // Wait for worker readiness
+            const readyTimeoutMs = resolveWorkerReadyTimeoutMs(env);
+            const skipReadyWait = env.OMC_TEAM_SKIP_READY_WAIT === '1';
+            if (!skipReadyWait) {
+                try {
+                    await waitForPaneReady(paneId, { timeoutMs: readyTimeoutMs });
+                }
+                catch {
+                    // Non-fatal: worker may still become ready
+                }
+            }
+            addedWorkers.push(workerInfo);
+            config.workers.push(workerInfo);
+            config.worker_count = config.workers.length;
+            config.next_worker_index = nextIndex;
+            await saveTeamConfig(config, leaderCwd);
+        }
+        await teamAppendEvent(sanitized, {
+            type: 'team_leader_nudge',
+            worker: 'leader-fixed',
+            reason: `scale_up: added ${count} worker(s), new count=${config.worker_count}`,
+        }, leaderCwd);
+        return {
+            ok: true,
+            addedWorkers,
+            newWorkerCount: config.worker_count,
+            nextWorkerIndex: nextIndex,
+        };
+    });
+}
+/**
+ * Remove workers from a running team.
+ *
+ * Sets targeted workers to 'draining' status, waits for them to finish
+ * current work (or force kills), then removes tmux panes and updates config.
+ */
+export async function scaleDown(teamName, cwd, options = {}, env = process.env) {
+    assertScalingEnabled(env);
+    const sanitized = sanitizeName(teamName);
+    const leaderCwd = resolve(cwd);
+    const force = options.force === true;
+    const drainTimeoutMs = options.drainTimeoutMs ?? 30_000;
+    return await withScalingLock(sanitized, leaderCwd, async () => {
+        const config = await teamReadConfig(sanitized, leaderCwd);
+        if (!config) {
+            return { ok: false, error: `Team ${sanitized} not found` };
+        }
+        // Determine which workers to remove
+        let targetWorkers;
+        if (options.workerNames && options.workerNames.length > 0) {
+            targetWorkers = [];
+            for (const name of options.workerNames) {
+                const w = config.workers.find(w => w.name === name);
+                if (!w) {
+                    return { ok: false, error: `Worker ${name} not found in team ${sanitized}` };
+                }
+                targetWorkers.push(w);
+            }
+        }
+        else {
+            const count = options.count ?? 1;
+            if (!Number.isInteger(count) || count < 1) {
+                return { ok: false, error: `count must be a positive integer (got ${count})` };
+            }
+            // Find idle workers to remove
+            const idleWorkers = [];
+            for (const w of config.workers) {
+                const status = await teamReadWorkerStatus(sanitized, w.name, leaderCwd);
+                if (status.state === 'idle' || status.state === 'done' || status.state === 'unknown') {
+                    idleWorkers.push(w);
+                }
+            }
+            if (idleWorkers.length < count && !force) {
+                return {
+                    ok: false,
+                    error: `Not enough idle workers to remove: found ${idleWorkers.length}, requested ${count}. Use force=true to remove busy workers.`,
+                };
+            }
+            targetWorkers = idleWorkers.slice(0, count);
+            if (force && targetWorkers.length < count) {
+                const remaining = count - targetWorkers.length;
+                const targetNames = new Set(targetWorkers.map(w => w.name));
+                const nonIdle = config.workers.filter(w => !targetNames.has(w.name));
+                targetWorkers.push(...nonIdle.slice(0, remaining));
+            }
+        }
+        if (targetWorkers.length === 0) {
+            return { ok: false, error: 'No workers selected for removal' };
+        }
+        // Minimum worker guard: must keep at least 1 worker
+        if (config.workers.length - targetWorkers.length < 1) {
+            return { ok: false, error: 'Cannot remove all workers — at least 1 must remain' };
+        }
+        const removedNames = [];
+        // Phase 1: Set workers to 'draining' status
+        for (const w of targetWorkers) {
+            const drainingStatus = {
+                state: 'draining',
+                reason: 'scale_down requested by leader',
+                updated_at: new Date().toISOString(),
+            };
+            const statusPath = absPath(leaderCwd, TeamPaths.workerStatus(sanitized, w.name));
+            await writeAtomic(statusPath, JSON.stringify(drainingStatus, null, 2));
+        }
+        // Phase 2: Wait for draining workers to finish or timeout
+        if (!force) {
+            const deadline = Date.now() + drainTimeoutMs;
+            while (Date.now() < deadline) {
+                const allDrained = await Promise.all(targetWorkers.map(async (w) => {
+                    const status = await teamReadWorkerStatus(sanitized, w.name, leaderCwd);
+                    const alive = w.pane_id ? await isWorkerAlive(w.pane_id) : false;
+                    return status.state === 'idle' || status.state === 'done' ||
+                        status.state === 'draining' || !alive;
+                }));
+                if (allDrained.every(Boolean))
+                    break;
+                await new Promise(r => setTimeout(r, 2_000));
+            }
+        }
+        // Phase 3: Kill tmux panes and remove from config
+        const targetPaneIds = targetWorkers
+            .map((w) => w.pane_id)
+            .filter((paneId) => typeof paneId === 'string' && paneId.trim().length > 0);
+        await killWorkerPanes({
+            paneIds: targetPaneIds,
+            leaderPaneId: config.leader_pane_id ?? undefined,
+            teamName: sanitized,
+            cwd: leaderCwd,
+        });
+        for (const w of targetWorkers) {
+            removedNames.push(w.name);
+        }
+        // Phase 4: Update config
+        const removedSet = new Set(removedNames);
+        config.workers = config.workers.filter(w => !removedSet.has(w.name));
+        config.worker_count = config.workers.length;
+        await saveTeamConfig(config, leaderCwd);
+        await teamAppendEvent(sanitized, {
+            type: 'team_leader_nudge',
+            worker: 'leader-fixed',
+            reason: `scale_down: removed ${removedNames.length} worker(s) [${removedNames.join(', ')}], new count=${config.worker_count}`,
+        }, leaderCwd);
+        return {
+            ok: true,
+            removedWorkers: removedNames,
+            newWorkerCount: config.worker_count,
+        };
+    });
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function resolveWorkerReadyTimeoutMs(env) {
+    const raw = env.OMC_TEAM_READY_TIMEOUT_MS;
+    const parsed = Number.parseInt(String(raw ?? ''), 10);
+    if (Number.isFinite(parsed) && parsed >= 5_000)
+        return parsed;
+    return 45_000;
+}
+//# sourceMappingURL=scaling.js.map

package/dist/team/scaling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaling.js","sourceRoot":"","sources":["../../src/team/scaling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EACL,cAAc,EACd,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,WAAW,GAGZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,YAAY,EACZ,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEtD,iFAAiF;AAEjF,MAAM,4BAA4B,GAAG,0BAA0B,CAAC;AAEhE,MAAM,UAAU,gBAAgB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACnE,MAAM,GAAG,GAAG,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAyB,OAAO,CAAC,GAAG;IAChE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,oCAAoC,4BAA4B,eAAe,CAChF,CAAC;IACJ,CAAC;AACH,CAAC;AAsBD,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,QAAgB,EAChB,KAAa,EACb,SAAiB,EACjB,KAA4G,EAC5G,GAAW,EACX,MAAyB,OAAO,CAAC,GAAG;IAEpC,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAE1B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yCAAyC,KAAK,GAAG,EAAE,CAAC;IACjF,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAE/B,OAAO,MAAM,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,IAAyC,EAAE;QACjG,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,SAAS,YAAY,EAAE,CAAC;QAC7D,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;QAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAC3C,IAAI,YAAY,GAAG,KAAK,GAAG,UAAU,EAAE,CAAC;YACtC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,cAAc,KAAK,uCAAuC,YAAY,MAAM,KAAK,MAAM,UAAU,GAAG;aAC5G,CAAC;QACJ,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,IAAI,GAAG,SAAS,aAAa,CAAC;QAC1E,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,IAAI,YAAY,SAAS,EAAE,CAAC;QAEnE,6CAA6C;QAC7C,IAAI,SAAS,GAAG,MAAM,CAAC,iBAAiB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;QAC/D,MAAM,gBAAgB,GAAG,SAAS,CAAC;QACnC,MAAM,YAAY,GAAiB,EAAE,CAAC;QAEtC,MAAM,eAAe,GAAG,KAAK,EAAE,KAAa,EAAE,MAAe,EAAuB,EAAE;YACpF,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;gBACzE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;oBACb,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAChC,CAAC;gBACD,IAAI,CAAC;oBACH,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;wBACd,YAAY,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC1E,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC,CAAC,8BAA8B,CAAC,CAAC;YAC5C,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC;oBACH,YAAY,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvE,CAAC;gBAAC,MAAM,CAAC,CAAC,8BAA8B,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5C,MAAM,CAAC,iBAAiB,GAAG,gBAAgB,CAAC;YAC5C,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YAExC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC,CAAC;QAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,WAAW,GAAG,SAAS,CAAC;YAC9B,SAAS,EAAE,CAAC;YACZ,MAAM,UAAU,GAAG,UAAU,WAAW,EAAE,CAAC;YAE3C,0BAA0B;YAC1B,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;YACrF,MAAM,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEhD,6CAA6C;YAC7C,MAAM,QAAQ,GAA2B;gBACvC,mBAAmB,EAAE,aAAa;gBAClC,mBAAmB,EAAE,SAAS;gBAC9B,eAAe,EAAE,GAAG,SAAS,IAAI,UAAU,EAAE;aAC9C,CAAC;YAEF,MAAM,GAAG,GAAG,uBAAuB,CAAC;gBAClC,QAAQ,EAAE,SAAS;gBACnB,UAAU;gBACV,OAAO,EAAE,QAAQ;gBACjB,UAAU,EAAE,EAAE;gBACd,YAAY,EAAE,QAAQ;gBACtB,SAAS,EAAE,EAAE;gBACb,GAAG,EAAE,SAAS;aACf,CAAC,CAAC;YAEH,0DAA0D;YAC1D,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAC3C,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC;gBACrF,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;YAClC,MAAM,cAAc,GAAG,WAAW,KAAK,CAAC,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YAEnF,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE;gBAC/B,cAAc,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG;aACxG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;YAE1B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACxB,OAAO,MAAM,eAAe,CAAC,kCAAkC,UAAU,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChH,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YACnE,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvC,OAAO,MAAM,eAAe,CAAC,iCAAiC,UAAU,EAAE,CAAC,CAAC;YAC9E,CAAC;YAED,UAAU;YACV,IAAI,OAA2B,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;gBACnH,MAAM,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAAE,OAAO,GAAG,MAAM,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC,CAAC,4BAA4B,CAAC,CAAC;YAExC,mDAAmD;YACnD,MAAM,eAAe,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;YAC/G,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC;YACjD,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,IAAI,KAAK,CAAC;gBACzE,CAAC,CAAC,eAAe,CAAC,CAAC,CAAE;gBACrB,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,UAAU,GAAe;gBAC7B,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,UAAU;gBAChB,cAAc,EAAE,EAAE;gBAClB,GAAG,EAAE,OAAO;gBACZ,OAAO,EAAE,MAAM;gBACf,WAAW,EAAE,SAAS;gBACtB,eAAe,EAAE,aAAa;aAC/B,CAAC;YAEF,MAAM,uBAAuB,CAAC,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;YAE5E,4BAA4B;YAC5B,MAAM,cAAc,GAAG,2BAA2B,CAAC,GAAG,CAAC,CAAC;YACxD,MAAM,aAAa,GAAG,GAAG,CAAC,wBAAwB,KAAK,GAAG,CAAC;YAC3D,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,IAAI,CAAC;oBACH,MAAM,gBAAgB,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;gBAChE,CAAC;gBAAC,MAAM,CAAC;oBACP,2CAA2C;gBAC7C,CAAC;YACH,CAAC;YAED,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAChC,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;YAC5C,MAAM,CAAC,iBAAiB,GAAG,SAAS,CAAC;YACrC,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,eAAe,CAAC,SAAS,EAAE;YAC/B,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,mBAAmB,KAAK,yBAAyB,MAAM,CAAC,YAAY,EAAE;SAC/E,EAAE,SAAS,CAAC,CAAC;QAEd,OAAO;YACL,EAAE,EAAE,IAAI;YACR,YAAY;YACZ,cAAc,EAAE,MAAM,CAAC,YAAY;YACnC,eAAe,EAAE,SAAS;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAeD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAAgB,EAChB,GAAW,EACX,UAA4B,EAAE,EAC9B,MAAyB,OAAO,CAAC,GAAG;IAEpC,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAE1B,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC;IACrC,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,MAAM,CAAC;IAExD,OAAO,MAAM,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,IAA2C,EAAE;QACnG,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,SAAS,YAAY,EAAE,CAAC;QAC7D,CAAC;QAED,oCAAoC;QACpC,IAAI,aAA2B,CAAC;QAChC,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,aAAa,GAAG,EAAE,CAAC;YACnB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;gBACvC,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;gBACpD,IAAI,CAAC,CAAC,EAAE,CAAC;oBACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,IAAI,sBAAsB,SAAS,EAAE,EAAE,CAAC;gBAC/E,CAAC;gBACD,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC1C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yCAAyC,KAAK,GAAG,EAAE,CAAC;YACjF,CAAC;YACD,8BAA8B;YAC9B,MAAM,WAAW,GAAiB,EAAE,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBACxE,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;oBACrF,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACtB,CAAC;YACH,CAAC;YACD,IAAI,WAAW,CAAC,MAAM,GAAG,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;gBACzC,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,4CAA4C,WAAW,CAAC,MAAM,eAAe,KAAK,0CAA0C;iBACpI,CAAC;YACJ,CAAC;YACD,aAAa,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAC5C,IAAI,KAAK,IAAI,aAAa,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;gBAC1C,MAAM,SAAS,GAAG,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC;gBAC/C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACrE,aAAa,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC;QACjE,CAAC;QAED,oDAAoD;QACpD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,oDAAoD,EAAE,CAAC;QACpF,CAAC;QAED,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,4CAA4C;QAC5C,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YAC9B,MAAM,cAAc,GAAiB;gBACnC,KAAK,EAAE,UAAU;gBACjB,MAAM,EAAE,gCAAgC;gBACxC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACrC,CAAC;YACF,MAAM,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACjF,MAAM,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,0DAA0D;QAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,CAAC;YAC7C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;gBAC7B,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;oBAC5B,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;oBACxE,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;oBACjE,OAAO,MAAM,CAAC,KAAK,KAAK,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,MAAM;wBAClD,MAAM,CAAC,KAAK,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC;gBAC/C,CAAC,CAAC,CACH,CAAC;gBACF,IAAI,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;oBAAE,MAAM;gBACrC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,MAAM,aAAa,GAAG,aAAa;aAChC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;aACrB,MAAM,CAAC,CAAC,MAAM,EAAoB,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEhG,MAAM,eAAe,CAAC;YACpB,OAAO,EAAE,aAAa;YACtB,YAAY,EAAE,MAAM,CAAC,cAAc,IAAI,SAAS;YAChD,QAAQ,EAAE,SAAS;YACnB,GAAG,EAAE,SAAS;SACf,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YAC9B,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,yBAAyB;QACzB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACrE,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5C,MAAM,cAAc,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAExC,MAAM,eAAe,CAAC,SAAS,EAAE;YAC/B,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,cAAc;YACtB,MAAM,EAAE,uBAAuB,YAAY,CAAC,MAAM,eAAe,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,YAAY,EAAE;SAC9H,EAAE,SAAS,CAAC,CAAC;QAEd,OAAO;YACL,EAAE,EAAE,IAAI;YACR,cAAc,EAAE,YAAY;YAC5B,cAAc,EAAE,MAAM,CAAC,YAAY;SACpC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iFAAiF;AAEjF,SAAS,2BAA2B,CAAC,GAAsB;IACzD,MAAM,GAAG,GAAG,GAAG,CAAC,yBAAyB,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,KAAK;QAAE,OAAO,MAAM,CAAC;IAC9D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/team/sentinel-gate.d.ts

@@ -0,0 +1,23 @@
+export interface SentinelReadinessOptions {
+    logPath?: string;
+    workspace?: string;
+    claims?: Record<string, unknown>;
+    enabled?: boolean;
+}
+export interface SentinelGateResult {
+    ready: boolean;
+    blockers: string[];
+    skipped: boolean;
+}
+export interface SentinelWaitOptions extends SentinelReadinessOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+export interface SentinelWaitResult extends SentinelGateResult {
+    timedOut: boolean;
+    elapsedMs: number;
+    attempts: number;
+}
+export declare function checkSentinelReadiness(options?: SentinelReadinessOptions): SentinelGateResult;
+export declare function waitForSentinelReadiness(options?: SentinelWaitOptions): Promise<SentinelWaitResult>;
+//# sourceMappingURL=sentinel-gate.d.ts.map

package/dist/team/sentinel-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel-gate.d.ts","sourceRoot":"","sources":["../../src/team/sentinel-gate.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,wBAAwB;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA+CD,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,wBAA6B,GACrC,kBAAkB,CAqDpB;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA2C7B"}

package/dist/team/sentinel-gate.js

@@ -0,0 +1,127 @@
+import { runFactcheck } from '../hooks/factcheck/index.js';
+import { checkSentinelHealth } from '../hooks/factcheck/sentinel.js';
+import { loadGuardsConfig } from '../hooks/factcheck/config.js';
+function mapFactcheckToBlockers(result) {
+    if (result.verdict === 'PASS') {
+        return [];
+    }
+    if (result.mismatches.length === 0) {
+        return [`[factcheck] verdict ${result.verdict}`];
+    }
+    return result.mismatches.map(mismatch => `[factcheck] ${mismatch.severity} ${mismatch.check}: ${mismatch.detail}`);
+}
+/**
+ * Coerce a value expected to be an array into an actual array.
+ * - If already an array, return as-is.
+ * - If nullish, return empty array.
+ * - Otherwise wrap in a single-element array.
+ */
+function coerceArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (value == null)
+        return [];
+    if (typeof value === 'object' && !Array.isArray(value))
+        return [];
+    return [value];
+}
+/**
+ * Validate and coerce a claims object so downstream factcheck code
+ * never throws on unexpected shapes (e.g. `{ files_modified: {} }`).
+ */
+function sanitizeClaims(raw) {
+    const out = { ...raw };
+    const arrayFields = [
+        'files_modified', 'files_created', 'files_deleted',
+        'artifacts_expected', 'commands_executed', 'models_used',
+    ];
+    for (const field of arrayFields) {
+        if (field in out) {
+            out[field] = coerceArray(out[field]);
+        }
+    }
+    return out;
+}
+export function checkSentinelReadiness(options = {}) {
+    const { logPath, workspace, claims, enabled = loadGuardsConfig(workspace).sentinel.enabled, } = options;
+    if (!enabled) {
+        return {
+            ready: true,
+            blockers: [],
+            skipped: true,
+        };
+    }
+    const blockers = [];
+    let ranCheck = false;
+    if (logPath) {
+        ranCheck = true;
+        const health = checkSentinelHealth(logPath, workspace);
+        blockers.push(...health.blockers);
+    }
+    if (claims) {
+        ranCheck = true;
+        try {
+            const sanitized = sanitizeClaims(claims);
+            const factcheck = runFactcheck(sanitized, { workspace });
+            blockers.push(...mapFactcheckToBlockers(factcheck));
+        }
+        catch (err) {
+            blockers.push(`[factcheck] execution error: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    // Fail-closed: if the gate is enabled but no checks ran, do not pass.
+    if (!ranCheck) {
+        return {
+            ready: false,
+            blockers: ['[sentinel] gate enabled but no logPath or claims provided — cannot verify readiness'],
+            skipped: true,
+        };
+    }
+    const dedupedBlockers = [...new Set(blockers)];
+    return {
+        ready: dedupedBlockers.length === 0,
+        blockers: dedupedBlockers,
+        skipped: false,
+    };
+}
+export async function waitForSentinelReadiness(options = {}) {
+    const timeoutMs = Math.max(0, options.timeoutMs ?? 30_000);
+    const pollIntervalMs = Math.max(50, options.pollIntervalMs ?? 250);
+    const startedAt = Date.now();
+    let attempts = 1;
+    let latest = checkSentinelReadiness(options);
+    if (latest.ready) {
+        return {
+            ...latest,
+            timedOut: false,
+            elapsedMs: Date.now() - startedAt,
+            attempts,
+        };
+    }
+    const deadline = startedAt + timeoutMs;
+    while (Date.now() < deadline) {
+        await new Promise(resolve => setTimeout(resolve, pollIntervalMs));
+        attempts += 1;
+        latest = checkSentinelReadiness(options);
+        if (latest.ready) {
+            return {
+                ...latest,
+                timedOut: false,
+                elapsedMs: Date.now() - startedAt,
+                attempts,
+            };
+        }
+    }
+    const timeoutBlocker = `[sentinel] readiness check timed out after ${timeoutMs}ms`;
+    const blockers = latest.blockers.includes(timeoutBlocker)
+        ? latest.blockers
+        : [...latest.blockers, timeoutBlocker];
+    return {
+        ...latest,
+        blockers,
+        timedOut: true,
+        elapsedMs: Date.now() - startedAt,
+        attempts,
+    };
+}
+//# sourceMappingURL=sentinel-gate.js.map

package/dist/team/sentinel-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentinel-gate.js","sourceRoot":"","sources":["../../src/team/sentinel-gate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AA2BhE,SAAS,sBAAsB,CAAC,MAAuB;IACrD,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,uBAAuB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAC1B,QAAQ,CAAC,EAAE,CAAC,eAAe,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,MAAM,EAAE,CACrF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClE,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,GAA4B;IAClD,MAAM,GAAG,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC;IACvB,MAAM,WAAW,GAAG;QAClB,gBAAgB,EAAE,eAAe,EAAE,eAAe;QAClD,oBAAoB,EAAE,mBAAmB,EAAE,aAAa;KACzD,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;QAChC,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;YACjB,GAAG,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,UAAoC,EAAE;IAEtC,MAAM,EACJ,OAAO,EACP,SAAS,EACT,MAAM,EACN,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,GACvD,GAAG,OAAO,CAAC;IAEZ,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,GAAG,IAAI,CAAC;QAChB,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACvD,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,GAAG,IAAI,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YACzD,QAAQ,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAAC;QACtD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CACX,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACnF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,QAAQ,EAAE,CAAC,qFAAqF,CAAC;YACjG,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,OAAO;QACL,KAAK,EAAE,eAAe,CAAC,MAAM,KAAK,CAAC;QACnC,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,UAA+B,EAAE;IAEjC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;IAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,cAAc,IAAI,GAAG,CAAC,CAAC;IACnE,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO;YACL,GAAG,MAAM;YACT,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YACjC,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IACvC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QAClE,QAAQ,IAAI,CAAC,CAAC;QACd,MAAM,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO;gBACL,GAAG,MAAM;gBACT,QAAQ,EAAE,KAAK;gBACf,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACjC,QAAQ;aACT,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,cAAc,GAAG,8CAA8C,SAAS,IAAI,CAAC;IACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC;QACvD,CAAC,CAAC,MAAM,CAAC,QAAQ;QACjB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAEzC,OAAO;QACL,GAAG,MAAM;QACT,QAAQ;QACR,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QACjC,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/team/shell-path.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Return the user's full interactive-shell PATH, falling back to
+ * process.env.PATH when resolution fails.
+ *
+ * Parses `env` output instead of `echo $PATH` to avoid stdout noise
+ * from interactive dotfiles (conda init, greeting messages).
+ *
+ * Note: On fish shell, the `-ilc` combined flags are not supported
+ * (fish requires `--login --interactive -c`), so resolution falls
+ * back to process.env.PATH. On Windows, SHELL is unset and
+ * resolution also falls back gracefully.
+ */
+export declare function resolveShellPath(): string;
+/**
+ * Return a copy of process.env with the resolved PATH merged in.
+ * Handles Windows where the key may be `Path` instead of `PATH`.
+ */
+export declare function resolvedEnv(extra?: Record<string, string>): NodeJS.ProcessEnv;
+/** @internal For testing only. Resets the cached PATH so the next call re-resolves. */
+export declare function _resetShellPathCache(): void;
+//# sourceMappingURL=shell-path.d.ts.map

package/dist/team/shell-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-path.d.ts","sourceRoot":"","sources":["../../src/team/shell-path.ts"],"names":[],"mappings":"AAeA;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAiCzC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAK7E;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/team/shell-path.js

@@ -0,0 +1,73 @@
+/**
+ * Resolve the user's full shell PATH.
+ *
+ * MCP server processes are spawned by the Claude Code plugin system and may
+ * not inherit the user's interactive-shell PATH. Tools installed via version
+ * managers (mise, asdf, nvm, fnm, volta, etc.) or into /usr/local/bin are
+ * therefore invisible to child_process.spawn/spawnSync.
+ *
+ * This module resolves the real PATH once (lazy, cached) by running a login
+ * shell and reading $PATH from it.
+ */
+import { spawnSync } from 'child_process';
+let _resolved = null;
+/**
+ * Return the user's full interactive-shell PATH, falling back to
+ * process.env.PATH when resolution fails.
+ *
+ * Parses `env` output instead of `echo $PATH` to avoid stdout noise
+ * from interactive dotfiles (conda init, greeting messages).
+ *
+ * Note: On fish shell, the `-ilc` combined flags are not supported
+ * (fish requires `--login --interactive -c`), so resolution falls
+ * back to process.env.PATH. On Windows, SHELL is unset and
+ * resolution also falls back gracefully.
+ */
+export function resolveShellPath() {
+    if (_resolved !== null)
+        return _resolved;
+    // On Windows, SHELL is unset and /bin/sh does not exist.
+    // Skip the spawn attempt to avoid a guaranteed-to-fail 5s timeout.
+    if (process.platform === 'win32') {
+        _resolved = process.env.PATH || '';
+        return _resolved;
+    }
+    try {
+        const shell = process.env.SHELL || '/bin/sh';
+        // Use `env` and parse PATH= line — works across all shells (bash, zsh, fish)
+        // and avoids stdout noise from interactive dotfiles (.bashrc, .zshrc, config.fish).
+        const result = spawnSync(shell, ['-ilc', 'env'], {
+            timeout: 5000,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (result.status === 0) {
+            const stdout = result.stdout?.toString() ?? '';
+            const pathLine = stdout.split('\n').find(l => l.startsWith('PATH='));
+            const path = pathLine?.slice(5)?.trim();
+            if (path) {
+                _resolved = path;
+                return _resolved;
+            }
+        }
+    }
+    catch {
+        // fall through
+    }
+    _resolved = process.env.PATH || '';
+    return _resolved;
+}
+/**
+ * Return a copy of process.env with the resolved PATH merged in.
+ * Handles Windows where the key may be `Path` instead of `PATH`.
+ */
+export function resolvedEnv(extra) {
+    const env = { ...process.env };
+    const pathKey = Object.keys(env).find(k => k.toUpperCase() === 'PATH') || 'PATH';
+    env[pathKey] = resolveShellPath();
+    return { ...env, ...extra };
+}
+/** @internal For testing only. Resets the cached PATH so the next call re-resolves. */
+export function _resetShellPathCache() {
+    _resolved = null;
+}
+//# sourceMappingURL=shell-path.js.map

package/dist/team/shell-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-path.js","sourceRoot":"","sources":["../../src/team/shell-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,IAAI,SAAS,GAAkB,IAAI,CAAC;AAEpC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAEzC,yDAAyD;IACzD,mEAAmE;IACnE,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QACnC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC;QAC7C,6EAA6E;QAC7E,oFAAoF;QACpF,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE;YAC/C,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;YACrE,MAAM,IAAI,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YACxC,IAAI,IAAI,EAAE,CAAC;gBACT,SAAS,GAAG,IAAI,CAAC;gBACjB,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACnC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAA8B;IACxD,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC;IACjF,GAAG,CAAC,OAAO,CAAC,GAAG,gBAAgB,EAAE,CAAC;IAClC,OAAO,EAAE,GAAG,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,oBAAoB;IAClC,SAAS,GAAG,IAAI,CAAC;AACnB,CAAC"}

package/dist/team/state/tasks.d.ts

@@ -0,0 +1,48 @@
+import type { TeamTaskStatus } from '../contracts.js';
+import type { TeamTask, TeamTaskV2, TaskReadiness, ClaimTaskResult, TransitionTaskResult, ReleaseTaskClaimResult, TeamMonitorSnapshotState } from '../types.js';
+interface TaskReadDeps {
+    readTask: (teamName: string, taskId: string, cwd: string) => Promise<TeamTask | null>;
+}
+export declare function computeTaskReadiness(teamName: string, taskId: string, cwd: string, deps: TaskReadDeps): Promise<TaskReadiness>;
+interface ClaimTaskDeps extends TaskReadDeps {
+    teamName: string;
+    cwd: string;
+    readTeamConfig: (teamName: string, cwd: string) => Promise<{
+        workers: Array<{
+            name: string;
+        }>;
+    } | null>;
+    withTaskClaimLock: <T>(teamName: string, taskId: string, cwd: string, fn: () => Promise<T>) => Promise<{
+        ok: true;
+        value: T;
+    } | {
+        ok: false;
+    }>;
+    normalizeTask: (task: TeamTask) => TeamTaskV2;
+    isTerminalTaskStatus: (status: TeamTaskStatus) => boolean;
+    taskFilePath: (teamName: string, taskId: string, cwd: string) => string;
+    writeAtomic: (path: string, data: string) => Promise<void>;
+}
+export declare function claimTask(taskId: string, workerName: string, expectedVersion: number | null, deps: ClaimTaskDeps): Promise<ClaimTaskResult>;
+interface TransitionDeps extends ClaimTaskDeps {
+    canTransitionTaskStatus: (from: TeamTaskStatus, to: TeamTaskStatus) => boolean;
+    appendTeamEvent: (teamName: string, event: {
+        type: 'task_completed' | 'task_failed';
+        worker: string;
+        task_id?: string;
+        message_id?: string | null;
+        reason?: string;
+    }, cwd: string) => Promise<unknown>;
+    readMonitorSnapshot: (teamName: string, cwd: string) => Promise<TeamMonitorSnapshotState | null>;
+    writeMonitorSnapshot: (teamName: string, snapshot: TeamMonitorSnapshotState, cwd: string) => Promise<void>;
+}
+export declare function transitionTaskStatus(taskId: string, from: TeamTaskStatus, to: TeamTaskStatus, claimToken: string, deps: TransitionDeps): Promise<TransitionTaskResult>;
+type ReleaseDeps = ClaimTaskDeps;
+export declare function releaseTaskClaim(taskId: string, claimToken: string, _workerName: string, deps: ReleaseDeps): Promise<ReleaseTaskClaimResult>;
+export declare function listTasks(teamName: string, cwd: string, deps: {
+    teamDir: (teamName: string, cwd: string) => string;
+    isTeamTask: (value: unknown) => value is TeamTask;
+    normalizeTask: (task: TeamTask) => TeamTaskV2;
+}): Promise<TeamTask[]>;
+export {};
+//# sourceMappingURL=tasks.d.ts.map