@osdlc/command-seam 0.0.1-stage → 0.4.0

package/CHANGELOG.md

@@ -1,55 +1,43 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/),
-and this project adheres to [Semantic Versioning](https://semver.org/).
-
-## [0.4.0] - 2026-10-16
-
-The package is renamed, and the repository moved from `sksizer/sdlc` to
-[osdlc/osdlc](https://github.com/osdlc/osdlc).
-
-### Breaking
-
-- The package is now `@osdlc/command-seam`, renamed from
-  `@sksizer/command-seam`. To move, replace `@sksizer/command-seam` with
-  `@osdlc/command-seam` in `package.json` and in every import, including
-  `@osdlc/command-seam/testing`. `@sksizer/command-seam` gets no further
-  releases.
-
-### Added
-
-These exports are experimental (see the README's Stability section).
-
-- `installGroupSignalForwarding(opts?)`, with options type
-  `GroupSignalForwardingOptions`: opt-in. While a group started with
-  `processGroup: true` (async and managed runners) is live, `SIGINT`,
-  `SIGTERM` and `SIGHUP` send `SIGTERM` to every group, `SIGKILL` after
-  `graceMs` (default 1000), then exit with `128 + signal number`. A repeat
-  signal escalates to `SIGKILL` at once; an `exit` handler `SIGKILL`s groups
-  whose run is still in flight. Listeners are attached only while a group is
-  starting or live, ahead of the host's own. A host with its own listener, `process.once`
-  included, keeps the exit; its groups still get `SIGKILL` after `graceMs`, or
-  on exit if sooner and the run is in flight. Returns an uninstall function.
-  POSIX only; a no-op on Windows. `SIGKILL` of the host still orphans its groups. When
-  forwarding owns the exit, a new `processGroup: true` run after the first
-  forwarded signal is refused: it starts nothing and settles with
-  `reason: 'abort'`. The uninstall function resets this.
-- `forwardedSignal()`: the signal forwarded when forwarding owns the exit, or
-  `undefined`. A host that runs one command after another checks it to stop.
-- `forwardedExitCode()`: `128 + signal number` for `forwardedSignal()`, or
-  `undefined`. A host that sets its own exit code keeps this one over it.
-- `liveProcessGroups()`: the pids of the groups currently registered. A group
-  stays registered until it is empty, also after its run settles or its
-  leader exits, so a forwarded signal still kills a background member or one
-  waiting for the `SIGKILL` follow-up. The host's normal exit kills only the
-  groups whose run is still in flight, so a daemon a settled run left behind
-  keeps running.
-- `unref` on the managed-process runner's options: the parent can exit while
-  the (usually `processGroup`) child keeps running. Such a group is not tracked
-  by `installGroupSignalForwarding`: a signal to the parent does not reach it
-  and the parent's exit does not `SIGKILL` it.
+## 0.4.0
+
+### Minor Changes
+
+- e30f155: **Breaking:** the package is now `@osdlc/command-seam`, renamed from `@sksizer/command-seam`. The repository moved from `sksizer/sdlc` to [osdlc/osdlc](https://github.com/osdlc/osdlc).
+  
+  To move, replace `@sksizer/command-seam` with `@osdlc/command-seam` in `package.json` and in every import, including `@osdlc/command-seam/testing`. `@sksizer/command-seam` gets no further releases.
+- e30f155: Add process-group signal forwarding and `unref` on the managed-process runner. These exports are experimental (see the README's Stability section).
+  
+  - `installGroupSignalForwarding(opts?)`, with options type
+    `GroupSignalForwardingOptions`: opt-in. While a group started with
+    `processGroup: true` (async and managed runners) is live, `SIGINT`,
+    `SIGTERM` and `SIGHUP` send `SIGTERM` to every group, `SIGKILL` after
+    `graceMs` (default 1000), then exit with `128 + signal number`. A repeat
+    signal escalates to `SIGKILL` at once; an `exit` handler `SIGKILL`s groups
+    whose run is still in flight. Listeners are attached only while a group is
+    starting or live, ahead of the host's own. A host with its own listener,
+    `process.once` included, keeps the exit; its groups still get `SIGKILL`
+    after `graceMs`, or on exit if sooner and the run is in flight. Returns an
+    uninstall function. POSIX only; a no-op on Windows. `SIGKILL` of the host
+    still orphans its groups. When forwarding owns the exit, a new
+    `processGroup: true` run after the first forwarded signal is refused: it
+    starts nothing and settles with `reason: 'abort'`. The uninstall function
+    resets this.
+  - `forwardedSignal()`: the signal forwarded when forwarding owns the exit, or
+    `undefined`. A host that runs one command after another checks it to stop.
+  - `forwardedExitCode()`: `128 + signal number` for `forwardedSignal()`, or
+    `undefined`. A host that sets its own exit code keeps this one over it.
+  - `liveProcessGroups()`: the pids of the groups currently registered. A group
+    stays registered until it is empty, also after its run settles or its
+    leader exits, so a forwarded signal still kills a background member or one
+    waiting for the `SIGKILL` follow-up. The host's normal exit kills only the
+    groups whose run is still in flight, so a daemon a settled run left behind
+    keeps running.
+  - `unref` on the managed-process runner's options: the parent can exit while
+    the (usually `processGroup`) child keeps running. Such a group is not
+    tracked by `installGroupSignalForwarding`: a signal to the parent does not
+    reach it and the parent's exit does not `SIGKILL` it.
 
 ## [0.3.0] - 2026-10-15
 
@@ -324,5 +312,4 @@ entry.
   exports. A breaking change to a stable export will be listed under
   "Breaking".
 
-[0.4.0]: https://github.com/osdlc/osdlc/tree/command-seam/v0.4.0/packages/ts/command-seam
 [0.3.0]: https://github.com/sksizer/sdlc/tree/command-seam/v0.3.0/packages/command-seam

package/CONTRIBUTING.md

@@ -55,4 +55,7 @@ is installed.
   code a user would write. The change is judged by how that code reads. See
   [D-15](https://github.com/osdlc/osdlc/blob/main/packages/ts/command-seam/docs/planning/decisions/D-15-api-changes-start-from-consumer-code.md).
 - Keep comments short. Say why, not what.
-- Update `CHANGELOG.md` for changes users can see.
+- For a change users can see, add a changeset: run `pnpm changeset` at the
+  repository root. Start a breaking change's summary with `**Breaking:**`.
+  Do not edit `CHANGELOG.md` or `version` by hand; the release writes them.
+  See [packages/README.md](https://github.com/osdlc/osdlc/blob/main/packages/README.md).

package/README.md

@@ -645,8 +645,8 @@ The package is at 0.x. Each export is stable or experimental.
 - **Stable** exports are the runner contract: the runners, their options and
   results, `CommandFailed`, and the helpers around them. The runners and
   helpers are in use by other packages; a type that names their options or
-  results is stable with them. A breaking change to one is listed under
-  "Breaking" in the CHANGELOG.
+  results is stable with them. A breaking change to one is marked
+  **Breaking** in the CHANGELOG.
 - **Experimental** exports are newer or have no user yet. Any release may
   change or remove one. Each has an `@experimental` tag in its TSDoc.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osdlc/command-seam",
-  "version": "0.0.1-stage",
+  "version": "0.4.0",
   "description": "Injectable subprocess runner for Node: capture, stream and managed-process runners, hard timeouts, failures as results.",
   "license": "MIT",
   "author": "SK Sizer",