@bradygaster/squad-cli 0.9.2-insider.6 → 0.9.4-insider.1

package/templates/skills/versioning-policy/SKILL.md

@@ -0,0 +1,119 @@
+---
+name: "versioning-policy"
+description: "Semver versioning rules for Squad SDK and CLI — prevents prerelease version incidents"
+domain: "release, versioning, npm, CI"
+confidence: "medium"
+source: "earned (PR #640 workspace resolution incident, PR #116 prerelease leak, CI gate implementation)"
+---
+
+## Context
+
+Squad is a monorepo with two publishable npm packages (`@bradygaster/squad-sdk` and `@bradygaster/squad-cli`) managed via npm workspaces. Version mismatches and prerelease leaks have caused production incidents — most notably PR #640, where a `-build.N` prerelease version silently broke workspace dependency resolution.
+
+This skill codifies the versioning rules every agent must follow.
+
+## 1. Version Format
+
+All packages use **strict semver**: `MAJOR.MINOR.PATCH`
+
+- ✅ `0.9.1`, `1.0.0`, `0.10.0`
+- ❌ `0.9.1-build.4`, `0.9.1-preview.1`, `0.8.6.1-preview`
+
+No prerelease suffixes on `dev` or `main` branches — ever.
+
+## 2. Prerelease Versions Are Ephemeral
+
+The `scripts/bump-build.mjs` script creates `-build.N` versions (e.g., `0.9.1-build.4`) for **local development testing only**.
+
+Rules:
+- `-build.N` versions are created automatically during local `npm run build`
+- They are **never committed** to `dev` or `main`
+- The script skips itself in CI (`CI=true` or `SKIP_BUILD_BUMP=1`)
+- If you see a `-build.N` version in a PR diff, it is a bug — reject the PR
+
+## 3. SDK and CLI Version Sync
+
+Both `@bradygaster/squad-sdk` and `@bradygaster/squad-cli` **MUST have the same version** at all times. The root `package.json` version must also match.
+
+`bump-build.mjs` enforces this by updating all three `package.json` files in lockstep (root + `packages/squad-sdk` + `packages/squad-cli`).
+
+If versions diverge, workspace resolution silently breaks (see §4).
+
+## 4. npm Workspace Semver Footgun
+
+The CLI depends on the SDK via a workspace dependency with a semver range:
+
+```json
+"@bradygaster/squad-sdk": ">=0.9.0"
+```
+
+**Critical:** Per the semver specification, `>=0.9.0` does **NOT** match `0.9.1-build.4`.
+
+Semver prerelease versions (anything with a `-` suffix) are only matched by ranges that explicitly reference the same `MAJOR.MINOR.PATCH` base with a prerelease comparator. A bare `>=0.9.0` range skips all prerelease versions.
+
+**What happens:** When the local SDK has version `0.9.1-build.4`, npm's workspace resolution fails to match the `>=0.9.0` range. npm then **silently installs a stale published version** from the npm registry instead of using the local workspace link. The build succeeds but runs against old SDK code.
+
+This is the root cause of the **PR #640 incident**, where workspace packages appeared linked but were actually running against stale registry versions.
+
+## 5. Who Bumps Versions
+
+**Surgeon (Release Manager) owns all version bumps.**
+
+| Agent | May modify `version` in package.json? |
+|-------|---------------------------------------|
+| Surgeon | ✅ Yes — sole owner of version bumps |
+| Any other agent | ❌ No — unless explicitly fixing a prerelease leak |
+
+If you discover a prerelease version committed to `dev` or `main`, you may fix it (revert to the clean release version) without Surgeon's approval. This is a safety escape hatch, not a license to manage versions.
+
+## 6. Version Bump Lifecycle
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  Development phase                                      │
+│  Versions stay at current release: 0.9.1                │
+│  bump-build.mjs creates -build.N locally (not committed)│
+├─────────────────────────────────────────────────────────┤
+│  Pre-release testing                                    │
+│  bump-build.mjs → 0.9.1-build.1, -build.2, ...         │
+│  Local only. Never committed. Never pushed.             │
+├─────────────────────────────────────────────────────────┤
+│  Release                                                │
+│  Surgeon bumps to next version (e.g., 0.9.2 or 0.10.0) │
+│  Tags, publishes to npm registry                        │
+├─────────────────────────────────────────────────────────┤
+│  Post-release                                           │
+│  Versions stay at the new release version (e.g., 0.9.2) │
+│  Development continues on clean version                 │
+└─────────────────────────────────────────────────────────┘
+```
+
+## 7. CI Enforcement
+
+The **`prerelease-version-guard`** CI gate blocks any PR to `dev` or `main` that contains prerelease version strings in `package.json` files.
+
+- The gate scans all three `package.json` files for `-` in the version field
+- PRs with prerelease versions **cannot merge** until the version is cleaned
+- The `skip-version-check` label bypasses the gate — use **only** for the bump-build script's own PR (if applicable), and only with Surgeon's approval
+
+## 8. Incident Reference — PR #640
+
+**PR #640** is the cautionary tale for this entire policy.
+
+**What happened:** Prerelease versions (`0.9.1-build.4`) were committed to a branch. The workspace dependency `>=0.9.0` failed to match the prerelease version per semver spec. npm silently installed a stale published SDK from the registry instead of linking the local workspace copy. Four PRs (#637–#640) attempted iterative patches before the root cause was identified.
+
+**Root cause:** No versioning policy existed. Agents didn't know that prerelease versions break workspace resolution, or that only Surgeon should modify versions.
+
+**Resolution:** This skill, the `prerelease-version-guard` CI gate, and the team decision to centralize version ownership under Surgeon.
+
+## Quick Reference
+
+| Rule | Summary |
+|------|---------|
+| Format | `MAJOR.MINOR.PATCH` — no prerelease on dev/main |
+| Prerelease | `-build.N` is local-only, never committed |
+| Sync | SDK + CLI + root must have identical versions |
+| Ownership | Surgeon bumps versions; others don't touch them |
+| CI gate | `prerelease-version-guard` blocks prerelease PRs |
+| Escape hatch | Any agent may revert a prerelease leak to clean version |
+| Footgun | `>=0.9.0` does NOT match `0.9.1-build.4` per semver |

package/templates/squad.agent.md.template

@@ -875,13 +875,15 @@ prompt: |
   SPAWN MANIFEST: {spawn_manifest}
 
   Tasks (in order):
-  1. ORCHESTRATION LOG: Write .squad/orchestration-log/{timestamp}-{agent}.md per agent. Use ISO 8601 UTC timestamp.
-  2. SESSION LOG: Write .squad/log/{timestamp}-{topic}.md. Brief. Use ISO 8601 UTC timestamp.
-  3. DECISION INBOX: Merge .squad/decisions/inbox/ → decisions.md, delete inbox files. Deduplicate.
-  4. CROSS-AGENT: Append team updates to affected agents' history.md.
-  5. DECISIONS ARCHIVE: If decisions.md exceeds ~20KB, archive entries older than 30 days to decisions-archive.md.
-  6. GIT COMMIT: git add .squad/ && commit (write msg to temp file, use -F). Skip if nothing staged.
-  7. HISTORY SUMMARIZATION: If any history.md >12KB, summarize old entries to ## Core Context.
+  0. PRE-CHECK: Stat decisions.md size and count inbox/ files. Record measurements.
+  1. DECISIONS ARCHIVE [HARD GATE]: If decisions.md >= 20480 bytes, archive entries older than 30 days NOW. If >= 51200 bytes, archive entries older than 7 days. Do not skip this step.
+  2. DECISION INBOX: Merge .squad/decisions/inbox/ → decisions.md, delete inbox files. Deduplicate.
+  3. ORCHESTRATION LOG: Write .squad/orchestration-log/{timestamp}-{agent}.md per agent. Use ISO 8601 UTC timestamp.
+  4. SESSION LOG: Write .squad/log/{timestamp}-{topic}.md. Brief. Use ISO 8601 UTC timestamp.
+  5. CROSS-AGENT: Append team updates to affected agents' history.md.
+  6. HISTORY SUMMARIZATION [HARD GATE]: If any history.md >= 15360 bytes (15KB), summarize now.
+  7. GIT COMMIT: Stage only the exact `.squad/` files Scribe wrote in this session. Use `git status --porcelain` filtered to allowed paths (decisions.md, decisions-archive.md, agents/{name}/history.md, agents/{name}/history-archive.md, log/*, orchestration-log/*). Stage each file individually with `git add -- <path>`. Handle renames by extracting destination path (`-replace '^.* -> ',''`). Commit with -F (write msg to temp file). Skip if nothing staged. ⚠️ NEVER use `git add .squad/` or broad globs.
+  8. HEALTH REPORT: Log decisions.md before/after size, inbox count processed, history files summarized.
 
   Never speak to user. ⚠️ End with plain text summary after all tool calls.
 ```

