automata-cli 0.2.0-develop.20 → 0.2.0-develop.26

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

@@ -255,7 +255,7 @@ function getPrInfo(branch) {
     "view",
     branch,
     "--json",
-    "number,title,state,url"
+    "number,title,state,url,statusCheckRollup"
   ]);
   if (status !== 0) {
     if (stderr.includes("no pull requests found") || stderr.includes("Could not resolve")) {
@@ -263,7 +263,15 @@ 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 checks = (raw.statusCheckRollup ?? []).map((c) => ({
+    name: c.name,
+    status: c.status,
+    conclusion: c.conclusion,
+    description: c.description ?? "",
+    detailsUrl: c.detailsUrl ?? ""
+  }));
+  return { number: raw.number, title: raw.title, state: raw.state, url: raw.url, checks };
 }
 function isUpstreamGone(branch) {
   const { status } = run("git", ["ls-remote", "--exit-code", "--heads", "origin", branch]);
@@ -283,6 +291,12 @@ function checkoutAndPull(targetBranch) {
     throw new Error(`Failed to pull ${targetBranch}: ${pull.stderr.trim()}`);
   }
 }
+function fetchPrune() {
+  const result = run("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]);
   if (result.status !== 0) {
@@ -291,7 +305,49 @@ function deleteLocalBranch(branch) {
 }
 
 // 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() || "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 detail = check.description.trim() || "(no details available)";
+      lines.push(`    Details: ${detail}`);
+    }
+  }
+  return lines.join("\n") + "\n";
+}
+var getPrInfoCmd = new Command2("get-pr-info").description("Show pull request info for the current branch").option("--json", "Output as JSON").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((options) => {
   let branch;
   try {
     branch = getCurrentBranch();
@@ -321,6 +377,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(() => {
@@ -375,6 +433,9 @@ var finishFeatureCmd = new Command2("finish-feature").description("Clean up a me
     process.exit(1);
   }
   try {
+    process.stdout.write(`Fetching and pruning remote refs...
+`);
+    fetchPrune();
     process.stdout.write(`Checking out develop and pulling latest...
 `);
     checkoutAndPull("develop");

package/package.json

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