opencode-goal-mode 0.3.4 → 0.3.5

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## v0.3.5
+
+- Verified the package against the **current** OpenCode plugin API
+  (`@opencode-ai/plugin@1.17.6`, matching OpenCode 1.17.6, now the dev pin): all
+  guard hooks (`chat.message`/`params`, `tool.execute.before`/`after`,
+  `experimental.chat.system.transform`/`text.complete`/`session.compacting`)
+  exist; the guard plugin loads with zero errors; and in a real OpenCode the
+  agent list shows `goal` as the only user-selectable agent with 26 subagents and
+  reviewer `edit`/`task: deny` applied. The enforcement core is unchanged and
+  fully intact.
+- Declared `@opentui/solid`, `solid-js`, `@opencode-ai/plugin` as **optional**
+  peer dependencies (the TUI runtime the sidebar uses).
+- Docs: stated the sidebar's verification status honestly — the experimental TUI
+  banner is verified to load and to render in a real headless OpenTUI test, but
+  its live in-session render depends on your OpenCode build's file-based
+  TUI-plugin support; it never errors and never affects the enforcement core.
+
 ## v0.3.4
 
 Critical fixes found by testing against a real OpenCode (1.17.6) install — the

package/README.md

@@ -41,8 +41,9 @@ opencode agent list | grep goal
    The `goal` agent writes a contract, delegates research/review to subagents, and
    **cannot** answer `Goal Completed` until every required review gate passes — the
    guard rewrites a premature claim to `Goal Not Completed`. Try a destructive
-   command mid-session (e.g. `rm -rf build`) and watch it get blocked. The active
-   goal shows in the sidebar in yellow.
+   command mid-session (e.g. `rm -rf build`) and watch it get blocked. If your
+   OpenCode build supports TUI plugins, the active goal also appears in the sidebar
+   in yellow (experimental — see [TUI integration](#tui-integration)).
 
 That's it. Everything below is detail.
 
@@ -174,14 +175,21 @@ enforcement and writes its state to disk, and an experimental TUI plugin
 - **Sidebar goal banner (experimental).** The current goal renders in shining
   yellow in the sidebar (`sidebar_content` slot), with a `passing/total gates ·
   dirty/ready` status line, and updates as reviews land. When a task is running
-  but **no goal is set**, it shows a clean grey `No goal` and nothing else. It
-  requires a TUI-plugin-capable OpenCode (one exposing `api.slots.register`); on
-  any older runtime it silently no-ops, so it can never break your TUI. Set
+  but **no goal is set**, it shows a clean grey `No goal`. Set
   `sidebarBanner: false` (or `GOAL_GUARD_SIDEBAR_BANNER=0`) to disable,
   `sidebarColor` to recolour the goal, or `sidebarMutedColor` for the "No goal"
-  line. It is rendered-and-asserted headlessly by the
-  [visual test](tools/visual-test/README.md) (`npm run test:visual`); still worth
-  a glance in your own TUI.
+  line.
+
+  **Verification status, honestly:** the component is rendered and asserted
+  (text + exact colours) by a real headless OpenTUI renderer in the
+  [visual test](tools/visual-test/README.md) (`npm run test:visual`, 17/17), and
+  OpenCode discovers and boots it as a plugin without error. It needs a recent
+  OpenCode that mounts file-based TUI plugins into the `sidebar_content` slot and
+  provides the `@opentui/solid` runtime; on a build without that, it simply does
+  not appear (it never errors or breaks the TUI — the enforcement core is a
+  separate server plugin and is unaffected). The banner appears in a **session**
+  view, not the home screen. If it doesn't show, that's the TUI-plugin runtime,
+  not Goal Mode's enforcement.
 - **Toasts.** Review verdicts and completion-unlock events surface as toasts
   (`toastOnReview`), and blocked destructive commands / premature completions
   toast as before (`toastOnBlock`).

package/docs/benchmarks/latency.svg

@@ -4,10 +4,10 @@
 <text x="20" y="47" font-size="12" fill="#656d76">Microseconds to classify one command. Both are negligible for a tool-call guard.</text>
 <text x="218" y="87" font-size="12" text-anchor="end" fill="#1f2328">Legacy regex guard</text>
 <rect x="230" y="70" width="420" height="22" rx="3" fill="#eaeef2"/>
-<rect x="230" y="70" width="212.3" height="22" rx="3" fill="#9aa0a6"/>
-<text x="450.3" y="87" font-size="12" font-weight="600" fill="#1f2328">0.81 µs</text>
+<rect x="230" y="70" width="217.1" height="22" rx="3" fill="#9aa0a6"/>
+<text x="455.1" y="87" font-size="12" font-weight="600" fill="#1f2328">0.75 µs</text>
 <text x="218" y="125" font-size="12" text-anchor="end" fill="#1f2328">Goal Mode analyzer</text>
 <rect x="230" y="108" width="420" height="22" rx="3" fill="#eaeef2"/>
 <rect x="230" y="108" width="300.0" height="22" rx="3" fill="#2da44e"/>
-<text x="538.0" y="125" font-size="12" font-weight="600" fill="#1f2328">1.14 µs</text>
+<text x="538.0" y="125" font-size="12" font-weight="600" fill="#1f2328">1.03 µs</text>
 </svg>

package/docs/benchmarks/results.json

@@ -75,8 +75,8 @@
           "safeFalsePos": 5
         }
       },
-      "opsPerSec": 1238863,
-      "usPerCommand": 0.81
+      "opsPerSec": 1341168,
+      "usPerCommand": 0.75
     },
     "current": {
       "detectionRate": 100,
@@ -111,8 +111,8 @@
           "safeFalsePos": 0
         }
       },
-      "opsPerSec": 876672,
-      "usPerCommand": 1.14
+      "opsPerSec": 970526,
+      "usPerCommand": 1.03
     }
   },
   "completionFixtures": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-goal-mode",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "Strict Goal Mode agents, commands, and guard plugin for OpenCode.",
   "type": "module",
   "engines": {
@@ -82,8 +82,18 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@opencode-ai/plugin": "1.15.13",
+    "@opencode-ai/plugin": "1.17.6",
     "fast-check": "^4.8.0",
     "yaml": "^2.6.1"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.15.0",
+    "@opentui/solid": "*",
+    "solid-js": "*"
+  },
+  "peerDependenciesMeta": {
+    "@opencode-ai/plugin": { "optional": true },
+    "@opentui/solid": { "optional": true },
+    "solid-js": { "optional": true }
   }
 }