@smartergpt/lexrunner 2.2.0 → 2.4.0

package/CHANGELOG.md

@@ -6,6 +6,44 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
 ## [Unreleased]
 
+## [2.4.0] - 2026-09-09
+
+### Added
+
+- Progressive root CLI help shows seven existing work, integration and setup families.
+  `--help-all` exposes every registered command family and compatibility alias;
+  nested help and typo suggestions retain the complete command inventory.
+
+### Fixed
+
+- First-use help saves the actual integration plan with `--output plan.json` instead
+  of redirecting the planner summary. Guidance distinguishes reads, writes, gate
+  execution, worker handoff and separate merge authority.
+
+### Documentation
+
+- Explain the selected-work assisted handoff through preparation, attachment,
+  observed effects, receipts and verification. Controlled composition tests do not
+  establish a real worker provider or native Windows preparation support.
+- Repository exploration and compact-resumption scripts remain opt-in development
+  tools, outside the npm package. No token, cost or efficacy improvement is claimed.
+
+## [2.3.0] - 2026-09-09
+
+### Added
+
+- Shared selected-work materialization through `attempt materialize` and the read-only
+  `materialize_attempt_input` MCP tool, with explicit preparation fields and source correspondence.
+- Optional expected packet hash in preparation to reject changed input before resource
+  acquisition and report possible effects if the prepared result unexpectedly differs.
+- A complete selected-work example and guidance separating materialization, preparation,
+  worker execution and verification. Older strict consumers must upgrade for the bound input.
+
+### Fixed
+
+- Preserve authored technical context and constraints through project planning and issue
+  descriptions; report missing success criteria as an actionable input failure.
+
 ## [2.2.0] - 2026-09-09
 
 ### Added

package/README.md

@@ -17,14 +17,19 @@ branch, pushing, opening a PR, or merging requires separate approval.
 
 ## Start here
 
+The [2.4.0 candidate](docs/releases/2.4.0.md) (pending release) makes `lexrunner --help` show the main work and integration families with a first-use
+path. Use `lexrunner --help-all` for every family and compatibility alias, or
+`lexrunner <command> --help` for full options and nested operations. Help changes
+presentation only; command effects and authority requirements still apply.
+The public 2.3.0 package does not yet contain this help view or `--help-all`.
+
 For your first trial, install **LexRunner only** in a GitHub repository with open
 PRs. Node.js 24+ and Git are required. npm installs LexRunner's dependencies; you
 do not need to install Lex, AXF, LexSona, a policy-host service, or an MCP server
-separately for this CLI workflow. These examples target the 2.2.0 candidate; verify
-npm availability before installation.
+separately for this CLI workflow. These examples use the published 2.3.0 release.
 
 ```bash
-npm install --save-dev @smartergpt/lexrunner@2.2.0
+npm install --save-dev @smartergpt/lexrunner@2.3.0
 npx lexrunner --version
 npx lexrunner weave discover --json
 ```
@@ -119,11 +124,12 @@ The checked-in package version is the single source for `lexrunner --version` an
 
 <!-- BEGIN GENERATED PACKAGE VERSION -->
 
-Current repository package version: **2.2.0**. npm availability and dist-tags are separate
+Current repository package version: **2.4.0**. npm availability and dist-tags are separate
 release evidence; inspect the registry rather than inferring publication from source metadata.
 <!-- END GENERATED PACKAGE VERSION -->
 
-See the [2.2.0 frozen-input release candidate](docs/releases/2.2.0.md), the
+See the [2.3.0 selected-work release](docs/releases/2.3.0.md), the
+[2.2.0 frozen-input release](docs/releases/2.2.0.md), the
 [2.1.0 open-source release](docs/releases/2.1.0.md), the
 [2.0.2 generated timeout correction](docs/releases/2.0.2.md), the
 [2.0.1 MCP identity correction](docs/releases/2.0.1.md), the