@prevalentware/opencode-goal-plugin 0.1.14 → 0.1.16

package/README.md

@@ -1,8 +1,20 @@
 # OpenCode Goal Plugin
 
-Codex-style long-running goal mode for OpenCode.
+[![npm version](https://img.shields.io/npm/v/@prevalentware/opencode-goal-plugin.svg)](https://www.npmjs.com/package/@prevalentware/opencode-goal-plugin)
+[![GitHub repository](https://img.shields.io/badge/GitHub-prevalentWare%2Fopencode--goal--plugin-blue?logo=github)](https://github.com/prevalentWare/opencode-goal-plugin)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-This plugin adds:
+OpenCode Goal Plugin adds Codex-style long-running goal mode to OpenCode. It gives AI coding agents a `/goal` slash command, persistent goal state, completion evidence, idle continuation, and a terminal UI goal indicator so an OpenCode session can keep working toward one explicit objective until it is complete, blocked, or cleared.
+
+If you are searching for an OpenCode goal plugin, goal mode for OpenCode, or a way to keep an OpenCode AI coding agent focused on a long-running task, this package is the npm plugin for that workflow.
+
+Links:
+
+- npm package: [`@prevalentware/opencode-goal-plugin`](https://www.npmjs.com/package/@prevalentware/opencode-goal-plugin)
+- GitHub repository: [`prevalentWare/opencode-goal-plugin`](https://github.com/prevalentWare/opencode-goal-plugin)
+- OpenCode plugin command: `opencode plugin @prevalentware/opencode-goal-plugin`
+
+The OpenCode Goal Plugin adds:
 
 - `/goal <objective>` as an OpenCode command for TUI, desktop, and web.
 - A sidebar goal indicator with status, elapsed time, and objective.
@@ -12,6 +24,17 @@ This plugin adds:
 - Optional automatic continuation on `session.idle`.
 - Compaction context so active goals are preserved when OpenCode summarizes a long session.
 
+## Why Use This OpenCode Goal Plugin?
+
+Use this plugin when you want OpenCode to behave more like a goal-driven coding agent instead of a one-prompt assistant. A goal stays visible, survives session compaction, can continue automatically when the session becomes idle, and can only be closed with explicit evidence or a concrete blocker.
+
+Common use cases:
+
+- Keep an OpenCode agent focused during long refactors, migrations, reviews, or test-fixing sessions.
+- Track one explicit objective across TUI, desktop, and web OpenCode surfaces.
+- Require completion evidence before a goal is marked done.
+- Preserve the current goal when OpenCode summarizes or compacts a long conversation.
+
 ## Install
 
 Install locally for the current OpenCode project:

package/package.json

@@ -1,11 +1,19 @@
 {
   "name": "@prevalentware/opencode-goal-plugin",
-  "version": "0.1.14",
-  "description": "Codex-style long-running goal mode for OpenCode.",
+  "version": "0.1.16",
+  "description": "OpenCode goal plugin that adds Codex-style long-running goal mode, /goal commands, persistence, and TUI status for AI coding agents.",
   "keywords": [
     "opencode",
     "opencode-plugin",
+    "opencode goal plugin",
+    "opencode goal mode",
+    "opencode ai",
     "goal",
+    "goal-mode",
+    "slash-command",
+    "coding-agent",
+    "ai-agent",
+    "developer-tools",
     "agent",
     "tui"
   ],

package/src/tui.tsx

@@ -37,6 +37,8 @@ type GoalSessionState = {
   messageIndex: number
 }
 
+const goalCache = new Map<string, GoalSnapshot>()
+
 function currentSessionID(api: TuiPluginApi) {
   const route = api.route.current
   if (route.name !== "session") return undefined
@@ -175,7 +177,7 @@ function parseGoalToolOutput(part: GoalToolPart): GoalSnapshot | null | undefine
   }
 }
 
-function goalStateFromSession(api: TuiPluginApi, sessionID: string): GoalSessionState {
+export function goalStateFromSession(api: TuiPluginApi, sessionID: string): GoalSessionState {
   const messages = [...api.state.session.messages(sessionID)] as SessionMessage[]
   for (let messageIndex = messages.length - 1; messageIndex >= 0; messageIndex -= 1) {
     const message = messages[messageIndex]
@@ -183,10 +185,14 @@ function goalStateFromSession(api: TuiPluginApi, sessionID: string): GoalSession
     const parts = [...api.state.part(message.id)].reverse() as GoalToolPart[]
     for (const part of parts) {
       const goal = parseGoalToolOutput(part)
-      if (goal !== undefined) return { goal, messageIndex }
+      if (goal !== undefined) {
+        if (goal) goalCache.set(sessionID, goal)
+        else goalCache.delete(sessionID)
+        return { goal, messageIndex }
+      }
     }
   }
-  return { goal: null, messageIndex: -1 }
+  return { goal: goalCache.get(sessionID) ?? null, messageIndex: -1 }
 }
 
 function goalFromSession(api: TuiPluginApi, sessionID: string) {