@bybrawe/opencode-loop 0.5.15 → 0.5.17

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.5.17
+
+- Prevented OpenCode project bootstrap deadlocks by deferring local SDK logging and session discovery until after plugin hooks are returned.
+- Added a tool-denied `opencode-loop-local` command agent for all 30 slash commands, preventing local status/control commands from spawning tools or background subagents; scheduled work restores the normal agent/model context.
+- Made the installer detect package-based plugin configuration in JSON or JSONC and remove duplicate local plugin copies instead of loading two schedulers.
+- Fixed watched jobs so file changes actually trigger them, while unchanged paths remain dormant.
+- Fixed preset parsing for explicit `0s`, flag-only presets, and custom `/loop-testfix` commands.
+- Fixed command-event deduplication so compatibility events are suppressed without swallowing intentional repeated commands.
+- Hardened safe shell detection for PowerShell and `rm` variants, removed the `npm run format` false positive, and paused invalid synchronous actions instead of retrying them indefinitely.
+- Added comprehensive parser, preset, lifecycle, watch, safety, routing, goal, installer, JSONC, and initialization regression coverage.
+
+## 0.5.16
+
+- Treat active OpenCode tools, shell calls, and foreground or background subtasks as busy even if the parent session receives an idle/status event while they are still running.
+- Prevent stale active-run recovery from finalizing a loop turn while any tracked tool call remains active.
+- Added regression coverage proving that a due loop waits for long-running tools and background child sessions, then resumes only after that work finishes and the parent session becomes idle.
+
 ## 0.5.15
 
 - Hardened experimental Goal Mode completion: agent tool completion now requires concrete evidence instead of accepting empty or generic claims.

package/README.md

@@ -16,7 +16,7 @@ v0.5.11 includes a referenced heartbeat scheduler. This is important in OpenCode
 
 ## Current status
 
-**v0.5.15 is a Goal Mode and SDK compatibility hardening release.** It keeps the timer/watchdog reliability fixes from v0.5.11-v0.5.14, then tightens experimental goals with evidence-gated completion, passing-check requirements, no-progress pausing, user-message interruption, explicit workspace paths, and safer active-turn recovery. It also prefers the OpenCode plugin SDK argument shape while keeping fallbacks for older builds.
+**v0.5.17 hardens command, installer, and scheduler behavior around the v0.5.16 busy-detection fix.** Long-running tools and child sessions remain authoritative busy signals. Local `/loop-*` commands now use a tool-denied acknowledgement agent, scheduled work restores the normal agent/model context, package/local duplicate loading is prevented, watched jobs fire correctly, and preset/safe-shell edge cases have regression coverage.
 
 The known update-related symptoms from older builds are fixed:
 
@@ -32,14 +32,14 @@ The known update-related symptoms from older builds are fixed:
 
 The TUI loop is still intentionally session-bound: it runs while OpenCode is open and the current session emits status/idle events. For long-running background work after closing the terminal or OpenCode, use `opencode-loopd`.
 
-## v0.5.15 quick behavior guide
+## v0.5.17 quick behavior guide
 
 OpenCode Loop has two triggers now:
 
 1. **Idle/status events** from OpenCode. These are used when OpenCode finishes a turn.
 2. **A real due timer** inside the plugin. This wakes delayed jobs even when no new OpenCode event happens.
 
-All TUI jobs are still idle-safe. If the timer expires while OpenCode is busy, the job does not interrupt the active turn. It waits and retries until the session becomes idle.
+All TUI jobs are still idle-safe. If the timer expires while OpenCode is busy, or while a tool/background child session is still executing, the job does not interrupt the active turn. It waits and retries until that work finishes and the parent session becomes idle.
 
 Simple examples:
 
@@ -79,7 +79,7 @@ Run a shell command every 10 minutes when idle.
 
 Experimental persistent goal mode: keep working until the goal is complete, blocked, paused, cleared, or a safety limit is reached.
 
