opencode-plugin-flow 4.1.8 → 4.1.10

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 One short line per release. For the full rationale behind each entry, see the
 commit history and review evidence.
 
+## [4.1.10] - 2026-06-17
+
+Move Flow session lore onto stable OpenCode instructions so experimental chat hooks no longer shape the default runtime context.
+
+## [4.1.9] - 2026-06-17
+
+Make public Flow command lore self-contained so stale native skill discovery cannot block the required loop.
+
 ## [4.1.8] - 2026-06-17
 
 Make Flow command preflight overrule stale OpenCode command lore, with review instructions bundled where skill discovery can lag.

package/README.md

@@ -21,8 +21,8 @@ The manager still owns every Flow state change. Workers gather evidence; they do
 Use OpenCode's plugin installer when your OpenCode version supports it:
 
 ```bash
-opencode plugin opencode-plugin-flow@4.1.8 --global --force
-npx -y opencode-plugin-flow@4.1.8 sync
+opencode plugin opencode-plugin-flow@4.1.10 --global --force
+npx -y opencode-plugin-flow@4.1.10 sync
 ```
 
 The first command adds Flow to your global OpenCode plugin config or replaces an
@@ -48,7 +48,7 @@ OpenCode config manually instead:
 
 ```json
 {
-  "plugin": ["opencode-plugin-flow@4.1.8"]
+  "plugin": ["opencode-plugin-flow@4.1.10"]
 }
 ```
 
@@ -59,7 +59,7 @@ duplicate entry.
 Then run the same pre-start skill sync and start or restart OpenCode:
 
 ```bash
-npx -y opencode-plugin-flow@4.1.8 sync
+npx -y opencode-plugin-flow@4.1.10 sync
 ```
 
 Project-local skill overrides still work through OpenCode's normal lookup:
@@ -84,19 +84,22 @@ version in your global `opencode.json`.
 To inspect the installed skill set:
 
 ```bash
-npx -y opencode-plugin-flow@4.1.8 doctor
+npx -y opencode-plugin-flow@4.1.10 doctor
 ```
 
 If a command reports `Skill "flow-review" not found. Available skills...` or a
 similar Flow skill-loading error after upgrading, it is usually an older
 OpenCode process or stale resolved command body. Flow command preflight replaces
 public Flow command bodies in the running process, and `/flow-review` no longer
-asks OpenCode to native-load the `flow-review` skill. Run `/flow-status` or the
-doctor command above first. Missing, incomplete, or outdated managed skills can
-still be repaired with:
+asks OpenCode to native-load required public Flow skills. Public Flow command
+preflight replaces stale command bodies with bundled command instructions, so
+`/flow-auto`, `/flow-plan`, `/flow-run`, and `/flow-review` can continue even
+when native skill discovery lags. Run `/flow-status` or the doctor command
+above first. Missing, incomplete, or outdated managed skills can still be
+repaired with:
 
 ```bash
-npx -y opencode-plugin-flow@4.1.8 sync
+npx -y opencode-plugin-flow@4.1.10 sync
 ```
 
 Then restart OpenCode so the refreshed registry is loaded. `sync` manages all
@@ -107,7 +110,9 @@ asks for a user decision instead of overwriting local work.
 
 ## Commands
 
-Commands are thin pointers into skills:
+Commands are bundled entrypoints. OpenCode still syncs the Flow skills for
+discoverability and manual use, but public command execution does not depend on
+native skill discovery for the required Flow loop:
 
 | Command | Purpose |
 | --- | --- |
@@ -142,6 +147,9 @@ There is no `flow_context` and no separate review-record tool. Review evidence i
 The runtime owns only safety:
 
 - `.flow/session.json` is the active source of truth.
+- `.flow/opencode-instructions.md` is a generated OpenCode instruction
+  projection of the active session. It is refreshed from `session.json`; do not
+  edit it.
 - `.flow/history/<session-id>.json` stores closed sessions.
 - Session writes are locked and atomic.
 - Flow writes `.flow/.gitignore` so session state stays out of Git by default.
@@ -159,6 +167,7 @@ Planning quality, decomposition, review depth, validation adequacy, orchestratio
 
 ```text
 .flow/session.json
+.flow/opencode-instructions.md
 .flow/history/<session-id>.json
 .flow/session.lock/
 ```
@@ -192,7 +201,7 @@ First remove `opencode-plugin-flow` from your OpenCode plugin config so future
 OpenCode startups stop loading Flow. Then remove Flow-owned synced skills:
 
 ```bash
-npx -y opencode-plugin-flow@4.1.8 uninstall
+npx -y opencode-plugin-flow@4.1.10 uninstall
 ```
 
 Restart OpenCode after both steps. This removes Flow-owned synced skills when