feat(pbs): add Map and read-only Keyval associations
Test / Tests and coverage
Intrepid/Prometeu/Studio/pipeline/pr-master This commit looks good

This commit is contained in:
2026-10-26 20:37:06 +00:00
parent 8105604f92
commit 01a1968689
41 changed files with 4072 additions and 42 deletions
@@ -0,0 +1,194 @@
---
id: LSN-0094
ticket: pbs-sdk-map-keyval
title: Map presence, key identity and captured associations
created: 2026-10-26
tags: [compiler-pbs, collections, map, keyval, identity, optional, cursor]
---
# Map presence, key identity and captured associations
**Worker:** Lesson Worker. **Owner domain:** `compiler/pbs`.
**Discussion:** DSC-0093, accepted DEC-0079 implemented by PLN-0157 (R1–R12).
The normative contract is [SDK Map and Keyval](../../../docs/compiler/pbs/specs/sdk-map-and-keyval.md).
The [evidence record](evidence/README.md) preserves reproduction commands, source
and fixture fingerprints, raw logs and requirement coverage after housekeeping.
## Original problem
Map needed to distinguish association existence from the content of its value,
define which object represents an equivalent key, and transport read-only entries
without exposing mutable hash storage. Set had already delivered reusable Identity
and hashing, while List supplied a shared snapshot Cursor. Neither delivery
automatically determined Map's API, representation or mutation guarantees.
The accepted result is a source SDK Map with its own bucket nodes, an ordinary
generic Keyval association, optional lookup/previous-value results and independent
entry snapshots. The implementation uses existing typed Registry/PBX/VM contracts;
the runtime checkout was not modified.
## Separate presence from payload
`m[key]`, `put(entry)` and `remove(key)` return optional V. The outer optional
answers whether an entry existed. V may itself be optional:
| Stored state | Lookup or previous-value result |
| --- | --- |
| No association | none |
| Present association, V=none | some(none) |
| Present association, V=some(42) | some(some(42)) |
For example, inside a function:
```pbs
let scores = new map<str, optional int>();
scores["pending"] = none;
if scores.containsKey("pending") {
if let payload = scores["pending"] {
// payload is optional int and is currently none.
}
}
```
Assigning none does not remove an entry. remove is the structural operation.
Zero/false are present values, and faults never become none. K directly optional
is rejected consistently with Set; independent `keyval<K,V>` remains an ordinary
generic struct and can hold optional components. The restriction on
`array<optional T>` does not prohibit a V field in a private node.
## Preserve the stored key representative
Default Identity follows the [Set policy](../../../docs/compiler/pbs/specs/sdk-set-and-identity.md):
scalar/String values use their specified value domains; eligible objects use
instance identity; contracts use their validated receiver. Unsupported defaults
require an explicit Identity<K>. V needs no equality/hash capability.
A content strategy can consider distinct objects equivalent. If a map already
stores object A and a write supplies equivalent object B, replacement changes
only V. A remains the key returned by subsequent snapshots; size and capacity do
not change. To make B the representative, remove and reinsert. This rule avoids
silently replacing object identity while updating an association's value.
An explicit strategy must remain coherent and stable while keys are stored.
Remove keys from affected collections before changing relevant content or policy
configuration, then reinsert. Cached hashes do not repair unstable equality.
## Keyval is an association, not a storage node
`new keyval<K,V>(key, value)` constructs a normal generic SDK struct. It has private
fields and only key()/value() accessors, with no mutators. Assignment shares its
instance and payload references. Separately constructed keyvals remain distinct
under default instance identity even when their components match.
Map.put reads those components and returns the previous V. It does not retain the
input Keyval as an editable table node. Internal Map nodes store cached long hash,
K, mutable V and next link. This keeps storage mutation private and avoids one
public Keyval allocation per internally stored association.
Keyval is shallowly read-only: its association is fixed, but referenced objects
remain shared and mutable. An old captured value does not follow replacement
with a new object; mutating the old object itself is still visible through aliases.
## Share policies and helpers without a universal table
Map and Set share Identity, hash primitives, private bucket/size/growth arithmetic
and the Cursor implementation. They retain separate node types and algorithms.
Map is not implemented over Set or Linked, and there is no universal Element.
Empty Map construction is lazy. First inclusion creates 8 buckets, growth occurs
above 3/4 occupancy and doubles up to Array's u32 structural maximum. Chaining may
continue above that bucket count within checked signed-long size and provider
quotas. Removal does not shrink; clear releases the table and restores lazy state.
Full signed-long hashes select buckets using remainder plus positive correction,
without abs or int narrowing. Rehash copies independent topology using cached
hashes and complete K/V groups; it never calls Identity or edits old published
links during preparation. Old and candidate tables/nodes coexist under normal
quota accounting. Search still has a linear worst case.
## Capture associations independently of later mutation
Map.cursor returns `Cursor<keyval<K,V>>`. Each association costs a new Keyval and
an immutable private snapshot node, plus applicable carriers. Capture takes
O(B+N) work and O(N) extra storage, returns only when complete, calls no strategies
and retains no editable Map node or bucket position.
The [shared Cursor table](../../../docs/compiler/pbs/specs/sdk-list-and-cursor.md#cursor-protocol)
is unchanged: current starts on the first captured entry; hasNext tests for a
successor; next without one retains the last entry. Only an empty-born Cursor has
absent current. Consume current before checking whether to advance.
Later insertion, replacement, removal, clear or rehash cannot rewrite captured
associations. Order is unspecified. Consumed prefixes may become unreachable,
while the final current remains retained until its Cursor releases it. The real
GC corpus observes 1,200 -> 1 -> 1 -> 0 snapshot nodes and Keyvals, retaining
2,400 -> 2 -> 2 -> 0 distinct key/value objects. The Map-node count is zero after
capture ownership leaves the source collection, confirming no source-node link.
## Prepare even typed absence before structural writes
The quota corpus exposed an easy source-level mistake: `return none` can lower
to instructions that allocate a private typed-default carrier. Returning it after
inserting a node therefore introduced a fallible allocation after publication,
despite the source text looking like a trivial constant.
The insertion path now prepares the typed absent previous value before structural
writes and returns that prepared local afterward. Existing-entry put/remove also
prepare their complete optional previous-value carriers before replacement or
unlinking. Optimized and ordinary producers qualify these phases independently.
This preparation is not a transaction. Read/write indexing, containsKey, put and
remove use a guard against Identity-driven reentry on the same Map, including
aliases. clear is also blocked during callbacks; size/isEmpty/cursor may inspect
the consistent prior structure. Normal returns release the guard. Callback faults
may leave it installed while associations remain unchanged.
Before structural writes, refusal preserves old associations/topology but does
not undo callbacks, arguments, guard writes or provisional allocation. After
structural writes start, faults may retain earlier writes and incomplete
invariants, with no rollback or safe-reuse guarantee. A separate test-only quota
probe after candidate-table installation demonstrates table=16/nodes=7 while old
size=6 and guard=true. It does not ship in the SDK or represent a natural refusal
frequency. Budget/debugger pauses remain resumable instruction boundaries.
## Compiler and editor integration pitfalls
- Map keys are K, not positional long indices. Semantic analysis and lowering must
select Map handling before Array/List/Linked promotion, passing every key slot.
- Indexed reads are optional V while indexed assignment expects V. Contextual
generic construction on a key/value expression must use that operand's expected
application, not the outer lookup optional.
- A chained `optionalCall().hasSome()` has a boolean outer context, but that must
not erase the uniquely resolved optional return or change the receiver's lowering
context. This front corrected both resolution and receiver lowering.
- Keyval privacy must hold in completion, hover, navigation and signature help,
while private `this` fields remain available inside their owner. Unknown editor
receivers must produce no invented members or null-name resolution failures.
- Contextual constructors record application provenance on the entire NewExpr
span; signature help must resolve that concrete application as well as explicit
angular type applications. Imported aliases keep original SDK definitions.
- Generic default constructors must not invalidate explicit-strategy applications
for keys without default Identity. Keep K and V restrictions independent.
## Qualification and maintenance references
The complete regression and installed-JAR gates passed. Both production runtime
profiles executed all 88 mandatory Map PBX fixtures: 64 paired behavior/expected
fault cases, 16 natural-resource fixtures, 2 separate injected-fault fixtures,
4 GC fixtures covering both producers and 2 import/installed examples. Each profile
observed 328 natural refusals before structural writes, 2 post-publication test
injections, 8 snapshot GC observations and 10 collection GC observations.
Qualification is local macOS/arm64 against unchanged provider
`dcf6561ea73446e0a3e1cf1c73eda20923b38df0`. It does not establish a performance
threshold, other-host qualification or installed game readiness. Existing unrelated
disabled JUnit cases and upstream headless-schema gaps remain explicit in the
evidence and are not counted as new Map conformance.
- [Normative Map/Keyval specification](../../../docs/compiler/pbs/specs/sdk-map-and-keyval.md).
- [Executable installed example](../../../prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/maps.pbs).
- [SDK algorithms](../../../prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/main.pbs).
- [Source-to-PBX qualification](../../../prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsMapKeyvalTest.java).
- [Harness reproduction](../../../tools/pbx-conformance/README.md).
- [Set/Identity predecessor](../DSC-0092-pbs-sdk-set/LSN-0093-reusable-identity-and-source-set-buckets.md).
- [Sequential mutation boundaries](../DSC-0096-runtime-storage-isa-consumer-migration/LSN-0092-sequential-collection-mutations-need-explicit-failure-boundaries.md).
@@ -0,0 +1,126 @@
# Map/Keyval implementation and qualification evidence
Owner: `compiler/pbs`. Captured 2026-10-26 for accepted DEC-0079 / PLN-0157,
with complete coverage of R1–R12. Studio baseline HEAD and host/tool versions are
in [environment.json](environment.json). Runtime remained clean at
`dcf6561ea73446e0a3e1cf1c73eda20923b38df0`; no runtime write or commit was made.
## Reproduction and results
From the Studio root:
```sh
./gradlew test :prometeu-app:installedKnowledgeTest --console=plain
CARGO_TARGET_DIR=/tmp/studio-pbx-map-target python3 tools/pbx-conformance/run.py --runtime ../runtime
CARGO_TARGET_DIR=/tmp/studio-pbx-map-target python3 tools/pbx-conformance/run.py --runtime ../runtime --release
git diff --check
discussion validate
```
All returned zero. The two complete VM runs include all Map cases and the existing
Registry, catalog, math, Random, input, Array/optional, Struct/contract, generic,
closure, storage/copy, List, Linked, Set, Identity/hash, admission and schema corpora.
Focused `--map-only` runs were used during development; final evidence is from
the complete harness built from the final source fingerprints.
Aggregated standard JUnit reports contain 1,079 cases: zero failures/errors,
1,066 executed and 13 existing skips. The independent installed-knowledge task
adds two passing cases outside the checkout using installed JARs. The final
Gradle invocation completed in 15 seconds with 2 executed and 92 up-to-date tasks;
unchanged suites retained valid prior successful results. Reported suites and
individual skips are preserved in [gradle-results.json](gradle-results.json).
Existing skips belong to BackendGateIIntegrationTest (8),
MainProjectPipelineIntegrationTest (4) and ExternalSourceDevelopmentHostTest (1).
None is a new Map test. Frontend totals are 305 and architecture totals are 127.
Each Rust profile uses both ordinary and optimized source producers, including
the GC fixtures. Eighty-eight mandatory Map files are fingerprinted: 64 behavior
and expected-fault cases, 16 resource fixtures, 2 distinct injection fixtures,
4 GC fixtures and 2 real import/installed examples. Missing mandatory fixtures
fail qualification. The full fixture directory contains 1,389 fingerprinted PBX
files; a directory count is not itself a count of executed corpus cases.
| New observation per Rust profile | Count |
| --- | ---: |
| Behavior / expected callback and overflow faults | 64 |
| Natural quota refusals with successful-prefix comparison | 328 |
| Separate test-only post-publication quota injections | 2 |
| Snapshot GC observations, ordinary + optimized | 8 |
| Collection/replacement/removal GC observations, ordinary + optimized | 10 |
| Import/reexport and installed-JAR example executions | 2 |
Known upstream headless-schema gaps for LifecycleRole and NonFiniteValue remain
printed explicitly. Original provider payloads are preserved and those cases are
not called conformance to the unmodified published enum. No new exception was
introduced for Map. Qualification is local macOS/arm64, not a timing benchmark or
other-host/deployed-game qualification.
## Resource and failure-phase observations
The paired producer paths and Rust profiles produced the same peak vectors.
These are measured whole-fixture/session peaks including setup, wrappers and call
preparation, not standalone Map object sizes.
| Operation | GuestBytes before → after | HandleSlots before → after | Peak Map nodes / tables | Natural refusals per producer |
| --- | --- | --- | --- | ---: |
| Growth 6 → 7 | 26,776 → 50,576 | 86 → 161 | 13 / 2 | 38 |
| Add without growth | 21,848 → 27,688 | 70 → 89 | 6 / 1 | 25 |
| Index replacement | 21,848 → 24,912 | 70 → 80 | 5 / 1 | 16 |
| put replacement | 21,848 → 25,516 | 70 → 82 | 5 / 1 | 18 |
| Remove | 21,848 → 25,540 | 70 → 82 | 5 / 1 | 16 |
| Clear | 21,848 → 22,152 | 70 → 71 | 5 / 1 | 5 |
| Cursor capture | 21,848 → 37,888 | 70 → 122 | 5 / 1 | 30 |
| Read | 21,848 → 25,212 | 70 → 81 | 5 / 1 | 16 |
All 328 natural refusals in each final profile occurred before structural writes;
an installed guard may remain. This does not prove post-write faults impossible
or permit automatic safe reuse. The separate test-only probe after actual table
installation retains 16 buckets, 7 nodes, old size 6 and active guard when the
probe allocation fails, while the refused instruction preserves its own entry state.
Production SDK source contains no such probe. The source prepares even typed none
before publication because lowering that absence can materialize a private carrier.
Snapshot GC observes 1,200 -> 1 -> 1 -> 0 nodes and Keyvals and
2,400 -> 2 -> 2 -> 0 distinct key/value Items, without retaining the source Map
table/nodes. Collection GC observes 64 -> 64 -> 61 -> 0 -> 0 Map nodes and
128 -> 128 -> 122 -> 0 -> 0 Items: overwritten values are reclaimed, removals
release keys/values and clear releases all associations. Both producer variants
pass these observations in both runtime profiles.
The eight peak vector components are GuestBytes, HandleSlots, AuxiliaryBytes,
TemporaryBytes, StringBytes, StringAllocations, IndividualStringBytes and CallDepth.
The complete vectors, refusal operation/resource/opcode records and GC counts are
in [map-results.json](map-results.json) and the compressed raw logs.
## Requirement coverage retained after housekeeping
| Requirement | Final evidence |
| --- | --- |
| R1 Construction, nominal origin, invariance | Frontend Map tests, SDK interface gate, alias/reexport frame and installed source |
| R2 API and evaluation | basic/scalars/evaluation source cases, typed string/object/tuple/native keys |
| R3 Optional presence | optional source case, nested payloads, stored none/zero/false, actual installed example |
| R4 Representative and previous values | content/basic cases, no-growth replacement resource baseline, snapshot independence |
| R5 Identity policies | scalars/objects/references/random/tuple/native/pixel cases and nominal/default-strategy frontend negatives |
| R6 Read-only Keyval | content case with distinct association instances and shared payloads; private-field semantic/editorial gates |
| R7 Buckets, bounds, cleanup | collisions/arithmetic/overflow, structural validation of resource fixtures, collection GC |
| R8 Reuse, rehash, memory | collision strategy counters, 13-node/2-table growth peak and full existing Set corpus |
| R9 Entry snapshot | empty/single/multiple states, snapshots/content, callback reads, paired snapshot GC |
| R10 Guard and failure phases | hash and equals callback fault matrices, successful-prefix quota comparison, separate post-publication injection |
| R11 Groups, owners, LSP | tuple/native/pixel/contract/reference payloads, source-order checks, real GC and SDK provenance/privacy editor tests |
| R12 Production qualification and distribution | Complete debug/release logs, both producer paths, isolated installed-JAR compilation/execution and regression reports |
## Files and workflow mechanics
- `regression.log.gz`, `conformance-debug.log.gz`, `conformance-release.log.gz`:
complete final raw outputs.
- `source.sha256`: all changed/new version-controlled surfaces at qualification.
- `fixtures.sha256.gz`: actual generated PBX fingerprints, including installed examples.
- `gradle-results.json`, `map-results.json`, `environment.json`: machine-readable results.
- `workflow.txt`: completed plan, validation and housekeeping output.
- `SHA256SUMS`: evidence file integrity manifest.
The CLI has no standalone lesson creation/next-ID query. LSN-0094 was read through
the framework's read-only model accessor; `discussion housekeep` performs its
registration, counter advancement, index updates and workflow artifact removal.
The index was not edited manually. The English lesson preserves the operational
knowledge; completed agenda/decision/plan files are disposable workflow scaffolding.
@@ -0,0 +1,10 @@
e00bd96cd1e689654be4d563b550e488265c8eaf2038734013219019c508e004 README.md
08b3115f4dc03a2a637b4133fd4a7ec6a27395183b8de1d778953e71c2e7df9f conformance-debug.log.gz
5efbde06fc26364560cf5e4e717d8023769ce322edb624b01d80e957dfe1a701 conformance-release.log.gz
325cb8c0638609340e398352e1c7a006b232ad24c7f860958f84017193266576 environment.json
8e8453dbd3b4e336d6fcf5d49337cb03ef2a3365d8e905f4db52d7ce6a8d1000 fixtures.sha256.gz
effff1a1552e7210bdb0486e44996d668dfb1d1e1cd1c0f076fe7a47a837f0f6 gradle-results.json
be95e4f4aa5c8d2718c8cc356b3eaa68cce050632f0ea6d1ed5051f482013b4e map-results.json
5af47b805bcf2c794d95bfaf517fe592e6b24116ba87d1c46a490fbbc18fbce1 regression.log.gz
8569d628c2e0305e403197ef8b7c92cb9156bae817529a01f828c7ef340ce3ea source.sha256
e93ad3067041f75297210adbf1f6cfd6a30a090c44d74afaf0059b6a1bee1faf workflow.txt
@@ -0,0 +1,13 @@
{
"captured": "2026-10-26",
"owner": "compiler/pbs",
"decision": "DEC-0079",
"plan": "PLN-0157",
"studio_baseline_head": "8105604f9210468fc61950b124cdd7adf58daaf0",
"runtime_head": "dcf6561ea73446e0a3e1cf1c73eda20923b38df0",
"runtime_working_tree": "",
"host": "macOS-27.0.1-arm64-arm-64bit-Mach-O",
"rust": "rustc 1.98.1 (48a229cea 2026-09-01)\nbinary: rustc\ncommit-hash: 48a229ceaefd4985c50990b14116b6d856af0985\ncommit-date: 2026-09-01\nhost: aarch64-apple-darwin\nrelease: 1.98.1\nLLVM version: 22.1.8",
"map_fixture_count": 88,
"all_fixture_count": 1389
}
File diff suppressed because it is too large Load Diff
@@ -0,0 +1,992 @@
{
"debug": {
"behavior_and_expected_faults": 64,
"phase_refusals": [
{
"operation": "growth",
"refusals": 38,
"after_structural": 0
},
{
"operation": "growth-optimized",
"refusals": 38,
"after_structural": 0
},
{
"operation": "add",
"refusals": 25,
"after_structural": 0
},
{
"operation": "add-optimized",
"refusals": 25,
"after_structural": 0
},
{
"operation": "replace",
"refusals": 16,
"after_structural": 0
},
{
"operation": "replace-optimized",
"refusals": 16,
"after_structural": 0
},
{
"operation": "put",
"refusals": 18,
"after_structural": 0
},
{
"operation": "put-optimized",
"refusals": 18,
"after_structural": 0
},
{
"operation": "remove",
"refusals": 16,
"after_structural": 0
},
{
"operation": "remove-optimized",
"refusals": 16,
"after_structural": 0
},
{
"operation": "clear",
"refusals": 5,
"after_structural": 0
},
{
"operation": "clear-optimized",
"refusals": 5,
"after_structural": 0
},
{
"operation": "cursor",
"refusals": 30,
"after_structural": 0
},
{
"operation": "cursor-optimized",
"refusals": 30,
"after_structural": 0
},
{
"operation": "read",
"refusals": 16,
"after_structural": 0
},
{
"operation": "read-optimized",
"refusals": 16,
"after_structural": 0
}
],
"peaks": [
{
"operation": "growth",
"nodes": 13,
"tables": 2,
"before": [
26776,
86,
10688,
3840,
0,
0,
0,
6
],
"after": [
50576,
161,
18368,
7680,
0,
0,
0,
8
]
},
{
"operation": "growth-optimized",
"nodes": 13,
"tables": 2,
"before": [
26776,
86,
10688,
3840,
0,
0,
0,
6
],
"after": [
50576,
161,
18368,
7680,
0,
0,
0,
8
]
},
{
"operation": "add",
"nodes": 6,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
27688,
89,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "add-optimized",
"nodes": 6,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
27688,
89,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "replace",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
24912,
80,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "replace-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
24912,
80,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "put",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25516,
82,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "put-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25516,
82,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "remove",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25540,
82,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "remove-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25540,
82,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "clear",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
22152,
71,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "clear-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
22152,
71,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "cursor",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
37888,
122,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "cursor-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
37888,
122,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "read",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25212,
81,
10688,
3840,
0,
0,
0,
7
]
},
{
"operation": "read-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25212,
81,
10688,
3840,
0,
0,
0,
7
]
}
],
"test_only_postpublication_injections": 2,
"snapshot_gc_observations": 8,
"collection_gc_observations": 10,
"distribution_executions": 2,
"known_upstream_schema_gaps": [
"LifecycleRole missing from published enum; original payload preserved",
"NonFiniteValue missing from published enum; original payload preserved"
]
},
"release": {
"behavior_and_expected_faults": 64,
"phase_refusals": [
{
"operation": "growth",
"refusals": 38,
"after_structural": 0
},
{
"operation": "growth-optimized",
"refusals": 38,
"after_structural": 0
},
{
"operation": "add",
"refusals": 25,
"after_structural": 0
},
{
"operation": "add-optimized",
"refusals": 25,
"after_structural": 0
},
{
"operation": "replace",
"refusals": 16,
"after_structural": 0
},
{
"operation": "replace-optimized",
"refusals": 16,
"after_structural": 0
},
{
"operation": "put",
"refusals": 18,
"after_structural": 0
},
{
"operation": "put-optimized",
"refusals": 18,
"after_structural": 0
},
{
"operation": "remove",
"refusals": 16,
"after_structural": 0
},
{
"operation": "remove-optimized",
"refusals": 16,
"after_structural": 0
},
{
"operation": "clear",
"refusals": 5,
"after_structural": 0
},
{
"operation": "clear-optimized",
"refusals": 5,
"after_structural": 0
},
{
"operation": "cursor",
"refusals": 30,
"after_structural": 0
},
{
"operation": "cursor-optimized",
"refusals": 30,
"after_structural": 0
},
{
"operation": "read",
"refusals": 16,
"after_structural": 0
},
{
"operation": "read-optimized",
"refusals": 16,
"after_structural": 0
}
],
"peaks": [
{
"operation": "growth",
"nodes": 13,
"tables": 2,
"before": [
26776,
86,
10688,
3840,
0,
0,
0,
6
],
"after": [
50576,
161,
18368,
7680,
0,
0,
0,
8
]
},
{
"operation": "growth-optimized",
"nodes": 13,
"tables": 2,
"before": [
26776,
86,
10688,
3840,
0,
0,
0,
6
],
"after": [
50576,
161,
18368,
7680,
0,
0,
0,
8
]
},
{
"operation": "add",
"nodes": 6,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
27688,
89,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "add-optimized",
"nodes": 6,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
27688,
89,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "replace",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
24912,
80,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "replace-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
24912,
80,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "put",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25516,
82,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "put-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25516,
82,
10688,
3840,
0,
0,
0,
8
]
},
{
"operation": "remove",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25540,
82,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "remove-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25540,
82,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "clear",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
22152,
71,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "clear-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
22152,
71,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "cursor",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
37888,
122,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "cursor-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
37888,
122,
10688,
3840,
0,
0,
0,
6
]
},
{
"operation": "read",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25212,
81,
10688,
3840,
0,
0,
0,
7
]
},
{
"operation": "read-optimized",
"nodes": 5,
"tables": 1,
"before": [
21848,
70,
10688,
3840,
0,
0,
0,
6
],
"after": [
25212,
81,
10688,
3840,
0,
0,
0,
7
]
}
],
"test_only_postpublication_injections": 2,
"snapshot_gc_observations": 8,
"collection_gc_observations": 10,
"distribution_executions": 2,
"known_upstream_schema_gaps": [
"LifecycleRole missing from published enum; original payload preserved",
"NonFiniteValue missing from published enum; original payload preserved"
]
}
}
@@ -0,0 +1,34 @@
08b3115f4dc03a2a637b4133fd4a7ec6a27395183b8de1d778953e71c2e7df9f discussion/lessons/DSC-0093-pbs-sdk-map-keyval/evidence/conformance-debug.log.gz
5efbde06fc26364560cf5e4e717d8023769ce322edb624b01d80e957dfe1a701 discussion/lessons/DSC-0093-pbs-sdk-map-keyval/evidence/conformance-release.log.gz
effff1a1552e7210bdb0486e44996d668dfb1d1e1cd1c0f076fe7a47a837f0f6 discussion/lessons/DSC-0093-pbs-sdk-map-keyval/evidence/gradle-results.json
be95e4f4aa5c8d2718c8cc356b3eaa68cce050632f0ea6d1ed5051f482013b4e discussion/lessons/DSC-0093-pbs-sdk-map-keyval/evidence/map-results.json
5af47b805bcf2c794d95bfaf517fe592e6b24116ba87d1c46a490fbbc18fbce1 discussion/lessons/DSC-0093-pbs-sdk-map-keyval/evidence/regression.log.gz
8d5804910106bfa3f654edcefd2a7d196d70fdf19fd67b86bc80d8d766ffe25b docs/compiler/pbs/specs/generic-structs-and-free-functions.md
c82af9031ddd0143e208869a807fff5c85ee71d35799b9c841efdf8e30ed4b19 docs/compiler/pbs/specs/sdk-list-and-cursor.md
12135be9ff129493eb332f4bb9c05e36d7667e001f52669d03d90221d1232d9a docs/compiler/pbs/specs/sdk-map-and-keyval.md
4af3aa15ce6da20ae83c39ab4fcca38beba6f634ee5e55bf5f6edb0b5018ad50 docs/compiler/pbs/specs/sdk-set-and-identity.md
fe0e0d0eccfacd5b3f5ca220ec8c7a7c82f7bc527c5317d4b0651443b021f73e docs/compiler/pbs/specs/typed-arrays-and-optional-execution.md
de20f955ac4e55b3845741ea0ed6631326b4b91997f78fe7151dc094c40fe100 prometeu-app/src/test/java/p/studio/app/compiler/CompilerProjectKnowledgeTest.java
59d87f52a1d75bb2b873a5a0446ba00b50a2ae69b8e13f610467e8879ab0dbbe prometeu-app/src/test/java/p/studio/app/compiler/InstalledKnowledgeProbe.java
dd65d8a6f7912aa1ba853a6876bf198069a88fdd75fbf53f6e83e4a2cfd29ebd prometeu-app/src/test/java/p/studio/app/compiler/InstalledKnowledgeTest.java
43fcb6def3cb51dd410d27baf67fc96f5c524d29633700d1c5192d0c7c64aabc prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsListCursorTest.java
38412eaad67ca52b591a12bad0d22064b569b2944e29d5f49e243c6243487bc5 prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsMapKeyvalTest.java
5254aad2e0001ce420fec865e518f41aeaa938e7271319a81da016aeed8ab48d prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsSetTest.java
f8336f28708de962c6dbe6e7c4927accb01c3bdc4df1a70f53921e14cea04e9d prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsGenericInstantiation.java
4231b9b16aae5e81740299a0959ca0258dedc3724ee69e82174df8218bfddfed prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsGenericTemplateValidator.java
e486759ce7a8225fdab8c793b1305dda761c7f7dc9ea542feb832432fa98efec prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsSdkCollections.java
f7295c1d1430b24f3bc76f3b988c9bb19e6047334d73b274a9eca6ff2751e624 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsExecutableBodyLowerer.java
e6101710926b3bb6b1d188544f505a6f6236c551c7c7667d7e0bf8cb68afeda5 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/parser/PbsDeclarationParser.java
452363ea506a17dabd68ff3bc1443066fbc9558877c8016df3fdb85465fa38dc prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsEditorialSupportService.java
e0cc2c6dbd0cd2c3acfe58ebc17dba8f9fe58dd76c7820212863f851afd7cd32 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowSemanticSupport.java
448ea7e5650ff101ae380d0fef3f5f925fea8687ec236f32fc95ddb2b79f57fb prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowStructuralExpressionAnalyzer.java
6fe7a8ed065c6df78af005320ece39425bb73eeb48e8451310866655ff109733 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/main.pbs
eedf6c88abc73535423edfeafa549d491c137d23f7532d3d9b72f0ca6622642c prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/mod.barrel
25d85ee0698f6e5e0ffae561ebf639a5942b4c990418fcbd5d9a4992c37109ea prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/maps.pbs
e3a5232997b2bdc2d249da07b186bbc6fb73eb8741aacd3aa00beda43537d2e6 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/mod.barrel
6ec188158133c4632bd15a42105a6b32a8c9b5963872bdd62e7a1cd3954a2893 prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/PbsGateUSdkInterfaceConformanceTest.java
fd9dd09edbf272ce54cb59c633df481d1d72fd1e008992b93f4a5583747f578b prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/PbsMapKeyvalTest.java
7a3ffc5e2a533966dbe069f8a5e1541005916d7be47aa65d0f4d605926945f71 prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/semantics/PbsMapKeyvalEditorialTest.java
01311527195d9f8513c96907adf7eb501080cd073e56f3f71b6e6c690c800b94 tools/pbx-conformance/README.md
2d3cfb43159a4c20f891562f2e196fd894e82e0d47124f09707b20f146ed505e tools/pbx-conformance/main.rs
11ac435b7c1f7a0df1961975a537da4f491d4c6fd7feeb8b7b39183ecaf039e2 tools/pbx-conformance/run.py
@@ -0,0 +1,23 @@
Owner: compiler/pbs. Completed 2026-10-26. DEC-0079 / PLN-0157, R1–R12.
Workers: Spec Editorial Worker, Code Implementation Worker, Lesson Worker.
discussion mark-plan PLN-0157 done --json
{"discussion_id":"DSC-0093","plan_id":"PLN-0157","status":"done"}
discussion validate (before housekeeping)
validation passed
discussion housekeep DSC-0093 --lesson discussion/lessons/DSC-0093-pbs-sdk-map-keyval/LSN-0094-map-presence-key-identity-and-captured-associations.md
housekept DSC-0093
removed workflow artifacts: 3
registered lesson: LSN-0094
discussion validate (after housekeeping)
validation passed
discussion inspect DSC-0093
DSC-0093 done pbs-sdk-map-keyval; sole artifact: LSN-0094 done, present.
Runtime: clean dcf6561ea73446e0a3e1cf1c73eda20923b38df0, no writes or commits.
Next lesson ID was obtained through DiscussionIndex.next_id (read only);
housekeep owned registration, counter advancement and index mutations.