opencode-plugin-flow 3.3.3 → 3.3.4

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 ## [Unreleased]
 
+## [3.3.4] - 2026-06-13
+
+Prune the historical maze and promote the living contracts
+
+Flow's current behavior was already defined by the skills-first maintainer contract, the source, and tests, but the docs tree still carried a large pre-v3 paper trail: superseded plans, incident investigations, and retired architecture archives. Those files were useful while the architecture was moving quickly, but by 3.3 they had become a navigation hazard — easy to quote as if they were current, noisy enough to hide the actual contracts, and stale enough to send maintainers back into deleted prompt/projection doctrine.
+
+This release removes that historical maze. The durable skills-first architecture decision is now captured as ADR 0001; the remaining current lessons from the deleted investigations are distilled into a skill review checklist; the maintainer contract now names the workspace root guard and hidden-root edit approval as separate write gates; and release/contributor docs now point maintainers to ADRs, current docs, source, and tests for present-day contracts. Release notes and `CHANGELOG.md` remain historical records, but stale release-note links were replaced where they would otherwise point at deleted plans.
+
+The completion lane also gets its named maintainer affordance back: `bun run check:completion-lane` now runs the focused final-completion, semantic-invariant, hard-invariant, and recovery tests referenced by the transition owner. The package version and README exact install pin move together to `3.3.4` so OpenCode's spec-string package cache installs this release when users bump the pin.
+
+No commands, tools, state paths, schemas, synced file ownership rules, runtime transitions, completion gates, review policy defaults, validation strictness, package exports, or public payloads changed.
+
+Constraint: Preserve release history while deleting superseded plans, investigations, and pre-v3 architecture archives that no longer define current behavior
+Constraint: Promote still-current lessons into current docs, ADRs, or the skill review checklist before deleting historical files
+Rejected: Keep tombstone plan files just to preserve old links | that would recreate the stale navigation surface this release removes
+Rejected: Rewrite old release notes wholesale | release notes remain historical evidence, not current contracts
+Confidence: high
+Scope-risk: low
+Reversibility: clean — deleted historical files remain recoverable from git history; current contracts are now shorter and explicit
+Directive: Future maintainers should use `docs/maintainer-contract.md`, ADRs, `docs/contributor-map.md`, source, and tests for current behavior; use release notes only as historical context
+Tested: `bun run check` (typecheck, lint, build, full test suite, npm-tarball install smoke asserting the 3.3.4 README pin, bundle sanity); `bun run smoke:release` (packed candidate tarball install smoke and release evidence bundle); `bun run check:completion-lane`; stale-reference scan for deleted historical paths; `package.json` parse check
+Not-tested: Live OpenCode UI restart against the release candidate; this release changes documentation, release metadata, and maintainer checks only.
+
 ## [3.3.3] - 2026-06-13
 
 Split the action hotspot without changing Flow's runtime contract

package/README.md

@@ -29,7 +29,7 @@ Add Flow to the `plugin` array in your `opencode.json` (global `~/.config/openco
 
 ```json
 {
-  "plugin": ["opencode-plugin-flow@3.3.3"]
+  "plugin": ["opencode-plugin-flow@3.3.4"]
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencode-plugin-flow",
-	"version": "3.3.3",
+	"version": "3.3.4",
 	"description": "Stateful planning and execution workflow plugin for OpenCode",
 	"type": "module",
 	"main": "dist/index.js",
@@ -29,6 +29,7 @@
 		"check:release-hygiene": "node ./scripts/cross-area/release-hygiene.mjs",
 		"check:pack-invariants": "node ./scripts/cross-area/pack-invariants.mjs",
 		"check:bundle-sanity": "node ./scripts/cross-area/bundle-sanity.mjs",
+		"check:completion-lane": "bun test tests/runtime/final-completion-gates.test.ts tests/runtime/semantic-invariants.test.ts tests/runtime/hard-invariants.test.ts tests/runtime-recovery.test.ts",
 		"smoke:opencode": "node ./scripts/cross-area/opencode-smoke.mjs",
 		"smoke:release": "node ./scripts/cross-area/release-smoke.mjs",
 		"deadcode": "knip --include files,dependencies,unlisted,unresolved,binaries,catalog",