perttool 0.10.0 → 0.10.2

package/CHANGELOG.md

@@ -4,6 +4,29 @@ This project records its notable changes here. The format is based on [Keep a Ch
 
 ## [Unreleased]
 
+## [0.10.2] - 2026-08-21
+
+Compatible Grammar 8 and CLI Contract 9 patch for Issue #20.
+
+### Fixed
+
+- Treat an unchanged retained assurance receipt whose producer is absent from
+  both adjacent historical snapshots as evidence extension instead of a
+  frozen-plan conflict, while preserving conflicts for one-sided presence,
+  changed receipts, and present frozen-task changes.
+
+## [0.10.1] - 2026-08-20
+
+Compatible Grammar 8 and CLI Contract 9 patch for Issue #22.
+
+### Fixed
+
+- Restored `document migrate --target-grammar 7` as the repository-bound route
+  required before milestone-acceptance `dag advance`.
+- Made Contract 9 help and JSON discovery advertise target grammars 7 and 8
+  plus both applicable migration result schemas.
+- Returned the active CLI Contract 9 envelope for Grammar 7 migration results.
+
 ## [0.10.0] - 2026-08-18
 
 Breaking Grammar 8 and CLI Contract 9 beta minor. This version publishes
@@ -543,7 +566,9 @@ First public development preview. Intended to evaluate the DSL and CLI, read-onl
 - Not published to the npm registry; use the GitHub Release asset
 - Requires Node.js 24 or later
 
-[Unreleased]: https://github.com/mako10k/perttool/compare/v0.10.0...HEAD
+[Unreleased]: https://github.com/mako10k/perttool/compare/v0.10.2...HEAD
+[0.10.2]: https://github.com/mako10k/perttool/compare/v0.10.1...v0.10.2
+[0.10.1]: https://github.com/mako10k/perttool/compare/v0.10.0...v0.10.1
 [0.10.0]: https://github.com/mako10k/perttool/compare/v0.9.4...v0.10.0
 [0.9.4]: https://github.com/mako10k/perttool/compare/v0.9.3...v0.9.4
 [0.9.3]: https://github.com/mako10k/perttool/compare/v0.9.2...v0.9.3

package/README.md

@@ -75,8 +75,9 @@ commands, 23 root schemas, 129 root and Node runtime exports,
 criterion-set replacement, caller-asserted receipts, and acceptance-aware
 canonical advance. Its accepted release commit, annotated tag, GitHub
 prerelease, and npm artifact agree, and npm currently reports
-`latest=0.9.0`, `beta=0.9.4`, and no `alpha`. Source is prepared for the
-unpublished `0.10.0` Grammar 8 and CLI Contract 9 beta candidate. Version `0.8.1` remains the
+`latest=beta=0.10.0` and no `alpha`. Version `0.10.0` is the published Grammar
+8 and CLI Contract 9 beta. Source is prepared for the compatible `0.10.2`
+Issue #20 retained-receipt history patch. Version `0.8.1` remains the
 exact Grammar 6 and CLI Contract 7 rollback pin.
 
 Version `0.9.1` is the durably accepted compatible Contract 8 patch for
@@ -677,6 +678,7 @@ diagnostics, and future or unavailable temporal eligibility must fail closed.
 - [`v0.9.3` publication record](docs/process/0.9.3-publish.md)
 - [`v0.9.3` durable release acceptance](docs/process/0.9.3-release-acceptance.md)
 - [`v0.9.4` release procedure](docs/process/0.9.4-release.md)
+- [`v0.10.2` release procedure](docs/process/0.10.2-release.md)
 - [Conditional Plan Assurance interface acceptance](docs/process/plan-assurance-interface-acceptance.md)
 - [Shared Library Boundary](docs/specs/shared-library.md)
 - [Editor Protocol Contract](docs/specs/editor-protocol.md)
@@ -724,9 +726,9 @@ diagnostics, and future or unavailable temporal eligibility must fail closed.
 Report vulnerabilities privately according to [SECURITY.md](SECURITY.md).
 perttool is released under the [MIT License](LICENSE). See
 [CHANGELOG.md](CHANGELOG.md) for release changes and known limitations.
-The current repository source identifies `0.10.0` and activates Grammar 8,
-CLI Contract 9, 56 commands, and the seven replacement result identities. It
-is preparation state only: no `v0.10.0` tag, GitHub Release, or npm package is
-claimed until candidate acceptance and separately authorized PUBLISH succeed.
+The current repository source identifies `0.10.2` and retains Grammar 8,
+CLI Contract 9, 56 commands, and 23 root schemas. It corrects the retained
+receipt history classification reported in Issue #20 while retaining Grammar 7
+to 8 migration. Version `0.10.1` remains the exact rollback pin.
 Migration guidance is in
 [`0.9.4-to-0.10.0-migration.md`](docs/process/0.9.4-to-0.10.0-migration.md).

package/dist/cli.js

@@ -3049,7 +3049,7 @@ async function runDocumentMigration(args) {
         return runContract9DocumentMigration(args);
     const parsed = parseCommandOptions("document.migrate", args);
     if (parsed.positionals.length !== 1 || parsed.values.get("target-grammar") !== "7")
-        throw new UsageError("document migrate requires <file> --target-grammar 8");
+        throw new UsageError("document migrate requires <file> --target-grammar 7 or 8");
     const sourceOperand = parsed.positionals[0];
     if (sourceOperand === "-")
         throw new UsageError("document migrate requires a repository file");
@@ -3081,7 +3081,7 @@ async function runDocumentMigration(args) {
         }
     }
     if (format === "json")
-        writeJson({ schema_version: "Perttool.MilestoneAcceptanceMigrationResult.v1", cli_contract_version: 8,
+        writeJson({ schema_version: "Perttool.MilestoneAcceptanceMigrationResult.v1", cli_contract_version: 9,
             tool_version: TOOL_VERSION, operation: "document.migrate", ...snakeJson(result) });
     else if (result.candidateText !== null)
         process.stdout.write(result.candidateText);