Skip to content

Latest commit

 

History

History
422 lines (354 loc) · 25.5 KB

CHANGELOG.md

File metadata and controls

422 lines (354 loc) · 25.5 KB

Changelog

1.10.0 — exact interchange; prepared source, publication separate

  • Report CLI source version 1.10.0 with a regenerated deterministic source identity. See the minor release notes and the 1.10 qualification record.
  • Add JSONCanonicalWriter, which writes RFC 8785 JSON Canonicalization Scheme (JCS) bytes: compact output, keys ordered by UTF-16 code units, short string escapes and ECMAScript spelling of binary64 numbers. Equal values produce equal bytes for hashing, signing and content addressing. NumberPolicy.preserving (the default) refuses a number whose binary64 spelling would denote a different exact decimal; .rounding rounds to the nearest binary64 value as RFC 8785 does. Tests cover the RFC's Appendix B number vectors, its sample document and its key-sorting example. The writer does not hash or sign. The existing writer and its scalar key order are unchanged.
  • Add JSONPatch.difference(from:to:options:) and differenceWithReport, which compute RFC 6902 operations that turn one exact value into another. Equal values (exact decimals, scalar keys, order-independent objects) produce no operation; objects diff by key, arrays keep their equal prefix and suffix and compare the rest by position, other changes are replaced. The result is deterministic and applies to the source to give the target, but is not minimal and never uses move, copy or test. One cumulative patch ledger covers both inputs and the produced operations.
  • Add JSONHTMLRenderer.renderDifference(from:to:) and renderDifferenceWithReport, a static, script-free page that shows two exact values as one combined tree. Added, removed and changed values carry text markers as well as color; equal values stay visible but collapsed. A summary, a change list linked by JSON Pointer, a CSS-only "Show changes only" toggle and native downloads of the RFC 6902 patch, the source and the target complete the page. Its CSP authorizes the two stylesheets by hash and sets script-src 'none'. The comparison is a package walker in JSON shared with JSONPatch.difference, so JSONHTML still depends on JSON only.
  • Add RFC 7464 JSON text sequences (application/json-seq) to JSONStreaming. JSONTextSequence reads texts framed by the record separator byte with the same pull model and budgets as NDJSON. Unterminated top-level scalars are treated as possibly truncated (RFC 7464 section 2.4). Malformed texts fail by default; JSONTextSequenceOptions.MalformedTexts.skip skips them and counts them on the iterator, but never skips resource failures. JSONTextSequenceWriter writes RS, strict JSON and LF per value, as one sequence or in awaited chunks.
  • Add JSONEnvelope, a versioned record of one payload in RFC 8785 canonical bytes. Format version 1 is a canonical object with digest, format (swift-json-envelope), formatVersion (1), payload, type and version. The digest is the SHA-256 of the payload's canonical bytes; decoding checks the marker, fields and digest and reports JSONEnvelopeFailure for invalid or damaged envelopes. Equal envelopes encode to equal bytes, and equal payloads have equal digests for content addressing. Tests pin bytes and digests computed independently.

