bmad-autopilot-addon 1.0.0

package/_bmad-addons/scripts/sync-status.sh

@@ -0,0 +1,138 @@
+#!/bin/bash
+# Write git metadata to git-status.yaml (addon-owned file).
+# NEVER modifies sprint-status.yaml (BMAD-owned).
+#
+# Usage: sync-status.sh --story <key> --git-status-file <path> \
+#          [--branch <name>] [--commit <sha>] [--patch-commits <sha,...>] \
+#          [--push-status <status>] [--pr-url <url>] [--lint-result <text>] \
+#          [--worktree <path>] [--platform <name>] [--base-branch <name>]
+#
+# Reads existing git-status.yaml and updates the story entry.
+# Creates the file if it doesn't exist.
+# Uses atomic write (same-dir tmp + mv).
+set -e
+
+STORY=""
+GIT_STATUS_FILE=""
+BRANCH=""
+WORKTREE=""
+STORY_COMMIT=""
+PATCH_COMMITS=""
+PUSH_STATUS="pending"
+PR_URL=""
+LINT_RESULT=""
+PLATFORM=""
+BASE_BRANCH="main"
+WORKTREE_CLEANED="false"
+
+while [ "$#" -gt 0 ]; do
+  case $1 in
+    --story) STORY="$2"; shift 2 ;;
+    --git-status-file) GIT_STATUS_FILE="$2"; shift 2 ;;
+    --branch) BRANCH="$2"; shift 2 ;;
+    --worktree) WORKTREE="$2"; shift 2 ;;
+    --commit) STORY_COMMIT="$2"; shift 2 ;;
+    --patch-commits) PATCH_COMMITS="$2"; shift 2 ;;
+    --push-status) PUSH_STATUS="$2"; shift 2 ;;
+    --pr-url) PR_URL="$2"; shift 2 ;;
+    --lint-result) LINT_RESULT="$2"; shift 2 ;;
+    --platform) PLATFORM="$2"; shift 2 ;;
+    --base-branch) BASE_BRANCH="$2"; shift 2 ;;
+    --worktree-cleaned) WORKTREE_CLEANED="$2"; shift 2 ;;
+    -h|--help)
+      echo "Usage: sync-status.sh --story <key> --git-status-file <path> [git fields...]"
+      exit 0
+      ;;
+    *) shift ;;
+  esac
+done
+
+if [ -z "$STORY" ] || [ -z "$GIT_STATUS_FILE" ]; then
+  echo "ERROR: --story and --git-status-file required" >&2
+  exit 1
+fi
+
+# Ensure parent directory exists
+mkdir -p "$(dirname "$GIT_STATUS_FILE")"
+
+# Read existing file or start fresh
+if [ -f "$GIT_STATUS_FILE" ]; then
+  EXISTING=$(cat "$GIT_STATUS_FILE")
+else
+  EXISTING=""
+fi
+
+# YAML-safe quoting: wrap values that may contain special chars
+yaml_safe() {
+  local val="$1"
+  # Quote if contains : { } [ ] , & * # ? | - < > = ! % @ ` or newlines
+  case "$val" in
+    *[:\{\}\[\],\&\*\#\?\|\-\<\>\=\!\%\@\`]*|*"
+"*) printf '"%s"' "$(echo "$val" | sed 's/"/\\"/g')" ;;
+    *) printf '%s' "$val" ;;
+  esac
+}
+
+# Build the story entry
+STORY_BLOCK="  ${STORY}:"
+[ -n "$BRANCH" ] && STORY_BLOCK="$STORY_BLOCK
+    branch: $(yaml_safe "$BRANCH")"
+[ -n "$WORKTREE" ] && STORY_BLOCK="$STORY_BLOCK
+    worktree: $(yaml_safe "$WORKTREE")"
+[ -n "$STORY_COMMIT" ] && STORY_BLOCK="$STORY_BLOCK
+    story_commit: $(yaml_safe "$STORY_COMMIT")"
+[ -n "$PATCH_COMMITS" ] && STORY_BLOCK="$STORY_BLOCK
+    patch_commits: [${PATCH_COMMITS}]"
+[ -n "$LINT_RESULT" ] && STORY_BLOCK="$STORY_BLOCK
+    lint_result: $(yaml_safe "$LINT_RESULT")"
+STORY_BLOCK="$STORY_BLOCK
+    push_status: $(yaml_safe "$PUSH_STATUS")"
+[ -n "$PR_URL" ] && STORY_BLOCK="$STORY_BLOCK
+    pr_url: $(yaml_safe "$PR_URL")"
+STORY_BLOCK="$STORY_BLOCK
+    worktree_cleaned: ${WORKTREE_CLEANED}"
+
+# If file exists and has this story, replace that story's block
+# If file exists without this story, append under stories:
+# If file doesn't exist, create fresh
+TMP_FILE="${GIT_STATUS_FILE}.tmp"
+
+if [ -z "$EXISTING" ]; then
+  # Create new file
+  cat > "$TMP_FILE" <<EOF
+# BMAD Autopilot Add-On — Git Status
+# Tracks git metadata per story. Do not edit manually.
+git_integration:
+  enabled: true
+  base_branch: ${BASE_BRANCH}
+  platform: ${PLATFORM}
+
+stories:
+${STORY_BLOCK}
+EOF
+elif echo "$EXISTING" | grep -q "^  ${STORY}:"; then
+  # Replace existing story block
+  # Write replacement block to temp file (awk -v can't handle embedded newlines on macOS)
+  BLOCK_FILE="${GIT_STATUS_FILE}.block"
+  printf '%s\n' "$STORY_BLOCK" > "$BLOCK_FILE"
+  awk -v story="  ${STORY}:" -v blockfile="$BLOCK_FILE" '
+    $0 == story {
+      skip=1
+      while ((getline line < blockfile) > 0) print line
+      close(blockfile)
+      next
+    }
+    skip && /^  [^ ]/ { skip=0 }
+    skip { next }
+    { print }
+  ' "$GIT_STATUS_FILE" > "$TMP_FILE"
+  rm -f "$BLOCK_FILE"
+else
+  # Append new story
+  printf '%s\n%s\n' "$EXISTING" "$STORY_BLOCK" > "$TMP_FILE"
+fi
+
+# Atomic rename
+mv "$TMP_FILE" "$GIT_STATUS_FILE"
+
+echo "OK:${STORY}:push=${PUSH_STATUS}"

