claudecode-omc 4.3.4

package/dist/team/capabilities.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Capability tagging system for worker fitness scoring.
+ *
+ * Maps worker backends to default capabilities and provides
+ * scoring functions for task-worker matching.
+ */
+import type { WorkerBackend, WorkerCapability } from './types.js';
+import type { UnifiedTeamMember } from './unified-team.js';
+/**
+ * Get default capabilities for a worker backend.
+ */
+export declare function getDefaultCapabilities(backend: WorkerBackend): WorkerCapability[];
+/**
+ * Score a worker's fitness for a task based on capabilities.
+ * Higher score = better fit.
+ *
+ * Scoring:
+ * - Each matching capability = 1.0 point
+ * - 'general' capability = 0.5 points for any requirement (wildcard)
+ * - Score normalized to 0-1 range based on total required capabilities
+ * - Workers with 0 matching capabilities score 0
+ */
+export declare function scoreWorkerFitness(worker: UnifiedTeamMember, requiredCapabilities: WorkerCapability[]): number;
+/**
+ * Find the best available workers for a set of required capabilities.
+ * Returns workers sorted by fitness score (descending).
+ * Only includes workers with score > 0.
+ */
+export declare function rankWorkersForTask(workers: UnifiedTeamMember[], requiredCapabilities: WorkerCapability[]): UnifiedTeamMember[];
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/team/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/team/capabilities.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAS3D;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB,EAAE,CAEjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,oBAAoB,EAAE,gBAAgB,EAAE,GACvC,MAAM,CAeR;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,EAAE,EAC5B,oBAAoB,EAAE,gBAAgB,EAAE,GACvC,iBAAiB,EAAE,CAOrB"}

package/dist/team/capabilities.js

