opencode-auto-loop 0.1.0 → 0.1.2

package/commands/auto-loop.md

@@ -4,27 +4,12 @@ description: Start Auto Loop - auto-continues until task completion
 
 # Auto Loop
 
-Start an iterative development loop that automatically continues until the task is complete.
+Invoke the `auto-loop` tool with the following arguments:
 
-## Setup
+- **task**: $ARGUMENTS
+- **maxIterations**: 100
 
-Create the state file in the project directory:
-
-```bash
-mkdir -p .opencode && cat > .opencode/auto-loop.local.md << 'EOF'
----
-active: true
-iteration: 0
-maxIterations: 100
----
-
-$ARGUMENTS
-EOF
-```
-
-## Task
-
-Now begin working on the task: **$ARGUMENTS**
+After the tool confirms the loop is active, **immediately begin working on the task**. Do not just acknowledge — start doing the work right away.
 
 ## Progress Tracking
 
@@ -38,15 +23,11 @@ Before going idle, you MUST output structured progress so the plugin knows where
 - [ ] What needs to be done next (in priority order)
 ```
 
-The plugin extracts these into the state file for the next iteration's continuation prompt.
-
 ## Completion
 
-When the task is FULLY completed, signal completion by outputting:
+When the task is FULLY completed, signal completion by outputting the promise-DONE XML tag on its own line:
 
-```
 <promise>DONE</promise>
