@horizon-ai-dev/shokunin 0.1.0-alpha.1 → 0.1.0-alpha.7

package/README.md

@@ -157,6 +157,63 @@ Use when:
 - `repeat_interval_seconds`: Interval for repeat alerts
 - `max_repeats`: Maximum number of repeat alerts
 
+## Agent Loop (Autonomous Mode)
+
+The plugin includes `agent-loop`, a bash script for running autonomous coding sessions with beads task tracking.
+
+### Installation
+
+After installing the plugin, the `agent-loop` command becomes available:
+
+```bash
+# Install plugin globally to get the agent-loop command
+npm install -g @horizon-ai-dev/shokunin
+
+# Or run directly via npx
+npx @horizon-ai-dev/shokunin agent-loop
+```
+
+### Usage
+
+```bash
+# Run with default 10 iterations
+agent-loop
+
+# Run with custom max iterations
+agent-loop 20
+
+# Initialize beads if not present
+agent-loop --init-beads
+
+# Combine options
+agent-loop 50 --init-beads
+```
+
+### What It Does
+
+Each iteration:
+1. **Syncs with remote** - Pulls latest git changes and beads tasks
+2. **Finds ready work** - Uses `bd ready` to find unblocked tasks
+3. **Claims and implements** - Picks highest priority task, marks in_progress, implements
+4. **Runs E2E tests** - If `pnpm e2e` exists, runs full test suite
+5. **Handles failures** - Creates P0 blocking tasks for E2E regressions
+6. **Syncs and pushes** - Commits changes, syncs beads, pushes to remote
+
+### Prerequisites
+
+- OpenCode CLI installed (`npm install -g opencode`)
+- Beads CLI installed (`bd` command available)
+- Git repository with remote configured
+- Beads initialized in project (`.beads/` directory)
+
+### Files Included
+
+| File | Purpose |
+|------|---------|
+| `scripts/agent-loop.sh` | Main orchestration script |
+| `scripts/agent/prompt.txt` | Agent instructions for beads-driven development |
+| `scripts/agent/test-failure-prompt.txt` | Prompt for creating P0 tasks on E2E failures |
+
 ## Bundled Skills
 
 The plugin includes 6 bundled skills:

package/dist/commands/sn-configure.d.ts

@@ -12,8 +12,9 @@
  * 5. Install beads git hooks
  * 6. Configure playwright-mcp in opencode.json
  * 7. Copy 6 skills to .opencode/skill/
