opencode-goal-mode 0.3.9 → 0.3.10

package/ARCHITECTURE.md

@@ -188,8 +188,9 @@ progress is visible even without the banner.
 The JSX renderer is verified headlessly with `@opentui/solid`'s `testRender` in
 `tools/visual-test/sidebar-visual.jsx` (`npm run test:visual`, needs Bun + the
 OpenTUI stack): it asserts the rendered text, the exact foreground colours, and
-the bold attribute for Goal todo / done / native-todo-preserved states. That tool is excluded from
-the npm package and from `node --test`/CI.
+the bold attribute for Goal todo / done / native-todo-preserved states. That tool
+is excluded from the npm package and from `node --test`; the GitHub CI workflow
+runs it in a separate Bun/OpenTUI job.
 
 ## Configuration
 

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## v0.3.10
+
+- Clarified the recommended install command to use a persistent global npm install
+  before running the installer, so OpenCode can resolve the TUI package on future
+  starts. `npx` remains documented for temporary installs/server-side checks.
+- Added the missing historical `v0.3.8` changelog section. `v0.3.8` reached npm,
+  but its GitHub Release workflow failed while generating release notes, so it was
+  superseded by `v0.3.9`.
+
 ## v0.3.9
 
 - Installer docs and `--help` now put the one-command `npx opencode-goal-mode --global`
@@ -12,6 +21,12 @@
 - Destructive-command blocking no longer activates Goal enforcement for Build or
   other non-Goal sessions, preventing non-Goal tasks from being classified as goals.
 
+## v0.3.8
+
+- Superseded release: npm publish succeeded, but the GitHub Release workflow failed
+  because the changelog section was still named `Unreleased`. The same functional
+  changes shipped correctly in `v0.3.9` with matching npm and GitHub releases.
+
 ## v0.3.7
 
 - **FIX: the sidebar now actually loads.** OpenCode loads a TUI plugin via the

package/README.md

@@ -17,14 +17,15 @@ TUI sidebar.
 **One command** (recommended; needs [Node](https://nodejs.org) 20.11+ and a working [OpenCode](https://opencode.ai) install):
 
 ```bash
-npx opencode-goal-mode --global
+npm install -g opencode-goal-mode && opencode-goal-mode --global
 ```
 
 Then **restart OpenCode**. That's the whole install: it copies the Goal agent,
 review subagents, slash commands, and guard plugin into `~/.config/opencode`, and
 merge-safely registers the Goal todo sidebar in `~/.config/opencode/tui.json`.
 In the agent picker you'll see only the **`goal`** agent; reviewers are subagents
-it drives automatically. Goal Mode inherits your existing OpenCode model/provider.
+it drives automatically. The global install keeps the TUI package resolvable on
+future OpenCode starts; Goal Mode inherits your existing OpenCode model/provider.
 
 <details>
 <summary>Other ways to install</summary>
@@ -34,6 +35,10 @@ it drives automatically. Goal Mode inherits your existing OpenCode model/provide
 npm install -g opencode-goal-mode
 opencode-goal-mode --global          # alias of opencode-goal-mode-install
 
+# Temporary npx install (server-side components work; for the TUI sidebar,
+# prefer the global install above so OpenCode can resolve the package later)
+npx opencode-goal-mode --global
+
 # Into a single project (writes ./.opencode, including ./.opencode/tui.json)
 npx opencode-goal-mode
 
@@ -253,6 +258,7 @@ enforcement and writes its state to disk, and an experimental TUI plugin
 ## Installer options
 
 ```bash
+npm install -g opencode-goal-mode && opencode-goal-mode --global
 npx opencode-goal-mode --global --dry-run
 npx opencode-goal-mode --global
 opencode-goal-mode-install --global --uninstall

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-goal-mode",
-  "version": "0.3.9",
+  "version": "0.3.10",
   "description": "Strict Goal Mode agents, commands, and guard plugin for OpenCode.",
   "type": "module",
   "main": "plugins/goal-sidebar.tsx",