package/_bmad-addons/skills/bmad-autopilot-off/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: bmad-autopilot-off
+description: 'Disengage autonomous BMAD execution mode with git status report. Reports sprint position, completed work, git branch/PR status, and next steps. Releases the autopilot lock file. Use when user says "/bmad-autopilot-off" or "stop autopilot" or "pause autopilot".'
+---
+
+Follow the instructions in ./workflow.md.

package/_bmad-addons/skills/bmad-autopilot-off/workflow.md

@@ -0,0 +1,154 @@
+# BMAD Autopilot — OFF (Enhanced with Git Status)
+
+## Purpose
+
+Disengage autopilot mode. Produce a complete status report including git branch/PR status, release the autopilot lock, and consult `bmad-help` for the exact next recommended step.
+
+---
+
+## INITIALIZATION
+
+Load config: `{project-root}/_bmad/bmm/config.yaml`
+
+Resolve:
+- `implementation_artifacts`
+- `status_file` = `{implementation_artifacts}/sprint-status.yaml` (BMAD-owned, read only)
+- `git_status_file` = `{implementation_artifacts}/git-status.yaml` (addon-owned git fields)
+- `decision_log_file` = `{implementation_artifacts}/decision-log.yaml`
+- `planning_artifacts`
+- `project_root` = absolute path of current working directory
+
+### Git integration check
+
+<action>Check if `{project-root}/_bmad-addons/manifest.yaml` exists</action>
+<check if="manifest exists">
+  <action>Read manifest → set `{{git_enabled}}` from `git.enabled`</action>
+</check>
+<check if="manifest does NOT exist">
+  <action>Set `{{git_enabled}}` = false</action>
+</check>
+
+---
+
+## EXECUTION
+
+### Step 1 — Exit worktree if active
+
+<check if="current working directory appears to be inside a worktree (check if `.worktrees/` is in the path or run `git rev-parse --show-toplevel` and compare to project_root)">
+  <action>Commit any uncommitted work if possible</action>
+  <action>`cd` to project root — preserve worktree for later resume</action>
+  <action>Log: "Exited worktree, returned to project root"</action>
+</check>
+
+### Step 2 — Load sprint state
+
+Read `{status_file}` fully.
+
+If `{status_file}` does not exist:
+> "No sprint-status.yaml found. Run `/bmad-sprint-planning` first, or `/bmad-autopilot-on` to start from the beginning."
+> Stop.
+
+### Step 3 — Summarize completed and in-progress work
+
+Scan all entries in sprint-status:
+- Count stories with status `done` — list them grouped by epic
+- Find the first story that is `in-progress` or `ready-for-dev` — this is the current position
+- Count remaining stories not yet `done`
+
+### Step 4 — Collect git status (if enabled)
+
+<check if="{{git_enabled}}">
+  <action>Read `{git_status_file}` (addon's git-status.yaml) if it exists</action>
+  <action>Extract `git_integration` block (platform, base_branch)</action>
+  <action>For each story in `stories:` section:
+    - Note `branch`, `push_status`, `pr_url`, `worktree_cleaned`
+  </action>
+  <action>Check for active worktrees: `git worktree list --porcelain 2>/dev/null`</action>
+  <action>Check current branch: `git branch --show-current 2>/dev/null`</action>
+</check>
+
+### Step 5 — Consult bmad-help for next action
+
+Invoke `bmad-help` with the question: "Where are we in the sprint and what is the next required step?"
+
+Extract the recommended next skill and any important context.
+
+### Step 6 — Release lock
+
+<check if="{{git_enabled}}">
+  <action>Release lock: `bash {{project_root}}/_bmad-addons/scripts/lock.sh release`</action>
+</check>
+
+### Step 7 — Collect decision log
+
+<action>Read `{decision_log_file}` if it exists</action>
+<action>Collect:
+  - All decisions with impact `medium` or `high`
+  - Count of `review-accept` entries (patches applied)
+  - Count of `review-triage` entries (findings dismissed)
+  - Per-story summary: patches applied and findings dismissed
+</action>
+
+### Step 8 — Produce status report
+
+Output to user (use exact format):
+
+```
+╔═══════════════════════════════════════════════════════════════╗
+║               BMAD AUTOPILOT — STATUS REPORT                  ║
+╚═══════════════════════════════════════════════════════════════╝
+
+SUMMARY
+  Stories completed : {{done_count}}/{{total_stories}}
+  Epics completed   : {{done_epics}}/{{total_epics}}
+{{#if git_enabled}}
+  Platform          : {{platform}}
+{{/if}}
+
+STORIES
+{{#each epic}}
+  Epic {{epic_number}}: {{epic_title}}
+  {{#each stories}}
+  {{#if done}}✓{{else}}{{#if in_progress}}▶{{else}}·{{/if}}{{/if}} {{story-key}}{{#if done}}{{#if pr_url}}  PR: {{pr_url}}{{/if}}{{/if}}{{#if in_progress}} ← current{{/if}}
+  {{/each}}
+{{/each}}
+
+{{#if medium_high_decisions}}
+DECISIONS REQUIRING REVIEW (high/medium impact)
+{{#each medium_high_decisions}}
+  #{{id}}  [{{impact}}] {{story}} / {{phase}}
+      {{decision}}
+      → {{rationale}}
+{{/each}}
+
+  Full log: {decision_log_file}
+{{/if}}
+
+{{#if has_review_data}}
+REVIEW FINDINGS APPLIED
+  Patches applied    : {{total_patches}}
+  Findings dismissed : {{total_dismissed}}
+
+CODE REVIEW SUMMARY (per story)
+{{#each reviewed_stories}}
+  {{story-key}} : {{patches_applied}} patches applied, {{findings_dismissed}} dismissed
+{{/each}}
+{{/if}}
+
+{{#if git_enabled}}
+GIT STATUS
+{{#each stories_with_git_fields}}
+  {{story-key}}: branch={{branch}} push={{push_status}} {{#if pr_url}}PR: {{pr_url}}{{/if}}
+{{/each}}
+  Active worktrees: {{worktree_count}}
+  Lock: released
+{{/if}}
+
+NEXT REQUIRED STEP (from bmad-help)
+  {{next_skill_name}} — {{next_skill_description}}
+
+WHAT TO DO NEXT
+  1. Review decisions marked medium/high above (if any)
+  2. TO RESUME AUTOPILOT:  /bmad-autopilot-on
+  3. TO CONTINUE MANUALLY: /{{next-skill-name}}
+```

package/_bmad-addons/skills/bmad-autopilot-on/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: bmad-autopilot-on
+description: 'Engage autonomous BMAD execution with git workflow integration. Implements stories end-to-end with automatic branching (git worktrees), commits, linting, and PR creation. Uses standard git worktree commands for story isolation — works with any coding agent. Falls back to stock BMAD behavior when git is disabled. Use when user says "/bmad-autopilot-on" or "start autopilot".'
+---
+
+Follow the instructions in ./workflow.md.