squads-cli 0.6.0 → 0.6.2

package/dist/cli.js

@@ -1655,6 +1655,72 @@ function buildContextFromSquad(squadName, squadContent, agentName) {
   return context;
 }
 
+// src/lib/cron.ts
+function cronMatches(cron, date) {
+  const parts = cron.trim().split(/\s+/);
+  if (parts.length < 5) return false;
+  const fields = [
+    { value: date.getMinutes(), field: parts[0], min: 0, max: 59 },
+    { value: date.getHours(), field: parts[1], min: 0, max: 23 },
+    { value: date.getDate(), field: parts[2], min: 1, max: 31 },
+    { value: date.getMonth() + 1, field: parts[3], min: 1, max: 12 },
+    { value: date.getDay(), field: parts[4], min: 0, max: 6 }
+  ];
+  return fields.every(
+    ({ value, field, min, max }) => fieldMatches(field, value, min, max)
+  );
+}
+function fieldMatches(field, value, min, max) {
+  if (field.includes(",")) {
+    return field.split(",").some((part) => fieldMatches(part.trim(), value, min, max));
+  }
+  if (field.includes("/")) {
+    const [range, stepStr] = field.split("/");
+    const step = parseInt(stepStr);
+    if (isNaN(step) || step <= 0) return false;
+    let start = min;
+    let end = max;
+    if (range !== "*") {
+      if (range.includes("-")) {
+        [start, end] = range.split("-").map(Number);
+      } else {
+        start = parseInt(range);
+      }
+    }
+    if (value < start || value > end) return false;
+    return (value - start) % step === 0;
+  }
+  if (field.includes("-")) {
+    const [start, end] = field.split("-").map(Number);
+    return value >= start && value <= end;
+  }
+  if (field === "*") return true;
+  return parseInt(field) === value;
+}
+function getNextCronRun(cron, after = /* @__PURE__ */ new Date()) {
+  const next = new Date(after);
+  next.setSeconds(0, 0);
+  next.setMinutes(next.getMinutes() + 1);
+  const maxIterations = 60 * 48;
+  for (let i = 0; i < maxIterations; i++) {
+    if (cronMatches(cron, next)) return next;
+    next.setMinutes(next.getMinutes() + 1);
+  }
+  const fallback = new Date(after);
+  fallback.setDate(fallback.getDate() + 1);
+  return fallback;
+}
+function parseCooldown(cooldown) {
+  const match = cooldown.match(/^(\d+)\s*(m|min|minutes?|h|hours?|d|days?)$/i);
+  if (!match) return 0;
+  const value = parseInt(match[1]);
+  const unit = match[2].toLowerCase();
+  if (unit.startsWith("m")) return value * 60 * 1e3;
+  if (unit.startsWith("h")) return value * 60 * 60 * 1e3;
+  if (unit.startsWith("d")) return value * 24 * 60 * 60 * 1e3;
+  return 0;
+}
+
 // src/lib/llm-clis.ts
 import { execSync as execSync3 } from "child_process";
 function commandExists2(command) {
@@ -2021,8 +2087,26 @@ function getProviderDisplayName(provider) {
 
 // src/commands/run.ts
 import { homedir as homedir3 } from "os";
+var DEFAULT_BRIDGE_URL = "http://localhost:8088";
+var DEFAULT_LEARNINGS_LIMIT = 5;
+var DEFAULT_CONTEXT_TOKENS = 8e3;
+var DEFAULT_FALLBACK_CHARS = 2e3;
+var MAX_AGENT_BRIEFS = 3;
+var MAX_SQUAD_BRIEFS = 2;
+var MAX_LEARNINGS_CHARS = 1500;
+var MAX_LEAD_STATE_CHARS = 1e3;
+var EXECUTION_EVENT_TIMEOUT_MS = 5e3;
+var VERIFICATION_STATE_MAX_CHARS = 2e3;
+var VERIFICATION_EXEC_TIMEOUT_MS = 3e4;
+var DRYRUN_DEF_MAX_CHARS = 500;
+var DRYRUN_CONTEXT_MAX_CHARS = 800;
+var DEFAULT_SCHEDULED_COOLDOWN_MS = 6 * 60 * 60 * 1e3;
+var DEFAULT_TIMEOUT_MINUTES = 30;
+var SOFT_DEADLINE_RATIO = 0.7;
+var LOG_FILE_INIT_DELAY_MS = 500;
+var VERBOSE_COMMAND_MAX_CHARS = 50;
 async function registerContextWithBridge(ctx) {
-  const bridgeUrl = process.env.SQUADS_BRIDGE_URL || "http://localhost:8088";
+  const bridgeUrl = process.env.SQUADS_BRIDGE_URL || DEFAULT_BRIDGE_URL;
   try {
     const response = await fetch(`${bridgeUrl}/api/context/register`, {
       method: "POST",
@@ -2044,7 +2128,7 @@ async function registerContextWithBridge(ctx) {
   }
 }
 async function checkPreflightGates(squad, agent) {
-  const bridgeUrl = process.env.SQUADS_BRIDGE_URL || "http://localhost:8088";
+  const bridgeUrl = process.env.SQUADS_BRIDGE_URL || DEFAULT_BRIDGE_URL;
   try {
     const response = await fetch(`${bridgeUrl}/api/execution/preflight`, {
       method: "POST",
@@ -2059,8 +2143,8 @@ async function checkPreflightGates(squad, agent) {
     return { allowed: true, gates: {} };
   }
 }
-async function fetchLearnings(squad, limit = 5) {
-  const bridgeUrl = process.env.SQUADS_BRIDGE_URL || "http://localhost:8088";
+async function fetchLearnings(squad, limit = DEFAULT_LEARNINGS_LIMIT) {
+  const bridgeUrl = process.env.SQUADS_BRIDGE_URL || DEFAULT_BRIDGE_URL;
   try {
     const response = await fetch(
       `${bridgeUrl}/api/learnings/relevant?squad=${encodeURIComponent(squad)}&limit=${limit}`
@@ -2091,7 +2175,7 @@ function gatherSquadContext(squadName, agentName, options = {}) {
   const squadsDir = findSquadsDir();
   if (!squadsDir) return "";
   const memoryDir = findMemoryDir();
-  const maxTokens = options.maxTokens || 8e3;
+  const maxTokens = options.maxTokens || DEFAULT_CONTEXT_TOKENS;
   const sections = [];
   let estimatedTokens = 0;
   const estimateTokens = (text) => Math.ceil(text.length / 4);
@@ -2109,7 +2193,7 @@ function gatherSquadContext(squadName, agentName, options = {}) {
       if (outputMatch) squadContext += outputMatch[0] + "\n";
       if (contextMatch) squadContext += contextMatch[0] + "\n";
       if (!squadContext && squadContent.length > 0) {
-        squadContext = squadContent.substring(0, 2e3);
+        squadContext = squadContent.substring(0, DEFAULT_FALLBACK_CHARS);
       }
       if (squadContext) {
         const tokens = estimateTokens(squadContext);
@@ -2143,7 +2227,7 @@ ${stateContent.trim()}`);
     const briefsDir = join4(memoryDir, squadName, agentName, "briefs");
     if (existsSync4(briefsDir)) {
       try {
-        const briefFiles = readdirSync2(briefsDir).filter((f) => f.endsWith(".md")).slice(0, 3);
+        const briefFiles = readdirSync2(briefsDir).filter((f) => f.endsWith(".md")).slice(0, MAX_AGENT_BRIEFS);
         for (const briefFile of briefFiles) {
           const briefPath = join4(briefsDir, briefFile);
           const briefContent = readFileSync3(briefPath, "utf-8");
@@ -2164,7 +2248,7 @@ ${briefContent.trim()}`);
     const squadBriefsDir = join4(memoryDir, squadName, "_briefs");
     if (existsSync4(squadBriefsDir)) {
       try {
-        const squadBriefs = readdirSync2(squadBriefsDir).filter((f) => f.endsWith(".md")).slice(0, 2);
+        const squadBriefs = readdirSync2(squadBriefsDir).filter((f) => f.endsWith(".md")).slice(0, MAX_SQUAD_BRIEFS);
         for (const briefFile of squadBriefs) {
           const briefPath = join4(squadBriefsDir, briefFile);
           const briefContent = readFileSync3(briefPath, "utf-8");
@@ -2207,8 +2291,8 @@ ${briefingContent.trim()}`);
           try {
             let learningsContent = readFileSync3(learningsPath, "utf-8");
             if (learningsContent.trim()) {
-              if (learningsContent.length > 1500) {
-                learningsContent = learningsContent.slice(0, 1500) + "\n...(truncated)";
+              if (learningsContent.length > MAX_LEARNINGS_CHARS) {
+                learningsContent = learningsContent.slice(0, MAX_LEARNINGS_CHARS) + "\n...(truncated)";
               }
               const tokens = estimateTokens(learningsContent);
               if (estimatedTokens + tokens < maxTokens) {
@@ -2225,8 +2309,8 @@ ${learningsContent.trim()}`);
           try {
             let leadState = readFileSync3(leadStatePath, "utf-8");
             if (leadState.trim()) {
-              if (leadState.length > 1e3) {
-                leadState = leadState.slice(0, 1e3) + "\n...(truncated)";
+              if (leadState.length > MAX_LEAD_STATE_CHARS) {
+                leadState = leadState.slice(0, MAX_LEAD_STATE_CHARS) + "\n...(truncated)";
               }
               const tokens = estimateTokens(leadState);
               if (estimatedTokens + tokens < maxTokens) {
@@ -2518,6 +2602,10 @@ function parseAgentFrontmatter(agentPath) {
   if (retriesMatch) {
     result.max_retries = parseInt(retriesMatch[1], 10);
   }
+  const cooldownMatch = yaml2.match(/cooldown:\s*["']?([^"'\n]+)["']?/);
+  if (cooldownMatch) {
+    result.cooldown = cooldownMatch[1].trim();
+  }
   return result;
 }
 async function emitExecutionEvent(eventType, data) {
@@ -2537,7 +2625,7 @@ async function emitExecutionEvent(eventType, data) {
             ...data.error ? { error: data.error } : {}
           }
         }),
-        signal: AbortSignal.timeout(5e3)
+        signal: AbortSignal.timeout(EXECUTION_EVENT_TIMEOUT_MS)
       });
       return;
     } catch {
@@ -2573,7 +2661,7 @@ async function verifyExecution(squadName, agentName, criteria, options = {}) {
   if (memDir) {
     const statePath = join4(memDir, squadName, agentName, "state.md");
     if (existsSync4(statePath)) {
-      stateContent = readFileSync3(statePath, "utf-8").slice(0, 2e3);
+      stateContent = readFileSync3(statePath, "utf-8").slice(0, VERIFICATION_STATE_MAX_CHARS);
     }
   }
   let recentCommits = "";
@@ -2610,7 +2698,7 @@ FAIL: <brief reason>`;
     const escapedPrompt = verifyPrompt.replace(/'/g, "'\\''");
     const result = execSync11(
       `claude --print --model haiku -- '${escapedPrompt}'`,
-      { encoding: "utf-8", cwd: projectRoot, timeout: 3e4 }
+      { encoding: "utf-8", cwd: projectRoot, timeout: VERIFICATION_EXEC_TIMEOUT_MS }
     ).trim();
     if (options.verbose) {
       writeLine(`  ${colors.dim}Verification: ${result}${RESET}`);
@@ -2801,7 +2889,7 @@ async function runLeadMode(squad, squadsDir, options) {
     writeLine();
     return;
   }
-  const timeoutMins = options.timeout || 30;
+  const timeoutMins = options.timeout || DEFAULT_TIMEOUT_MINUTES;
   const agentList = agentFiles.map((a) => `- ${a.name}: ${a.role}`).join("\n");
   const agentPaths = agentFiles.map((a) => `- ${a.name}: ${a.path}`).join("\n");
   const prompt2 = `You are the Lead of the ${squad.name} squad.
@@ -2921,7 +3009,7 @@ ${learnings.map((l) => `- ${l.content}`).join("\n")}
     const dryRunContext = gatherSquadContext(squadName, agentName, { verbose: options.verbose, agentPath });
     if (options.verbose) {
       writeLine(`  ${colors.dim}Agent definition:${RESET}`);
-      writeLine(`  ${colors.dim}${definition.slice(0, 500)}...${RESET}`);
+      writeLine(`  ${colors.dim}${definition.slice(0, DRYRUN_DEF_MAX_CHARS)}...${RESET}`);
       if (learnings.length > 0) {
         writeLine(`  ${colors.dim}Learnings: ${learnings.length} from bridge${RESET}`);
       }
@@ -2929,7 +3017,7 @@ ${learnings.map((l) => `- ${l.content}`).join("\n")}
         const fullContext = `${dryRunContext}${learningContext}`;
         writeLine();
         writeLine(`  ${colors.cyan}Context to inject (${Math.ceil(fullContext.length / 4)} tokens):${RESET}`);
-        writeLine(`  ${colors.dim}${fullContext.slice(0, 800)}...${RESET}`);
+        writeLine(`  ${colors.dim}${fullContext.slice(0, DRYRUN_CONTEXT_MAX_CHARS)}...${RESET}`);
       }
     }
     return;
@@ -2982,8 +3070,9 @@ ${learnings.map((l) => `- ${l.content}`).join("\n")}
   const isScheduledRun = options.trigger === "scheduled" || options.trigger === "smart";
   const bridgeHasNoHistory = preflight.gates.cooldown?.elapsed_sec === null;
   if (isScheduledRun && (!preflight.gates.cooldown || bridgeHasNoHistory)) {
-    const defaultCooldownMs = 6 * 60 * 60 * 1e3;
-    const localCooldown = checkLocalCooldown(squadName, agentName, defaultCooldownMs);
+    const frontmatterForCooldown = parseAgentFrontmatter(agentPath);
+    const cooldownMs = frontmatterForCooldown.cooldown ? parseCooldown(frontmatterForCooldown.cooldown) || DEFAULT_SCHEDULED_COOLDOWN_MS : DEFAULT_SCHEDULED_COOLDOWN_MS;
+    const localCooldown = checkLocalCooldown(squadName, agentName, cooldownMs);
     if (!localCooldown.ok) {
       spinner.stop();
       writeLine();
@@ -3013,7 +3102,7 @@ ${learnings.map((l) => `- ${l.content}`).join("\n")}
 ${approvalInstructions}
 ` : "";
   const squadContext = gatherSquadContext(squadName, agentName, { verbose: options.verbose, agentPath });
-  const timeoutMins = options.timeout || 30;
+  const timeoutMins = options.timeout || DEFAULT_TIMEOUT_MINUTES;
   const prompt2 = `Execute the ${agentName} agent from squad ${squadName}.
 
 Read the agent definition at ${agentPath} and follow its instructions exactly.
@@ -3034,7 +3123,7 @@ ${squadContext}${learningContext}${approvalContext}
 TIME LIMIT: You have ${timeoutMins} minutes. Work efficiently:
 - Focus on the most important tasks first
 - If a task is taking too long, move on and note it for next run
-- Aim to complete within ${Math.floor(timeoutMins * 0.7)} minutes
+- Aim to complete within ${Math.floor(timeoutMins * SOFT_DEADLINE_RATIO)} minutes
 
 After completion:
 
@@ -3348,7 +3437,7 @@ async function executeWithClaude(prompt2, options) {
       SQUADS_TASK_TYPE: execContext.taskType,
       SQUADS_TRIGGER: execContext.trigger,
       SQUADS_EXECUTION_ID: execContext.executionId,
-      BRIDGE_API: process.env.SQUADS_BRIDGE_URL || "http://localhost:8088",
+      BRIDGE_API: process.env.SQUADS_BRIDGE_URL || DEFAULT_BRIDGE_URL,
       OTEL_RESOURCE_ATTRIBUTES: `squads.squad=${execContext.squad},squads.agent=${execContext.agent},squads.task_type=${execContext.taskType},squads.trigger=${execContext.trigger},squads.execution_id=${execContext.executionId}`,
       ...effort ? { CLAUDE_EFFORT: effort } : {},
       ...skills && skills.length > 0 ? { CLAUDE_SKILLS: skills.join(",") } : {}
@@ -3420,7 +3509,7 @@ async function executeWithClaude(prompt2, options) {
       SQUADS_TASK_TYPE: execContext.taskType,
       SQUADS_TRIGGER: execContext.trigger,
       SQUADS_EXECUTION_ID: execContext.executionId,
-      BRIDGE_API: process.env.SQUADS_BRIDGE_URL || "http://localhost:8088"
+      BRIDGE_API: process.env.SQUADS_BRIDGE_URL || DEFAULT_BRIDGE_URL
     };
     const modelFlag2 = claudeModelAlias ? `--model ${claudeModelAlias}` : "";
     const watchBranchName = `agent/${squadName}/${agentName}-${timestamp2}`;
@@ -3434,7 +3523,7 @@ async function executeWithClaude(prompt2, options) {
       env: watchEnv
     });
     child2.unref();
-    await new Promise((resolve) => setTimeout(resolve, 500));
+    await new Promise((resolve) => setTimeout(resolve, LOG_FILE_INIT_DELAY_MS));
     writeLine(`  ${colors.dim}Tailing log (Ctrl+C to stop watching, agent continues)...${RESET}`);
     writeLine();
     const tail = spawn2("tail", ["-f", logFile2], { stdio: "inherit" });
@@ -3485,7 +3574,7 @@ async function executeWithClaude(prompt2, options) {
     SQUADS_TASK_TYPE: execContext.taskType,
     SQUADS_TRIGGER: execContext.trigger,
     SQUADS_EXECUTION_ID: execContext.executionId,
-    BRIDGE_API: process.env.SQUADS_BRIDGE_URL || "http://localhost:8088",
+    BRIDGE_API: process.env.SQUADS_BRIDGE_URL || DEFAULT_BRIDGE_URL,
     OTEL_RESOURCE_ATTRIBUTES: `squads.squad=${execContext.squad},squads.agent=${execContext.agent},squads.task_type=${execContext.taskType},squads.trigger=${execContext.trigger},squads.execution_id=${execContext.executionId}`,
     ...effort ? { CLAUDE_EFFORT: effort } : {},
     ...skills && skills.length > 0 ? { CLAUDE_SKILLS: skills.join(",") } : {}
@@ -3538,7 +3627,7 @@ async function executeWithProvider(provider, prompt2, options) {
   }
   if (options.verbose) {
     writeLine(`  ${colors.dim}Provider: ${cliConfig.displayName}${RESET}`);
-    writeLine(`  ${colors.dim}Command: ${cliConfig.command} ${args.join(" ").slice(0, 50)}...${RESET}`);
+    writeLine(`  ${colors.dim}Command: ${cliConfig.command} ${args.join(" ").slice(0, VERBOSE_COMMAND_MAX_CHARS)}...${RESET}`);
     writeLine(`  ${colors.dim}CWD: ${workDir}${RESET}`);
     if (workDir !== projectRoot) {
       writeLine(`  ${colors.dim}Worktree: ${branchName}${RESET}`);
@@ -10018,74 +10107,6 @@ import {
 import { join as join17 } from "path";
 import { homedir as homedir6 } from "os";
 import { spawn as spawn3, execSync as execSync9 } from "child_process";
-
-// src/lib/cron.ts
-function cronMatches(cron, date) {
-  const parts = cron.trim().split(/\s+/);
-  if (parts.length < 5) return false;
-  const fields = [
-    { value: date.getMinutes(), field: parts[0], min: 0, max: 59 },
-    { value: date.getHours(), field: parts[1], min: 0, max: 23 },
-    { value: date.getDate(), field: parts[2], min: 1, max: 31 },
-    { value: date.getMonth() + 1, field: parts[3], min: 1, max: 12 },
-    { value: date.getDay(), field: parts[4], min: 0, max: 6 }
-  ];
-  return fields.every(
-    ({ value, field, min, max }) => fieldMatches(field, value, min, max)
-  );
-}
-function fieldMatches(field, value, min, max) {
-  if (field.includes(",")) {
-    return field.split(",").some((part) => fieldMatches(part.trim(), value, min, max));
-  }
-  if (field.includes("/")) {
-    const [range, stepStr] = field.split("/");
-    const step = parseInt(stepStr);
-    if (isNaN(step) || step <= 0) return false;
-    let start = min;
-    let end = max;
-    if (range !== "*") {
-      if (range.includes("-")) {
-        [start, end] = range.split("-").map(Number);
-      } else {
-        start = parseInt(range);
-      }
-    }
-    if (value < start || value > end) return false;
-    return (value - start) % step === 0;
-  }
-  if (field.includes("-")) {
-    const [start, end] = field.split("-").map(Number);
-    return value >= start && value <= end;
-  }
-  if (field === "*") return true;
-  return parseInt(field) === value;
-}
-function getNextCronRun(cron, after = /* @__PURE__ */ new Date()) {
-  const next = new Date(after);
-  next.setSeconds(0, 0);
-  next.setMinutes(next.getMinutes() + 1);
-  const maxIterations = 60 * 48;
-  for (let i = 0; i < maxIterations; i++) {
-    if (cronMatches(cron, next)) return next;
-    next.setMinutes(next.getMinutes() + 1);
-  }
-  const fallback = new Date(after);
-  fallback.setDate(fallback.getDate() + 1);
-  return fallback;
-}
-function parseCooldown(cooldown) {
-  const match = cooldown.match(/^(\d+)\s*(m|min|minutes?|h|hours?|d|days?)$/i);
-  if (!match) return 0;
-  const value = parseInt(match[1]);
-  const unit = match[2].toLowerCase();
-  if (unit.startsWith("m")) return value * 60 * 1e3;
-  if (unit.startsWith("h")) return value * 60 * 60 * 1e3;
-  if (unit.startsWith("d")) return value * 24 * 60 * 60 * 1e3;
-  return 0;
-}
-
-// src/commands/autonomous.ts
 var DAEMON_DIR = join17(homedir6(), ".squads");
 var PID_FILE = join17(DAEMON_DIR, "autonomous.pid");
 var DAEMON_LOG = join17(DAEMON_DIR, "autonomous.log");