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
16 changes: 8 additions & 8 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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.
Expand Down Expand Up @@ -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.
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 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
Expand Down
4 changes: 2 additions & 2 deletions Documentation/Architecture/API.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
20 changes: 15 additions & 5 deletions Documentation/Qualification/Release1.9.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down
15 changes: 7 additions & 8 deletions Documentation/Qualification/ReleaseLines.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
9 changes: 5 additions & 4 deletions Documentation/README.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
18 changes: 9 additions & 9 deletions Documentation/ReleaseRoadmap.md
Original file line number Diff line number Diff line change
@@ -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

Expand Down 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 (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. |

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:43e6285a7d265092fc1f29d9919cfa297a1f96d074d40f1e12be7a8d2734a453"
package static let revision = "sha256:aa26808464399893b8609da161cc55d93a4cc1c24437091570ec4f639beb22d6"
package static let kind = "source-sha256"
}
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading