v4.2.0

[4.2.0] - 2026-07-01

Safety and usability overhaul across the runtime, packaging, skills, and docs:

• Uninstall no longer deletes managed skill folders that contain your own
  files or have a damaged version marker; uninstall --dry-run previews
  removals.
• Crashed sessions recover: stale session locks expire automatically and the
  lock timeout error names the manual fix; corrupt or older-version
  session.json files are quarantined into .flow/history/ with recovery
  guidance instead of failing every tool with a raw validation dump.
• Fixed a batch of small correctness bugs: $-sequences in goals no longer
  get mangled, attachments to Flow commands are preserved, failed plan saves
  no longer discard the previous session, replacing a draft plan archives it,
  and needs_input no longer reports a stale prior error.
• OpenCode compatibility: the peer dependency is now a range
  (>=1.17.3 <2) so newer OpenCode versions install cleanly; a live smoke
  test boots a real OpenCode server against the packed tarball in CI; CI runs
  on macOS and Node 20/22/24; published bundles are no longer minified and
  ship sourcemaps.
• Skills: repo-specific content removed from distributed skills, duplicated
  orchestration rules consolidated (smaller command prompts), the read-only
  reviewer no longer receives instructions it cannot execute, and managers
  are told to paste handoff templates into worker prompts.
• New opt-in FLOW_EXPERIMENTAL_COMPACTION=1 injects the active session
  summary into OpenCode session compaction; the default stays hook-free.
• README rewritten around a quick start; install/repair depth moved to
  docs/troubleshooting.md.

v4.1.18

[4.1.18] - 2026-07-01

Teach Flow's skill review lore to keep audit fallback bundled, commit preflight staged-only, and long references navigable.

v4.1.17

[4.1.17] - 2026-06-28

Teach Flow's parallel pass lore to verify worker handoffs, prune retired managed skill files, and keep manager-owned synthesis explicit.

v4.1.16

[4.1.16] - 2026-06-22

Quote Flow skill frontmatter lore so GitHub previews parse cleanly and CI guards future YAML slips.

v4.1.15

[4.1.15] - 2026-06-22

Refine Flow's orchestration lore into a quick path, bundled wave example, tested doc links, and trusted-publishing release guidance.

v4.1.14

[4.1.14] - 2026-06-22

Publish Flow through npm trusted publishing so release CI no longer depends on expiring npm tokens.

v4.1.12

[4.1.12] - 2026-06-18

Harden Flow's hidden worker lore, scriptable doctor checks, typed package smoke, and session edge contracts without widening the v4 runtime surface.

v4.1.11

[4.1.11] - 2026-06-17

Give bundled Flow command lore a real title seed so OpenCode can name new chats while keeping the heavy instructions synthetic.

v4.1.10

[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.

v4.1.9

[4.1.9] - 2026-06-17

Make public Flow command lore self-contained so stale native skill discovery cannot block the required loop.