Maintenance collected as 1.9.1 hygiene (not published separately)

  • Add the platform-floor native CI lane. It checks the macOS 15 / iOS 18 manifest minimums, cross-compiles all twelve libraries for iOS 18 devices and the iOS simulator, and builds and runs Tools/PlatformFloorConsumer, an external consumer declaring the same minimums. Runtime tests on macOS 15-26 or iOS 18 systems remain outside CI.
  • The CLI source identity no longer covers DocC catalogs (*.docc), so documentation-only edits no longer require regenerating it.
  • Repository housekeeping: superseded remote branches removed; branches without a PR were first preserved as archive/<branch> tags.
  • Developer kit 0.2.0: the skill and its compiled recipes now target published 1.9.0 (twelve libraries, the CLI, macOS 15 / iOS 18). The repository is a Claude Code plugin marketplace (/plugin marketplace add ThorFuchs/Swift-JSON), and the kit validator checks content and runs in the docs lane. The kit download release remains a separate maintainer action.

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 and the 1.9 qualification record.

  • Add exact versioned Transform source definitions, a bounded native codec and successful compilation reports through the existing compiler.

  • Add finite indexed selection scopes over explicit populations, owner-bound positions and private-constructor EOF/accounting witnesses. Admission, projection, VM evaluation, provider/output handling and completion share one ledger. Preserve order/repeats, first failures and terminal lease accounting; ordinary Transform/CLI semantics and all thirteen products remain unchanged.

  • Extend public acceptance across schema validation, store/transform reads and checked Patch rebuilds, with exact numeric/scalar identity and lifecycle cases.

  • Add a frozen capacity/owned-counter matrix and compiled cross-product recipes; distinguish diagnostic refusals from completed cells and logical retention from timing, RSS and allocations. Library APIs/algorithms and default policies unchanged.

  • Add ordered typed-path, snapshot-ordinal and store-position value batches using one cumulative native ledger per batch, complete source admission and atomic results.

  • Promote the original checked configured-store profile/construction inside JSONInspection; add exact-ID lookup and finite complete BFS reference following.

  • Preserve exact numbers/scalar identity, unforgeable source-local positions, explicit absent/null/link states and original construction error precedence.

  • Add external SwiftPM examples, ordinary compiler refusals, boundary/lifecycle/ concurrency tests and exact scoped CI discovery. Qualification remains source-bound; no 1.9 release or performance/platform pass is implied.

  • Refine the new store API before release. JSONStoreFailure reports a typed JSONStoreFailurePhase and JSONStoreCapacity (raw values keep the original phase numbers and capacity names) and is Equatable. JSONStoreReferences.strict(marker:) drops the validateTargets flag that only accepted true; targets are always validated. Add JSONConfiguredStore.collectionIndex(named:).

  • Add integer record IDs. Each collection declares a JSONStoreIDKind; .string stays the default. Integer IDs compare by exact mathematical value (7, 7.0 and 7e0 are one ID), stay exact beyond Double precision and never expand large exponents. IDs never convert between kinds. JSONStoreRecordMetadata.id is now a typed JSONStoreRecordID, and lookup(collection:id:) accepts one; the String overload remains. String-ID accounting and all 69 pinned NAV12 vectors are unchanged.

  • Add JSONInspectionBatch.optionalValues(at:maximumRequests:): nil for an absent member or an index past the end, the same errors as values(at:) otherwise.

  • Add JSONTransformProgram.selectIndices(in:bindings:limits:source:), returning the selected ordinals with completion statistics identical to the manual loop.

  • Move the WASI lane pin to Swift 6.4.2 (swift-6.4.2-RELEASE_wasm).

  • Composition accounting: apply inputBytes per document while keeping reported input cumulative, and charge completion's own report (424 logical bytes, 50 work units) on the original ledger. Add the checked reserveExternalLogicalBytes(_:count:overhead:) overload; the two-argument form is unchanged. Salvaged from the historical composition branch (PR #63) without its performance toolkit.

  • Lower the Apple deployment minimums from macOS/iOS 27 to macOS 15 and iOS 18. Development still uses Swift 6.4 with the macOS 27 SDK. Linux and WASI are unchanged.

  • JSONHTML: the WebKit WebPage PDF backend is available on macOS/iOS 26 and later; earlier systems report the existing JSONPDFFailure.backendUnavailable, as on platforms without WebKit. The Markdown transfer type uses the system-declared net.daringfireball.markdown identifier before macOS/iOS 27.

  • The platform change alone changes no public API, behavior or dependency on macOS/iOS 27.

1.8.0 — prepared source; publication separate

  • Add JSONLocatedTopLevelArraySequence and JSONLocatedTopLevelArrayEvent to JSONStreaming. Each root-array element also reports its JSONSourceSpan: zero-based half-open UTF-8 byte offsets in the complete stream, excluding whitespace and separators, independent of chunk boundaries. Spans stay provisional until documentCompleted; no original bytes are retained.
  • Both root-array facades share one strict grammar and pull driver, so quotas, errors, statistics and completion are identical. JSONTopLevelArraySequence behavior and all existing products, dependencies and platforms are unchanged.
  • Report CLI source version 1.8.0 with a regenerated deterministic source identity. The proposed bounded structural workflows move to 1.9.0 in the roadmap. See the minor release notes.

1.7.1 — prepared source; publication separate

  • Fix packaged Draft 2020-12 resource discovery when SwiftPM's native test host loads JSONSchema from an XCTest bundle. Search beside that bundle after the existing locations; preserve integrity checks, finite cumulative compilation budgets, cancellation and selected-resource failure behavior.
  • Add a real public native SwiftPM test-host regression in Debug and Release, retaining the standalone intact, missing and corrupt resource probes.
  • Report CLI source version 1.7.1 with a regenerated deterministic source identity. No public API, product, dependency or deployment change is introduced.
  • See the patch release notes for scope and the source-bound qualification asset attached to the draft release for outcomes.

Publication note — 28 October 2026