- * 8. Smart-merge model config into opencode.json
- * 9. Add note to AGENTS.md about runtime context
+ * 8. Copy agent-loop.sh and agent prompt files
+ * 9. Smart-merge model config into opencode.json
+ * 10. Add note to AGENTS.md about runtime context
  */
 import type { Config } from "@opencode-ai/sdk";
 /**

package/dist/commands/sn-configure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sn-configure.d.ts","sourceRoot":"","sources":["../../src/commands/sn-configure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAqP3C;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,CAOhD,CAAC"}
+{"version":3,"file":"sn-configure.d.ts","sourceRoot":"","sources":["../../src/commands/sn-configure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAuT3C;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,CAOhD,CAAC"}

package/dist/commands/sn-configure.js

@@ -12,8 +12,9 @@
  * 5. Install beads git hooks
  * 6. Configure playwright-mcp in opencode.json
  * 7. Copy 6 skills to .opencode/skill/
- * 8. Smart-merge model config into opencode.json
- * 9. Add note to AGENTS.md about runtime context
+ * 8. Copy agent-loop.sh and agent prompt files
+ * 9. Smart-merge model config into opencode.json
+ * 10. Add note to AGENTS.md about runtime context
  */
 /**
  * Command name (without leading slash).
@@ -167,21 +168,79 @@ Note: The skill files are bundled with the Shokunin plugin. To copy them, you'll
 
 Since we're running as a command template, use bash to copy:
 \`\`\`bash
-# Find the plugin location (it's in node_modules/@horizon-ai-dev/shokunin)
-PLUGIN_DIR="$(dirname "$(realpath "$(npm root)")/@horizon-ai-dev/shokunin")/vendor/skills"
+# Find the plugin location
+find_plugin_dir() {
+  # Try npm global location first
+  local npm_global_plugins="$(npm root -g)/@horizon-ai-dev/shokunin"
+  if [ -d "$npm_global_plugins/skills" ]; then
+    echo "$npm_global_plugins"
+    return
+  fi
+  
+  # Try local node_modules
+  local local_plugins="$(npm root)/@horizon-ai-dev/shokunin"
+  if [ -d "$local_plugins/skills" ]; then
+    echo "$local_plugins"
+    return
+  fi
+  
+  # Try relative path for development
+  if [ -d "./packages/shokunin-opencode-plugin/skills" ]; then
+    echo "./packages/shokunin-opencode-plugin"
+    return
+  fi
+  
+  echo ""
+}
 
-# Or if running locally during development
-PLUGIN_DIR="./package/vendor/skills"
+PLUGIN_DIR="$(find_plugin_dir)"
+
+if [ -z "$PLUGIN_DIR" ]; then
+  echo "Error: Could not find Shokunin plugin directory"
+  exit 1
+fi
 
 # Copy each skill
 for skill in prd-generator prd-decomposition agent-development command-development skill-development playwright-skill; do
-  if [ -d "$PLUGIN_DIR/$skill" ]; then
-    cp -r "$PLUGIN_DIR/$skill" ".opencode/skill/"
+  if [ -d "$PLUGIN_DIR/skills/$skill" ]; then
+    cp -r "$PLUGIN_DIR/skills/$skill" ".opencode/skill/"
   fi
 done
 \`\`\`
 
-## Step 8: Smart-Merge Model Config
+## Step 8: Copy Agent Loop Script and Prompts
+
+Copy the agent-loop.sh script and its associated prompt files for autonomous agent execution:
+
+\`\`\`bash
+# Create the scripts directory if it doesn't exist
+mkdir -p scripts/agent
+
+# Copy agent-loop.sh to project root scripts directory
+if [ -f "$PLUGIN_DIR/scripts/agent-loop.sh" ]; then
+  cp "$PLUGIN_DIR/scripts/agent-loop.sh" "./scripts/agent-loop.sh"
+  chmod +x "./scripts/agent-loop.sh"
+  echo "Copied agent-loop.sh"
+fi
+
+# Copy agent prompt files
+if [ -d "$PLUGIN_DIR/scripts/agent" ]; then
+  cp -r "$PLUGIN_DIR/scripts/agent/"* "./scripts/agent/"
+  echo "Copied agent prompt files"
+fi
+\`\`\`
+
+The agent-loop files include:
+- \`scripts/agent-loop.sh\` - Main agent loop script for autonomous task execution
+- \`scripts/agent/prompt.txt\` - Primary agent prompt for task work
+- \`scripts/agent/test-failure-prompt.txt\` - Prompt for handling test failures
+
+After copying, you can run the agent loop with:
+\`\`\`bash
+./scripts/agent-loop.sh [max_iterations] [--init-beads]
+\`\`\`
+
+## Step 9: Smart-Merge Model Config
 
 Based on the user's selection in Step 1, merge the model configuration into opencode.json.
 
@@ -202,7 +261,7 @@ Smart-merge rules:
 - For conflicts, keep existing value and report the conflict
 - Show user what changes were made
 
-## Step 9: Update AGENTS.md
+## Step 10: Update AGENTS.md
 
 Check if AGENTS.md exists:
 \`\`\`bash
@@ -241,15 +300,23 @@ MCP Servers:
 Skills Installed:
   - [list of skills copied]
 
+Agent Loop:
+  - scripts/agent-loop.sh: [copied]
+  - scripts/agent/prompt.txt: [copied]
+  - scripts/agent/test-failure-prompt.txt: [copied]
+
 Files Modified:
   - opencode.json
   - .opencode/skill/
+  - scripts/agent-loop.sh
+  - scripts/agent/
   - AGENTS.md
 
 Next Steps:
   1. Run /sn-check-config to verify configuration
   2. Try /sn-review-pr to review code changes
   3. Use Tab to switch to sn-code-reviewer agent
+  4. Run ./scripts/agent-loop.sh to start autonomous agent
 \`\`\`
 
 ## Error Handling

package/dist/commands/sn-configure.js.map

@@ -1 +1 @@
-{"version":3,"file":"sn-configure.js","sourceRoot":"","sources":["../../src/commands/sn-configure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C;;GAEG;AACH,MAAM,aAAa,GAAG;;;;;;;;;;;CAWrB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;EAqBvB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAsMqB,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,CAAC,YAAY,CAAC,EAAE;QACd,WAAW,EACT,qHAAqH;QACvH,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,IAAI,EAAE,6CAA6C;KAC7D;CACF,CAAC"}
+{"version":3,"file":"sn-configure.js","sourceRoot":"","sources":["../../src/commands/sn-configure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C;;GAEG;AACH,MAAM,aAAa,GAAG;;;;;;;;;;;CAWrB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;EAqBvB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAwQqB,CAAC;AAErC;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,CAAC,YAAY,CAAC,EAAE;QACd,WAAW,EACT,qHAAqH;QACvH,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,IAAI,EAAE,6CAA6C;KAC7D;CACF,CAAC"}

package/dist/plugin.d.ts

@@ -17,14 +17,21 @@
  * - sn-silent-failure-hunter (subagent) - Error handling analysis
  * - sn-type-design-analyzer (subagent) - TypeScript type design
  * - sn-skill-reviewer (subagent) - OpenCode skill review
+ *
+ * IMPORTANT: This plugin handles context injection differently from raw beads:
+ * - Combines SHOKUNIN_RULES + beads-context into a SINGLE session.prompt() call
+ * - This prevents the freeze bug caused by multiple session.prompt() calls
+ *   within the chat.message hook (see issue investigation 2026-01-18)
  */
 import type { Plugin } from "@opencode-ai/plugin";
 /**
  * The main Shokunin plugin export.
  *
- * Wraps BeadsPlugin and merges any additional Shokunin-specific hooks.
- * This allows extending the plugin functionality while maintaining
- * full compatibility with opencode-beads.
+ * Unlike a simple BeadsPlugin wrapper, this plugin:
+ * 1. Loads beads commands and agents directly (not via BeadsPlugin)
+ * 2. Handles context injection with a SINGLE session.prompt() call
+ *    that combines both SHOKUNIN_RULES and beads-context
+ * 3. This prevents the freeze bug caused by nested session.prompt() calls
  */
 export declare const ShokuninPlugin: Plugin;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAS,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAkDzD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,MA4E5B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAS,MAAM,EAAe,MAAM,qBAAqB,CAAC;AA6ItE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,MAoF5B,CAAC"}

package/dist/plugin.js

@@ -17,8 +17,15 @@
  * - sn-silent-failure-hunter (subagent) - Error handling analysis
  * - sn-type-design-analyzer (subagent) - TypeScript type design
  * - sn-skill-reviewer (subagent) - OpenCode skill review
+ *
+ * IMPORTANT: This plugin handles context injection differently from raw beads:
+ * - Combines SHOKUNIN_RULES + beads-context into a SINGLE session.prompt() call
+ * - This prevents the freeze bug caused by multiple session.prompt() calls
+ *   within the chat.message hook (see issue investigation 2026-01-18)
  */
-import { BeadsPlugin } from "opencode-beads";
+// Import beads utilities directly - we handle context injection ourselves
+// to avoid the freeze bug caused by multiple session.prompt() calls
+import { BEADS_GUIDANCE, loadAgent, loadCommands, } from "opencode-beads/src/vendor";
 // Shokunin agents
 import { snCodeReviewerAgent } from "./agents/sn-code-reviewer.js";
 import { snCodeSimplifierAgent } from "./agents/sn-code-simplifier.js";
@@ -33,7 +40,8 @@ import { snConfigureCommand } from "./commands/sn-configure.js";
 import { snReviewPrCommand } from "./commands/sn-review-pr.js";
 import { snUpdateCommand } from "./commands/sn-update.js";
 // Shokunin context
