@bradygaster/squad-cli 0.9.1 → 0.9.2-insider.6

package/dist/cli/commands/watch/capabilities/execute.js

@@ -0,0 +1,156 @@
+/**
+ * Execute capability — spawns Copilot sessions for eligible issues.
+ */
+import { execFile } from 'node:child_process';
+import path from 'node:path';
+import { RatePool } from './rate-pool.js';
+/** Labels that block autonomous execution. */
+const BLOCKED_LABELS = new Set([
+    'status:blocked',
+    'status:waiting-external',
+    'status:postponed',
+    'status:scheduled',
+    'status:needs-action',
+    'status:needs-decision',
+    'status:needs-review',
+    'pending-user',
+    'do-not-merge',
+]);
+/** Build agent command for a prompt. */
+function buildAgentCommand(prompt, context) {
+    if (context.agentCmd) {
+        const parts = context.agentCmd.trim().split(/\s+/);
+        const cmd = parts[0];
+        const args = [...parts.slice(1), '--message', prompt];
+        return { cmd, args };
+    }
+    const args = ['copilot', '--message', prompt];
+    if (context.copilotFlags) {
+        args.push(...context.copilotFlags.trim().split(/\s+/));
+    }
+    return { cmd: 'gh', args };
+}
+/** Find issues eligible for autonomous execution. */
+export function findExecutableIssues(roster, capabilities, issues) {
+    const memberLabels = new Set(roster.map(m => m.label));
+    return issues.filter(issue => {
+        const labels = issue.labels.map(l => l.name);
+        if (!labels.some(l => memberLabels.has(l)))
+            return false;
+        if (issue.assignees && issue.assignees.length > 0)
+            return false;
+        if (labels.some(l => BLOCKED_LABELS.has(l)))
+            return false;
+        return true;
+    });
+}
+/** Spawn agent for a single issue. */
+async function executeOne(issue, context, timeoutMs) {
+    // Claim the issue
+    try {
+        await context.adapter.addTag(issue.number, 'status:in-progress');
+    }
+    catch { /* best-effort */ }
+    try {
+        await context.adapter.addComment(issue.number, '🤖 Ralph: starting autonomous work on this issue.');
+    }
+    catch { /* best-effort */ }
+    const prompt = `Work on issue #${issue.number}: ${issue.title}. Read the issue body for full details.`;
+    const { cmd, args } = buildAgentCommand(prompt, context);
+    return new Promise((resolve) => {
+        const _cp = execFile(cmd, args, { cwd: context.teamRoot, timeout: timeoutMs, maxBuffer: 50 * 1024 * 1024 }, (err) => {
+            if (err) {
+                const execErr = err;
+                const msg = execErr.killed ? `Timed out` : execErr.message;
+                resolve({ success: false, error: msg });
+            }
+            else {
+                resolve({ success: true });
+            }
+        });
+    });
+}
+export class ExecuteCapability {
+    name = 'execute';
+    description = 'Spawn Copilot sessions to work on eligible issues';
+    configShape = 'boolean';
+    requires = ['gh'];
+    phase = 'post-execute';
+    async preflight(_context) {
+        return new Promise((resolve) => {
+            execFile('gh', ['--version'], (err) => {
+                resolve(err ? { ok: false, reason: 'gh CLI not found' } : { ok: true });
+            });
+        });
+    }
+    async execute(context) {
+        try {
+            const maxConcurrent = context.config['maxConcurrent'] ?? 1;
+            const timeout = (context.config['timeout'] ?? 30) * 60_000;
+            // Fetch open issues with squad label
+            const sdkItems = await context.adapter.listWorkItems({ tags: ['squad'], state: 'open', limit: 50 });
+            const issues = sdkItems.map(wi => ({
+                number: wi.id,
+                title: wi.title,
+                labels: wi.tags.map(t => ({ name: t })),
+                assignees: wi.assignedTo ? [{ login: wi.assignedTo }] : [],
+            }));
+            // Filter by capabilities
+            const { filterByCapabilities, loadCapabilities } = await import('@bradygaster/squad-sdk/ralph/capabilities');
+            const capabilities = await loadCapabilities(context.teamRoot);
+            const { handled } = filterByCapabilities(issues, capabilities);
+            const executable = findExecutableIssues(context.roster, capabilities, handled);
+            const batch = executable.slice(0, maxConcurrent);
+            if (batch.length === 0) {
+                return { success: true, summary: 'no executable issues' };
+            }
+            // Rate pool gate — respect shared API budget across instances
+            const poolCfg = context.config['ratePool'];
+            const squadDir = path.join(context.teamRoot, '.squad');
+            const ratePool = new RatePool(squadDir, {
+                maxCallsPerInterval: poolCfg?.['maxCallsPerInterval'] ?? undefined,
+                intervalSeconds: poolCfg?.['intervalSeconds'] ?? undefined,
+                poolFile: poolCfg?.['poolFile'] ?? undefined,
+            });
+            const admitted = [];
+            const skipped = [];
+            for (const issue of batch) {
+                if (ratePool.acquireSlot()) {
+                    admitted.push(issue);
+                }
+                else {
+                    skipped.push(issue.number);
+                }
+            }
+            if (admitted.length === 0) {
+                const status = ratePool.getPoolStatus();
+                return {
+                    success: true,
+                    summary: `rate pool exhausted (${status.slotsUsed}/${status.maxSlots}), ${skipped.length} skipped`,
+                };
+            }
+            if (skipped.length > 0) {
+                console.log(`[rate-pool] skipped issues due to budget: ${skipped.join(', ')}`);
+            }
+            const results = await Promise.all(admitted.map(async (issue) => {
+                try {
+                    return await executeOne(issue, context, timeout);
+                }
+                finally {
+                    ratePool.releaseSlot();
+                }
+            }));
+            const succeeded = results.filter(r => r.success).length;
+            const failed = results.length - succeeded;
+            return {
+                success: true,
+                summary: `${succeeded} executed, ${failed} failed`,
+                data: { executed: succeeded, failed },
+            };
+        }
+        catch (e) {
+            return { success: false, summary: `execute error: ${e.message}` };
+        }
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/cli/commands/watch/capabilities/execute.js.map

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

package/dist/cli/commands/watch/capabilities/health-check.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Health-check capability — pre-round watchdog.
+ *
+ * Ported from ralph-watch.ps1 `Invoke-RalphHealthCheck`.
+ * Runs in the `pre-scan` phase and verifies:
+ *   1. gh CLI authenticated
+ *   2. Circuit breaker state file is valid
+ *   3. Disk space above threshold (configurable, default 500 MB)
+ *   4. Git branch matches expected (optional)
+ *
+ * Config (via squad.config.ts → watch.capabilities["health-check"]):
+ *   diskThresholdMB   – minimum free disk in MB (default: 500)
+ *   expectedBranch    – warn if not on this branch (optional)
+ */
+import type { WatchCapability, WatchContext, PreflightResult, CapabilityResult } from '../types.js';
+export interface HealthCheckResult {
+    healed: string[];
+    warnings: string[];
+}
+export declare class HealthCheckCapability implements WatchCapability {
+    readonly name = "health-check";
+    readonly description = "Pre-round watchdog: verify auth, disk space, branch, CB state";
+    readonly configShape: "object";
+    readonly requires: string[];
+    readonly phase: "pre-scan";
+    preflight(_context: WatchContext): Promise<PreflightResult>;
+    execute(context: WatchContext): Promise<CapabilityResult>;
+}
+//# sourceMappingURL=health-check.d.ts.map

package/dist/cli/commands/watch/capabilities/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/health-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpG,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qBAAa,qBAAsB,YAAW,eAAe;IAC3D,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,mEAAmE;IACvF,QAAQ,CAAC,WAAW,EAAG,QAAQ,CAAU;IACzC,QAAQ,CAAC,QAAQ,WAAU;IAC3B,QAAQ,CAAC,KAAK,EAAG,UAAU,CAAU;IAE/B,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAI3D,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA0EhE"}

package/dist/cli/commands/watch/capabilities/health-check.js

@@ -0,0 +1,139 @@
+/**
+ * Health-check capability — pre-round watchdog.
+ *
+ * Ported from ralph-watch.ps1 `Invoke-RalphHealthCheck`.
+ * Runs in the `pre-scan` phase and verifies:
+ *   1. gh CLI authenticated
+ *   2. Circuit breaker state file is valid
+ *   3. Disk space above threshold (configurable, default 500 MB)
+ *   4. Git branch matches expected (optional)
+ *
+ * Config (via squad.config.ts → watch.capabilities["health-check"]):
+ *   diskThresholdMB   – minimum free disk in MB (default: 500)
+ *   expectedBranch    – warn if not on this branch (optional)
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import path from 'node:path';
+import fs from 'node:fs';
+const execFileAsync = promisify(execFile);
+export class HealthCheckCapability {
+    name = 'health-check';
+    description = 'Pre-round watchdog: verify auth, disk space, branch, CB state';
+    configShape = 'object';
+    requires = ['gh'];
+    phase = 'pre-scan';
+    async preflight(_context) {
+        return { ok: true };
+    }
+    async execute(context) {
+        const healed = [];
+        const warnings = [];
+        const config = context.config;
+        const diskThresholdMB = config['diskThresholdMB'] ?? 500;
+        const expectedBranch = config['expectedBranch'];
+        // 1. Verify gh auth
+        try {
+            await execFileAsync('gh', ['auth', 'status'], { timeout: 10_000 });
+        }
+        catch {
+            // Try extracting auth info from git remote (P3 auth fallback)
+            const patFromRemote = await extractPatFromRemote(context.teamRoot);
+            if (patFromRemote) {
+                healed.push('Detected PAT in git remote URL — gh auth may need refresh');
+            }
+            else {
+                warnings.push('gh auth: not authenticated — run "gh auth login"');
+            }
+        }
+        // 2. Validate circuit breaker state file
+        const cbPath = path.join(context.teamRoot, '.squad', 'ralph-circuit-breaker.json');
+        try {
+            if (fs.existsSync(cbPath)) {
+                const rawContent = fs.readFileSync(cbPath, 'utf-8');
+                const parsed = JSON.parse(rawContent);
+                // Check for nested schema (legacy)
+                if (!parsed.preferredModel && parsed.model_fallback) {
+                    healed.push('CB schema: would convert nested→flat on next use');
+                }
+                // Check for empty model
+                if (parsed.currentModel === '' || parsed.currentModel === null) {
+                    warnings.push('CB state has empty currentModel — circuit-breaker will auto-reset');
+                }
+            }
+        }
+        catch {
+            // No CB file is fine — will be created on demand
+        }
+        // 3. Disk space check
+        try {
+            const freeBytes = await getFreeDiskSpace(context.teamRoot);
+            const freeMB = Math.floor(freeBytes / (1024 * 1024));
+            if (freeMB < diskThresholdMB) {
+                warnings.push(`Low disk space: ${freeMB} MB free (threshold: ${diskThresholdMB} MB)`);
+            }
+        }
+        catch {
+            // Disk check failed — non-blocking
+        }
+        // 4. Branch drift check
+        if (expectedBranch) {
+            try {
+                const { stdout } = await execFileAsync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {
+                    cwd: context.teamRoot,
+                    timeout: 5_000,
+                });
+                const current = stdout.trim();
+                if (current && current !== expectedBranch) {
+                    warnings.push(`Branch drift: on "${current}" (expected "${expectedBranch}")`);
+                }
+            }
+            catch { /* not a git repo or other error */ }
+        }
+        const summary = healed.length > 0 || warnings.length > 0
+            ? `healed: ${healed.length}, warnings: ${warnings.length}`
+            : 'all checks passed';
+        return {
+            success: warnings.length === 0,
+            summary,
+            data: { healed, warnings },
+        };
+    }
+}
+/** Try extracting a PAT from git remote URL (https://<pat>@github.com/...) */
+async function extractPatFromRemote(cwd) {
+    try {
+        const { stdout } = await execFileAsync('git', ['config', '--get', 'remote.origin.url'], {
+            cwd,
+            timeout: 5_000,
+        });
+        const url = stdout.trim();
+        // Pattern: https://<token>@github.com/...
+        const match = url.match(/https:\/\/([^@]+)@github\.com/);
+        if (match && match[1] && match[1] !== 'oauth2') {
+            return match[1];
+        }
+    }
+    catch { /* not available */ }
+    return null;
+}
+/** Get free disk space in bytes for the drive containing the given path. */
+async function getFreeDiskSpace(dirPath) {
+    const platform = process.platform;
+    if (platform === 'win32') {
+        const drive = path.parse(path.resolve(dirPath)).root;
+        const { stdout } = await execFileAsync('wmic', [
+            'logicaldisk', 'where', `DeviceID='${drive.replace('\\', '')}'`,
+            'get', 'FreeSpace', '/value',
+        ], { timeout: 5_000 });
+        const match = stdout.match(/FreeSpace=(\d+)/);
+        return match ? parseInt(match[1], 10) : Infinity;
+    }
+    // Unix: use df
+    const { stdout } = await execFileAsync('df', ['--output=avail', '-B1', dirPath], {
+        timeout: 5_000,
+    });
+    const lines = stdout.trim().split('\n');
+    return parseInt(lines[lines.length - 1].trim(), 10) || Infinity;
+}
+//# sourceMappingURL=health-check.js.map