-> Note: OpenCode custom command markdown still creates a tiny assistant turn for slash commands. v0.5.11 keeps these command templates short and asks the model to reply `OK`. The actual loop scheduling is handled locally by the plugin. If that short turn briefly makes OpenCode look busy, the loop now recovers with fresh status checks, stale-active-run recovery, and a watchdog that does not require another manual command.
+> Note: OpenCode custom command markdown still creates an assistant turn for slash commands. v0.5.17 routes that acknowledgement through the installed `opencode-loop-local` agent, which denies tools and subagents. The real scheduled iteration explicitly restores the normal coding agent/model, so a status or control command cannot launch background exploration or leave later loop work tool-disabled.
 
 ## Why this exists
 
@@ -157,14 +157,14 @@ Use the npm installer from any shell: Windows PowerShell, Windows CMD, macOS, or
 npx -y @bybrawe/opencode-loop@latest
 ```
 
-The installer copies the plugin and slash command files into your OpenCode config directory. It also ensures that the config directory has a `package.json` dependency on `@opencode-ai/plugin`, which local `.ts` plugins need for the `tool()` helper.
-It also removes the old local `opencode-loop.js` copy from earlier releases so only the current local `opencode-loop.ts` plugin remains.
+The installer copies the slash command files and the tool-denied local command agent into your OpenCode config directory. If `@bybrawe/opencode-loop` is already present in the OpenCode `plugin` array, that package entry remains authoritative and the installer removes duplicate local plugin copies. Otherwise it installs `opencode-loop.ts` locally and ensures the config directory has the `@opencode-ai/plugin` dependency required by `tool()`.
 
 Windows target paths:
 
 ```text
 %USERPROFILE%\.config\opencode\plugins\opencode-loop.ts
 %USERPROFILE%\.config\opencode\commands\loop*.md
+%USERPROFILE%\.config\opencode\agents\opencode-loop-local.md
 ```
 
 macOS / Linux target paths:
@@ -172,6 +172,7 @@ macOS / Linux target paths:
 ```text
 ~/.config/opencode/plugins/opencode-loop.ts
 ~/.config/opencode/commands/loop*.md
+~/.config/opencode/agents/opencode-loop-local.md
 ```
 
 Then fully restart OpenCode and run:
@@ -195,9 +196,9 @@ The `npx` installer installs both parts:
 
 - the OpenCode plugin file
 - the `/loop-*` command markdown files
+- the tool-denied `opencode-loop-local` acknowledgement agent
 
-Use the OpenCode config-only method only if you already installed the command files separately or you are only testing plugin loading.
-Do not use the config package entry and the local `npx`-installed plugin at the same time unless you intentionally want to test duplicate plugin loading.
+The installer automatically avoids loading both the package entry and a local plugin copy. It can therefore be rerun safely after switching installation styles.
 
 ### Optional: OpenCode config package entry
 
@@ -220,7 +221,7 @@ If `/loop` does not appear after using only the config method, run the installer
 npx -y @bybrawe/opencode-loop
 ```
 
-If you later switch back to the recommended `npx` local install, remove `@bybrawe/opencode-loop` from the `plugin` array to avoid loading the package plugin and local plugin together.
+If you later remove `@bybrawe/opencode-loop` from the `plugin` array, rerun the installer so it restores the local plugin copy.
 
 ### Install from GitHub
 
@@ -257,16 +258,19 @@ Windows PowerShell:
 ```powershell
 mkdir "$env:USERPROFILE\.config\opencode\plugins" -Force
 mkdir "$env:USERPROFILE\.config\opencode\commands" -Force
+mkdir "$env:USERPROFILE\.config\opencode\agents" -Force
 copy .\src\index.js "$env:USERPROFILE\.config\opencode\plugins\opencode-loop.ts"
 copy .\commands\*.md "$env:USERPROFILE\.config\opencode\commands\"
+copy .\agents\*.md "$env:USERPROFILE\.config\opencode\agents\"
 ```
 
 macOS / Linux:
 
 ```bash
-mkdir -p ~/.config/opencode/plugins ~/.config/opencode/commands
+mkdir -p ~/.config/opencode/plugins ~/.config/opencode/commands ~/.config/opencode/agents
 cp ./src/index.js ~/.config/opencode/plugins/opencode-loop.ts
 cp ./commands/*.md ~/.config/opencode/commands/
+cp ./agents/*.md ~/.config/opencode/agents/
 ```
 
 ### Project-local install
