automata-cli 0.2.0-develop.21 → 0.2.0-develop.31

package/README.md

@@ -1,6 +1,6 @@
 # automata-cli
 
-A command-line interface tool.
+A command-line interface tool for automating Git and project workflows.
 
 ## Installation
 
@@ -8,7 +8,7 @@ A command-line interface tool.
 npm install -g automata-cli
 ```
 
-## Usage
+## Quick start
 
 ```bash
 automata --help
@@ -16,62 +16,10 @@ automata --help
 
 ## Commands
 
-### `automata config`
-
-Launch the interactive configuration wizard. Use arrow keys to select the remote environment type and press Enter to save.
-
-```bash
-automata config
-```
-
-### `automata config set type <value>`
-
-Set a configuration value non-interactively (useful in scripts or CI).
-
-```bash
-automata config set type gh      # GitHub
-automata config set type azdo    # Azure DevOps
-```
-
-Configuration is saved to `.automata/config.json` in the current directory.
-
-### `automata git get-pr-info`
-
-Show the pull request associated with the current branch (requires [`gh` CLI](https://cli.github.com/) installed and authenticated).
-
-```bash
-automata git get-pr-info           # human-readable output
-automata git get-pr-info --json    # JSON output
-```
-
-Example output:
-
-```
-PR:    #42
-Title: Fix authentication bug
-State: MERGED
-URL:   https://github.com/org/repo/pull/42
-```
-
-If no PR exists for the current branch, a friendly message is printed and the command exits with code 0.
-
-### `automata git finish-feature`
-
-Clean up a merged feature branch in one step: checkout `develop`, pull the latest, and delete the local branch.
-
-```bash
-automata git finish-feature
-```
-
-The command validates all preconditions before making any changes:
-
-- Must **not** be on the `develop` branch
-- Working tree must be clean (no uncommitted changes)
-- A pull request for the branch must exist
-- The PR must be in `merged` state (not open or closed-without-merge)
-- The remote tracking branch must no longer exist (`origin/<branch>` is gone)
-
-If any precondition fails, the command prints a descriptive error to stderr and exits with a non-zero code.
+| Command group | Description | Docs |
+|---|---|---|
+| `automata config` | Configure the tool | [docs/config.md](docs/config.md) |
+| `automata git` | Git workflow helpers (requires `gh` CLI) | [docs/git.md](docs/git.md) |
 
 ## Development
 
@@ -91,7 +39,7 @@ npm install
 ### Scripts
 
 | Command | Description |
-| --- | --- |
+|---|---|
 | `npm run build` | Build the CLI with tsup |
 | `npm test` | Build and run tests with vitest |
 | `npm run lint` | Lint source files with ESLint |

package/dist/index.js

@@ -233,9 +233,59 @@ var configCommand = new Command("config").description("Configure automata settin
 import { Command as Command2 } from "commander";
 
 // src/git/gitService.ts
+import { spawnSync as spawnSync2 } from "child_process";
+
+// src/config/azdoService.ts
 import { spawnSync } from "child_process";
 function run(cmd, args) {
   const result = spawnSync(cmd, args, { encoding: "utf8" });
+  if (result.error) {
+    const err = result.error;
+    if (err.code === "ENOENT") {
+      throw new Error("`azdo` CLI is not installed or not on PATH.");
+    }
+    throw new Error(err.message);
+  }
+  return {
+    stdout: result.stdout ?? "",
+    stderr: result.stderr ?? "",
+    status: result.status ?? 1
+  };
+}
+function mapStatus(azdoStatus) {
+  switch (azdoStatus) {
+    case "active":
+      return "OPEN";
+    case "completed":
+      return "MERGED";
+    case "abandoned":
+      return "CLOSED";
+    default:
+      return azdoStatus.toUpperCase();
+  }
+}
+function getPrInfo() {
+  const { stdout, stderr, status } = run("azdo", ["pr", "status", "--json"]);
+  if (status !== 0) {
+    throw new Error(stderr.trim() || "Failed to query Azure DevOps PR status. Is `azdo` installed and authenticated?");
+  }
+  const parsed = JSON.parse(stdout);
+  if (parsed.pullRequests.length === 0) {
+    return null;
+  }
+  const pr = parsed.pullRequests[0];
+  return {
+    number: pr.id,
+    title: pr.title,
+    state: mapStatus(pr.status),
+    url: pr.url,
+    checks: []
+  };
+}
+
+// src/git/gitService.ts
+function run2(cmd, args) {
+  const result = spawnSync2(cmd, args, { encoding: "utf8" });
   return {
     stdout: result.stdout ?? "",
     stderr: result.stderr ?? "",
@@ -243,19 +293,55 @@ function run(cmd, args) {
   };
 }
 function getCurrentBranch() {
-  const { stdout, status } = run("git", ["rev-parse", "--abbrev-ref", "HEAD"]);
+  const { stdout, status } = run2("git", ["rev-parse", "--abbrev-ref", "HEAD"]);
   if (status !== 0) {
     throw new Error("Failed to determine current branch. Are you inside a git repository?");
   }
   return stdout.trim();
 }
-function getPrInfo(branch) {
-  const { stdout, stderr, status } = run("gh", [
+function parseOwnerRepo() {
+  const { stdout, status } = run2("git", ["remote", "get-url", "origin"]);
+  if (status !== 0) return null;
+  const url = stdout.trim();
+  const https = url.match(/github\.com\/([^/]+\/[^/]+?)(?:\.git)?$/);
+  if (https) return https[1];
+  const ssh = url.match(/github\.com:([^/]+\/[^/]+?)(?:\.git)?$/);
+  if (ssh) return ssh[1];
+  return null;
+}
+function extractLastMarkdownUrl(markdown) {
+  const matches = [...markdown.matchAll(/\]\((https?:\/\/[^)]+)\)/g)];
+  return matches.length > 0 ? matches[matches.length - 1][1] ?? null : null;
+}
+function fetchCheckRunOutputs(ownerRepo, sha) {
+  const { stdout, status } = run2("gh", [
+    "api",
+    `repos/${ownerRepo}/commits/${sha}/check-runs`,
+    "--jq",
+    ".check_runs[] | {name, html_url, details_url, output}"
+  ]);
+  const map = /* @__PURE__ */ new Map();
+  if (status !== 0) return map;
+  for (const line of stdout.trim().split("\n")) {
+    if (!line) continue;
+    try {
+      const item = JSON.parse(line);
+      const title = item.output?.title ?? "";
+      const summaryUrl = item.output?.summary ? extractLastMarkdownUrl(item.output.summary) : null;
+      const detailsUrl = summaryUrl ?? (item.details_url !== item.html_url ? item.details_url : "") ?? item.html_url;
+      map.set(item.name, { title, detailsUrl });
+    } catch {
+    }
+  }
+  return map;
+}
+function getPrInfoGh(branch) {
+  const { stdout, stderr, status } = run2("gh", [
     "pr",
     "view",
     branch,
     "--json",
-    "number,title,state,url"
+    "number,title,state,url,headRefOid,statusCheckRollup"
   ]);
   if (status !== 0) {
     if (stderr.includes("no pull requests found") || stderr.includes("Could not resolve")) {
@@ -263,41 +349,125 @@ function getPrInfo(branch) {
     }
     throw new Error(stderr.trim() || "Failed to query GitHub. Is `gh` installed and authenticated?");
   }
-  return JSON.parse(stdout);
+  const raw = JSON.parse(stdout);
+  const failedChecks = (raw.statusCheckRollup ?? []).filter(
+    (c) => c.conclusion !== null && ["FAILURE", "TIMED_OUT", "ACTION_REQUIRED", "CANCELLED"].includes(c.conclusion)
+  );
+  const ownerRepo = failedChecks.length > 0 ? parseOwnerRepo() : null;
+  const checkOutputs = ownerRepo ? fetchCheckRunOutputs(ownerRepo, raw.headRefOid) : /* @__PURE__ */ new Map();
+  const checks = (raw.statusCheckRollup ?? []).map((c) => {
+    const enriched = checkOutputs.get(c.name);
+    return {
+      name: c.name,
+      status: c.status,
+      conclusion: c.conclusion,
+      description: enriched?.title || c.description || "",
+      detailsUrl: enriched?.detailsUrl || c.detailsUrl || ""
+    };
+  });
+  return { number: raw.number, title: raw.title, state: raw.state, url: raw.url, checks };
+}
+function getPrInfo2(branch) {
+  const config = readConfig();
+  if (config.remoteType === "azdo") {
+    return getPrInfo();
+  }
+  return getPrInfoGh(branch);
 }
 function isUpstreamGone(branch) {
-  const { status } = run("git", ["ls-remote", "--exit-code", "--heads", "origin", branch]);
+  const { status } = run2("git", ["ls-remote", "--exit-code", "--heads", "origin", branch]);
   return status !== 0;
 }
 function hasUncommittedChanges() {
-  const { stdout } = run("git", ["status", "--porcelain"]);
+  const { stdout } = run2("git", ["status", "--porcelain"]);
   return stdout.trim().length > 0;
 }
 function checkoutAndPull(targetBranch) {
-  const checkout = run("git", ["checkout", targetBranch]);
+  const checkout = run2("git", ["checkout", targetBranch]);
   if (checkout.status !== 0) {
     throw new Error(`Failed to checkout ${targetBranch}: ${checkout.stderr.trim()}`);
   }
-  const pull = run("git", ["pull"]);
+  const pull = run2("git", ["pull"]);
   if (pull.status !== 0) {
     throw new Error(`Failed to pull ${targetBranch}: ${pull.stderr.trim()}`);
   }
 }
 function fetchPrune() {
-  const result = run("git", ["fetch", "--prune"]);
+  const result = run2("git", ["fetch", "--prune"]);
   if (result.status !== 0) {
     throw new Error(`Failed to fetch --prune: ${result.stderr.trim()}`);
   }
 }
 function deleteLocalBranch(branch) {
-  const result = run("git", ["branch", "-d", branch]);
+  const result = run2("git", ["branch", "-D", branch]);
   if (result.status !== 0) {
     throw new Error(`Failed to delete branch ${branch}: ${result.stderr.trim()}`);
   }
 }
 
 // src/commands/git.ts
-var getPrInfoCmd = new Command2("get-pr-info").description("Show pull request info for the current branch").option("--json", "Output as JSON").action((options) => {
+var FAIL_CONCLUSIONS = /* @__PURE__ */ new Set(["FAILURE", "TIMED_OUT", "ACTION_REQUIRED", "CANCELLED"]);
+var SKIP_CONCLUSIONS = /* @__PURE__ */ new Set(["SKIPPED", "NEUTRAL"]);
+function checkSymbol(check) {
+  if (check.status !== "COMPLETED") return "\u25CF";
+  if (check.conclusion === "SUCCESS") return "\u2713";
+  if (check.conclusion !== null && SKIP_CONCLUSIONS.has(check.conclusion)) return "\u25CB";
+  if (check.conclusion !== null && FAIL_CONCLUSIONS.has(check.conclusion)) return "\u2717";
+  return "\u25CF";
+}
+function formatCheckSummary(checks) {
+  const running = checks.some((c) => c.status !== "COMPLETED");
+  const failed = checks.filter((c) => c.conclusion !== null && FAIL_CONCLUSIONS.has(c.conclusion));
+  const errors = failed.length === 0 ? "none" : failed.map((c) => `${c.name}: ${c.description.trim() || c.detailsUrl || "no details available"}`).join("; ");
+  return `Checks Running: ${String(running)}
+Check Errors:   ${errors}
+`;
+}
+function formatChecks(checks) {
+  if (checks.length === 0) return "Checks: none\n";
+  const lines = ["Checks:"];
+  for (const check of checks) {
+    const sym = checkSymbol(check);
+    const pending = check.status !== "COMPLETED" ? " (pending)" : "";
+    lines.push(`  ${sym} ${check.name}${pending}`);
+    if (check.conclusion !== null && FAIL_CONCLUSIONS.has(check.conclusion)) {
+      const desc = check.description.trim();
+      const url = check.detailsUrl.trim();
+      if (desc) lines.push(`    Details: ${desc}`);
+      if (url) lines.push(`    URL:     ${url}`);
+      if (!desc && !url) lines.push(`    Details: (no details available)`);
+    }
+  }
+  return lines.join("\n") + "\n";
+}
+function sleep(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+function formatFailedChecks(failed) {
+  const lines = [];
+  for (const check of failed) {
+    lines.push(`  \u2717 ${check.name}`);
+    const desc = check.description.trim();
+    const url = check.detailsUrl.trim();
+    if (desc) lines.push(`    Details: ${desc}`);
+    if (url) lines.push(`    URL:     ${url}`);
+    if (!desc && !url) lines.push(`    Details: (no details available)`);
+  }
+  return lines.join("\n") + "\n";
+}
+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 report pass/fail (exit 1 on failure)").addHelpText(
+  "after",
+  `
+Check status symbols:
+  \u2713  Passed        (conclusion: SUCCESS)
+  \u2717  Failed        (conclusion: FAILURE / TIMED_OUT / ACTION_REQUIRED / CANCELLED)
+  \u25CF  Pending       (status: QUEUED or IN_PROGRESS)
+  \u25CB  Skipped       (conclusion: SKIPPED or NEUTRAL)
+
+Failure details are printed beneath each \u2717 check.
+See docs/git.md for full output reference.`
+).action(async (options) => {
   let branch;
   try {
     branch = getCurrentBranch();
@@ -306,9 +476,51 @@ var getPrInfoCmd = new Command2("get-pr-info").description("Show pull request in
 `);
     process.exit(1);
   }
+  if (options.waitFinishChecks) {
+    let pr2;
+    while (true) {
+      try {
+        pr2 = getPrInfo2(branch);
+      } catch (err) {
+        process.stderr.write(`Error: ${err.message}
+`);
+        process.exit(1);
+      }
+      if (pr2 === null) {
+        process.stderr.write(`Error: No pull request found for branch: ${branch}
+`);
+        process.exit(1);
+      }
+      const running = pr2.checks.filter((c) => c.status !== "COMPLETED");
+      if (running.length === 0) break;
+      process.stdout.write(`Waiting for ${running.length} check(s) to complete...
+`);
+      await sleep(POLL_INTERVAL_MS);
+    }
+    const failed = pr2.checks.filter((c) => c.conclusion !== null && FAIL_CONCLUSIONS.has(c.conclusion));
+    if (failed.length === 0) {
+      if (options.json) {
+        process.stdout.write(JSON.stringify({ result: "passed" }, null, 2) + "\n");
+      } else {
+        process.stdout.write(`All checks passed. \u2713
+`);
+      }
+      process.exit(0);
+    } else {
+      if (options.json) {
+        process.stdout.write(JSON.stringify({ result: "failed", failed }, null, 2) + "\n");
+      } else {
+        process.stdout.write(`${failed.length} check(s) failed:
+`);
+        process.stdout.write(formatFailedChecks(failed));
+      }
+      process.exit(1);
+    }
+    return;
+  }
   let pr;
   try {
-    pr = getPrInfo(branch);
+    pr = getPrInfo2(branch);
   } catch (err) {
     process.stderr.write(`Error: ${err.message}
 `);
@@ -327,6 +539,8 @@ Title: ${pr.title}
 State: ${pr.state}
 URL:   ${pr.url}
 `);
+    process.stdout.write(formatCheckSummary(pr.checks));
+    process.stdout.write(formatChecks(pr.checks));
   }
 });
 var finishFeatureCmd = new Command2("finish-feature").description("Clean up a merged feature branch: checkout develop, pull, and delete local branch").action(() => {
@@ -350,7 +564,7 @@ var finishFeatureCmd = new Command2("finish-feature").description("Clean up a me
   }
   let pr;
   try {
-    pr = getPrInfo(branch);
+    pr = getPrInfo2(branch);
   } catch (err) {
     process.stderr.write(`Error: ${err.message}
 `);
@@ -402,14 +616,14 @@ var gitCommand = new Command2("git").description("Git workflow commands (require
 
 // src/commands/getReady.ts
 import { Command as Command3 } from "commander";
-import { spawnSync as spawnSync3 } from "child_process";
+import { spawnSync as spawnSync4 } from "child_process";
 import { existsSync } from "fs";
 import { delimiter, join as join2 } from "path";
 
 // src/config/githubService.ts
-import { spawnSync as spawnSync2 } from "child_process";
-function run2(cmd, args) {
-  const result = spawnSync2(cmd, args, { encoding: "utf8" });
+import { spawnSync as spawnSync3 } from "child_process";
+function run3(cmd, args) {
+  const result = spawnSync3(cmd, args, { encoding: "utf8" });
   if (result.error) {
     const err = result.error;
     if (err.code === "ENOENT") {
@@ -450,7 +664,7 @@ function listIssues(technique, value) {
       filterArgs = ["--search", `${value} in:title`];
       break;
   }
-  const { stdout, stderr, status } = run2("gh", [...baseArgs, ...filterArgs]);
+  const { stdout, stderr, status } = run3("gh", [...baseArgs, ...filterArgs]);
   if (status !== 0) {
     throw new Error(stderr.trim() || "Failed to query GitHub issues. Is `gh` installed and authenticated?");
   }
@@ -461,7 +675,7 @@ function listIssues(technique, value) {
   return issues[0];
 }
 function postComment(issueNumber, body) {
-  const { stderr, status } = run2("gh", ["issue", "comment", String(issueNumber), "--body", body]);
+  const { stderr, status } = run3("gh", ["issue", "comment", String(issueNumber), "--body", body]);
   if (status !== 0) {
     throw new Error(stderr.trim() || `Failed to post comment on issue #${issueNumber}.`);
   }
@@ -481,7 +695,7 @@ function invokeClaudeCode(issue, systemPrompt) {
 
 ${issue.body}` : issue.body;
   const claudeBin = resolveCommand("claude");
-  const result = spawnSync3(claudeBin, ["-p", prompt], { encoding: "utf8", stdio: "inherit" });
+  const result = spawnSync4(claudeBin, ["-p", prompt], { encoding: "utf8", stdio: "inherit" });
   if (result.error) {
     const err = result.error;
     if (err.code === "ENOENT") {
@@ -501,7 +715,9 @@ ${issue.body}` : issue.body;
 var getReadyCommand = new Command3("get-ready").description("Find the next open GitHub issue matching the configured filter, claim it, and invoke Claude Code").option("--json", "Output issue details as JSON").option("--no-claude", "Skip Claude Code invocation after claiming the issue").action((options) => {
   const config = readConfig();
   if (config.remoteType !== "gh") {
-    process.stderr.write("Error: get-ready is only available for GitHub (gh) mode.\n");
+    process.stderr.write(
+      "Error: get-ready is not supported in Azure DevOps mode. Work item discovery is not available in azdo-cli. See docs/azdo-gap.md for details.\n"
+    );
     process.exit(1);
   }
   if (!config.issueDiscoveryTechnique) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "automata-cli",
-  "version": "0.2.0-develop.21",
+  "version": "0.2.0-develop.31",
   "description": "Automata CLI tool",
   "type": "module",
   "bin": {