package/dist/cli/commands/watch/capabilities/health-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.js","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/health-check.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/watch/capabilities/heartbeat.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Heartbeat capability — write status JSON every round.
+ *
+ * Ported from ralph-watch.ps1 `Update-Heartbeat`.
+ * Writes to `.squad/ralph-heartbeat.json` every round with:
+ *   - round number, status, PID, timestamp
+ *   - consecutive failures counter
+ *   - duration of last round
+ *
+ * Also maintains a structured log at `.squad/ralph-watch.log` with rotation.
+ *
+ * Runs in the `housekeeping` phase.
+ *
+ * Config (via squad.config.ts → watch.capabilities["heartbeat"]):
+ *   heartbeatPath  – override heartbeat file location (default: .squad/ralph-heartbeat.json)
+ *   logPath        – override log file location (default: .squad/ralph-watch.log)
+ *   maxLogEntries  – max log lines before rotation (default: 500)
+ *   maxLogBytes    – max log file size before rotation (default: 1MB)
+ */
+import type { WatchCapability, WatchContext, PreflightResult, CapabilityResult } from '../types.js';
+export interface HeartbeatData {
+    lastRun: string;
+    lastHeartbeat: string;
+    round: number;
+    status: string;
+    exitCode: number;
+    durationSeconds: number;
+    consecutiveFailures: number;
+    pid: number;
+}
+export declare class HeartbeatCapability implements WatchCapability {
+    readonly name = "heartbeat";
+    readonly description = "Write heartbeat JSON and structured log every round";
+    readonly configShape: "object";
+    readonly requires: never[];
+    readonly phase: "housekeeping";
+    preflight(_context: WatchContext): Promise<PreflightResult>;
+    execute(context: WatchContext): Promise<CapabilityResult>;
+}
+/** Increment consecutive failure counter (called by the main loop on error). */
+export declare function recordFailure(): void;
+/** Reset consecutive failure counter (called by the main loop on success). */
+export declare function recordSuccess(): void;
+/** Get current consecutive failure count. */
+export declare function getConsecutiveFailures(): number;
+/** Mark round start time for duration tracking. */
+export declare function markRoundStart(): void;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/cli/commands/watch/capabilities/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/heartbeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpG,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;CACb;AAMD,qBAAa,mBAAoB,YAAW,eAAe;IACzD,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,yDAAyD;IAC7E,QAAQ,CAAC,WAAW,EAAG,QAAQ,CAAU;IACzC,QAAQ,CAAC,QAAQ,UAAM;IACvB,QAAQ,CAAC,KAAK,EAAG,cAAc,CAAU;IAEnC,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAI3D,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA2ChE;AAED,gFAAgF;AAChF,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,6CAA6C;AAC7C,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,mDAAmD;AACnD,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/cli/commands/watch/capabilities/heartbeat.js

