opencode-plugin-flow 4.1.5 → 4.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/CHANGELOG.md +4 -0
  2. package/README.md +20 -17
  3. package/package.json +1 -1
package/CHANGELOG.md CHANGED
@@ -3,6 +3,10 @@
3
3
  One short line per release. For the full rationale behind each entry, see the
4
4
  commit history and review evidence.
5
5
 
6
+ ## [4.1.6] - 2026-06-16
7
+
8
+ Make Flow's pinned installer path force-aware, so OpenCode replaces older global plugin entries instead of leaving stale versions behind.
9
+
6
10
  ## [4.1.5] - 2026-06-16
7
11
 
8
12
  Make Flow installation follow OpenCode's native plugin installer, with pre-start skill sync and older-version fallback.
package/README.md CHANGED
@@ -14,18 +14,18 @@ Flow v4 is a breaking simplification. It does not preserve v3 session layouts or
14
14
 
15
15
  The manager still owns every Flow state change. Workers gather evidence; they do not approve plans, complete features, or close sessions.
16
16
 
17
- ## Install
17
+ ## Install or update
18
18
 
19
19
  Use OpenCode's plugin installer when your OpenCode version supports it:
20
20
 
21
21
  ```bash
22
- opencode plugin opencode-plugin-flow@4.1.5 --global
23
- npx -y opencode-plugin-flow@4.1.5 sync
22
+ opencode plugin opencode-plugin-flow@4.1.6 --global --force
23
+ npx -y opencode-plugin-flow@4.1.6 sync
24
24
  ```
25
25
 
26
- The first command adds Flow to your global OpenCode plugin config. The `sync`
27
- command pre-installs Flow's managed skills so the next OpenCode startup can load
28
- the refreshed skill registry.
26
+ The first command adds Flow to your global OpenCode plugin config or replaces an
27
+ older pinned Flow entry. The `sync` command pre-installs Flow's managed skills so
28
+ the next OpenCode startup can load the refreshed skill registry.
29
29
 
30
30
  Then start or restart OpenCode. On startup, the plugin syncs its global skills
31
31
  into:
@@ -44,14 +44,18 @@ OpenCode config manually instead:
44
44
 
45
45
  ```json
46
46
  {
47
- "plugin": ["opencode-plugin-flow@4.1.5"]
47
+ "plugin": ["opencode-plugin-flow@4.1.6"]
48
48
  }
49
49
  ```
50
50
 
51
+ When updating through this fallback, replace the older
52
+ `opencode-plugin-flow@...` entry with the new pinned version instead of adding a
53
+ duplicate entry.
54
+
51
55
  Then run the same pre-start skill sync and start or restart OpenCode:
52
56
 
53
57
  ```bash
54
- npx -y opencode-plugin-flow@4.1.5 sync
58
+ npx -y opencode-plugin-flow@4.1.6 sync
55
59
  ```
56
60
 
57
61
  Project-local skill overrides still work through OpenCode's normal lookup:
@@ -66,18 +70,17 @@ the skill registry for the running process, so a just-synced skill can exist on
66
70
  disk while still being unavailable to that process. Flow reports this through
67
71
  `flow_status` as `setup.skills.status: "restart_required"`.
68
72
 
69
- To update a pinned Flow version, replace the existing OpenCode plugin entry and
70
- sync the matching skill bundle:
73
+ To update a pinned Flow version later, rerun the same install command with the
74
+ new version.
71
75
 
72
- ```bash
73
- opencode plugin opencode-plugin-flow@4.1.5 --global --force
74
- npx -y opencode-plugin-flow@4.1.5 sync
75
- ```
76
+ `--force` is intentional here: OpenCode keeps an existing same-package plugin
77
+ entry unless replacement is requested, so the flag avoids leaving an older pinned
78
+ version in your global `opencode.json`.
76
79
 
77
80
  To inspect the installed skill set:
78
81
 
79
82
  ```bash
80
- npx -y opencode-plugin-flow@4.1.5 doctor
83
+ npx -y opencode-plugin-flow@4.1.6 doctor
81
84
  ```
82
85
 
83
86
  If a command reports `Skill "flow-review" not found. Available skills...` or a
@@ -85,7 +88,7 @@ similar Flow skill-loading error, run `/flow-status` or the doctor command above
85
88
  first. Missing, incomplete, or outdated managed skills can be repaired with:
86
89
 
87
90
  ```bash
88
- npx -y opencode-plugin-flow@4.1.5 sync
91
+ npx -y opencode-plugin-flow@4.1.6 sync
89
92
  ```
90
93
 
91
94
  Then restart OpenCode so the refreshed registry is loaded. `sync` manages all
@@ -177,7 +180,7 @@ First remove `opencode-plugin-flow` from your OpenCode plugin config so future
177
180
  OpenCode startups stop loading Flow. Then remove Flow-owned synced skills:
178
181
 
179
182
  ```bash
180
- npx -y opencode-plugin-flow@4.1.5 uninstall
183
+ npx -y opencode-plugin-flow@4.1.6 uninstall
181
184
  ```
182
185
 
183
186
  Restart OpenCode after both steps. This removes Flow-owned synced skills when
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "opencode-plugin-flow",
3
- "version": "4.1.5",
3
+ "version": "4.1.6",
4
4
  "description": "Stateful planning and execution workflow plugin for OpenCode",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",