iterate-kernel 0.1.4 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/README.md +14 -6
  2. package/dist/convergence.d.ts +90 -0
  3. package/dist/convergence.d.ts.map +1 -0
  4. package/dist/convergence.js +97 -0
  5. package/dist/convergence.js.map +1 -0
  6. package/dist/errors.d.ts +15 -0
  7. package/dist/errors.d.ts.map +1 -1
  8. package/dist/errors.js +7 -0
  9. package/dist/errors.js.map +1 -1
  10. package/dist/evidence-pack.d.ts +19 -19
  11. package/dist/index.d.ts +5 -2
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.js +5 -2
  14. package/dist/index.js.map +1 -1
  15. package/dist/invariant-report.d.ts +271 -0
  16. package/dist/invariant-report.d.ts.map +1 -0
  17. package/dist/invariant-report.js +145 -0
  18. package/dist/invariant-report.js.map +1 -0
  19. package/dist/parse.d.ts +7 -0
  20. package/dist/parse.d.ts.map +1 -1
  21. package/dist/parse.js +18 -10
  22. package/dist/parse.js.map +1 -1
  23. package/dist/provider-registration.d.ts +132 -0
  24. package/dist/provider-registration.d.ts.map +1 -0
  25. package/dist/provider-registration.js +119 -0
  26. package/dist/provider-registration.js.map +1 -0
  27. package/dist/schemas.d.ts +8 -0
  28. package/dist/schemas.d.ts.map +1 -1
  29. package/dist/schemas.js +8 -0
  30. package/dist/schemas.js.map +1 -1
  31. package/fixtures/convergence.ok-01.json +252 -0
  32. package/fixtures/invariant-report.ok-01.json +306 -0
  33. package/fixtures/provider-registration.ok-01.json +309 -0
  34. package/fixtures/run-plan.ok-01.json +1 -1
  35. package/package.json +13 -1
  36. package/schemas/convergence-round-state.schema.json +37 -0
  37. package/schemas/invariant-report.schema.json +108 -0
  38. package/schemas/provider-registration.schema.json +63 -0
  39. package/schemas/reverification-request.schema.json +89 -0