-import { looksLikeCompaction, SHOKUNIN_RULES, } from "./context/shokunin-rules.js";
+import { SHOKUNIN_RULES } from "./context/shokunin-rules.js";
+// Note: looksLikeCompaction is no longer needed - we use session.compacted event instead
 // Shokunin tools
 import { shokuninTools } from "./tools/emergency-stop.js";
 /**
@@ -57,77 +65,155 @@ const shokuninAgents = {
     ...snTypeDesignAnalyzerAgent,
     ...snSkillReviewerAgent,
 };
+/**
+ * Get the current model/agent context for a session by querying messages.
+ *
+ * Mirrors OpenCode's internal lastModel() logic to find the most recent
+ * user message. Used during event handling when we don't have direct access
+ * to the current user message's context.
+ */
+async function getSessionContext(client, sessionID) {
+    try {
+        const response = await client.session.messages({
+            path: { id: sessionID },
+            query: { limit: 50 },
+        });
+        if (response.data) {
+            for (const msg of response.data) {
+                if (msg.info.role === "user" && "model" in msg.info && msg.info.model) {
+                    return { model: msg.info.model, agent: msg.info.agent };
+                }
+            }
+        }
+    }
+    catch {
+        // On error, return undefined (let opencode use its default)
+    }
+    return;
+}
+/**
+ * Inject combined Shokunin + Beads context into a session.
+ *
+ * IMPORTANT: This combines both contexts into a SINGLE session.prompt() call
+ * to avoid the freeze bug caused by multiple session.prompt() calls within
+ * the chat.message hook.
+ *
+ * Runs `bd prime` and combines the output with SHOKUNIN_RULES.
+ * Silently skips beads context if bd is not installed or not initialized.
+ */
+async function injectCombinedContext(client, $, sessionID, context) {
+    // Start with shokunin rules
+    let combinedContext = SHOKUNIN_RULES;
+    // Try to add beads context
+    try {
+        const primeOutput = await $ `bd prime`.text();
+        if (primeOutput && primeOutput.trim() !== "") {
+            combinedContext += `\n\n<beads-context>
+${primeOutput.trim()}
+</beads-context>
+
+${BEADS_GUIDANCE}`;
+        }
+    }
+    catch {
+        // Silent skip if bd prime fails (not installed or not initialized)
+        // Shokunin rules will still be injected
+    }
+    // Single injection call with combined context
+    try {
+        await client.session.prompt({
+            path: { id: sessionID },
+            body: {
+                noReply: true,
+                model: context?.model,
+                agent: context?.agent,
+                parts: [{ type: "text", text: combinedContext, synthetic: true }],
+            },
+        });
+    }
+    catch {
+        // Silent skip if injection fails
+    }
+}
 /**
  * The main Shokunin plugin export.
  *
- * Wraps BeadsPlugin and merges any additional Shokunin-specific hooks.
- * This allows extending the plugin functionality while maintaining
- * full compatibility with opencode-beads.
+ * Unlike a simple BeadsPlugin wrapper, this plugin:
+ * 1. Loads beads commands and agents directly (not via BeadsPlugin)
+ * 2. Handles context injection with a SINGLE session.prompt() call
+ *    that combines both SHOKUNIN_RULES and beads-context
+ * 3. This prevents the freeze bug caused by nested session.prompt() calls
  */
