Version Packages

packages/core/CHANGELOG.md

@@ -0,0 +1,55 @@
+# effect-herdr
+
+## 0.2.0
+
+### Minor Changes
+
+- 91ae167: RPC surface expansion, branded identity types, and scope-bound liveness.
+
+  **Wired RPC methods go from 14 to 62** (of herdr's 89), the bulk of this
+  release. New `operations/` modules: `workspace`, `tab`, `worktree`,
+  `notification`, `integration`, `events`, `agent`, `agentReporting`, plus
+  `claim` and `entity` below. `operations/pane.ts` gains eight spatial
+  combinators and `sendKeys`; `operations/current.ts` gains `currentPaneById`.
+  Still unwrapped: `plugin.*`, `client.window_title.*`, `server.*`,
+  `popup.close`, `pane.graphics.*`, and `layout.apply/export/set_split_ratio`
+  — see `TODO.md`.
+
+  `Pane`, `Tab`, and `Workspace` now carry a discriminating `EntityTypeId` tag
+  plus `Equal`/`Hash`/`Order` traits, and are built with `makePane`/`makeTab`/
+  `makeWorkspace`. This is a **breaking change to construction**: bare object
+  literals (`{ id, tabId, workspaceId }`) are no longer assignable. The tag lives
+  on the prototype, so spreading an entity drops it at runtime rather than
+  producing a half-entity that compares by reference. Note the spread is still
+  statically assignable to `Pane` — TypeScript tracks the symbol-keyed property
+  through a spread even though JS does not copy it — so kind-dispatching
+  combinators fail loudly on a detagged value rather than relying on
+  exhaustiveness.
+
+  The tag fixes a real soundness hole. `Pane` structurally contains every field
+  of `Tab`, which contains every field of `Workspace`, so the previous
+  field-presence guards (`hasProperty(u, "id")` for a workspace) returned `true`
+  for all three kinds — a `Pane` passed where a `Workspace` was expected would
+  typecheck and dispatch the wrong RPC. New sound refinements `isPane`/`isTab`/
+  `isWorkspace` replace them everywhere.
+
+  New `claim`/`claimIn`/`withClaim` tie a resource's liveness to a `Scope`:
+
+  - `claim(entity)` forks a watcher on herdr's `*.closed` push stream and
+    interrupts the claiming fiber if the resource is closed remotely, so
+    multi-step work stops at the close instead of failing on a later RPC.
+  - `disconnectPolicy: "retain"` (default) only watches; `"destroy"` also closes
+    the resource when the scope ends.
+  - `claim` takes its `Scope` from the requirements channel; `claimIn` takes one
+    explicitly, for callers managing lifetimes by hand.
+
+  New kind-polymorphic `close`/`focus`/`rename` dispatch on the tag, collapsing
+  the three per-kind families into one surface each. `move` is deliberately not
+  collapsed — `movePane` takes a destination union and returns the pane's fresh
+  identity, while `moveTab`/`moveWorkspace` take an index and return `void`.
+
+- d9b4bd3: Initial public release: typed Effect SDK for herdr.
+
+  - Protocol layer (`HerdrRpcs`, identity/snapshot value objects, tagged error types)
+  - Connection primitive (`HerdrConnection`) with per-call-dial wire adapter and scoped `events.subscribe` support
+  - Service layer (`HerdrSession`) and domain combinators: `splitPane`, `focusPane`, `closePane`, `runInPane` (batch + streaming), `waitForOutput`, `activePane`/`activeTab`, `focusedPane`/`focusedTab`/`focusedWorkspace`, `focusedPaneRef`, `currentPane`/`currentTab`/`currentWorkspace`, `listWorkspaces`

packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "effect-herdr",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "A typed Effect SDK for herdr, the terminal-native agent multiplexer.",
   "license": "MIT",