@@ -0,0 +1,306 @@
1
+ {
2
+ "comment": "Cross-implementation anchor for the invariant-report contract (kernel/src/invariant-report.ts): what a run may state about its own invariant checks, and how to digest one so a re-verification can cite the failure it answers. Rules a second implementation must reproduce, stated here so it need not read the TypeScript: (1) schemaVersion is exactly `iterate.invariant-report/0.1`. (2) `outcome` is `pass|fail|error`. (3) `checks` is 1..256 entries, each an object with required `name` (1..256 chars), required `kind` in `ensure|command|refused`, required `ok` boolean, and optional `detail` (<=4096); no other keys. (4) THE ONE RULE THAT MATTERS: `outcome` must follow from `checks`. `pass` requires every check to have ok true. `fail` requires at least one check with ok false. `error` is unconstrained. A report that says pass over a failed check is refused by both validators — the JSON Schema expresses this with `allOf`/`if`/`then`/`contains`, so a schema-only consumer refuses it too. (5) `kind` `refused` means the runner declined to execute a configured command because it carries shell metacharacters or is empty; it is a violation, so a report whose only failing check was refused is `fail`, never `error`. `error` is reserved for checks that could not be evaluated at all, and it produces no re-verification request. (6) `round` (>=1) and `durationMs` (>=0) are optional integers. (7) The digest is `iv_` + sha256 of the canonical JSON form: UTF-16-code-unit-sorted keys, no insignificant whitespace, arrays in order, strings as JSON escapes them; numbers use the host's shortest roundtrip form (integral values print without a fraction). (8) A re-verification request is `iterate.reverification/0.1` with `trigger.kind` exactly `invariant`, `trigger.reportDigest` matching `^iv_[0-9a-f]{64}$`, and `targets` carrying at least one of `recipeSteps` (1..64), `dimensions` (1..64 kebab-case ids <=64 chars), `operationIds` (1..64 matching `^op_[0-9A-HJKMNP-TV-Z]{26}$`); an empty target set is refused, by `anyOf` in the schema and by `superRefine` in the validator. PROVENANCE: every name, kind and detail string below was captured from `iterate_harness.defensive.invariants.check_invariants` running against the real repo — the ensure entries are the config's own `invariants.ensure` plus a file the run does not have, the command label is the real `<module>:<command>` format, the `exit 1 | ...` tail is real npm output truncated the way the runner truncates it (last three lines, joined by ' | '), and `python:ruff check src/ ; rm -rf /` is the metacharacter case the runner refuses with the exact string it uses. The runner records only violations plus a count, so the ok=true entries here are the configured check names minus the violating ones — that is how a producer derives `checks`, not an invention for this fixture.",
3
+ "input": {
4
+ "schemaVersion": "iterate.invariant-report/0.1",
5
+ "outcome": "fail",
6
+ "round": 3,
7
+ "durationMs": 917,
8
+ "checks": [
9
+ {
10
+ "name": "ensure:README.md",
11
+ "kind": "ensure",
12
+ "ok": true
13
+ },
14
+ {
15
+ "name": "ensure:iterate.config.yaml",
16
+ "kind": "ensure",
17
+ "ok": false,
18
+ "detail": "missing file: iterate.config.yaml"
19
+ },
20
+ {
21
+ "name": "typescript:npm run compile",
22
+ "kind": "command",
23
+ "ok": false,
24
+ "detail": "exit 1 | npm error To see a list of scripts, run: | npm error npm run | npm error A complete log of this run can be found in: /Users/ethanlin/.npm/_logs/2026-10-11T01_07_36_468Z-debug-0.log"
25
+ },
26
+ {
27
+ "name": "python:ruff check src/ ; rm -rf /",
28
+ "kind": "refused",
29
+ "ok": false,
30
+ "detail": "refused: unsafe command (shell metacharacter or empty)"
31
+ }
32
+ ]
33
+ },
34
+ "expectedDigest": "iv_81373b5040663b9f56a4a0bc671ab55e0d92bc33e5980b5580f3e7cec5902332",
35
+ "expectedFailingChecks": [
36
+ "ensure:iterate.config.yaml",
37
+ "typescript:npm run compile",
38
+ "python:ruff check src/ ; rm -rf /"
39
+ ],
40
+ "passInput": {
41
+ "schemaVersion": "iterate.invariant-report/0.1",
42
+ "outcome": "pass",
43
+ "round": 4,
44
+ "checks": [
45
+ {
46
+ "name": "ensure:README.md",
47
+ "kind": "ensure",
48
+ "ok": true
49
+ },
50
+ {
51
+ "name": "typescript:npm run compile",
52
+ "kind": "command",
53
+ "ok": true
54
+ }
55
+ ]
56
+ },
57
+ "passDigest": "iv_2038dfde43106446a87212196d1e6738ed4cdd9c1a90d6d55f94429401e8e501",
58
+ "errorInput": {
59
+ "schemaVersion": "iterate.invariant-report/0.1",
60
+ "outcome": "error",
61
+ "checks": [
62
+ {
63
+ "name": "python:pytest tests/ -x -q --timeout=60",
64
+ "kind": "command",
65
+ "ok": false,
66
+ "detail": "not measured: the runner could not start (timeout=60 requires pytest-timeout)"
67
+ }
68
+ ]
69
+ },
70
+ "errorDigest": "iv_7fe700d844d8c7ee60ce34220b55e6cbfca220d4aed27de0b22f091159c0c063",
71
+ "cases": [
72
+ {
73
+ "name": "pass-over-a-failed-check",
74
+ "input": {
75
+ "schemaVersion": "iterate.invariant-report/0.1",
76
+ "outcome": "pass",
77
+ "checks": [
78
+ {
79
+ "name": "ensure:README.md",
80
+ "kind": "ensure",
81
+ "ok": false,
82
+ "detail": "missing file: README.md"
83
+ }
84
+ ]
85
+ },
86
+ "expect": "refused",
87
+ "path": "outcome"
88
+ },
89
+ {
90
+ "name": "fail-with-every-check-ok",
91
+ "input": {
92
+ "schemaVersion": "iterate.invariant-report/0.1",
93
+ "outcome": "fail",
94
+ "checks": [
95
+ {
96
+ "name": "ensure:README.md",
97
+ "kind": "ensure",
98
+ "ok": true
99
+ }
100
+ ]
101
+ },
102
+ "expect": "refused",
103
+ "path": "outcome"
104
+ },
105
+ {
106
+ "name": "no-checks",
107
+ "input": {
108
+ "schemaVersion": "iterate.invariant-report/0.1",
109
+ "outcome": "pass",
110
+ "checks": []
111
+ },
112
+ "expect": "refused",
113
+ "path": "checks"
114
+ },
115
+ {
116
+ "name": "unknown-check-kind",
117
+ "input": {
118
+ "schemaVersion": "iterate.invariant-report/0.1",
119
+ "outcome": "fail",
120
+ "checks": [
121
+ {
122
+ "name": "ensure:README.md",
123
+ "kind": "vibes",
124
+ "ok": false
125
+ }
126
+ ]
127
+ },
128
+ "expect": "refused",
129
+ "path": "checks.0.kind"
130
+ },
131
+ {
132
+ "name": "check-without-ok",
133
+ "input": {
134
+ "schemaVersion": "iterate.invariant-report/0.1",
135
+ "outcome": "fail",
136
+ "checks": [
137
+ {
138
+ "name": "ensure:README.md",
139
+ "kind": "ensure",
140
+ "detail": "missing file: README.md"
141
+ }
142
+ ]
143
+ },
144
+ "expect": "refused",
145
+ "path": "checks.0.ok"
146
+ },
147
+ {
148
+ "name": "invented-outcome",
149
+ "input": {
150
+ "schemaVersion": "iterate.invariant-report/0.1",
151
+ "outcome": "probably",
152
+ "checks": [
153
+ {
154
+ "name": "ensure:README.md",
155
+ "kind": "ensure",
156
+ "ok": true
157
+ }
158
+ ]
159
+ },
160
+ "expect": "refused",
161
+ "path": "outcome"
162
+ },
163
+ {
164
+ "name": "extra-top-level-key",
165
+ "input": {
166
+ "schemaVersion": "iterate.invariant-report/0.1",
167
+ "outcome": "pass",
168
+ "checks": [
169
+ {
170
+ "name": "ensure:README.md",
171
+ "kind": "ensure",
172
+ "ok": true
173
+ }
174
+ ],
175
+ "note": "not part of the contract"
176
+ },
177
+ "expect": "refused",
178
+ "path": "",
179
+ "messageIncludes": "note"
180
+ },
181
+ {
182
+ "name": "zero-round",
183
+ "input": {
184
+ "schemaVersion": "iterate.invariant-report/0.1",
185
+ "outcome": "pass",
186
+ "round": 0,
187
+ "checks": [
188
+ {
189
+ "name": "ensure:README.md",
190
+ "kind": "ensure",
191
+ "ok": true
192
+ }
193
+ ]
194
+ },
195
+ "expect": "refused",
196
+ "path": "round"
197
+ },
198
+ {
199
+ "name": "error-report-is-accepted",
200
+ "input": {
201
+ "schemaVersion": "iterate.invariant-report/0.1",
202
+ "outcome": "error",
203
+ "checks": [
204
+ {
205
+ "name": "python:pytest tests/ -x -q --timeout=60",
206
+ "kind": "command",
207
+ "ok": false
208
+ }
209
+ ]
210
+ },
211
+ "expect": "accepted",
212
+ "digest": "iv_6d79b3b909a22c2185b11265ecf34ec04b6e7054530a96797f3dc02034ca2e2b"
213
+ },
214
+ {
215
+ "name": "refused-command-only",
216
+ "input": {
217
+ "schemaVersion": "iterate.invariant-report/0.1",
218
+ "outcome": "fail",
219
+ "checks": [
220
+ {
221
+ "name": "ensure:README.md",
222
+ "kind": "ensure",
223
+ "ok": true
224
+ },
225
+ {
226
+ "name": "python:ruff check src/ ; rm -rf /",
227
+ "kind": "refused",
228
+ "ok": false,
229
+ "detail": "refused: unsafe command (shell metacharacter or empty)"
230
+ }
231
+ ]
232
+ },
233
+ "expect": "accepted",
234
+ "failingChecks": ["python:ruff check src/ ; rm -rf /"]
235
+ }
236
+ ],
237
+ "reverificationCases": [
238
+ {
239
+ "name": "empty-targets",
240
+ "targets": {},
241
+ "expect": "refused"
242
+ },
243
+ {
244
+ "name": "dimensions-only",
245
+ "targets": {
246
+ "dimensions": ["spec-compliance", "frontend-backend"]
247
+ },
248
+ "expect": "accepted"
249
+ },
250
+ {
251
+ "name": "recipe-step-and-operation",
252
+ "targets": {
253
+ "recipeSteps": [
254
+ {
255
+ "kind": "assert",
256
+ "params": {
257
+ "selector": "id:gp-run-button"
258
+ }
259
+ }
260
+ ],
261
+ "operationIds": ["op_AAAAAAAAAAAAAAAAAAAAAAAAAA"]
262
+ },
263
+ "expect": "accepted"
264
+ },
265
+ {
266
+ "name": "uppercase-dimension",
267
+ "targets": {
268
+ "dimensions": ["Spec-Compliance"]
269
+ },
270
+ "expect": "refused"
271
+ },
272
+ {
273
+ "name": "bad-operation-id",
274
+ "targets": {
275
+ "operationIds": ["op_short"]
276
+ },
277
+ "expect": "refused"
278
+ },
279
+ {
280
+ "name": "unknown-target-kind",
281
+ "targets": {
282
+ "dimensions": ["security"],
283
+ "screenshots": ["a.png"]
284
+ },
285
+ "expect": "refused"
286
+ }
287
+ ],
288
+ "request": {
289
+ "schemaVersion": "iterate.reverification/0.1",
290
+ "trigger": {
291
+ "kind": "invariant",
292
+ "reportDigest": "iv_81373b5040663b9f56a4a0bc671ab55e0d92bc33e5980b5580f3e7cec5902332"
293
+ },
294
+ "targets": {
295
+ "recipeSteps": [
296
+ {
297
+ "kind": "assert",
298
+ "params": {
299
+ "selector": "id:gp-run-button"
300
+ }
301
+ }
302
+ ],
303
+ "dimensions": ["spec-compliance"]
304
+ }
305
+ }
306
+ }
@@ -0,0 +1,309 @@
1
+ {
2
+ "comment": "Cross-implementation anchor for the provider-registration contract (kernel/src/provider-registration.ts): how a judgement producer says what it offers, so both harnesses consume the same provider through the same shape (5.7 R40 scenario 5). Rules a second implementation must reproduce, stated here so it need not read the TypeScript: (1) schemaVersion is exactly `iterate.provider/0.1`. (2) Required: `id` and `kind` and `version` and `methods`. `id` matches `^[a-z0-9]+(?:-[a-z0-9]+)*$` and is <=64 chars; `kind` is `ae-diagnosis|report-render|evidence-source`; `version` is 1..64 chars; `origin` is optional and one of `kernel|glasspane|iterate|plugin`. (3) `methods` is 1..32 entries, each with a required `name` (same kebab pattern, <=64) and a required `requires` array (0..16 entries, same kebab pattern, <=64 each). An empty `requires` is a claim the provider makes — 'this needs nothing' — not an absence. (4) A method name repeated inside one registration is refused, not collapsed: the two declarations can carry different prerequisites, and last-write-wins would let a provider offer a method under prerequisites nobody agreed to. JSON Schema cannot express name-level uniqueness (`uniqueItems` compares whole objects), so the case named `duplicate-method-differs-only-by-requires` below is the documented shape where the published schema accepts and the validator refuses. (5) REGISTRY SEMANTICS, which are functions rather than schema features: registering an id already present is refused rather than overwriting it (a silent override means one product runs a provider the other never saw); resolution is exact — no default provider, no fuzzy match, no 'the only one registered'; asking a provider for a method it does not offer is refused and the error names what it does offer; a registry is replaced whole on each registration, never mutated, so a half-applied registration cannot leave one map with the provider and the next without it. (6) What two harnesses must not do is let the same id mean two different things across the boundary, so the ids in common between two registries are a question to settle before a run, not during one. PROVENANCE: the diagnosis classes and the prerequisite names are the evidence-pack contract's own vocabulary (`DiagnosisClassSchema` values T0..T9/NO_ANOMALY/INCONCLUSIVE, and `SignalsSchema` keys axEvent/handlerProbe/stateDiff/pixelDiff/responsiveness/crash rendered in kebab case) — a provider that requires `pixel-diff` is requiring the signal an evidence pack actually carries. `glasspane-engine` is the engine that produces those packs, and the report-render provider is the engine's markdown/HTML report (the two renderings shipped as `report.ok-01.md` and `report.ok-01.html` in this same corpus). The version strings are the package/engine versions at the time of writing, not placeholders.",
3
+ "input": {
4
+ "schemaVersion": "iterate.provider/0.1",
5
+ "id": "glasspane-engine-ae",
6
+ "kind": "ae-diagnosis",
7
+ "version": "1.11.0",
8
+ "origin": "glasspane",
9
+ "methods": [
10
+ {
11
+ "name": "diagnose",
12
+ "requires": ["ax-event", "attribution", "circuit-breaker"]
13
+ },
14
+ {
15
+ "name": "diagnose-pixel",
16
+ "requires": ["ax-event", "pixel-diff", "attribution", "circuit-breaker"]
17
+ },
18
+ {
19
+ "name": "diagnose-probed",
20
+ "requires": ["ax-event", "handler-probe", "state-diff", "attribution"]
21
+ }
22
+ ]
23
+ },
24
+ "expectedMethods": ["diagnose", "diagnose-pixel", "diagnose-probed"],
25
+ "cases": [
26
+ {
27
+ "name": "duplicate-method-differs-only-by-requires",
28
+ "input": {
29
+ "schemaVersion": "iterate.provider/0.1",
30
+ "id": "glasspane-engine-ae",
31
+ "kind": "ae-diagnosis",
32
+ "version": "1.11.0",
33
+ "methods": [
34
+ {
35
+ "name": "diagnose",
36
+ "requires": []
37
+ },
38
+ {
39
+ "name": "diagnose",
40
+ "requires": ["pixel-diff"]
41
+ }
42
+ ]
43
+ },
44
+ "expect": "refused",
45
+ "path": "methods.1.name",
46
+ "jsonSchemaAccepts": true
47
+ },
48
+ {
49
+ "name": "uppercase-id",
50
+ "input": {
51
+ "schemaVersion": "iterate.provider/0.1",
52
+ "id": "GlasspaneEngine",
53
+ "kind": "ae-diagnosis",
54
+ "version": "1.11.0",
55
+ "methods": [
56
+ {
57
+ "name": "diagnose",
58
+ "requires": []
59
+ }
60
+ ]
61
+ },
62
+ "expect": "refused",
63
+ "path": "id"
64
+ },
65
+ {
66
+ "name": "unknown-kind",
67
+ "input": {
68
+ "schemaVersion": "iterate.provider/0.1",
69
+ "id": "glasspane-engine-ae",
70
+ "kind": "vibes",
71
+ "version": "1.11.0",
72
+ "methods": [
73
+ {
74
+ "name": "diagnose",
75
+ "requires": []
76
+ }
77
+ ]
78
+ },
79
+ "expect": "refused",
80
+ "path": "kind"
81
+ },
82
+ {
83
+ "name": "no-methods",
84
+ "input": {
85
+ "schemaVersion": "iterate.provider/0.1",
86
+ "id": "glasspane-engine-ae",
87
+ "kind": "ae-diagnosis",
88
+ "version": "1.11.0",
89
+ "methods": []
90
+ },
91
+ "expect": "refused",
92
+ "path": "methods"
93
+ },
94
+ {
95
+ "name": "empty-version",
96
+ "input": {
97
+ "schemaVersion": "iterate.provider/0.1",
98
+ "id": "glasspane-engine-ae",
99
+ "kind": "ae-diagnosis",
100
+ "version": "",
101
+ "methods": [
102
+ {
103
+ "name": "diagnose",
104
+ "requires": []
105
+ }
106
+ ]
107
+ },
108
+ "expect": "refused",
109
+ "path": "version"
110
+ },
111
+ {
112
+ "name": "method-without-requires",
113
+ "input": {
114
+ "schemaVersion": "iterate.provider/0.1",
115
+ "id": "iterate-report-render",
116
+ "kind": "report-render",
117
+ "version": "0.1.4",
118
+ "origin": "iterate",
119
+ "methods": [
120
+ {
121
+ "name": "render-markdown"
122
+ }
123
+ ]
124
+ },
125
+ "expect": "refused",
126
+ "path": "methods.0.requires"
127
+ },
128
+ {
129
+ "name": "uppercase-requires-name",
130
+ "input": {
131
+ "schemaVersion": "iterate.provider/0.1",
132
+ "id": "iterate-report-render",
133
+ "kind": "report-render",
134
+ "version": "0.1.4",
135
+ "methods": [
136
+ {
137
+ "name": "render-markdown",
138
+ "requires": ["SSH"]
139
+ }
140
+ ]
141
+ },
142
+ "expect": "refused",
143
+ "path": "methods.0.requires.0"
144
+ },
145
+ {
146
+ "name": "extra-top-level-key",
147
+ "input": {
148
+ "schemaVersion": "iterate.provider/0.1",
149
+ "id": "glasspane-engine-ae",
150
+ "kind": "ae-diagnosis",
151
+ "version": "1.11.0",
152
+ "methods": [
153
+ {
154
+ "name": "diagnose",
155
+ "requires": []
156
+ }
157
+ ],
158
+ "default": true
159
+ },
160
+ "expect": "refused",
161
+ "path": "",
162
+ "messageIncludes": "default"
163
+ },
164
+ {
165
+ "name": "no-origin",
166
+ "input": {
167
+ "schemaVersion": "iterate.provider/0.1",
168
+ "id": "iterate-report-render",
169
+ "kind": "report-render",
170
+ "version": "0.1.4",
171
+ "methods": [
172
+ {
173
+ "name": "render-markdown",
174
+ "requires": ["decision-log"]
175
+ },
176
+ {
177
+ "name": "render-html",
178
+ "requires": ["decision-log", "evidence-pack"]
179
+ }
180
+ ]
181
+ },
182
+ "expect": "accepted"
183
+ }
184
+ ],
185
+ "registry": {
186
+ "note": "The registry half of the contract is functions, and its cases are in kernel/test/provider-registration.test.mjs. What is pinned here is the two-harness shape: one registry per consumer, ids that must not silently mean different things, and a resolution that refuses rather than guessing.",
187
+ "glasspane": [
188
+ {
189
+ "schemaVersion": "iterate.provider/0.1",
190
+ "id": "glasspane-engine-ae",
191
+ "kind": "ae-diagnosis",
192
+ "version": "1.11.0",
193
+ "origin": "glasspane",
194
+ "methods": [
195
+ {
196
+ "name": "diagnose",
197
+ "requires": ["ax-event", "attribution", "circuit-breaker"]
198
+ }
199
+ ]
200
+ },
201
+ {
202
+ "schemaVersion": "iterate.provider/0.1",
203
+ "id": "glasspane-evidence",
204
+ "kind": "evidence-source",
205
+ "version": "1.11.0",
206
+ "origin": "glasspane",
207
+ "methods": [
208
+ {
209
+ "name": "capture",
210
+ "requires": ["ax-tree"]
211
+ },
212
+ {
213
+ "name": "last-evidence",
214
+ "requires": []
215
+ }
216
+ ]
217
+ }
218
+ ],
219
+ "iterate": [
220
+ {
221
+ "schemaVersion": "iterate.provider/0.1",
222
+ "id": "iterate-report-render",
223
+ "kind": "report-render",
224
+ "version": "0.1.4",
225
+ "origin": "iterate",
226
+ "methods": [
227
+ {
228
+ "name": "render-markdown",
229
+ "requires": ["decision-log"]
230
+ }
231
+ ]
232
+ },
233
+ {
234
+ "schemaVersion": "iterate.provider/0.1",
235
+ "id": "iterate-engine-ae",
236
+ "kind": "ae-diagnosis",
237
+ "version": "0.1.4",
238
+ "origin": "iterate",
239
+ "methods": [
240
+ {
241
+ "name": "diagnose",
242
+ "requires": ["evidence-pack"]
243
+ }
244
+ ]
245
+ }
246
+ ],
247
+ "idsInCommon": [],
248
+ "collision": {
249
+ "note": "What must be caught before a run: the same id offered by both sides. `glasspane-ae` means two different diagnoses here — one requiring the AX event stream, one requiring an evidence pack — so 'the AE provider' would name a different judgement in each product while both looked satisfied. `providerIdsInCommon` returns exactly the ids to settle, and the answer is a rename or one registry, never 'whichever map was consulted first'.",
250
+ "a": [
251
+ {
252
+ "schemaVersion": "iterate.provider/0.1",
253
+ "id": "glasspane-ae",
254
+ "kind": "ae-diagnosis",
255
+ "version": "1.11.0",
256
+ "origin": "glasspane",
257
+ "methods": [
258
+ {
259
+ "name": "diagnose",
260
+ "requires": ["ax-event"]
261
+ }
262
+ ]
263
+ },
264
+ {
265
+ "schemaVersion": "iterate.provider/0.1",
266
+ "id": "shared-render",
267
+ "kind": "report-render",
268
+ "version": "1.11.0",
269
+ "origin": "glasspane",
270
+ "methods": [
271
+ {
272
+ "name": "render-markdown",
273
+ "requires": []
274
+ }
275
+ ]
276
+ }
277
+ ],
278
+ "b": [
279
+ {
280
+ "schemaVersion": "iterate.provider/0.1",
281
+ "id": "glasspane-ae",
282
+ "kind": "ae-diagnosis",
283
+ "version": "0.1.4",
284
+ "origin": "iterate",
285
+ "methods": [
286
+ {
287
+ "name": "diagnose",
288
+ "requires": ["evidence-pack"]
289
+ }
290
+ ]
291
+ },
292
+ {
293
+ "schemaVersion": "iterate.provider/0.1",
294
+ "id": "shared-render",
295
+ "kind": "report-render",
296
+ "version": "0.1.4",
297
+ "origin": "iterate",
298
+ "methods": [
299
+ {
300
+ "name": "render-markdown",
301
+ "requires": []
302
+ }
303
+ ]
304
+ }
305
+ ],
306
+ "expect": ["glasspane-ae", "shared-render"]
307
+ }
308
+ }
309
+ }
@@ -1,5 +1,5 @@
1
1
  {
2
- "comment": "Cross-implementation anchor for the run-plan contract (kernel/src/run-plan.ts): what a plan is, and how to digest one so two shells and a ledger can say 'this run was held to this plan'. Rules a second implementation must reproduce, stated here so it need not read the TypeScript: (1) schemaVersion is exactly `iterate.run-plan/0.1`. (2) `dimensions` is 1..64 entries, each an object with a required `id` matching `^[a-z0-9]+(?:-[a-z0-9]+)*$` and at most 64 chars, and optional `label` (<=256) and `focus` (<=4096); no other keys. An empty plan is refused: a run with nothing to verify has a configuration problem, and reporting 0/0 dimensions as success is how that gets hidden. (3) Planned order is the caller's and is never sorted. (4) A repeated id is refused, not collapsed — the two entries can carry different focus, so collapsing picks one silently. JSON Schema cannot express id-level uniqueness (`uniqueItems` compares whole objects), so that rule lives on the validator side; the case named `duplicate-ids-differ-only-by-focus` below is the documented shape where the published schema accepts and the validator refuses. (5) `source`, when present, has a required `kind` in `config|recipe|session|manual` and an optional non-empty `name` <=512; nothing here reads a config file to invent a source. (6) The digest is `rp_` + sha256 of the canonical JSON form: UTF-16-code-unit-sorted keys, no insignificant whitespace, arrays in order, strings as JSON escapes them; numbers use the host's shortest roundtrip form, which is why none appear in this fixture — that concern is pinned by the canonical-JSON cases in the C35 suite instead. Provenance: the nine ids and both focus strings are taken verbatim from GlassPane's own iterate.config.yaml (`dimensions:` and `dimension_sets.engine|gui.focus`), because a vocabulary invented for a fixture would let both sides agree on something neither product uses.",
2
+ "comment": "Cross-implementation anchor for the run-plan contract (kernel/src/run-plan.ts): what a plan is, and how to digest one so two shells and a ledger can say 'this run was held to this plan'. Rules a second implementation must reproduce, stated here so it need not read the TypeScript: (1) schemaVersion is exactly `iterate.run-plan/0.1`. (2) `dimensions` is 1..64 entries, each an object with a required `id` matching `^[a-z0-9]+(?:-[a-z0-9]+)*$` and at most 64 chars, and optional `label` (<=256) and `focus` (<=4096); no other keys. An empty plan is refused: a run with nothing to verify has a configuration problem, and reporting 0/0 dimensions as success is how that gets hidden. (3) Planned order is the caller's and is never sorted. (4) A repeated id is refused, not collapsed — the two entries can carry different focus, so collapsing picks one silently. JSON Schema cannot express id-level uniqueness (`uniqueItems` compares whole objects), so that rule lives on the validator side; the case named `duplicate-ids-differ-only-by-focus` below is the documented shape where the published schema accepts and the validator refuses. (5) `source`, when present, has a required `kind` in `config|recipe|session|manual` and an optional non-empty `name` <=512; nothing here reads a config file to invent a source. (6) The digest is `rp_` + sha256 of the canonical JSON form: UTF-16-code-unit-sorted keys, no insignificant whitespace, arrays in order, strings as JSON escapes them; numbers use the host's shortest roundtrip form, which is why none appear in this fixture — that concern is pinned by the canonical-JSON cases in the C35 suite instead. Provenance: the nine ids and both focus strings are taken verbatim from GlassPane's own iterate.config.yaml (`dimensions:` and `dimension_sets.engine|gui.focus`), because a vocabulary invented for a fixture would let both sides agree on something neither product uses. The one `label` value is NOT from that config — it has no label vocabulary at all — and is written here to pin that a label is accepted, is optional, and is part of the digest; treat that string as fixture vocabulary, not as a name either product displays.",
3
3
  "input": {
4
4
  "schemaVersion": "iterate.run-plan/0.1",
5
5
  "dimensions": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "iterate-kernel",
3
- "version": "0.1.4",
3
+ "version": "0.1.5",
4
4
  "private": false,
5
5
  "description": "iterate ecosystem shared kernel: schemas, the evidence->decision transcription, the decision-log audit chain and public validators. Verification reasoning stays in the engine; this layer transcribes.",
6
6
  "type": "module",
@@ -14,6 +14,10 @@
14
14
  "types": "./dist/canonical-json.d.ts",
15
15
  "default": "./dist/canonical-json.js"
16
16
  },
17
+ "./convergence": {
18
+ "types": "./dist/convergence.d.ts",
19
+ "default": "./dist/convergence.js"
20
+ },
17
21
  "./decision-log": {
18
22
  "types": "./dist/decision-log.d.ts",
19
23
  "default": "./dist/decision-log.js"
@@ -42,10 +46,18 @@
42
46
  "types": "./dist/index.d.ts",
43
47
  "default": "./dist/index.js"
44
48
  },
49
+ "./invariant-report": {
50
+ "types": "./dist/invariant-report.d.ts",
51
+ "default": "./dist/invariant-report.js"
52
+ },
45
53
  "./parse": {
46
54
  "types": "./dist/parse.d.ts",
47
55
  "default": "./dist/parse.js"
48
56
  },
57
+ "./provider-registration": {
58
+ "types": "./dist/provider-registration.d.ts",
59
+ "default": "./dist/provider-registration.js"
60
+ },
49
61
  "./recipe-config": {
50
62
  "types": "./dist/recipe-config.d.ts",
51
63
  "default": "./dist/recipe-config.js"