@bybrawe/opencode-loop 0.5.16 → 0.5.18

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## 0.5.18
+
+- Fixed package-based installs loading stale OpenCode cache entries after npm had installed a newer release. The installer now pins an existing package config entry to its exact installed version while preserving JSONC comments.
+- Fixed Goal Mode mistaking delayed updates for its own scheduler-created user message as a real user interruption. Loop-owned message IDs remain recognized without hiding a distinct user message.
+- Added a dedicated `opencode-loopd` regression suite for literal argument passing, BOM prompt files, model/agent forwarding, finite-run exit codes, invalid options, and Windows scheduled-task lifecycle behavior.
+- Made finite daemon runs propagate OpenCode failures instead of reporting exit code 0, and reject invalid `--max-runs` values and missing project directories.
+- Added `--model` and `--agent` forwarding to daemon and scheduled-task runs.
+- Fixed Windows Task Scheduler installation failing when `/TR` exceeded its 261-character limit. Scheduled tasks now use a short launcher plus a task-specific JSON config under the local app-data directory, and uninstall removes both artifacts.
+- Made Task Scheduler command launch failures return a nonzero exit code instead of silently succeeding.
+- Added non-mutating `--help` and `--version` handling to the `opencode-loop` installer CLI.
+
+## 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.

package/README.md

@@ -16,7 +16,7 @@ v0.5.11 includes a referenced heartbeat scheduler. This is important in OpenCode
 
 ## Current status
 
-**v0.5.16 fixes idle detection during long-running tools and background subtasks.** The scheduler now treats OpenCode tool lifecycle activity and running child sessions as stronger busy signals than a premature parent idle/status event, so due prompts wait instead of filling the queue. It keeps the Goal Mode and SDK compatibility hardening from v0.5.15.
+**v0.5.18 hardens Goal Mode, package updates, and the background daemon.** Package installs are pinned to the installed version so OpenCode cannot keep loading an older cached release, scheduler-created goal messages no longer self-interrupt on delayed updates, finite daemon failures return nonzero, model/agent selection is supported, and Windows scheduled tasks use a short launcher that stays below the `/TR` limit.
 
 The known update-related symptoms from older builds are fixed:
 
@@ -32,7 +32,7 @@ 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.16 quick behavior guide
+## v0.5.18 quick behavior guide
 
 OpenCode Loop has two triggers now:
 
@@ -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, is pinned to the installer's exact version to bypass stale OpenCode package caches, and duplicate local plugin copies are removed. 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
 
@@ -523,6 +531,14 @@ Limit runs:
 opencode-loopd --project . --every 5m --max-runs 20 --prompt-file loop-prompt.md
 ```
 
+Select the OpenCode model and agent explicitly:
+
+```bash
+opencode-loopd --project . --every 0s --max-runs 1 --model opencode/big-pickle --agent build --prompt-file loop-prompt.md
+```
+
+When `--max-runs` is finite, the daemon exits with the final OpenCode run's nonzero status so scripts and CI can detect failures.
+
 Wait before the first run:
 
 ```bash
@@ -560,6 +576,8 @@ Install a scheduled task:
 opencode-loopd install-task --project "C:\path\to\project" --every 10m --prompt-file loop-prompt.md --name OpenCodeLoop
 ```
 
+You can also pass `--model <provider/model>` and `--agent <name>`. The installer stores long task options in a task-specific JSON file and registers only a short launcher with Task Scheduler, avoiding Windows' 261-character `/TR` limit. `uninstall-task` removes that launcher and JSON config after the task is deleted.
+
 Remove it:
 
 ```powershell
@@ -1112,6 +1130,13 @@ 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.

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.16",
+  "version": "0.5.18",
   "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/loopd-test.mjs && node --check scripts/smoke-test.mjs && node --check scripts/comprehensive-test.mjs",
+    "test": "node scripts/install-test.mjs && node scripts/loopd-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"