From fed6fb87964a55a1339d0150901ba6ebd00f3c76 Mon Sep 17 00:00:00 2001 From: Thorsten Fuchs <76904008+ThorFuchs@users.noreply.github.com> Date: Tue, 10 Nov 2026 16:38:02 +0100 Subject: [PATCH] Prepare 1.9.0 minor release metadata Report CLI version 1.9.0 with its deterministic source identity and regression assertion. Finalize the 1.9.0 changelog entry, add minor release notes for bounded structural workflows, Transform index selection and the macOS 15 / iOS 18 deployment floor, and mark 1.9.0 prepared in the roadmap, source-line and qualification records. Public APIs and finite budgets are unchanged. Publication remains separate. Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 8 +- CHANGELOG.md | 6 +- CONTRIBUTING.md | 2 +- Documentation/Architecture/API.md | 2 +- Documentation/Qualification/Release1.9.md | 5 +- Documentation/Qualification/ReleaseLines.md | 7 +- Documentation/README.md | 5 +- Documentation/ReleaseNotes/1.9.0.md | 84 +++++++++++++++++++ Documentation/ReleaseRoadmap.md | 4 +- Sources/JSONCLIEngine/CLIBuildIdentity.swift | 2 +- Sources/JSONCLIEngine/CLIReleaseVersion.swift | 2 +- Tests/JSONCLITests/IntegrationTests.swift | 2 +- 12 files changed, 109 insertions(+), 20 deletions(-) create mode 100644 Documentation/ReleaseNotes/1.9.0.md diff --git a/AGENTS.md b/AGENTS.md index 279e1f2..aa4a0ac 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,9 +1,9 @@ # Contributor instructions -Development source is 1.9.0-dev, based on published 1.8.0 at -66718f11514d8c555f6a6b0ecc738e5029405a55. Stable 1.6.1 remains a separate -maintenance line. Preserve every source-bound qualification record. No 1.9 -merge/tag/publication follows from implementation or passing tests. +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. 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 diff --git a/CHANGELOG.md b/CHANGELOG.md index eedb736..5a4905c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,10 @@ # Changelog -## Unreleased — 1.9.0-dev +## 1.9.0 — prepared source; publication separate + +- Report CLI source version `1.9.0` with a regenerated deterministic source + identity. See the [minor release notes](Documentation/ReleaseNotes/1.9.0.md) + and the [1.9 qualification record](Documentation/Qualification/Release1.9.md). - Add exact versioned Transform source definitions, a bounded native codec and successful compilation reports through the existing compiler. diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index c83493b..f152c4c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,6 +1,6 @@ # 1.9 scoped workflow qualification -This isolated development source is 1.9.0-dev from published 1.8.0. +This prepared 1.9.0 source builds on published 1.8.0. 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 dc2c707..82b08aa 100644 --- a/Documentation/Architecture/API.md +++ b/Documentation/Architecture/API.md @@ -1,6 +1,6 @@ # 1.9 additive API candidate -The latest released source is 1.8.0 (66718f11); this feature source is 1.9.0-dev. +The latest released source is 1.8.0 (66718f11); this prepared source is 1.9.0. 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 3339c5c..42cce6c 100644 --- a/Documentation/Qualification/Release1.9.md +++ b/Documentation/Qualification/Release1.9.md @@ -1,7 +1,8 @@ # 1.9.0 candidate qualification -Status: candidate source on `main` after 1.8.0 (`66718f1`). Not published. A tag -and release still need an explicit maintainer instruction. +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. ## Scope diff --git a/Documentation/Qualification/ReleaseLines.md b/Documentation/Qualification/ReleaseLines.md index 637aaa8..452f1b9 100644 --- a/Documentation/Qualification/ReleaseLines.md +++ b/Documentation/Qualification/ReleaseLines.md @@ -3,9 +3,10 @@ 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 isolated 1.9.0-dev successor -keeps those products and adds bounded Inspection batches/store operations. -See [its separate qualification](Release1.8.md). 1.6.1 stays the eight-library +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 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 da9ca1e..bb88a7f 100644 --- a/Documentation/README.md +++ b/Documentation/README.md @@ -1,8 +1,7 @@ # Current authority — 1.9 candidate -Published 1.8.0 has twelve libraries plus CLI and thirteen catalogs. This isolated -1.9.0-dev branch adds bounded batches and a public immutable store inside -JSONInspection. See [1.8 qualification](Qualification/Release1.8.md) and the +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). The dated predecessor inventories below are historical, not 1.9 pass evidence. diff --git a/Documentation/ReleaseNotes/1.9.0.md b/Documentation/ReleaseNotes/1.9.0.md new file mode 100644 index 0000000..8e4cf4d --- /dev/null +++ b/Documentation/ReleaseNotes/1.9.0.md @@ -0,0 +1,84 @@ +# Swift-JSON 1.9.0 — release notes + +This minor release adds bounded structural workflows to JSONInspection, one-call +index selection to JSONTransform, and lowers the Apple deployment minimums to +macOS 15 and iOS 18. Preparation and tagging do not establish publication; the +official GitHub release and its qualification asset identify the final source and +actual outcomes. + +## Added + +**Ordered value batches.** `JSONInspectionBatch` reads typed paths in one +operation. Snapshot ordinals and store positions have matching batch reads. Each +batch uses one cumulative ledger and returns its results atomically. Repeated +requests stay repeated, a missing selection throws, and an explicit JSON null is a +value. `optionalValues(at:maximumRequests:)` returns `nil` for an absent member or +an index past the end, and throws the same errors as `values(at:)` otherwise. + +**A read-only configured store.** `JSONStoreBuilder` promotes an immutable source +to `JSONConfiguredStore` after the checked eight-phase construction. Collections, +ID fields, record paths and reference fields are declared explicitly; nothing is +inferred. The store offers exact-ID `lookup(collection:id:)`, ordered value reads +and complete breadth-first `follow(from:)` with finite depth, frontier, visited +and result limits. Positions are owner-bound and cannot be forged or reused +against another build. There is no persistence, mutable store or network +resolution. + +- Each collection declares a `JSONStoreIDKind`. String IDs (the default) compare + by exact decoded Unicode scalars. Integer IDs compare by exact mathematical + value, so `7`, `7.0` and `7e0` are one ID, and stay exact beyond Double + precision. IDs never convert between kinds. +- `JSONStoreRecordID` accepts string and integer literals. +- `JSONStoreFailure` is `Equatable` and reports a typed `JSONStoreFailurePhase` + and, for capacity refusals, a typed `JSONStoreCapacity`. +- `collectionIndex(named:)` maps an exact collection name to its position. +- `JSONStoreReferences.strict(marker:)` always validates reference targets. + +**Transform selection.** Versioned Transform source definitions, compile reports +and finite indexed selection scopes over an explicit population, with +owner-bound positions and an EOF completion witness on one invocation ledger. +`JSONTransformProgram.selectIndices(in:bindings:limits:source:)` runs a selection +to the end and returns the ordinals, with the same completion statistics as the +manual loop. + +**Composition accounting.** Input bytes are charged per document, completion +charges its own report on the original ledger, and a checked +`reserveExternalLogicalBytes(_:count:overhead:)` overload is added. + +## Platforms + +The deployment minimums are now **macOS 15 and iOS 18** (previously macOS/iOS 27). +Development still uses Swift 6.4 and the macOS 27 SDK (Xcode 27). Linux and WASI +are unchanged; the WASI lane is pinned to Swift 6.4.2. + +- JSONHTML's WebKit `WebPage` PDF backend requires macOS/iOS 26. Earlier systems + report the existing `JSONPDFFailure.backendUnavailable`. +- Before macOS/iOS 27, the Markdown transfer type uses the system-declared + `net.daringfireball.markdown` identifier. + +Platform evidence is compile-time: every product and test builds at the macOS 15 +floor, and every library compiles for `arm64-apple-ios18.0`. No tests have run +on a macOS 15–26 or iOS 18 system. + +## Compatibility and qualification + +The release is additive over 1.8.0. SwiftPM API-break checking against 1.8.0 reports +one finding, a false positive for a package-only enum, and no public breaking change. The package keeps twelve library products plus `swift-json`, thirteen DocC +catalogs, Swift tools and compiler 6.4+, Swift language mode 6, an empty root +dependency graph, Apache-2.0 and retained upstream notices. CLI metadata reports +`1.9.0` with the deterministic final-source identity. + +The maintainer recorded an explicit **exception for the 1.9.0 +controlled-performance gate**. It is not a pass. This release makes no speed, +throughput, allocation or RSS claim. Navigation G4 remains HOLD, and earlier +performance dispositions stay historical. Logical retained bytes and caller work +keep their documented accounting boundaries. + +The release qualification asset records the actual source-bound Native, Linux, +safety, docs and archive outcomes. See the +[1.9 qualification record](../Qualification/Release1.9.md). + +The work was integrated through +[PR #74](https://github.com/ThorFuchs/Swift-JSON/pull/74), +[PR #81](https://github.com/ThorFuchs/Swift-JSON/pull/81) and +[PR #84](https://github.com/ThorFuchs/Swift-JSON/pull/84). diff --git a/Documentation/ReleaseRoadmap.md b/Documentation/ReleaseRoadmap.md index 2aed94f..78afefb 100644 --- a/Documentation/ReleaseRoadmap.md +++ b/Documentation/ReleaseRoadmap.md @@ -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** | 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 (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.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. | @@ -70,7 +70,7 @@ A major version is a deliberate compatibility commitment: record and justify any actual break and provide migration guidance; do not manufacture a break to reach 2.0. Dates follow exit gates, not a promised calendar. -The 1.9/1.10 entries are **proposed scope**, not API approval or permission to start +The 1.10 entry and later are **proposed scope**, not API approval or permission to start implementation. All planned packages at 2.0 means the explicitly accepted release portfolio. Lexical/semantic retrieval, embeddings, persistent indexes, weighted graph algorithms, set algebra, matrix arithmetic, JSONPath/another query grammar, diff --git a/Sources/JSONCLIEngine/CLIBuildIdentity.swift b/Sources/JSONCLIEngine/CLIBuildIdentity.swift index 263899d..f560b08 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:615a1cc005527cc2e8488adced3cebae5b041f1109b6546fa154b5e3b3ed3909" + package static let revision = "sha256:43e6285a7d265092fc1f29d9919cfa297a1f96d074d40f1e12be7a8d2734a453" package static let kind = "source-sha256" } diff --git a/Sources/JSONCLIEngine/CLIReleaseVersion.swift b/Sources/JSONCLIEngine/CLIReleaseVersion.swift index 124dd45..01acae9 100644 --- a/Sources/JSONCLIEngine/CLIReleaseVersion.swift +++ b/Sources/JSONCLIEngine/CLIReleaseVersion.swift @@ -2,5 +2,5 @@ // Version of this source distribution. Publication is a separate action. package enum CLIReleaseVersion { - package static let value = "1.9.0-dev" + package static let value = "1.9.0" } diff --git a/Tests/JSONCLITests/IntegrationTests.swift b/Tests/JSONCLITests/IntegrationTests.swift index 0e7d51a..1ef51a7 100644 --- a/Tests/JSONCLITests/IntegrationTests.swift +++ b/Tests/JSONCLITests/IntegrationTests.swift @@ -146,7 +146,7 @@ private func integrationDirectory() throws -> URL { @Test func cliVersionIsDeterministicAndNeedsNoRepositoryOrInput() throws { let metadata = try JSONParser().parse(CLIHelp.versionJSON) - #expect(try metadata.requiredMember("version") == .string("1.9.0-dev")) + #expect(try metadata.requiredMember("version") == .string("1.9.0")) #expect(try metadata.requiredMember("revisionKind") == .string("source-sha256")) let revision = try #require(try metadata.requiredMember("revision").stringValue) #expect(revision.hasPrefix("sha256:") && revision.utf8.count == 71)