Skip to content

Commit d02b75b

Browse files
ThorFuchsclaude
andauthored
Add bounded store workflows and Transform selection for 1.9 (#74)
Squash of the 1.9 candidate: ordered Inspection batches, the public immutable configured store with exact-ID lookup and bounded BFS follow (public API admitted by the maintainer 2026-11-10), exact Transform source definitions with compile reports, finite indexed selection scopes, cross-product acceptance, composition CI execution lanes, and the reconciliations with published 1.8.0 and #81. The full commit history, including the qualified source-bound commits, remains on branch codex/1.8-selection-main-qa. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 5362626 commit d02b75b

65 files changed

Lines changed: 5221 additions & 158 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/workflows/linux.yml‎

Lines changed: 20 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,13 @@ concurrency:
1111
cancel-in-progress: true
1212
jobs:
1313
qualification:
14-
name: Linux / ${{ matrix.architecture }} / ${{ matrix.lane }}
14+
name: Linux execution / ${{ matrix.architecture }} / ${{ matrix.lane }}
1515
runs-on: ${{ matrix.runner }}
1616
timeout-minutes: 60
1717
strategy:
1818
fail-fast: false
1919
matrix:
20-
lane: [linux, linux-safety]
20+
lane: [linux, linux-safety, composition]
2121
architecture: [x86_64, arm64]
2222
include:
2323
- architecture: x86_64
@@ -47,9 +47,6 @@ jobs:
4747
git config --global --add safe.directory "$GITHUB_WORKSPACE"
4848
test "$(git rev-parse HEAD)" = "$GITHUB_SHA"
4949
- run: python3 -B Scripts/ci.py --lane '${{ matrix.lane }}'
50-
- name: Public composition and reference imports
51-
if: matrix.lane == 'linux'
52-
run: python3 -B Scripts/ci.py --lane composition
5350
- name: Preserve Linux receipts
5451
if: always()
5552
uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
@@ -60,3 +57,21 @@ jobs:
6057
path: |
6158
.build/ci/
6259
!.build/ci/**/reproduction/extracted/**
60+
required:
61+
# Both architectures and all three lanes must succeed. Preserve the four
62+
# existing context names without converting an incomplete matrix to green.
63+
name: Linux / ${{ matrix.architecture }} / ${{ matrix.lane }}
64+
needs: qualification
65+
if: ${{ always() }}
66+
runs-on: ubuntu-latest
67+
timeout-minutes: 5
68+
strategy:
69+
fail-fast: false
70+
matrix:
71+
lane: [linux, linux-safety]
72+
architecture: [x86_64, arm64]
73+
steps:
74+
- name: Require complete qualification
75+
env:
76+
QUALIFICATION_RESULT: ${{ needs.qualification.result }}
77+
run: test "$QUALIFICATION_RESULT" = success

‎.github/workflows/native.yml‎

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -11,13 +11,13 @@ concurrency:
1111
cancel-in-progress: true
1212
jobs:
1313
qualification:
14-
name: Native / ${{ matrix.lane }}
14+
name: Native execution / ${{ matrix.lane }}
1515
runs-on: xcode-27
1616
timeout-minutes: 60
1717
strategy:
1818
fail-fast: false
1919
matrix:
20-
lane: [native, safety, docs, archive]
20+
lane: [native, safety, docs, archive, composition]
2121
env:
2222
DEVELOPER_DIR: /Applications/Xcode_27.2.app/Contents/Developer
2323
PYTHONDONTWRITEBYTECODE: '1'
@@ -34,9 +34,6 @@ jobs:
3434
- run: python3 -B Scripts/ci.py --lane '${{ matrix.lane }}'
3535
env:
3636
SWIFT_JSON_RELEASE_METADATA: ${{ github.workspace }}/.build/handoff/pages/latest-release.json
37-
- name: Public composition and reference imports
38-
if: matrix.lane == 'native'
39-
run: python3 -B Scripts/ci.py --lane composition
4037
- name: Preserve native receipts
4138
if: always()
4239
uses: actions/upload-artifact@b7c566a772e6b6bfb58ed0dc250532a479d7789f # v6
@@ -63,10 +60,27 @@ jobs:
6360
with:
6461
path: .build/handoff/pages/site
6562
include-hidden-files: true # Preserve the verified .nojekyll file; only the generated site is uploaded.
63+
required:
64+
# Preserve protected context names. Every execution lane, including
65+
# composition, must succeed; a failed/cancelled/skipped dependency fails here.
66+
name: Native / ${{ matrix.lane }}
67+
needs: qualification
68+
if: ${{ always() }}
69+
runs-on: ubuntu-latest
70+
timeout-minutes: 5
71+
strategy:
72+
fail-fast: false
73+
matrix:
74+
lane: [native, safety, docs, archive]
75+
steps:
76+
- name: Require complete qualification
77+
env:
78+
QUALIFICATION_RESULT: ${{ needs.qualification.result }}
79+
run: test "$QUALIFICATION_RESULT" = success
6680
publish:
6781
name: Documentation / publish
6882
if: github.ref == 'refs/heads/main' && github.event_name != 'pull_request'
69-
needs: qualification
83+
needs: [qualification, required]
7084
# Native compilation and all qualification happened in the jobs above.
7185
# This job only publishes their exact static artifact.
7286
runs-on: ubuntu-latest

‎AGENTS.md‎

Lines changed: 20 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
# Contributor instructions
22

3-
Prepared minor release source is 1.8.0; publication is a separate owner action. It
4-
adds located root-array streaming to the published 1.7.1 line; stable 1.6.1 remains
5-
separate. This is not a maintenance release or the frozen 6fe8067 RC. Preserve all source-bound
6-
qualification history; source integration never publishes a version.
3+
Development source is 1.9.0-dev, based on published 1.8.0 at
4+
66718f11514d8c555f6a6b0ecc738e5029405a55. Stable 1.6.1 remains a separate
5+
maintenance line. Preserve every source-bound qualification record. No 1.9
6+
merge/tag/publication follows from implementation or passing tests.
77

88
Swift-JSON requires Swift tools/compiler 6.4+, Swift language mode 6 and
99
macOS/SDK 27+. Read README.md, CONTRIBUTING.md and the relevant contracts in
@@ -50,13 +50,25 @@ Scalar scanning and immutable plan-local regex sharing are selected private
5050
optimizations. Source-attached N3 snapshots and P1 tree/sparse-table projections live in JSONInspection.
5151
NAV10 set/matrix and NAV11 directed-simple-graph APIs are development capabilities
5252
inside JSONInspection; no graph product, mutation or serializer is introduced.
53-
Private NAV12 store construction/preparation remains package-only and shares one
54-
original invocation ledger; no public store/follow API or persistence is exposed.
55-
Wider retrieval/persistence, NAV13 batches and JSON text-sequence framing remain
56-
separate, unadmitted work.
53+
The 1.9 candidate promotes the checked immutable configured store inside
54+
JSONInspection and adds ordered path/snapshot/store value batches, exact-ID lookup
55+
and bounded complete BFS follow. The maintainer admitted this public read-only
56+
store/follow API on 2026-11-10; merge and release remain separate decisions. Preserve the original construction phases and
57+
one invocation-owned ledger per operation. Positions remain unforgeable and
58+
source-instance-local. No persistence or mutable store is exposed. See
59+
Documentation/Architecture/StructuralIntelligence/BoundedWorkflows1.8.md.
60+
Wider retrieval/persistence and JSON text-sequence framing remain separate work.
5761

5862
JSONTransform uses one private compiler/VM and the CLI's accounted adapter.
5963
Preserve its accepted 42 authored declarations and exact semantics. The original
6064
1.7.0 P4 waiver and later partial measurements are historical scoped evidence;
6165
no allocation, speed, RSS or controlled-performance pass follows from consolidation.
6266
See Documentation/Qualification/Consolidation2026.md for combined gates and holds.
67+
68+
The commissioned 1.8 Transform binding train adds a source-definition codec and
69+
compile reports while preserving those original declarations. Sprint 1
70+
retains its historical test-only selection experiment. Sprint 2 adds public
71+
guarded selection scopes, owner-bound positions and EOF completion reports;
72+
preserve ordinary Transform semantics and require one cumulative invocation ledger.
73+
See Documentation/Architecture/Release1.8/TransformBindings.md. No Content code,
74+
lock, message, merge or publication is authorized by implementing this sprint.

‎CHANGELOG.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,30 @@
22

33
## Unreleased — 1.9.0-dev
44

5+
- Add exact versioned Transform source definitions, a bounded native codec and
6+
successful compilation reports through the existing compiler.
7+
- Add finite indexed selection scopes over explicit populations, owner-bound
8+
positions and private-constructor EOF/accounting witnesses. Admission, projection,
9+
VM evaluation, provider/output handling and completion share one ledger.
10+
Preserve order/repeats, first failures and terminal lease accounting; ordinary
11+
Transform/CLI semantics and all thirteen products remain unchanged.
12+
13+
- Extend public acceptance across schema validation, store/transform reads and
14+
checked Patch rebuilds, with exact numeric/scalar identity and lifecycle cases.
15+
- Add a frozen capacity/owned-counter matrix and compiled cross-product recipes;
16+
distinguish diagnostic refusals from completed cells and logical retention from
17+
timing, RSS and allocations. Library APIs/algorithms and default policies unchanged.
18+
19+
- Add ordered typed-path, snapshot-ordinal and store-position value batches using
20+
one cumulative native ledger per batch, complete source admission and atomic results.
21+
- Promote the original checked configured-store profile/construction inside
22+
JSONInspection; add exact-ID lookup and finite complete BFS reference following.
23+
- Preserve exact numbers/scalar identity, unforgeable source-local positions,
24+
explicit absent/null/link states and original construction error precedence.
25+
- Add external SwiftPM examples, ordinary compiler refusals, boundary/lifecycle/
26+
concurrency tests and exact scoped CI discovery. Qualification remains source-bound;
27+
no 1.9 release or performance/platform pass is implied.
28+
529
- Composition accounting: apply `inputBytes` per document while keeping reported
630
input cumulative, and charge completion's own report (424 logical bytes, 50
731
work units) on the original ledger. Add the checked
@@ -37,6 +61,11 @@
3761
- See the [patch release notes](Documentation/ReleaseNotes/1.7.1.md) for scope and
3862
the source-bound qualification asset attached to the draft release for outcomes.
3963

64+
## Publication note — 28 October 2026
65+
66+
Version 1.7.0 was published from 8557badef562cf2f059e964c113d4a7f60ecbe6c.
67+
The preparation records below retain their original historical wording.
68+
4069
## 1.7.0 — prepared source; publication separate
4170

4271
- Reconcile admitted set/matrix APIs with the reviewed public directed graph,

‎CONTRIBUTING.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,15 @@
1+
# 1.9 scoped workflow qualification
2+
3+
This isolated development source is 1.9.0-dev from published 1.8.0.
4+
Run `python3 Scripts/ci.py --lane structural-workflows` for exact Debug/Release
5+
behavior, preserved store cases and public compiler/consumer checks. M2 adds
6+
`--lane structural-acceptance` and `--lane structural-acceptance-safety` for exact
7+
public cross-product cases, deterministic capacity observations and their safety
8+
checks. These extend the existing gates. Run
9+
`--lane structural-workflows-safety` for scoped ASan, shared-state TSan and strict
10+
memory checks; complete native/Linux/docs/WASI gates still apply before release.
11+
Do not infer a pass when storage or an actual supported runtime is unavailable.
12+
113
# Contributing
214

315
Choose the source line deliberately: maintenance changes use the 1.6 line;

‎Documentation/Architecture/API.md‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,22 @@
1+
# 1.9 additive API candidate
2+
3+
The latest released source is 1.8.0 (66718f11); this feature source is 1.9.0-dev.
4+
No product or dependency is added. JSONInspection now includes
5+
`JSONInspectionBatch`, snapshot ordinal batches, public `JSONStoreBuilder`/
6+
`JSONConfiguredStore` and typed profile/metadata/error declarations, exact-ID
7+
lookup, position value batches and finite complete BFS follow.
8+
See [the exact behavior/ownership boundary](StructuralIntelligence/BoundedWorkflows1.8.md)
9+
and [qualification](../Qualification/Release1.8.md).
10+
The optional JSONTransform candidate also adds immutable versioned source definitions,
11+
a bounded native codec and successful compilation reports. Finite public selection
12+
scopes produce owner-bound positions and private-constructor EOF completion reports
13+
through the same compiler/VM. See the [binding contract](Release1.8/TransformBindings.md)
14+
and [selection qualification](../Qualification/TransformSelection1.8.md). No released
15+
1.7 signature or ordinary execution/CLI semantics change.
16+
Navigation public signatures stay unchanged; its new selection capability is
17+
package-only and uses the original admitted scope. Earlier inventories below
18+
remain historical; compiler graphs must establish the final additive surface.
19+
120
# Current API inventory
221

322
Unreleased 1.7.0-dev consolidation has twelve library products plus swift-json and

‎Documentation/Architecture/ExtractionManifest.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -355,6 +355,17 @@
355355
"attribution": "Apache-2.0 prototype SPDX retained; original integration cases extend actual-engine qualification.",
356356
"validation": "Scripts/ci.py --lane dsl; native and safety exact discovery",
357357
"evidence": "Actual-engine Debug/Release/ASan receipts and real public consumer"
358+
},
359+
{
360+
"component": "1.8 bounded structural workflows",
361+
"source": "Original Swift-JSON implementation over the existing native prepared traversal and NAV12 checked store construction",
362+
"paths": [
363+
"Sources/JSONInspection/JSONInspectionBatch.swift",
364+
"Sources/JSONInspection/Store/JSONStoreQueries.swift",
365+
"Examples/BoundedWorkflows"
366+
],
367+
"validation": "Exact Debug/Release behavior, preserved 65 store vectors, public SwiftPM consumer, codegen negatives and safety/docs/platform gates; see Documentation/Qualification/Release1.8.md for actual status",
368+
"dependencies": "No new dependencies or numeric/key/schema authority; Apache-2.0 original contributions"
358369
}
359370
],
360371
"original_implementation_notes": [

0 commit comments

Comments
 (0)