@saga-ai/cli 2.16.0 → 2.17.1

package/dist/cli.cjs

@@ -26,11 +26,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/cli.ts
 var import_node_fs9 = require("node:fs");
 var import_node_path15 = require("node:path");
-var import_node_process10 = __toESM(require("node:process"), 1);
+var import_node_process11 = __toESM(require("node:process"), 1);
 var import_commander = require("commander");
 
 // src/commands/dashboard.ts
-var import_node_process3 = __toESM(require("node:process"), 1);
+var import_node_process4 = __toESM(require("node:process"), 1);
 
 // src/server/index.ts
 var import_node_http = require("node:http");
@@ -385,6 +385,7 @@ async function parseJournal(journalPath) {
         entries.push({
           timestamp,
           type: "session",
+          title: `Session ${timestamp}`,
           content: sectionContent
         });
       } else if (headerLine.toLowerCase().startsWith("blocker:")) {
@@ -393,9 +394,8 @@ async function parseJournal(journalPath) {
           timestamp: "",
           // Blockers may not have timestamps
           type: "blocker",
-          content: `${title}
-
-${sectionContent}`.trim()
+          title,
+          content: sectionContent
         });
       } else if (headerLine.toLowerCase().startsWith("resolution:")) {
         const title = headerLine.substring("resolution:".length).trim();
@@ -403,9 +403,8 @@ ${sectionContent}`.trim()
           timestamp: "",
           // Resolutions may not have timestamps
           type: "resolution",
-          content: `${title}
-
-${sectionContent}`.trim()
+          title,
+          content: sectionContent
         });
       }
     }
@@ -1199,12 +1198,16 @@ var LogStreamManager = class {
 // src/server/watcher.ts
 var import_node_events = require("node:events");
 var import_node_path6 = require("node:path");
+var import_node_process2 = __toESM(require("node:process"), 1);
 var import_chokidar2 = __toESM(require("chokidar"), 1);
 var MIN_PATH_PARTS = 4;
 var ARCHIVE_STORY_PARTS = 5;
 var EPIC_FILE_PARTS = 4;
 var STORY_FILE_PARTS = 6;
 var DEBOUNCE_DELAY_MS = 100;
+function shouldUsePolling() {
+  return import_node_process2.default.env.SAGA_USE_POLLING === "1";
+}
 function isStoryMarkdownFile(fileName) {
   return fileName === "story.md" || fileName === "journal.md";
 }
@@ -1327,17 +1330,18 @@ function createDebounceKey(parsed) {
 function createChokidarWatcher(sagaRoot) {
   const epicsDir = (0, import_node_path6.join)(sagaRoot, ".saga", "epics");
   const archiveDir = (0, import_node_path6.join)(sagaRoot, ".saga", "archive");
+  const usePolling = shouldUsePolling();
   return import_chokidar2.default.watch([epicsDir, archiveDir], {
     persistent: true,
     ignoreInitial: true,
-    usePolling: true,
-    interval: DEBOUNCE_DELAY_MS,
-    // Wait for writes to finish before emitting events - prevents missing
-    // rapid file changes when polling
-    awaitWriteFinish: {
+    // Use polling for tests (reliable) or native watching for production (fast)
+    usePolling,
+    interval: usePolling ? DEBOUNCE_DELAY_MS : void 0,
+    // Wait for writes to finish when polling
+    awaitWriteFinish: usePolling ? {
       stabilityThreshold: 50,
       pollInterval: 50
-    }
+    } : false
   });
 }
 async function createSagaWatcher(sagaRoot) {
@@ -1734,9 +1738,9 @@ async function startServer(config) {
 // src/utils/project-discovery.ts
 var import_node_fs4 = require("node:fs");
 var import_node_path9 = require("node:path");
-var import_node_process2 = __toESM(require("node:process"), 1);
+var import_node_process3 = __toESM(require("node:process"), 1);
 function findProjectRoot(startDir) {
-  let currentDir = startDir ?? import_node_process2.default.cwd();
+  let currentDir = startDir ?? import_node_process3.default.cwd();
   while (true) {
     const sagaDir = (0, import_node_path9.join)(currentDir, ".saga");
     if ((0, import_node_fs4.existsSync)(sagaDir)) {
@@ -1776,7 +1780,7 @@ async function dashboardCommand(options) {
     projectPath = resolveProjectPath(options.path);
   } catch (error) {
     console.error(error instanceof Error ? error.message : "Failed to resolve SAGA project path");
-    import_node_process3.default.exit(1);
+    import_node_process4.default.exit(1);
   }
   try {
     const server = await startServer({
@@ -1785,21 +1789,21 @@ async function dashboardCommand(options) {
     });
     console.log(`SAGA Dashboard server running on http://localhost:${server.port}`);
     console.log(`Project: ${projectPath}`);
-    import_node_process3.default.on("SIGINT", async () => {
+    import_node_process4.default.on("SIGINT", async () => {
       await server.close();
-      import_node_process3.default.exit(0);
+      import_node_process4.default.exit(0);
     });
-    import_node_process3.default.on("SIGTERM", async () => {
+    import_node_process4.default.on("SIGTERM", async () => {
       await server.close();
-      import_node_process3.default.exit(0);
+      import_node_process4.default.exit(0);
     });
   } catch (_error) {
-    import_node_process3.default.exit(1);
+    import_node_process4.default.exit(1);
   }
 }
 
 // src/commands/find.ts
-var import_node_process4 = __toESM(require("node:process"), 1);
+var import_node_process5 = __toESM(require("node:process"), 1);
 
 // src/utils/finder.ts
 var import_node_fs5 = require("node:fs");
@@ -1959,7 +1963,7 @@ async function findCommand(query, options) {
   try {
     projectPath = resolveProjectPath(options.path);
   } catch (_error) {
-    import_node_process4.default.exit(1);
+    import_node_process5.default.exit(1);
   }
   const type = options.type ?? "story";
   let result;
@@ -1970,7 +1974,7 @@ async function findCommand(query, options) {
   }
   console.log(JSON.stringify(result, null, 2));
   if (!result.found) {
-    import_node_process4.default.exit(1);
+    import_node_process5.default.exit(1);
   }
 }
 
@@ -1978,7 +1982,7 @@ async function findCommand(query, options) {
 var import_node_child_process2 = require("node:child_process");
 var import_node_fs6 = require("node:fs");
 var import_node_path11 = require("node:path");
-var import_node_process5 = __toESM(require("node:process"), 1);
+var import_node_process6 = __toESM(require("node:process"), 1);
 var DEFAULT_MAX_CYCLES = 10;
 var DEFAULT_MAX_TIME = 60;
 var DEFAULT_MODEL = "opus";
@@ -2194,17 +2198,144 @@ function buildScopeSettings() {
     }
   };
 }
+function truncateString(str, maxLength) {
+  if (str.length <= maxLength) {
+    return str;
+  }
+  return `${str.slice(0, maxLength)}...`;
+}
+function formatInputValue(value, maxLength) {
+  if (value === null || value === void 0) {
+    return "null";
+  }
+  if (typeof value === "string") {
+    const singleLine = value.replace(/\n/g, " ").replace(/\s+/g, " ");
+    return truncateString(singleLine, maxLength);
+  }
+  if (typeof value === "boolean" || typeof value === "number") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    return truncateString(JSON.stringify(value), maxLength);
+  }
+  if (typeof value === "object") {
+    return truncateString(JSON.stringify(value), maxLength);
+  }
+  return String(value);
+}
+function formatAllInputFields(input) {
+  const maxValueLength = 100;
+  const entries = Object.entries(input);
+  if (entries.length === 0) {
+    return "";
+  }
+  return entries.map(([key, value]) => `${key}=${formatInputValue(value, maxValueLength)}`).join(", ");
+}
+function formatToolUsage(name, input) {
+  try {
+    const safeInput = input || {};
+    const maxLength = 100;
+    switch (name) {
+      // File operations - show path
+      case "Read": {
+        const path = safeInput.file_path || "unknown";
+        const extras = [];
+        if (safeInput.offset) {
+          extras.push(`offset=${safeInput.offset}`);
+        }
+        if (safeInput.limit) {
+          extras.push(`limit=${safeInput.limit}`);
+        }
+        const suffix = extras.length > 0 ? ` (${extras.join(", ")})` : "";
+        return `[Tool Used: Read] ${path}${suffix}`;
+      }
+      case "Write":
+        return `[Tool Used: Write] ${safeInput.file_path || "unknown"}`;
+      case "Edit": {
+        const file = safeInput.file_path || "unknown";
+        const replaceAll = safeInput.replace_all ? " (replace_all)" : "";
+        return `[Tool Used: Edit] ${file}${replaceAll}`;
+      }
+      // Shell command - show command and description
+      case "Bash": {
+        const cmd = truncateString(String(safeInput.command || ""), maxLength);
+        const desc = safeInput.description ? ` - ${truncateString(String(safeInput.description), 60)}` : "";
+        return `[Tool Used: Bash] ${cmd}${desc}`;
+      }
+      // Search operations - show pattern and path
+      case "Glob": {
+        const pattern = safeInput.pattern || "unknown";
+        const path = safeInput.path ? ` in ${safeInput.path}` : "";
+        return `[Tool Used: Glob] ${pattern}${path}`;
+      }
+      case "Grep": {
+        const pattern = truncateString(String(safeInput.pattern || ""), 60);
+        const path = safeInput.path ? ` in ${safeInput.path}` : "";
+        const mode = safeInput.output_mode ? ` (${safeInput.output_mode})` : "";
+        return `[Tool Used: Grep] "${pattern}"${path}${mode}`;
+      }
+      // Agent task - show description and type
+      case "Task": {
+        const desc = truncateString(
+          String(safeInput.description || safeInput.prompt || ""),
+          maxLength
+        );
+        const agentType = safeInput.subagent_type ? ` [${safeInput.subagent_type}]` : "";
+        return `[Tool Used: Task]${agentType} ${desc}`;
+      }
+      // Todo operations
+      case "TodoWrite": {
+        const todos = safeInput.todos;
+        if (todos && Array.isArray(todos)) {
+          const subjects = todos.map((t) => {
+            if (t && typeof t === "object" && "subject" in t) {
+              return String(t.subject || "untitled");
+            }
+            return "untitled";
+          }).join(", ");
+          return `[Tool Used: TodoWrite] ${truncateString(subjects, maxLength)}`;
+        }
+        return "[Tool Used: TodoWrite]";
+      }
+      // Structured output - show status
+      case "StructuredOutput": {
+        const status = safeInput.status || "unknown";
+        const summary = safeInput.summary ? ` - ${truncateString(String(safeInput.summary), maxLength)}` : "";
+        return `[Tool Used: StructuredOutput] ${status}${summary}`;
+      }
+      // Unknown tools - show all fields
+      default: {
+        const fields = formatAllInputFields(safeInput);
+        return fields ? `[Tool Used: ${name}] ${fields}` : `[Tool Used: ${name}]`;
+      }
+    }
+  } catch {
+    return `[Tool Used: ${name}]`;
+  }
+}
 function formatAssistantContent(content) {
-  for (const block of content) {
-    const blockData = block;
-    if (blockData.type === "text" && blockData.text) {
-      return blockData.text;
+  try {
+    if (!(content && Array.isArray(content))) {
+      return null;
     }
-    if (blockData.type === "tool_use") {
-      return `[Tool: ${blockData.name}]`;
+    for (const block of content) {
+      if (!block || typeof block !== "object") {
+        continue;
+      }
+      const blockData = block;
+      if (blockData.type === "text" && blockData.text) {
+        return `${blockData.text}
+`;
+      }
+      if (blockData.type === "tool_use" && blockData.name) {
+        return `${formatToolUsage(blockData.name, blockData.input || {})}
+`;
+      }
     }
+    return null;
+  } catch {
+    return null;
   }
-  return null;
 }
 function formatStreamLine(line) {
   try {
@@ -2309,19 +2440,19 @@ function spawnWorkerAsync(prompt, model, settings, workingDir) {
         if (line.trim()) {
           const formatted = formatStreamLine(line);
           if (formatted) {
-            import_node_process5.default.stdout.write(formatted);
+            import_node_process6.default.stdout.write(formatted);
           }
         }
       }
     });
     child.stderr.on("data", (chunk) => {
-      import_node_process5.default.stderr.write(chunk);
+      import_node_process6.default.stderr.write(chunk);
     });
     child.on("error", (err) => {
       reject(new Error(`Failed to spawn worker: ${err.message}`));
     });
     child.on("close", (_code) => {
-      import_node_process5.default.stdout.write("\n");
+      import_node_process6.default.stdout.write("\n");
       try {
         const result = parseStreamingResult(buffer);
         resolve2(result);
@@ -2485,7 +2616,7 @@ function buildDetachedCommand(storySlug, projectPath, options) {
 function handleDryRun(storyInfo, projectPath, pluginRoot) {
   const dryRunResult = runDryRun(storyInfo, projectPath, pluginRoot);
   printDryRunResults(dryRunResult);
-  import_node_process5.default.exit(dryRunResult.success ? 0 : 1);
+  import_node_process6.default.exit(dryRunResult.success ? 0 : 1);
 }
 async function handleDetachedMode(storySlug, storyInfo, projectPath, options) {
   const detachedCommand = buildDetachedCommand(storySlug, projectPath, {
@@ -2504,7 +2635,7 @@ async function handleDetachedMode(storySlug, storyInfo, projectPath, options) {
     console.error(
       `Error creating session: ${error instanceof Error ? error.message : String(error)}`
     );
-    import_node_process5.default.exit(1);
+    import_node_process6.default.exit(1);
   }
 }
 async function handleInternalSession(storyInfo, projectPath, pluginRoot, options) {
@@ -2526,7 +2657,7 @@ async function handleInternalSession(storyInfo, projectPath, pluginRoot, options
   );
   if (result.status === "ERROR") {
     console.error(`Error: ${result.summary}`);
-    import_node_process5.default.exit(1);
+    import_node_process6.default.exit(1);
   }
   console.log(`
 Implementation ${result.status}: ${result.summary}`);
@@ -2537,28 +2668,28 @@ async function implementCommand(storySlug, options) {
     projectPath = resolveProjectPath(options.path);
   } catch (_error) {
     console.error("Error: SAGA project not found. Run saga init first or use --path option.");
-    import_node_process5.default.exit(1);
+    import_node_process6.default.exit(1);
   }
   const storyInfo = await findStory2(projectPath, storySlug);
   if (!storyInfo) {
     console.error(`Error: Story '${storySlug}' not found in project.`);
     console.error("Use /generate-stories to create stories for an epic first.");
-    import_node_process5.default.exit(1);
+    import_node_process6.default.exit(1);
   }
-  const pluginRoot = import_node_process5.default.env.SAGA_PLUGIN_ROOT;
+  const pluginRoot = import_node_process6.default.env.SAGA_PLUGIN_ROOT;
   if (options.dryRun) {
     handleDryRun(storyInfo, projectPath, pluginRoot);
   }
   if (!pluginRoot) {
     console.error("Error: SAGA_PLUGIN_ROOT environment variable is not set.");
     console.error("This is required to find the worker prompt template.");
-    import_node_process5.default.exit(1);
+    import_node_process6.default.exit(1);
   }
   if (!(0, import_node_fs6.existsSync)(storyInfo.worktreePath)) {
     console.error(`Error: Worktree not found at ${storyInfo.worktreePath}`);
-    import_node_process5.default.exit(1);
+    import_node_process6.default.exit(1);
   }
-  const isInternalSession = import_node_process5.default.env.SAGA_INTERNAL_SESSION === "1";
+  const isInternalSession = import_node_process6.default.env.SAGA_INTERNAL_SESSION === "1";
   if (isInternalSession) {
     await handleInternalSession(storyInfo, projectPath, pluginRoot, options);
   } else {
@@ -2569,7 +2700,7 @@ async function implementCommand(storySlug, options) {
 // src/commands/init.ts
 var import_node_fs7 = require("node:fs");
 var import_node_path12 = require("node:path");
-var import_node_process6 = __toESM(require("node:process"), 1);
+var import_node_process7 = __toESM(require("node:process"), 1);
 var WORKTREES_PATTERN = ".saga/worktrees/";
 function runInitDryRun(targetPath) {
   const sagaDir = (0, import_node_path12.join)(targetPath, ".saga");
@@ -2633,7 +2764,7 @@ function resolveTargetPath(explicitPath) {
   if (existingRoot) {
     return existingRoot;
   }
-  return import_node_process6.default.cwd();
+  return import_node_process7.default.cwd();
 }
 function createDirectoryStructure(projectRoot) {
   const sagaDir = (0, import_node_path12.join)(projectRoot, ".saga");
@@ -2668,11 +2799,11 @@ function initCommand(options) {
   if (options.path) {
     if (!(0, import_node_fs7.existsSync)(options.path)) {
       console.error(`Error: Path does not exist: ${options.path}`);
-      import_node_process6.default.exit(1);
+      import_node_process7.default.exit(1);
     }
     if (!(0, import_node_fs7.statSync)(options.path).isDirectory()) {
       console.error(`Error: Path is not a directory: ${options.path}`);
-      import_node_process6.default.exit(1);
+      import_node_process7.default.exit(1);
     }
   }
   const targetPath = resolveTargetPath(options.path);
@@ -2688,7 +2819,7 @@ function initCommand(options) {
 
 // src/commands/scope-validator.ts
 var import_node_path13 = require("node:path");
-var import_node_process7 = __toESM(require("node:process"), 1);
+var import_node_process8 = __toESM(require("node:process"), 1);
 var FILE_PATH_WIDTH = 50;
 var EPIC_STORY_WIDTH = 43;
 var REASON_WIDTH = 56;
@@ -2757,19 +2888,19 @@ function printScopeViolation(filePath, epicSlug, storySlug, worktreePath, reason
     "\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256F",
     ""
   ].join("\n");
-  import_node_process7.default.stderr.write(message);
+  import_node_process8.default.stderr.write(message);
 }
 async function readStdinInput() {
   const chunks = [];
-  for await (const chunk of import_node_process7.default.stdin) {
+  for await (const chunk of import_node_process8.default.stdin) {
     chunks.push(chunk);
   }
   return Buffer.concat(chunks).toString("utf-8");
 }
 function getScopeEnvironment() {
-  const worktreePath = import_node_process7.default.env.SAGA_PROJECT_DIR || "";
-  const epicSlug = import_node_process7.default.env.SAGA_EPIC_SLUG || "";
-  const storySlug = import_node_process7.default.env.SAGA_STORY_SLUG || "";
+  const worktreePath = import_node_process8.default.env.SAGA_PROJECT_DIR || "";
+  const epicSlug = import_node_process8.default.env.SAGA_EPIC_SLUG || "";
+  const storySlug = import_node_process8.default.env.SAGA_STORY_SLUG || "";
   if (!(worktreePath && epicSlug && storySlug)) {
     return null;
   }
@@ -2791,23 +2922,23 @@ function validatePath(filePath, worktreePath, epicSlug, storySlug) {
 async function scopeValidatorCommand() {
   const env = getScopeEnvironment();
   if (!env) {
-    import_node_process7.default.exit(2);
+    import_node_process8.default.exit(2);
   }
   const toolInput = await readStdinInput();
   const filePath = getFilePathFromInput(toolInput);
   if (!filePath) {
-    import_node_process7.default.exit(0);
+    import_node_process8.default.exit(0);
   }
   const violation = validatePath(filePath, env.worktreePath, env.epicSlug, env.storySlug);
   if (violation) {
     printScopeViolation(filePath, env.epicSlug, env.storySlug, env.worktreePath, violation);
-    import_node_process7.default.exit(2);
+    import_node_process8.default.exit(2);
   }
-  import_node_process7.default.exit(0);
+  import_node_process8.default.exit(0);
 }
 
 // src/commands/sessions/index.ts
-var import_node_process8 = __toESM(require("node:process"), 1);
+var import_node_process9 = __toESM(require("node:process"), 1);
 async function sessionsListCommand() {
   const sessions = await listSessions();
   console.log(JSON.stringify(sessions, null, 2));
@@ -2821,7 +2952,7 @@ async function sessionsLogsCommand(sessionName) {
     await streamLogs(sessionName);
   } catch (error) {
     console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
-    import_node_process8.default.exit(1);
+    import_node_process9.default.exit(1);
   }
 }
 async function sessionsKillCommand(sessionName) {
@@ -2833,7 +2964,7 @@ async function sessionsKillCommand(sessionName) {
 var import_node_child_process3 = require("node:child_process");
 var import_node_fs8 = require("node:fs");
 var import_node_path14 = require("node:path");
-var import_node_process9 = __toESM(require("node:process"), 1);
+var import_node_process10 = __toESM(require("node:process"), 1);
 function runGitCommand(args, cwd) {
   try {
     const output = (0, import_node_child_process3.execSync)(`git ${args.join(" ")}`, {
@@ -2914,12 +3045,12 @@ function worktreeCommand(epicSlug, storySlug, options) {
       error: error instanceof Error ? error.message : String(error)
     };
     console.log(JSON.stringify(result2, null, 2));
-    import_node_process9.default.exit(1);
+    import_node_process10.default.exit(1);
   }
   const result = createWorktree(projectPath, epicSlug, storySlug);
   console.log(JSON.stringify(result, null, 2));
   if (!result.success) {
-    import_node_process9.default.exit(1);
+    import_node_process10.default.exit(1);
   }
 }
 
@@ -2982,6 +3113,6 @@ sessionsCommand.command("kill <name>").description("Terminate a session").action
 });
 program.on("command:*", (operands) => {
   console.error(`error: unknown command '${operands[0]}'`);
-  import_node_process10.default.exit(1);
+  import_node_process11.default.exit(1);
 });
 program.parse();