automata-cli 0.3.0 → 0.4.0-develop.131

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."
+    };
+  }
+  if (typeof response.data.paging?.total === "number") {
+    return { total: response.data.paging.total };
   }
-  return response.data.paging?.total ?? null;
+  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));
@@ -1510,6 +1559,7 @@ minor segment is incremented (e.g. 1.2.0 \u2192 1.3.0).`
 var gitCommand = new Command2("git").description("Git workflow commands (some require gh CLI)").addCommand(getPrInfoCmd).addCommand(getPrCommentsCmd).addCommand(finishFeatureCmd).addCommand(publishReleaseCmd);
 
 // src/commands/getReady.ts
+import { createInterface as createInterface2 } from "readline";
 import { Command as Command3 } from "commander";
 
 // src/config/githubService.ts
@@ -1529,14 +1579,14 @@ function run3(cmd, args) {
     status: result.status ?? 1
   };
 }
-function listIssues(technique, value) {
+function listIssues(technique, value, limit = 10) {
   const baseArgs = [
     "issue",
     "list",
     "--state",
     "open",
     "--limit",
-    "1",
+    String(limit),
     "--json",
     "number,title,body,url"
   ];
@@ -1556,11 +1606,7 @@ function listIssues(technique, value) {
   if (status !== 0) {
     throw new Error(stderr.trim() || "Failed to query GitHub issues. Is `gh` installed and authenticated?");
   }
-  const issues = JSON.parse(stdout);
-  if (issues.length === 0) {
-    return null;
-  }
-  return issues[0];
+  return JSON.parse(stdout);
 }
 function postComment(issueNumber, body) {
   const { stderr, status } = run3("gh", ["issue", "comment", String(issueNumber), "--body", body]);
@@ -1740,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");
@@ -1753,8 +1800,37 @@ function invokeCodexCodeSync(prompt, yolo) {
 }
 
 // src/commands/getReady.ts
-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").action(async (options) => {
-  const config = readConfig();
+function writeOverflowHint(output, issues, limit) {
+  if (issues.length === limit) {
+    output.write(`(Showing first ${limit} matching issues \u2014 there may be more. Use --limit to fetch more.)
+`);
+  }
+}
+function writeIssueList(output, issues, limit) {
+  output.write("\nAvailable issues:\n");
+  for (let i = 0; i < issues.length; i++) {
+    output.write(`  [${i + 1}] #${issues[i].number} - ${issues[i].title}
+`);
+  }
+  writeOverflowHint(output, issues, limit);
+}
+async function promptSelection(issues, limit, output) {
+  writeIssueList(output, issues, limit);
+  const rl = createInterface2({ input: process.stdin, output });
+  const answer = await new Promise(
+    (resolve3) => rl.question(`
+Select issue (1-${issues.length}): `, resolve3)
+  );
+  rl.close();
+  const n = Number.parseInt(answer.trim(), 10);
+  if (Number.isNaN(n) || n < 1 || n > issues.length) {
+    process.stderr.write(`Error: Invalid selection "${answer.trim()}". Enter a number between 1 and ${issues.length}.
+`);
+    process.exit(1);
+  }
+  return issues[n - 1];
+}
+function validateConfig(config) {
   if (config.remoteType !== "gh") {
     process.stderr.write(
       "Error: implement-next is not supported in Azure DevOps mode. Work item discovery is not available in azdo-cli. See docs/azdo-gap.md for details.\n"
@@ -1773,24 +1849,58 @@ var implementNextCommand = new Command3("implement-next").description("Find the
     );
     process.exit(1);
   }
+}
+async function resolveIssue(issues, options, limit) {
+  const selectionOutput = options.json ? process.stderr : process.stdout;
+  if (issues.length === 0) {
+    process.stdout.write("No issues found matching the configured filter.\n");
+    process.exit(0);
+  }
+  if (issues.length > 1 && options.queryOnly) {
+    writeIssueList(selectionOutput, issues, limit);
+    process.exit(0);
+  }
   let issue;
+  if (issues.length === 1) {
+    issue = issues[0];
+    selectionOutput.write(`Issue:  #${issue.number}
+Title:  ${issue.title}
+`);
+  } else if (options.takeFirst) {
+    issue = issues[0];
+    selectionOutput.write(`Selecting issue #${issue.number}: ${issue.title}
+`);
+  } else {
+    issue = await promptSelection(issues, limit, selectionOutput);
+    selectionOutput.write(`
+Issue:  #${issue.number}
+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) => {
+  const config = readConfig();
+  validateConfig(config);
+  const limit = Number.parseInt(options.limit, 10);
+  if (Number.isNaN(limit) || limit <= 0) {
+    process.stderr.write(`Error: --limit must be a positive integer (got "${options.limit}").
+`);
+    process.exit(1);
+  }
+  let issues;
   try {
-    issue = listIssues(config.issueDiscoveryTechnique, config.issueDiscoveryValue);
+    issues = listIssues(config.issueDiscoveryTechnique, config.issueDiscoveryValue, limit);
   } catch (err) {
     process.stderr.write(`Error: ${err.message}
 `);
     process.exit(1);
   }
-  if (issue === null) {
-    process.stdout.write("No issues found matching the configured filter.\n");
-    process.exit(0);
-  }
+  const issue = await resolveIssue(issues, options, limit);
   if (options.json) {
     process.stdout.write(JSON.stringify({ number: issue.number, title: issue.title, body: issue.body, url: issue.url }, null, 2) + "\n");
   } else {
-    process.stdout.write(`Issue:  #${issue.number}
-Title:  ${issue.title}
-URL:    ${issue.url}
+    process.stdout.write(`URL:    ${issue.url}
 
 ${issue.body}
 `);
@@ -1807,7 +1917,9 @@ ${issue.body}
   }
   if (options.claude !== false) {
     const systemPrompt = config.claudeSystemPrompt ?? DEFAULT_CLAUDE_SYSTEM_PROMPT;
-    const prompt = `${systemPrompt}
+    const prompt = `Resolving issue #${issue.number}:
+
+${systemPrompt}
 
 ${issue.body}`;
     if (options.codex) {
@@ -1819,16 +1931,62 @@ ${issue.body}`;
   }
 });
 
-// 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";
@@ -1958,7 +2116,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.3.0",
+  "version": "0.4.0-develop.131",
   "description": "Automata CLI tool",
   "type": "module",
   "bin": {