autopilot-code 0.3.0 → 0.4.0

package/package.json

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

package/scripts/issue_runner/states.py

@@ -0,0 +1,102 @@
+from enum import Enum
+from dataclasses import dataclass, asdict, field
+from typing import Optional
+from datetime import datetime
+import json
+
+
+class IssueStep(Enum):
+    """Discrete steps in the issue resolution workflow."""
+
+    INIT = "init"
+    WORKTREE_READY = "worktree_ready"
+    DEPS_INSTALLED = "deps_installed"
+    ISSUE_FETCHED = "issue_fetched"
+    PLAN_POSTED = "plan_posted"
+    IMPLEMENTED = "implemented"
+    COMMITTED = "committed"
+    PUSHED = "pushed"
+    PR_CREATED = "pr_created"
+    CONFLICTS_RESOLVING = "conflicts_resolving"
+    CONFLICTS_RESOLVED = "conflicts_resolved"
+    CHECKS_WAITING = "checks_waiting"
+    CHECKS_FIXING = "checks_fixing"
+    CHECKS_PASSED = "checks_passed"
+    MERGED = "merged"
+    DONE = "done"
+    FAILED = "failed"
+
+
+@dataclass
+class StateData:
+    """
+    Issue state persisted to GitHub as a hidden comment.
+    This is the single source of truth for issue progress.
+    """
+
+    issue_number: int
+    step: IssueStep
+    branch: str
+    worktree: str
+    pr_number: Optional[int] = None
+    session_id: Optional[str] = None  # Agent session for context continuity
+    conflict_attempts: int = 0
+    ci_fix_attempts: int = 0
+    error_message: Optional[str] = None
+    updated_at: str = field(default_factory=lambda: datetime.utcnow().isoformat() + "Z")
+
+    def to_dict(self) -> dict:
+        """Convert to JSON-serializable dict."""
+        d = asdict(self)
+        d["step"] = self.step.value
+        return d
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "StateData":
+        """Create from dict (parsed from JSON)."""
+        data["step"] = IssueStep(data["step"])
+        return cls(**data)
+
+    def to_comment_body(self, status_message: str) -> str:
+        """Generate GitHub comment with hidden state JSON."""
+        state_json = json.dumps(self.to_dict(), indent=2)
+        return f"""
+<!-- autopilot-state
+{state_json}
+-->
+
+🤖 **Autopilot Status**: {status_message}
+"""
+
+
+# Human-readable status messages for each step
+STEP_STATUS_MESSAGES = {
+    IssueStep.INIT: "Starting work on this issue...",
+    IssueStep.WORKTREE_READY: "Git worktree created.",
+    IssueStep.DEPS_INSTALLED: "Dependencies installed.",
+    IssueStep.ISSUE_FETCHED: "Issue details retrieved.",
+    IssueStep.PLAN_POSTED: "Implementation plan ready.",
+    IssueStep.IMPLEMENTED: "Code changes complete.",
+    IssueStep.COMMITTED: "Changes committed.",
+    IssueStep.PUSHED: "Branch pushed to remote.",
+    IssueStep.PR_CREATED: "Pull request created.",
+    IssueStep.CONFLICTS_RESOLVING: "Resolving merge conflicts...",
+    IssueStep.CONFLICTS_RESOLVED: "Merge conflicts resolved.",
+    IssueStep.CHECKS_WAITING: "Waiting for CI checks to pass...",
+    IssueStep.CHECKS_FIXING: "Attempting to fix failing CI checks...",
+    IssueStep.CHECKS_PASSED: "All CI checks passed!",
+    IssueStep.MERGED: "PR merged successfully!",
+    IssueStep.DONE: "Issue complete! 🎉",
+    IssueStep.FAILED: "❌ Autopilot encountered an error.",
+}
+
+# Labels to apply for each step (for human visibility in issue list)
+STEP_LABELS = {
+    IssueStep.INIT: "autopilot:starting",
+    IssueStep.PLAN_POSTED: "autopilot:planning",
+    IssueStep.IMPLEMENTED: "autopilot:implementing",
+    IssueStep.PR_CREATED: "autopilot:pr-created",
+    IssueStep.CHECKS_WAITING: "autopilot:waiting-checks",
+    IssueStep.CHECKS_FIXING: "autopilot:fixing-checks",
+    IssueStep.MERGED: "autopilot:merging",
+}