@@ -0,0 +1,115 @@
+/**
+ * Heartbeat capability — write status JSON every round.
+ *
+ * Ported from ralph-watch.ps1 `Update-Heartbeat`.
+ * Writes to `.squad/ralph-heartbeat.json` every round with:
+ *   - round number, status, PID, timestamp
+ *   - consecutive failures counter
+ *   - duration of last round
+ *
+ * Also maintains a structured log at `.squad/ralph-watch.log` with rotation.
+ *
+ * Runs in the `housekeeping` phase.
+ *
+ * Config (via squad.config.ts → watch.capabilities["heartbeat"]):
+ *   heartbeatPath  – override heartbeat file location (default: .squad/ralph-heartbeat.json)
+ *   logPath        – override log file location (default: .squad/ralph-watch.log)
+ *   maxLogEntries  – max log lines before rotation (default: 500)
+ *   maxLogBytes    – max log file size before rotation (default: 1MB)
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+// Module-level state tracked across rounds
+let consecutiveFailures = 0;
+let lastRoundStart = Date.now();
+export class HeartbeatCapability {
+    name = 'heartbeat';
+    description = 'Write heartbeat JSON and structured log every round';
+    configShape = 'object';
+    requires = [];
+    phase = 'housekeeping';
+    async preflight(_context) {
+        return { ok: true };
+    }
+    async execute(context) {
+        const config = context.config;
+        const squadDir = path.join(context.teamRoot, '.squad');
+        const heartbeatPath = config['heartbeatPath'] ?? path.join(squadDir, 'ralph-heartbeat.json');
+        const logPath = config['logPath'] ?? path.join(squadDir, 'ralph-watch.log');
+        const maxLogEntries = config['maxLogEntries'] ?? 500;
+        const maxLogBytes = config['maxLogBytes'] ?? 1_048_576; // 1 MB
+        const now = new Date();
+        const durationSeconds = Math.round((Date.now() - lastRoundStart) / 1000 * 100) / 100;
+        lastRoundStart = Date.now();
+        // Write heartbeat
+        const heartbeat = {
+            lastRun: now.toISOString(),
+            lastHeartbeat: now.toISOString(),
+            round: context.round,
+            status: 'idle',
+            exitCode: 0,
+            durationSeconds,
+            consecutiveFailures,
+            pid: process.pid,
+        };
+        try {
+            ensureDir(path.dirname(heartbeatPath));
+            fs.writeFileSync(heartbeatPath, JSON.stringify(heartbeat, null, 2), 'utf-8');
+        }
+        catch { /* best-effort */ }
+        // Append structured log entry
+        const logEntry = `${now.toISOString()} | Round=${context.round} | Duration=${durationSeconds}s | Failures=${consecutiveFailures} | Status=idle`;
+        try {
+            ensureDir(path.dirname(logPath));
+            fs.appendFileSync(logPath, logEntry + '\n', 'utf-8');
+            rotateLog(logPath, maxLogEntries, maxLogBytes);
+        }
+        catch { /* best-effort */ }
+        return {
+            success: true,
+            summary: `heartbeat written (round ${context.round})`,
+            data: { heartbeatPath, durationSeconds },
+        };
+    }
+}
+/** Increment consecutive failure counter (called by the main loop on error). */
+export function recordFailure() {
+    consecutiveFailures++;
+}
+/** Reset consecutive failure counter (called by the main loop on success). */
+export function recordSuccess() {
+    consecutiveFailures = 0;
+}
+/** Get current consecutive failure count. */
+export function getConsecutiveFailures() {
+    return consecutiveFailures;
+}
+/** Mark round start time for duration tracking. */
+export function markRoundStart() {
+    lastRoundStart = Date.now();
+}
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+function rotateLog(logPath, maxEntries, maxBytes) {
+    try {
+        const stat = fs.statSync(logPath);
+        let needsRotation = stat.size > maxBytes;
+        if (!needsRotation) {
+            const content = fs.readFileSync(logPath, 'utf-8');
+            const lines = content.split('\n').filter(Boolean);
+            needsRotation = lines.length > maxEntries;
+        }
+        if (needsRotation) {
+            const content = fs.readFileSync(logPath, 'utf-8');
+            const lines = content.split('\n').filter(Boolean);
+            const kept = lines.slice(-Math.max(maxEntries - 1, 1));
+            const header = `# Ralph Watch Log — Rotated ${new Date().toISOString()} (kept last ${kept.length} entries)`;
+            fs.writeFileSync(logPath, [header, ...kept].join('\n') + '\n', 'utf-8');
+        }
+    }
+    catch { /* best-effort */ }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/cli/commands/watch/capabilities/heartbeat.js.map

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

package/dist/cli/commands/watch/capabilities/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Capability barrel — registers all built-in capabilities.
+ */
+import { CapabilityRegistry } from '../registry.js';
+export { RatePool } from './rate-pool.js';
+export type { RatePoolConfig, PoolStatus } from './rate-pool.js';
+/** Create a registry pre-loaded with all built-in capabilities. */
+export declare function createDefaultRegistry(): CapabilityRegistry;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/watch/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAkBpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjE,mEAAmE;AACnE,wBAAgB,qBAAqB,IAAI,kBAAkB,CAkB1D"}

package/dist/cli/commands/watch/capabilities/index.js

@@ -0,0 +1,40 @@
+/**
+ * Capability barrel — registers all built-in capabilities.
+ */
+import { CapabilityRegistry } from '../registry.js';
+import { SelfPullCapability } from './self-pull.js';
+import { ExecuteCapability } from './execute.js';
+import { BoardCapability } from './board.js';
+import { MonitorTeamsCapability } from './monitor-teams.js';
+import { MonitorEmailCapability } from './monitor-email.js';
+import { TwoPassCapability } from './two-pass.js';
+import { WaveDispatchCapability } from './wave-dispatch.js';
+import { RetroCapability } from './retro.js';
+import { DecisionHygieneCapability } from './decision-hygiene.js';
+// ── Watch parity capabilities (ported from ralph-watch.ps1, #743) ──
+import { HealthCheckCapability } from './health-check.js';
+import { StaleReclaimCapability } from './stale-reclaim.js';
+import { HeartbeatCapability } from './heartbeat.js';
+import { WebhookAlertCapability } from './webhook-alerts.js';
+// Re-export rate pool for direct consumption (utility, not a phase capability)
+export { RatePool } from './rate-pool.js';
+/** Create a registry pre-loaded with all built-in capabilities. */
+export function createDefaultRegistry() {
+    const registry = new CapabilityRegistry();
+    registry.register(new SelfPullCapability());
+    registry.register(new ExecuteCapability());
+    registry.register(new BoardCapability());
+    registry.register(new MonitorTeamsCapability());
+    registry.register(new MonitorEmailCapability());
+    registry.register(new TwoPassCapability());
+    registry.register(new WaveDispatchCapability());
+    registry.register(new RetroCapability());
+    registry.register(new DecisionHygieneCapability());
+    // Watch parity capabilities (#743)
+    registry.register(new HealthCheckCapability());
+    registry.register(new StaleReclaimCapability());
+    registry.register(new HeartbeatCapability());
+    registry.register(new WebhookAlertCapability());
+    return registry;
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/commands/watch/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE,sEAAsE;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,+EAA+E;AAC/E,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,mEAAmE;AACnE,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,IAAI,yBAAyB,EAAE,CAAC,CAAC;IAEnD,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,CAAC,IAAI,qBAAqB,EAAE,CAAC,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,IAAI,sBAAsB,EAAE,CAAC,CAAC;IAChD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/cli/commands/watch/capabilities/lockfile.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Lockfile utility — per-repo lock with PID, timestamp, and stale detection.
+ *
+ * Ported from ralph-watch.ps1 lockfile logic.
+ * Written BEFORE a round (status=running) and AFTER (status=idle/error).
+ * External tools (e.g., squad-monitor) can read this file to know if
+ * a watch process is active.
+ *
+ * This is a utility module — not a WatchCapability.
+ */
+export interface LockfileData {
+    pid: number;
+    status: 'running' | 'idle' | 'error';
+    round: number;
+    lastRun: string;
+    exitCode: number;
+    consecutiveFailures: number;
+    started: string;
+    directory: string;
+}
+/**
+ * Acquire a lockfile for this watch process.
+ * Returns false if another non-stale process holds the lock.
+ */
+export declare function acquireLock(teamRoot: string): boolean;
+/** Update the lockfile with current round state. */
+export declare function updateLock(teamRoot: string, status: 'running' | 'idle' | 'error', round: number, exitCode?: number, consecutiveFailures?: number): void;
+/** Release the lockfile on shutdown. */
+export declare function releaseLock(teamRoot: string): void;
+//# sourceMappingURL=lockfile.d.ts.map

package/dist/cli/commands/watch/capabilities/lockfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/lockfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiCrD;AAED,oDAAoD;AACpD,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,EACpC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAU,EACpB,mBAAmB,GAAE,MAAU,GAC9B,IAAI,CAiBN;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUlD"}