automata-cli 0.4.0-develop.124 → 0.4.0-develop.142

package/README.md

@@ -99,6 +99,20 @@ See [docs/implement-next.md](docs/implement-next.md) for full details.
 
 ---
 
+## `automata execute`
+
+Delegate work to an AI executor (Claude or Codex) by providing a prompt inline, from a file, or via stdin.
+
+```bash
+automata execute --with claude --prompt "refactor the auth module"
+automata execute --with codex  --file-prompt prompts/fix.md
+echo "fix lint errors" | automata execute --with claude
+```
+
+See [docs/execute.md](docs/execute.md) for full details.
+
+---
+
 ## Development
 
 ### Prerequisites

package/dist/index.js

@@ -557,6 +557,14 @@ function extractSonarProjectKey(url) {
     return null;
   }
 }
+function buildSonarPullRequestUrl(projectKey, prNumber) {
+  return `https://sonarcloud.io/summary/new_code?id=${encodeURIComponent(projectKey)}&pullRequest=${String(prNumber)}`;
+}
+function resolveSonarPullRequestUrl(url, prNumber) {
+  const projectKey = extractSonarProjectKey(url);
+  if (!projectKey) return url;
+  return buildSonarPullRequestUrl(projectKey, prNumber);
+}
 function isSonarUrl(url) {
   try {
     const hostname = new URL(url).hostname;
@@ -671,13 +679,28 @@ async function fetchSonarJson(apiUrl) {
     clearTimeout(timeoutId);
   }
 }
-async function fetchSonarNewIssues(projectKey, prNumber) {
+async function fetchSonarNewIssues(projectKey, prNumber, sonarcloudUrl) {
   const apiUrl = `https://sonarcloud.io/api/issues/search?componentKeys=${encodeURIComponent(projectKey)}&pullRequest=${String(prNumber)}&resolved=false&ps=1`;
   const response = await fetchSonarJson(apiUrl);
   if (!response.ok) {
-    return null;
+    if (response.status === 401) {
+      return {
+        total: null,
+        note: `SonarCloud project is private. Open the Sonar URL in an authenticated browser: ${sonarcloudUrl}`
+      };
+    }
+    return {
+      total: null,
+      note: "SonarCloud new-issue count is unavailable right now."
+    };
   }
-  return response.data.paging?.total ?? null;
+  if (typeof response.data.paging?.total === "number") {
+    return { total: response.data.paging.total };
+  }
+  return {
+    total: null,
+    note: "SonarCloud did not return a new-issue count for this pull request."
+  };
 }
 async function fetchSonarGateViolations(projectKey, prNumber) {
   const apiUrl = `https://sonarcloud.io/api/qualitygates/project_status?projectKey=${encodeURIComponent(projectKey)}&pullRequest=${String(prNumber)}`;
@@ -793,19 +816,22 @@ async function fetchSonarFailureSummary(projectKey, prNumber, sonarcloudUrl) {
   if (!gateResult.ok && gateResult.status === 401) {
     return {
       summary: sonarPrivateFailureSummary(sonarcloudUrl),
-      issueTotal: null
+      issueTotal: null,
+      issueNote: `SonarCloud project is private. Open the Sonar URL in an authenticated browser: ${sonarcloudUrl}`
     };
   }
   if (!issuesResult.ok && issuesResult.status === 401) {
     return {
       summary: sonarPrivateFailureSummary(sonarcloudUrl),
-      issueTotal: null
+      issueTotal: null,
+      issueNote: `SonarCloud project is private. Open the Sonar URL in an authenticated browser: ${sonarcloudUrl}`
     };
   }
   if (!hotspotsResult.ok && hotspotsResult.status === 401) {
     return {
       summary: sonarPrivateFailureSummary(sonarcloudUrl),
-      issueTotal: null
+      issueTotal: null,
+      issueNote: `SonarCloud project is private. Open the Sonar URL in an authenticated browser: ${sonarcloudUrl}`
     };
   }
   const gateViolations = gateResult.ok ? gateResult.data.gateViolations : [];
@@ -813,6 +839,7 @@ async function fetchSonarFailureSummary(projectKey, prNumber, sonarcloudUrl) {
   const securityHotspots = hotspotsResult.ok ? hotspotsResult.data : [];
   const qualityGateStatus = gateResult.ok ? gateResult.data.qualityGateStatus : void 0;
   const issueTotal = issuesResult.ok ? issuesResult.data.total : null;
+  const issueNote = issuesResult.ok ? void 0 : "SonarCloud new-issue count is unavailable right now.";
   if (gateViolations.length === 0 && issues.length === 0 && securityHotspots.length === 0 && !qualityGateStatus) {
     return {
       summary: {
@@ -822,7 +849,8 @@ async function fetchSonarFailureSummary(projectKey, prNumber, sonarcloudUrl) {
         securityHotspots: [],
         unavailableMessage: "SonarCloud failure details are unavailable right now."
       },
-      issueTotal
+      issueTotal,
+      issueNote
     };
   }
   return {
@@ -833,7 +861,8 @@ async function fetchSonarFailureSummary(projectKey, prNumber, sonarcloudUrl) {
       issues,
       securityHotspots
     },
-    issueTotal
+    issueTotal,
+    issueNote
   };
 }
 async function getPrInfoGh(branch) {
@@ -851,12 +880,16 @@ async function getPrInfoGh(branch) {
     throw new Error(stderr.trim() || "Failed to query GitHub. Is `gh` installed and authenticated?");
   }
   const raw = JSON.parse(stdout);
-  const failedChecks = (raw.statusCheckRollup ?? []).filter(
+  const statusChecks = raw.statusCheckRollup ?? [];
+  const failedChecks = statusChecks.filter(
     (c) => c.conclusion !== null && ["FAILURE", "TIMED_OUT", "ACTION_REQUIRED", "CANCELLED"].includes(c.conclusion)
   );
-  const ownerRepo = failedChecks.length > 0 ? parseOwnerRepo() : null;
+  const sonarNeedsCheckRunOutput = statusChecks.some(
+    (c) => (isSonarUrl(c.detailsUrl) || c.name.toLowerCase().includes("sonar")) && !extractSonarProjectKey(c.detailsUrl)
+  );
+  const ownerRepo = failedChecks.length > 0 || sonarNeedsCheckRunOutput ? parseOwnerRepo() : null;
   const checkOutputs = ownerRepo ? fetchCheckRunOutputs(ownerRepo, raw.headRefOid) : /* @__PURE__ */ new Map();
-  const checks = (raw.statusCheckRollup ?? []).map((c) => {
+  const checks = statusChecks.map((c) => {
     const enriched = checkOutputs.get(c.name);
     return {
       name: c.name,
@@ -869,20 +902,25 @@ async function getPrInfoGh(branch) {
   const sonarCheck = checks.find((c) => isSonarUrl(c.detailsUrl));
   let sonarcloudUrl;
   let sonarNewIssues;
+  let sonarNewIssuesNote;
   let sonarFailures;
   if (sonarCheck) {
-    sonarcloudUrl = sonarCheck.detailsUrl;
-    const projectKey = extractSonarProjectKey(sonarCheck.detailsUrl);
+    sonarcloudUrl = resolveSonarPullRequestUrl(sonarCheck.detailsUrl, raw.number);
+    const projectKey = extractSonarProjectKey(sonarcloudUrl);
     if (projectKey) {
       if (sonarCheck.conclusion !== null && SONAR_FAIL_CONCLUSIONS.has(sonarCheck.conclusion)) {
         const sonarSummary = await fetchSonarFailureSummary(projectKey, raw.number, sonarcloudUrl);
         sonarFailures = sonarSummary.summary;
         sonarNewIssues = sonarSummary.issueTotal;
+        sonarNewIssuesNote = sonarSummary.issueNote;
       } else {
-        sonarNewIssues = await fetchSonarNewIssues(projectKey, raw.number);
+        const sonarNewIssuesResult = await fetchSonarNewIssues(projectKey, raw.number, sonarcloudUrl);
+        sonarNewIssues = sonarNewIssuesResult.total;
+        sonarNewIssuesNote = sonarNewIssuesResult.note;
       }
     } else {
       sonarNewIssues = null;
+      sonarNewIssuesNote = "Could not determine the SonarCloud project key from the check URL.";
     }
   }
   return {
@@ -891,7 +929,7 @@ async function getPrInfoGh(branch) {
     state: raw.state,
     url: raw.url,
     checks,
-    ...sonarcloudUrl === void 0 ? {} : { sonarcloudUrl, sonarNewIssues },
+    ...sonarcloudUrl === void 0 ? {} : { sonarcloudUrl, sonarNewIssues, sonarNewIssuesNote },
     ...sonarFailures === void 0 ? {} : { sonarFailures }
   };
 }
@@ -1221,6 +1259,12 @@ function formatSonarFailures(sonarFailures, sonarcloudUrl) {
   }
   return lines.join("\n") + "\n";
 }
+function sonarFailureNote(sonarFailures) {
+  if (!sonarFailures) return void 0;
+  if (sonarFailures.status === "private") return sonarFailures.privateMessage;
+  if (sonarFailures.status === "unavailable") return sonarFailures.unavailableMessage;
+  return void 0;
+}
 var POLL_INTERVAL_MS = 1e4;
 var getPrInfoCmd = new Command2("get-pr-info").description("Show pull request info for the current branch").option("--json", "Output as JSON").option("--wait-finish-checks", "Poll until all checks complete, then print the normal get-pr-info output").addHelpText(
   "after",
@@ -1290,6 +1334,11 @@ URL:   ${pr.url}
       const issueStr = pr.sonarNewIssues === null || pr.sonarNewIssues === void 0 ? "unavailable" : String(pr.sonarNewIssues);
       process.stdout.write(`Sonar New Issues: ${issueStr}
 `);
+      const failureNote = sonarFailureNote(pr.sonarFailures);
+      if (pr.sonarNewIssuesNote && pr.sonarNewIssuesNote !== failureNote) {
+        process.stdout.write(`Sonar Note: ${sanitizeText(pr.sonarNewIssuesNote)}
+`);
+      }
     }
     process.stdout.write(formatCheckSummary(pr.checks));
     process.stdout.write(formatChecks(pr.checks));
@@ -1737,12 +1786,13 @@ function invokeCodexCode(prompt, options = {}) {
   if (options.verbose) {
     process.stderr.write("Warning: --verbose is not supported for Codex and will be ignored.\n");
   }
-  invokeCodexCodeSync(prompt, options.yolo ?? false);
+  invokeCodexCodeSync(prompt, options.yolo ?? false, options.model);
 }
-function invokeCodexCodeSync(prompt, yolo) {
+function invokeCodexCodeSync(prompt, yolo, model) {
   const codexBin = resolveCommand("codex");
   const args = ["exec"];
   if (yolo) args.push("--dangerously-bypass-approvals-and-sandbox");
+  if (model) args.push("--model", model);
   args.push(prompt);
   const result = spawnSync5(codexBin, args, { encoding: "utf8", stdio: "inherit" });
   handleSpawnError(result.error, "codex");
@@ -1829,7 +1879,7 @@ Title:  ${issue.title}
   }
   return issue;
 }
-var implementNextCommand = new Command3("implement-next").description("Find the next open GitHub issue matching the configured filter, claim it, and invoke the AI code assistant (Claude or Codex)").option("--json", "Output issue details as JSON").option("--no-claude", "Skip all AI invocation (Claude or Codex) after claiming the issue").option("--codex", "Use Codex CLI instead of Claude Code").option("--query-only", "Print issue content and exit without claiming or invoking any AI tools").option("--yolo", "Launch with --dangerously-skip-permissions (Claude) or --dangerously-bypass-approvals-and-sandbox (Codex)").option("--verbose", "Show step-by-step progress summary and final result").option("--opus", "Use claude-opus-4-6").option("--sonnet", "Use claude-sonnet-4-6").option("--haiku", "Use claude-haiku-4-5-20251001").option("--take-first", "When multiple issues match, pick the first without prompting").option("--limit <n>", "Max issues to fetch and display (default: 10)", "10").action(async (options) => {
+var implementNextCommand = new Command3("implement-next").description("Find the next open GitHub issue matching the configured filter, claim it, and invoke the AI code assistant (Claude or Codex)").option("--json", "Output issue details as JSON").option("--no-claude", "Skip all AI invocation (Claude or Codex) after claiming the issue").option("--with <executor>", "Executor to use: claude or codex", "claude").option("--query-only", "Print issue content and exit without claiming or invoking any AI tools").option("--yolo", "Launch with --dangerously-skip-permissions (Claude) or --dangerously-bypass-approvals-and-sandbox (Codex)").option("--silent", "Suppress step-by-step Claude output; show only the final summary").option("--model <string>", "Model identifier to pass to the executor").option("--take-first", "When multiple issues match, pick the first without prompting").option("--limit <n>", "Max issues to fetch and display (default: 10)", "10").action(async (options) => {
   const config = readConfig();
   validateConfig(config);
   const limit = Number.parseInt(options.limit, 10);
@@ -1858,6 +1908,16 @@ ${issue.body}
   if (options.queryOnly) {
     process.exit(0);
   }
+  let executor;
+  if (options.claude !== false) {
+    const requestedExecutor = options.with.toLowerCase();
+    if (requestedExecutor !== "claude" && requestedExecutor !== "codex") {
+      process.stderr.write(`Error: --with must be 'claude' or 'codex', got '${options.with}'.
+`);
+      process.exit(1);
+    }
+    executor = requestedExecutor;
+  }
   try {
     postComment(issue.number, "working");
   } catch (err) {
@@ -1872,25 +1932,73 @@ ${issue.body}
 ${systemPrompt}
 
 ${issue.body}`;
-    if (options.codex) {
-      await invokeCodexCode(prompt, { yolo: options.yolo, verbose: options.verbose });
+    if (executor === "codex") {
+      if (options.silent) {
+        process.stderr.write("Warning: --silent is only supported with Claude and has no effect when used with Codex.\n");
+      }
+      invokeCodexCode(prompt, { yolo: options.yolo, model: options.model });
     } else {
-      const model = resolveModelOption(options);
-      await invokeClaudeCode(prompt, { yolo: options.yolo, verbose: options.verbose, model });
+      await invokeClaudeCode(prompt, { yolo: options.yolo, verbose: !options.silent, model: options.model });
     }
   }
 });
 
-// src/commands/test.ts
+// src/commands/execute.ts
+import { readFileSync as readFileSync3 } from "fs";
 import { Command as Command4 } from "commander";
-var testClaudeCmd = new Command4("claude").description("Test Claude Code invocation with a user-supplied prompt").requiredOption("--prompt <string>", "Prompt to send to Claude Code").option("--yolo", "Launch Claude Code with --dangerously-skip-permissions").option("--verbose", "Show step-by-step progress summary and final result").option("--opus", "Use claude-opus-4-6").option("--sonnet", "Use claude-sonnet-4-6").option("--haiku", "Use claude-haiku-4-5-20251001").action(async (options) => {
-  const model = resolveModelOption(options);
-  await invokeClaudeCode(options.prompt, { yolo: options.yolo, verbose: options.verbose, model });
-});
-var testCodexCmd = new Command4("codex").description("Test Codex CLI invocation with a user-supplied prompt").requiredOption("--prompt <string>", "Prompt to send to Codex CLI").option("--yolo", "Launch Codex with --dangerously-bypass-approvals-and-sandbox").option("--verbose", "Not supported for Codex; prints a warning and is otherwise ignored").action((options) => {
-  invokeCodexCode(options.prompt, { yolo: options.yolo, verbose: options.verbose });
+function readStdin() {
+  return new Promise((resolve3, reject) => {
+    const chunks = [];
+    process.stdin.on("data", (chunk) => chunks.push(chunk));
+    process.stdin.on("end", () => resolve3(Buffer.concat(chunks).toString("utf8")));
+    process.stdin.on("error", reject);
+  });
+}
+async function resolvePrompt(options) {
+  const hasCli = options.prompt !== void 0;
+  const hasFile = options.filePrompt !== void 0;
+  if (hasCli && hasFile) {
+    process.stderr.write("Error: --prompt is mutually exclusive with --file-prompt.\n");
+    process.exit(1);
+  }
+  if (hasCli) {
+    return options.prompt;
+  }
+  if (hasFile) {
+    const path = options.filePrompt;
+    try {
+      return readFileSync3(path, "utf8");
+    } catch {
+      process.stderr.write(`Error: Cannot read file: ${path}
+`);
+      process.exit(1);
+    }
+  }
+  if (!process.stdin.isTTY) {
+    const content = await readStdin();
+    if (content.trim().length === 0) {
+      process.stderr.write("Error: No prompt provided. Use --prompt, --file-prompt, or pipe via stdin.\n");
+      process.exit(1);
+    }
+    return content;
+  }
+  process.stderr.write("Error: No prompt provided. Use --prompt, --file-prompt, or pipe via stdin.\n");
+  process.exit(1);
+}
+var executeCommand = new Command4("execute").description("Delegate work to an AI executor").requiredOption("--with <executor>", "Executor to use: claude or codex").option("--prompt <string>", "Prompt to send to the executor").option("--file-prompt <path>", "Path to a file whose content is used as the prompt").option("--silent", "Suppress step-by-step Claude output; show only the final summary").option("--model <string>", "Model identifier to pass to the executor").action(async (options) => {
+  const executor = options.with.toLowerCase();
+  if (executor !== "claude" && executor !== "codex") {
+    process.stderr.write(`Error: --with must be 'claude' or 'codex', got '${options.with}'.
+`);
+    process.exit(1);
+  }
+  const prompt = await resolvePrompt(options);
+  if (executor === "codex") {
+    invokeCodexCode(prompt, { yolo: true, model: options.model });
+  } else {
+    await invokeClaudeCode(prompt, { yolo: true, verbose: !options.silent, model: options.model });
+  }
 });
-var testCommand = new Command4("test").description("Test commands for verifying automata integrations").addCommand(testClaudeCmd).addCommand(testCodexCmd);
 
 // src/commands/executePrompt.ts
 import { Command as Command5 } from "commander";
@@ -2020,7 +2128,7 @@ program.name("automata").description("Automata CLI tool").version(version, "-v,
 program.addCommand(configCommand);
 program.addCommand(gitCommand);
 program.addCommand(implementNextCommand);
-program.addCommand(testCommand);
+program.addCommand(executeCommand);
 program.addCommand(executePromptCommand);
 program.showHelpAfterError();
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "automata-cli",
-  "version": "0.4.0-develop.124",
+  "version": "0.4.0-develop.142",
   "description": "Automata CLI tool",
   "type": "module",
   "bin": {