Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
6 changes: 5 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion Documentation/Architecture/API.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
5 changes: 3 additions & 2 deletions Documentation/Qualification/Release1.9.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down
7 changes: 4 additions & 3 deletions Documentation/Qualification/ReleaseLines.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
5 changes: 2 additions & 3 deletions Documentation/README.md
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
84 changes: 84 additions & 0 deletions Documentation/ReleaseNotes/1.9.0.md
Original file line number Diff line number Diff line change
@@ -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).
4 changes: 2 additions & 2 deletions Documentation/ReleaseRoadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -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. |

Expand All @@ -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,
Expand Down
2 changes: 1 addition & 1 deletion Sources/JSONCLIEngine/CLIBuildIdentity.swift
Original file line number Diff line number Diff line change
Expand Up @@ -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"
}
2 changes: 1 addition & 1 deletion Sources/JSONCLIEngine/CLIReleaseVersion.swift
Original file line number Diff line number Diff line change
Expand Up @@ -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"
}
2 changes: 1 addition & 1 deletion Tests/JSONCLITests/IntegrationTests.swift
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
Loading