Version 1.7.0 was published from 8557badef562cf2f059e964c113d4a7f60ecbe6c. The preparation records below retain their original historical wording.

1.7.0 — prepared source; publication separate

  • Reconcile admitted set/matrix APIs with the reviewed public directed graph, shared JSONTransform compiler/pull VM and optional exact value/schema DSLs.
  • Retain package-only configured-store preparation/construction with one original scope/ledger; no public store, follow or persistence API is introduced.
  • Keep twelve libraries plus CLI and thirteen DocC catalogs including the shared JSONDSLCore reference. Root dependencies and Apple deployment floors remain unchanged.
  • Preserve finite exact semantics and all predecessor fixtures, failures and performance/platform holds. Require fresh combined-source qualification; a merge is development integration and does not publish a version.
  • Prepare the combined source with CLI version1.7.0 and a regenerated deterministic source digest. Record exact final-source outcomes in the release checklist and release notes.
  • Preserve consolidation qualification and every historical failed attempt; neither preparation nor CI creates a release.

Historical JTX10 release-candidate checkpoint (unpublished)

  • Add opt-in JSONTransform over the existing shared compiler and pull VM; retain immutable Sendable plans, guarded invocation-owned execution, exact native output admission and package-only cumulative CLI adapters. No second interpreter.
  • Include admitted Inspection array evidence, source-attached snapshots, trees and sparse tables: ten libraries plus CLI, ten catalogs, 1,214 authored declarations.
  • Report candidate source version 1.7.0 with deterministic CLI identity; stable remains 1.6.1. Publication and exact-version consumption are separate later gates.
  • Preserve loaded-host timing limits, original 8M refusal and separately approved private 100k16M profile. Record the explicit one-time allocation-instrumentation waiver; events, allocated bytes and profiler overhead remain unknown.
  • See candidate qualification for source-bound gates, Apple/Linux/scoped WASI claims and historical holds.

Historical authored-DSL prototype checkpoint (unpublished)

The value/schema DSL proposal was developed against the earlier 1.4-era source, but JSONValueDSL and JSONSchemaDSL are absent from the published 1.4.0, 1.5.0 and 1.6.1 manifests. Their first combined public-product preparation is this 1.7 source. The prototype introduced trusted authored values/schema documents with native exact semantics and finite iterative finalization; staging/callbacks remain caller work.

Historical JSONTransform extraction checkpoints

  • Add an optional public compiler/pull API over the single existing private query kernel.
  • Preserve CLI ownership through package-only cumulative adapters; add real-engine lifecycle, exactness, provider and typed failure tests and a standalone consumer.
  • Retain rejected inout substitution and Swift 6.4 borrowed-capture compiler failure evidence; the guarded handle API and release qualification remain provisional.

Earlier 1.7 development metadata checkpoint (historical)

  • Retain admitted opt-in JSONInspection: observation-only array evidence, exact first-seen columns and explicit complete/prefix coverage; 44 authored declarations, with all 56 Navigation declarations unchanged.
  • Identify development source as 1.7.0-dev, separate from the eight-library 1.6 maintenance line. No N3/P1, DSL, accounting or deployment change is implied.

1.6.1

  • Publish the eight-library maintenance source with matching source, DocC and qualification assets; see 1.6.1 qualification.

  • Run the existing full Native/Linux matrices automatically on release/1.6 pushes and document bounded build-incident handling; main retains its Pages guard.

  • Reconcile published Navigation, eight-library/eight-catalog authority and historical candidate records without changing the public API or runtime.

  • Report the maintenance source version 1.6.1 with a regenerated deterministic CLI source identity. Preserve Swift 6.4/language 6, Apple OS/SDK 27+, Linux/WASI scope, empty dependencies, upstream notices and all 49 finite policies.

  • Clarify stable versus development documentation and branch-specific release inventories. Version headings describe source; official release metadata determines publication status.

