@bradygaster/squad-cli 0.9.2-insider.5 → 0.9.3-insider.1

package/dist/cli/commands/watch/capabilities/circuit-breaker.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Enhanced Circuit Breaker capability — model-level fallback with cooldown.
+ *
+ * Ported from ralph-watch.ps1 `Get-CircuitBreakerState` / `Update-CircuitBreakerOn*`.
+ * Tracks model failures, auto-fallback through a configurable chain, and
+ * cooldown timer.  State persisted to `.squad/ralph-circuit-breaker.json`.
+ *
+ * This is a **utility module** consumed by the main watch loop, not a
+ * phase-based capability (it gates every round, not a specific phase).
+ *
+ * Config (via squad.config.ts → watch.circuitBreaker):
+ *   preferredModel   – default model to use (default: "claude-sonnet-4")
+ *   fallbackChain    – ordered list of fallback models
+ *   cooldownMinutes  – minutes before half-open probe (default: 10)
+ *   requiredSuccessesToClose – successes in half-open before closing (default: 2)
+ */
+export type CircuitState = 'closed' | 'open' | 'half-open';
+export interface ModelCircuitBreakerState {
+    state: CircuitState;
+    preferredModel: string;
+    currentModel: string;
+    fallbackChain: string[];
+    lastRateLimitHit: string | null;
+    cooldownMinutes: number;
+    consecutiveSuccesses: number;
+    requiredSuccessesToClose: number;
+    totalFallbacks: number;
+    totalRecoveries: number;
+}
+export interface CircuitBreakerConfig {
+    preferredModel?: string;
+    fallbackChain?: string[];
+    cooldownMinutes?: number;
+    requiredSuccessesToClose?: number;
+}
+export declare class ModelCircuitBreaker {
+    private statePath;
+    constructor(squadDir: string, config?: CircuitBreakerConfig);
+    load(): ModelCircuitBreakerState;
+    save(state: ModelCircuitBreakerState): void;
+    /** Get the model to use for the current round. */
+    getCurrentModel(): string;
+    /** Call after a successful round. */
+    onSuccess(): void;
+    /** Call when a rate limit or model error is detected. */
+    onRateLimit(): void;
+    /** Reset to defaults (used by post-failure remediation). */
+    reset(): void;
+    /** Get full state for diagnostics. */
+    getState(): ModelCircuitBreakerState;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/cli/commands/watch/capabilities/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,YAAY,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAeD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB;IAkB3D,IAAI,IAAI,wBAAwB;IAuBhC,IAAI,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI;IAU3C,kDAAkD;IAClD,eAAe,IAAI,MAAM;IAmBzB,qCAAqC;IACrC,SAAS,IAAI,IAAI;IAcjB,yDAAyD;IACzD,WAAW,IAAI,IAAI;IAanB,4DAA4D;IAC5D,KAAK,IAAI,IAAI;IAIb,sCAAsC;IACtC,QAAQ,IAAI,wBAAwB;CAGrC"}

package/dist/cli/commands/watch/capabilities/circuit-breaker.js

@@ -0,0 +1,152 @@
+/**
+ * Enhanced Circuit Breaker capability — model-level fallback with cooldown.
+ *
+ * Ported from ralph-watch.ps1 `Get-CircuitBreakerState` / `Update-CircuitBreakerOn*`.
+ * Tracks model failures, auto-fallback through a configurable chain, and
+ * cooldown timer.  State persisted to `.squad/ralph-circuit-breaker.json`.
+ *
+ * This is a **utility module** consumed by the main watch loop, not a
+ * phase-based capability (it gates every round, not a specific phase).
+ *
+ * Config (via squad.config.ts → watch.circuitBreaker):
+ *   preferredModel   – default model to use (default: "claude-sonnet-4")
+ *   fallbackChain    – ordered list of fallback models
+ *   cooldownMinutes  – minutes before half-open probe (default: 10)
+ *   requiredSuccessesToClose – successes in half-open before closing (default: 2)
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+const DEFAULT_STATE = {
+    state: 'closed',
+    preferredModel: 'claude-sonnet-4',
+    currentModel: 'claude-sonnet-4',
+    fallbackChain: ['gpt-4.1', 'claude-haiku-4.5'],
+    lastRateLimitHit: null,
+    cooldownMinutes: 10,
+    consecutiveSuccesses: 0,
+    requiredSuccessesToClose: 2,
+    totalFallbacks: 0,
+    totalRecoveries: 0,
+};
+export class ModelCircuitBreaker {
+    statePath;
+    constructor(squadDir, config) {
+        this.statePath = path.join(squadDir, 'ralph-circuit-breaker.json');
+        // Ensure defaults incorporate any user config
+        if (config) {
+            const state = this.load();
+            let dirty = false;
+            if (config.preferredModel && state.preferredModel !== config.preferredModel) {
+                state.preferredModel = config.preferredModel;
+                if (state.state === 'closed')
+                    state.currentModel = config.preferredModel;
+                dirty = true;
+            }
+            if (config.fallbackChain) {
+                state.fallbackChain = config.fallbackChain;
+                dirty = true;
+            }
+            if (config.cooldownMinutes) {
+                state.cooldownMinutes = config.cooldownMinutes;
+                dirty = true;
+            }
+            if (config.requiredSuccessesToClose) {
+                state.requiredSuccessesToClose = config.requiredSuccessesToClose;
+                dirty = true;
+            }
+            if (dirty)
+                this.save(state);
+        }
+    }
+    load() {
+        try {
+            if (!fs.existsSync(this.statePath))
+                return { ...DEFAULT_STATE };
+            const raw = fs.readFileSync(this.statePath, 'utf-8');
+            if (!raw)
+                return { ...DEFAULT_STATE };
+            const parsed = JSON.parse(raw);
+            // Handle legacy nested schema (model_fallback wrapper)
+            const legacy = parsed;
+            if (!parsed.preferredModel && legacy['model_fallback']) {
+                const mf = legacy['model_fallback'];
+                return {
+                    ...DEFAULT_STATE,
+                    preferredModel: mf['preferred'] ?? DEFAULT_STATE.preferredModel,
+                    currentModel: mf['preferred'] ?? DEFAULT_STATE.currentModel,
+                    fallbackChain: mf['fallback_chain'] ?? DEFAULT_STATE.fallbackChain,
+                };
+            }
+            return { ...DEFAULT_STATE, ...parsed };
+        }
+        catch {
+            return { ...DEFAULT_STATE };
+        }
+    }
+    save(state) {
+        try {
+            const dir = path.dirname(this.statePath);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            fs.writeFileSync(this.statePath, JSON.stringify(state, null, 2), 'utf-8');
+        }
+        catch { /* best-effort */ }
+    }
+    /** Get the model to use for the current round. */
+    getCurrentModel() {
+        const state = this.load();
+        if (state.state === 'closed')
+            return state.preferredModel;
+        if (state.state === 'open') {
+            if (state.lastRateLimitHit) {
+                const elapsed = Date.now() - new Date(state.lastRateLimitHit).getTime();
+                if (elapsed >= state.cooldownMinutes * 60_000) {
+                    state.state = 'half-open';
+                    state.currentModel = state.preferredModel;
+                    this.save(state);
+                    return state.preferredModel;
+                }
+            }
+            return state.currentModel;
+        }
+        // half-open — probe preferred
+        return state.preferredModel;
+    }
+    /** Call after a successful round. */
+    onSuccess() {
+        const state = this.load();
+        if (state.state === 'half-open') {
+            state.consecutiveSuccesses++;
+            if (state.consecutiveSuccesses >= state.requiredSuccessesToClose) {
+                state.state = 'closed';
+                state.currentModel = state.preferredModel;
+                state.consecutiveSuccesses = 0;
+                state.totalRecoveries++;
+            }
+            this.save(state);
+        }
+    }
+    /** Call when a rate limit or model error is detected. */
+    onRateLimit() {
+        const state = this.load();
+        state.state = 'open';
+        state.lastRateLimitHit = new Date().toISOString();
+        state.consecutiveSuccesses = 0;
+        state.totalFallbacks++;
+        // Pick first fallback
+        if (state.fallbackChain.length > 0) {
+            state.currentModel = state.fallbackChain[0];
+        }
+        this.save(state);
+    }
+    /** Reset to defaults (used by post-failure remediation). */
+    reset() {
+        this.save({ ...DEFAULT_STATE });
+    }
+    /** Get full state for diagnostics. */
+    getState() {
+        return this.load();
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/cli/commands/watch/capabilities/circuit-breaker.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * Cleanup capability — housekeeping for stale temp and log files.
+ *
+ * Runs in the 'housekeeping' phase. Clears the scratch directory, prunes
+ * old orchestration-log and session-log entries, and warns about stale
+ * decision inbox files.
+ */
+import type { WatchCapability, WatchContext, PreflightResult, CapabilityResult } from '../types.js';
+export declare class CleanupCapability implements WatchCapability {
+    readonly name = "cleanup";
+    readonly description = "Remove stale scratch files, prune old logs, warn about stale inbox";
+    readonly configShape: "object";
+    readonly requires: string[];
+    readonly phase: "housekeeping";
+    preflight(context: WatchContext): Promise<PreflightResult>;
+    execute(context: WatchContext): Promise<CapabilityResult>;
+}
+//# sourceMappingURL=cleanup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/cleanup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAyDpG,qBAAa,iBAAkB,YAAW,eAAe;IACvD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,wEAAwE;IAC5F,QAAQ,CAAC,WAAW,EAAG,QAAQ,CAAU;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAM;IACjC,QAAQ,CAAC,KAAK,EAAG,cAAc,CAAU;IAEnC,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAQ1D,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAoEhE"}

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

@@ -0,0 +1,135 @@
+/**
+ * Cleanup capability — housekeeping for stale temp and log files.
+ *
+ * Runs in the 'housekeeping' phase. Clears the scratch directory, prunes
+ * old orchestration-log and session-log entries, and warns about stale
+ * decision inbox files.
+ */
+import path from 'node:path';
+import { rmSync } from 'node:fs';
+import { FSStorageProvider } from '@bradygaster/squad-sdk';
+const storage = new FSStorageProvider();
+/** Default: files older than this many days are pruned. */
+const DEFAULT_MAX_AGE_DAYS = 30;
+/** Default: run cleanup every N rounds (not every round). */
+const DEFAULT_EVERY_N_ROUNDS = 10;
+/** Stale inbox warning threshold (days). */
+const STALE_INBOX_DAYS = 7;
+function parseConfig(raw) {
+    return {
+        everyNRounds: typeof raw.everyNRounds === 'number' && Number.isFinite(raw.everyNRounds) && raw.everyNRounds > 0
+            ? raw.everyNRounds
+            : DEFAULT_EVERY_N_ROUNDS,
+        maxAgeDays: typeof raw.maxAgeDays === 'number' && Number.isFinite(raw.maxAgeDays) && raw.maxAgeDays > 0
+            ? raw.maxAgeDays
+            : DEFAULT_MAX_AGE_DAYS,
+    };
+}
+function isOlderThan(filename, days) {
+    // Filenames may start with ISO timestamp: 2026-04-01T12-00-00Z-agent.md
+    const match = filename.match(/^(\d{4}-\d{2}-\d{2})/);
+    if (!match)
+        return false;
+    const fileDate = new Date(match[1]);
+    if (isNaN(fileDate.getTime()))
+        return false;
+    const cutoffMs = Date.now() - (days * 86400000);
+    return fileDate.getTime() < cutoffMs;
+}
+function safeList(dir) {
+    try {
+        if (!storage.existsSync(dir))
+            return [];
+        return storage.listSync?.(dir) ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+function safeDelete(filePath) {
+    try {
+        rmSync(filePath, { recursive: true, force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export class CleanupCapability {
+    name = 'cleanup';
+    description = 'Remove stale scratch files, prune old logs, warn about stale inbox';
+    configShape = 'object';
+    requires = [];
+    phase = 'housekeeping';
+    async preflight(context) {
+        const squadDir = path.join(context.teamRoot, '.squad');
+        if (!storage.existsSync(squadDir)) {
+            return { ok: false, reason: '.squad/ directory not found' };
+        }
+        return { ok: true };
+    }
+    async execute(context) {
+        const config = parseConfig(context.config);
+        const everyN = config.everyNRounds ?? DEFAULT_EVERY_N_ROUNDS;
+        // Only run on every Nth round (or round 1 for immediate feedback)
+        if (context.round > 1 && context.round % everyN !== 0) {
+            return { success: true, summary: `cleanup: skipped (runs every ${everyN} rounds)` };
+        }
+        const squadDir = path.join(context.teamRoot, '.squad');
+        const maxAge = config.maxAgeDays ?? DEFAULT_MAX_AGE_DAYS;
+        const actions = [];
+        // 1. Clear .squad/.scratch/ — everything in here is ephemeral
+        const scratchDir = path.join(squadDir, '.scratch');
+        const scratchFiles = safeList(scratchDir);
+        let scratchDeleted = 0;
+        for (const f of scratchFiles) {
+            if (safeDelete(path.join(scratchDir, f)))
+                scratchDeleted++;
+        }
+        if (scratchDeleted > 0) {
+            actions.push(`scratch: ${scratchDeleted} files cleared`);
+        }
+        // 2. Prune old orchestration-log entries (older than maxAge days)
+        const orchDir = path.join(squadDir, 'orchestration-log');
+        const orchFiles = safeList(orchDir);
+        let orchPruned = 0;
+        for (const f of orchFiles) {
+            if (isOlderThan(f, maxAge)) {
+                if (safeDelete(path.join(orchDir, f)))
+                    orchPruned++;
+            }
+        }
+        if (orchPruned > 0) {
+            actions.push(`orchestration-log: ${orchPruned} entries pruned (>${maxAge}d)`);
+        }
+        // 3. Prune old session logs
+        const logDir = path.join(squadDir, 'log');
+        const logFiles = safeList(logDir);
+        let logPruned = 0;
+        for (const f of logFiles) {
+            if (isOlderThan(f, maxAge)) {
+                if (safeDelete(path.join(logDir, f)))
+                    logPruned++;
+            }
+        }
+        if (logPruned > 0) {
+            actions.push(`log: ${logPruned} entries pruned (>${maxAge}d)`);
+        }
+        // 4. Warn about stale decision inbox files
+        const inboxDir = path.join(squadDir, 'decisions', 'inbox');
+        const inboxFiles = safeList(inboxDir).filter(f => f.endsWith('.md'));
+        const staleInbox = inboxFiles.filter(f => isOlderThan(f, STALE_INBOX_DAYS));
+        if (staleInbox.length > 0) {
+            actions.push(`⚠ ${staleInbox.length} stale inbox files (>${STALE_INBOX_DAYS}d)`);
+        }
+        if (actions.length === 0) {
+            return { success: true, summary: 'cleanup: nothing to do' };
+        }
+        return {
+            success: true,
+            summary: `cleanup: ${actions.join('; ')}`,
+            data: { scratchDeleted, orchPruned, logPruned, staleInboxCount: staleInbox.length },
+        };
+    }
+}
+//# sourceMappingURL=cleanup.js.map

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

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

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

@@ -15,12 +15,24 @@ export interface ExecutableWorkItem {
         login: string;
     }>;
 }
-/** Find issues eligible for autonomous execution. */
-export declare function findExecutableIssues(roster: Array<{
+/** Classify an issue as read-heavy or write-heavy by title keywords. */
+export declare function classifyIssue(title: string): 'read' | 'write';
+/** Find issues eligible for autonomous execution.
+ *
+ * Pre-filters to keep only clearly actionable items:
+ *  - must have a squad/squad:* label
+ *  - must not be assigned to a human (agent decides once it reads ralph-instructions.md)
+ *  - must not carry a blocking status label
+ *
+ * Matches the PS1 ralph-watch pre-filter design.
+ */
+export declare function findExecutableIssues(_roster: Array<{
     name: string;
     label: string;
     expertise: string[];
-}>, capabilities: MachineCapabilities | null, issues: ExecutableWorkItem[]): ExecutableWorkItem[];
+}>, _capabilities: MachineCapabilities | null, issues: ExecutableWorkItem[]): ExecutableWorkItem[];
+/** Build the rich agent prompt matching PS1 ralph-watch design. */
+export declare function buildAgentPrompt(issues: ExecutableWorkItem[], teamRoot: string): string;
 export declare class ExecuteCapability implements WatchCapability {
     readonly name = "execute";
     readonly description = "Spawn Copilot sessions to work on eligible issues";

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

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/execute.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAErF,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrC;AAiCD,qDAAqD;AACrD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EACnE,YAAY,EAAE,mBAAmB,GAAG,IAAI,EACxC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,kBAAkB,EAAE,CAStB;AAsCD,qBAAa,iBAAkB,YAAW,eAAe;IACvD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,uDAAuD;IAC3E,QAAQ,CAAC,WAAW,EAAG,SAAS,CAAU;IAC1C,QAAQ,CAAC,QAAQ,WAAU;IAC3B,QAAQ,CAAC,KAAK,EAAG,cAAc,CAAU;IAEnC,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAQ3D,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAyChE"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/execute.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAGrF,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrC;AAoBD,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAM7D;AAiCD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EACpE,aAAa,EAAE,mBAAmB,GAAG,IAAI,EACzC,MAAM,EAAE,kBAAkB,EAAE,GAC3B,kBAAkB,EAAE,CAItB;AAaD,mEAAmE;AACnE,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAAE,EAC5B,QAAQ,EAAE,MAAM,GACf,MAAM,CA8BR;AA6BD,qBAAa,iBAAkB,YAAW,eAAe;IACvD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,uDAAuD;IAC3E,QAAQ,CAAC,WAAW,EAAG,SAAS,CAAU;IAC1C,QAAQ,CAAC,QAAQ,WAAU;IAC3B,QAAQ,CAAC,KAAK,EAAG,cAAc,CAAU;IAEnC,SAAS,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC;IAQ3D,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA4ChE"}

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

@@ -2,18 +2,33 @@
  * Execute capability — spawns Copilot sessions for eligible issues.
  */
 import { execFile } from 'node:child_process';
-/** 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',
-]);
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { createVerboseLogger } from '../verbose.js';
+/** Check whether an issue carries a squad or squad:* label. */
+function hasSquadLabel(issue) {
+    return issue.labels.some(l => l.name === 'squad' || l.name.startsWith('squad:'));
+}
+/** Keywords that indicate read-heavy / analysis work. */
+const READ_KEYWORDS = [
+    'research', 'review', 'analyze', 'investigate', 'audit',
+    'check', 'scan', 'assess', 'evaluate', 'fact-check',
+    'document', 'report',
+];
+/** Keywords that indicate write-heavy / implementation work. */
+const WRITE_KEYWORDS = [
+    'fix', 'implement', 'create', 'build', 'refactor',
+    'add', 'update', 'migrate', 'deploy', 'feature',
+];
+/** Classify an issue as read-heavy or write-heavy by title keywords. */
+export function classifyIssue(title) {
+    const lower = title.toLowerCase();
+    const isRead = READ_KEYWORDS.some(k => lower.includes(k));
+    const isWrite = WRITE_KEYWORDS.some(k => lower.includes(k));
+    if (isRead && !isWrite)
+        return 'read';
+    return 'write'; // default to write (safer — gets full agent session)
+}
 /** Build agent command for a prompt. */
 function buildAgentCommand(prompt, context) {
     if (context.agentCmd) {
@@ -28,32 +43,71 @@ function buildAgentCommand(prompt, context) {
     }
     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;
-    });
+/** Labels that indicate an issue should not be auto-executed. */
+const BLOCKING_LABELS = ['status:blocked', 'status:wontfix', 'status:on-hold', 'blocked'];
+/** Check whether an issue has a blocking status label. */
+function hasBlockingLabel(issue) {
+    return issue.labels.some(l => BLOCKING_LABELS.includes(l.name));
 }
-/** 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.');
+/** Check whether an issue is already assigned to a human. */
+function isAssigned(issue) {
+    return issue.assignees.length > 0;
+}
+/** Find issues eligible for autonomous execution.
+ *
+ * Pre-filters to keep only clearly actionable items:
+ *  - must have a squad/squad:* label
+ *  - must not be assigned to a human (agent decides once it reads ralph-instructions.md)
+ *  - must not carry a blocking status label
+ *
+ * Matches the PS1 ralph-watch pre-filter design.
+ */
+export function findExecutableIssues(_roster, _capabilities, issues) {
+    return issues.filter(issue => hasSquadLabel(issue) && !isAssigned(issue) && !hasBlockingLabel(issue));
+}
+/** Format issue list for the agent prompt. */
+function formatIssueList(issues) {
+    return issues.map(i => {
+        const labels = i.labels.map(l => l.name).join(', ');
+        const assigned = i.assignees?.length
+            ? `assigned: ${i.assignees.map(a => a.login).join(',')}`
+            : 'unassigned';
+        return `- #${i.number}: ${i.title} [${labels}] ${assigned}`;
+    }).join('\n');
+}
+/** Build the rich agent prompt matching PS1 ralph-watch design. */
+export function buildAgentPrompt(issues, teamRoot) {
+    const issueList = formatIssueList(issues);
+    const hasInstructions = existsSync(path.join(teamRoot, '.squad', 'ralph-instructions.md'));
+    if (hasInstructions) {
+        return [
+            'Ralph, Go! Read .squad/ralph-instructions.md for your full instructions. Follow ALL sections there. MAXIMIZE PARALLELISM — spawn agents for ALL actionable issues simultaneously.',
+            '',
+            'Here are the current open squad issues:',
+            issueList,
+            '',
+            'Task: Read the issues, follow your instructions in .squad/ralph-instructions.md, and work on what\'s actionable.',
+            'WHY: Keep the squad pipeline moving — no idle work.',
+            'Success: Issues get branches, PRs, and progress.',
+            'Escalation: If blocked, comment on the issue and move to next.',
+        ].join('\n');
     }
-    catch { /* best-effort */ }
-    const prompt = `Work on issue #${issue.number}: ${issue.title}. Read the issue body for full details.`;
+    // Fallback when ralph-instructions.md does not exist
+    return [
+        'You are Ralph, the autonomous work monitor. Review the open squad issues below and work on every actionable one. Skip issues that are blocked, waiting on external input, or already assigned.',
+        '',
+        'Here are the current open squad issues:',
+        issueList,
+        '',
+        'Task: Triage the list, pick up unblocked/unassigned issues, create branches and PRs.',
+        'WHY: Keep the squad pipeline moving — no idle work.',
+        'Success: Issues get branches, PRs, and progress.',
+        'Escalation: If blocked, comment on the issue and move to next.',
+    ].join('\n');
+}
+/** Spawn a single agent session for all eligible issues. */
+async function executeAll(issues, context, timeoutMs) {
+    const prompt = buildAgentPrompt(issues, context.teamRoot);
     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) => {
@@ -82,9 +136,10 @@ export class ExecuteCapability {
         });
     }
     async execute(context) {
+        const vlog = createVerboseLogger(context.verbose ?? false);
         try {
-            const maxConcurrent = context.config['maxConcurrent'] ?? 1;
             const timeout = (context.config['timeout'] ?? 30) * 60_000;
+            vlog.log(`Execute: agentCmd=${context.agentCmd ?? 'gh copilot'}, timeout=${timeout / 60_000}m`);
             // Fetch open issues with squad label
             const sdkItems = await context.adapter.listWorkItems({ tags: ['squad'], state: 'open', limit: 50 });
             const issues = sdkItems.map(wi => ({
@@ -93,22 +148,24 @@ export class ExecuteCapability {
                 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' };
+            // Minimal filter: must have squad or squad:* label (agent decides the rest)
+            const eligible = findExecutableIssues(context.roster, null, issues);
+            vlog.log(`Execute: ${issues.length} total issues, ${eligible.length} eligible`);
+            for (const issue of eligible.slice(0, 5)) {
+                const labels = issue.labels.map(l => l.name).join(', ');
+                vlog.log(`  → #${issue.number}: "${issue.title}" [${labels}]`);
+            }
+            if (eligible.length === 0) {
+                return { success: true, summary: 'no squad-labeled issues found' };
             }
-            const results = await Promise.all(batch.map(issue => executeOne(issue, context, timeout)));
-            const succeeded = results.filter(r => r.success).length;
-            const failed = results.length - succeeded;
+            // Single agent invocation with all issues — agent reads ralph-instructions.md
+            const result = await executeAll(eligible, context, timeout);
             return {
-                success: true,
-                summary: `${succeeded} executed, ${failed} failed`,
-                data: { executed: succeeded, failed },
+                success: result.success,
+                summary: result.success
+                    ? `agent dispatched with ${eligible.length} issues`
+                    : `agent failed: ${result.error}`,
+                data: { dispatched: eligible.length, success: result.success },
             };
         }
         catch (e) {