automata-cli 0.4.0 → 0.5.0-develop.181

package/README.md

@@ -115,11 +115,12 @@ See [docs/execute.md](docs/execute.md) for full details.
 
 ## `automata execute-prompt`
 
-Run predefined AI workflows that gather context from the current branch before invoking Claude or Codex.
+Run predefined AI workflows that gather context from the current branch's PR — or from a GitHub issue's conversation — before invoking Claude or Codex.
 
 ```bash
 automata execute-prompt sonar --with claude
 automata execute-prompt fix-comments --with codex --model o3
+automata execute-prompt check-issue 34 --with claude
 ```
 
 See [docs/execute-prompt.md](docs/execute-prompt.md) for full details.

package/dist/{ConfigWizard-WUGEM3PT.js → ConfigWizard-N473Z6LV.js}

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import {
+  DEFAULT_CHECK_ISSUE_PROMPT,
   DEFAULT_FIX_COMMENTS_PROMPT,
   DEFAULT_SONAR_PROMPT,
   readConfig,
   readRawConfig,
   writeConfig
-} from "./chunk-LAIP3B6F.js";
+} from "./chunk-OLM47VIK.js";
 
 // src/config/ConfigWizard.tsx
 import { useState } from "react";
@@ -27,8 +28,11 @@ var TECHNIQUE_OPTIONS = [
   { label: "By Assignee", value: "assignee" },
   { label: "By Title Contains", value: "title-contains" }
 ];
-var MAIN_MENU_OPTIONS = ["Remote / Mode", "Implement-Next", "Prompts"];
-var PROMPTS_MENU_OPTIONS = ["Sonar", "Fix-Comments"];
+var MAIN_MENU_OPTIONS = ["Remote / Mode", "Implement-Next", "Prompts", "Issue Watch"];
+var PROMPTS_MENU_OPTIONS = ["Sonar", "Fix-Comments", "Check-Issue"];
+function parseAllowedUsers(value) {
+  return value.split(",").map((user) => user.trim()).filter((user) => user.length > 0);
+}
 function ConfigWizard() {
   const existing = readConfig();
   const rawExisting = readRawConfig();
@@ -45,6 +49,9 @@ function ConfigWizard() {
   const [fixCommentsPrompt, setFixCommentsPrompt] = useState(
     existing.prompts?.fixComments ?? DEFAULT_FIX_COMMENTS_PROMPT
   );
+  const [checkIssuePrompt, setCheckIssuePrompt] = useState(existing.prompts?.checkIssue ?? DEFAULT_CHECK_ISSUE_PROMPT);
+  const [allowedUsers, setAllowedUsers] = useState((existing.allowedUsers ?? []).join(", "));
+  const [agentUser, setAgentUser] = useState(existing.agentUser ?? "");
   const [pendingRemote, setPendingRemote] = useState(existing.remoteType ?? "gh");
   const [pendingTechnique, setPendingTechnique] = useState(
     existing.issueDiscoveryTechnique ?? "label"
@@ -62,6 +69,8 @@ function ConfigWizard() {
           setScreen("remote");
         } else if (chosen === "Implement-Next") {
           setScreen("technique");
+        } else if (chosen === "Issue Watch") {
+          setScreen("allowed-users");
         } else {
           setScreen("prompts-menu");
         }
@@ -146,8 +155,10 @@ function ConfigWizard() {
         const chosen = PROMPTS_MENU_OPTIONS[promptsMenuIndex];
         if (chosen === "Sonar") {
           setScreen("sonar-prompt");
-        } else {
+        } else if (chosen === "Fix-Comments") {
           setScreen("fix-comments-prompt");
+        } else {
+          setScreen("check-issue-prompt");
         }
       } else if (key.escape) {
         setScreen("main");
@@ -198,6 +209,59 @@ function ConfigWizard() {
       } else if (input && !key.ctrl && !key.meta) {
         setFixCommentsPrompt((v) => v + input);
       }
+    } else if (screen === "check-issue-prompt") {
+      if (key.return) {
+        let checkIssueValue;
+        if (checkIssuePrompt) {
+          writePromptFile("check-issue-prompt.md", checkIssuePrompt);
+          checkIssueValue = "check-issue-prompt.md";
+        }
+        const current = readRawConfig();
+        writeConfig({
+          ...current,
+          prompts: { ...current.prompts, checkIssue: checkIssueValue }
+        });
+        setScreen("prompts-menu");
+      } else if (key.backspace || key.delete) {
+        setCheckIssuePrompt((v) => v.slice(0, -1));
+      } else if (key.escape) {
+        setScreen("prompts-menu");
+      } else if (key.ctrl && input === "c") {
+        exit();
+      } else if (input && !key.ctrl && !key.meta) {
+        setCheckIssuePrompt((v) => v + input);
+      }
+    } else if (screen === "allowed-users") {
+      if (key.return) {
+        setScreen("agent-user");
+      } else if (key.backspace || key.delete) {
+        setAllowedUsers((v) => v.slice(0, -1));
+      } else if (key.escape) {
+        setScreen("main");
+      } else if (key.ctrl && input === "c") {
+        exit();
+      } else if (input && !key.ctrl && !key.meta) {
+        setAllowedUsers((v) => v + input);
+      }
+    } else if (screen === "agent-user") {
+      if (key.return) {
+        const parsedUsers = parseAllowedUsers(allowedUsers);
+        const current = readRawConfig();
+        writeConfig({
+          ...current,
+          allowedUsers: parsedUsers.length > 0 ? parsedUsers : void 0,
+          agentUser: agentUser.trim() || void 0
+        });
+        exit();
+      } else if (key.backspace || key.delete) {
+        setAgentUser((v) => v.slice(0, -1));
+      } else if (key.escape) {
+        setScreen("allowed-users");
+      } else if (key.ctrl && input === "c") {
+        exit();
+      } else if (input && !key.ctrl && !key.meta) {
+        setAgentUser((v) => v + input);
+      }
     }
   });
   if (screen === "main") {
@@ -300,6 +364,54 @@ function ConfigWizard() {
       /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Type prompt \xB7 Enter to save \xB7 Esc to go back \xB7 Ctrl+C to cancel" })
     ] });
   }