-```
 
 **IMPORTANT:** ONLY output this when the task is COMPLETELY and VERIFIABLY finished. Do NOT output false promises to escape the loop.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-auto-loop",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Auto-continue for OpenCode",
   "main": "src/index.ts",
   "type": "module",

package/skills/auto-loop/SKILL.md

@@ -11,30 +11,19 @@ Start an iterative development loop that automatically continues until the task
 
 The Auto Loop creates a continuous feedback cycle for completing complex tasks:
 
-1. You work on the task until you go idle
-2. The plugin detects the idle state and checks for completion
-3. If not complete, it extracts your progress and prompts you to continue
-4. This repeats until you output the completion promise or max iterations reached
+1. You invoke the `auto-loop` tool, which creates the state file and starts the loop
+2. You work on the task until you go idle
+3. The plugin detects the idle state and checks for completion
+4. If not complete, it extracts your progress and prompts you to continue
+5. This repeats until you output the completion signal or max iterations reached
 
 Your previous work remains accessible through files, git history, and the state file's progress sections.
 
 ## Starting the Loop
 
-When you invoke this skill, create the state file in the project directory:
+**Always use the `auto-loop` tool** to start the loop. Do NOT create the state file manually. The tool handles state file creation, session tracking, and initialization.
 
-```bash
-mkdir -p .opencode && cat > .opencode/auto-loop.local.md << 'EOF'
----
-active: true
-iteration: 0
-maxIterations: 100
----
-
-[The user's task prompt goes here]
-EOF
-```
-
-Then inform the user and begin working on the task.
+After the tool confirms the loop is active, **immediately begin working on the task**. Do not just acknowledge — start doing the work.
 
 ## Progress Tracking - CRITICAL
 
@@ -61,9 +50,9 @@ Use this format in your final message of each iteration:
 - Order ## Next Steps by priority — the continuation will tell you to start from the top
 - The plugin extracts these sections and writes them into `auto-loop.local.md` for the next iteration
 
-## Completion Promise - CRITICAL RULES
+## Completion Signal - CRITICAL RULES
 
-When you have FULLY completed the task, signal completion by outputting:
+When you have FULLY completed the task, signal completion by outputting the promise-DONE XML tag on its own line:
 
 ```
 <promise>DONE</promise>
@@ -71,14 +60,14 @@ When you have FULLY completed the task, signal completion by outputting:
 
 **IMPORTANT CONSTRAINTS:**
 
-- ONLY output `<promise>DONE</promise>` when the task is COMPLETELY and VERIFIABLY finished
-- The statement MUST be completely and unequivocally TRUE
-- Do NOT output false promises to escape the loop, even if you think you're stuck
-- Do NOT lie even if you think you should exit for other reasons
+- ONLY output the completion signal when the task is COMPLETELY and VERIFIABLY finished
+- The completion tag MUST be on its own line (not inline with other text)
+- Do NOT mention or echo the completion tag in explanatory text — only output it as the actual signal
+- Do NOT output false completion signals to escape the loop, even if you think you're stuck
 - If you're blocked, explain the blocker and request help instead of falsely completing
 
 The loop can only be stopped by:
-1. Truthful completion promise
+1. Truthful completion signal
 2. Max iterations reached
 3. User running `/cancel-auto-loop`
 

package/src/index.ts

@@ -30,7 +30,7 @@ type OpencodeClient = PluginInput["client"];
 const SERVICE_NAME = "auto-loop";
 const STATE_FILENAME = "auto-loop.local.md";
 const OPENCODE_CONFIG_DIR = join(homedir(), ".config/opencode");
-const COMPLETION_TAG = /<promise>\s*DONE\s*<\/promise>/is;
+const COMPLETION_TAG = /^\s*<promise>\s*DONE\s*<\/promise>\s*$/im;
 const DEBOUNCE_MS = 2000;
 
 // Get plugin root directory (ESM only — package is "type": "module")
@@ -52,11 +52,13 @@ function copyIfChanged(src: string, dest: string): void {
   cpSync(src, dest, { recursive: true });
 }
 
-// Auto-copy skills and commands to opencode config, updating if content changed
-function setupSkillsAndCommands(log: LogFn): void {
+// Auto-copy skills and commands to opencode config, updating if content changed.
+// Returns true if any new files were copied (first install), false otherwise.
+function setupSkillsAndCommands(log: LogFn): boolean {
   const pluginRoot = getPluginRoot();
   const skillsDir = join(OPENCODE_CONFIG_DIR, "skill");
   const commandsDir = join(OPENCODE_CONFIG_DIR, "command");
+  let newFilesCopied = false;
 
   // Copy skills
   const pluginSkillsDir = join(pluginRoot, "skills");
@@ -65,8 +67,10 @@ function setupSkillsAndCommands(log: LogFn): void {
     for (const skill of skills) {
       const srcFile = join(pluginSkillsDir, skill, "SKILL.md");
       const destFile = join(skillsDir, skill, "SKILL.md");
+      const isNew = !existsSync(destFile);
       try {
         copyIfChanged(srcFile, destFile);
+        if (isNew && existsSync(destFile)) newFilesCopied = true;
       } catch (err) {
         log("warn", `Failed to copy skill '${skill}': ${err}`);
       }
@@ -78,13 +82,18 @@ function setupSkillsAndCommands(log: LogFn): void {
   if (existsSync(pluginCommandsDir)) {
     const commands = ["auto-loop.md", "cancel-auto-loop.md", "auto-loop-help.md"];
     for (const cmd of commands) {
+      const destCmd = join(commandsDir, cmd);
+      const isNew = !existsSync(destCmd);
       try {
-        copyIfChanged(join(pluginCommandsDir, cmd), join(commandsDir, cmd));
+        copyIfChanged(join(pluginCommandsDir, cmd), destCmd);
+        if (isNew && existsSync(destCmd)) newFilesCopied = true;
       } catch (err) {
         log("warn", `Failed to copy command '${cmd}': ${err}`);
       }
     }
   }
+
+  return newFilesCopied;
 }
 
 // Get state file path (project-relative)
@@ -182,9 +191,11 @@ function clearState(directory: string, log: LogFn): void {
   }
 }
 
-// Strip markdown code fences before checking for completion tag
+// Strip markdown code fences and inline code before checking for completion tag
 function stripCodeFences(text: string): string {
-  return text.replace(/```[\s\S]*?```/g, "");
+  return text
+    .replace(/```[\s\S]*?```/g, "") // triple-backtick blocks
+    .replace(/`[^`]+`/g, "");       // inline backtick code
 }
 
 // Extract text from the last assistant message in a session
@@ -366,8 +377,12 @@ export const AutoLoopPlugin: Plugin = async (ctx) => {
     }
   };
 
-  // Auto-setup skills and commands
-  setupSkillsAndCommands(log);
+  // Auto-setup skills and commands — notify on first install
+  const isFirstInstall = setupSkillsAndCommands(log);
+  if (isFirstInstall) {
+    toast("Auto Loop installed — restart opencode to enable /auto-loop commands", "warning");
+    log("info", "First install detected — commands copied, restart needed for slash commands");
+  }
 
   // Debounce tracking for idle events
   let lastContinuation = 0;
@@ -403,7 +418,9 @@ export const AutoLoopPlugin: Plugin = async (ctx) => {
 
 Task: ${task}
 
-I will auto-continue until the task is complete. Before going idle each iteration, I will output structured progress:
+**Begin working on the task now.** The loop will auto-continue until you signal completion.
+
+Before going idle each iteration, output structured progress:
 
 \`\`\`
 ## Completed
@@ -413,7 +430,7 @@ I will auto-continue until the task is complete. Before going idle each iteratio
 - [ ] What remains (in priority order)
 \`\`\`
 
-When fully done, I will output \`<promise>DONE</promise>\` to signal completion.
+When the task is FULLY and VERIFIABLY complete, output the completion signal on its own line (the promise-DONE XML tag). Do NOT mention or echo the completion tag until you are truly done.
 
 Use /cancel-auto-loop to stop early.`;
         },
@@ -480,7 +497,9 @@ Located at: .opencode/auto-loop.local.md`;
         // Fetch last assistant message (used for completion check + progress extraction)
         const lastText = await getLastAssistantText(client, sessionId, directory, log);
 
-        if (lastText && checkCompletion(lastText)) {
+        // Skip completion check on iteration 0 (first idle after loop start)
+        // to avoid false positives from the tool's initial response text
+        if (state.iteration > 0 && lastText && checkCompletion(lastText)) {
           clearState(directory, log);
           log("info", `Loop completed at iteration ${state.iteration}`);
           toast(`Auto Loop completed after ${state.iteration} iteration(s)`, "success");