From ecfe07db16dbe6da352d474fbf769dea2ec4b20e Mon Sep 17 00:00:00 2001 From: Thorsten Fuchs <76904008+ThorFuchs@users.noreply.github.com> Date: Wed, 11 Nov 2026 14:21:23 +0100 Subject: [PATCH] docs: record 1.9.0 as published across status documents AGENTS, CONTRIBUTING, the API inventory, source lines, the Documentation README, the roadmap execution update and the 1.9 qualification record still described 1.9.0 as prepared or a candidate, or 1.8.0 as latest. Record the publication (tag, commit, tree, assets, CI) and note that no 1.8.1 was released. ScopedTransforms no longer calls Transform unreleased. Regenerate the CLI source identity for the DocC change. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 16 +++++++-------- CONTRIBUTING.md | 2 +- Documentation/Architecture/API.md | 4 ++-- Documentation/Qualification/Release1.9.md | 20 ++++++++++++++----- Documentation/Qualification/ReleaseLines.md | 15 +++++++------- Documentation/README.md | 9 +++++---- Documentation/ReleaseRoadmap.md | 18 ++++++++--------- Sources/JSONCLIEngine/CLIBuildIdentity.swift | 2 +- .../Documentation.docc/ScopedTransforms.md | 2 +- 9 files changed, 49 insertions(+), 39 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index aa4a0ac..91251a9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,9 +1,9 @@ # Contributor instructions -Prepared minor release source is 1.9.0; publication is a separate owner action. It -builds on published 1.8.0 at 66718f11514d8c555f6a6b0ecc738e5029405a55. Stable -1.6.1 remains a separate maintenance line. Preserve every source-bound -qualification record. No tag/publication follows from passing tests alone. +Latest published release is 1.9.0 at f2a0d12da7028edfbcb0cb307f19a921a3a12d03; +main continues from it. Stable 1.6.1 remains a separate maintenance line. Preserve +every source-bound qualification record. No tag/publication follows from passing +tests alone. Swift-JSON requires Swift tools/compiler 6.4+, Swift language mode 6 and a macOS/SDK 27+ development host; deployment minimums are macOS 15 and iOS 18. Read README.md, CONTRIBUTING.md and the relevant contracts in @@ -20,7 +20,7 @@ Documentation/Architecture before changing behavior. JSONHTML and opt-in JSONBridges depend on JSON only; core never re-exports the bridges. The approved CLI and E2 additions preserve historical product contracts. JSONNavigation is a released opt-in product depending on JSON only; future merge/release remain human-gated. - Published 1.6.1 has eight libraries plus CLI; this unreleased source includes + Published 1.6.1 has eight libraries plus CLI; releases since 1.7.0 include JSONInspection plus the optional Transform and DSL products. Its API is separate from released Navigation. Future merge and release decisions remain human-gated. JSONInspection depends on JSON and JSONNavigation only; core re-exports neither. @@ -50,10 +50,10 @@ Scalar scanning and immutable plan-local regex sharing are selected private optimizations. Source-attached N3 snapshots and P1 tree/sparse-table projections live in JSONInspection. NAV10 set/matrix and NAV11 directed-simple-graph APIs are development capabilities inside JSONInspection; no graph product, mutation or serializer is introduced. -The 1.9 candidate promotes the checked immutable configured store inside -JSONInspection and adds ordered path/snapshot/store value batches, exact-ID lookup +Release 1.9.0 published the checked immutable configured store inside +JSONInspection with ordered path/snapshot/store value batches, exact-ID lookup and bounded complete BFS follow. The maintainer admitted this public read-only -store/follow API on 2026-11-10; merge and release remain separate decisions. Preserve the original construction phases and +store/follow API on 2026-11-10; later API changes stay additive and human-gated. Preserve the original construction phases and one invocation-owned ledger per operation. Positions remain unforgeable and source-instance-local. No persistence or mutable store is exposed. See Documentation/Architecture/StructuralIntelligence/BoundedWorkflows1.8.md. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index f152c4c..24e1b32 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,6 @@ # 1.9 scoped workflow qualification -This prepared 1.9.0 source builds on published 1.8.0. +Published 1.9.0 introduced these workflows; main continues from it. Run `python3 Scripts/ci.py --lane structural-workflows` for exact Debug/Release behavior, preserved store cases and public compiler/consumer checks. M2 adds `--lane structural-acceptance` and `--lane structural-acceptance-safety` for exact diff --git a/Documentation/Architecture/API.md b/Documentation/Architecture/API.md index 82b08aa..b30d6c1 100644 --- a/Documentation/Architecture/API.md +++ b/Documentation/Architecture/API.md @@ -1,6 +1,6 @@ -# 1.9 additive API candidate +# 1.9 additive API -The latest released source is 1.8.0 (66718f11); this prepared source is 1.9.0. +The latest released source is 1.9.0 (f2a0d12d), which added this API to 1.8.0 (66718f11). No product or dependency is added. JSONInspection now includes `JSONInspectionBatch`, snapshot ordinal batches, public `JSONStoreBuilder`/ `JSONConfiguredStore` and typed profile/metadata/error declarations, exact-ID diff --git a/Documentation/Qualification/Release1.9.md b/Documentation/Qualification/Release1.9.md index 42cce6c..bd5d5ff 100644 --- a/Documentation/Qualification/Release1.9.md +++ b/Documentation/Qualification/Release1.9.md @@ -1,8 +1,18 @@ -# 1.9.0 candidate qualification - -Status: prepared 1.9.0 source on `main` after 1.8.0 (`66718f1`). The maintainer -gave explicit tag and publication approval on 2026-11-10. PR #83 (1.8.1) was closed -without release; the platform floor ships in 1.9.0 only. +# 1.9.0 qualification + +Status: **published** on 2026-11-10 as +[Swift-JSON 1.9.0](https://github.com/ThorFuchs/Swift-JSON/releases/tag/1.9.0) with +the explicit approval of the maintainer. The annotated tag `1.9.0` (object `172c361`) +points to `f2a0d12da7028edfbcb0cb307f19a921a3a12d03`, tree +`6b5438751352e0e424b133e79d40d32d6f8c8dd7`, the merge of PR #85. PR #83 (1.8.1) was +closed without release; the platform floor ships in 1.9.0 only. + +The release assets are the Git-free reproducible source archive (`5376b8a2…`, 1,553 +entries), the 13-catalog DocC archive built by CI at the release commit, its member +manifest, `Swift-JSON-1.9.0-qualification.json` and `SHA256SUMS`. All Native and Linux +lanes passed on the release commit, DocC covers 1,743 of 1,743 authored public +declarations, and a separate SwiftPM consumer resolved `exact: "1.9.0"` and passed in +Debug and Release. The qualification asset records runs, hashes and what was not run. ## Scope diff --git a/Documentation/Qualification/ReleaseLines.md b/Documentation/Qualification/ReleaseLines.md index 452f1b9..70f7930 100644 --- a/Documentation/Qualification/ReleaseLines.md +++ b/Documentation/Qualification/ReleaseLines.md @@ -1,12 +1,11 @@ -# Current source lines — 9 November 2026 +# Current source lines — 11 November 2026 -Latest published stable is [1.8.0](https://github.com/ThorFuchs/Swift-JSON/releases/tag/1.8.0), -commit `66718f11514d8c555f6a6b0ecc738e5029405a55`, tree -`8422e5eccc9c16d4b9de091be0aac8b61eaaeb0a`: twelve libraries plus CLI, -thirteen catalogs. The prepared 1.9.0 successor -keeps those products, adds bounded Inspection batches/store operations and lowers -the Apple deployment minimums to macOS 15 and iOS 18. See -[its qualification record](Release1.9.md). 1.6.1 stays the eight-library +Latest published stable is [1.9.0](https://github.com/ThorFuchs/Swift-JSON/releases/tag/1.9.0), +commit `f2a0d12da7028edfbcb0cb307f19a921a3a12d03`, tree +`6b5438751352e0e424b133e79d40d32d6f8c8dd7`: twelve libraries plus CLI, +thirteen catalogs. It adds bounded Inspection batches/store operations to 1.8.0 +and lowers the Apple deployment minimums to macOS 15 and iOS 18. See +[its qualification record](Release1.9.md). No 1.8.1 was released. 1.6.1 stays the eight-library maintenance line. The dated preparation inventories below remain history. # Stable and development source lines diff --git a/Documentation/README.md b/Documentation/README.md index bb88a7f..2e4a6c5 100644 --- a/Documentation/README.md +++ b/Documentation/README.md @@ -1,8 +1,9 @@ -# Current authority — 1.9 candidate +# Current authority — 1.9.0 -Published 1.8.0 has twelve libraries plus CLI and thirteen catalogs. Prepared 1.9.0 -adds bounded batches and a public immutable store inside JSONInspection. See [1.8 qualification](Qualification/Release1.8.md) and the -[1.9 candidate record](Qualification/Release1.9.md). +Published 1.9.0 has twelve libraries plus CLI and thirteen catalogs. It adds bounded +batches and a public immutable store inside JSONInspection to 1.8.0. See the +[1.9 qualification record](Qualification/Release1.9.md) and +[1.8 qualification](Qualification/Release1.8.md). The dated predecessor inventories below are historical, not 1.9 pass evidence. # Current documentation authority diff --git a/Documentation/ReleaseRoadmap.md b/Documentation/ReleaseRoadmap.md index 78afefb..690e4ce 100644 --- a/Documentation/ReleaseRoadmap.md +++ b/Documentation/ReleaseRoadmap.md @@ -1,12 +1,12 @@ -# Execution update — 28 October 2026 +# Execution update — 11 November 2026 -1.7.0 is published at `8557badef562cf2f059e964c113d4a7f60ecbe6c`. -The maintainer has now commissioned the 1.8 bounded structural wave, including -the public read-only store, on isolated `codex/1.8-batches-and-store`. -[The implementation contract](Architecture/StructuralIntelligence/BoundedWorkflows1.8.md) -freezes this wave; [qualification](Qualification/Release1.8.md) records actual results. -The proposal and historical inventories below remain source-bound. Persistence, -platform-floor reduction and new query grammars are not included. +1.9.0 is published at `f2a0d12da7028edfbcb0cb307f19a921a3a12d03`. It delivered the +bounded structural wave, including the public read-only store, and lowered the Apple +deployment minimums to macOS 15 and iOS 18 (see the +[1.9 qualification record](Qualification/Release1.9.md)). 1.8.0 delivered located +root-array streaming. The next proposed wave is 1.10.0; it is proposed scope only. +Persistence and new query grammars are not included in any release so far. +The proposal and historical inventories below remain source-bound. # Release roadmap: 1.7 through 2.0 @@ -60,7 +60,7 @@ there is no public store/follow API or store product. Root dependencies stay emp | --- | --- | --- | | **1.7.0 — integrated foundations** | Release the complete current public consolidation together: Navigation/Inspection snapshots, projections and graph, Transform and both DSL products, alongside all stable products. Keep store implementation private. | Freeze current-main successor; qualify exact source, public consumers/API/DocC, archives/assets and supported platforms; resolve the new candidate's performance dispositions explicitly. | | **1.8.0 — located root-array streaming** | Add JSONLocatedTopLevelArraySequence: root-array elements with zero-based half-open UTF-8 source spans over the existing shared grammar/driver, for consumers that stage original record bytes. | Additive public-consumer tests, facade parity on errors/limits/statistics, DocC and complete supported-platform CI on the exact source. | -| **1.9.0 — bounded structural workflows (prepared)** | Add independently reviewed, additive Inspection conveniences: aggregate batch reads and the minimal immutable public configured-store/follow interface (public API admitted by the maintainer on 2026-11-10). Improve Navigation/Inspection guides and error/resource ergonomics. | One-ledger aggregate proof, finite request/result/frontier profiles, ordinary compiler refusals, adversarial failure/cancellation and complete supported-platform evidence. Admission of the store API does not waive these gates. | +| **1.9.0 — bounded structural workflows (published)** | Add independently reviewed, additive Inspection conveniences: aggregate batch reads and the minimal immutable public configured-store/follow interface (public API admitted by the maintainer on 2026-11-10). Improve Navigation/Inspection guides and error/resource ergonomics. | One-ledger aggregate proof, finite request/result/frontier profiles, ordinary compiler refusals, adversarial failure/cancellation and complete supported-platform evidence. Admission of the store API does not waive these gates. | | **1.10.0 — durable workflows and operational maturity** | Candidate wave for versioned exact snapshot/store persistence and source-bound restoration, after a dedicated design admission. Complete capacity/scaling characterization and consumer migration guidance. | Freeze the logical envelope, corruption/version/source-identity semantics, bounded decode/rebuild and disk teardown/reopen tests. No persistence or source-span claim from a bare JSON dump. | | **2.0.0 — supported family and compatibility contract** | Ship all accepted products/capabilities under one coherent, documented compatibility, resource and platform contract. Complete end-to-end applications, migration tooling and the release qualification matrix. | Scope freeze, complete public API review and cross-product qualification, explicit treatment of every remaining hold, reproducible clean candidate and a separate owner tag/publication instruction. | diff --git a/Sources/JSONCLIEngine/CLIBuildIdentity.swift b/Sources/JSONCLIEngine/CLIBuildIdentity.swift index f560b08..0b198c1 100644 --- a/Sources/JSONCLIEngine/CLIBuildIdentity.swift +++ b/Sources/JSONCLIEngine/CLIBuildIdentity.swift @@ -2,6 +2,6 @@ // Generated by Scripts/generate_cli_identity.py; excludes this file. // SHA-256 of the ordered Package.swift + Sources content manifest, not a Git commit. package enum CLIBuildIdentity { - package static let revision = "sha256:43e6285a7d265092fc1f29d9919cfa297a1f96d074d40f1e12be7a8d2734a453" + package static let revision = "sha256:aa26808464399893b8609da161cc55d93a4cc1c24437091570ec4f639beb22d6" package static let kind = "source-sha256" } diff --git a/Sources/JSONTransform/Documentation.docc/ScopedTransforms.md b/Sources/JSONTransform/Documentation.docc/ScopedTransforms.md index 966c699..5b18ce9 100644 --- a/Sources/JSONTransform/Documentation.docc/ScopedTransforms.md +++ b/Sources/JSONTransform/Documentation.docc/ScopedTransforms.md @@ -19,7 +19,7 @@ let report = try plan.withExecution(input: root) { execution in The plan uses the same exact decimal and decoded-scalar rules as JSON and the CLI. Nonterminating division is a language error; no approximate arithmetic is added. The standalone public consumer at `Tools/TransformQualification` is available -in this unreleased source line; it is absent from stable 1.6.1. +in releases since 1.7.0; it is absent from the 1.6.1 maintenance line. ## Shared language reference