refactor(vm)!: remove publication and logical guard opcodes
Intrepid/Prometeu/Runtime/pipeline/head This commit looks good
Intrepid/Prometeu/Runtime/pipeline/head This commit looks good
Remove INDEX_GUARD, ARRAY_CHECK_LENGTH, STORAGE_PUBLISH and FIELDS_PUBLISH from decoding, metadata, tooling, verification and execution. Keep ARRAY_LEN and overlap-safe ARRAY_COPY with complete-group ownership and early charging of calculable copy work, including refused attempts. Update specifications, producer handoff, qualification evidence and lessons. Share collection test support and remove redundant Copy clones for Clippy. Validation: make ci-domains passed with 1,095 workspace tests, five separately executed debugger socket tests and all 15 unchanged coverage domain gates. VM release, resource diagnostics and layer/quality suites also passed. BREAKING CHANGE: PBX using opcodes 0xA7, 0xA8, 0xAA or 0xAB is rejected, including unreachable instructions. Consumers must adapt their emission and collection algorithms or operational guarantees.
This commit is contained in:
@@ -169,6 +169,16 @@ The [Dynamic/reference instruction table](02c-program-registry-and-pbx-v0.md#dyn
|
||||
|
||||
The [collection ISA table](02-vm-instruction-set.md#typed-collection-instructions) defines complete costs. Metadata widths determine costs independently of native sizeof, allocator, timing, optimizer and GC. Each decoded collection attempt is charged exactly once before validation/refusal. Fixed costs apply even to underflow, invalid receiver, bounds and rejected value groups. ARRAY_NEW charges 8 + N*w(E) whenever an available exact Int64 length is in 0..u32::MAX, including quota/allocation refusal; absent, wrong-carrier, negative or above-u32 length charges eight. Rejected loads execute and charge no guest instruction.
|
||||
|
||||
ARRAY_COPY charges C=4+2*N*W when all five temporary operands are available and
|
||||
count is exact Int64 in 0..u32::MAX. W comes from immutable Registry element
|
||||
storage. Charge C before receiver/range/group validation and scratch reservation,
|
||||
retaining it on refusal. Otherwise charge base 4 and preserve ordinary fault
|
||||
precedence. Checked cost overflow charges base 4 and traps SizeOverflow before
|
||||
ordinary validation. Never inspect frame locals as missing operands. Empty copies
|
||||
still validate and cost 4; identity/overlap give no discount. Ten one-slot elements
|
||||
cost 24 on success, invalid receiver/range or scratch refusal. Full validation
|
||||
order is defined in the [copy contract](02-vm-instruction-set.md#typed-array-range-copy).
|
||||
|
||||
Examples: empty Struct/Array costs eight; a Struct containing Int32, vec2 and Trait costs thirteen; ten vec2 elements cost twenty-eight even on quota refusal; pixel GET costs six including bounds failure; pixel SET costs seven including group rejection; LEN costs three including receiver failure. Charged cycles are never refunded by rollback.
|
||||
|
||||
Budget admission remains between instructions. Zero executes nothing. A positive remaining budget admits the entire next instruction, which may overshoot; continuation then returns BudgetExhausted before the following instruction. Thus ARRAY_NEW of ten vec2 under run_budget(1) consumes twenty-eight cycles. Trap takes priority on refusal, with the same cycle delta and no successful target step. steps_executed counts only successful steps; cycles_used includes failed attempts. Collection operations add no implicit frame sync, tick, GC or coroutine switch, no extra length cap and no cycle pre-admission rule.
|
||||
|
||||
@@ -163,96 +163,58 @@ Typed callable instructions are MAKE_CLOSURE `(FunctionId,FnTypeId)`, CALL_CLOSU
|
||||
INTRINSIC also dispatches the [VM-owned random operations](02e-vm-owned-random-core.md), IDs 0x4000–0x4003. NEW cannot construct Random. TRAP_RANDOM_REJECTION_LIMIT is 0x00000015.
|
||||
|
||||
|
||||
## Logical guards and atomic storage publication
|
||||
## Typed array range copy
|
||||
|
||||
The core includes the following generic operations, with u16 opcodes and
|
||||
little-endian u32 immediates. They introduce no new Registry category, syscall,
|
||||
source-language collection or ambient transaction. Operand order below is bottom
|
||||
to top; all integer operands are Int64.
|
||||
ARRAY_COPY uses little-endian u16 opcode 0xA9 followed by one little-endian u32
|
||||
Array TypeId. It consumes five operands, bottom to top: source, sourceStart,
|
||||
target, targetStart, count, and produces no result. Receivers require the exact
|
||||
Array type; sourceStart, targetStart and count require exact Int64 carriers.
|
||||
Ranges must be nonnegative and fit each physical array, without clamping,
|
||||
truncation or coercion. An empty range may start at the physical length.
|
||||
|
||||
| Opcode | Immediate | Stack operands consumed |
|
||||
| --- | --- | --- |
|
||||
| INDEX_GUARD `0xA7` | none | index, exclusive limit |
|
||||
| ARRAY_CHECK_LENGTH `0xA8` | Array TypeId | length |
|
||||
| ARRAY_COPY `0xA9` | Array TypeId | source, sourceStart, target, targetStart, count |
|
||||
| STORAGE_PUBLISH `0xAA` | Array TypeId, Struct TypeId, first field, second field | source, sourceStart, target, targetStart, count, fillStart, fillCount, element group, owner, first field group, second field group |
|
||||
Loading validates Array identity/category even in unreachable code. Registry
|
||||
verification requires five complete operands. The instruction may trap, but is
|
||||
neither a branch, terminator nor safepoint. ARRAY_LEN (0xA4) remains the physical
|
||||
length query. Logical collection limits and error paths belong to producers.
|
||||
The encodings 0xA7, 0xA8, 0xAA and 0xAB are unsupported and reject at admission,
|
||||
including in unreachable code. Bytes inside immediates or data are not opcodes.
|
||||
There is no multi-owner publication, generic batch or atomic-region replacement.
|
||||
|
||||
All operations return no values. INDEX_GUARD accepts exactly
|
||||
`0 <= index < limit`, otherwise TRAP_OOB. It does not use physical storage length.
|
||||
ARRAY_CHECK_LENGTH accepts zero through u32::MAX without allocating. Negative
|
||||
lengths produce TRAP_OOB; values above u32::MAX produce the same resource
|
||||
SizeOverflow failure as ARRAY_NEW. This check does not reserve future allocation.
|
||||
Copy preserves complete stored groups, including presence tags, immutable boxes,
|
||||
native String owners, HeapRefs, traits and identities without boxing or payload
|
||||
repacking. All source groups are captured before the first destination write,
|
||||
so overlap observes the pre-attempt source sequence. All copy scratch is reserved
|
||||
under TemporaryBytes before writing and released on success or failure. Original
|
||||
operands remain roots throughout preparation. No guest object or request token
|
||||
is allocated. Quota refusal does not trigger rescue GC.
|
||||
|
||||
ARRAY_COPY and STORAGE_PUBLISH require exact Array receiver identities and complete
|
||||
stored groups. Every range must have nonnegative start/count and fit its physical
|
||||
array; an empty range may start at length. Invalid ranges produce TRAP_OOB, never
|
||||
clamping or truncation. Copy reads the pre-attempt source sequence, including for
|
||||
overlapping source/target ranges. Presence tags, immutable boxes, native owners and
|
||||
object identities are preserved without payload unpacking or repacking.
|
||||
Validation, quota or recoverable allocation failure preserves operands and all
|
||||
destinations/owners. Commit uses prevalidated infallible writes; no callback,
|
||||
allocation, GC or scheduler boundary occurs inside the instruction. Consume the
|
||||
five operands only after commit. Cycles and diagnostics retain the attempt.
|
||||
This guarantee begins with prepared operands; it does not undo earlier source
|
||||
calculations, allocations or callbacks, or make a sequence of stores transactional.
|
||||
|
||||
STORAGE_PUBLISH first copies the selected source range, then fills the selected
|
||||
target range with the supplied element group, then writes the two selected fields
|
||||
on the supplied Struct owner. Fields must be distinct valid indices on that Struct;
|
||||
their types and widths come from the immutable Registry. Source code/producer owns
|
||||
selection of every range, value, owner and field. The VM implements these generic
|
||||
ordered effects and does not select collection algorithms.
|
||||
Let N=count and W=element storage slots from the immutable validated Registry.
|
||||
The planned cost is C=4+2*N*W. Charge base 4 for every admitted attempt. Only inspect
|
||||
count for cost selection when all five operands are available in the temporary
|
||||
stack region; frame locals are not operands. If N is exact Int64 in 0..u32::MAX,
|
||||
charge representable C before validating receivers, offsets, ranges, source
|
||||
groups or reserving scratch. Retain C on any later refusal. Otherwise retain base
|
||||
4 and follow ordinary validation; count is neither converted nor accepted.
|
||||
Checked overflow of C retains only base 4 and produces structured RESOURCE_LIMIT
|
||||
with SizeOverflow before ordinary validation, without wrapping or saturation.
|
||||
|
||||
Loading validates all immediate identities/categories/fields even in unreachable
|
||||
code. Verification requires complete typed operands. ARRAY_COPY consumes five
|
||||
slots; STORAGE_PUBLISH consumes `8 + elementWidth + firstWidth + secondWidth`.
|
||||
INDEX_GUARD consumes two slots and ARRAY_CHECK_LENGTH consumes one.
|
||||
|
||||
Execution validates all receivers, lengths/ranges, supplied groups and source
|
||||
groups, and reserves the complete charged copy scratch before writing. Validation,
|
||||
quota or host allocation refusal leaves all input operands and destinations
|
||||
unchanged, including both fields and native owners. Scratch uses TemporaryBytes,
|
||||
is refunded on success/refusal and does not relax any resource ceiling. Existing
|
||||
operands remain roots during preparation. There is no GC, callback, scheduler or
|
||||
other interleaving inside this single instruction. Commit uses already validated
|
||||
complete groups, performs no fallible allocation and consumes operands only after
|
||||
all selected effects have been published. No prepared token escapes the attempt.
|
||||
|
||||
Base cycle costs are 2 for either guard, 4 for ARRAY_COPY and 6 for STORAGE_PUBLISH.
|
||||
Copy adds `2 * count * elementWidth`; publication additionally adds
|
||||
`fillCount * elementWidth + firstWidth + secondWidth`. Work arithmetic is checked
|
||||
before mutation. A refused preparation still charges the attempted work. Neither
|
||||
operation is a safepoint. Consumers must prepare any potentially failing return
|
||||
carrier and all call operands before publication; a series of ordinary stores is
|
||||
not a substitute for whole-operation safety.
|
||||
|
||||
|
||||
## Atomic publication of multiple Struct instances
|
||||
|
||||
FIELDS_PUBLISH (`0xAB`) has one little-endian u32 schema TypeId immediate. The
|
||||
schema MUST be a Registry Struct whose ordered field types are all Struct types.
|
||||
Names are descriptive only. The schema is declarative metadata; no request object,
|
||||
new Registry category or preparation token is allocated or exposed.
|
||||
|
||||
For each schema entry, the operand stack supplies one nullable destination
|
||||
reference followed by every destination field's complete typed value group, in
|
||||
field declaration order. The stack effect is the sum, over entries, of one plus
|
||||
the destination instance's initialization-slot count; no results are produced.
|
||||
Null skips that destination, but every supplied field group is still validated.
|
||||
Non-null destinations require exact concrete Struct identity and a live reference
|
||||
of the current session/generation. Array, Trait, Fn and builtin schema entries are
|
||||
invalid, including in unreachable instructions. The full schema and exact stack
|
||||
height/groups are checked under normal Registry admission/work limits.
|
||||
|
||||
Validate all destinations and value groups before any shared write or operand
|
||||
consumption. The original operands remain roots throughout preparation. Then write
|
||||
all fields in schema order, without allocation, fallible validation, callbacks,
|
||||
GC or scheduler interleaving, and consume the entire input. Input values are
|
||||
captured before publication; repeated destinations use ordered last-write
|
||||
semantics. Complete multi-slot/native/reference groups retain identity and normal
|
||||
ownership. A failed attempt preserves every destination and the operand stack.
|
||||
|
||||
The operation allocates no publication scratch or guest object. Operand/frame and
|
||||
source value preparation remain normally charged and may fail before publication.
|
||||
Base cost is 6 cycles. After the stack-height check, precharge one cycle per schema
|
||||
entry and one per destination field execution slot for the complete declared
|
||||
attempt, including skipped destinations. Quotas are unchanged.
|
||||
This is a generic typed storage mechanism; collection algorithms and node topology
|
||||
remain source-owned, with no collection-specific VM instruction or syscall.
|
||||
Early count inspection selects cost only. Apart from cost overflow, fault order
|
||||
is temporary height, source receiver, target receiver, carriers of sourceStart,
|
||||
targetStart and count, source range, target range, scratch reservation, then source
|
||||
group reads/validation in order. Thus above-u32 count with otherwise valid inputs
|
||||
fails physical bounds, not an allocation-size check. N=0 still validates receivers
|
||||
and ranges and costs 4. Identity and overlap grant no discount. N=10/W=1 costs 24
|
||||
on success, invalid receiver/range or scratch refusal. Zero budget executes no
|
||||
attempt; a positive budget admits the whole instruction with overshoot. Trap
|
||||
prevails over BudgetExhausted on failure, with no successful target step. Rejected
|
||||
images execute no guest instruction and charge zero guest cycles.
|
||||
|
||||
## Identity and value hashing
|
||||
|
||||
|
||||
@@ -308,13 +308,15 @@ precedence, conversions, catalog metadata and producer examples.
|
||||
[Random](02e-vm-owned-random-core.md) adds BuiltinId 0x0016 and intrinsic IDs 0x4000–0x4003 using existing PBX v0 encoding. Registry categories remain unchanged; unsupported identities are rejected, without fallback.
|
||||
|
||||
|
||||
## Logical guards and atomic storage publication
|
||||
## Typed array range copy
|
||||
|
||||
INDEX_GUARD (0xA7), ARRAY_CHECK_LENGTH (0xA8), ARRAY_COPY (0xA9) and
|
||||
STORAGE_PUBLISH (0xAA) provide generic logical validation, complete stored-group
|
||||
transfer and prepared atomic publication. Their encoding, typed operands, exact
|
||||
faults, overlap semantics, costs and preflight/commit guarantees are defined by
|
||||
the [canonical instruction contract](02-vm-instruction-set.md#logical-guards-and-atomic-storage-publication). No new Registry category, syscall, collection algorithm or safepoint is introduced.
|
||||
ARRAY_COPY (0xA9) uses one Array TypeId and five operands for complete stored-group
|
||||
range transfer, with no new Registry category or PBX section. Encoding, exact
|
||||
receivers, overlap, preparation, fault order and precharged attempt costs follow
|
||||
the [instruction contract](02-vm-instruction-set.md#typed-array-range-copy).
|
||||
Unsupported opcodes 0xA7, 0xA8, 0xAA and 0xAB reject during bounded instruction
|
||||
admission even after a terminator. Immediate/data bytes are not instructions.
|
||||
ARRAY_LEN remains 0xA4; physical allocation/access checks remain mandatory.
|
||||
|
||||
## Identity queries
|
||||
|
||||
|
||||
@@ -223,15 +223,18 @@ Threshold GC opportunities are FRAME_SYNC and successful RET of the last root, a
|
||||
[Random objects](02e-vm-owned-random-core.md) use ObjectKind tag 9 (tag 6 remains reserved), 32 logical payload bytes and quota-accounted headers/handles/auxiliary storage. They are opaque GC leaves; Dynamic holds their direct reference and exact TypeId.
|
||||
|
||||
|
||||
## Prepared storage publication
|
||||
## Prepared array range copy
|
||||
|
||||
Generic complete-group transfer/publication reserves its copy scratch against
|
||||
TemporaryBytes before changing any destination. Source groups preserve Dynamic
|
||||
presence tags and immutable box/native owner/reference identities. Operands remain
|
||||
roots throughout preparation; the commit phase has no allocation, GC, scheduler or
|
||||
callback boundary. Refusal changes neither destinations nor input groups, and
|
||||
releases temporary reservations. Consumer return carriers must be prepared before
|
||||
publication. See [the instruction contract](02c-program-registry-and-pbx-v0.md#logical-guards-and-atomic-storage-publication).
|
||||
ARRAY_COPY reserves all copy scratch against TemporaryBytes and captures complete
|
||||
source groups before changing any destination. Preserve Dynamic tags, immutable
|
||||
boxes, native String owners, HeapRefs and trait groups without boxing or new guest
|
||||
objects/request tokens. Operands remain roots; commit has no allocation, fallible
|
||||
validation, callback, GC or scheduler boundary. No rescue GC is performed.
|
||||
Failure preserves destinations and operands and releases provisional scratch;
|
||||
success also releases scratch, then consumes the five operands. Charged cycles
|
||||
are never refunded. Overlap reads the pre-attempt source sequence, without an
|
||||
identity discount. Earlier instructions retain their effects; multiple ordinary
|
||||
stores do not form a transaction. See [the instruction contract](02-vm-instruction-set.md#typed-array-range-copy).
|
||||
|
||||
## Borrowed intrinsic invocation
|
||||
|
||||
|
||||
@@ -204,10 +204,14 @@ The [Program Registry contract](../specs/runtime/02c-program-registry-and-pbx-v0
|
||||
See the [random contract](../specs/runtime/02e-vm-owned-random-core.md) for Random BuiltinId 0x0016, ObjectKind tag 9, intrinsics 0x4000–0x4003, atomic state mutation, bounded 4+8*N costs and rejection-limit trap 0x00000015. Random is managed by the VM heap and existing GC, without host entropy or PBX changes.
|
||||
|
||||
|
||||
## Atomic publication of multiple Struct instances
|
||||
## Typed array range copy
|
||||
|
||||
FIELDS_PUBLISH (0xAB) atomically publishes complete typed fields to multiple
|
||||
source-selected Struct destinations. Its schema is an ordinary Registry Struct;
|
||||
no new category, request object, syscall or safepoint is introduced. Exact nullable
|
||||
destination rules, stack effects, validation, costs and commit semantics are in the
|
||||
[canonical instruction contract](../specs/runtime/02-vm-instruction-set.md#atomic-publication-of-multiple-struct-instances).
|
||||
ARRAY_COPY (0xA9) copies complete groups between exact typed arrays with strict
|
||||
physical ranges and pre-attempt overlap semantics. Preparation reserves scratch
|
||||
before infallible commit; failures preserve operands/destinations and retain
|
||||
charged work. No callbacks, GC or scheduling occur inside the instruction.
|
||||
The [instruction contract](../specs/runtime/02-vm-instruction-set.md#typed-array-range-copy)
|
||||
defines encoding, fault order and early cost selection. ARRAY_LEN remains the
|
||||
physical query; producer algorithms own logical limits and multi-owner invariants.
|
||||
There is no transactional sequence of stores. Encodings 0xA7/0xA8/0xAA/0xAB are
|
||||
unsupported, including in dead code.
|
||||
|
||||
+10
-15
@@ -192,22 +192,17 @@ STRUCT_NEW (0x00A0), STRUCT_GET (0x00A1), STRUCT_SET (0x00A2), ARRAY_NEW (0x00A3
|
||||
See the [random contract](../specs/runtime/02e-vm-owned-random-core.md) for Random BuiltinId 0x0016, ObjectKind tag 9, intrinsics 0x4000–0x4003, atomic state mutation, bounded 4+8*N costs and rejection-limit trap 0x00000015. Random is managed by the VM heap and existing GC, without host entropy or PBX changes.
|
||||
|
||||
|
||||
## Logical guards and atomic storage publication
|
||||
## Typed array range copy
|
||||
|
||||
INDEX_GUARD (0xA7), ARRAY_CHECK_LENGTH (0xA8), ARRAY_COPY (0xA9) and
|
||||
STORAGE_PUBLISH (0xAA) provide generic logical validation, complete stored-group
|
||||
transfer and prepared atomic publication. Their encoding, typed operands, exact
|
||||
faults, overlap semantics, costs and preflight/commit guarantees are defined by
|
||||
the [canonical instruction contract](../specs/runtime/02-vm-instruction-set.md#logical-guards-and-atomic-storage-publication). No new Registry category, syscall, collection algorithm or safepoint is introduced.
|
||||
|
||||
|
||||
## Atomic publication of multiple Struct instances
|
||||
|
||||
FIELDS_PUBLISH (0xAB) atomically publishes complete typed fields to multiple
|
||||
source-selected Struct destinations. Its schema is an ordinary Registry Struct;
|
||||
no new category, request object, syscall or safepoint is introduced. Exact nullable
|
||||
destination rules, stack effects, validation, costs and commit semantics are in the
|
||||
[canonical instruction contract](../specs/runtime/02-vm-instruction-set.md#atomic-publication-of-multiple-struct-instances).
|
||||
ARRAY_COPY (0xA9, Array TypeId u32) consumes source, sourceStart, target,
|
||||
targetStart, count without a result. Complete groups and owners survive overlap
|
||||
and failed preparation. Charge 4+2*N*W before ordinary validation for available
|
||||
Int64 count in 0..u32::MAX; other counts/underflow charge base 4. Checked cost
|
||||
overflow charges base and traps SizeOverflow. The
|
||||
[canonical contract](../specs/runtime/02-vm-instruction-set.md#typed-array-range-copy)
|
||||
defines fault precedence, scratch and commit. ARRAY_LEN (0xA4) and physical array
|
||||
checks remain. Encodings 0xA7/0xA8/0xAA/0xAB reject at load even in dead code;
|
||||
no replacement publication/guard or transaction is provided.
|
||||
|
||||
## Identity/hash and catalog schema 2
|
||||
|
||||
|
||||
@@ -0,0 +1,63 @@
|
||||
# Storage ISA qualification
|
||||
|
||||
This record qualifies the working-tree delivery over baseline `69ad1931de1e12e59c2268f94aa906aed114fb6d` on
|
||||
macOS-27.0.1-arm64-arm-64bit-Mach-O with `rustc 1.98.1 (48a229cea 2026-09-01)`. The baseline commit alone does
|
||||
not contain the changes. No new provider revision is claimed. Source/test/spec
|
||||
SHA-256 fingerprints and exact test commands are stored in
|
||||
[the qualification manifest](storage-qualification.json).
|
||||
|
||||
## Delivered behavior
|
||||
|
||||
Encodings 0xA7/0xA8/0xAA/0xAB are unsupported at real instruction boundaries,
|
||||
including dead code. ARRAY_LEN stays 0xA4 and ARRAY_COPY stays 0xA9. The
|
||||
[copy contract](../specs/runtime/02-vm-instruction-set.md#typed-array-range-copy)
|
||||
defines strict ranges, complete groups/owners, snapshot overlap and precharged
|
||||
4+2*N*W work for calculable counts, including receiver/range/scratch refusal.
|
||||
No replacement publication, guard or transaction was introduced.
|
||||
|
||||
## Verification
|
||||
|
||||
`make ci-domains` passed: formatting, workspace Clippy with warnings denied,
|
||||
workspace tests/all features, all five debugger socket tests, LLVM coverage,
|
||||
coverage ownership audit and all 15 unchanged domain gates.
|
||||
|
||||
| Run | Passed | Ignored |
|
||||
| --- | ---: | ---: |
|
||||
| Workspace/all targets/all features | 1095 | 13 |
|
||||
| Debugger sockets (explicit ignored selection) | 5 | 0 |
|
||||
| LLVM coverage/workspace/all features | 1095 | 13 |
|
||||
| VM release | 400 | 2 |
|
||||
| VM diagnostics checkpoint | 407 | 2 |
|
||||
| Layer and quality suites | 19 | 0 |
|
||||
|
||||
The diagnostics checkpoint preceded test-only fixture import/Copy cleanup; the
|
||||
final all-features workspace and coverage runs include diagnostics on final code.
|
||||
No identity/hash semantic change was made. Default ignored measurement probes,
|
||||
audio probes and packaged-installation smoke remain explicit exclusions. The
|
||||
five debugger socket tests were executed separately and passed; sandbox-local
|
||||
binding had first been denied, so the complete successful gate ran with approval
|
||||
outside the sandbox. Coverage gates were not lowered or skipped.
|
||||
|
||||
Independent bytecode and serialized PBX tests prove decoder/admission rejection
|
||||
without treating immediate/data bytes as instructions. VM tests cover cost/fault
|
||||
precedence, frame temporary floors, empty and overlapping ranges, native and
|
||||
multislot groups, aliases, scratch quota and allocation refusal, late source-group
|
||||
failure, operand/destination preservation, native owners and roots through GC,
|
||||
zero budget, overshoot and successful-step accounting.
|
||||
|
||||
Overflow defense uses synthetic widths to exercise checked multiplication and
|
||||
addition. It does not imply such widths are accepted Registry layouts. Internal
|
||||
corruption tests are labeled separately from admitted-program evidence. There
|
||||
are no JavaScript/Lua engines or frontend fixtures in this qualification.
|
||||
|
||||
Local full logs and the domain audit are under `target/qualification/storage/`;
|
||||
the manifest records their digests. Generated logs/LLVM output are reproducible
|
||||
local evidence, not a runtime or SDK API.
|
||||
|
||||
## Consumer boundary
|
||||
|
||||
The [producer handoff](collection-producer-handoff.md) describes required compiler
|
||||
emission and SDK algorithm/contract changes. Existing consumer evidence still
|
||||
qualifies its original provider only. Compiler/SDK migration, provider pin/catalog
|
||||
import, installed resources and normal/optimized source conformance require
|
||||
consumer-owned delivery and are not claimed here.
|
||||
@@ -15,6 +15,7 @@ Opcodes are little-endian u16, followed by little-endian u32 immediates. TypeId
|
||||
| ARRAY_LEN | 0xA4 | TypeId | ref → Int64 length |
|
||||
| ARRAY_GET | 0xA5 | TypeId | ref, Int64 index → complete element group |
|
||||
| ARRAY_SET | 0xA6 | TypeId | ref, Int64 index, complete element group → [] |
|
||||
| ARRAY_COPY | 0xA9 | TypeId | source, sourceStart, target, targetStart, count → [] |
|
||||
|
||||
The single-immediate forms are six bytes; field forms are ten. Width is one for scalar/String/color/concrete references, two for vec2/Trait/Dynamic, three for pixel. A Trait contains receiver then ImplementationId; Dynamic contains TypeId then payload. Preserve the whole group, including absent [Null, Null]. ImplementationId zero is valid. GET does not implicitly box; Dynamic copies share immutable boxes. NEW initializes canonical defaults without constructing referenced instances. Arrays have fixed lengths. SDKs implement List, Set and Map algorithms using these runtime capabilities.
|
||||
|
||||
@@ -58,7 +59,7 @@ Static bad IDs/categories/fields reject load with typed LOAD_INVALID_REFERENCE c
|
||||
|
||||
## Consumer integration and evidence
|
||||
|
||||
Consumers must recognize all seven encodings, invoke Registry-derived effects in bounded structural/height/type verification and use validated-image execution. The metadata-free verifier and legacy decoder have been removed. Reuse compact typed storage, default initialization, native ownership maps and generational handles; do not replace them with raw Value arrays or SDK container implementations.
|
||||
Consumers must recognize all eight encodings, invoke Registry-derived effects in bounded structural/height/type verification and use validated-image execution. The metadata-free verifier and legacy decoder have been removed. Reuse compact typed storage, default initialization, native ownership maps and generational handles; do not replace them with raw Value arrays or SDK container implementations.
|
||||
|
||||
Executable oracles live in bytecode `tests/registry_isa.rs`, VM `tests/collection_conformance.rs`, VM `virtual_machine/collections_tests.rs` and layer `tests/typed_collections.rs`. They cover independent bytes, default/alias/group operations, attempt costs and refusals, malformed/proven types, ownership and actual FRAME_SYNC graph reclamation. VM unit tests inject otherwise unreachable invalid state only inside tests. Optimized ownership/conformance runs complement debug evidence.
|
||||
|
||||
@@ -70,3 +71,40 @@ never invokes callbacks. Threshold GC runs at FRAME_SYNC and successful last-roo
|
||||
RET after rooting results. Quota refusal cannot invoke rescue GC.
|
||||
|
||||
The published patterns and validation limits are explained in [Collection Attempts Preserve Groups and Charge Work Before Publication](../../discussion/lessons/DSC-0051-game-state-collections-and-objects/LSN-0060-collection-attempts-preserve-groups-and-charge-work-before-publication.md).
|
||||
|
||||
## Range-copy migration contract
|
||||
|
||||
ARRAY_LEN stays 0xA4. ARRAY_COPY is six bytes: `A9 00 04 03 02 01` for encoding
|
||||
oracle TypeId 0x01020304. Actual execution needs an existing exact Array descriptor.
|
||||
The five operands use Int64 offsets/count and exact Array receivers. Physical
|
||||
ranges are strict; an empty range may start at length. Copy snapshots complete
|
||||
source groups before writing, preserving tags, native owners and identity under
|
||||
overlap without boxing. Reserve complete TemporaryBytes scratch first; release it
|
||||
on success/failure. Failed attempts preserve operands/storage; no request token,
|
||||
guest object, callback, GC or scheduler occurs inside the instruction.
|
||||
|
||||
For available five temporary operands and exact Int64 count N in 0..u32::MAX,
|
||||
precharge representable C=4+2*N*W before receiver/range/group validation or scratch
|
||||
reservation. Retain it on refusal: N=10/W=1 costs 24 for success, bad receiver,
|
||||
bad range or scratch quota. Other counts/underflow cost base 4 with normal fault
|
||||
order. Checked cost overflow costs 4 and traps SizeOverflow before ordinary
|
||||
validation. Empty copies validate receivers/ranges and cost 4; aliases give no
|
||||
discount. See the [copy contract](../specs/runtime/02-vm-instruction-set.md#typed-array-range-copy)
|
||||
for exact precedence. Positive budget admits the full attempt with overshoot;
|
||||
Trap wins on refusal and only successful steps count. Zero budget does no work.
|
||||
|
||||
Encodings 0xA7, 0xA8, 0xAA and 0xAB are unsupported in actual instruction
|
||||
positions, including dead code. They are not remapped or emulated. Producers
|
||||
must remove their emission, adapt logical checks/error paths and re-evaluate
|
||||
algorithms, representations and collection guarantees. Sequential stores do not
|
||||
preserve the former multi-owner publication guarantee. Prepare fallible values
|
||||
before mutation and explicitly define the remaining source contract.
|
||||
|
||||
Compiler/SDK migration, provider pinning/catalog import and source/optimized/
|
||||
installed-resource conformance belong to the consumer. Prior List/Linked evidence
|
||||
qualifies earlier providers only. Identity/hash catalog schema 2 import is a
|
||||
separate consumer dependency, not a storage or new-collection implementation here.
|
||||
See `virtual_machine/array_copy_tests.rs` and collection/Registry conformance for
|
||||
current executable oracles. Qualification provenance is recorded in
|
||||
[storage qualification](STORAGE_QUALIFICATION.md); an uncommitted implementation
|
||||
must not be attributed to an earlier committed provider SHA.
|
||||
|
||||
@@ -0,0 +1,357 @@
|
||||
{
|
||||
"schema_version": 1,
|
||||
"qualified_at_utc": "2026-10-23T22:32:12.156934+00:00",
|
||||
"base_revision": "69ad1931de1e12e59c2268f94aa906aed114fb6d",
|
||||
"delivery_state": "uncommitted working tree; fingerprints identify this delivery, not base_revision alone",
|
||||
"platform": "macOS-27.0.1-arm64-arm-64bit-Mach-O",
|
||||
"rustc": "rustc 1.98.1 (48a229cea 2026-09-01)",
|
||||
"gate": "make ci-domains",
|
||||
"gate_status": "passed",
|
||||
"execution": "Approved outside sandbox: debugger localhost sockets are blocked in sandbox.",
|
||||
"checks": [
|
||||
{
|
||||
"command": "cargo test --workspace --all-targets --all-features --no-fail-fast",
|
||||
"status": "passed",
|
||||
"passed": 1095,
|
||||
"failed": 0,
|
||||
"ignored": 13
|
||||
},
|
||||
{
|
||||
"command": "cargo test -p prometeu-host-desktop-winit --lib runner::tests -- --ignored",
|
||||
"status": "passed",
|
||||
"passed": 5,
|
||||
"failed": 0,
|
||||
"ignored": 0
|
||||
},
|
||||
{
|
||||
"command": "cargo llvm-cov --workspace --all-features --html --output-dir target/llvm-cov",
|
||||
"status": "passed",
|
||||
"passed": 1095,
|
||||
"failed": 0,
|
||||
"ignored": 13
|
||||
},
|
||||
{
|
||||
"command": "cargo test --locked --offline -p prometeu-vm --release --no-fail-fast",
|
||||
"status": "passed",
|
||||
"passed": 400,
|
||||
"failed": 0,
|
||||
"ignored": 2
|
||||
},
|
||||
{
|
||||
"command": "cargo test --locked --offline -p prometeu-vm --features resource-diagnostics --no-fail-fast",
|
||||
"status": "passed",
|
||||
"phase": "Before Clippy-only fixture import/Copy cleanup; final all-features workspace and coverage also include diagnostics.",
|
||||
"passed": 407,
|
||||
"failed": 0,
|
||||
"ignored": 2
|
||||
},
|
||||
{
|
||||
"command": "cargo test --locked --offline -p prometeu-layer-tests -p prometeu-quality-checks --no-fail-fast",
|
||||
"status": "passed",
|
||||
"passed": 19,
|
||||
"failed": 0,
|
||||
"ignored": 0
|
||||
}
|
||||
],
|
||||
"coverage": {
|
||||
"system/os": {
|
||||
"source_files": 19,
|
||||
"report_files": 10,
|
||||
"lines_count": 1711,
|
||||
"lines_covered": 1410,
|
||||
"functions": {
|
||||
"count": 239,
|
||||
"covered": 184
|
||||
},
|
||||
"regions": {
|
||||
"count": 2976,
|
||||
"covered": 2514
|
||||
},
|
||||
"baseline_percent": 77.24,
|
||||
"line_percent": 82.4,
|
||||
"gate_passed": true
|
||||
},
|
||||
"system/runtime": {
|
||||
"source_files": 14,
|
||||
"report_files": 12,
|
||||
"lines_count": 3309,
|
||||
"lines_covered": 2762,
|
||||
"functions": {
|
||||
"count": 250,
|
||||
"covered": 224
|
||||
},
|
||||
"regions": {
|
||||
"count": 5722,
|
||||
"covered": 4655
|
||||
},
|
||||
"baseline_percent": 76.19,
|
||||
"line_percent": 83.46,
|
||||
"gate_passed": true
|
||||
},
|
||||
"system/fs": {
|
||||
"source_files": 13,
|
||||
"report_files": 9,
|
||||
"lines_count": 2469,
|
||||
"lines_covered": 1944,
|
||||
"functions": {
|
||||
"count": 249,
|
||||
"covered": 204
|
||||
},
|
||||
"regions": {
|
||||
"count": 4450,
|
||||
"covered": 3401
|
||||
},
|
||||
"baseline_percent": 76.08,
|
||||
"line_percent": 78.73,
|
||||
"gate_passed": true
|
||||
},
|
||||
"system/programs": {
|
||||
"source_files": 3,
|
||||
"report_files": 1,
|
||||
"lines_count": 567,
|
||||
"lines_covered": 556,
|
||||
"functions": {
|
||||
"count": 54,
|
||||
"covered": 52
|
||||
},
|
||||
"regions": {
|
||||
"count": 854,
|
||||
"covered": 834
|
||||
},
|
||||
"baseline_percent": 93.05,
|
||||
"line_percent": 98.05,
|
||||
"gate_passed": true
|
||||
},
|
||||
"asset/bank": {
|
||||
"source_files": 8,
|
||||
"report_files": 7,
|
||||
"lines_count": 3434,
|
||||
"lines_covered": 3176,
|
||||
"functions": {
|
||||
"count": 303,
|
||||
"covered": 269
|
||||
},
|
||||
"regions": {
|
||||
"count": 5718,
|
||||
"covered": 5306
|
||||
},
|
||||
"baseline_percent": 86.76,
|
||||
"line_percent": 92.48,
|
||||
"gate_passed": true
|
||||
},
|
||||
"firmware": {
|
||||
"source_files": 16,
|
||||
"report_files": 11,
|
||||
"lines_count": 2314,
|
||||
"lines_covered": 1990,
|
||||
"functions": {
|
||||
"count": 139,
|
||||
"covered": 127
|
||||
},
|
||||
"regions": {
|
||||
"count": 4255,
|
||||
"covered": 3791
|
||||
},
|
||||
"baseline_percent": 83.2,
|
||||
"line_percent": 85.99,
|
||||
"gate_passed": true
|
||||
},
|
||||
"host-dependent": {
|
||||
"source_files": 13,
|
||||
"report_files": 13,
|
||||
"lines_count": 2393,
|
||||
"lines_covered": 1531,
|
||||
"functions": {
|
||||
"count": 203,
|
||||
"covered": 136
|
||||
},
|
||||
"regions": {
|
||||
"count": 4011,
|
||||
"covered": 2599
|
||||
},
|
||||
"baseline_percent": 40.05,
|
||||
"line_percent": 63.97,
|
||||
"gate_passed": true
|
||||
},
|
||||
"host/headless": {
|
||||
"source_files": 6,
|
||||
"report_files": 3,
|
||||
"lines_count": 855,
|
||||
"lines_covered": 739,
|
||||
"functions": {
|
||||
"count": 93,
|
||||
"covered": 69
|
||||
},
|
||||
"regions": {
|
||||
"count": 1451,
|
||||
"covered": 1246
|
||||
},
|
||||
"baseline_percent": 83.39,
|
||||
"line_percent": 86.43,
|
||||
"gate_passed": true
|
||||
},
|
||||
"vm/core": {
|
||||
"source_files": 64,
|
||||
"report_files": 47,
|
||||
"lines_count": 10137,
|
||||
"lines_covered": 9028,
|
||||
"functions": {
|
||||
"count": 945,
|
||||
"covered": 774
|
||||
},
|
||||
"regions": {
|
||||
"count": 19226,
|
||||
"covered": 17054
|
||||
},
|
||||
"baseline_percent": 84.29,
|
||||
"line_percent": 89.05,
|
||||
"gate_passed": true
|
||||
},
|
||||
"bytecode": {
|
||||
"source_files": 19,
|
||||
"report_files": 14,
|
||||
"lines_count": 3374,
|
||||
"lines_covered": 3157,
|
||||
"functions": {
|
||||
"count": 299,
|
||||
"covered": 243
|
||||
},
|
||||
"regions": {
|
||||
"count": 5909,
|
||||
"covered": 5070
|
||||
},
|
||||
"baseline_percent": 88.26,
|
||||
"line_percent": 93.56,
|
||||
"gate_passed": true
|
||||
},
|
||||
"hal/core": {
|
||||
"source_files": 59,
|
||||
"report_files": 27,
|
||||
"lines_count": 2369,
|
||||
"lines_covered": 2093,
|
||||
"functions": {
|
||||
"count": 264,
|
||||
"covered": 227
|
||||
},
|
||||
"regions": {
|
||||
"count": 3341,
|
||||
"covered": 3035
|
||||
},
|
||||
"baseline_percent": 83.56,
|
||||
"line_percent": 88.34,
|
||||
"gate_passed": true
|
||||
},
|
||||
"drivers/core": {
|
||||
"source_files": 13,
|
||||
"report_files": 12,
|
||||
"lines_count": 3107,
|
||||
"lines_covered": 2775,
|
||||
"functions": {
|
||||
"count": 347,
|
||||
"covered": 307
|
||||
},
|
||||
"regions": {
|
||||
"count": 4756,
|
||||
"covered": 4123
|
||||
},
|
||||
"baseline_percent": 79.51,
|
||||
"line_percent": 89.31,
|
||||
"gate_passed": true
|
||||
},
|
||||
"system/core": {
|
||||
"source_files": 12,
|
||||
"report_files": 7,
|
||||
"lines_count": 1444,
|
||||
"lines_covered": 1353,
|
||||
"functions": {
|
||||
"count": 171,
|
||||
"covered": 163
|
||||
},
|
||||
"regions": {
|
||||
"count": 2318,
|
||||
"covered": 2184
|
||||
},
|
||||
"baseline_percent": 87.71,
|
||||
"line_percent": 93.69,
|
||||
"gate_passed": true
|
||||
},
|
||||
"tooling": {
|
||||
"source_files": 8,
|
||||
"report_files": 8,
|
||||
"lines_count": 612,
|
||||
"lines_covered": 396,
|
||||
"functions": {
|
||||
"count": 41,
|
||||
"covered": 31
|
||||
},
|
||||
"regions": {
|
||||
"count": 947,
|
||||
"covered": 621
|
||||
},
|
||||
"baseline_percent": 59.75,
|
||||
"line_percent": 64.7,
|
||||
"gate_passed": true
|
||||
},
|
||||
"dev/test-support": {
|
||||
"source_files": 4,
|
||||
"report_files": 2,
|
||||
"lines_count": 115,
|
||||
"lines_covered": 99,
|
||||
"functions": {
|
||||
"count": 17,
|
||||
"covered": 13
|
||||
},
|
||||
"regions": {
|
||||
"count": 131,
|
||||
"covered": 112
|
||||
},
|
||||
"baseline_percent": 80.96,
|
||||
"line_percent": 86.08,
|
||||
"gate_passed": true
|
||||
}
|
||||
},
|
||||
"fingerprints_sha256": {
|
||||
"crates/console/prometeu-bytecode/src/assembler.rs": "ae718b0881fef0b10bb8a0f5e56c348e13796b1133e2639b7fbd8683faff0792",
|
||||
"crates/console/prometeu-bytecode/src/decoder.rs": "032e9e7606b68c4d722518e7d4e97eac7fa5feecc78453a41ee8e2e14f8b87d9",
|
||||
"crates/console/prometeu-bytecode/src/disassembler.rs": "f5e47a2b0f0595b628f17816ffd2728d48ef92c65aa926ea1aaf7c38fe7a63ec",
|
||||
"crates/console/prometeu-bytecode/src/opcode.rs": "3392129a50e365445439c9c76e379650a474f492df6f4878fe87fee7172630e2",
|
||||
"crates/console/prometeu-bytecode/src/opcode_spec.rs": "d2e74d88d68a223e4411ccc159f8003db21d05428511add13016aaa862a66883",
|
||||
"crates/console/prometeu-bytecode/src/registry_instruction.rs": "8bd4d3928f4e85674877be5398279988641da17be203a323edce8df795639f47",
|
||||
"crates/console/prometeu-bytecode/tests/registry_isa.rs": "0a61b8e1ba6054dab542acc6b2c320e8ab9140375fc12780350a75395b10d87a",
|
||||
"crates/console/prometeu-vm/src/registry_verifier.rs": "985446f71017625266483be539514f8a74c61ffcf3a21e5676bd67620ae3575f",
|
||||
"crates/console/prometeu-vm/src/registry_verifier/types.rs": "6776bf04c49f8f9738a1be293d775493557b0d8ba035bf525a1e9aec1323047b",
|
||||
"crates/console/prometeu-vm/src/virtual_machine.rs": "cfa594d54109bfcdca6e138bb287db6d20a003ea3248cf1970eb6c926def9729",
|
||||
"crates/console/prometeu-vm/src/virtual_machine/array_copy.rs": "122bb20f9041f22a46d7e23398d016fbe365fe93834878a9d6fcc4f4c4b36c1b",
|
||||
"crates/console/prometeu-vm/src/virtual_machine/array_copy_tests.rs": "e0afba27cee5bd94772c1a53498dc7a4185f9a0642b7f029378ed2c0f3be5d12",
|
||||
"crates/console/prometeu-vm/src/virtual_machine/collections_tests.rs": "90ba1cba0d37b2213f0fa13de2b16c04515a5c1d33e858118768a448b06b6c8b",
|
||||
"crates/console/prometeu-vm/src/virtual_machine/identity_tests.rs": "ce3501539df309f154bb1f46f7d72c450cb87c71b9d21a7ca86fc3fcc63a6c44",
|
||||
"crates/console/prometeu-vm/tests/collection_conformance.rs": "bcb40dcd9dc650ffd1234fc4eeb6799742dc7a8f60536126543d6a2db6f37128",
|
||||
"discussion/lessons/DSC-0065-vm-storage-publication-neutrality/LSN-0072-primitives-need-independent-semantics-and-failed-attempts-still-cost-work.md": "a55d2d5f2487301f9b3d18c81c9112a4ad4f104a967e20df849fd3c722aadf3c",
|
||||
"docs/specs/runtime/01-time-model-and-cycles.md": "6c1ba3e023521d5593edb8aefd20f3d6d09fdec5be23d89487871df339f0359f",
|
||||
"docs/specs/runtime/02-vm-instruction-set.md": "26bf012681f6e96ff793e0541f6685c3e15df899ac2b04b62edbe70a4a116726",
|
||||
"docs/specs/runtime/02c-program-registry-and-pbx-v0.md": "e5a42d1aab637467dacde624f2662a615b74fbb3b5111fc437ef1bd0aeffb149",
|
||||
"docs/specs/runtime/03-memory-stack-heap-and-allocation.md": "96bf0859ecfc949390a159166673a7bfa0ad83c651138c5b8d28c87229a5669a",
|
||||
"docs/vm-arch/ARCHITECTURE.md": "d7e3487bb2d9718bba810cf4cfaec175dcbf9b079f7df12a4fad537bd1606146",
|
||||
"docs/vm-arch/ISA_CORE.md": "6b3207f81d3bd782e4f9b445b19c80b64bc599d8aebc5f01d8627a477bd09c8b",
|
||||
"docs/vm-arch/collection-producer-handoff.md": "47e6117fd7585b10927090519c72c8476ea5f4800e5777d201f536fd9a05dc91"
|
||||
},
|
||||
"removed_files": [
|
||||
"crates/console/prometeu-vm/src/virtual_machine/storage_publication.rs",
|
||||
"crates/console/prometeu-vm/src/virtual_machine/storage_publication_tests.rs"
|
||||
],
|
||||
"local_evidence_sha256": {
|
||||
"target/qualification/storage/ci.log": "36adf2b1407ada9101d0b1b94011d870116964dd44655a0694221a4a541ae91d",
|
||||
"target/qualification/storage/diagnostics.log": "8b51fbfd18083b0b49831109c61e29687e799ce0d654711be74caad95f4c7762",
|
||||
"target/qualification/storage/domain-audit.json": "4a08f40ff6d73d5e1b3f405e3cb5556117fb3a6667c58a067e6db71274649189",
|
||||
"target/qualification/storage/layers.log": "6d2a15c2fd90b86050ccb9b92b2f74670fe73f0165ff7b2cef01fdc3afcf12b6",
|
||||
"target/qualification/storage/release.log": "1d9e946e90dfc3d2f3e64af0a1099437cdf85cf9a2ef149ab80189082ca4da25"
|
||||
},
|
||||
"limits": [
|
||||
"No new provider commit is claimed; consumers must select and qualify a revision containing the delivery.",
|
||||
"Consumer compiler/SDK migration is not executed by runtime qualification.",
|
||||
"Cost arithmetic overflow uses synthetic-width defense tests, not an admitted wide Registry.",
|
||||
"Malformed internal-state injection tests are distinct from admitted PBX conformance.",
|
||||
"Default ignored probes/packaged-installation smoke remain explicitly ignored; five debugger socket tests were separately executed.",
|
||||
"Clippy cleanup shares collection fixture imports and removes redundant Copy clones in identity tests without changing identity/hash contracts."
|
||||
]
|
||||
}
|
||||
Reference in New Issue
Block a user