-export const ShokuninPlugin = async (input) => {
-    const { client } = input;
-    // Get hooks from BeadsPlugin
-    const beadsHooks = await BeadsPlugin(input);
-    // Track sessions that have received shokunin-rules context
+export const ShokuninPlugin = async ({ client, $ }) => {
+    // Load beads commands and agents directly
+    const [beadsCommands, beadsAgents] = await Promise.all([
+        loadCommands(),
+        loadAgent(),
+    ]);
+    // Track sessions that have received combined context
     const injectedSessions = new Set();
-    // Shokunin-specific hooks
     const shokuninHooks = {
         config: async (config) => {
             // Inject Shokunin agents
             config.agent = {
                 ...config.agent,
                 ...shokuninAgents,
+                ...beadsAgents,
             };
             // Inject Shokunin commands
             config.command = {
                 ...config.command,
                 ...shokuninCommands,
+                ...beadsCommands,
             };
-            // Call beads config hook if it exists
-            if (beadsHooks.config) {
-                await beadsHooks.config(config);
-            }
         },
         // Register Shokunin tools
         tool: shokuninTools,
-        // Inject shokunin-rules context on first message and after compaction
-        "chat.message": async (hookInput, output) => {
+        // Inject combined shokunin-rules + beads context on first message
+        "chat.message": async (hookInput, _output) => {
             const sessionID = hookInput.sessionID;
-            // Get the first text part from the message
-            const textPart = output.parts.find((p) => p.type === "text");
-            const messageText = textPart?.type === "text" ? textPart.text : "";
-            // Check if this is a new session or post-compaction
-            const isNewSession = !injectedSessions.has(sessionID);
-            const isPostCompaction = looksLikeCompaction(messageText);
-            // Inject context if needed
-            if (isNewSession || isPostCompaction) {
-                try {
-                    await client.session.prompt({
-                        path: { id: sessionID },
-                        body: {
-                            noReply: true,
-                            model: hookInput.model,
-                            agent: hookInput.agent,
-                            parts: [{ type: "text", text: SHOKUNIN_RULES, synthetic: true }],
-                        },
+            // Skip if already injected this session
+            if (injectedSessions.has(sessionID))
+                return;
+            // Check if combined context was already injected (handles plugin reload/reconnection)
+            try {
+                const existing = await client.session.messages({
+                    path: { id: sessionID },
+                });
+                if (existing.data) {
+                    const hasContext = existing.data.some((msg) => {
+                        const parts = msg.parts || msg.info.parts;
+                        if (!parts)
+                            return false;
+                        return parts.some((part) => part.type === "text" &&
+                            (part.text?.includes("<shokunin-rules>") ||
+                                part.text?.includes("<beads-context>")));
                     });
-                    injectedSessions.add(sessionID);
-                }
-                catch {
-                    // Silent skip if injection fails
+                    if (hasContext) {
+                        injectedSessions.add(sessionID);
+                        return;
+                    }
                 }
             }
-            // Call beads chat.message hook if it exists
-            if (beadsHooks["chat.message"]) {
-                await beadsHooks["chat.message"](hookInput, output);
+            catch {
+                // On error, proceed with injection
+            }
+            injectedSessions.add(sessionID);
+            // Inject combined context with a SINGLE session.prompt() call
+            await injectCombinedContext(client, $, sessionID, {
+                model: hookInput.model,
+                agent: hookInput.agent,
+            });
+        },
+        // Re-inject context after session compaction
+        event: async ({ event }) => {
+            if (event.type === "session.compacted") {
+                const sessionID = event.properties.sessionID;
+                const context = await getSessionContext(client, sessionID);
+                await injectCombinedContext(client, $, sessionID, context);
             }
         },
     };
-    // Merge hooks - shokunin hooks override beads hooks when both exist
-    // This ensures our config hook runs and then calls beads' config hook
-    return {
-        ...beadsHooks,
-        ...shokuninHooks,
-    };
+    return shokuninHooks;
 };
 //# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@horizon-ai-dev/shokunin",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.7",
   "type": "module",
   "description": "Complete AI-assisted development workflow plugin for OpenCode. Re-exports opencode-beads with specialized agents, commands, and bundled skills.",
   "author": "Horizon AI Dev",
@@ -15,20 +15,20 @@
     "beads",
     "shokunin",
     "ai",
-    "agent"
+    "agent",
+    "autonomous"
   ],
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "agent-loop": "./scripts/agent-loop.sh"
+  },
   "files": [
     "dist",
     "vendor",
+    "scripts",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm build"
-  },
   "dependencies": {
     "@opencode-ai/plugin": "^1.0.143",
     "@opencode-ai/sdk": "^1.0.143",
@@ -42,5 +42,14 @@
   },
   "engines": {
     "bun": ">=1.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "publish:alpha": "pnpm version prerelease --preid=alpha --no-git-tag-version && git add package.json && git commit -m \"chore: bump to $(node -p \"require('./package.json').version\")\" && pnpm publish --access public --tag alpha --no-git-checks",
+    "publish:beta": "pnpm version prerelease --preid=beta --no-git-tag-version && git add package.json && git commit -m \"chore: bump to $(node -p \"require('./package.json').version\")\" && pnpm publish --access public --tag beta --no-git-checks",
+    "publish:release": "pnpm version patch && pnpm publish --access public",
+    "publish:minor": "pnpm version minor && pnpm publish --access public",
+    "publish:major": "pnpm version major && pnpm publish --access public"
   }
-}
+}

package/scripts/agent/prompt.txt

@@ -0,0 +1,270 @@
+# Autonomous Agent Instructions (Beads Edition)
+
+You are an autonomous coding agent working on a software project using Beads for task tracking.
+
+## Beads Overview
+
+Beads is a distributed, git-backed graph issue tracker designed for AI agents. Issues are stored as JSONL in `.beads/` and synchronized via git.
+
+Key concepts:
+- `bd ready` - Find tasks with no blockers (ready to work)
+- `bd show <id>` - View task details
+- `bd update <id> --status in_progress` - Claim work
+- `bd close <id>` - Complete work
+- `bd sync` - Synchronize with remote (CRITICAL at session end)
+
+## Your Task
+
+1. **Synchronize with remote first** - Run `bd sync` to pull latest tasks/changes
+2. **Read the current state** - Run `bd ready --json` to find available work
+3. **Check for in-progress work** - Run `bd list --status=in_progress --json` to resume any interrupted work
+4. **Check branch alignment** - Verify you're on the correct working branch
+5. **Pick the highest priority ready task** - Select from `bd ready` output (P0 highest, P4 lowest)
+6. **Claim the task** - Run `bd update <id> --status in_progress --json`
+7. **Implement the task** - Do the actual work
+8. **Run quality checks** - typecheck, lint, test (use whatever your project requires)
+9. **Update AGENTS.md files** if you discover reusable patterns (see below)
+10. **If checks pass**, commit ALL code changes with message: `feat: [Task ID] - [Task Title]`
+11. **Close the task** - Run `bd close <id> --reason "Implemented and tested" --json`
+12. **Add learnings** - If significant discoveries, create a note task or update the closed task's notes
+13. **Synchronize** - Run `bd sync` to push all changes
+
+## Recovery from Interruption
+
+On startup, ALWAYS check for interrupted work:
+
+```bash
+# 1. Sync with remote to get latest state
+bd sync
+
+# 2. Check for any in-progress work (might be from crashed session)
+bd list --status=in_progress --json
+
+# 3. If found, either:
+#    - Resume the work if it's still valid
+#    - Reset status if work was completed but not closed:
+#      bd close <id> --reason "Completed in previous session"
+#    - Or reopen if it needs rework:
+#      bd update <id> --status open --json
+```
+
+## Progress Tracking with Beads
+
+Use Beads' built-in tracking:
+
+### Recording Progress
+```bash
+# Update task with implementation notes
+bd update <id> --notes "Implemented auth validation. Changed files: src/auth.ts, tests/auth.test.ts"
+
+# Add design notes if relevant
+bd update <id> --design "Used JWT validation pattern from @repo/auth"
+```
+
+### Recording Learnings
+```bash
+# For significant patterns discovered, create a documentation task
+bd create "Document: [Pattern Name]" -t chore -p 3 --description "Pattern discovered while working on <parent-id>: [description]" --json
+
+# Or if it's a quick note, add to the task's notes field
+bd update <id> --notes "Learning: Always use IF NOT EXISTS for migrations"
+```
+
+### Discovering Related Work
+```bash
+# If you find a bug or new requirement while working, track it:
+bd create "Found: [issue description]" -t bug -p 2 --deps discovered-from:<current-task-id> --json
+```
+
+## Consolidate Patterns in AGENTS.md
+
+If you discover a **reusable pattern** that future iterations should know, add it to the relevant AGENTS.md file (project root or directory-specific):
+
+```markdown
+## Codebase Patterns
+- Example: Use `sql<number>` template for aggregations
+- Example: Always use `IF NOT EXISTS` for migrations
+- Example: Export types from actions.ts for UI components
+```
+
+Only add patterns that are **general and reusable**, not task-specific details.
+
+## Update AGENTS.md Files
+
+Before committing, check if any edited files have learnings worth preserving:
+
+1. **Identify directories with edited files**
+2. **Check for existing AGENTS.md** in those directories or parent directories
+3. **Add valuable learnings**:
+   - API patterns or conventions specific to that module
+   - Gotchas or non-obvious requirements
+   - Dependencies between files
+   - Testing approaches for that area
+
+**Do NOT add:**
+- Task-specific implementation details (those go in the task notes)
+- Temporary debugging notes
+- Information already tracked in Beads
+
+## Quality Requirements
+
+- ALL commits must pass your project's quality checks (typecheck, lint, test)
+- Do NOT commit broken code
+- Keep changes focused and minimal
+- Follow existing code patterns
+
+Run these commands and ensure they pass:
+```bash
+pnpm check        # Linting
+pnpm test         # Unit tests
+pnpm build        # Full build (includes typecheck) - allow up to 10 min
+```
+
+## E2E Testing (MANDATORY)
+
+### Distinction: Skill vs Persistent Tests
+
+| Tool | Purpose | When to Use |
+|------|---------|-------------|
+| `playwright-skill` | Interactive browser exploration | During development, debugging, one-off verification |
+| E2E test files | Permanent regression tests | Encoding acceptance criteria, run every iteration |
+
+**Key principle:** The playwright-skill is for exploratory testing during development. Acceptance criteria MUST be encoded as persistent E2E tests that run every iteration to prevent regressions.
+
+### Before Closing ANY UI Task
+
+1. **Encode acceptance criteria as persistent E2E test**
+   - Location: See app-specific AGENTS.md for test paths (e.g., `apps/app/e2e/`)
+   - Each acceptance criterion = one or more test assertions
+   - Tests must be self-contained and repeatable
+
+2. **Run ALL E2E tests (not just new ones)**
+   ```bash
+   pnpm e2e
+   ```
+
+3. **All tests must pass**
+   - If ANY test fails (including tests for other features), you MUST NOT close the task
+   - Fix the regression first
+   - The agent-loop will automatically create a P0 blocking task if E2E tests fail
+
+### E2E Test Template
+
+For task `bd-abc123` with acceptance criteria:
+- Filter dropdown has options: All, Active, Completed
+- Selecting "Active" shows only active tasks
+
+Create `apps/app/e2e/tasks/bd-abc123-filter.spec.ts`:
+
+```typescript
+import { expect, test } from '@playwright/test'
+
+const TITLE_PATTERN = /.+/
+
+test.describe('Task Filter (bd-abc123)', () => {
+  test('filter dropdown has correct options', async ({ page }) => {
+    await page.goto('/tasks')
+    await page.getByRole('combobox', { name: /filter/i }).click()
+    await expect(page.getByRole('option', { name: 'All' })).toBeVisible()
+    await expect(page.getByRole('option', { name: 'Active' })).toBeVisible()
+    await expect(page.getByRole('option', { name: 'Completed' })).toBeVisible()
+  })
+
+  test('selecting Active shows only active tasks', async ({ page }) => {
+    await page.goto('/tasks')
+    await page.getByRole('combobox', { name: /filter/i }).selectOption('Active')
+    // Assert filtering worked...
+  })
+})
+```
+
+## Browser Testing During Development
+
+For interactive browser exploration during development, use the `playwright-skill`:
+
+1. Load the `playwright-skill` skill (use the skill tool)
+2. Navigate to the relevant page
+3. Verify the UI changes work as expected
+4. Take screenshots if helpful
+
+**IMPORTANT:** This is for exploratory testing only. You MUST ALSO create persistent E2E tests from acceptance criteria (see above).
+
+## Stop Condition
+
+After completing a task, check if ALL work is done:
+
+```bash
+bd ready --json
+```
+
+If `bd ready` returns an empty array (no ready tasks), check overall status:
+
+```bash
+bd stats --json
+```
+
+If all tasks are complete (open=0, in_progress=0), reply with:
+<promise>COMPLETE</promise>
+
+If there are still tasks with blockers, check:
+```bash
+bd blocked --json
+```
+
+And report what's blocking progress.
+
+If there are still ready tasks, end your response normally (another iteration will pick up the next task).
+
+## Important
+
+- Work on ONE task per iteration
+- Always run `bd sync` at the START and END of each iteration
+- Commit frequently
+- Keep CI green
+- Use `--json` flag for all bd commands (easier to parse)
+
+## Essential bd Commands Reference
+
+```bash
+# Finding work
+bd ready --json                    # Tasks ready to work on
+bd list --status=open --json       # All open tasks
+bd list --status=in_progress --json # In-progress work
+bd blocked --json                  # What's blocked and why
+bd show <id> --json                # Detailed task view
+
+# Working on tasks
+bd update <id> --status in_progress --json  # Claim work
+bd update <id> --notes "..." --json         # Add notes
+bd close <id> --reason "..." --json         # Complete work
+
+# Creating new tasks
+bd create "Title" -t task|bug|feature -p 0-4 --json
+bd create "Title" --deps discovered-from:<id> --json  # Link to parent
+
+# Dependencies
+bd dep add <child> <parent> --type blocks|related|discovered-from
+
+# Synchronization (CRITICAL)
+bd sync                            # Full sync with remote
+bd sync --status                   # Check sync status
+
+# Project health
+bd stats --json                    # Overall statistics
+```
+
+## Priority Levels
+
+- `0` (P0) - Critical: security, data loss, broken builds
+- `1` (P1) - High: major features, important bugs
+- `2` (P2) - Medium: nice-to-have, minor bugs
+- `3` (P3) - Low: polish, optimization
+- `4` (P4) - Backlog: future ideas
+
+## Issue Types
+
+- `bug` - Something broken
+- `feature` - New functionality
+- `task` - General work item
+- `epic` - Large feature with subtasks
+- `chore` - Maintenance work

package/scripts/agent/test-failure-prompt.txt

@@ -0,0 +1,40 @@
+# E2E Test Failure - Create Blocking Fix Task
+
+E2E tests failed during the agent loop. You MUST create a beads task to fix this regression.
+
+## Test Failure Output
+
+```
+{{E2E_OUTPUT}}
+```
+
+## Your Task
+
+1. **Analyze the failure** - Identify which test(s) failed and why
+2. **Create a blocking beads task** with:
+   - Title: "Fix E2E regression: [brief description]"
+   - Type: bug
+   - Priority: 0 (P0 - Critical, blocks all work)
+   - Description: Include the failing test name, error message, and likely cause
+   - Acceptance criteria: "E2E test [name] passes", "Full E2E suite passes"
+
+3. **Add dependency** - If you can identify which recent task likely caused this, link them:
+   ```bash
+   bd dep add <fix-task-id> <causing-task-id> --type discovered-from
+   ```
+
+4. **Sync** - Run `bd sync` to save the task
+
+## Example
+
+```bash
+bd create "Fix E2E regression: Task filter dropdown not visible" \
+  --type bug \
+  --priority 0 \
+  --description "E2E test 'filter dropdown has correct options' fails with: Timeout waiting for selector '[role=combobox]'. Likely caused by recent filter component refactor." \
+  --acceptance "E2E test 'filter dropdown has correct options' passes
+Full E2E suite passes (pnpm e2e)" \
+  --labels "area:frontend,regression"
+```
+
+Do NOT attempt to fix the code in this session. Just create the task with sufficient context for the next iteration to fix it.

package/scripts/agent-loop.sh

@@ -0,0 +1,439 @@
+#!/bin/bash
+# Agent Loop - Long-running AI agent loop using OpenCode with Beads task tracking
+# Usage: agent-loop [max_iterations] [--init-beads]
+#
+# Features:
+# - Uses Beads for distributed, git-backed task tracking
+# - Syncs with remote before each iteration to get latest tasks
+# - Recovers gracefully from unexpected termination
+# - Archives completed runs for historical reference
+#
+# This script is part of the @horizon-ai-dev/shokunin OpenCode plugin.
+# It can be run from any directory with a beads-initialized project.
+
+set -e
+
+MAX_ITERATIONS=${1:-10}
+INIT_BEADS=false
+
+# Parse arguments
+for arg in "$@"; do
+  case $arg in
+    --init-beads)
+      INIT_BEADS=true
+      shift
+      ;;
+    [0-9]*)
+      MAX_ITERATIONS=$arg
+      shift
+      ;;
+  esac
+done
+
+# Resolve script location (handles symlinks from npm bin)
+resolve_script_dir() {
+  local source="${BASH_SOURCE[0]}"
+  local dir
+  # Resolve symlinks
+  while [ -h "$source" ]; do
+    dir="$(cd -P "$(dirname "$source")" && pwd)"
+    source="$(readlink "$source")"
+    # Handle relative symlinks
+    [[ $source != /* ]] && source="$dir/$source"
+  done
+  dir="$(cd -P "$(dirname "$source")" && pwd)"
+  echo "$dir"
+}
+
+SCRIPT_DIR="$(resolve_script_dir)"
+PROMPT_FILE="$SCRIPT_DIR/agent/prompt.txt"
+TEST_FAILURE_PROMPT_FILE="$SCRIPT_DIR/agent/test-failure-prompt.txt"
+
+# Working directory where the user runs the command
+WORK_DIR="$(pwd)"
+BEADS_DIR="$WORK_DIR/.beads"
+AGENT_DIR="$WORK_DIR/.agent-loop"
+CONFIG_FILE="$AGENT_DIR/opencode.json"
+STATE_FILE="$AGENT_DIR/.agent-state"
+
+# Extended timeout for turbo builds (10 minutes in milliseconds)
+export OPENCODE_TIMEOUT=600000
+
+# Color codes for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+log_info() { echo -e "${BLUE}[INFO]${NC} $1"; }
+log_success() { echo -e "${GREEN}[SUCCESS]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
+
+# Create OpenCode config for autonomous mode (all permissions allowed)
+create_opencode_config() {
+  cat > "$CONFIG_FILE" << 'EOF'
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "auto",
+  "autoupdate": false,
+  "compaction": {
+    "auto": true,
+    "prune": true
+  },
+  "permission": {
+    "edit": "allow",
+    "bash": {
+      "*": "allow",
+      "*terraform apply*": "allow",
+      "*terraform destroy*": "allow",
+      "*terraform import*": "allow",
+      "*terraform state rm*": "allow",
+      "*terraform state mv*": "allow",
+      "*terraform taint*": "allow",
+      "*terraform apply -replace*": "allow",
+      "*terraform state replace-provider*": "allow",
+      "*gcloud *": "allow",
+      "*rm -rf*": "allow",
+      "*rm -r*": "allow",
+      "chmod 777": "allow",
+      "chmod -R": "allow",
+      "chown -R": "allow",
+      "*curl http*": "allow",
+      "*wget http*": "allow",
+      "*sudo*": "allow",
+      "*su*": "allow",
+      "bd*": "allow",
+      "*apt install*": "allow",
+      "*apt-get install*": "allow",
+      "*pip install*": "allow",
+      "*pnpm install -g*": "allow",
+      "*yarn global add*": "allow",
+      "*systemctl*": "allow",
+      "*service*": "allow",
+      "*kill -9*": "allow",
+      "*killall*": "allow",
+      "*mount*": "allow",
+      "*umount*": "allow",
+      "*fdisk*": "allow",
+      "*mkfs*": "allow",
+      "*dd*": "allow",
+      "*ssh*": "allow",
+      "*scp*": "allow",
+      "*rsync*": "allow",
+      "*supabase*": "allow",
+      "*psql*": "allow"
+    }
+  }
+}
+EOF
+}
+
+# Check if bd (beads CLI) is available
+check_beads_installed() {
+  if ! command -v bd &> /dev/null; then
+    log_error "Beads CLI (bd) not found. Please install it first:"
+    echo "  curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash"
+    echo "  Or: npm install -g @beads/bd"
+    exit 1
+  fi
+  log_info "Beads CLI found: $(which bd)"
+}
+
+# Check if opencode is available
+check_opencode_installed() {
+  if ! command -v opencode &> /dev/null; then
+    log_error "OpenCode CLI not found. Please install it first:"
+    echo "  npm install -g opencode"
+    exit 1
+  fi
+  log_info "OpenCode CLI found: $(which opencode)"
+}
+
+# Initialize Beads if not already initialized
+init_beads_if_needed() {
+  if [ ! -d "$BEADS_DIR" ]; then
+    if [ "$INIT_BEADS" = true ]; then
+      log_info "Initializing Beads in $WORK_DIR..."
+      bd init --quiet
+      log_success "Beads initialized"
+    else
+      log_error "Beads not initialized. Run with --init-beads or manually run 'bd init'"
+      exit 1
+    fi
+  else
+    log_info "Beads directory found at $BEADS_DIR"
+  fi
+}
+
+# Sync with remote to get latest tasks and push any local changes
+sync_with_remote() {
+  log_info "Syncing with remote..."
+  
+  # First, pull latest git changes
+  if git remote -v | grep -q origin; then
+    git pull --rebase origin "$(git branch --show-current)" 2>/dev/null || {
+      log_warn "Git pull failed, continuing with local state"
+    }
+  fi
+  
+  # Then sync beads (imports from JSONL if newer, exports if DB is newer)
+  bd sync 2>/dev/null || {
+    log_warn "Beads sync had issues, attempting import..."
+    bd import -i .beads/issues.jsonl 2>/dev/null || true
+  }
+  
+  log_success "Sync complete"
+}
+
+# Check for and recover from interrupted work
+check_interrupted_work() {
+  log_info "Checking for interrupted work..."
+  
+  local in_progress=$(bd list --status=in_progress --json 2>/dev/null | jq -r 'length // 0')
+  
+  if [ "$in_progress" -gt 0 ]; then
+    log_warn "Found $in_progress task(s) in progress from previous session"
+    echo "The agent will attempt to resume or reconcile these tasks."
+    
+    # Show the in-progress tasks
+    bd list --status=in_progress --json 2>/dev/null | jq -r '.[] | "  - \(.id): \(.title)"'
+  else
+    log_info "No interrupted work found"
+  fi
+}
+
+# Get current work status for logging
+get_work_status() {
+  local ready=$(bd ready --json 2>/dev/null | jq -r 'length // 0')
+  local in_progress=$(bd list --status=in_progress --json 2>/dev/null | jq -r 'length // 0')
+  local blocked=$(bd blocked --json 2>/dev/null | jq -r 'length // 0')
+  local stats=$(bd stats --json 2>/dev/null)
+  local total_open=$(echo "$stats" | jq -r '.open // 0')
+  local total_closed=$(echo "$stats" | jq -r '.closed // 0')
+  
+  echo "Tasks: Ready=$ready, In-Progress=$in_progress, Blocked=$blocked, Open=$total_open, Closed=$total_closed"
+}
+
+# Save agent state for recovery
+save_state() {
+  local iteration=$1
+  local session_id=$2
+  
+  cat > "$STATE_FILE" << EOF
+{
+  "iteration": $iteration,
+  "session_id": "$session_id",
+  "timestamp": "$(date -Iseconds)",
+  "branch": "$(git branch --show-current 2>/dev/null || echo 'unknown')"
+}
+EOF
+}
+
+# Load previous state if it exists
+load_state() {
+  if [ -f "$STATE_FILE" ]; then
+    cat "$STATE_FILE"
+  else
+    echo "{}"
+  fi
+}
+
+# Archive completed run
+archive_run() {
+  local run_name=$1
+  local archive_dir="$AGENT_DIR/archive"
+  local date_prefix=$(date +%Y-%m-%d-%H%M%S)
+  local archive_path="$archive_dir/$date_prefix-$run_name"
+  
+  mkdir -p "$archive_path"
+  
+  # Export current beads state for the archive
+  bd list --json > "$archive_path/tasks-final.json" 2>/dev/null || true
+  bd stats --json > "$archive_path/stats-final.json" 2>/dev/null || true
+  
+  # Copy agent state
+  [ -f "$STATE_FILE" ] && cp "$STATE_FILE" "$archive_path/"
+  
+  log_info "Run archived to: $archive_path"
+}
+
+# Main execution starts here
+echo ""
+echo "================================================================"
+echo "  Beads-Powered Agent Loop"
+echo "  Max Iterations: $MAX_ITERATIONS"
+echo "  Working Directory: $WORK_DIR"
+echo "================================================================"
+echo ""
+
+# Pre-flight checks
+check_beads_installed
+check_opencode_installed
+init_beads_if_needed
+mkdir -p "$AGENT_DIR"
+
+# Sync with remote to get latest state
+sync_with_remote
+
+# Check for interrupted work from previous runs
+check_interrupted_work
+
+# Show current status
+log_info "$(get_work_status)"
+
+# Create OpenCode config for autonomous mode
+create_opencode_config
+
+# Read the prompt file content
+if [ ! -f "$PROMPT_FILE" ]; then
+  log_error "Prompt file not found at $PROMPT_FILE"
+  log_error "This may indicate a broken installation. Try reinstalling the plugin."
+  exit 1
+fi
+
+PROMPT_CONTENT=$(cat "$PROMPT_FILE")
+
+# Main iteration loop
+for i in $(seq 1 $MAX_ITERATIONS); do
+  echo ""
+  echo "================================================================"
+  echo "  Iteration $i of $MAX_ITERATIONS - $(date '+%Y-%m-%d %H:%M:%S')"
+  echo "================================================================"
+  
+  # Sync before each iteration to catch any external changes
+  log_info "Pre-iteration sync..."
+  sync_with_remote
+  
+  # Show current work status
+  log_info "$(get_work_status)"
+  
+  # Check if there's actually work to do
+  READY_COUNT=$(bd ready --json 2>/dev/null | jq -r 'length // 0')
+  IN_PROGRESS_COUNT=$(bd list --status=in_progress --json 2>/dev/null | jq -r 'length // 0')
+  
+  if [ "$READY_COUNT" -eq 0 ] && [ "$IN_PROGRESS_COUNT" -eq 0 ]; then
+    log_info "No ready or in-progress tasks found"
+    
+    # Check if everything is complete
+    STATS=$(bd stats --json 2>/dev/null)
+    OPEN=$(echo "$STATS" | jq -r '.open // 0')
+    
+    if [ "$OPEN" -eq 0 ]; then
+      log_success "All tasks complete!"
+      archive_run "completed"
+      rm -f "$CONFIG_FILE"
+      exit 0
+    else
+      log_warn "Open tasks exist but none are ready (possibly blocked)"
+      bd blocked --json 2>/dev/null | jq -r '.[] | "  Blocked: \(.id) - \(.title)"' || true
+    fi
+  fi
+  
+  # Generate a unique session title for this iteration
+  SESSION_TITLE="agent-loop-iteration-$i-$(date +%Y%m%d-%H%M%S)"
+  
+  # Save state before running
+  save_state $i "$SESSION_TITLE"
+  
+  # Run opencode in non-interactive mode
+  log_info "Starting OpenCode session: $SESSION_TITLE"
+  
+  OUTPUT=$(OPENCODE_CONFIG="$CONFIG_FILE" opencode run \
+    --title "$SESSION_TITLE" \
+    "$PROMPT_CONTENT" 2>&1 | tee /dev/stderr) || true
+  
+  # Extract session ID from output if available
+  SESSION_ID=$(echo "$OUTPUT" | grep -oP 'session[:\s]+\K[a-zA-Z0-9-]+' | head -1 || echo "iteration-$i")
+  export OPENCODE_SESSION_ID="$SESSION_ID"
+  
+  # Run ALL E2E tests to verify no regressions (if pnpm e2e exists)
+  if [ -f "package.json" ] && grep -q '"e2e"' package.json 2>/dev/null; then
+    log_info "Running full E2E test suite..."
+    E2E_FAILED=false
+    E2E_OUTPUT=$(pnpm e2e --reporter=line 2>&1) || E2E_FAILED=true
+    
+    if [ "$E2E_FAILED" = true ]; then
+      log_error "E2E tests failed! Creating blocking task for remediation..."
+      
+      # Save the failure output for context
+      E2E_FAILURE_FILE="$AGENT_DIR/.e2e-failure-$i"
+      echo "$E2E_OUTPUT" > "$E2E_FAILURE_FILE"
+      
+      # Run opencode with the test-failure prompt to create a blocking beads task
+      if [ -f "$TEST_FAILURE_PROMPT_FILE" ]; then
+        TEST_FAILURE_PROMPT=$(cat "$TEST_FAILURE_PROMPT_FILE")
+        # Replace placeholder with actual test output (first 100 lines to avoid token overflow)
+        TEST_OUTPUT_EXCERPT=$(head -100 "$E2E_FAILURE_FILE")
+        TEST_FAILURE_PROMPT="${TEST_FAILURE_PROMPT//\{\{E2E_OUTPUT\}\}/$TEST_OUTPUT_EXCERPT}"
+        
+        OPENCODE_CONFIG="$CONFIG_FILE" opencode run \
+          --title "e2e-failure-iteration-$i" \
+          "$TEST_FAILURE_PROMPT" 2>&1 | tee /dev/stderr || true
+      else
+        log_warn "Test failure prompt file not found, skipping task creation"
+      fi
+      
+      # Clean up failure file
+      rm -f "$E2E_FAILURE_FILE"
+      
+      # Continue to next iteration (which should pick up the blocking fix task)
+      log_warn "E2E failure recorded as P0 blocking task. Next iteration will prioritize the fix."
+    else
+      log_success "E2E tests passed"
+    fi
+  else
+    log_info "No E2E tests configured (no 'e2e' script in package.json)"
+  fi
+  
+  # Post-iteration sync to ensure all changes are pushed
+  log_info "Post-iteration sync..."
+  bd sync 2>/dev/null || log_warn "Post-iteration sync had issues"
+  
+  # Push git changes
+  if git remote -v | grep -q origin; then
+    git push origin "$(git branch --show-current)" 2>/dev/null || {
+      log_warn "Git push failed, changes are local only"
+    }
+  fi
+  
+  # Check for completion signal
+  if echo "$OUTPUT" | grep -q "<promise>COMPLETE</promise>"; then
+    echo ""
+    log_success "Agent completed all tasks!"
+    log_info "Completed at iteration $i of $MAX_ITERATIONS"
+    
+    # Final sync and archive
+    bd sync 2>/dev/null || true
+    archive_run "completed"
+    
+    # Clean up config file
+    rm -f "$CONFIG_FILE"
+    exit 0
+  fi
+  
+  # Show post-iteration status
+  log_info "Post-iteration: $(get_work_status)"
+  
+  echo ""
+  log_info "Iteration $i complete. Continuing in 2 seconds..."
+  sleep 2
+done
+
+# Final sync before exit
+log_info "Final sync..."
+bd sync 2>/dev/null || true
+
+# Archive the incomplete run
+archive_run "max-iterations-reached"
+
+# Clean up config file
+rm -f "$CONFIG_FILE"
+
+echo ""
+log_warn "Agent reached max iterations ($MAX_ITERATIONS) without completing all tasks."
+log_info "Final status: $(get_work_status)"
+log_info "Run 'bd ready --json' to see remaining tasks"
+log_info "Run 'bd blocked --json' to see blocked tasks"
+exit 1