+  if (screen === "check-issue-prompt") {
+    return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginY: 1, children: [
+      /* @__PURE__ */ jsx(Text, { bold: true, children: "Prompts \u2014 Check-Issue" }),
+      /* @__PURE__ */ jsx(Text, { children: " " }),
+      /* @__PURE__ */ jsxs(Text, { children: [
+        "Check-Issue prompt:",
+        " ",
+        /* @__PURE__ */ jsxs(Text, { color: "cyan", children: [
+          checkIssuePrompt,
+          /* @__PURE__ */ jsx(Text, { children: "_" })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsx(Text, { children: " " }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Type prompt \xB7 Enter to save \xB7 Esc to go back \xB7 Ctrl+C to cancel" })
+    ] });
+  }
+  if (screen === "allowed-users") {
+    return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginY: 1, children: [
+      /* @__PURE__ */ jsx(Text, { bold: true, children: "Issue Watch \u2014 Allowed Users" }),
+      /* @__PURE__ */ jsx(Text, { children: " " }),
+      /* @__PURE__ */ jsxs(Text, { children: [
+        "Logins allowed to instruct the agent (comma separated):",
+        " ",
+        /* @__PURE__ */ jsxs(Text, { color: "cyan", children: [
+          allowedUsers,
+          /* @__PURE__ */ jsx(Text, { children: "_" })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsx(Text, { children: " " }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Type logins \xB7 Enter to continue \xB7 Esc to go back \xB7 Ctrl+C to cancel" })
+    ] });
+  }
+  if (screen === "agent-user") {
+    return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginY: 1, children: [
+      /* @__PURE__ */ jsx(Text, { bold: true, children: "Issue Watch \u2014 Agent User" }),
+      /* @__PURE__ */ jsx(Text, { children: " " }),
+      /* @__PURE__ */ jsxs(Text, { children: [
+        "Login the agent posts as:",
+        " ",
+        /* @__PURE__ */ jsxs(Text, { color: "cyan", children: [
+          agentUser,
+          /* @__PURE__ */ jsx(Text, { children: "_" })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsx(Text, { children: " " }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Type login \xB7 Enter to save and exit \xB7 Esc to go back \xB7 Ctrl+C to cancel" })
+    ] });
+  }
   return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginY: 1, children: [
     /* @__PURE__ */ jsx(Text, { bold: true, children: "Prompts \u2014 Fix-Comments" }),
     /* @__PURE__ */ jsx(Text, { children: " " }),

package/dist/{chunk-LAIP3B6F.js → chunk-OLM47VIK.js}

@@ -6,6 +6,7 @@ import { join, resolve, sep } from "path";
 var DEFAULT_CLAUDE_SYSTEM_PROMPT = "You are an expert software engineer. Implement the following issue according to the project's existing conventions and style. Make minimal, targeted changes that satisfy the requirements. Run tests and linting before finishing.";
 var DEFAULT_FIX_COMMENTS_PROMPT = "You are an expert software engineer reviewing a pull request. Below are the open review comments left by reviewers on this PR. Please address each comment by making the appropriate code changes. Focus on the reviewer's concerns and make minimal, targeted changes that resolve each comment without altering unrelated code.";
 var DEFAULT_SONAR_PROMPT = "You are an expert software engineer. You have been given the URL of a SonarCloud analysis for this pull request. If the `sonar-quality-gate` skill is available in this repository, use it. The project is public, so use the SonarCloud REST API directly (no authentication required) rather than scraping the URL. Inspect both the quality gate and the list of issues for this pull request. If the quality gate fails because of duplication or another metric-based condition, use the relevant Sonar APIs to identify the affected files and details instead of relying only on the issues endpoint. Fix all new issues and quality-gate failures reported. Focus on code smells, bugs, vulnerabilities, and blocking quality-gate conditions flagged in this PR. Make targeted, minimal changes that resolve each issue without altering unrelated code.";
+var DEFAULT_CHECK_ISSUE_PROMPT = "You are an expert software engineer working on a GitHub issue. Below is the conversation on that issue, restricted to the people allowed to instruct you and your own previous replies. Messages marked as new arrived after your last run: treat them as the current instruction and read the earlier messages only as context. Do what the new messages ask, following the project's existing conventions and style, and make minimal, targeted changes. Run tests and linting before finishing, then reply on the issue with a short summary of what you did.";
 var CONFIG_DIR = ".automata";
 var CONFIG_FILE = "config.json";
 function configPath() {
@@ -62,6 +63,9 @@ function readConfig() {
   if (config.prompts?.fixComments) {
     config.prompts.fixComments = resolvePromptRef(config.prompts.fixComments, dir);
   }
+  if (config.prompts?.checkIssue) {
+    config.prompts.checkIssue = resolvePromptRef(config.prompts.checkIssue, dir);
+  }
   return config;
 }
 function writeConfig(config) {
@@ -74,6 +78,7 @@ export {
   DEFAULT_CLAUDE_SYSTEM_PROMPT,
   DEFAULT_FIX_COMMENTS_PROMPT,
   DEFAULT_SONAR_PROMPT,
+  DEFAULT_CHECK_ISSUE_PROMPT,
   readRawConfig,
   readConfig,
   writeConfig

package/dist/index.js

@@ -1,12 +1,13 @@
 #!/usr/bin/env node
 import {
+  DEFAULT_CHECK_ISSUE_PROMPT,
   DEFAULT_CLAUDE_SYSTEM_PROMPT,
   DEFAULT_FIX_COMMENTS_PROMPT,
   DEFAULT_SONAR_PROMPT,
   readConfig,
   readRawConfig,
   writeConfig
-} from "./chunk-LAIP3B6F.js";
+} from "./chunk-OLM47VIK.js";
 
 // src/index.ts
 import { Command as Command6 } from "commander";
@@ -57,12 +58,34 @@ var configSetClaudeSystemPrompt = new Command("claude-system-prompt").descriptio
   process.stdout.write(`Claude system prompt set.
 `);
 });
-var configSet = new Command("set").description("Set a configuration value").addCommand(configSetType).addCommand(configSetIssueDiscoveryTechnique).addCommand(configSetIssueDiscoveryValue).addCommand(configSetClaudeSystemPrompt);
+var configSetAllowedUsers = new Command("allowed-users").description("Set the comma-separated list of users allowed to instruct the agent on an issue").argument("<value>", "Comma-separated GitHub logins, e.g. alice,bob").action((value) => {
+  const users = value.split(",").map((user) => user.trim()).filter((user) => user.length > 0);
+  if (users.length === 0) {
+    process.stderr.write("Error: allowed-users requires at least one login.\n");
+    process.exit(1);
+  }
+  const current = readRawConfig();
+  writeConfig({ ...current, allowedUsers: users });
+  process.stdout.write(`Allowed users set to: ${users.join(", ")}
+`);
+});
+var configSetAgentUser = new Command("agent-user").description("Set the login the agent itself posts as").argument("<value>", "GitHub login used by the agent").action((value) => {
+  const user = value.trim();
+  if (user.length === 0) {
+    process.stderr.write("Error: agent-user requires a non-empty login.\n");
+    process.exit(1);
+  }
+  const current = readRawConfig();
+  writeConfig({ ...current, agentUser: user });
+  process.stdout.write(`Agent user set to: ${user}
+`);
+});
+var configSet = new Command("set").description("Set a configuration value").addCommand(configSetType).addCommand(configSetIssueDiscoveryTechnique).addCommand(configSetIssueDiscoveryValue).addCommand(configSetClaudeSystemPrompt).addCommand(configSetAllowedUsers).addCommand(configSetAgentUser);
 var configCommand = new Command("config").description("Configure automata settings").addCommand(configSet).action(async () => {
   const [{ render }, React, { ConfigWizard }] = await Promise.all([
     import("ink"),
     import("react"),
-    import("./ConfigWizard-WUGEM3PT.js")
+    import("./ConfigWizard-N473Z6LV.js")
   ]);
   const { waitUntilExit } = render(React.createElement(ConfigWizard));
   await waitUntilExit();
@@ -1237,6 +1260,34 @@ function listIssues(technique, value, limit = 10) {
   }
   return JSON.parse(stdout);
 }
+function getIssueConversation(issueNumber) {
+  const { stdout, stderr, status } = run3("gh", [
+    "issue",
+    "view",
+    String(issueNumber),
+    "--json",
+    "number,title,body,url,author,createdAt,comments"
+  ]);
+  if (status !== 0) {
+    throw new Error(stderr.trim() || `Failed to read issue #${issueNumber}. Is \`gh\` installed and authenticated?`);
+  }
+  const raw = JSON.parse(stdout);
+  const comments = (raw.comments ?? []).map((comment) => ({
+    id: comment.id,
+    author: comment.author?.login ?? "",
+    body: comment.body,
+    createdAt: comment.createdAt
+  })).sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+  return {
+    number: raw.number,
+    title: raw.title,
+    body: raw.body,
+    url: raw.url,
+    author: raw.author?.login ?? "",
+    createdAt: raw.createdAt,
+    comments
+  };
+}
 function postComment(issueNumber, body) {
   const { stderr, status } = run3("gh", ["issue", "comment", String(issueNumber), "--body", body]);
   if (status !== 0) {
@@ -1715,6 +1766,53 @@ var executeCommand = new Command4("execute").description("Delegate work to an AI
 
 // src/commands/executePrompt.ts
 import { Command as Command5 } from "commander";
+
+// src/github/issueConversation.ts
+function analyzeConversation(conversation, allowedUsers, agentUser) {
+  const agent = agentUser.toLowerCase();
+  const allowed = new Set(allowedUsers.map((user) => user.toLowerCase()));
+  let lastAgentAt = null;
+  for (const comment of conversation.comments) {
+    if (comment.author.toLowerCase() !== agent) continue;
+    if (lastAgentAt === null || comment.createdAt > lastAgentAt) {
+      lastAgentAt = comment.createdAt;
+    }
+  }
+  const entries = [
+    {
+      kind: "issue",
+      author: conversation.author,
+      body: conversation.body,
+      createdAt: conversation.createdAt
+    },
+    ...conversation.comments.map((c) => ({
+      kind: "comment",
+      author: c.author,
+      body: c.body,
+      createdAt: c.createdAt
+    }))
+  ].sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+  const messages = [];
+  for (const entry of entries) {
+    const author = entry.author.toLowerCase();
+    const isAgent = author === agent;
+    if (!isAgent && !allowed.has(author)) continue;
+    const isNew = !isAgent && (lastAgentAt === null || entry.createdAt > lastAgentAt);
+    messages.push({ ...entry, isNew });
+  }
+  const newMessageCount = messages.filter((m) => m.isNew).length;
+  return { messages, newMessageCount, hasNewMessage: newMessageCount > 0, lastAgentAt };
+}
+function formatConversation(messages) {
+  return messages.map((message) => {
+    const kind = message.kind === "issue" ? "issue description" : "comment";
+    const marker = message.isNew ? " \xB7 NEW since last agent run" : "";
+    return `[${message.author}] ${kind} \xB7 ${message.createdAt}${marker}
+${message.body}`;
+  }).join("\n\n");
+}
+
+// src/commands/executePrompt.ts
 var PUSH_INSTRUCTION = "Once all changes are complete, stage every modified file, create a single commit with a clear and descriptive commit message that summarises what was fixed, and push the branch to the remote.";
 function withPush(prompt, push) {
   return push ? `${prompt}
@@ -1724,6 +1822,9 @@ ${PUSH_INSTRUCTION}` : prompt;
 function formatPrInfoContext(pr) {
   return JSON.stringify(pr, null, 2);
 }
+function pluralSuffix(count) {
+  return count === 1 ? "" : "s";
+}
 function addAiOptions(cmd) {
   return cmd.requiredOption("--with <executor>", "Executor to use: claude or codex").option("--model <string>", "Model identifier to pass to the executor").option("--silent", "Suppress step-by-step Claude output; show only the final summary").option("--push", "Append instruction to commit and push changes after the AI finishes");
 }
@@ -1841,7 +1942,90 @@ ${formatComments(comments)}`,
   );
   await invokeSelectedExecutor(fullPrompt, executor, options);
 });
-var executePromptCommand = new Command5("execute-prompt").description("Execute a configured custom prompt using an AI assistant").addCommand(executeSonarCmd).addCommand(executeFixCommentsCmd);
+var executeCheckIssueCmd = addAiOptions(
+  new Command5("check-issue").description(
+    "Check a GitHub issue for a new message from an allowed user since the last agent run and invoke the AI with the issue conversation"
+  ).argument("<issue-number>", "GitHub issue number to check")
+).option("--force", "Skip the new-message check and invoke the AI directly").action(async (issueNumberArg, options) => {
+  const executor = resolveExecutor(options.with);
+  const issueNumber = Number.parseInt(issueNumberArg, 10);
+  if (Number.isNaN(issueNumber) || issueNumber <= 0) {
+    process.stderr.write(`Error: <issue-number> must be a positive integer (got '${issueNumberArg}').
+`);
+    process.exit(1);
+  }
+  const config = readConfig();
+  if (config.remoteType === "azdo") {
+    process.stderr.write(
+      "Error: check-issue is not supported for Azure DevOps. See docs/azdo-gap.md for details.\n"
+    );
+    process.exit(1);
+  }
+  const allowedUsers = (config.allowedUsers ?? []).filter((user) => user.trim().length > 0);
+  if (allowedUsers.length === 0) {
+    process.stderr.write(
+      "Error: No allowed users configured. Run `automata config` or `automata config set allowed-users <user1,user2>` to set them.\n"
+    );
+    process.exit(1);
+  }
+  const agentUser = (config.agentUser ?? "").trim();
+  if (agentUser.length === 0) {
+    process.stderr.write(
+      "Error: No agent user configured. Run `automata config` or `automata config set agent-user <login>` to set it.\n"
+    );
+    process.exit(1);
+  }
+  let conversation;
+  try {
+    conversation = getIssueConversation(issueNumber);
+  } catch (err) {
+    process.stderr.write(`Error: ${err.message}
+`);
+    process.exit(1);
+  }
+  const analysis = analyzeConversation(conversation, allowedUsers, agentUser);
+  if (!analysis.hasNewMessage && !options.force) {
+    const since = analysis.lastAgentAt === null ? "" : ` (last agent message: ${analysis.lastAgentAt})`;
+    process.stdout.write(
+      `No new messages from allowed users on issue #${String(issueNumber)}${since}. Use --force to invoke the AI anyway.
+`
+    );
+    return;
+  }
+  if (analysis.hasNewMessage) {
+    process.stdout.write(
+      `Found ${String(analysis.newMessageCount)} new message${pluralSuffix(analysis.newMessageCount)} on issue #${String(issueNumber)}. Invoking AI\u2026
+`
+    );
+  } else {
+    process.stdout.write(`No new messages on issue #${String(issueNumber)} \u2014 forced run. Invoking AI\u2026
+`);
+  }
+  const promptText = config.prompts?.checkIssue ?? DEFAULT_CHECK_ISSUE_PROMPT;
+  const fullPrompt = withPush(
+    `${promptText}
+
+Issue #${String(issueNumber)}: ${conversation.title}
+URL: ${conversation.url}
+
+Conversation (only messages from allowed users and the agent, oldest first):
+
+${formatConversation(analysis.messages)}`,
+    options.push
+  );
+  const marker = analysis.hasNewMessage ? `automata check-issue: picked up ${String(analysis.newMessageCount)} new message${pluralSuffix(analysis.newMessageCount)}, starting an agent run.` : "automata check-issue: forced run, starting an agent run.";
+  try {
+    postComment(issueNumber, marker);
+  } catch (err) {
+    process.stderr.write(
+      `Error: could not post the execution marker comment on issue #${String(issueNumber)}: ${err.message}
+`
+    );
+    process.exit(1);
+  }
+  await invokeSelectedExecutor(fullPrompt, executor, options);
+});
+var executePromptCommand = new Command5("execute-prompt").description("Execute a configured custom prompt using an AI assistant").addCommand(executeSonarCmd).addCommand(executeFixCommentsCmd).addCommand(executeCheckIssueCmd);
 
 // src/index.ts
 var program = new Command6();

package/package.json

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