1.6.0 — 2026-10-16

  • Add opt-in JSONSchemaExamples: deterministic exact candidates, conservative typed construction, offline immutable preparation, versioned provenance and completed native root validation before returning a value. Unsupported/exhausted search remains explicit and does not establish unsatisfiability.

  • Add opt-in JSONNavigation: exact many-node DFS, physical/virtual scopes, finite metadata, overlap/stop/pruning policy and explicit completion coverage. Core one-node reads remain unchanged; deeper N2 inspection stays deferred.

  • Include bounded native composition with shared cumulative work and terminal failure accounting. Synthetic capacity qualification keeps five completed imports separate from three operational refusals; arbitrary capacity is not promised.

  • Add structured JSONHTML layouts with finite string, color, declared raster, inline and atomic MathML previews; preserve exact source, complete export/print and shared CLI policy. Native, browser and WASI evidence is recorded with remaining assistive and host qualification boundaries.

  • Preserve the 1.5.1 maintenance repairs. CLI metadata reports 1.6.0 with a deterministic source digest. Keep nine products, no root dependencies and all 49 baseline finite policies.

  • Restore native DocC guide navigators at existing URLs, with byte-identical per-catalog indexes and twelve focused regression cases. Retain documented cross-catalog routing and one observed lazy-chunk loading limitation.

1.5.1 — 2026-10-15

  • Restore best-effort schema diagnostic omission without latching terminal failure; strict diagnostic, work, retention, annotation and cancellation errors still throw.
  • Restore all 126 test functions from the separately published 1.2.1 maintenance line, public integration/resource consumers and exact discovery/safety inventories.
  • Qualify extracted archives without requiring or borrowing a parent Git checkout.
  • Replace stale CLI development metadata with an explicit version and reproducible source digest; preserve empty dependencies, all seven products and 49 core caps.
  • Reconcile README, support/platform guidance, release history and DocC navigation. Structured HTML previews remain outside the separate 1.5.1 patch candidate.

1.5.0 — 2026-10-15

  • Ship the bounded swift-json CLI: strict formatting/validation, Pointer, staged Patch, exact pull queries/arithmetic, advanced filters, streaming and HTML/text/ Markdown rendering. Add offline strict Responses schema fragment helpers.
  • Preserve the six libraries and add only the executable; no root dependencies.
  • Qualify native and ARM64/x86_64 Linux behavior/safety, source reproduction, public consumers and six DocC catalogues. Full CLI/WASI and Apple model helpers remain unqualified/unavailable. Frozen CLI metadata reports 1.4.0-dev/unknown, explicitly disclosed in the release notes and repaired in the next candidate.

1.4.0 tag — 2026-10-15

The protected public version tag exists; its separate GitHub release remains draft. These additive APIs are also included in the published 1.5.0 release.

  • Add E2's shallow JSON parsing, checked object construction, decimal-text and pre-parsed Pointer entry points; exact-key membership and three-state presence composition; and direct validation from an immutable compiled schema plan.

  • Add the opt-in JSONBridges product with trusted integer construction, checked integer projection, explicitly named Double round-trip-text admission and policy-explicit Double/Foundation Decimal projection. Core imports remain isolated. The generic JSON.number integer overload is deferred because it changes existing literal overload resolution. Exact-binary source conversion, Float-family and Decimal source bridges remain deferred.

1.3.0 — 2026-10-14

  • Add typed caller diagnostics and coherent JSONDocument byte-span rendering to JSONHTML, with exact target identity, explicitly missing-parent attachment and finite cumulative annotation/path/message accounting. Rendering never asserts schema validity or archives source bytes; replaced roots invent no locations.

  • Add explicit main-actor PDF preparation from immutable static HTML, with genuine A4/Letter text-range pagination, an explicit continuous mode, cumulative finite accounting, cancellation/deadline lifecycle and prepared-byte-only transfer.

  • Add opt-in styled RTF to immutable JSONHTML prepared exports. An owned bounded strict-token emitter preserves pretty JSON text, Unicode scalar sequences and number spellings; native decoding checks font, colors and actual tab positions. Finite style/UTF-16 ceilings complement cumulative work/output/retention limits. Direct JSON defaults remain JSON, HTML, plain text and Markdown.

  • Add immutable prepared JSON, UTF-8 text, Markdown and expanded static HTML in JSONHTML, plus Apple native JSON Transferable conformance with strict import. Preparation preserves exact lexemes/scalars/order under one cumulative meter; selected-format closure guards prevent transport from exposing hidden artifacts. Real receiving-app/device qualification remains separate.

  • Add opt-in JSONHTML interactive disclosure, container outline, literal search, native-byte JSON/Pointer copy and downloads, and complete print content; qualify three browser engines separately from Safari/device/accessibility release gates.

  • Develop JSONHTML as the fifth product for 1.3: exact formatted standalone HTML, shared strict-writer token formatting, literal tab indentation, cumulative finite reports, bounded script-free output and a fifth native DocC catalogue.

1.2.1 — 2026-10-14