package/templates/workflows/squad-triage.yml

@@ -110,9 +110,11 @@ jobs:
               return;
             }
 
+            function slugify(t) { return t.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, ''); }
+
             // Build triage context
             const memberList = members.map(m =>
-              `- **${m.name}** (${m.role}) → label: \`squad:${m.name.toLowerCase()}\``
+              `- **${m.name}** (${m.role}) → label: \`squad:${slugify(m.name)}\``
             ).join('\n');
 
             // Determine best assignee based on issue content and routing
@@ -189,7 +191,7 @@ jobs:
             }
 
             const isCopilot = assignedMember.name === '@copilot';
-            const assignLabel = isCopilot ? 'squad:copilot' : `squad:${assignedMember.name.toLowerCase()}`;
+            const assignLabel = isCopilot ? 'squad:copilot' : `squad:${slugify(assignedMember.name)}`;
 
             // Add the member-specific label
             await github.rest.issues.addLabels({

package/templates/workflows/sync-squad-labels.yml

@@ -103,6 +103,8 @@ jobs:
               { name: 'priority:p2', color: 'FBCA04', description: 'Next sprint' }
             ];
 
+            function slugify(t) { return t.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, ''); }
+
             // Ensure the base "squad" triage label exists
             const labels = [
               { name: 'squad', color: SQUAD_COLOR, description: 'Squad triage inbox — Lead will assign to a member' }
@@ -110,7 +112,7 @@ jobs:
 
             for (const member of members) {
               labels.push({
-                name: `squad:${member.name.toLowerCase()}`,
+                name: `squad:${slugify(member.name)}`,
                 color: MEMBER_COLOR,
                 description: `Assigned to ${member.name} (${member.role})`
               });

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

@@ -1,29 +0,0 @@
-/**
- * Budget check utility — enforce configurable per-round limits.
- *
- * Ported from ralph-watch.ps1 rate-pool / budget tracking logic.
- *
- * Config (via squad.config.ts → watch.capabilities or CLI flags):
- *   maxIssuesPerRound  – max issues to execute in a single round (default: 5)
- *   maxCostPerRound    – cost cap (abstract units) per round (default: Infinity)
- *
- * This is a utility module — not a WatchCapability.
- * Called by the execute capability before spawning agent sessions.
- */
-export interface BudgetConfig {
-    maxIssuesPerRound?: number;
-    maxCostPerRound?: number;
-}
-export interface BudgetResult {
-    allowed: number;
-    reason: string;
-}
-/**
- * Determine how many issues can be executed this round given budget constraints.
- *
- * @param requested  Number of issues the execute phase wants to process.
- * @param config     Budget limits from config or CLI.
- * @returns          How many are allowed + explanation.
- */
-export declare function checkBudget(requested: number, config?: BudgetConfig): BudgetResult;
-//# sourceMappingURL=budget-check.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"budget-check.d.ts","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/budget-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,CAmBlF"}

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

@@ -1,38 +0,0 @@
-/**
- * Budget check utility — enforce configurable per-round limits.
- *
- * Ported from ralph-watch.ps1 rate-pool / budget tracking logic.
- *
- * Config (via squad.config.ts → watch.capabilities or CLI flags):
- *   maxIssuesPerRound  – max issues to execute in a single round (default: 5)
- *   maxCostPerRound    – cost cap (abstract units) per round (default: Infinity)
- *
- * This is a utility module — not a WatchCapability.
- * Called by the execute capability before spawning agent sessions.
- */
-const DEFAULT_MAX_ISSUES = 5;
-/**
- * Determine how many issues can be executed this round given budget constraints.
- *
- * @param requested  Number of issues the execute phase wants to process.
- * @param config     Budget limits from config or CLI.
- * @returns          How many are allowed + explanation.
- */
-export function checkBudget(requested, config) {
-    const maxIssues = config?.maxIssuesPerRound ?? DEFAULT_MAX_ISSUES;
-    const maxCost = config?.maxCostPerRound ?? Infinity;
-    // Simple issue-count gate
-    if (requested <= maxIssues && maxCost === Infinity) {
-        return { allowed: requested, reason: `within budget (${requested}/${maxIssues})` };
-    }
-    const allowed = Math.min(requested, maxIssues);
-    const reasons = [];
-    if (requested > maxIssues) {
-        reasons.push(`capped to ${maxIssues} issues/round`);
-    }
-    if (maxCost !== Infinity) {
-        reasons.push(`cost cap: ${maxCost}`);
-    }
-    return { allowed, reason: reasons.join('; ') };
-}
-//# sourceMappingURL=budget-check.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"budget-check.js","sourceRoot":"","sources":["../../../../../src/cli/commands/watch/capabilities/budget-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,MAAqB;IAClE,MAAM,SAAS,GAAG,MAAM,EAAE,iBAAiB,IAAI,kBAAkB,CAAC;IAClE,MAAM,OAAO,GAAG,MAAM,EAAE,eAAe,IAAI,QAAQ,CAAC;IAEpD,0BAA0B;IAC1B,IAAI,SAAS,IAAI,SAAS,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACnD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB,SAAS,IAAI,SAAS,GAAG,EAAE,CAAC;IACrF,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,aAAa,SAAS,eAAe,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACjD,CAAC"}

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

@@ -1,52 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,152 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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/health-check.d.ts

@@ -1,29 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,139 +0,0 @@
-/**
- * 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