dsh-loop-engine 0.2.1-rc1

dsh-loop-engine 0.2.1-rc1

Serves the 0.2.1 harness line (>=0.2.1-rc.1 <0.2.2-0) on the same build that still covers the 0.1.5, 0.1.7 and 0.2.0 lines.

Why this release exists

The 0.2.1 line deleted @deepseek-ai/dsh-invariants outright and republished the JSONL durability backend as a namespace plugin with no default export. Neither renames a method, but the first one is fatal: dsh's boot gate skips a whole bundle whose @deepseek-ai/dsh-* peers do not satisfy the running version. Keeping that peer would have unmounted the entire plugin rather than degrading one feature — the symptom is a missing "Loop engine" settings section, not an error.

Changes

• src/invariant.ts now declares the invariant registry's shapes locally (the same technique driver-core/host-servers.ts already used), so one build mounts on every line. inject = ['invariants'] is unchanged, which keeps the companion pending where the service no longer exists.
• @deepseek-ai/dsh-invariants is removed from peerDependencies and devDependencies.
• tests/helpers/harness-generation.ts gains jsonlSessionPersistence, handing ctx.plugin whichever form the running generation publishes. That single adapter turned 108 red specs green.
• .compat/021/ + vitest.config.compat021.ts add the fourth line's isolated dependency set.
• Peer ranges extend to >=0.2.1-rc.1 <0.2.2-0; devDependencies follow.
• Docs: compatibility.md gains §4.5 (the two structural changes) and an upgraded §6 checklist; source-checkout.md drops the dsh-invariants shim; both READMEs and architecture.md §5 are updated.

Verification

• pnpm run typecheck and pnpm run build clean
• pnpm run test:coverage: 68 files / 1298 specs, per-file 100%
• All four compat lines green: 0.1.5 (1296 + 2 skipped), 0.1.7, 0.2.0, 0.2.1 (1298 each)
• dsh web boots clean from both the source checkout and the published dsh@0.2.1-rc.2 runtime: the managed block disables agent-loop and command-goal, all four hosted presets are authored from the new standard, and the browser half serves dsh-loop-engine/client.js
• The desktop build (Electron shell) verified end to end, with data-loop-engine reflected onto <html>

Known limitation

dsh-usage-overlay still declares 0.1.7-only peer ranges and is skipped by dsh on 0.2.1; that is a separate package.