@@ -274,9 +278,10 @@ cp ./commands/*.md ~/.config/opencode/commands/
 Use this when you want the plugin to be available only inside one repository.
 
 ```bash
-mkdir -p .opencode/plugins .opencode/commands
+mkdir -p .opencode/plugins .opencode/commands .opencode/agents
 cp ./src/index.js .opencode/plugins/opencode-loop.ts
 cp ./commands/*.md .opencode/commands/
+cp ./agents/*.md .opencode/agents/
 ```
 
 On Windows PowerShell:
@@ -284,8 +289,10 @@ On Windows PowerShell:
 ```powershell
 mkdir .opencode\plugins -Force
 mkdir .opencode\commands -Force
+mkdir .opencode\agents -Force
 copy .\src\index.js .opencode\plugins\opencode-loop.ts
 copy .\commands\*.md .opencode\commands\
+copy .\agents\*.md .opencode\agents\
 ```
 
 ### Verify installation
@@ -302,7 +309,8 @@ If the commands do not appear:
 1. Make sure OpenCode was fully restarted.
 2. Check that `opencode-loop.ts` exists in the OpenCode plugin directory.
 3. Check that `loop.md`, `loop-help.md`, and the other command files exist in the OpenCode commands directory.
-4. Run `npx -y @bybrawe/opencode-loop` again to reinstall the command files.
+4. Check that `opencode-loop-local.md` exists in the OpenCode agents directory.
+5. Run `npx -y @bybrawe/opencode-loop` again to reinstall the command and agent files.
 
 ## Quick start
 
@@ -352,7 +360,7 @@ Experimental goal mode: keep working until the objective is actually done, block
 
 ### What “when idle” means
 
-OpenCode Loop is idle-safe. It does **not** intentionally start a new agent turn while OpenCode is already busy.
+OpenCode Loop is idle-safe. It does **not** intentionally start a new agent turn while OpenCode is already busy. Active tool calls and running child sessions also count as busy, even if OpenCode emits a premature idle/status signal for the parent during long-running background work.
 
 Example:
 
@@ -1112,6 +1120,19 @@ Improve the application in small safe steps.
 
 ## Changelog highlights
 
+### v0.5.17
+
+- Added a tool-denied local command agent and restored the normal coding agent/model for scheduled iterations.
+- Prevented package/local duplicate plugin loading and deferred bootstrap SDK calls to avoid project startup deadlocks.
+- Fixed watched jobs, preset parsing, repeated-command deduplication, safe-shell patterns, and invalid-action retry storms.
+- Added comprehensive command, lifecycle, installer, JSONC, scheduler, and safety regression tests.
+
+### v0.5.16
+
+- Treat active tools, shell calls, and running foreground/background child sessions as busy even when the parent session appears idle.
+- Prevent stale-run recovery from enqueueing another continuation while tracked background work is still active.
+- Added regression tests for long-running tool calls and background child sessions.
+
 ### v0.5.15
 
 - Hardened experimental Goal Mode completion with concrete evidence, passing-check requirements, no-progress pausing, and user-message interruption.

package/agents/opencode-loop-local.md

@@ -0,0 +1,10 @@
+---
+description: Handles OpenCode Loop slash-command acknowledgements without tools.
+mode: primary
+permission:
+  "*": deny
+---
+
+The OpenCode Loop plugin has already handled the slash command locally.
+Never call tools, spawn subagents, inspect files, or perform additional work.
+Reply exactly: OK

package/commands/loop-ask.md

@@ -1,5 +1,6 @@
 ---
 description: Schedule a recurring prompt/question. Usage: /loop-ask 1h did you run tests?
+agent: opencode-loop-local
 ---
 
 OpenCode Loop ask scheduler handled locally. Reply exactly: OK.

package/commands/loop-clear.md

@@ -1,5 +1,6 @@
 ---
 description: Clear all OpenCode Loop jobs for this session.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop clear command handled locally. Reply exactly: OK.

package/commands/loop-cmd.md

@@ -1,5 +1,6 @@
 ---
 description: Alias for /loop-command. Usage: /loop-cmd 200m /compact
+agent: opencode-loop-local
 ---
 
 OpenCode Loop command scheduler handled locally. Reply exactly: OK.

package/commands/loop-command.md

@@ -1,5 +1,6 @@
 ---
 description: Schedule an OpenCode slash command loop. Usage: /loop-command 200m /compact
+agent: opencode-loop-local
 ---
 
 OpenCode Loop command scheduler handled locally. Reply exactly: OK.

package/commands/loop-compact.md

@@ -1,5 +1,6 @@
 ---
 description: OpenCode Loop plugin command.
+agent: opencode-loop-local
 ---
 
 Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-dev.md

@@ -1,5 +1,6 @@
 ---
 description: OpenCode Loop plugin command.
+agent: opencode-loop-local
 ---
 
 Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-doctor.md

@@ -1,5 +1,6 @@
 ---
 description: Run OpenCode Loop diagnostics.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop doctor command handled locally. Reply exactly: OK.

package/commands/loop-export.md

@@ -1,5 +1,6 @@
 ---
 description: Export OpenCode Loop state.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop export command handled locally. Reply exactly: OK.

package/commands/loop-goal-blocked.md

@@ -1,5 +1,6 @@
 ---
 description: Mark experimental goal blocked.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop experimental goal blocked command handled locally. Reply exactly: OK.

package/commands/loop-goal-clear.md

@@ -1,5 +1,6 @@
 ---
 description: Clear experimental goal jobs.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop experimental goal clear command handled locally. Reply exactly: OK.

package/commands/loop-goal-done.md

@@ -1,5 +1,6 @@
 ---
 description: Mark experimental goal done.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop experimental goal done command handled locally. Reply exactly: OK.

package/commands/loop-goal-pause.md

@@ -1,5 +1,6 @@
 ---
 description: Pause experimental goal jobs.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop experimental goal pause command handled locally. Reply exactly: OK.

package/commands/loop-goal-resume.md

@@ -1,5 +1,6 @@
 ---
 description: Resume experimental goal jobs.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop experimental goal resume command handled locally. Reply exactly: OK.

package/commands/loop-goal-status.md

@@ -1,5 +1,6 @@
 ---
 description: Show experimental goal status.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop experimental goal status command handled locally. Reply exactly: OK.

package/commands/loop-goal.md

@@ -1,5 +1,6 @@
 ---
 description: Experimental persistent goal mode. Usage: /loop-goal finish the feature and keep tests green
+agent: opencode-loop-local
 ---
 
 OpenCode Loop experimental goal command handled locally. Reply exactly: OK.

package/commands/loop-help.md

@@ -1,5 +1,6 @@
 ---
 description: Show OpenCode Loop help.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop help command handled locally. Reply exactly: OK.

package/commands/loop-init.md

@@ -1,5 +1,6 @@
 ---
 description: Create a starter progress.md file.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop init command handled locally. Reply exactly: OK.

package/commands/loop-logs.md

@@ -1,5 +1,6 @@
 ---
 description: Show OpenCode Loop logs.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop logs command handled locally. Reply exactly: OK.

package/commands/loop-now.md

@@ -1,5 +1,6 @@
 ---
 description: Run due OpenCode Loop jobs now when idle.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop run-now command handled locally. Reply exactly: OK.

package/commands/loop-pause.md

@@ -1,5 +1,6 @@
 ---
 description: Pause OpenCode Loop jobs.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop pause command handled locally. Reply exactly: OK.

package/commands/loop-progress.md

@@ -1,5 +1,6 @@
 ---
 description: OpenCode Loop plugin command.
+agent: opencode-loop-local
 ---
 
 Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-prompt.md

@@ -1,5 +1,6 @@
 ---
 description: Schedule a recurring prompt loop. Usage: /loop-prompt 1h continue the project
+agent: opencode-loop-local
 ---
 
 Loop prompt scheduler received. The OpenCode Loop plugin handles this recurring prompt locally. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-remove.md

@@ -1,5 +1,6 @@
 ---
 description: OpenCode Loop plugin command.
+agent: opencode-loop-local
 ---
 
 Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-resume.md

@@ -1,5 +1,6 @@
 ---
 description: Resume OpenCode Loop jobs.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop resume command handled locally. Reply exactly: OK.

package/commands/loop-safe-dev.md

@@ -1,5 +1,6 @@
 ---
 description: OpenCode Loop plugin command.
+agent: opencode-loop-local
 ---
 
 Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop-shell.md

@@ -1,5 +1,6 @@
 ---
 description: Schedule a recurring shell command. Usage: /loop-shell 10m npm test
+agent: opencode-loop-local
 ---
 
 OpenCode Loop shell scheduler handled locally. Reply exactly: OK.

package/commands/loop-status.md

@@ -1,5 +1,6 @@
 ---
 description: Show OpenCode Loop status.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop status command handled locally. Reply exactly: OK.

package/commands/loop-stop.md

@@ -1,5 +1,6 @@
 ---
 description: Stop OpenCode Loop jobs.
+agent: opencode-loop-local
 ---
 
 OpenCode Loop stop command handled locally. Reply exactly: OK.

package/commands/loop-testfix.md

@@ -1,5 +1,6 @@
 ---
 description: OpenCode Loop plugin command.
+agent: opencode-loop-local
 ---
 
 Loop command received. The OpenCode Loop plugin handles this command. Do not explain this command, do not search the web, do not create scheduler files, and do not run extra shell commands because of this command.

package/commands/loop.md

@@ -1,5 +1,6 @@
 ---
 description: Start an OpenCode auto-continue loop. Usage: /loop 5m <task>
+agent: opencode-loop-local
 ---
 
 OpenCode Loop local command handled. Reply exactly: OK.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bybrawe/opencode-loop",
-  "version": "0.5.15",
+  "version": "0.5.17",
   "description": "Claude Code/Codex style /loop and experimental goal mode for OpenCode: heartbeat scheduler, idle-safe loops, scheduled commands, compact scheduling, verification, checkpoints, and persistent coding goals.",
   "type": "module",
   "main": "src/index.js",
@@ -10,6 +10,7 @@
   "files": [
     "src",
     "commands",
+    "agents",
     "scripts",
     "examples",
     "README.md",
@@ -17,8 +18,8 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "check": "node --check src/index.js && node --check scripts/install-node.mjs && node --check scripts/loopd.mjs && node --check scripts/smoke-test.mjs",
-    "test": "node scripts/smoke-test.mjs",
+    "check": "node --check src/index.js && node --check scripts/install-node.mjs && node --check scripts/loopd.mjs && node --check scripts/install-test.mjs && node --check scripts/smoke-test.mjs && node --check scripts/comprehensive-test.mjs",
+    "test": "node scripts/install-test.mjs && node scripts/smoke-test.mjs && node scripts/comprehensive-test.mjs",
     "install:global": "node scripts/install-node.mjs",
     "pack:zip": "node scripts/make-zip.mjs"
   },
@@ -59,8 +60,8 @@
     "@opencode-ai/plugin": "^1.4.0"
   },
   "bin": {
-    "opencode-loop": "./scripts/install-node.mjs",
-    "opencode-loopd": "./scripts/loopd.mjs"
+    "opencode-loop": "scripts/install-node.mjs",
+    "opencode-loopd": "scripts/loopd.mjs"
   },
   "publishConfig": {
     "access": "public"