@@ -0,0 +1,51 @@
+// src/team/capabilities.ts
+/** Default capabilities by worker backend */
+const DEFAULT_CAPABILITIES = {
+    'claude-native': ['code-edit', 'testing', 'general'],
+    'mcp-codex': ['code-review', 'security-review', 'architecture', 'refactoring'],
+    'mcp-gemini': ['ui-design', 'documentation', 'research', 'code-edit'],
+};
+/**
+ * Get default capabilities for a worker backend.
+ */
+export function getDefaultCapabilities(backend) {
+    return [...(DEFAULT_CAPABILITIES[backend] || ['general'])];
+}
+/**
+ * Score a worker's fitness for a task based on capabilities.
+ * Higher score = better fit.
+ *
+ * Scoring:
+ * - Each matching capability = 1.0 point
+ * - 'general' capability = 0.5 points for any requirement (wildcard)
+ * - Score normalized to 0-1 range based on total required capabilities
+ * - Workers with 0 matching capabilities score 0
+ */
+export function scoreWorkerFitness(worker, requiredCapabilities) {
+    if (requiredCapabilities.length === 0)
+        return 1.0; // No requirements = everyone fits
+    let score = 0;
+    const workerCaps = new Set(worker.capabilities);
+    for (const req of requiredCapabilities) {
+        if (workerCaps.has(req)) {
+            score += 1.0;
+        }
+        else if (workerCaps.has('general')) {
+            score += 0.5;
+        }
+    }
+    return score / requiredCapabilities.length;
+}
+/**
+ * Find the best available workers for a set of required capabilities.
+ * Returns workers sorted by fitness score (descending).
+ * Only includes workers with score > 0.
+ */
+export function rankWorkersForTask(workers, requiredCapabilities) {
+    const scored = workers
+        .map(w => ({ worker: w, score: scoreWorkerFitness(w, requiredCapabilities) }))
+        .filter(s => s.score > 0)
+        .sort((a, b) => b.score - a.score);
+    return scored.map(s => s.worker);
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/team/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/team/capabilities.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAY3B,6CAA6C;AAC7C,MAAM,oBAAoB,GAA8C;IACtE,eAAe,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC;IACpD,WAAW,EAAE,CAAC,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,CAAC;IAC9E,YAAY,EAAE,CAAC,WAAW,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,CAAC;CACtE,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAsB;IAC3D,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAyB,EACzB,oBAAwC;IAExC,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,CAAC,kCAAkC;IAErF,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAEhD,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,IAAI,GAAG,CAAC;QACf,CAAC;aAAM,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,KAAK,IAAI,GAAG,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA4B,EAC5B,oBAAwC;IAExC,MAAM,MAAM,GAAG,OAAO;SACnB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,oBAAoB,CAAC,EAAE,CAAC,CAAC;SAC7E,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;SACxB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAErC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/dist/team/fs-utils.d.ts

@@ -0,0 +1,14 @@
+/** Atomic write: write JSON to temp file with permissions, then rename (prevents corruption on crash) */
+export declare function atomicWriteJson(filePath: string, data: unknown, mode?: number): void;
+/** Write file with explicit permission mode */
+export declare function writeFileWithMode(filePath: string, data: string, mode?: number): void;
+/** Append to file with explicit permission mode. Creates with mode if file doesn't exist.
+ *  Uses O_WRONLY|O_APPEND|O_CREAT to atomically create-or-append in a single syscall,
+ *  avoiding TOCTOU race between existence check and write. */
+export declare function appendFileWithMode(filePath: string, data: string, mode?: number): void;
+/** Create directory with explicit permission mode */
+export declare function ensureDirWithMode(dirPath: string, mode?: number): void;
+/** Validate that a resolved path is under the expected base directory. Throws if not.
+ *  Uses realpathSync to resolve symlinks, preventing symlink-based escapes. */
+export declare function validateResolvedPath(resolvedPath: string, expectedBase: string): void;
+//# sourceMappingURL=fs-utils.d.ts.map

package/dist/team/fs-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.d.ts","sourceRoot":"","sources":["../../src/team/fs-utils.ts"],"names":[],"mappings":"AAaA,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,MAAc,GAAG,IAAI,CAM3F;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG,IAAI,CAE5F;AAED;;8DAE8D;AAC9D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG,IAAI,CAO7F;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG,IAAI,CAE7E;AAoBD;+EAC+E;AAC/E,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAOrF"}

package/dist/team/fs-utils.js

@@ -0,0 +1,70 @@
+// src/team/fs-utils.ts
+/**
+ * Shared filesystem utilities with permission hardening.
+ *
+ * All file writes default to 0o600 (owner-only read/write).
+ * All directory creates default to 0o700 (owner-only access).
+ * Atomic writes use PID+timestamp temp files to prevent collisions.
+ */
+import { writeFileSync, existsSync, mkdirSync, renameSync, openSync, writeSync, closeSync, realpathSync, constants } from 'fs';
+import { dirname, resolve, relative, basename } from 'path';
+/** Atomic write: write JSON to temp file with permissions, then rename (prevents corruption on crash) */
+export function atomicWriteJson(filePath, data, mode = 0o600) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const tmpPath = `${filePath}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmpPath, JSON.stringify(data, null, 2) + '\n', { encoding: 'utf-8', mode });
+    renameSync(tmpPath, filePath);
+}
+/** Write file with explicit permission mode */
+export function writeFileWithMode(filePath, data, mode = 0o600) {
+    writeFileSync(filePath, data, { encoding: 'utf-8', mode });
+}
+/** Append to file with explicit permission mode. Creates with mode if file doesn't exist.
+ *  Uses O_WRONLY|O_APPEND|O_CREAT to atomically create-or-append in a single syscall,
+ *  avoiding TOCTOU race between existence check and write. */
+export function appendFileWithMode(filePath, data, mode = 0o600) {
+    const fd = openSync(filePath, constants.O_WRONLY | constants.O_APPEND | constants.O_CREAT, mode);
+    try {
+        writeSync(fd, data, null, 'utf-8');
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** Create directory with explicit permission mode */
+export function ensureDirWithMode(dirPath, mode = 0o700) {
+    if (!existsSync(dirPath))
+        mkdirSync(dirPath, { recursive: true, mode });
+}
+/** Resolve a path through symlinks where possible, falling back to resolve for non-existent paths.
+ *  For paths that don't exist yet, resolves the parent via realpath and appends the filename. */
+function safeRealpath(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        // Path doesn't exist yet — resolve the parent directory and append the filename
+        const parent = dirname(p);
+        const name = basename(p);
+        try {
+            return resolve(realpathSync(parent), name);
+        }
+        catch {
+            // Parent also doesn't exist, fall back to plain resolve
+            return resolve(p);
+        }
+    }
+}
+/** Validate that a resolved path is under the expected base directory. Throws if not.
+ *  Uses realpathSync to resolve symlinks, preventing symlink-based escapes. */
+export function validateResolvedPath(resolvedPath, expectedBase) {
+    const absResolved = safeRealpath(resolvedPath);
+    const absBase = safeRealpath(expectedBase);
+    const rel = relative(absBase, absResolved);
+    if (rel.startsWith('..') || resolve(absBase, rel) !== absResolved) {
+        throw new Error(`Path traversal detected: "${resolvedPath}" escapes base "${expectedBase}"`);
+    }
+}
+//# sourceMappingURL=fs-utils.js.map

package/dist/team/fs-utils.js.map

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

package/dist/team/git-worktree.d.ts

@@ -0,0 +1,26 @@
+export interface WorktreeInfo {
+    path: string;
+    branch: string;
+    workerName: string;
+    teamName: string;
+    createdAt: string;
+}
+/**
+ * Create a git worktree for a team worker.
+ * Path: {repoRoot}/.omc/worktrees/{team}/{worker}
+ * Branch: omc-team/{teamName}/{workerName}
+ */
+export declare function createWorkerWorktree(teamName: string, workerName: string, repoRoot: string, baseBranch?: string): WorktreeInfo;
+/**
+ * Remove a worker's worktree and branch.
+ */
+export declare function removeWorkerWorktree(teamName: string, workerName: string, repoRoot: string): void;
+/**
+ * List all worktrees for a team.
+ */
+export declare function listTeamWorktrees(teamName: string, repoRoot: string): WorktreeInfo[];
+/**
+ * Remove all worktrees for a team (cleanup on shutdown).
+ */
+export declare function cleanupTeamWorktrees(teamName: string, repoRoot: string): void;
+//# sourceMappingURL=git-worktree.d.ts.map

package/dist/team/git-worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-worktree.d.ts","sourceRoot":"","sources":["../../src/team/git-worktree.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAqCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,YAAY,CA+Cd;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,IAAI,CAuBN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,YAAY,EAAE,CAEhB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,IAAI,CAON"}

package/dist/team/git-worktree.js

@@ -0,0 +1,138 @@
+// src/team/git-worktree.ts
+/**
+ * Git worktree manager for team worker isolation.
+ *
+ * Each MCP worker gets its own git worktree at:
+ *   {repoRoot}/.omc/worktrees/{team}/{worker}
+ * Branch naming: omc-team/{teamName}/{workerName}
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { atomicWriteJson, ensureDirWithMode, validateResolvedPath } from './fs-utils.js';
+import { sanitizeName } from './tmux-session.js';
+/** Get worktree path for a worker */
+function getWorktreePath(repoRoot, teamName, workerName) {
+    return join(repoRoot, '.omc', 'worktrees', sanitizeName(teamName), sanitizeName(workerName));
+}
+/** Get branch name for a worker */
+function getBranchName(teamName, workerName) {
+    return `omc-team/${sanitizeName(teamName)}/${sanitizeName(workerName)}`;
+}
+/** Get worktree metadata path */
+function getMetadataPath(repoRoot, teamName) {
+    return join(repoRoot, '.omc', 'state', 'team-bridge', sanitizeName(teamName), 'worktrees.json');
+}
+/** Read worktree metadata */
+function readMetadata(repoRoot, teamName) {
+    const metaPath = getMetadataPath(repoRoot, teamName);
+    if (!existsSync(metaPath))
+        return [];
+    try {
+        return JSON.parse(readFileSync(metaPath, 'utf-8'));
+    }
+    catch {
+        return [];
+    }
+}
+/** Write worktree metadata */
+function writeMetadata(repoRoot, teamName, entries) {
+    const metaPath = getMetadataPath(repoRoot, teamName);
+    validateResolvedPath(metaPath, repoRoot);
+    const dir = join(repoRoot, '.omc', 'state', 'team-bridge', sanitizeName(teamName));
+    ensureDirWithMode(dir);
+    atomicWriteJson(metaPath, entries);
+}
+/**
+ * Create a git worktree for a team worker.
+ * Path: {repoRoot}/.omc/worktrees/{team}/{worker}
+ * Branch: omc-team/{teamName}/{workerName}
+ */
+export function createWorkerWorktree(teamName, workerName, repoRoot, baseBranch) {
+    const wtPath = getWorktreePath(repoRoot, teamName, workerName);
+    const branch = getBranchName(teamName, workerName);
+    validateResolvedPath(wtPath, repoRoot);
+    // Prune stale worktrees first
+    try {
+        execFileSync('git', ['worktree', 'prune'], { cwd: repoRoot, stdio: 'pipe' });
+    }
+    catch { /* ignore */ }
+    // Remove stale worktree if it exists
+    if (existsSync(wtPath)) {
+        try {
+            execFileSync('git', ['worktree', 'remove', '--force', wtPath], { cwd: repoRoot, stdio: 'pipe' });
+        }
+        catch { /* ignore */ }
+    }
+    // Delete stale branch if it exists
+    try {
+        execFileSync('git', ['branch', '-D', branch], { cwd: repoRoot, stdio: 'pipe' });
+    }
+    catch { /* branch doesn't exist, fine */ }
+    // Create worktree directory
+    const wtDir = join(repoRoot, '.omc', 'worktrees', sanitizeName(teamName));
+    ensureDirWithMode(wtDir);
+    // Create worktree with new branch
+    const args = ['worktree', 'add', '-b', branch, wtPath];
+    if (baseBranch)
+        args.push(baseBranch);
+    execFileSync('git', args, { cwd: repoRoot, stdio: 'pipe' });
+    const info = {
+        path: wtPath,
+        branch,
+        workerName,
+        teamName,
+        createdAt: new Date().toISOString(),
+    };
+    // Update metadata
+    const existing = readMetadata(repoRoot, teamName);
+    const updated = existing.filter(e => e.workerName !== workerName);
+    updated.push(info);
+    writeMetadata(repoRoot, teamName, updated);
+    return info;
+}
+/**
+ * Remove a worker's worktree and branch.
+ */
+export function removeWorkerWorktree(teamName, workerName, repoRoot) {
+    const wtPath = getWorktreePath(repoRoot, teamName, workerName);
+    const branch = getBranchName(teamName, workerName);
+    // Remove worktree
+    try {
+        execFileSync('git', ['worktree', 'remove', '--force', wtPath], { cwd: repoRoot, stdio: 'pipe' });
+    }
+    catch { /* may not exist */ }
+    // Prune to clean up
+    try {
+        execFileSync('git', ['worktree', 'prune'], { cwd: repoRoot, stdio: 'pipe' });
+    }
+    catch { /* ignore */ }
+    // Delete branch
+    try {
+        execFileSync('git', ['branch', '-D', branch], { cwd: repoRoot, stdio: 'pipe' });
+    }
+    catch { /* branch may not exist */ }
+    // Update metadata
+    const existing = readMetadata(repoRoot, teamName);
+    const updated = existing.filter(e => e.workerName !== workerName);
+    writeMetadata(repoRoot, teamName, updated);
+}
+/**
+ * List all worktrees for a team.
+ */
+export function listTeamWorktrees(teamName, repoRoot) {
+    return readMetadata(repoRoot, teamName);
+}
+/**
+ * Remove all worktrees for a team (cleanup on shutdown).
+ */
+export function cleanupTeamWorktrees(teamName, repoRoot) {
+    const entries = readMetadata(repoRoot, teamName);
+    for (const entry of entries) {
+        try {
+            removeWorkerWorktree(teamName, entry.workerName, repoRoot);
+        }
+        catch { /* best effort */ }
+    }
+}
+//# sourceMappingURL=git-worktree.js.map

package/dist/team/git-worktree.js.map

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

package/dist/team/heartbeat.d.ts

@@ -0,0 +1,18 @@
+import type { HeartbeatData } from './types.js';
+/** Write/update heartbeat. Called every poll cycle by the bridge. */
+export declare function writeHeartbeat(workingDirectory: string, data: HeartbeatData): void;
+/** Read heartbeat for a specific worker. Returns null if not found. */
+export declare function readHeartbeat(workingDirectory: string, teamName: string, workerName: string): HeartbeatData | null;
+/** List all heartbeat files for a team. Used by lead to check worker health. */
+export declare function listHeartbeats(workingDirectory: string, teamName: string): HeartbeatData[];
+/**
+ * Check if a worker is alive based on heartbeat freshness.
+ * A worker is considered dead if lastPollAt is older than maxAgeMs.
+ * Invalid dates are treated as dead.
+ */
+export declare function isWorkerAlive(workingDirectory: string, teamName: string, workerName: string, maxAgeMs: number): boolean;
+/** Delete heartbeat file (called during cleanup) */
+export declare function deleteHeartbeat(workingDirectory: string, teamName: string, workerName: string): void;
+/** Delete all heartbeat files for a team */
+export declare function cleanupTeamHeartbeats(workingDirectory: string, teamName: string): void;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/team/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../src/team/heartbeat.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAchD,qEAAqE;AACrE,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,aAAa,GAClB,IAAI,CAGN;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAC3B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,aAAa,GAAG,IAAI,CAStB;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,GACf,aAAa,EAAE,CAiBjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAWT;AAED,oDAAoD;AACpD,wBAAgB,eAAe,CAC7B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,IAAI,CAKN;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,GACf,IAAI,CAcN"}

package/dist/team/heartbeat.js

@@ -0,0 +1,110 @@
+// src/team/heartbeat.ts
+/**
+ * Heartbeat Management for MCP Team Bridge Workers
+ *
+ * Each worker writes a heartbeat file every poll cycle.
+ * The lead checks freshness to detect dead workers.
+ * Files stored at: .omc/state/team-bridge/{team}/{worker}.heartbeat.json
+ */
+import { readFileSync, existsSync, readdirSync, unlinkSync, rmdirSync } from 'fs';
+import { join } from 'path';
+import { sanitizeName } from './tmux-session.js';
+import { atomicWriteJson } from './fs-utils.js';
+/** Heartbeat file path */
+function heartbeatPath(workingDirectory, teamName, workerName) {
+    return join(workingDirectory, '.omc', 'state', 'team-bridge', sanitizeName(teamName), `${sanitizeName(workerName)}.heartbeat.json`);
+}
+/** Heartbeat directory for a team */
+function heartbeatDir(workingDirectory, teamName) {
+    return join(workingDirectory, '.omc', 'state', 'team-bridge', sanitizeName(teamName));
+}
+/** Write/update heartbeat. Called every poll cycle by the bridge. */
+export function writeHeartbeat(workingDirectory, data) {
+    const filePath = heartbeatPath(workingDirectory, data.teamName, data.workerName);
+    atomicWriteJson(filePath, data);
+}
+/** Read heartbeat for a specific worker. Returns null if not found. */
+export function readHeartbeat(workingDirectory, teamName, workerName) {
+    const filePath = heartbeatPath(workingDirectory, teamName, workerName);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        const raw = readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** List all heartbeat files for a team. Used by lead to check worker health. */
+export function listHeartbeats(workingDirectory, teamName) {
+    const dir = heartbeatDir(workingDirectory, teamName);
+    if (!existsSync(dir))
+        return [];
+    try {
+        const files = readdirSync(dir).filter(f => f.endsWith('.heartbeat.json'));
+        const heartbeats = [];
+        for (const file of files) {
+            try {
+                const raw = readFileSync(join(dir, file), 'utf-8');
+                heartbeats.push(JSON.parse(raw));
+            }
+            catch { /* skip malformed */ }
+        }
+        return heartbeats;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Check if a worker is alive based on heartbeat freshness.
+ * A worker is considered dead if lastPollAt is older than maxAgeMs.
+ * Invalid dates are treated as dead.
+ */
+export function isWorkerAlive(workingDirectory, teamName, workerName, maxAgeMs) {
+    const heartbeat = readHeartbeat(workingDirectory, teamName, workerName);
+    if (!heartbeat)
+        return false;
+    try {
+        const lastPoll = new Date(heartbeat.lastPollAt).getTime();
+        if (isNaN(lastPoll))
+            return false; // Invalid date = dead
+        return (Date.now() - lastPoll) < maxAgeMs;
+    }
+    catch {
+        return false;
+    }
+}
+/** Delete heartbeat file (called during cleanup) */
+export function deleteHeartbeat(workingDirectory, teamName, workerName) {
+    const filePath = heartbeatPath(workingDirectory, teamName, workerName);
+    if (existsSync(filePath)) {
+        try {
+            unlinkSync(filePath);
+        }
+        catch { /* ignore */ }
+    }
+}
+/** Delete all heartbeat files for a team */
+export function cleanupTeamHeartbeats(workingDirectory, teamName) {
+    const dir = heartbeatDir(workingDirectory, teamName);
+    if (!existsSync(dir))
+        return;
+    try {
+        const files = readdirSync(dir);
+        for (const file of files) {
+            try {
+                unlinkSync(join(dir, file));
+            }
+            catch { /* ignore */ }
+        }
+        // Try to remove the directory itself
+        try {
+            rmdirSync(dir);
+        }
+        catch { /* ignore - may not be empty */ }
+    }
+    catch { /* ignore */ }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/team/heartbeat.js.map

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

package/dist/team/inbox-outbox.d.ts

@@ -0,0 +1,58 @@
+import type { InboxMessage, OutboxMessage, ShutdownSignal, DrainSignal } from './types.js';
+/**
+ * Append a message to the outbox JSONL file.
+ * Creates directories if needed.
+ */
+export declare function appendOutbox(teamName: string, workerName: string, message: OutboxMessage): void;
+/**
+ * Rotate outbox if it exceeds maxLines.
+ * Keeps the most recent maxLines/2 entries, discards older.
+ * Prevents unbounded growth.
+ *
+ * NOTE: Rotation events are not audit-logged here to avoid circular dependency
+ * on audit-log.ts. The caller (e.g., mcp-team-bridge.ts) should log rotation
+ * events using the 'outbox_rotated' audit event type after calling this function.
+ */
+export declare function rotateOutboxIfNeeded(teamName: string, workerName: string, maxLines: number): void;
+/**
+ * Rotate inbox if it exceeds maxSizeBytes.
+ * Keeps the most recent half of lines, discards older.
+ * Prevents unbounded growth of inbox files.
+ *
+ * NOTE: Rotation events are not audit-logged here to avoid circular dependency
+ * on audit-log.ts. The caller (e.g., mcp-team-bridge.ts) should log rotation
+ * events using the 'inbox_rotated' audit event type after calling this function.
+ */
+export declare function rotateInboxIfNeeded(teamName: string, workerName: string, maxSizeBytes: number): void;
+/**
+ * Read new inbox messages using offset cursor.
+ *
+ * Uses byte-offset cursor to avoid clock skew issues:
+ * 1. Read cursor from {worker}.offset file (default: 0)
+ * 2. Open inbox JSONL, seek to offset
+ * 3. Read from offset to EOF
+ * 4. Parse new JSONL lines
+ * 5. Update cursor to new file position
+ *
+ * Handles file truncation (cursor > file size) by resetting cursor.
+ */
+export declare function readNewInboxMessages(teamName: string, workerName: string): InboxMessage[];
+/** Read ALL inbox messages (for initial load or debugging) */
+export declare function readAllInboxMessages(teamName: string, workerName: string): InboxMessage[];
+/** Clear inbox (truncate file + reset cursor) */
+export declare function clearInbox(teamName: string, workerName: string): void;
+/** Write a shutdown signal file */
+export declare function writeShutdownSignal(teamName: string, workerName: string, requestId: string, reason: string): void;
+/** Check if shutdown signal exists, return parsed content or null */
+export declare function checkShutdownSignal(teamName: string, workerName: string): ShutdownSignal | null;
+/** Delete the shutdown signal file after processing */
+export declare function deleteShutdownSignal(teamName: string, workerName: string): void;
+/** Write a drain signal for a worker */
+export declare function writeDrainSignal(teamName: string, workerName: string, requestId: string, reason: string): void;
+/** Check if a drain signal exists for a worker */
+export declare function checkDrainSignal(teamName: string, workerName: string): DrainSignal | null;
+/** Delete a drain signal file */
+export declare function deleteDrainSignal(teamName: string, workerName: string): void;
+/** Remove all inbox/outbox/signal files for a worker */
+export declare function cleanupWorkerFiles(teamName: string, workerName: string): void;
+//# sourceMappingURL=inbox-outbox.d.ts.map

package/dist/team/inbox-outbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-outbox.d.ts","sourceRoot":"","sources":["../../src/team/inbox-outbox.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAe,MAAM,YAAY,CAAC;AA2CxG;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAI/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAkBjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAwBpG;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAsFzF;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAiBzF;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAUrE;AAID,mCAAmC;AACnC,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CASjH;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAS/F;AAED,uDAAuD;AACvD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAK/E;AAID,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAS9G;AAED,kDAAkD;AAClD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CASzF;AAED,iCAAiC;AACjC,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAK5E;AAID,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAa7E"}