Published from the separate 1.2 maintenance branch. Add 126 behavior/conformance functions, public integration and missing/corrupt-resource acceptance, complete coverage export and explicit performance disposition. Repair best-effort schema diagnostics and Git-free qualification identity. These two repairs and the added suites were absent from 1.3.0 through 1.5.0; the 1.5.1 candidate restores them. Historical qualification and performance receipts retain their original scope.

1.2.0 — 2026-10-13

  • Add Swift 6.4 Ubuntu 24.04/glibc ARM64/x86_64 builds and portable schema integrity.

  • Add local full-language wasm32 WASI support, preserving all four products and the empty root dependency graph. Twelve cumulative UInt64 quotas can exceed Int.max without changing profiles; allocation capacities retain Int guards. Check retired work overflow before admission. Load integrity-pinned schema resources beside the WASI command and throw structured missing-resource errors. Add exact portable qualification with explicit host/safety scope.

1.1.1 — 2026-10-13

  • Keep object-schema construction and document admission within one cumulative budget, including live retention and terminal owned failures/cancellation. Tight limits that previously fit each phase separately can now fail the composed call. Public signatures and finite default profiles are unchanged.

  • Update release documentation for the published 1.1.0 package and its macOS, iOS and iPadOS 27 baseline.

1.1.0 — 2026-10-12

  • Scoped typed reads with cumulative reports, native model projection and guarded cursor invalidation; explicit numeric fidelity and absent/null presence.
  • Native JSON value-coding conveniences and immutable exact Version 1 payload.
  • Metered adaptive exact-key metadata and incremental duplicate recognition; ordered members and exact collision confirmation remain authoritative.
  • macOS/iOS 27 deployment minima and corrected schema bundle layout; public SDK/simulator and disk-backed SwiftData consumers. Full physical-device qualification follows the approved 1.1 matrix: physical iPhone required, iPad SDK/simulator acceptance with physical iPad deferred.
  • Correct native ISO-8601 calendar fields and strict Base64 unused padding bits. See API migration guidance; no limits/profile weights or dependencies raised.
  • Release failed Base64 scratch from logical retention while preserving consumed work and terminal operational errors. Add 19 acceptance/conformance tests, public mobile recovery checks and a focused debug/release/ASAN QA lane.

1.0.0 — 2026-10-11

First stable release.

  • Public GitHub Pages documentation with four native DocC references; the exact artifact publishes from main after native, safety and documentation CI pass.

  • Public README with eight executed Swift examples; complete authored API/parameter documentation, focused DocC guides and verified native-symbol DocC catalogs.

  • Four SwiftPM library products on Swift 6.4, Swift 6 and macOS 27: JSON, JSONSchema, JSONStreaming and JSONPatch. No root package dependencies.

  • Exact bounded decimal mathematics and decoded-scalar key/text identity; ordered objects with order-independent equality and hashing.

  • One strict incremental UTF-8 parser and writer; native value-based Codable, presence/construction helpers, RFC 6901 Pointer, owned source documents, bounded previews/diagnostics and versioned operation reports.

  • Draft 2020-12 compilation/evaluation with explicit immutable registries, packaged meta-schema bootstrap, vocabularies, static/dynamic references, successful-branch annotations, unevaluated behavior, native formats, flag/basic output and raw declaration inspection.

  • Private interruptible, budgeted ECMA-262 2020 Unicode regex implementation; pinned Unicode 13 tables and plan-local immutable program sharing.

  • Staged RFC 6902 and RFC 7396, including root removal and intermediate limits.

  • Pull event/value streams, strict NDJSON, root-array provisional elements and explicit completion, awaited sinks, backpressure and cumulative quotas.

  • Pinned independent syntax/schema suites with enumerated policy outcomes, deterministic malformed replay, native concurrency/safety lanes, public qualification and benchmark tools, compiled examples and four DocC catalogs.

Qualification details and counts are in Documentation/Qualification/README.md. Resource policy bounds logical work/ownership; it is not an operating-system RSS ceiling. E09 keeps scalar scanning and no retained scratch pool. SIMD and regex prefilters remain unselected; projection and RFC 7464 framing remain deferred.

Exact coding and public reports

  • Reject lossy native String-dictionary and changed CodingKey spelling projections.
  • Add exact JSONObject Codable round-trips and a raw-schema compile report that includes document admission within the same cumulative meter.
  • Make native cancellation qualification rendezvous after counted work, without timing sleeps; retain an invocation-local package-only checkpoint observer.
  • Qualify twenty frozen explicitly rooted downstream schema vectors and public cumulative budgets in a separate consumer; no protocol/runtime dependency added.