autopilot-code 0.9.0 → 1.0.0

package/README.md

@@ -15,6 +15,62 @@ A repo is considered autopilot-enabled when it contains:
 
 - `.autopilot/autopilot.json` with `enabled: true`
 
+## Quick Start
+
+### Choosing an Agent
+
+Autopilot supports multiple agent types:
+
+**opencode** (recommended): Full-featured agent with extensive code understanding
+```json
+{
+  "agent": "opencode"
+}
+```
+
+**claude**: Fast, targeted code changes
+```json
+{
+  "agent": "claude"
+}
+```
+
+### Runner Configuration
+
+**IMPORTANT**: The new Python runner is now the default. The legacy bash script is deprecated and will be removed in a future version.
+
+The new runner provides enhanced progress tracking and session continuity:
+
+```json
+{
+  "useNewRunner": true,
+  "enablePlanningStep": true
+}
+```
+
+**Deprecation Timeline**:
+- **Current release**: New runner is default, deprecation warnings added
+- **+1 minor release**: More prominent warnings for legacy runner
+- **+1 major release**: Bash script will be removed entirely
+
+If you see a deprecation warning, it means you're using the legacy bash runner. To migrate, remove `"useNewRunner": false` from your config (or set to `true`).
+
+### Understanding Step Labels
+
+When using the new runner, issues progress through these labels:
+
+- `autopilot:planning` - Creating implementation plan
+- `autopilot:implementing` - Writing code
+- `autopilot:pr-created` - Pull request created
+- `autopilot:waiting-checks` - Waiting for CI
+- `autopilot:fixing-checks` - Fixing failing CI
+- `autopilot:merging` - Merging PR
+
+To create these labels in your repository:
+```bash
+autopilot setup-labels --repo owner/repo
+```
+
 Example:
 
 ```json
@@ -47,7 +103,8 @@ Example:
 
 Notes:
 - `repo` must be the GitHub `owner/name`.
-- `agent` (optional, default `"none"`): set to `"opencode"` to enable OpenCode integration after claiming issues.
+- `agent` (optional, default `"opencode"`): set to `"opencode"` or `"claude"` to choose which coding agent to use.
+- `useNewRunner` (optional, default `true`): enable the new runner with step labels and session continuity. The legacy bash runner is deprecated and will be removed in a future version.
 - `autoMerge` (optional, default `true`): if `true`, autopilot will automatically merge PRs after checks pass.
 - `mergeMethod` (optional, default `"squash"`): merge strategy to use. Options: `"squash"`, `"merge"`, or `"rebase"`.
 - `allowedMergeUsers` (required when `autoMerge=true`): list of GitHub usernames allowed to auto-merge. The runner verifies the authenticated GitHub user is in this list before merging.
@@ -57,7 +114,8 @@ Notes:
 - `conflictResolutionMaxAttempts` (optional, default `3`): maximum number of attempts to resolve merge conflicts.
 - `autoFixChecks` (optional, default `true`): if `true`, autopilot will attempt to automatically fix failing CI checks.
 - `autoFixChecksMaxAttempts` (optional, default `3`): maximum number of attempts to fix failing checks.
-- `heartbeatMaxAgeSecs` controls how long an in-progress issue can go without a heartbeat before it's considered stale.
+- `enablePlanningStep` (optional, default `true`): if `true`, add an explicit planning phase before implementation (requires `useNewRunner: true`).
+- `agentPath` (optional): custom path to agent executable (defaults to searching PATH).
 
 ## Workflow (labels)
 Autopilot uses labels as a kanban state machine:

package/dist/cli.js

@@ -548,4 +548,63 @@ program
     .action(() => {
     logsSystemdService();
 });
+program
+    .command("setup-labels")
+    .description("Create required GitHub labels for autopilot workflow")
+    .option("--repo <owner/repo>", "Repository in owner/repo format")
+    .action((opts) => {
+    if (!opts.repo) {
+        const cwd = process.cwd();
+        const repoName = getRepoName(cwd);
+        if (!repoName) {
+            console.error("No --repo option provided and could not detect repo from current directory.");
+            console.error("Usage: autopilot setup-labels --repo owner/repo");
+            process.exit(1);
+        }
+        opts.repo = repoName;
+    }
+    const labels = [
+        { name: "autopilot:todo", color: "7057ff", description: "Ready to be picked up by autopilot" },
+        { name: "autopilot:in-progress", color: "0075ca", description: "Claimed by autopilot" },
+        { name: "autopilot:blocked", color: "d93f0b", description: "Needs human input or missing heartbeat" },
+        { name: "autopilot:done", color: "3fb950", description: "Completed" },
+        { name: "autopilot:backlog", color: "d4c5f9", description: "Captured, not ready" },
+        { name: "autopilot:planning", color: "5319e7", description: "Creating implementation plan" },
+        { name: "autopilot:implementing", color: "1f883d", description: "Writing code" },
+        { name: "autopilot:pr-created", color: "fbca04", description: "Pull request created" },
+        { name: "autopilot:waiting-checks", color: "0e8a16", description: "Waiting for CI checks" },
+        { name: "autopilot:fixing-checks", color: "cfd3d7", description: "Fixing failing CI checks" },
+        { name: "autopilot:merging", color: "bfd4f2", description: "Merging pull request" }
+    ];
+    console.log(`Creating labels for ${opts.repo}...`);
+    labels.forEach(label => {
+        const args = [
+            "api",
+            "--method",
+            "POST",
+            "-H",
+            "Accept: application/vnd.github+json",
+            "repos/${opts.repo}/labels",
+            "-f",
+            `name=${label.name}`,
+            "-f",
+            `color=${label.color}`,
+            "-f",
+            `description=${label.description}`
+        ];
+        const res = (0, node_child_process_1.spawnSync)("gh", args, { stdio: "pipe" });
+        if (res.status === 0) {
+            console.log(`✅ Created: ${label.name}`);
+        }
+        else if (res.stderr && res.stderr.toString().includes("Label already exists")) {
+            console.log(`ℹ️  Exists: ${label.name}`);
+        }
+        else {
+            console.error(`❌ Failed to create ${label.name}`);
+            if (res.stderr)
+                console.error(res.stderr.toString());
+        }
+    });
+    console.log("\n✅ Label setup complete!");
+});
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autopilot-code",
-  "version": "0.9.0",
+  "version": "1.0.0",
   "private": false,
   "description": "Repo-issue–driven autopilot runner",
   "license": "MIT",

package/scripts/run_autopilot.py

@@ -765,6 +765,16 @@ def run_issue(cfg: RepoConfig, issue_number: int) -> bool:
     Uses either the new Python runner or legacy bash script
     based on configuration.
     """
+    use_new_runner = cfg.config.get("useNewRunner", True)
+    
+    if not use_new_runner:
+        import logging
+        logger = logging.getLogger(__name__)
+        logger.warning(
+            "Legacy bash runner is deprecated and will be removed in a future version. "
+            "Please migrate to new runner by removing 'useNewRunner: false' from config."
+        )
+    
     if cfg.use_new_runner:
         return run_issue_new(cfg, issue_number)
     else:

package/scripts/run_opencode_issue.sh

@@ -1,4 +1,15 @@
 #!/usr/bin/env bash
+# =============================================================================
+# DEPRECATED: This script is deprecated and will be removed in a future version.
+#
+# The functionality has been replaced by Python IssueRunner module at:
+#   scripts/issue_runner/
+#
+# To use the new runner, ensure "useNewRunner" is not set to false in your
+# autopilot.json config (it defaults to true).
+#
+# This script is maintained only for backward compatibility.
+# =============================================================================
 set -euo pipefail
 
 REPO_DIR="$1"

package/templates/autopilot.json

@@ -1,18 +1,29 @@
 {
   "enabled": true,
-  "repo": "bakkensoftware/TicketToolbox",
+  "repo": "owner/repo",
   "agent": "opencode",
-  "allowedMergeUsers": ["github-username"],
+  "useNewRunner": true,
+  "autoMerge": true,
+  "mergeMethod": "squash",
+  "allowedMergeUsers": [],
   "issueLabels": {
     "queue": ["autopilot:todo"],
-    "blocked": "autopilot:blocked",
     "inProgress": "autopilot:in-progress",
+    "blocked": "autopilot:blocked",
     "done": "autopilot:done"
   },
+  "stepLabels": {
+    "planning": "autopilot:planning",
+    "implementing": "autopilot:implementing",
+    "prCreated": "autopilot:pr-created",
+    "waitingChecks": "autopilot:waiting-checks",
+    "fixingChecks": "autopilot:fixing-checks",
+    "merging": "autopilot:merging"
+  },
   "priorityLabels": ["p0", "p1", "p2"],
   "minPriority": null,
-  "maxParallel": 2,
   "ignoreIssueLabels": ["autopilot:backlog"],
+  "maxParallel": 2,
   "branchPrefix": "autopilot/",
   "allowedBaseBranch": "main",
   "autoResolveConflicts": true,
@@ -20,5 +31,6 @@
   "autoFixChecks": true,
   "autoFixChecksMaxAttempts": 3,
   "autoUpdate": true,
-  "enablePlanningStep": true
+  "enablePlanningStep": true,
+  "agentPath": ""
 }