feat(pbs): add mutable lists and stable snapshot cursors

Implement SDK list<T> and Cursor<T> with trusted compiler bindings and generic storage publication across IR and PBX. Pin the runtime provider and include specs, conformance coverage, installed examples, and DSC-0090 lessons.
This commit is contained in:
2026-10-23 00:46:39 +01:00
parent 76a8b074e8
commit c410e35001
46 changed files with 2683 additions and 165 deletions
@@ -0,0 +1,234 @@
---
id: LSN-0090
ticket: pbs-sdk-list
title: Mutable Lists and Stable Snapshot Cursors
created: 2026-10-22
tags: [compiler-pbs, collections, snapshot-cursor, atomic-publication, runtime-conformance]
---
## Original problem and final result
Owner: `compiler/pbs`. Transversal owners: `compiler/general` for neutral IR/PBX
and the runtime provider for storage, faults, ownership and resource accounting.
DSC-0090 implemented accepted DEC-0075 through PLN-0153, covering R1–R14.
The workflow control artifacts are disposable; the
[List/Cursor specification](../../../docs/compiler/pbs/specs/sdk-list-and-cursor.md)
is the durable normative reference.
PBS needed a resizable collection whose existing references remain valid, together
with a traversal that survives later collection edits. Both now live in the
executable SDK: ordinary generic `list<T>`, the shared `Cursor<T>` contract and
private snapshot nodes. The compiler provides trusted private bindings and source
projections; generic storage instructions support complete publication in the VM.
Linked, Set and Map remain separate discussions.
## Separate collection identity, logical positions and physical storage
A List is a shared object containing a private fixed-length array and logical size.
Growth replaces the backing reference inside that same object. Existing aliases
therefore continue to observe the collection after growth, reserve or trim.
Size includes holes. Capacity alone does not create valid positions. For example,
`new list<int>(16)` has size zero; `resize(3)` creates three valid empty positions.
Writing position zero then stores a present value without changing size. Zero and
false remain present values. `clearAt` leaves a hole, while `removeAt` removes a
position and shifts the complete suffix, including its holes.
The complete API includes constructors, size/capacity, bracket access, add, insert,
clearAt, removeAt, clear, resize, reserve, trim and cursor. The
[specification](../../../docs/compiler/pbs/specs/sdk-list-and-cursor.md) defines
their exact results, geometric growth, structural limits and fault classifications.
Clear, shrink and removal erase discarded references; later growth cannot resurrect
old values. Directly optional elements are rejected, including through grouping;
an optional List remains valid. Applications are invariant, and argument values
do not infer the element type.
## A snapshot freezes the sequence of references
List capture scans its logical positions backwards and prepends one node per
present occurrence. The resulting chain visits increasing source indices, skips
holes and preserves duplicates. Nodes are private, immutable, singly linked and
non-circular. Capture finishes before the Cursor is returned. There is no second
array, source-slot alias or source collection reference needed for traversal.
Replacing, inserting, removing, clearing or resizing the List cannot change this
captured sequence. A captured object reference still identifies the same object,
so later mutations of its fields remain visible. This distinction lets gameplay
change its collections while a consumer walks a stable sequence.
The private cursor object stores its current-node reference. It can replace that
root as it advances without changing any node link. Once other owners and call
frames release consumed nodes, the prefix becomes collectible. The current node
retains the remaining suffix.
### Successor-based hasNext and a retained last element
`current()` initially reports the first element. `hasNext()` asks whether that
element has a successor. `next()` follows an existing successor and otherwise
does nothing.
| Snapshot/state | hasNext() | current() |
| --- | --- | --- |
| Empty, initially or after repeated next | false | none |
| [A], initially or after repeated next | false | some(A) |
| [A, B], initially | true | some(A) |
| [A, B], after one or any further next | false | some(B) |
Process current, then either advance or stop. A hasNext-only loop omits the last
element. A loop waiting for current to become none never finishes a nonempty
snapshot. The
[distributed example](../../../prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/collections.pbs)
captures 20 and 22 around a hole, clears the List, visits both captured values and
returns 42. Current still contains 22 afterwards.
The outer optional describes whether a node exists. A producer with optional T
must preserve `some(none)` as a present node whose payload is none. A synthetic
non-List producer qualifies that distinction independently of List's element rule.
Future Linked/Set producers use Cursor<T>; Map entries use Cursor<keyval<K,V>>.
Their construction rules and ordering guarantees belong to their own discussions.
## Prepare the whole mutation before publishing
An insert without growth can shift many slots and update size. A remove also
prepares an optional result and clears its old tail. Each operation needs a single
failure boundary for all observable changes.
The generic provider adds four operations, carried through common IR and PBX:
| Operation | Purpose |
| --- | --- |
| INDEX_GUARD | Check a signed-long logical index against an exclusive limit |
| ARRAY_CHECK_LENGTH | Validate a structural length without allocating |
| ARRAY_COPY | Transfer complete stored groups with overlap-safe prestate semantics |
| STORAGE_PUBLISH | Prepare and commit source-selected copy/fill ranges and two typed fields |
The SDK chooses its indices, ranges, fill value, target backing and resulting size.
The generic layer validates those operands and resource charges. It snapshots
complete source groups into charged scratch before any write, then commits the
selected copy, fill and field updates without allocation, callbacks, scheduler or
GC interleaving. Its four immediate operands identify the Array/Struct types and
two distinct fields. There is no exported preparation token or general transaction
syntax.
For growth, a private candidate array is allocated and populated first. For a
no-growth edit, scratch and all argument/result carriers are prepared first.
`removeAt` obtains its previous optional value before publication. Raw transfer
keeps presence tags, full value groups and existing reference/carrier identity.
Per-element public optional unpack/repack would add failure points and allocation
costs while shifting.
Refusal leaves backing identity, capacity, size and complete stored groups
unchanged. Argument effects evaluated before the call remain ordinary source
effects. Unpublished candidates and scratch follow normal ownership and budgets.
The provider has no List/Cursor opcode, category or syscall; collection algorithms
remain in
[SDK source](../../../prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/main.pbs).
## Compiler and tooling integration
Reserved SDK attributes carry trusted definition origin. Copying their names into
a project cannot grant private primitive access, and a user struct named list does
not acquire SDK indexing or constructor rules. The public barrel exports List and
Cursor; backing fields, storage bindings, nodes and bracket adapters stay private.
SDK executable functions and implementations use the ordinary generic pipeline.
Supporting them exposed reusable shape requirements: optional recursive payload
members, concrete contract methods, applicable implementations and native group
field maps must survive specialization. Complete values include vec2, pixel,
tuples, nested arrays, contracts and function references.
List index/length arguments accept localized lossless int-to-long promotion.
Receiver and arguments execute once in source order, including named arguments.
General numeric conversion rules stay unchanged. Common aggregation, optimization,
emission and preload verification retain all four publication operands; malformed
types or fields are rejected even in unreachable instructions.
Editor projections show concrete public List/Cursor methods, optional results,
constructor overloads and SDK definitions. Hover/completion hide private adapters
and backing fields. Installed JAR tests load the actual packaged SDK, normative
spec and example outside the checkout, generate PBX and execute it in the provider.
## Evidence and practical limits
The selected provider is clean commit
`d9b9eeb171d2861ec660d4cf5703b0795eac49a9`. Studio changes were tested over base
`76a8b074e89e17c7425220888eeec38427261d46`. Qualification used macOS 27.0.1 arm64,
Rust 1.98.1/LLVM 22.1.8, the dev runtime profile with resource-diagnostics,
capabilities NONE, Gradle 9.3.1 and the repository's Java 21 toolchain
(Corretto 21.0.4). Ordinary and optimized producer paths were exercised.
| Gate | Observed result |
| --- | --- |
| Provider bytecode and VM libraries | 6 + 302 passed; 2 existing measurement tests ignored |
| Full Studio regression and installed knowledge | Passed; existing skipped tests retained |
| Final frontend/editor, LSP, source generation and installed checks | Passed; both installed tests passed |
| PBS List/Cursor through production verifier/VM | 27 cases in each producer mode: 54 passed |
| Non-PBS common IR | 2 storage fixtures executed through production VM |
| Whole-operation quota refusals | 71 attempts; independently observed prior List state preserved |
| Cursor GC | Nodes/items: 1200/1200 → 1/1 → 1/1 → 0/0 |
| Reexports and installed example execution | Both passed; final captured value 22 retained |
| Provider catalogs and canonical mirrors | Clean pinned provider; catalog parity and all four mirrors match |
The refusal matrix lowers GuestBytes, HandleSlots, AuxiliaryBytes and TemporaryBytes
around candidate allocation, no-growth publication scratch, optional return
preparation, node creation and frame/operand preparation. It compares the typed
List fields and every backing group before and after each refusal, and verifies
resource accounting returns to zero after VM drop. Generic provider tests also
cover overlapping multi-slot transfers, late invalid fields/ranges, immutable
Dynamic-box identity and malformed encodings.
Controlled normal GC safepoints prove consumed-prefix reclamation, retention of
the final value 1199 despite repeated next calls, and release after dropping the
Cursor. No source or snapshot Array remains live for that payload type at those
safepoints. Optional carriers and other legitimate owners still have their normal
allocation and retention costs. Capturing n positions with k present values takes
O(n) time and O(k) additional nodes; next follows one link in O(1).
[Machine-readable evidence](runtime-conformance-evidence.json) records commands,
source and PBX hashes, default ceilings, every lowered refusal quota, GC observations
and tested provenance. New cases are mandatory; missing fixtures fail the harness.
The full harness also reports two pre-existing response-schema gaps, LifecycleRole
and NonFiniteValue, with original payloads preserved. These were not changed by
this delivery. Qualification makes no release-profile or cross-platform claim.
R1–R5 are covered by type/construction/bounds/mutation/capacity fixtures; R6–R9 by
snapshot states, identity, non-List optional production and GC; R10–R11 by direct
provider tests, common IR and the refusal matrix; R12 by editor/import/distribution
gates; R13 by resource accounting and retention observations; R14 by the mandatory
production corpus, full regressions and pinned provenance.
## Pitfalls to preserve in future work
- Treat logical size and capacity separately. An index inside physical capacity
can still require TRAP_OOB; a hole is an optional result only at a valid index.
- Keep faults distinct from absence. Long overflow, invalid bounds and resource
refusal cannot become none or a truncated index.
- Prepare optional returns and temporary groups before publication. Individual
Array instruction atomicity alone cannot prove whole-mutator atomicity.
- Preserve complete stored groups while shifting. Public optional reboxing can
change identity, roots, costs and refusal boundaries.
- Follow the Cursor state table. Never advance a nonempty cursor past its last
node or retain an initial-head root just to support an unrequested reset.
- Account for node and optional-carrier allocation. A linked snapshot has no
promise of lower memory use than an array or immediate quota recovery.
- Carry all publication operands through linking and optimization. A lost second
field identity can invalidate otherwise well-typed SDK calls after imports.
- Keep privileged bindings origin-based and private. Names and copied attributes
are insufficient authority.
## References and reproduction
- [List/Cursor specification](../../../docs/compiler/pbs/specs/sdk-list-and-cursor.md)
and [Array/optional foundation](../../../docs/compiler/pbs/specs/typed-arrays-and-optional-execution.md).
- [Common Registry/PBX specification](../../../docs/compiler/general/specs/typed-registry-and-pbx-v0.md)
and [canonical provider publication code](../../../../runtime/crates/console/prometeu-vm/src/virtual_machine/storage_publication.rs).
- [Source fixture generator](../../../prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsListCursorTest.java),
[neutral IR fixtures](../../../prometeu-compiler/prometeu-build-pipeline/src/test/java/p/studio/compiler/backend/registry/StoragePublicationPipelineTest.java)
and [production harness instructions](../../../tools/pbx-conformance/README.md).
- [Generic structs lesson](../DSC-0094-pbs-generic-structs/LSN-0089-concrete-generic-state-and-bodies.md)
and [generic contracts lesson](../DSC-0089-pbs-generic-contracts/LSN-0088-concrete-generic-contracts-from-source-to-vm.md).
Run `./gradlew test :prometeu-app:installedKnowledgeTest --console=plain` before
`python3 tools/pbx-conformance/run.py --runtime ../runtime` so the complete fixture
corpus, including the installed example, exists. Provider and catalog commands,
their working directories and the tested configuration are in the evidence file.
@@ -0,0 +1,699 @@
{
"schema_version": 1,
"discussion": "DSC-0090",
"historical_decision": "DEC-0075",
"historical_plan": "PLN-0153",
"owner": "compiler/pbs",
"date": "2026-10-22",
"provenance": {
"studio_base": "76a8b074e89e17c7425220888eeec38427261d46",
"studio_changes": "uncommitted implementation",
"runtime": "d9b9eeb171d2861ec660d4cf5703b0795eac49a9",
"runtime_working_tree": "clean",
"platform": "macOS-27.0.1-arm64-arm-64bit-Mach-O",
"java": "Corretto 21.0.4+7-LTS; repository Java toolchain 21",
"gradle": "9.3.1",
"rustc": "1.98.1 (48a229cea 2026-09-01)",
"rust_host": "aarch64-apple-darwin",
"llvm": "22.1.8",
"runtime_profile": "dev",
"features": [
"resource-diagnostics"
],
"capabilities": "NONE",
"producer_modes": [
"ordinary",
"optimized"
]
},
"default_vm_limits": {
"GuestBytes": 268435456,
"HandleSlots": 1048576,
"AuxiliaryBytes": 67108864,
"TemporaryBytes": 67108864,
"StringBytes": 67108864,
"StringAllocations": 262144,
"IndividualStringBytes": 4194304,
"CallDepth": 1024
},
"source_sha256": {
"tools/pbx-conformance/run.py": "9acf64b74241f65fa09ab33fcb7d0daf57b56142d2874d87812d7b9948fe94ef",
"tools/pbx-conformance/main.rs": "c24ade424adfe9edd7168814aabdfc869272c7bcfb816f5e4945b771cca96efd",
"prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsRuntimeRandomTest.java": "ba0b3de2e0aa7177fa71b5a837a56bc262a080717df3276c3a73b67b33dcb384",
"prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/random/main.pbs": "c21c12d99c5a033a1e4026432bbab56393ad09c0fe2d36711504ccca01ce93b5",
"prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsListCursorTest.java": "e9a7b24ca82a00339c0b0c96a53660ef4dcf69a52587a7c9e56f5f28b5c0b94a",
"prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/main.pbs": "fd3fb817a55e25553d4f7bbe8cbad5f306f22fd0a8e0bb6f8bf05bc43bc0794b",
"../runtime/crates/console/prometeu-vm/src/virtual_machine/storage_publication.rs": "6d63bb474d7659a1e256e242fb2f3c9655d80173d51a263bad56b30cae3088b6",
"../runtime/Cargo.lock": "cffad9ed62f38a591538abd81dd39270d6022397342c8189f4ac6c7baaa8e795",
"../runtime/docs/vm-arch/INTRINSICS.csv": "0c1bb78a9b81d1e3480ef5713f3d70f0b06772a7dfab2fd00c1f0a6364f98daa",
"../runtime/docs/vm-arch/BUILTIN_CONSTANTS.csv": "e407e4718127aa7ef7b1097b5b4b67d86dd979235e73a551a7c36b628cddc039",
"../runtime/crates/console/prometeu-vm/tests/fixtures/numeric-conformance.tsv": "5536ee18cadaf32e3719b0e8d541dfcf1a84a49ea978a702101547c5ccdee3fe",
"../runtime/crates/console/prometeu-vm/tests/fixtures/random-conformance.tsv": "0bee1cd0366f1716687aee8c7ac39dd495da5fe2908cce37b1443cb04fac542f"
},
"pbx_sha256": {
"common-storage-optimized.pbx": "2820aa4ab46544e719e73dfce7e2c03b36377399e5f12e44f32d1f3020bbd087",
"common-storage.pbx": "2820aa4ab46544e719e73dfce7e2c03b36377399e5f12e44f32d1f3020bbd087",
"pbs-list-basic-optimized.pbx": "700dd48e3ceb84ad5f3e3f793fc0d2c6057ce1e87e0fdbadf408f82cf637f5fd",
"pbs-list-basic.pbx": "0669143076d8b4e4610c9699b371de539ccd3aedf0a6f2d5dc46cc78f23dd148",
"pbs-list-capacity-optimized.pbx": "a75c1ff31ef7527e1097e5da3e33747834ca0bc278f843edde32193aeb489fcc",
"pbs-list-capacity.pbx": "35d68be7ffefc4dd930351efd083e78f34af1603e16c85eab96f4611fc8e2415",
"pbs-list-construction-optimized.pbx": "21ab588682a00856461f2758cd3135f444fb9477d5dd70f6e48c001f7d54fe36",
"pbs-list-construction.pbx": "b10de1f77f47758ca5a1eb7167e0c5241683a660073ae1241063a40b35098100",
"pbs-list-contract-optimized.pbx": "5c5737ad4d3db9306415d2e9d389ceff8bef752b9beef2d57b15ee368c029eb9",
"pbs-list-contract.pbx": "3c3250138ecaa1235f2bf1351e90a988e440dd34118cc22b1d26ab58c91189b7",
"pbs-list-cursor-empty-optimized.pbx": "8741c4ec6a1736a2521fa414def12684af881561c829f88a96dcf1f24b961451",
"pbs-list-cursor-empty.pbx": "c65d444082b8ceebfc9ec266811833c4dc40260ed47bc85cd0d9851d5be31cd1",
"pbs-list-cursor-many-optimized.pbx": "7f5fa28ad380321f459df27606bc59d7e6d8b0bda7be4acc4305c859ca2af740",
"pbs-list-cursor-many.pbx": "3ef35e99df5800fb5368f198a91350ffbb561d46af465db5a19ba986452693e3",
"pbs-list-cursor-single-optimized.pbx": "8a19dd496746df5aea0208e983bc50bbdbd4596cea1cc79fed2f94b12e62c939",
"pbs-list-cursor-single.pbx": "8ff5fe78d78915e51ad7dce6c1af354b4efc5c4729c9655da2172f0595fbd66a",
"pbs-list-evaluation-optimized.pbx": "6e5e5a7e3085ea2eefa5f7e0ff296444eb633072fa8b301224737390d55965d3",
"pbs-list-evaluation.pbx": "06f2de5f371973b93ee07577224670a2c02d15899b7dbd791be9733a67a5fb2b",
"pbs-list-false-present-optimized.pbx": "48460d05c9dc22c8c3cd7ac87d429ff0e5ecffc17b2ca254196598e965248816",
"pbs-list-false-present.pbx": "be70e9a6e741541f68c0180760bfd73ef81c54175c359f2208b512c4f3656816",
"pbs-list-fault-constructor-optimized.pbx": "676d4c73965dbf4976de01655c4e0f97601dc1cdc01d312957e5be9d4d5135fd",
"pbs-list-fault-constructor.pbx": "89cfeced7967ea96280874591e640eb88c255f88016f16cd69a9b2ed1330e02f",
"pbs-list-fault-insert-optimized.pbx": "1c3ade1229ec4ed3095feaf961ad9a1dcedf9d6e2bca2f217187ca1a06be1668",
"pbs-list-fault-insert.pbx": "fc92df90d591665f12dafa4ae937b44adb62dd7b308dd38d30b4ea30459f4f5f",
"pbs-list-fault-length-optimized.pbx": "c114f0f0bae45d1cc6625319af8c79b158f8e4680448a7343f8899f1ae9e1153",
"pbs-list-fault-length.pbx": "fc06adc9a6b67f25644042147f1f7475d9ac9d25b856b1f0ed3d40e3b9e46482",
"pbs-list-fault-long-index-optimized.pbx": "b098baa781990fa70baf0d6d4671eb5e24978b4491f6317c9f2466f7535447eb",
"pbs-list-fault-long-index.pbx": "10ac9074183cf09ef3e2bff8396bd6451b976a80f3b05458804c20169e353a15",
"pbs-list-fault-negative-optimized.pbx": "1f42b229ed6d8118d61767494bc0e132d2a6e63485642ef6f4d218638c676964",
"pbs-list-fault-negative.pbx": "0614c7b5dc4d5b4d799c179974e9e614dbc1fbdefba688c0acc0c43984090112",
"pbs-list-fault-overflow-optimized.pbx": "c8f9f03f0d4c2d67acff1f094dcce96c129ce9e1abd3b9be04240f780ebe6e46",
"pbs-list-fault-overflow.pbx": "3b66b7da63516af9981e3722997aa477bd0736a882eb0fce1c189bf040cf8554",
"pbs-list-fault-read-optimized.pbx": "208f256e6c97753611edd7d222923a2b1a855c7ff1a7c872d1bc3bb9c1dfe72b",
"pbs-list-fault-read.pbx": "acf039804bc732dc642fea696429bee398c2e6b6b6975e03dc2b2b24e1048c19",
"pbs-list-fault-write-optimized.pbx": "35051291b52de2109e5f7f7d4bd0a8a218fefc31cb167fdda173871cd531be2f",
"pbs-list-fault-write.pbx": "bcd721c64efe44f073ee660daebff72dca8ac9c2f8619be04d018ead799795ca",
"pbs-list-function-optimized.pbx": "1002a115aebb3a7433f3978cbaa300fcadf26ad837da6272fd34260e2a9b7dad",
"pbs-list-function.pbx": "1a047759799eff2982e8212a86d7d5237e8584e74cacff8301c29c4ff2c16b7c",
"pbs-list-gc.pbx": "265bf39e53bd3e521166dc1ac14c99920d83726ebac8a0e0a3a339d49d19bb29",
"pbs-list-holes-optimized.pbx": "ad331fd7f9298eadea06dbc55587d48a964f8b746406b316c108819186633d30",
"pbs-list-holes.pbx": "c8263fb24fa8df2b98d7cb405733329281f386946c9c6ad186b01051fa25752c",
"pbs-list-identity-optimized.pbx": "f8c572e91351cc8ff4901cc6e972bc05ea0e2e696a550526dc8c511919b438a9",
"pbs-list-identity.pbx": "0e20e6c0a1c9d754a3cd9421155debb231b0dbd93d0935cc3e59b1f70dc21eca",
"pbs-list-imports.pbx": "2364fde21bb3db0a86717f904103d5df657248e2b7979d0e17d2fe9c27ea7e1e",
"pbs-list-installed.pbx": "83748e5203837069363e4d01b0c26e6423d7978f18ee5f6438dcf6336faeef0f",
"pbs-list-nested-array-optimized.pbx": "c6d5d630c620589cf72bdad3f4226748c60a64f14d0965d5ee1aa22e89d79e17",
"pbs-list-nested-array.pbx": "7e3b07300b6f03eeba738dec95001b6d9ab583f58c268dddfdf0b876605999db",
"pbs-list-pixel-optimized.pbx": "ba46dd0ed8efacbbae0015cdfdc0cfa1567684df6681ed836f3ef15a5f828e82",
"pbs-list-pixel.pbx": "36ceaa3115e9439ff21550637f62631dbae39ff06c553f459d58fd91e69cea24",
"pbs-list-refusal-cursor.pbx": "0734d3608ff52a2cd9754b319c6d8a471429571e4336b9f2ae0cff729177042b",
"pbs-list-refusal-growth.pbx": "2c453f52469127cc71818c69d7e3b3dd1add99f524f791ed46fb0c507da2f392",
"pbs-list-refusal-insert.pbx": "6786c290f3ed924c6cfc1666afb3624385ca75cf44b397a05071388f951ccb80",
"pbs-list-refusal-remove.pbx": "d7f0460f35a716bd0ef6dca47816d5f76bf8b1a9b32d9e3620479d5e2ace0888",
"pbs-list-shared-optional-optimized.pbx": "bb71e6ffcae4da82bada01aeda5a8941361417c2eb97186b416715b8087d5ab2",
"pbs-list-shared-optional.pbx": "98d12e6ab4eaefdab0c825fc063300feaf74839ad3d695b97187d4b6a510a557",
"pbs-list-snapshot-optimized.pbx": "d673a2bbbcbc1de9c343f295fa15cf0a7e68aa2f694474842116fda3f1ec1787",
"pbs-list-snapshot.pbx": "11c9dbbdc3ad403c55875e28054343b5275a1467a721ccf8fe1265204858d39e",
"pbs-list-structural-growth-optimized.pbx": "d7ef11a773ac5ff179297b5ea89d1e4e7c7abfb9e5ab16d5bdb6860e28550ef9",
"pbs-list-structural-growth.pbx": "a35fa7776ce571ceb8c6e77cbc3bcdac98851396eeb581e2445b4a774591d8a3",
"pbs-list-tuple-optimized.pbx": "84f12aeb2e7686b91cbcbf4f64e584857184fe0f98bcddb72b6637c8f3cfe8bc",
"pbs-list-tuple.pbx": "43d948da3e128f4eaeda52e64cf04c1e3f90df6205c17f847f55365729da1997",
"pbs-list-vec2-optimized.pbx": "a2850a8204adaafc9f2bd0d84e01b53ed0898d7d0a5044f5ea716aa2d4429383",
"pbs-list-vec2.pbx": "5d31b5f46c75992bcd798363def57509b1600e14e3432316196e000f371d77de"
},
"full_production_log_sha256": "f9a92347e491173ed11398257aac8cadd098ba9af175958ae920f4ed5339c051",
"source_execution_passes": [
"basic",
"basic-optimized",
"construction",
"construction-optimized",
"capacity",
"capacity-optimized",
"holes",
"holes-optimized",
"structural-growth",
"structural-growth-optimized",
"cursor-empty",
"cursor-empty-optimized",
"cursor-single",
"cursor-single-optimized",
"cursor-many",
"cursor-many-optimized",
"snapshot",
"snapshot-optimized",
"false-present",
"false-present-optimized",
"shared-optional",
"shared-optional-optimized",
"identity",
"identity-optimized",
"tuple",
"tuple-optimized",
"nested-array",
"nested-array-optimized",
"function",
"function-optimized",
"evaluation",
"evaluation-optimized",
"vec2",
"vec2-optimized",
"pixel",
"pixel-optimized",
"contract",
"contract-optimized",
"fault-read",
"fault-read-optimized",
"fault-write",
"fault-write-optimized",
"fault-negative",
"fault-negative-optimized",
"fault-insert",
"fault-insert-optimized",
"fault-length",
"fault-length-optimized",
"fault-overflow",
"fault-overflow-optimized",
"fault-long-index",
"fault-long-index-optimized",
"fault-constructor",
"fault-constructor-optimized"
],
"common_ir_execution_passes": [
"common-storage",
"common-storage-optimized"
],
"distribution_execution_passes": [
"imports",
"installed"
],
"atomic_refusals": [
{
"operation": "insert",
"resource": "GuestBytes",
"limit": 9736,
"opcode": "StructNew"
},
{
"operation": "insert",
"resource": "GuestBytes",
"limit": 9887,
"opcode": "StructNew"
},
{
"operation": "insert",
"resource": "GuestBytes",
"limit": 10038,
"opcode": "StructNew"
},
{
"operation": "insert",
"resource": "GuestBytes",
"limit": 10339,
"opcode": "StructNew"
},
{
"operation": "insert",
"resource": "HandleSlots",
"limit": 5,
"opcode": "StructNew"
},
{
"operation": "insert",
"resource": "HandleSlots",
"limit": 6,
"opcode": "StructNew"
},
{
"operation": "insert",
"resource": "AuxiliaryBytes",
"limit": 1408,
"opcode": "Call"
},
{
"operation": "insert",
"resource": "AuxiliaryBytes",
"limit": 1640,
"opcode": "GetLocal"
},
{
"operation": "insert",
"resource": "TemporaryBytes",
"limit": 504,
"opcode": "StructNew"
},
{
"operation": "insert",
"resource": "TemporaryBytes",
"limit": 2698,
"opcode": "StoragePublish"
},
{
"operation": "insert",
"resource": "TemporaryBytes",
"limit": 4892,
"opcode": "StoragePublish"
},
{
"operation": "insert",
"resource": "TemporaryBytes",
"limit": 9279,
"opcode": "StoragePublish"
},
{
"operation": "remove",
"resource": "GuestBytes",
"limit": 9736,
"opcode": "StructNew"
},
{
"operation": "remove",
"resource": "GuestBytes",
"limit": 10127,
"opcode": "StructNew"
},
{
"operation": "remove",
"resource": "GuestBytes",
"limit": 10518,
"opcode": "StructNew"
},
{
"operation": "remove",
"resource": "GuestBytes",
"limit": 11299,
"opcode": "StructNew"
},
{
"operation": "remove",
"resource": "HandleSlots",
"limit": 5,
"opcode": "StructNew"
},
{
"operation": "remove",
"resource": "HandleSlots",
"limit": 6,
"opcode": "StructNew"
},
{
"operation": "remove",
"resource": "HandleSlots",
"limit": 7,
"opcode": "StructNew"
},
{
"operation": "remove",
"resource": "HandleSlots",
"limit": 8,
"opcode": "StructNew"
},
{
"operation": "remove",
"resource": "HandleSlots",
"limit": 9,
"opcode": "StructNew"
},
{
"operation": "remove",
"resource": "AuxiliaryBytes",
"limit": 1408,
"opcode": "Call"
},
{
"operation": "remove",
"resource": "AuxiliaryBytes",
"limit": 1760,
"opcode": "StructNew"
},
{
"operation": "remove",
"resource": "AuxiliaryBytes",
"limit": 2112,
"opcode": "GetLocal"
},
{
"operation": "remove",
"resource": "TemporaryBytes",
"limit": 504,
"opcode": "GetLocal"
},
{
"operation": "remove",
"resource": "TemporaryBytes",
"limit": 2678,
"opcode": "StoragePublish"
},
{
"operation": "remove",
"resource": "TemporaryBytes",
"limit": 4852,
"opcode": "StoragePublish"
},
{
"operation": "remove",
"resource": "TemporaryBytes",
"limit": 9199,
"opcode": "StoragePublish"
},
{
"operation": "growth",
"resource": "GuestBytes",
"limit": 5640,
"opcode": "ArrayNew"
},
{
"operation": "growth",
"resource": "GuestBytes",
"limit": 7401,
"opcode": "ArrayNew"
},
{
"operation": "growth",
"resource": "GuestBytes",
"limit": 9162,
"opcode": "ArrayNew"
},
{
"operation": "growth",
"resource": "GuestBytes",
"limit": 12683,
"opcode": "StructNew"
},
{
"operation": "growth",
"resource": "HandleSlots",
"limit": 5,
"opcode": "ArrayNew"
},
{
"operation": "growth",
"resource": "HandleSlots",
"limit": 6,
"opcode": "StructNew"
},
{
"operation": "growth",
"resource": "HandleSlots",
"limit": 7,
"opcode": "StructNew"
},
{
"operation": "growth",
"resource": "AuxiliaryBytes",
"limit": 1408,
"opcode": "Call"
},
{
"operation": "growth",
"resource": "AuxiliaryBytes",
"limit": 1640,
"opcode": "GetLocal"
},
{
"operation": "growth",
"resource": "TemporaryBytes",
"limit": 504,
"opcode": "ArrayCopy"
},
{
"operation": "growth",
"resource": "TemporaryBytes",
"limit": 2938,
"opcode": "ArrayCopy"
},
{
"operation": "growth",
"resource": "TemporaryBytes",
"limit": 5372,
"opcode": "ArrayCopy"
},
{
"operation": "growth",
"resource": "TemporaryBytes",
"limit": 10239,
"opcode": "ArrayCopy"
},
{
"operation": "cursor",
"resource": "GuestBytes",
"limit": 9736,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "GuestBytes",
"limit": 59424,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "GuestBytes",
"limit": 109112,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "GuestBytes",
"limit": 208487,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 5,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 6,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 7,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 8,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 9,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 10,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 11,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 12,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 13,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 14,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 15,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 16,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 17,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 18,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 19,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 20,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 165,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 326,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "HandleSlots",
"limit": 646,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "AuxiliaryBytes",
"limit": 1408,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "AuxiliaryBytes",
"limit": 16648,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "AuxiliaryBytes",
"limit": 31888,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "TemporaryBytes",
"limit": 504,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "TemporaryBytes",
"limit": 8058,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "TemporaryBytes",
"limit": 15612,
"opcode": "StructNew"
},
{
"operation": "cursor",
"resource": "TemporaryBytes",
"limit": 30719,
"opcode": "StructNew"
}
],
"refusal_observation": "Independent typed List fields, backing identity, capacity and all stored groups before/after each refusal; all resource usage zero after VM drop.",
"gc_safepoints": [
{
"round": 0,
"nodes": 1200,
"items": 1200,
"collected": 6003
},
{
"round": 1,
"nodes": 1,
"items": 1,
"collected": 13197
},
{
"round": 2,
"nodes": 1,
"items": 1,
"collected": 15597
},
{
"round": 3,
"nodes": 0,
"items": 0,
"collected": 16803
}
],
"gc_assertions": [
"Consumed prefix reclaimable",
"Final current value 1199 retained after repeated next",
"No source or snapshot Array remains live for Item payload",
"Last node/item released after dropping Cursor"
],
"gates": [
{
"command": "cargo test -p prometeu-bytecode -p prometeu-vm --lib --features prometeu-vm/resource-diagnostics --locked --offline",
"result": "passed",
"working_directory": "../runtime",
"passed": 308,
"ignored": 2,
"environment": {
"CARGO_TARGET_DIR": "/tmp/pln153-provider-final-target"
}
},
{
"command": "./gradlew -q test :prometeu-app:installedKnowledgeTest --console=plain",
"result": "passed",
"notes": "Full repository regression and installed gate; 13 existing skipped tests. Subsequent UI projection and positive construction additions also passed the focused gates below."
},
{
"command": "./gradlew -q :prometeu-compiler:frontends:prometeu-frontend-pbs:test :prometeu-lsp:prometeu-lsp-v1:test --console=plain",
"result": "passed",
"notes": "Final frontend/editor and LSP regression."
},
{
"command": "./gradlew -q :prometeu-architecture-tests:test --tests '*PbsListCursorTest' :prometeu-app:installedKnowledgeTest --console=plain",
"result": "passed",
"notes": "Final source corpus generation and both installed-knowledge tests."
},
{
"command": "python3 tools/pbx-conformance/run.py --runtime ../runtime",
"result": "passed",
"exit_code": 0,
"environment": {
"CARGO_TARGET_DIR": "/tmp/pln153-conformance-target"
},
"notes": "Full mandatory harness, including existing suites, with the final generated and installed List corpus."
},
{
"command": "python3 tools/runtime-catalog/verify.py --runtime ../runtime",
"result": "passed",
"notes": "Clean committed provider; both catalog hashes and actual provider exporter parity match."
}
],
"limitations": [
"Qualification applies to the recorded macOS/arm64 dev runtime profile; no release or cross-platform claim.",
"Two pre-existing full-harness response-schema gaps, LifecycleRole and NonFiniteValue, remain reported with original payloads; no new List/Cursor case is skipped.",
"Quota matrix intentionally lowers only GuestBytes, HandleSlots, AuxiliaryBytes and TemporaryBytes at each recorded limit; other resource ceilings are unchanged."
],
"workflow_cli_gap": "No create-lesson/next-id command. LSN-0090 was read from the framework model without mutation; discussion housekeep registers the lesson and updates the index/counter.",
"workflow_completion": {
"discussion_status": "done",
"plan_status_before_housekeeping": "done",
"lesson": "LSN-0090",
"housekeeping": "discussion housekeep DSC-0090 --lesson discussion/lessons/DSC-0090-pbs-sdk-list/LSN-0090-mutable-lists-and-stable-snapshot-cursors.md",
"removed_control_artifacts": 3,
"validation_after_housekeeping": "passed"
}
}