From 8105604f9210468fc61950b124cdd7adf58daaf0 Mon Sep 17 00:00:00 2001 From: bQUARKz Date: Sun, 25 Oct 2026 12:14:48 +0000 Subject: [PATCH] feat(pbs): add Set and reusable identity hashing --- ...eusable-identity-and-source-set-buckets.md | 218 ++ .../DSC-0092-pbs-sdk-set/evidence/README.md | 156 ++ .../DSC-0092-pbs-sdk-set/evidence/SHA256SUMS | 19 + .../evidence/conformance-debug.log.gz | Bin 0 -> 12362 bytes .../evidence/conformance-release.log.gz | Bin 0 -> 12351 bytes .../evidence/distribution-tests.log.gz | Bin 0 -> 822 bytes .../evidence/environment.txt | 32 + .../evidence/fixtures.sha256.gz | Bin 0 -> 41596 bytes .../evidence/gradle-results.json | 1765 +++++++++++++++++ .../evidence/hashing-conformance.log.gz | Bin 0 -> 2511 bytes .../evidence/hashing-tests.log.gz | Bin 0 -> 717 bytes .../evidence/provider-catalog.log.gz | Bin 0 -> 895 bytes .../evidence/provider-hash-remaining.log.gz | Bin 0 -> 1381 bytes .../evidence/provider-identity-debug.log.gz | Bin 0 -> 830 bytes .../provider-identity-private-debug.log.gz | Bin 0 -> 569 bytes .../evidence/regression.log.gz | Bin 0 -> 1068 bytes .../evidence/set-conformance.log.gz | Bin 0 -> 3603 bytes .../evidence/set-tests.log.gz | Bin 0 -> 696 bytes .../evidence/source.sha256 | 39 + .../evidence/workflow.txt | 10 + .../general/specs/runtime-catalog-support.md | 8 + .../specs/typed-registry-and-pbx-v0.md | 14 + docs/compiler/pbs/specs/generic-contracts.md | 2 +- .../compiler/pbs/specs/sdk-list-and-cursor.md | 7 +- .../pbs/specs/sdk-set-and-identity.md | 242 +++ docs/specs/compiler-languages/pbs/README.md | 10 +- .../app/compiler/InstalledKnowledgeProbe.java | 18 + .../backend/irvm/PbsIdentityHashingTest.java | 134 ++ .../backend/irvm/PbsListCursorTest.java | 11 +- .../compiler/backend/irvm/PbsSetTest.java | 404 ++++ .../test/resources/hash/hash-conformance.tsv | 119 ++ .../src/test/resources/hash/provenance.txt | 5 + .../studio/compiler/pbs/PbsContractTypes.java | 6 +- .../compiler/pbs/PbsGenericInstantiation.java | 30 +- .../pbs/PbsGenericTemplateValidator.java | 21 +- .../compiler/pbs/PbsSdkCollections.java | 20 + .../lowering/PbsExecutableBodyLowerer.java | 69 +- .../pbs/lowering/PbsRuntimeTypes.java | 8 + .../pbs/parser/PbsDeclarationParser.java | 4 +- .../semantics/PbsEditorialSupportService.java | 4 +- .../semantics/PbsFlowExpressionAnalyzer.java | 6 + .../pbs/semantics/PbsFlowSemanticSupport.java | 10 + .../game/stdlib/1/sdk/collections/main.pbs | 193 ++ .../game/stdlib/1/sdk/collections/mod.barrel | 2 + .../resources/game/stdlib/1/sdk/hash/main.pbs | 26 + .../game/stdlib/1/sdk/hash/mod.barrel | 3 + .../examples/game/1/src/hashing.pbs | 19 + .../examples/game/1/src/mod.barrel | 2 + .../examples/game/1/src/sets.pbs | 25 + .../compiler/pbs/PbsGenericStructsTest.java | 32 +- .../semantics/PbsListCursorEditorialTest.java | 6 +- .../bytecode/BytecodeOpcodeLayout.java | 4 +- .../BytecodePreloadVerifierService.java | 4 + .../registry/RegistryInstructionLowerer.java | 13 + .../registry/IdentityHashingPipelineTest.java | 108 + .../registry/IRRegistryInstruction.java | 3 +- tools/pbx-conformance/README.md | 59 +- tools/pbx-conformance/main.rs | 326 ++- tools/pbx-conformance/run.py | 8 +- 59 files changed, 4190 insertions(+), 34 deletions(-) create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/LSN-0093-reusable-identity-and-source-set-buckets.md create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/README.md create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/SHA256SUMS create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/conformance-debug.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/conformance-release.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/distribution-tests.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/environment.txt create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/fixtures.sha256.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/gradle-results.json create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/hashing-conformance.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/hashing-tests.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/provider-catalog.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/provider-hash-remaining.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/provider-identity-debug.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/provider-identity-private-debug.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/regression.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/set-conformance.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/set-tests.log.gz create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/source.sha256 create mode 100644 discussion/lessons/DSC-0092-pbs-sdk-set/evidence/workflow.txt create mode 100644 docs/compiler/pbs/specs/sdk-set-and-identity.md create mode 100644 prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsIdentityHashingTest.java create mode 100644 prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsSetTest.java create mode 100644 prometeu-architecture-tests/src/test/resources/hash/hash-conformance.tsv create mode 100644 prometeu-architecture-tests/src/test/resources/hash/provenance.txt create mode 100644 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/hash/main.pbs create mode 100644 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/hash/mod.barrel create mode 100644 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/hashing.pbs create mode 100644 prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/sets.pbs create mode 100644 prometeu-compiler/prometeu-build-pipeline/src/test/java/p/studio/compiler/backend/registry/IdentityHashingPipelineTest.java diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/LSN-0093-reusable-identity-and-source-set-buckets.md b/discussion/lessons/DSC-0092-pbs-sdk-set/LSN-0093-reusable-identity-and-source-set-buckets.md new file mode 100644 index 00000000..c02d8f9e --- /dev/null +++ b/discussion/lessons/DSC-0092-pbs-sdk-set/LSN-0093-reusable-identity-and-source-set-buckets.md @@ -0,0 +1,218 @@ +--- +id: LSN-0093 +ticket: pbs-sdk-set +title: Reusable identity and source Set buckets +created: 2026-10-25 +tags: [compiler-pbs, collections, hashing, identity, runtime-integration] +--- + +## Original problem and ownership + +Owner: `compiler/pbs`; propagation: `compiler` and `vm-arch`. + +Set needed a precise equality policy before membership could become an executable +SDK algorithm. Mutable objects must retain instance identity by default, while an +explicit strategy can intentionally merge distinct objects by content. Importing +hash metadata alone did not make source hashing, typed reference queries or Set +available to PBS consumers. + +AGD-0094 converged into accepted DEC-0078 and implementation PLN-0156. The user +accepted the recommendations, authorized the decision and plan, and requested +implementation. These identifiers record provenance; normative behavior now lives +in the [Set/Identity specification](../../../docs/compiler/pbs/specs/sdk-set-and-identity.md). +Completed workflow scaffolding is removed by the discussion CLI. + +The runtime provider is `dcf6561ea73446e0a3e1cf1c73eda20923b38df0`, consumed +unchanged. No runtime source, documentation, catalog, manifest, lockfile or commit +was changed. Cargo projects/targets used for qualification live outside its +checkout. Ordinary Studio builds use versioned local SDK/catalog resources. + +## Consolidated decision and final result + +`@sdk:collections` exports invariant ordinary `set` and nominal `Identity`. +Identity supplies `hash(T)->long` and `equals(T,T)->bool`. Set exports +add/contains/remove/clear/size/isEmpty/cursor, with either a default constructor or +an explicit service/struct strategy. Constructor arguments do not infer T. + +Defaults use value equality for int/long/bool, exact UTF-8 content for str, finite +Float equality with normalized signed zeros, and instance identity for +struct/array/Fn/Random. Contract identity uses its fully validated receiver, +independent of the view/implementation. Tuples and other native values require an +explicit strategy. Direct optional elements, including grouped optionals, are +invalid; optional Sets and optional fields within elements remain valid. + +```pbs +import {set, Cursor} from @sdk:collections; + +declare struct Enemy(pub mut health: int); + +fn sample() -> long { + let a = new Enemy(20); + let b = new Enemy(20); + let enemies: set = new set(); + enemies.add(a); + enemies.add(b); // A distinct instance, despite equal fields. + enemies.add(a); // False; keeps the first stored reference. + a.health = 42; // Instance identity is stable across mutation. + let saved: Cursor = enemies.cursor(); + enemies.clear(); // The snapshot still retains the shared Enemy references. + return enemies.size(); +} +``` + +An explicit content strategy may collapse a and b. It must be an equivalence +relation, remain stable while stored, and satisfy equal values => equal hashes. +Remove from every affected collection before changing content used by that policy, +then reinsert. Cached hashes do not freeze mutable equality. The compiler does +not prove purity or coherence and does not deep-copy payloads. + +The shared public policy is reusable by Map. Map/keyval API and representation +remain a separate discussion; Set does not impose its physical table on Map. + +## Patterns and algorithms + +### Integrate neutral identity before the collection + +Common IR now represents REF_IDENTITY_HASH 0x97 and REF_IDENTITY_EQ 0x98 with static +source TypeIds. Lowering derives complete group widths; encoding uses one/two +little-endian TypeIds. Producer verification checks eligible categories even in +dead code and consumes the complete operands. Existing conversion instructions +retain their narrower categories. + +The exact eligible categories are Struct, Array, Fn, Trait and Random. Trait +queries validate receiver plus ImplementationId, including valid zero, before +using receiver identity. Equality validates both operands left-to-right: an absent +or different left operand cannot hide an invalid right operand. Invalid/stale +values remain faults. Digests neither root objects nor provide persistent IDs. + +The new `@sdk:hash` facade exposes i64/f64/text plus explicitly applied +referenceHash/referenceEquals. Origin-checked private bindings select default +hash/equality at concrete logical types. Unsupported default construction is a +localized diagnostic; the unreachable default branch of an explicitly configured +Set does not reject valid tuple/native strategies. User declarations with matching +names or attributes receive no SDK privilege. + +The source-to-PBX-to-production-VM hash gate ran before Set algorithms were +written. The initial gate covered 60 scalar/String oracle executions and 14 +reference executions; later qualification expanded admission/right-side and +discarded-reference cases. Temporal gate provenance and retained final logs are +distinguished in [the evidence record](evidence/README.md). + +### Cache full hashes and build independent growth candidates + +Private `_SetNode` stores a full signed long hash, complete T and next link. +Buckets are an optional array. Empty construction has no table; the first +successful inclusion allocates eight buckets. Above 75% next occupancy, capacity +doubles, clamped to Array's u32 maximum. At that maximum, chains may continue +within checked signed-long size and resource limits. Removal does not shrink; +clear releases the table and returns to lazy empty state. + +Use signed remainder followed by correction for negative values. Taking abs of +Long.MIN_VALUE or narrowing a digest to int breaks valid inputs, and clamped +capacity is not necessarily a power of two. + +Duplicate detection precedes growth. Rehash copies independent nodes from cached +hashes, preserving original links and shared payload references until installation. +It invokes no strategy callbacks. Ordinary insertion does not copy the whole +table. Capture likewise never calls hash/equals. + +The six-to-seven growth case simultaneously retained six old nodes, six copied +nodes and the inserted node, plus both tables. GuestBytes high-water rose from +21,304 to 44,192 in the measured fixture. These are charged fixture/session peaks, +including generic carriers and call preparation, not a universal per-Set bound +or a timing benchmark. Detailed resource vectors are retained with the evidence. + +### Separate guard writes from structural mutation + +add/contains/remove install a guard before invoking Identity. Reentrant +add/remove/clear/contains on the same Set, including aliases, terminate through +TRAP_EXPLICIT. size/isEmpty/cursor may inspect the consistent pre-mutation +structure during callbacks and do not invoke Identity. Normal return releases the +guard; a callback fault may leave it installed. + +Prepare checks, callbacks, next size, nodes/tables and complete values before +structural stores. Then apply ordinary sequential stores without user callbacks. +The [shared failure-phase contract](../../../docs/compiler/pbs/specs/sdk-set-and-identity.md#guard-mutation-phases-and-faults) +is essential: + +| Outcome | Meaning | +| --- | --- | +| Refusal before structural writes | Old elements/topology survive; guard, callback effects and provisional allocations are not rolled back | +| Successful return | Size, table, groups, links and guard satisfy all invariants | +| Fault after structural writes | Earlier writes and incomplete invariants may remain; no recovery, safe-reuse or rollback guarantee | + +The natural quota corpus observed 282 refusals across paired producer variants, +all before structural mutation. That observation does not prove post-write faults +impossible. A separately named test-only in-memory SDK variant inserts an Array +allocation after the real table installation. Its quota fault leaves capacity 16, +seven reachable nodes, old size six and the active guard. The failed instruction +itself preserves its entry state. Production SDK source contains no such probe. + +Budget/debugger pauses are resumable instruction boundaries. They do not make a +source method an atomic observation region. + +### Reuse the entire snapshot protocol + +Capture builds one private immutable singly linked snapshot node per element. +It scans B buckets and N nodes, costs O(B+N) work and O(N) extra nodes, and returns +only a complete Cursor. Payload references stay shared; later Set mutation cannot +rewrite the captured sequence. There is no iteration-order promise. + +A nonempty Cursor starts at its first value, hasNext tests a successor, and next +without a successor retains the final value. Only empty-born cursors have absent +current. Real GC safepoints verified snapshot node/payload retention +1,200 -> 1 -> 1 -> 0, and source Set node reclamation 64 -> 61 -> 0 -> 0. + +### Preserve logical identity across specialization and modules + +This consumer exposed several reusable compiler pitfalls. Concrete implementations +from the same generic family share a source span; deduplicating by span alone +loses later applications. Deduplication now includes logical owner and contract +keys. Raw TypeRef equality would instead distinguish incidental spans and produce +duplicates. + +An already specialized type used as another module's generic argument still needs +its defining dependency. Scoped if-let bindings, member receiver shapes and field +assignment paths must also carry their symbolic types through specialization. +Expected value contexts now reject mismatched nominal generic applications, such +as list assigned to list; Set and ordinary user generic structs obey +the same invariant rule. Negative integer literals retain contextual long typing +during overload selection instead of falling through to an incorrect call path. + +## Validation and limits of evidence + +The [evidence record](evidence/README.md) preserves commands, raw compressed logs, +SHA-256 manifests, generated fixture fingerprints and the regression report. +Source fixtures execute through the production loader/VM with ordinary and +optimized PBS output, independently of Rust debug/release profiles. Installed +examples compile outside the checkout using installDist JARs and their PBX runs +on the same unchanged provider. LSP projections expose concrete signatures and +hide fields/private helpers. + +Qualification is local macOS/arm64. It does not claim other hosts, installed game +deployment, adversarial hash resistance or a performance threshold. Existing +upstream headless-schema gaps are printed explicitly by the harness; their +historical exceptions are not counted as schema conformance. Existing disabled +JUnit cases are listed separately from the mandatory runtime corpus. + +## Pitfalls to avoid + +- Do not compare carrier handles to implement logical tuple/value equality. +- Do not reinterpret valid zero/false payloads as absence. +- Do not make dead generic default branches reject explicit strategies. +- Do not invoke strategy callbacks during rehash/capture or structural updates. +- Do not translate resource faults into false/none or silently reset a faulted guard. +- Do not infer whole-method rollback from single-instruction refusal preservation. +- Do not present test-only fault injection as a natural production allocation. +- Do not feed new named corpora through a legacy catch-all fixture verifier; + each mandatory corpus has its own assertions and count. + +## References + +- [Set/Identity/hash specification](../../../docs/compiler/pbs/specs/sdk-set-and-identity.md). +- [Shared Cursor specification](../../../docs/compiler/pbs/specs/sdk-list-and-cursor.md). +- [Common Registry/PBX specification](../../../docs/compiler/general/specs/typed-registry-and-pbx-v0.md). +- [SDK collection source](../../../prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/main.pbs). +- [Set source fixtures](../../../prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsSetTest.java). +- [Conformance tooling and reproduction](../../../tools/pbx-conformance/README.md). +- [Sequential mutation predecessor](../DSC-0096-runtime-storage-isa-consumer-migration/LSN-0092-sequential-collection-mutations-need-explicit-failure-boundaries.md). diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/README.md b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/README.md new file mode 100644 index 00000000..7cd43ce6 --- /dev/null +++ b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/README.md @@ -0,0 +1,156 @@ +# Set and reusable identity qualification + +Owner: compiler/pbs. Captured 2026-10-25 for accepted DEC-0078 / PLN-0156. +Studio baseline HEAD: `632ba6d0d6988a5e5020f0d70e4fb3993739bc85`. +Runtime: clean `dcf6561ea73446e0a3e1cf1c73eda20923b38df0`, unchanged throughout. +No commit was created in either repository. Runtime builds used external targets. + +## Commands and outcomes + +All commands ran from Studio unless a runtime working directory is specified. +The compressed raw outputs and SHA-256 manifest are alongside this file. + +```sh +./gradlew test :prometeu-app:installedKnowledgeTest --console=plain +python3 tools/runtime-catalog/verify.py --runtime ../runtime +CARGO_TARGET_DIR=/tmp/pln156-pbx-target python3 tools/pbx-conformance/run.py --runtime ../runtime +CARGO_TARGET_DIR=/tmp/pln156-pbx-target python3 tools/pbx-conformance/run.py --runtime ../runtime --release +``` + +All four commands returned zero. Gradle completed in 46 seconds: 94 actionable +tasks, 21 executed and 73 up-to-date. Aggregated JUnit reports contain 1,062 cases, +zero failures/errors and 13 existing skipped cases (1,049 executed cases). Skips +belong to BackendGateIIntegrationTest (8), MainProjectPipelineIntegrationTest (4) +and ExternalSourceDevelopmentHostTest (1); individual names and suite counts are +in `gradle-results.json`. None belongs to the new identity/Set tests. Installed +knowledge validation additionally completed outside the checkout using the built +distribution JARs and produced the mandatory hash/Set PBX examples. + +Focused class sizes in the full regression: IdentityHashingPipelineTest 3, +PbsIdentityHashingTest 3, PbsSetTest 15. PBS frontend totals 300; architecture totals +115; build-pipeline totals 200 including its 12 existing skips. The complete +regression also covers editor/LSP, Array, List, Linked, generic structs/contracts, +native groups, Random, compiler architecture and ordinary packaging. + +Both complete production VM harness commands passed. Each includes the following +new mandatory observations (no missing fixture is skipped): + +| Corpus | Count per Rust profile | +| --- | ---: | +| Scalar/String independent oracle + exact attempted cost + zero fuel | 60 | +| Complete reference/common/source groups, aliases, costs, unused results | 16 | +| Neutral category/TypeId/dead-code admission rejects | 8 | +| Partial group / truncated instruction admission rejects | 2 | +| Null views / complete invalid right operand / cost / fuel | 3 | +| Set success and expected callback/overflow faults, paired producers | 52 | +| Natural Set quota refusals with instruction-prefix comparison | 282 | +| Separate test-only post-publication quota injection | 2 | +| Snapshot GC observations / source Set GC observations | 4 / 4 | +| Real Set import/reexport and installed-example executions | 2 | +| Real installed hash-example execution | 1 | + +The full harness additionally requires the existing common Registry, math, Random, +input, structured values, generic contracts/structs, storage/copy, List/Linked, +closure/lifecycle and loader/schema corpora. Historical upstream schema exceptions +remain explicit: LifecycleRole and NonFiniteValue are absent from the selected +provider's published headless enum. The harness preserves the original payload +and does not call those two cases unmodified-schema conformance. + +Provider supplement (runtime working directory; external target only): + +```sh +cargo test --locked --offline --target-dir /tmp/pln156-provider-target -p prometeu-vm --test identity_hashing +cargo test --locked --offline --target-dir /tmp/pln156-provider-target -p prometeu-vm --lib identity_tests +cargo test --locked --offline --target-dir /tmp/pln156-provider-target -p prometeu-vm --lib 'hashing::' +``` + +The three suites passed 7 + 6 + 2 tests in debug and again with `--release`. +These provider tests cover stale handles/generation reuse, complete invalid +groups, fault order, non-finite injected Float bits, foreign/resident String +owners, quota-free borrowed queries, GC non-rooting and all independent reference +hash vectors. They supplement actual Studio-produced PBX; they do not substitute +for it. Two exploratory `--lib hash_intrinsics::` filters in the retained combined +log selected zero tests and provide no additional qualification. + +The explicit catalog exporter check passed one provider test and compared both +CSV artifacts byte-for-byte against committed provider source and Studio mirrors. + +## Resource observations + +Ordinary and optimized producers produced identical resource vectors. These are +whole-fixture/session high-water measurements, including earlier setup, complete +carriers and call preparation, not standalone object layout sizes. + +| Operation | GuestBytes peak before → after | HandleSlots peak before → after | Maximum Set nodes / bucket tables | Natural refusals per producer | +| --- | --- | --- | --- | ---: | +| Growth 6 → 7 | 21,304 → 44,192 | 68 → 140 | 13 / 2 | 38 | +| Add without growth 5 → 6 | 17,288 → 22,216 | 55 → 71 | 6 / 1 | 28 | +| Duplicate add | 17,288 → 19,440 | 55 → 62 | 5 / 1 | 13 | +| Remove | 17,288 → 20,680 | 55 → 66 | 5 / 1 | 21 | +| Clear | 17,288 → 17,592 | 55 → 56 | 5 / 1 | 5 | +| Cursor | 17,288 → 31,808 | 55 → 102 | 5 / 1 | 36 | + +Growth's AuxiliaryBytes peak was 9,968 → 17,648, TemporaryBytes 3,840 → 7,680 +and CallDepth 5 → 7. The eight raw peak entries are GuestBytes, HandleSlots, +AuxiliaryBytes, TemporaryBytes, StringBytes, StringAllocations, +IndividualStringBytes and CallDepth. Detailed limits, fault opcodes and complete +vectors are printed in both profile logs. Every natural refusal was before a +structural write; an installed guard may remain. Snapshot failures always +preserved the source Set and returned no partial result. + +The independently named `pbs-set-injected-refusal-growth*` fixtures use an +in-memory SDK override that inserts one controlled Array allocation after the +real candidate table store. A GuestBytes quota refuses the probe: the source now +references a 16-bucket table with seven nodes, still reports old size six and +retains its guard. The failing instruction preserves its own entry state. This +is explicitly test-only post-write evidence, not production refusal frequency. + +The production SDK has no injected allocation. Real safepoints measured snapshot +nodes/payloads 1,200 → 1 → 1 → 0 without retained source Set nodes, and source +collection nodes 64 → 61 → 0 → 0 after removal/clear/release. Captures and their +final values assume no iteration order. + +## Hashing-first chronology and scope + +The plan recorded a successful gate on 2026-10-24 before any Set algorithm edits: +60 scalar/String oracle executions plus 14 common/source reference executions. +At that stage IdentityHashingPipelineTest had two tests and +PbsIdentityHashingTest three. The original `/tmp/pln156-hashing-*` log names were +subsequently reused for expanded requalification. Retained focused logs therefore +show the later 89-observation corpus; they are not represented as untouched raw +outputs from the initial temporal gate. This chronology preserves the original +plan's contemporaneous record without fabricating an earlier log. + +Final scope: local macOS 27.0.1, arm64; Rust 1.98.1; Java/Gradle toolchain recorded +in `environment.txt`; VM resource-diagnostics feature and default production +ceilings except explicitly lowered quotas. Source optimizer paths are independent +of Rust runtime profiles. Cross-host, installed game deployment, performance and +adversarial hash resistance are not qualified by these runs. + +`source.sha256` fingerprints 39 changed/new Studio production, test and documentation +files. `fixtures.sha256.gz` fingerprints 1,301 generated PBX artifacts available to +the full harness; regenerate them with the Gradle command. `gradle-results.json` +preserves all suite counts and skipped names. `SHA256SUMS` fingerprints retained +evidence files. Logs can be read with `gzip -dc .gz`. + +## Workflow closure + +`discussion mark-plan PLN-0156 done` completed successfully, followed by +`discussion housekeep DSC-0092 --lesson discussion/lessons/DSC-0092-pbs-sdk-set/LSN-0093-reusable-identity-and-source-set-buckets.md`. +The CLI removed three completed control artifacts and registered LSN-0093. +`discussion validate` passed afterward; DSC-0092 is done with only its lesson +registered. AGD-0089 and AGD-0095 reference the delivered result and keep Map's +remaining questions open. Final read-only workflow state is in `workflow.txt`. + +## Accepted requirement coverage + +| Requirements | Final evidence | +| --- | --- | +| R1 / R3 | Source API/default/explicit/type/privacy tests, generic invariance, concrete editor projections and installed examples | +| R2 / R5 | Neutral IR instruction/width/encoding tests, oracle and complete-group source execution, malformed instructions and source-order fixtures | +| R4 | Topology assertions, 8 → 16 threshold, duplicate/no-shrink/clear, signed-long/u32 arithmetic and cached rehash counters | +| R6 / R7 | Alias reentrancy faults, permitted callback reads, callback-fault guard observations and natural/injected instruction-prefix resource evidence | +| R8 | Empty/single/multiple complete Cursor state table, payload sharing, independent capture and real GC lifetime | +| R9 / R10 | Hashing-first chronology, paired producer/profile runs, provider supplement, collision/callback counters and measured coexistence | +| R11 | Public Identity/hash handoff to Map without Map API/layout implementation | +| R12 | Clean fixed provider, external targets, English specs/lesson, packaged SDK/examples, full regression and CLI validation/housekeeping | diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/SHA256SUMS b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/SHA256SUMS new file mode 100644 index 00000000..1a7976c2 --- /dev/null +++ b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/SHA256SUMS @@ -0,0 +1,19 @@ +01b966b6a3f710c150c960c6a5b49f1b45d1db93fe7d5fa536db761f3489dfad README.md +fb48082c878378f7fa01009361380b38be074a0b711edc605c531c9fb575ff5a conformance-debug.log.gz +4e5b52584c70bca57c3b715558102b663daf51cf84bebf549600bdf11c88cab4 conformance-release.log.gz +774b5aa6f29a3e4d986bab805427b7d0a0c53445749e03a93db4320cee376302 distribution-tests.log.gz +1510a88944e6a632e4373d35e3e5855a06a1273f7f0be3b590d811faa209d830 environment.txt +5b136af3ee037ba0879c02cc57c135350ed446853dedfd41a7455a532e4852e6 fixtures.sha256.gz +b7a05d6c252b869cd2a909edd40ef16a094279d6aee4379daa67b607753cfe2b gradle-results.json +3e4e33aa6338142b79a4740945c50b149c572980ad108219d930e3909dd73f8a hashing-conformance.log.gz +6c4a1723e53ad40a2315a509a43a6a0058db145cc006ee4bc7a346cd12333fee hashing-tests.log.gz +79b81e38a9ecf948c7381796c77aa30929dbcfcd2f4eb0a5ead71032fbb5bf04 provider-catalog.log.gz +2f53ddd02d054c4c801aeaf20981f83eb28961b9b973fd025c10aed6673dd254 provider-hash-remaining.log.gz +0d2a846ee52a7a40662c1720055ffdf36179cdbaf846696e07d7ab0149d4367d provider-identity-debug.log.gz +0255d42eb28c98566741fa17987480969ab89b35a113c568481240713f69aa1e provider-identity-private-debug.log.gz +f6ca7e0c4865b83031d8f21e166248209089a91466103d193cb14ffd8e533df7 regression.log.gz +9f9bf7af13da11147a1388ea86a41f8e59202b4d08333dca24d4385d5329dc21 set-conformance.log.gz +60b879014ec61aad58eb6aba651e28fb017077c3c17a6f06b2851f99be50ca72 set-tests.log.gz +2d0b3b19a447fa29a4ae127842db26d4adacb400af77837c09edd8ea0c9874c3 source.sha256 +0e245cc1d83d697f9ffb3fb0a8dd18800cdc0892c23def0d4e14737c3cb42cbc workflow.txt +8ee423550b4716622600a4a943084837961ff9587259f2ff485e25d30005e434 ../LSN-0093-reusable-identity-and-source-set-buckets.md diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/conformance-debug.log.gz b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/conformance-debug.log.gz new file mode 100644 index 0000000000000000000000000000000000000000..f8c2fc94857b5122ee61a6f38f5a47d556c40183 GIT binary patch literal 12362 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 A%K!iX literal 0 HcmV?d00001 diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/environment.txt b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/environment.txt new file mode 100644 index 00000000..0436cb9f --- /dev/null +++ b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/environment.txt @@ -0,0 +1,32 @@ +macOS-27.0.1-arm64-arm-64bit-Mach-O +632ba6d0d6988a5e5020f0d70e4fb3993739bc85 + +dcf6561ea73446e0a3e1cf1c73eda20923b38df0 + +runtime working tree: clean + +rustc 1.98.1 (48a229cea 2026-09-01) +binary: rustc +commit-hash: 48a229ceaefd4985c50990b14116b6d856af0985 +commit-date: 2026-09-01 +host: aarch64-apple-darwin +release: 1.98.1 +LLVM version: 22.1.8 + + +------------------------------------------------------------ +Gradle 9.3.1 +------------------------------------------------------------ + +Build time: 2026-01-29 14:15:01 UTC +Revision: 44f4e8d3122ee6e7cbf5a248d7e20b4ca666bda3 + +Kotlin: 2.2.21 +Groovy: 4.0.29 +Ant: Apache Ant(TM) version 1.10.15 compiled on August 25 2024 +Launcher JVM: 21.0.4 (Amazon.com Inc. 21.0.4+7-LTS) +Daemon JVM: /Users/niltonconstantino/.sdkman/candidates/java/21.0.4-amzn (no Daemon JVM specified, using current Java home) +OS: Mac OS X 27.0.1 aarch64 + + +Java toolchain: buildSrc/src/main/kotlin/gradle.java-common-conventions.gradle.kts sets 21 diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/fixtures.sha256.gz b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/fixtures.sha256.gz new file mode 100644 index 0000000000000000000000000000000000000000..c24441ab5772d28946c29052d159ceffbd17b0c7 GIT binary patch literal 41596 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�)WVg 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

3@Imj#JE^txH<8- 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%0A9iSRJ>WD<*j~Ih*Jg1s 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 Zopum|CqoUkIcVU;zX6AOeG$PZ001m9vM2xm literal 0 HcmV?d00001 diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/hashing-tests.log.gz b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/hashing-tests.log.gz new file mode 100644 index 0000000000000000000000000000000000000000..aee0364b92359f5d0845c2940d6436bd0c229d2b GIT binary patch literal 717 zcmV;;0y6y{iwFP!00002|E*ZtZsITyedjCu0h@Y3*s{8_{?~GJmi5asoIg@I^}T`A{(-IV7r;nF;AY6Mlmenbjy>m zNH%<%BGp_ZQ$&G^gtM2$VmcW-Tykt70TT(+g9c1!oKu7n*eDADgIz6x#@EB1QHcFlTcA9OoPat?wk0T0WOaB0B~mo++NH)+DND=;#irlQ zI-j5+4S2FaT1mPsx`@O2H|7mO51tK*L_-n} za@^BEatWq~;dVqWJ?A0odQ-ZSxOHt!c>Ne&_PK+&JkqAXb$gbebhbs^_a$Sv(cWl7 zHO@=mf3|(9ZS{#xO;Y9X-=X9A>z77;ggdD}Lj6TojIp2is>gOpqC(LlnUkB|D5JAG z_e<-<N(9lYc)&6KQs1h;Wo_OeA{|e`V`Pc*4srh$Ew4WP9rY7Mg>XPuDnkE z*^8oB)oaixFewi{Oz7s|42+emeDG3Q1Mlzp7RrNxO6e8r)yGG2hZfD^Y~4qZy>ksr zrwBpTY05JFw;_FutZ8AFoUZDONOAaI{VmrQ_*SmGY@}s75K=w$bI2+d+}@ z$Wo4X)O2>x6`>@pu}BPpenL z6Y^UP?(Ya?*@Hp4j)7>ifEto}0taBJhUf?R`HQ47&?1P;tU34(@E3XdbQAypnB`&r literal 0 HcmV?d00001 diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/provider-catalog.log.gz b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/provider-catalog.log.gz new file mode 100644 index 0000000000000000000000000000000000000000..9728222b3cb5401a88e1a412b007b478ca1e53e8 GIT binary patch literal 895 zcmV-_1AzP=iwFP!00002|GiaBZ{s!)z57@2xWQH*lqgYd(8Jb1Q3FjpQZY0(RnKR|i4jn|bqQI2_)5+N}O0>)Xxe_3iz7bstMV5#NZcD1YOU z%Dl{Vp;NtNw9ZAHaj7NGgk}_I4va~~a!zGgaaC7&n(~ZhRizn+GGE;6$$$T{{%fC=rHzzTGr5qTi70tL195kT9OHYm{#d2^aD_w z9bRU*iu3#(<_n}!?;@j*iq1$o^Ki_Ry(jg-+x`__o*KB(2e}o4ZmkFh&H2Z+ow|sX znaHUwL?P-^AKV??ik&ADCYZ)&8TwA3Kgc;CEn<3#cF@Vj&7M3iPazYmII27=_zr>- zy|Uf0sAuqu9k(Nm%k$#+mwpb1tmnniLnlHrJJEBQ!!Sjy2~d@XkQsfiuGsBny0l*h zRSkBrm^t$E5Ho)0g5pj4b`W5U>X!g>n;sOV=n+tmH+LQUOX3;DzJ#y6nI_gUxn*U?G7j=dd_!Tdn%BM#Df+?ih6 zZzSNHh48^&5z`Yq)>*M1tAuYNhU4844G%^>R*yxp7l!ZQZN#Wb zSzQ%uS!KG+3SD0<7VfB#?o}@Kw*~w&Zw;ueaKUJF^jkddve||PwjQlp*dEKdJqjUl z925JvI1u2)f|ty%xDX@pAiM{4O;Vx-R&xJkc0G=r{bvWlkNa<$6D)NA{2_J>*Z6nb V3oI;-%hWFx{{n~|ssQc>005@Pyl?;j literal 0 HcmV?d00001 diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/provider-hash-remaining.log.gz b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/provider-hash-remaining.log.gz new file mode 100644 index 0000000000000000000000000000000000000000..f1f0828d16fe908f3bea1d1f1a48fe397fa2e5a8 GIT binary patch literal 1381 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 literal 0 HcmV?d00001 diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/set-conformance.log.gz b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/set-conformance.log.gz new file mode 100644 index 0000000000000000000000000000000000000000..bbe728a89a9acbcdde19ed8c37f734c34c28e179 GIT binary patch literal 3603 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 BB9{OF literal 0 HcmV?d00001 diff --git a/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/set-tests.log.gz b/discussion/lessons/DSC-0092-pbs-sdk-set/evidence/set-tests.log.gz new file mode 100644 index 0000000000000000000000000000000000000000..bcacac94fa7843d0494a6233b2fa8751e094ec6c GIT binary patch literal 696 zcmV;p0!RHHiwFP!00002|E*ZtZsIT$eCI3t0h@ca06CV2}_VG+;`TQX-PTMmYowcR3FhvtaVL2%B^` zXrxTf5t#UpJb^f3$fYi2%454i#jBvBM6g{u;mh%rH6IxRr3AW()R-}q+7`H4vaGrb z@(H5!kpxueVpbT$C@`a z^5eL)e60cd6r^g|4mBu|wkvzq)O~E6?*$HC&ft!Qigw$yOyn zjoj^>NH&kwe(L4f-klvXSVjCZ)wg4x`@_1mcM4S3@Xu3hnf+pvyKX1<1=ZhlZI for forward and reverse captures. -Future Set producers use Cursor; Map uses Cursor>. Set/Map gain -no ordering guarantee between captures. A captured keyval association is read-only +[Set](sdk-set-and-identity.md) produces Cursor; future Map uses +Cursor>. Set/Map gain no ordering guarantee between captures. +A captured keyval association is read-only and does not follow later association replacement; referenced objects stay shared. -Set/Map and keyval are separate deliveries. +Map and keyval remain separate deliveries. For n logical List positions and k present occurrences, capture takes O(n) work and O(k) additional nodes; next follows one link in O(1). Each node costs allocation, diff --git a/docs/compiler/pbs/specs/sdk-set-and-identity.md b/docs/compiler/pbs/specs/sdk-set-and-identity.md new file mode 100644 index 00000000..00fc4b7b --- /dev/null +++ b/docs/compiler/pbs/specs/sdk-set-and-identity.md @@ -0,0 +1,242 @@ +# SDK Set, Identity and hashing + +Owner: `compiler/pbs`. Set algorithms belong to executable PBS SDK source. Typed +reference queries, storage, admission, faults and resource limits are generic +compiler/provider mechanisms. This contract builds on [generic structs](generic-structs-and-free-functions.md), +[generic contracts](generic-contracts.md), [Array/optional](typed-arrays-and-optional-execution.md) +and the [shared snapshot Cursor](sdk-list-and-cursor.md#cursor-protocol). + +## Types, construction and operations + +The `@sdk:collections` module exports invariant ordinary generic `set` and the +nominal contract `Identity`: + +```pbs +declare contract Identity { + fn hash(value: T) -> long; + fn equals(left: T, right: T) -> bool; +} +``` + +Import the SDK declarations with `import {set, Identity, Cursor} from @sdk:collections;`. +Another user contract named Identity does not become the SDK contract through its spelling. + +`new set()` selects the SDK default for T. `new set(identity)` takes an +explicit `Identity` service/struct value. Contextual `new set()` and diamond +construction require an existing expected application; argument values do not infer +T. Type applications and strategies are invariant. Associated members such as +Enemy.identity, blanket implementations and generic reflection are not introduced. + +No-strategy construction for T without a default is a localized source error. +Explicit-strategy construction remains valid for otherwise supported grouped/native +T, even though the generic owner also declares a no-argument constructor. Direct +optional T, including grouped optional, is invalid with either constructor. +`optional (set)` and elements with optional fields remain valid. + +| Operation | Result | Behavior | +| --- | --- | --- | +| add(value) | bool | True on inclusion; false for an equal existing element | +| contains(value) | bool | Membership under the selected policy | +| remove(value) | bool | True only when an equal element was removed | +| clear() | unit | Release table/nodes and reset size to zero | +| size() | long | Number of elements | +| isEmpty() | bool | size equals zero | +| cursor() | Cursor | Complete independent snapshot | + +Set has stable reference identity: aliases observe the same collection. A duplicate +add preserves the original stored reference and does not grow the table. Removing +an absent value is false. There is no positional indexer, tryGet, capacity argument, +capacity/reserve/trim API or public node. Insertion/iteration order is not guaranteed. +Receiver and arguments evaluate once in source order, including named application. +An unrelated user declaration named set gains none of the SDK-specific rules. + +## Equality policy and obligations + +| T | Default policy | +| --- | --- | +| int / long | Value equality in the static domain of T; int widens exactly to Int64 for hashing | +| bool | Value equality; false/true map to Int64 0/1 for hashing | +| str | Exact resident UTF-8 content, without normalization or case folding | +| float | Finite Float equality; +0 and -0 are equal and hash equally | +| Source structs, arrays, Fn and Random | Instance identity, independent of mutable fields/elements, code/captures or generator state | +| contracts | Identity of the fully validated receiver, independent of view/ImplementationId | +| Tuples and other native values | Explicit Identity required; no automatic composition | + +Services represented as ordinary singleton references retain the same instance +semantics when they are valid element types. There is no public Dynamic, universal +cross-numeric equality, structural fallback or equality based on private value +carrier identity. Hash collisions do not imply equality. All signed long digest +bits, including negative values, are retained. + +Two distinct gameplay objects with equal fields remain distinct under defaults. +An explicit strategy may define content equality and collapse such instances. +Actual stored references remain shared; no deep freezing/copying occurs. Identity +must define a stable equivalence relation while stored and satisfy +`equals(a,b) => hash(a) == hash(b)`. The converse is not required. Strategy +configuration and relevant content must remain coherent. Remove from every affected +collection before changing content used by equality/hash, then reinsert. A cached +old hash does not stabilize mutable equality. The SDK cannot prove these obligations +and does not introduce purity, readonly or effect-system requirements. + +Every value preserves its complete logical group and reference aliases through +callbacks, nodes, calls, allocations, rehash and capture. A tuple's private storage +carrier is not that tuple's source identity. Groups/native owners retain ordinary +storage packing and quota costs. + +## Private representation and growth + +Set uses a private array of buckets with private chained nodes. Each node stores +the complete cached long hash, full T and its next link. It does not depend on the +public linked collection or a universal Element. Hash selects candidates and +equals resolves collisions, including deliberately identical hashes. + +Empty construction has no nonempty bucket table. First successful inclusion uses +8 buckets. For current capacity c and next size r, grow when r exceeds +`floor(3*c/4)`; new capacity is `min(2*c, 4294967295)`. Arithmetic uses long and +must not overflow. At the maximum Array capacity, chaining can continue within +checked signed-long size and provider quotas, accepting increased occupancy. +Array's u32 structural bound limits buckets, not the count of chained elements. +An unrepresentable next size is rejected before addition/mutation. + +For positive capacity, select the bucket with signed remainder and correction: + +```text +bucket = hash % capacity +if bucket < 0: bucket += capacity +``` + +Do not abs the digest, narrow to int, or assume every capacity is a power of two. +Removal does not shrink. Clear releases table/node references and returns to lazy +empty state. Discarded objects and old storage follow normal tracing and other +owners; immediate collection or quota recovery is not guaranteed. + +Rehash prepares independent buckets/nodes/topology from cached hashes. It preserves +published links until installation and preserves payload reference identities. +It does not invoke hash/equals. Old and candidate structures coexist under ordinary +quotas; private carriers can add allocation/ownership work. Installation uses +ordinary typed stores. Whole-table reconstruction on every mutation is not the +algorithm, and preparing a candidate does not make later source instructions atomic. + +Search cost depends on hash distribution, occupancy and callback cost; the worst +case is O(N). Growing rehash costs O(new buckets + N) work and additional nodes/table. +String hashing additionally costs work proportional to content. Expected lookup +or amortized growth claims do not promise constant instruction cost, no allocation, +adversarial resistance or allocation-free optional carriers. + +## Guard, mutation phases and faults + +Operations calling Identity use a private guard. A callback cannot reenter +add/remove/clear/contains on the same Set, including aliases; reject before +structural changes through the private terminal TRAP_EXPLICIT path. During callback +preparation the original structure is consistent: size/isEmpty/cursor may read it +without invoking Identity. Capturing a Cursor may still fail resources. + +Validation, hashing/equality/search, next sizes, nodes/tables and value/return +carriers are prepared before structural writes. No user callback or explicit +suspension occurs in the sequence that applies structural changes. Rehash/capture +never call strategies. The guard is released on successful return, including +ordinary false results. + +| Outcome | Guarantee | +| --- | --- | +| Refusal before the first structural write | Prior elements/topology are unchanged; external argument/callback effects and provisional allocations are not undone | +| Successful return | Size, topology, buckets, groups, identity, cleanup and guard invariants hold | +| Internal/resource fault after structural mutation starts | Earlier writes may remain and invariants may be incomplete; no rollback, safe reuse, retry or automatic recovery | + +Installing the guard is already a write. Callback fault can leave it active while +elements remain unchanged. Structural preservation is not bit-for-bit preservation +of the whole Set object. No catch/finally, poison flag or recovery API is added; +permitted callback reads do not establish post-fault safe reuse. Mutations of other +Sets/objects are not rolled back, and the guard does not prove strategy stability. +Faults are never translated into false/none. + +Per-instruction refusal preserves that instruction's applicable entry state, not +earlier successful instructions. BudgetExhausted/debugger pauses are resumable +instruction boundaries; execution resumes at its PC. A source method is not an +atomic observation region for host/debugger inspection. + +## Snapshot Cursor + +Cursor uses the existing shared implementation and full state table. A nonempty +snapshot begins on the first captured element; hasNext tests a successor; next +without a successor keeps the final value. Only an empty-born Cursor reports +current absent. Consume current before deciding whether to advance: + +```pbs +let snapshot = values.cursor(); +while true { + if let value = snapshot.current() { + // Use value. + } else { break; } + if snapshot.hasNext() { snapshot.next(); } + else { break; } +} +``` + +Capture allocates one private immutable singly linked node per element and completes +before returning. Failure returns no partial Cursor and preserves source structure. +Snapshot nodes retain payload values, not editable Set nodes/bucket positions. +Later inclusion/removal/clear/growth cannot rewrite the capture. Referenced objects +remain shared and later field mutation remains visible; iteration order between +captures is not guaranteed. There is no live/fail-fast iterator, reset, removal +through Cursor or new for-in protocol. + +For B buckets and N elements, capture is O(B+N) work/O(N) extra nodes and next O(1). +Consumed prefixes can become unreachable; final current node/value stays retained +until the Cursor releases it. Ordinary allocations, carriers, owners, GC and quotas +apply without relaxation. + +## Hash facade and typed query boundary + +`@sdk:hash` exports `hash.i64(long)->long`, `hash.f64(float)->long`, +`hash.text(str)->long`, `referenceHash(T)->long` and +`referenceEquals(T,T)->bool`. Generic reference wrappers require explicit type +arguments and accept exactly eligible reference categories; grouped/optional value +carriers and arbitrary scalar/Dynamic values do not become references. + +The reference wrappers lower complete groups to REF_IDENTITY_HASH 0x0097 and +REF_IDENTITY_EQ 0x0098. Contracts validate receiver and ImplementationId, including +valid zero, before querying receiver identity. Concrete and valid trait views agree. +Both sides of equality validate left-to-right; an absent/different left cannot +suppress an invalid right. Invalid handles/groups remain faults. TypeIds are static +program metadata, not guest selectors. Reference hashes do not root objects or +provide persistent cross-session IDs. + +Scalar wrappers use hash.i64@1 0x4100, hash.float@1 0x4101 and hash.string@1 0x4102. +Hash-v1 preserves the provider's XXH64 seed-zero digest bits. Numeric hashes cost +8 cycles; String costs 8 plus UTF-8 bytes. Finite Float bit hashing normalizes both +zeros, never converts numerically to integer, and rejects non-finite inputs. +Provider-level canonical null String hashes to zero and differs from empty text; +PBS adds no public null syntax or optional-element admission. Reference hash costs +8+w(T), equality 4+w(left)+w(right). Valid queries have bounded borrowed execution +without guest/scratch allocation or user callbacks; wrapper/call costs are separate. + +Compiler verification, emission and optimization must preserve complete groups, +provenance/null admission, fault order, attempt costs, zero-budget/overshoot and +unused-result effects. Defaults are resolved by private trusted bindings at +concrete logical types, not by enabling == on unconstrained T. Existing user +contracts named Identity retain their own nominal identity and signatures. + +## Qualification, distribution and related consumers + +Qualify the hash facade from real PBS through PBX into the production VM before +Set algorithms. Test ordinary/optimized source and neutral producers, independent +provider vectors, negative hashes, complete contract groups, Float boundaries, +String owners, aliases/mutation, GC/stale handles and malformed/dead instructions. +Strategy counters and deliberate collisions must demonstrate callback-free +rehash/capture and alias-safe reentrancy. Observe measured old/candidate memory +peaks and instruction-prefix refusal state, separating guard effects and structural +writes. Controlled test-only fault injection must be identified separately from +natural production quota cases. + +Ship this English specification, SDK source and executable examples in installed +knowledge; compile actual installed examples outside the checkout and execute their +PBX. Normal compilation uses versioned Studio catalogs/resources without a sibling +checkout. Runtime ownership, limits and semantics remain the provider contract; +Set adds no VM collection instruction/syscall or provider source change. + +Identity/hash are reusable by future Map. Map/keyval API, representation and +implementation are separate consumers; sharing policy does not impose a shared +physical table or universal entry type. See the +[common typed Registry contract](../../general/specs/typed-registry-and-pbx-v0.md) +and [catalog consumer rules](../../general/specs/runtime-catalog-support.md). diff --git a/docs/specs/compiler-languages/pbs/README.md b/docs/specs/compiler-languages/pbs/README.md index 92b262ec..b6319ea5 100644 --- a/docs/specs/compiler-languages/pbs/README.md +++ b/docs/specs/compiler-languages/pbs/README.md @@ -28,7 +28,7 @@ For an external coding agent: ### Small Game Project -The installed example has three separately indexed files: +The installed example has separately indexed files. Its basic game entry consists of: - `pbs:example:game:1:prometeu.json`: a Game manifest with `language: pbs`, `stdlib: 1` (serialized as a string), and no external dependencies; @@ -36,6 +36,11 @@ The installed example has three separately indexed files: moving rectangle through `Gfx` and constructing colors through `Color`; - `pbs:example:game:1:src/mod.barrel`: the module's public declarations. +Additional runnable examples include `src/collections.pbs` for List/Cursor, +`src/linked.pbs` for Linked, `src/sets.pbs` for Set and `src/hashing.pbs` for +scalar hashing and typed instance queries. Read the corresponding SDK/spec +references; Set's order is unspecified and custom equality is explicit. + Copy these reference texts to the corresponding paths only when creating that example in your editable project. The example is compiled in the test suite; it is not a complete game or a claim that every requested gameplay abstraction @@ -54,7 +59,8 @@ for exact rules rather than inferring compatibility with another language. `pbs:sdk:game:1:sdk/gfx/main.pbs` exposes the actual installed Gfx source, including documentation comments and signatures. Its `mod.barrel` reference defines exports. Equivalent references exist for `sdk/asset`, `sdk/composer`, -`sdk/input`, `sdk/log`, `sdk/math`, `sdk/mathf`, `sdk/random`, and `core/color`. Read those interfaces before calling +`sdk/input`, `sdk/log`, `sdk/math`, `sdk/mathf`, `sdk/random`, `sdk/hash`, +`sdk/collections`, and `core/color`. Read those interfaces before calling them. Game SDK 1 does not currently ship `audio` or `core/math` modules. Ordinary game source uses public services such as `Gfx`; it must not manufacture diff --git a/prometeu-app/src/test/java/p/studio/app/compiler/InstalledKnowledgeProbe.java b/prometeu-app/src/test/java/p/studio/app/compiler/InstalledKnowledgeProbe.java index 99fcbd03..8e043555 100644 --- a/prometeu-app/src/test/java/p/studio/app/compiler/InstalledKnowledgeProbe.java +++ b/prometeu-app/src/test/java/p/studio/app/compiler/InstalledKnowledgeProbe.java @@ -31,6 +31,10 @@ public final class InstalledKnowledgeProbe { check(docs.stream().anyMatch(r -> r.id().equals("pbs:example:game:1:src/collections.pbs")), "Missing installed List/Cursor example"); check(docs.stream().anyMatch(r -> r.id().equals("pbs:spec:sdk-linked-and-cursor.md")), "Missing installed Linked specification"); check(docs.stream().anyMatch(r -> r.id().equals("pbs:example:game:1:src/linked.pbs")), "Missing installed Linked example"); + check(docs.stream().anyMatch(r -> r.id().equals("pbs:spec:sdk-set-and-identity.md")), "Missing installed Set/Identity specification"); + check(docs.stream().anyMatch(r -> r.id().equals("pbs:example:game:1:src/sets.pbs")), "Missing installed Set example"); + check(docs.stream().anyMatch(r -> r.id().equals("pbs:example:game:1:src/hashing.pbs")), "Missing installed hashing example"); + check(docs.stream().anyMatch(r -> r.id().equals("pbs:sdk:game:1:sdk/hash/main.pbs")), "Missing installed hash SDK"); for (var reference : docs) { if (reference.id().startsWith("pbs:example:game:1:")) { Path file = root.resolve(reference.id().substring("pbs:example:game:1:".length())); @@ -91,6 +95,20 @@ public final class InstalledKnowledgeProbe { check(linkedResult.diagnostics().stream().noneMatch(issue->issue.isError()),"Installed Linked example must compile"); Files.write(fixtures.resolve("pbs-linked-installed.pbx"),linkedResult.bytecodeBytes()); System.out.println("Installed Linked execution fixture generated"); + for(var example:java.util.Map.of("set","sets.pbs","hash","hashing.pbs").entrySet()) { + Path exampleRoot=Files.createDirectory(Path.of(example.getKey()+"-example")).toRealPath(); + Files.createDirectories(exampleRoot.resolve("src")); + Files.copy(root.resolve("prometeu.json"),exampleRoot.resolve("prometeu.json")); + Files.writeString(exampleRoot.resolve("src/mod.barrel"),"pub fn frame() -> void;"); + String function=example.getKey().equals("set")?"setExample":"hashingExample"; + Files.writeString(exampleRoot.resolve("src/main.pbs"),Files.readString(root.resolve("src/"+example.getValue())) + +"\n[Frame] fn frame()->void {if "+function+"()!=42 {let failure=1/0;}}"); + var exampleResult=BuilderPipelineService.INSTANCE.compile( + BuilderPipelineContext.fromConfig(new BuilderPipelineConfig(false,exampleRoot.toString())),LogAggregator.stdout()); + check(exampleResult.diagnostics().stream().noneMatch(issue->issue.isError()),"Installed "+example.getKey()+" example must compile: "+exampleResult.diagnostics()); + Files.write(fixtures.resolve("pbs-"+example.getKey()+"-installed.pbx"),exampleResult.bytecodeBytes()); + System.out.println("Installed "+example.getKey()+" execution fixture generated"); + } verifyExternalSources(provider.getClass().getClassLoader()); registration.unsubscribe(); System.out.println("Installed knowledge verified: " + docs.size() + " references; example compiled"); diff --git a/prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsIdentityHashingTest.java b/prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsIdentityHashingTest.java new file mode 100644 index 00000000..f07507de --- /dev/null +++ b/prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsIdentityHashingTest.java @@ -0,0 +1,134 @@ +package p.studio.compiler.backend.irvm; + +import org.junit.jupiter.api.Test; +import p.studio.compiler.models.SourceKind; +import p.studio.compiler.pbs.PbsFrontendCompiler; +import p.studio.compiler.source.diagnostics.DiagnosticSink; +import p.studio.compiler.source.identifiers.FileId; +import java.nio.charset.StandardCharsets; +import java.nio.file.*; +import java.util.HexFormat; +import static org.junit.jupiter.api.Assertions.*; + +class PbsIdentityHashingTest { + static String sdk() throws Exception { + try(var stream=PbsIdentityHashingTest.class.getResourceAsStream("/game/stdlib/1/sdk/hash/main.pbs")) { + assertNotNull(stream);return new String(stream.readAllBytes(),StandardCharsets.UTF_8); + } + } + static void compile(String name,String source) throws Exception { + compile(name,source,""); + } + static void compile(String name,String source,String extraSdk) throws Exception { + var matcher=java.util.regex.Pattern.compile("declare service Probe\\s*\\{fn main\\(\\)->(int|long)").matcher(source); + assertTrue(matcher.find(),name);String result=matcher.group(1); + String executable=matcher.replaceFirst("fn _hashProbe()->"+result); + executable=executable.substring(0,executable.lastIndexOf('}')); + executable+="declare service Probe {fn main()->"+result+" {return _hashProbe();}}"; + for(var suffix:new String[]{"","-optimized"}) + PbsRuntimeAlignmentTest.compile("hash-"+name+suffix,sdk()+extraSdk+executable); + } + @Test void scalarWrappersMatchIndependentProviderOracle() throws Exception { + String corpus; + try(var stream=getClass().getResourceAsStream("/hash/hash-conformance.tsv")) { + assertNotNull(stream);corpus=new String(stream.readAllBytes(),StandardCharsets.UTF_8); + } + int count=0;var manifest=new StringBuilder(); + for(var row:corpus.lines().skip(1).toList()) { + var parts=row.split("\t",-1);String expression;int id;int bytes=0; + switch(parts[0]) { + case "i64" -> {expression="hash.i64("+parts[1]+")";id=0x4100;} + case "float" -> { + long bits=Long.parseUnsignedLong(parts[1],16); + String value=bits==Long.MIN_VALUE?"-0.0":java.math.BigDecimal.valueOf(Double.longBitsToDouble(bits)).toPlainString(); + if(!value.contains("."))value+=".0"; + expression="hash.f64("+value+")";id=0x4101; + } + case "string" -> { + var content=HexFormat.of().parseHex(parts[1]);bytes=content.length; + String value=new String(content,StandardCharsets.UTF_8).replace("\\","\\\\").replace("\"","\\\"") + .replace("\n","\\n").replace("\r","\\r").replace("\t","\\t"); + expression="hash.text(\""+value+"\")";id=0x4102; + } + default -> {continue;} + } + String name="vector-"+count++; + compile(name,"declare service Probe {fn main()->long {return "+expression+";}}"); + for(var suffix:new String[]{"","-optimized"}) + manifest.append("pbs-hash-").append(name).append(suffix).append('\t').append(parts[2]) + .append('\t').append(id).append('\t').append(8+bytes).append('\n'); + } + assertEquals(30,count); + Files.writeString(Path.of(System.getProperty("pbs.registryConformanceDirectory")).resolve("hash-vectors.tsv"),manifest); + } + @Test void instanceQueriesCoverMutableObjectsViewsArraysFunctionsAndGenerators() throws Exception { + compile("object",""" + declare struct Item(pub mut value:int); + declare service Probe {fn main()->int { + let item=new Item(20);let other=new Item(20);let saved=referenceHash(item); + item.value=42; + if saved!=referenceHash(item) {return 0;} + if referenceEquals(item,item)==false or referenceEquals(item,other) {return 0;} + return 42; + }} + """); + compile("contract",""" + declare contract Read {fn read()->int;} + declare struct Item(pub mut value:int); + implements Read for Item using item {fn read()->int {return item.value;}} + declare service Probe {fn main()->int { + let item=new Item(20);let other=new Item(20);let left:Read=item;let right:Read=item; + if referenceHash(left)!=referenceHash(item) {return 0;} + if referenceEquals(left,right)==false {return 0;} + if referenceEquals(left,other as Read) {return 0;} + item.value=42;return right.read(); + }} + """); + compile("array",""" + declare service Probe {fn main()->int { + let a:array=[1];let b:array=[1];let h=referenceHash>(a);a[0]=42; + if h!=referenceHash>(a) or referenceEquals>(a,b) {return 0;} + if referenceEquals>(a,a)==false {return 0;}return a[0] else 0; + }} + """); + compile("function",""" + fn make()->Fn()->int {return fn []()->int{return 42;};} + declare service Probe {fn main()->int { + let a=make();let b=make();let alias=a; + if referenceHashint>(a)!=referenceHashint>(alias) {return 0;} + if referenceEqualsint>(a,alias)==false or referenceEqualsint>(a,b) {return 0;} + return alias(); + }} + """); + String random; + try(var stream=getClass().getResourceAsStream("/game/stdlib/1/sdk/random/main.pbs")) { + assertNotNull(stream);random=new String(stream.readAllBytes(),StandardCharsets.UTF_8); + } + compile("random",""" + declare service Probe {fn main()->int { + let a=random.new(42);let b=random.new(42);let h=referenceHash(a);random.next(a); + if h!=referenceHash(a) or referenceEquals(a,b) {return 0;} + if referenceEquals(a,a)==false {return 0;}return 42; + }} + """,random); + compile("discard","declare service Probe {fn main()->int {hash.text(\"hello\");hash.i64(-1);return 42;}}"); + compile("discard-reference",""" + declare struct Item(pub value:int); + declare service Probe {fn main()->int{ + let item=new Item(1);let other=new Item(1); + referenceHash(item);referenceEquals(item,other);return 42; + }} + """); + } + @Test void invalidReferenceSourcesAndProjectAttributesReject() throws Exception { + for(var argument:new String[]{"int","str","optional int","(x:int,y:int)"}) { + var diagnostics=DiagnosticSink.empty(); + String value=switch(argument){case "int"->"1";case "str"->"\"x\"";case "optional int"->"none";default->"(x:1,y:2)";}; + new PbsFrontendCompiler().compileFile(new FileId(0),sdk()+"fn probe()->long {return referenceHash<"+argument+">("+value+");}",diagnostics,SourceKind.SDK_INTERFACE); + assertTrue(diagnostics.stream().anyMatch(d->d.getCode().equals("E_SEM_IDENTITY_REFERENCE_TYPE")),argument+": "+diagnostics.stream().map(d->d.getCode()+":"+d.getMessage()).toList()); + } + var diagnostics=DiagnosticSink.empty(); + new PbsFrontendCompiler().compileFile(new FileId(0),"[IdentityPrimitive(name=\"referenceHash\")] fn counterfeit(x:T)->long{return 0;}",diagnostics); + assertTrue(diagnostics.hasErrors()); + } +} diff --git a/prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsListCursorTest.java b/prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsListCursorTest.java index 876e63cc..b3649623 100644 --- a/prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsListCursorTest.java +++ b/prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsListCursorTest.java @@ -21,10 +21,15 @@ class PbsListCursorTest { return compileCollection("list", name, source); } static BytecodeModule compileCollection(String collection,String name,String source) throws Exception { + return compileCollection(collection,name,source,null); + } + static BytecodeModule compileCollection(String collection,String name,String source,String sdkOverride) throws Exception { var diagnostics=DiagnosticSink.empty();var id=new FileId(0);var sdkId=new FileId(1); - String sdk; - try(var stream=PbsListCursorTest.class.getResourceAsStream("/game/stdlib/1/sdk/collections/main.pbs")) { - assertNotNull(stream);sdk=new String(stream.readAllBytes(),StandardCharsets.UTF_8); + String sdk=sdkOverride; + if(sdk==null) { + try(var stream=PbsListCursorTest.class.getResourceAsStream("/game/stdlib/1/sdk/collections/main.pbs")) { + assertNotNull(stream);sdk=new String(stream.readAllBytes(),StandardCharsets.UTF_8); + } } var ast=PbsParser.parse(PbsLexer.lex(sdk+"\n"+source,id,diagnostics),id,diagnostics,PbsParser.ParseMode.INTERFACE_MODULE); var file=new PbsFrontendCompiler().compileParsedFile(id,ast,diagnostics,source.contains("[BuiltinType")?SourceKind.SDK_INTERFACE:SourceKind.PROJECT,new ModuleId(0), diff --git a/prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsSetTest.java b/prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsSetTest.java new file mode 100644 index 00000000..b938c63b --- /dev/null +++ b/prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsSetTest.java @@ -0,0 +1,404 @@ +package p.studio.compiler.backend.irvm; + +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; +import p.studio.compiler.pbs.*; +import p.studio.compiler.pbs.lexer.PbsLexer; +import p.studio.compiler.pbs.parser.PbsParser; +import p.studio.compiler.models.SourceKind; +import p.studio.compiler.source.diagnostics.DiagnosticSink; +import p.studio.compiler.source.identifiers.FileId; +import java.nio.charset.StandardCharsets; +import java.nio.file.*; +import static org.junit.jupiter.api.Assertions.*; + +class PbsSetTest { + static String sdk() throws Exception { + try(var stream=PbsSetTest.class.getResourceAsStream("/game/stdlib/1/sdk/collections/main.pbs")) { + assertNotNull(stream);return new String(stream.readAllBytes(),StandardCharsets.UTF_8); + } + } + static void compile(String name,String source)throws Exception{PbsListCursorTest.compileCollection("set",name,source);} + static void probe(String name,String body)throws Exception{compile(name,"declare service Probe {fn main()->int {"+body+"}}");} + @Test void constructionEveryOperationAndGrowthUseTheSourceSdk()throws Exception { + probe("basic",""" + let values:set=new set();let alias=values; + if values.isEmpty()==false or values.size()!=(0 as long) {return 0;} + if values.contains(42) or values.remove(42) {return 0;} + if values.add(42)==false or values.add(42) {return 0;} + if alias.size()!=(1 as long) or alias.contains(42)==false {return 0;} + if values.remove(42)==false or values.remove(42) {return 0;} + if values.isEmpty()==false {return 0;} + for i:int from 0 until 40 {if values.add(i)==false {return 0;}} + for i:int from 0 until 40 {if alias.contains(i)==false {return 0;}} + if values.size()!=(40 as long) {return 0;} + for i:int from 0 until 40 {if values.remove(i)==false {return 0;}} + values.add(9);values.clear();values.clear(); + if values.isEmpty()==false or values.contains(9) {return 0;} + values.add(42);let cursor=values.cursor();return cursor.current() else 0; + """); + probe("construction",""" + let a:set=new set<>();let b:optional (set)=some(new set()); + if let values=b {values.add(42);if values.size()!=(1 as long) {return 0;}} else {return 0;} + if a.isEmpty()==false {return 0;}return 42; + """); + probe("arithmetic",""" + let maximum:long=4294967295;let sizeMaximum:long=9223372036854775807; + if _setCapacity(0,1)!=(8 as long) or _setCapacity(8,6)!=(8 as long) {return 0;} + if _setCapacity(8,7)!=(16 as long) or _setCapacity(16,13)!=(32 as long) {return 0;} + if _setCapacity(maximum-1,maximum)!=maximum {return 0;} + if _setCapacity(maximum,maximum+1)!=maximum {return 0;} + if _setNextSize(sizeMaximum-1)!=sizeMaximum {return 0;} + let minimum:long=-9223372036854775808; + if _setBucket(minimum,maximum)<(0 as long) or _setBucket(-1,8)!=(7 as long) {return 0;} + return 42; + """); + } + @Test void basicDefaultsKeepValueDomainsAndPresence()throws Exception { + probe("scalars",""" + let ints=new set();ints.add(-2147483648);ints.add(0);ints.add(42); + if ints.add(-2147483648) or ints.size()!=(3 as long) {return 0;} + let longs=new set();longs.add(-9223372036854775808);longs.add(9223372036854775807); + if longs.contains(-9223372036854775808)==false {return 0;} + let booleans=new set();booleans.add(false);booleans.add(true); + if booleans.add(false) or booleans.size()!=(2 as long) {return 0;} + let floats=new set();floats.add(0.0); + if floats.add(-0.0) or floats.contains(-0.0)==false {return 0;} + floats.add(0.5);if floats.remove(-0.0)==false or floats.size()!=(1 as long) {return 0;} + let strings=new set();strings.add("hello");let constructed="hel"+"lo"; + if strings.add(constructed) or strings.contains(constructed)==false {return 0;} + strings.add("");strings.add("ação 😀"); + if strings.size()!=(3 as long) {return 0;}return 42; + """); + } + @Test void objectsAndContractReceiversKeepInstanceIdentity()throws Exception { + compile("objects",""" + declare contract Read {fn read()->int;} + declare struct Item(pub mut value:int); + implements Read for Item using item {fn read()->int{return item.value;}} + declare service Probe {fn main()->int { + let a=new Item(20);let b=new Item(20);let values=new set();let alias=values; + if values.add(a)==false or values.add(b)==false or values.add(a) {return 0;} + a.value=42;if alias.contains(a)==false {return 0;} + let views=new set();views.add(a as Read); + if views.add(a as Read) or views.add(b as Read)==false {return 0;} + if views.size()!=(2 as long) or views.contains(a as Read)==false {return 0;} + if values.remove(a)==false or values.contains(b)==false {return 0;}return a.value; + }} + """); + } + @Test void optionalMissingDefaultsAndPositionalAccessReject()throws Exception { + for(var source:new String[]{ + "fn test(){let values=new set();}", + "fn test(){let values=new set<(x:int,y:int)>();}", + "fn test(){let values=new set();values[0]=42;}", + "fn test(){let values=new set();values._hash(42);}", + "fn test(){let values=new set();let hidden=values.buckets;}", + "fn test(){let values=new set(8);}", + "fn test(){let values:set=new set();}", + "fn test(){let values=new set(42);}"}) { + var diagnostics=DiagnosticSink.empty();var id=new FileId(0); + var ast=PbsParser.parse(PbsLexer.lex(sdk()+source,id,diagnostics),id,diagnostics,PbsParser.ParseMode.INTERFACE_MODULE); + new PbsFrontendCompiler().compileParsedFile(id,ast,diagnostics,SourceKind.PROJECT,new p.studio.compiler.source.identifiers.ModuleId(0), + p.studio.utilities.structures.ReadOnlyList.empty(),p.studio.compiler.messages.HostAdmissionContext.permissiveDefault(), + p.studio.compiler.messages.FESurfaceContext.empty(),new p.studio.compiler.source.tables.NameTable()); + assertTrue(diagnostics.hasErrors(),source); + if(source.contains("setd.getCode().equals("E_SEM_GENERIC_SET_OPTIONAL_ELEMENT"))); + if(source.contains("set<(x:"))assertTrue(diagnostics.stream().anyMatch(d->d.getCode().equals("E_SEM_GENERIC_SET_IDENTITY_REQUIRED"))); + } + } + @Test void receiverArgumentsAndNamedApplicationEvaluateOnceInSourceOrder()throws Exception { + compile("evaluation",""" + declare struct Effects(pub mut trace:int,pub values:set){ + fn receiver()->set{this.trace=this.trace*10+1;return this.values;} + fn value()->int{this.trace=this.trace*10+2;return 42;} + } + fn include(values:set,value:int)->bool{return values.add(value);} + declare service Probe {fn main()->int{ + let values=new set.make();let effects=new Effects(0,values); + effects.receiver().add(effects.value());if effects.trace!=12{return 0;} + effects.trace=0;effects.receiver().add apply effects.value();if effects.trace!=12{return 0;} + effects.trace=0;if effects.receiver().contains(effects.value())==false or effects.trace!=12{return 0;} + effects.trace=0;if (effects.receiver().remove apply effects.value())==false {return 0;} + if effects.trace!=12 or values.isEmpty()==false{return 0;} + effects.trace=0;if (include apply (value:effects.value(),values:effects.receiver()))==false{return 0;} + if effects.trace!=21{return 0;}return 42; + }} + """); + } + @Test void collisionCountersProveRehashAndCaptureNeverCallStrategies()throws Exception { + compile("collisions",""" + declare struct Policy(pub mut hashes:int,pub mut comparisons:int); + implements Identity for Policy using policy { + fn hash(value:int)->long {policy.hashes=policy.hashes+1;return -9223372036854775808;} + fn equals(left:int,right:int)->bool {policy.comparisons=policy.comparisons+1;return left==right;} + } + declare service Probe {fn main()->int { + let policy=new Policy(0,0);let values=new set(policy); + for i:int from 0 until 6 {values.add(i);} + if policy.hashes!=6 or policy.comparisons!=15 {return 0;} + let comparisons=policy.comparisons; + values.add(6); + if policy.hashes!=7 or policy.comparisons!=comparisons+6 {return 0;} + let captured=values.cursor();let saved=policy.comparisons; + if policy.hashes!=7 or saved!=21 {return 0;} + let total:int=0; + while true { + if let value=captured.current() {total=total+value;} else {break;} + if captured.hasNext() {captured.next();} else {break;} + } + if policy.hashes!=7 or policy.comparisons!=saved or total!=21 {return 0;} + if values.add(6) or policy.hashes!=8 {return 0;} + for i:int from 7 until 30 {values.add(i);} + for i:int from 0 until 30 {if values.contains(i)==false {return 0;}} + for i:int from 0 until 30 {if values.remove(i)==false {return 0;}} + if values.isEmpty()==false {return 0;}return 42; + }} + """); + } + @Test void explicitContentPolicyKeepsTheFirstActualReferenceAndGroupedValues()throws Exception { + compile("content",""" + declare struct Item(pub mut key:int,pub mut health:int); + declare service Policy {} + implements Identity for Policy using policy { + fn hash(value:Item)->long {return value.key as long;} + fn equals(left:Item,right:Item)->bool {return left.key==right.key;} + } + declare service Probe {fn main()->int { + let first=new Item(7,20);let second=new Item(7,22);let values=new set(Policy); + if values.add(first)==false or values.add(second) or values.size()!=(1 as long) {return 0;} + first.health=42;let cursor=values.cursor(); + if let value=cursor.current() {if value!=first {return 0;}} else {return 0;} + if values.remove(second)==false {return 0;} + first.key=9;values.add(first);if values.contains(first)==false {return 0;}return first.health; + }} + """); + compile("tuple",""" + declare service Policy {} + implements Identity<(left:int,right:int)> for Policy using policy { + fn hash(value:(left:int,right:int))->long {return value.left as long;} + fn equals(a:(left:int,right:int),b:(left:int,right:int))->bool {return a.left==b.left && a.right==b.right;} + } + declare service Probe {fn main()->int { + let values=new set<(left:int,right:int)>(Policy); + if values.add((left:20,right:22))==false or values.add((left:20,right:22)) {return 0;} + values.add((left:20,right:1));let cursor=values.cursor();values.clear(); + let total:int=0; + while true { + if let value=cursor.current() {if value.right==22 {total=value.left+value.right;}} else {break;} + if cursor.hasNext() {cursor.next();} else {break;} + } + return total; + }} + """); + } + @Test void snapshotsKeepSharedProtocolAndMutationsDoNotRewriteCapture()throws Exception { + probe("cursor-empty","let values=new set();let cursor=values.cursor();values.add(42);cursor.next();if cursor.current().hasSome() or cursor.hasNext(){return 0;}return 42;"); + probe("cursor-single","let values=new set();values.add(42);let cursor=values.cursor();values.clear();cursor.next();cursor.next();if cursor.hasNext(){return 0;}return cursor.current() else 0;"); + probe("snapshot",""" + let values=new set();values.add(0);values.add(20);values.add(22);let cursor=values.cursor(); + values.remove(20);for i:int from 0 until 40 {values.add(i);}values.clear(); + let total:int=0;let count:int=0; + while true { + if let value=cursor.current() {total=total+value;count=count+1;} else {break;} + if cursor.hasNext() {cursor.next();} else {break;} + } + if count!=3 or cursor.current().hasNone() {return 0;}return total; + """); + compile("contract-snapshot",""" + declare contract Read{fn read()->int;} + declare struct Item(pub mut value:int); + implements Read for Item using item{fn read()->int{return item.value;}} + declare service Probe{fn main()->int{ + let item=new Item(20);let values=new set();values.add(item as Read); + let cursor=values.cursor();values.clear();item.value=42; + if let view=cursor.current(){return view.read();}return 0; + }} + """); + probe("string-snapshot",""" + let values=new set();let text="hel"+"lo";values.add(text); + let cursor=values.cursor();values.clear(); + if let value=cursor.current(){if value=="hello"{return 42;}}return 0; + """); + probe("false-snapshot",""" + let values=new set();values.add(false);let cursor=values.cursor();values.clear(); + cursor.next();if cursor.hasNext(){return 0;} + if let value=cursor.current(){if value==false{return 42;}}return 0; + """); + } + @Test void callbackReadsAreAllowedAndAliasReentrancyRefuses()throws Exception { + String policy=""" + declare struct Policy(pub mut target:optional set,pub mut mode:int,pub mut reads:int); + implements Identity for Policy using policy { + fn hash(value:int)->long { + if let target=policy.target { + if policy.mode==1 {target.add(9);} + if policy.mode==2 {target.remove(9);} + if policy.mode==3 {target.clear();} + if policy.mode==4 {target.contains(9);} + if policy.mode==5 {let failure=1/0;} + let size=target.size();let empty=target.isEmpty();let cursor=target.cursor(); + if empty && cursor.current().hasSome() {let failure=1/0;} + policy.reads=policy.reads+1; + } + return 0; + } + fn equals(left:int,right:int)->bool {return left==right;} + } + """; + compile("callback-reads",policy+""" + declare service Probe {fn main()->int { + let policy=new Policy(none,0,0);let values=new set(policy);let alias=values;policy.target=some(alias); + values.add(42);if values.contains(42)==false or policy.reads!=2 {return 0;} + values.remove(42);if policy.reads!=3 or values.isEmpty()==false {return 0;}return 42; + }} + """); + for(int mode=1;mode<=5;mode++)compile("fault-callback-"+mode,policy+"declare service Probe {fn main()->int {let policy=new Policy(none,"+mode+",0);let values=new set(policy);let alias=values;policy.target=some(alias);values.add(42);return 0;}}"); + probe("fault-overflow","_setNextSize(9223372036854775807);return 0;"); + } + @Test void arraysFunctionsAndRandomKeepReferenceDefaults()throws Exception { + compile("references",""" + fn closure()->Fn()->int {return fn []()->int{return 42;};} + declare service Probe {fn main()->int { + let arrays=new set>();let a:array=[1];let b:array=[1]; + arrays.add(a);arrays.add(b);a[0]=42; + if arrays.add(a) or arrays.contains(a)==false or arrays.size()!=(2 as long) {return 0;} + let calls=new setint>();let first=closure();let second=closure(); + calls.add(first);calls.add(second);if calls.add(first) or calls.size()!=(2 as long) {return 0;} + let cursor=calls.cursor();calls.clear();if let f=cursor.current(){return f();}return 0; + }} + """); + String random; + try(var stream=getClass().getResourceAsStream("/game/stdlib/1/sdk/random/main.pbs")) { + assertNotNull(stream);random=new String(stream.readAllBytes(),StandardCharsets.UTF_8); + } + // SDK intrinsic service signatures live in an interface; the application body is a free function. + compile("random",random+""" + fn randomSetProbe()->int { + let values=new set();let a=random.new(42);let b=random.new(42); + values.add(a);values.add(b);random.next(a); + if values.add(a) or values.contains(a)==false or values.size()!=(2 as long){return 0;}return 42; + } + declare service Probe {fn main()->int{return randomSetProbe();}} + """); + } + @Test void nativeGroupStrategiesPreserveAllSlots()throws Exception { + compile("vec2",""" + [BuiltinType(name="vec2",version=1)] declare builtin type Vector(pub x:float,pub y:float) {} + declare service Policy {} + implements Identity for Policy using policy { + fn hash(value:Vector)->long {return 0;} + fn equals(a:Vector,b:Vector)->bool{return a.x==b.x && a.y==b.y;} + } + fn vectorProbe()->int { + let values=new set(Policy);values.add(new Vector(20.0,22.0)); + if values.add(new Vector(20.0,22.0)) {return 0;} + let cursor=values.cursor();values.clear(); + if let value=cursor.current(){return (value.x+value.y) as int;}return 0; + } + declare service Probe {fn main()->int{return vectorProbe();}} + """); + compile("pixel",""" + [BuiltinType(name="color",version=1)] declare builtin type Color(pub raw:long) {} + [BuiltinConst(target="color",name="red",version=1)] declare const RED:Color; + [BuiltinType(name="pixel",version=1)] declare builtin type Pixel(pub x:long,pub y:long,pub color:Color) {} + declare service Policy {} + implements Identity for Policy using policy { + fn hash(value:Pixel)->long{return value.x;} + fn equals(a:Pixel,b:Pixel)->bool{return a.x==b.x && a.y==b.y && a.color==b.color;} + } + fn pixelProbe()->int { + let values=new set(Policy);values.add(new Pixel(20,22,RED)); + if values.add(new Pixel(20,22,RED)){return 0;} + let cursor=values.cursor();values.clear(); + if let value=cursor.current(){if value.color!=RED{return 0;}return (value.x+value.y) as int;}return 0; + } + declare service Probe {fn main()->int{return pixelProbe();}} + """); + } + @Test void importsReexportsAndHashAliasesCompileFromRealSdkModules(@TempDir Path root)throws Exception { + Files.createDirectories(root.resolve("src/facade")); + Files.writeString(root.resolve("prometeu.json"),""" + {"name":"app","version":"1.0.0","language":"pbs","stdlib":"1","target":"Game","dependencies":[]} + """); + Files.writeString(root.resolve("src/mod.barrel"),"pub fn frame()->void;"); + Files.writeString(root.resolve("src/facade/mod.barrel"),"pub struct Values;pub contract Walk;pub fn refHash(value:T)->long;"); + Files.writeString(root.resolve("src/facade/main.pbs"),"import {set as Values,Cursor as Walk} from @sdk:collections;import {referenceHash as refHash} from @sdk:hash;"); + Files.writeString(root.resolve("src/main.pbs"),""" + import {Values,Walk,refHash} from @app:facade; + import {hash as Hash} from @sdk:hash; + [Frame] fn frame()->void { + let values:Values=new Values();values.add(20);values.add(22); + if values.add(20){let failure=1/0;} + let before=refHash>(values);let cursor:Walk=values.cursor();values.clear(); + let expected:long=-8804195676797548855; + if before!=refHash>(values) or Hash.i64(-1)!=expected{let failure=1/0;} + let total:int=0; + while true{if let value=cursor.current(){total=total+value;}else{break;}if cursor.hasNext(){cursor.next();}else{break;}} + if total!=42{let failure=1/0;} + } + """); + var result=p.studio.compiler.workspaces.BuilderPipelineService.INSTANCE.compile( + p.studio.compiler.models.BuilderPipelineContext.fromConfig(new p.studio.compiler.messages.BuilderPipelineConfig(false,root.toString())), + p.studio.utilities.logs.LogAggregator.stdout()); + assertFalse(result.diagnostics().stream().anyMatch(d->d.isError()),result.diagnostics().toString()); + Files.write(Path.of(System.getProperty("pbs.registryConformanceDirectory")).resolve("pbs-set-imports.pbx"),result.bytecodeBytes()); + } + @Test void resourceFixturesExposePreparationGrowthMutationAndCapture()throws Exception { + for(var operation:java.util.Map.of( + "growth","values.add(42);","add","values.add(42);","duplicate","values.add(1);", + "remove","values.remove(1);","clear","values.clear();","cursor","let snapshot=values.cursor();").entrySet()) { + int count=operation.getKey().equals("growth")?6:5; + compile("refusal-"+operation.getKey(),""" + fn mutationMarker(){let marker:int=314160;} + fn completedMarker(){let marker:int=314161;} + fn performSecond(values:set){OPERATION} + fn perform(values:set){performSecond(values);} + declare service Probe {fn main()->int { + let values=new set();for i:int from 0 until COUNT {values.add(i);} + mutationMarker();perform(values);completedMarker();return 42; + }} + """.replace("COUNT",Integer.toString(count)).replace("OPERATION",operation.getValue())); + } + } + @Test void explicitPostPublicationFaultInjectionDoesNotClaimProductionRefusalFrequency()throws Exception { + // Only this fixture gets a controlled allocation after real source table installation. + // It qualifies the failure boundary; natural quota cases are measured separately. + String injected=sdk().replace("this.buckets = published;",""" + this.buckets = published; + if this.length == (6 as long) {let injectedQuotaProbe=new array(1000000);} + """); + PbsListCursorTest.compileCollection("set","injected-refusal-growth",""" + declare service Probe {fn main()->int { + let values=new set();for i:int from 0 until 6 {values.add(i);} + values.add(42);return 42; + }} + """,injected); + } + @Test void snapshotPrefixesFinalValuesAndRemovedNodesUseRealGc()throws Exception { + compile("gc",""" + declare struct Item(pub value:int);declare struct Garbage(); + fn collect(){let marker:int=314159;} + fn makeCursor()->Cursor{ + let values=new set();for i:int from 0 until 1200 {values.add(new Item(i));}return values.cursor(); + } + fn useCursor(){ + let cursor=makeCursor();collect();for i:int from 0 until 1199 {cursor.next();}collect(); + if let last=cursor.current(){ + for i:int from 0 until 1200 {cursor.next();}collect(); + if let still=cursor.current(){if still!=last {let failure=1/0;}}else{let failure=1/0;} + }else{let failure=1/0;} + } + declare service Probe {fn main()->int{useCursor();for i:int from 0 until 1200{let item=new Garbage();}collect();return 42;}} + """); + compile("gc-collection",""" + declare struct Item(pub value:int);declare struct Garbage(); + fn collect(){let marker:int=314159;} + fn pressure(){for i:int from 0 until 1200 {let item=new Garbage();}} + fn create()->set{let values=new set();for i:int from 0 until 64 {values.add(new Item(i));}return values;} + fn discard(values:set){let cursor=values.cursor();for i:int from 0 until 3 {if let value=cursor.current(){values.remove(value);}cursor.next();}} + fn useCollection(){let values=create();pressure();collect();discard(values);pressure();collect();values.clear();pressure();collect();} + declare service Probe {fn main()->int{useCollection();pressure();collect();return 42;}} + """); + } +} diff --git a/prometeu-architecture-tests/src/test/resources/hash/hash-conformance.tsv b/prometeu-architecture-tests/src/test/resources/hash/hash-conformance.tsv new file mode 100644 index 00000000..e5f34915 --- /dev/null +++ b/prometeu-architecture-tests/src/test/resources/hash/hash-conformance.tsv @@ -0,0 +1,119 @@ +kind input expected_hash_hex +bytes EF46DB3751D8E999 +bytes 11 AD10CD9780AC4FF7 +bytes 1194 B22635899E8F2235 +bytes 119417 40626D96276E4594 +bytes 1194179a 882207C122C76E23 +bytes 1194179a1d A3DA885EEC618BB4 +bytes 1194179a1da0 AD9C2ECD863325F1 +bytes 1194179a1da023 CFC90033AA9DAC4F +bytes 1194179a1da023a6 90FDA2F089FA86DE +bytes 1194179a1da023a629 A80DEB192B8C5215 +bytes 1194179a1da023a629ac 3AAF07FC10721C6D +bytes 1194179a1da023a629ac2f D2953E1354CAEF18 +bytes 1194179a1da023a629ac2fb2 333861B25FD6348B +bytes 1194179a1da023a629ac2fb235 4E8F0D349A6F20EF +bytes 1194179a1da023a629ac2fb235b8 4DF943FE248C8BBA +bytes 1194179a1da023a629ac2fb235b83b 59F95BAD12D14C9D +bytes 1194179a1da023a629ac2fb235b83bbe 3A5B1165D151AA50 +bytes 1194179a1da023a629ac2fb235b83bbe41 C0BBB6AC5DBEFE29 +bytes 1194179a1da023a629ac2fb235b83bbe41c4 A43333C50C99A7B9 +bytes 1194179a1da023a629ac2fb235b83bbe41c447 F919C24061C10223 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca BD5C3B7ACE1CF9C6 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4d 2718C52BDD650ABF +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd0 955BDFDEB57244D6 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053 B2D26D6E52E62480 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d6 22A0F61ABE725BF4 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659 2E7D73F3896A812E +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc 05286F7B4D3669BA +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5f 581E8369415863B4 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe2 3BEE93D5A57498CA +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265 186A89BD8A211C92 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e8 C2FE19097A329DE7 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86b 44CC9EFE5D2D0233 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee 0E1AAB1D173CF196 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71 5C820B4B4FE28FDC +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f4 674271278616AB41 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477 22DE45605909B372 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa 4085F13B32C5FEB0 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d 92E43D6D89A524DE +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d00 36BD670CD3955867 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d0083 D0AB734277760E45 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306 C0441297B12D2395 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d00830689 77DEC64A3B3BC5C3 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c 32AC8537AA1EE157 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f 533C78D7B4373E03 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f12 0D95EE4190E08749 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295 A05508CB6737D409 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f129518 C87DD14C48FE91C1 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b A4D02F0326869446 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1e 8E7952E9DB8EAE71 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea1 4C5A1F7910733F74 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124 4D87691089AA979B +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a7 7B9CF9C7EE42EDFF +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72a C1A02E8D0A24430D +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad 1B90E8100ED94B5E +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30 BD61FC2BF492D4DD +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b3 910E8A09EEB42EC5 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336 88576C889955FCE8 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b9 247644B2BC54C238 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93c F30240A3A869130B +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf 319659E04033E85D +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42 137A5DEB3F660384 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c5 159B99D9E0929A9A +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548 D73D713C67CE4B7A +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb 1153D36CADE87066 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4e D4C20EF54CBC9F67 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed1 AC086C9B87BAEA67 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154 1B497BB2FD3D5691 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d7 087FA05DC97EEEBD +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75a F9394FBD99B2B1E1 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add 4F755863C483139B +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60 56F7033D775AE682 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82b D8137F7D8598EB90 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae C0331DAE6E064E2C +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31 BC3294E0954E656F +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b 5493AA81F81FD0D9 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e 9441529208FCB7EC +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e91 81755BB24BDE67E2 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b FC0C21A234C0A092 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e FA7639C7A1C6E86E +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e11 750F529A50862B96 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e 858367D2F49055A4 +bytes 1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e1194179a1da023a629ac2fb235b83bbe41c447ca4dd053d659dc5fe265e86bee71f477fa7d008306890c8f1295189b1ea124a72aad30b336b93cbf42c548cb4ed154d75add60e366e96cef72f578fb7e0184078a0d901396199c1fa225a82bae31b437ba3dc043c649cc4fd255d85bde61e467ea6df073f679fc7f0285088b0e9114971a9d20a326a92caf32b538bb3ec144c74acd50d356d95cdf62e568eb6ef174f77afd800386098c0f9215981b9e21a427aa2db033b639bc3fc245c84bce51d457da5de063e669ec6ff275f87bfe8104870a8d109316991c9f22a528ab2eb134b73abd40c346c94ccf52d558db5ee164e76aed70f376f97cff8205880b8e11 1C81641E680C8227 +i64 0 34C96ACDCADB1BBB +i64 1 9F29CB17A2A49995 +i64 -1 85D136ADB773C6C9 +i64 2 EAC73E4044E82DB0 +i64 -2 BAB3B83CF164D97F +i64 -9223372036854775808 3F425EACF01544E0 +i64 9223372036854775807 FF70CC60366E770C +i64 9007199254740993 E61780137AF44266 +i64 4294967296 CA6084DF268EA2A9 +float 0000000000000000 34C96ACDCADB1BBB +float 8000000000000000 34C96ACDCADB1BBB +float 3FF0000000000000 949522F153A1A395 +float BFF0000000000000 A12F6FC677BC860E +float 3FE0000000000000 48CB5E118059DA42 +float BFE0000000000000 EAE223A5665F292E +float 0000000000000001 9F29CB17A2A49995 +float 8000000000000001 044E434D0C94F9C4 +float 000FFFFFFFFFFFFF 4E2C69F1F7F6CB63 +float 0010000000000000 177C9E1BA22DCD5A +float 7FEFFFFFFFFFFFFF 2B67450CEDC2D98B +float FFEFFFFFFFFFFFFF BF1A70DEAECB5D63 +float 4340000000000000 A5716302E37132C7 +string EF46DB3751D8E999 +string 68656c6c6f 26C7827D889F6DA3 +string 00 E934A84ADB052768 +string 61c3a7c3a36f20f09f9880 47D0DCD7A1C3868D +string 61616161616161616161616161616161616161616161616161616161616161 FE47067CDA802916 +string 6161616161616161616161616161616161616161616161616161616161616161 856E843298F99AD7 +string 616161616161616161616161616161616161616161616161616161616161616161 18F3FF0C21E3B24B +string 7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a7a 92FD8D6AD9EE4549 +reference 0,1 CA6084DF268EA2A9 +reference 1,1 288EC41B1AB5A63C +reference 1,2 CD3D4C871EE4183A +reference 1024,1 25BF80C69CB54435 +reference 4294967295,4294967295 85D136ADB773C6C9 +null null 0000000000000000 diff --git a/prometeu-architecture-tests/src/test/resources/hash/provenance.txt b/prometeu-architecture-tests/src/test/resources/hash/provenance.txt new file mode 100644 index 00000000..cc69e4db --- /dev/null +++ b/prometeu-architecture-tests/src/test/resources/hash/provenance.txt @@ -0,0 +1,5 @@ +Provider: dcf6561ea73446e0a3e1cf1c73eda20923b38df0 +Source: crates/console/prometeu-vm/tests/fixtures/hash-conformance.tsv +SHA-256: a863486eaea14ab1a010f076f355eed0d5738207dad3651f7d10e92fc09f74d4 +Independent XXH64 C v0.8.3 oracle; see provider tests/fixtures/hash-oracle.md. +Copied unchanged. Source producer tests select scalar/String rows; raw-byte and reference vectors remain provider evidence. diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsContractTypes.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsContractTypes.java index 2a9f177c..f24e11b8 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsContractTypes.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsContractTypes.java @@ -73,7 +73,11 @@ public final class PbsContractTypes { declarations.put(name, declaration); scopes.computeIfAbsent(declaration.span().getFileId(), ignored -> new HashMap<>()).put(name, declaration); } - if (declaration instanceof PbsAst.ImplementsDecl implementation && implementations.stream().noneMatch(i -> i.span().equals(implementation.span()))) implementations.add(implementation); + // A generic owner family produces several concrete implementations at the + // same source span. Deduplicating by span alone loses all but its first T. + if (declaration instanceof PbsAst.ImplementsDecl implementation && implementations.stream().noneMatch(i -> + i.span().equals(implementation.span())&&key(i.ownerType()).equals(key(implementation.ownerType())) + &&key(i.contractType()).equals(key(implementation.contractType())))) implementations.add(implementation); } public PbsAst.TopDecl declaration(PbsAst.TypeRef type) { diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsGenericInstantiation.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsGenericInstantiation.java index 9e9c6fa3..93386d15 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsGenericInstantiation.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsGenericInstantiation.java @@ -221,7 +221,14 @@ public final class PbsGenericInstantiation { if (t == null) return null; var rewritten = super.type(t); var d = types.declaration(t); - if (t.kind() != PbsAst.TypeRefKind.SIMPLE || d == null || PbsContractTypes.applicationOrigin(d) != null) return rewritten; + if (t.kind() != PbsAst.TypeRefKind.SIMPLE || d == null) return rewritten; + var origin=PbsContractTypes.applicationOrigin(d); + if(origin!=null) { + // A concrete argument still belongs to its defining module. + // The generic function's module must import that application. + dependency(definition,origin.declaration()); + return rewritten; + } var alias = nominalBinding(d); types.index(new PbsAst.TypeBindingDecl(alias, d, definition)); var file = concrete.containsKey(definition.getFileId()) ? definition.getFileId() : sources.getFirst().ast().span().getFileId(); @@ -237,8 +244,8 @@ public final class PbsGenericInstantiation { error("ARITY", name(template)+" requires "+parameters(template).size()+" explicit type argument(s)", site); return null; } - if (PbsSdkCollections.isIndexedCollection(template) && PbsSdkCollections.directOptional(arguments.getFirst())) { - error(PbsSdkCollections.isLinked(template) ? "LINKED_OPTIONAL_ELEMENT" : "LIST_OPTIONAL_ELEMENT", + if (PbsSdkCollections.isCollection(template) && PbsSdkCollections.directOptional(arguments.getFirst())) { + error(PbsSdkCollections.isSet(template)?"SET_OPTIONAL_ELEMENT":PbsSdkCollections.isLinked(template) ? "LINKED_OPTIONAL_ELEMENT" : "LIST_OPTIONAL_ELEMENT", "SDK " + name(template) + " does not permit a directly optional element", site); return null; } @@ -535,6 +542,11 @@ public final class PbsGenericInstantiation { if (s instanceof PbsAst.ReturnStatement r) return new PbsAst.ReturnStatement(expression(r.value(), result), r.span()); if (s instanceof PbsAst.AssignStatement a) { var target = a.target().expression(); + if(target==null&&!a.target().pathSegments().isEmpty()) { + target=a.target().rootName().equals("this")?new PbsAst.ThisExpr(a.target().span()) + :new PbsAst.IdentifierExpr(a.target().rootName(),a.target().span()); + for(var member:a.target().pathSegments())target=new PbsAst.MemberExpr(target,member,a.target().span()); + } var expected = target == null ? locals.get(a.target().rootName()) : infer(target); return new PbsAst.AssignStatement(a.target(), a.operator(), expression(a.value(), expected), a.span()); } @@ -543,6 +555,10 @@ public final class PbsGenericInstantiation { @Override public PbsAst.Expression expression(PbsAst.Expression e, PbsAst.TypeRef expected) { if (e != null) { budget.visit(e.span(), chain.size()); budget.store(e.span(), 64); } + if(symbolicProbe&&e instanceof PbsAst.MemberExpr member) { + var receiver=infer(member.receiver()); + if(receiver!=null)requiredShapes.add(receiver.name()); + } if (e instanceof PbsAst.CallExpr c) { var callee = expression(c.callee()); var signatures = callableSignatures(callee); @@ -631,8 +647,14 @@ public final class PbsGenericInstantiation { else { error("CONTEXT", "Construction of "+n.typeName()+" requires explicit arguments or an expected application", n.span()); return n; } } var concreteType = type(applied); + if(PbsSdkCollections.isSet(s)&&n.arguments().isEmpty()&&!symbolicProbe) { + var owner=types.declaration(concreteType); + var origin=PbsContractTypes.applicationOrigin(owner); + if(origin!=null&&!PbsSdkCollections.hasDefaultIdentity(origin.arguments().getFirst(),types)) + error("SET_IDENTITY_REQUIRED","This Set element type requires an explicit Identity strategy",n.span()); + } if (symbolicProbe) requiredShapes.add(concreteType.name()); - var constructor = PbsSdkCollections.isIndexedCollection(s) && n.ctorName() == null ? "make" : n.ctorName(); + var constructor = PbsSdkCollections.isCollection(s) && n.ctorName() == null ? "make" : n.ctorName(); if (constructor != null && s.ctors().stream().noneMatch(c -> c.name().equals(constructor) && c.parameters().size() == n.arguments().size())) { error("CONSTRUCTOR_ARITY", "No constructor '" + constructor + "' with " diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsGenericTemplateValidator.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsGenericTemplateValidator.java index 5effd65c..6e349662 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsGenericTemplateValidator.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsGenericTemplateValidator.java @@ -86,13 +86,30 @@ final class PbsGenericTemplateValidator { } @Override public PbsAst.Statement statement(PbsAst.Statement s) { - if (s instanceof PbsAst.LetStatement l) { + if(s instanceof PbsAst.IfStatement branch&&branch.bindingName()!=null) { + var optional=infer(branch.condition(),null); + while(optional!=null&&optional.kind()==PbsAst.TypeRefKind.GROUP)optional=optional.inner(); + var previous=locals;locals=new HashMap<>(locals); + try { + if(optional!=null&&optional.kind()==PbsAst.TypeRefKind.OPTIONAL)locals.put(branch.bindingName(),optional.inner()); + block(branch.thenBlock()); + } finally {locals=previous;} + if(branch.elseIf()!=null)statement(branch.elseIf()); + if(branch.elseBlock()!=null)block(branch.elseBlock()); + return s; + } else if (s instanceof PbsAst.LetStatement l) { var actual = infer(l.initializer(), l.explicitType()); checkCompatible(actual, l.explicitType(), l.span()); locals.put(l.name(), l.explicitType() == null ? actual : l.explicitType()); } else if (s instanceof PbsAst.ReturnStatement r) checkCompatible(infer(r.value(), result), result, r.span()); else if (s instanceof PbsAst.AssignStatement a) { - var target = a.target().expression() == null ? locals.get(a.target().rootName()) : infer(a.target().expression(), null); + var expression=a.target().expression(); + if(expression==null&&!a.target().pathSegments().isEmpty()) { + expression=a.target().rootName().equals("this")?new PbsAst.ThisExpr(a.target().span()) + :new PbsAst.IdentifierExpr(a.target().rootName(),a.target().span()); + for(var member:a.target().pathSegments())expression=new PbsAst.MemberExpr(expression,member,a.target().span()); + } + var target = expression == null ? locals.get(a.target().rootName()) : infer(expression, null); // Indexed writes accept the element, while indexed reads are optional. if(a.target().expression() instanceof PbsAst.IndexExpr && target!=null && target.kind()==PbsAst.TypeRefKind.OPTIONAL) target=target.inner(); diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsSdkCollections.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsSdkCollections.java index 91c73bb8..fe5e913e 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsSdkCollections.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/PbsSdkCollections.java @@ -15,6 +15,26 @@ public final class PbsSdkCollections { public static boolean isIndexedCollection(PbsAst.TopDecl declaration) { return isList(declaration) || isLinked(declaration); } + public static boolean isSet(PbsAst.TopDecl declaration) { + return declaration instanceof PbsAst.StructDecl s && attribute(s.attributes(), "SdkSet") != null; + } + public static boolean isCollection(PbsAst.TopDecl declaration) { + return isIndexedCollection(declaration)||isSet(declaration); + } + public static boolean hasDefaultIdentity(PbsAst.TypeRef type,PbsContractTypes types) { + while(type!=null&&type.kind()==PbsAst.TypeRefKind.GROUP)type=type.inner(); + if(type==null)return false; + if(type.kind()==PbsAst.TypeRefKind.ARRAY||type.kind()==PbsAst.TypeRefKind.FN)return true; + if(type.kind()!=PbsAst.TypeRefKind.SIMPLE)return false; + if(java.util.Set.of("int","long","bool","float","str").contains(type.name()))return true; + var declaration=types.declaration(type); + if(declaration instanceof PbsAst.StructDecl||declaration instanceof PbsAst.ServiceDecl||declaration instanceof PbsAst.ContractDecl)return true; + if(declaration instanceof PbsAst.BuiltinTypeDecl builtin) { + var binding=builtin.attributes().stream().filter(a->a.name().equals("BuiltinType")).findFirst().orElse(null); + return binding!=null&&argument(binding,"name").equals("Random"); + } + return false; + } public static PbsAst.Attribute attribute(ReadOnlyList attributes, String name) { return attributes.stream().filter(a -> a.trustedSdkOrigin() && a.name().equals(name)).findFirst().orElse(null); } diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsExecutableBodyLowerer.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsExecutableBodyLowerer.java index 7d5e603f..9a81a3d7 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsExecutableBodyLowerer.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsExecutableBodyLowerer.java @@ -61,7 +61,11 @@ final class PbsExecutableBodyLowerer { var binding = functionDecl.attributes().stream().filter(a -> "IntrinsicCall".equals(a.name())).findFirst(); final boolean terminated; var storageBinding = p.studio.compiler.pbs.PbsSdkCollections.attribute(functionDecl.attributes(), "StoragePrimitive"); - if (storageBinding != null) { + var identityBinding = p.studio.compiler.pbs.PbsSdkCollections.attribute(functionDecl.attributes(), "IdentityPrimitive"); + if (identityBinding != null) { + lowerIdentityPrimitive(functionDecl,identityBinding,context); + terminated = true; + } else if (storageBinding != null) { lowerStoragePrimitive(functionDecl,storageBinding,context); terminated = true; } else if (binding.isPresent()) { @@ -1613,6 +1617,61 @@ final class PbsExecutableBodyLowerer { span); } + private void lowerIdentityPrimitive(PbsAst.FunctionDecl function, PbsAst.Attribute binding, PbsExecutableLoweringContext c) { + var operation=p.studio.compiler.pbs.PbsSdkCollections.argument(binding,"name"); + boolean equality=operation.equals("referenceEquals")||operation.equals("defaultEquals"); + boolean fallback=operation.equals("defaultHash")||operation.equals("defaultEquals"); + if(!fallback&&!operation.equals("referenceHash")&&!operation.equals("referenceEquals")) + throw new IllegalArgumentException("Unknown identity binding: "+operation); + var type=PbsRuntimeTypes.unwrap(function.parameters().getFirst().typeRef()); + var span=function.span();int width=c.types().slots(type); + boolean reference=c.types().identitySource(type); + var scalar=c.types().canonical(type); + if(!reference&&(!fallback||!java.util.Set.of("int","long","bool","float","str").contains(scalar))) { + // Explicit strategy Sets instantiate this unreachable default branch too. + // Public reference queries always reject ineligible source applications. + if(!fallback) p.studio.compiler.source.diagnostics.Diagnostics.error(c.diagnostics(), + "E_SEM_IDENTITY_REFERENCE_TYPE","Reference identity requires Struct, Array, Fn, contract or Random", + function.applicationOrigin()==null?span:function.applicationOrigin().requestedAt()); + c.instructions().add(new IRBackendExecutableFunction.Instruction(IRBackendExecutableFunction.InstructionKind.TRAP,"",null,null,span)); + return; + } + emitLoadLocalSlots(0,width*(equality?2:1),span,c); + if(reference) { + var source=c.types().registryType(type); + c.instructions().add(new IRBackendExecutableFunction.Instruction(IRBackendExecutableFunction.InstructionKind.REGISTRY, + null,"",null,null,null,"","",width*(equality?2:1),1,span, + new IRRegistryInstruction(equality?REF_IDENTITY_EQ:REF_IDENTITY_HASH,source,equality?source:null,null,0))); + } else if(equality) { + emitBinaryOperatorInstruction("==",span,c); + } else { + String intrinsic; + switch(scalar) { + case "int" -> {identityIntrinsic("math.i32.to_i64",span,c);intrinsic="hash.i64";} + case "long" -> intrinsic="hash.i64"; + case "float" -> intrinsic="hash.float"; + case "str" -> intrinsic="hash.string"; + case "bool" -> { + var zero=c.nextLabel("bool_hash_zero");var done=c.nextLabel("bool_hash_done"); + emitJump(IRBackendExecutableFunction.InstructionKind.JMP_IF_FALSE,zero,span,c); + emitIdentityLong(1,span,c);emitJump(IRBackendExecutableFunction.InstructionKind.JMP,done,span,c); + emitLabel(zero,span,c);emitIdentityLong(0,span,c);emitLabel(done,span,c);intrinsic="hash.i64"; + } + default -> throw new AssertionError(scalar); + } + identityIntrinsic(intrinsic,span,c); + } + c.instructions().add(new IRBackendExecutableFunction.Instruction(IRBackendExecutableFunction.InstructionKind.RET,"",null,null,span)); + } + private void identityIntrinsic(String name,Span span,PbsExecutableLoweringContext c) { + c.instructions().add(new IRBackendExecutableFunction.Instruction(IRBackendExecutableFunction.InstructionKind.CALL_INTRINSIC, + "",null,new IRBackendExecutableFunction.IntrinsicCallMetadata(name,1,c.intrinsicIdTable().register(name,1)),1,1,span)); + } + private void emitIdentityLong(long value,Span span,PbsExecutableLoweringContext c) { + c.instructions().add(new IRBackendExecutableFunction.Instruction(IRBackendExecutableFunction.InstructionKind.PUSH_I64, + null,"",null,null,null,Long.toString(value),"",null,null,span)); + } + private void lowerStoragePrimitive(PbsAst.FunctionDecl function, PbsAst.Attribute binding, PbsExecutableLoweringContext c) { var operation=p.studio.compiler.pbs.PbsSdkCollections.argument(binding,"name"); var span=function.span(); @@ -1929,13 +1988,19 @@ final class PbsExecutableBodyLowerer { && allocation.typeName().equals("array") && allocation.explicitType() == null) continue; if (listIndex && i==0 && "int".equals(c.types().canonical(actual)) && "long".equals(c.types().canonical(expected))) continue; if (c.types().shapeKey(actual).equals(c.types().shapeKey(expected))) continue; - if (arguments.get(i) instanceof PbsAst.IntLiteralExpr && "long".equals(c.types().canonical(expected))) continue; + if (integerLiteral(arguments.get(i)) && "long".equals(c.types().canonical(expected))) continue; if (c.types().isContract(expected) && c.types().contractTypes.implementers(expected).contains(actual.name())) continue; return false; } return true; } + private static boolean integerLiteral(PbsAst.Expression expression) { + if(expression instanceof PbsAst.GroupExpr group)return integerLiteral(group.expression()); + if(expression instanceof PbsAst.UnaryExpr unary&&"-".equals(unary.operator()))return integerLiteral(unary.expression()); + return expression instanceof PbsAst.IntLiteralExpr; + } + private void emitStructuredFunction(String name, java.util.List parameters, PbsAst.TypeRef returnType, int pops, int pushes, Span span, PbsExecutableLoweringContext c) { var callableId = c.exactLocalCallable(name, parameters, returnType); diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsRuntimeTypes.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsRuntimeTypes.java index 70d2af95..1a0fab1a 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsRuntimeTypes.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/lowering/PbsRuntimeTypes.java @@ -132,6 +132,14 @@ final class PbsRuntimeTypes { return "pbs:" + category + ":file" + span.getFileId().getId() + ":" + span.getStart(); } IRRegistry.TypeRef dynamic() { return builtin(0x15); } + boolean identitySource(PbsAst.TypeRef type) { + var t=unwrap(type); + if(t==null)return false; + return t.kind()==PbsAst.TypeRefKind.ARRAY||t.kind()==PbsAst.TypeRefKind.FN + ||contractTypes.declaration(t) instanceof PbsAst.StructDecl + ||contractTypes.declaration(t) instanceof PbsAst.ServiceDecl + ||isContract(t)||canonical(t).equals("Random"); + } IRRegistry.TypeRef arrayStorage() { var element = dynamic(); var ref = new IRRegistry.TypeRef("pbs:array-storage"); diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/parser/PbsDeclarationParser.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/parser/PbsDeclarationParser.java index d5ffe671..3efe7228 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/parser/PbsDeclarationParser.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/parser/PbsDeclarationParser.java @@ -685,7 +685,7 @@ final class PbsDeclarationParser { final String targetSurface) { for (final var attribute : attributes) { if ("Doc".equals(attribute.name()) || attribute.trustedSdkOrigin() && - java.util.Set.of("SdkList", "SdkLinked").contains(attribute.name()) && "struct declarations".equals(targetSurface)) { + java.util.Set.of("SdkList", "SdkLinked", "SdkSet").contains(attribute.name()) && "struct declarations".equals(targetSurface)) { continue; } p.studio.compiler.source.diagnostics.Diagnostics.error(context.diagnostics(), @@ -724,7 +724,7 @@ final class PbsDeclarationParser { for (final var attribute : attributes) { final PbsAst.LifecycleMarker nextMarker; if ("Doc".equals(attribute.name()) || attribute.trustedSdkOrigin() && - java.util.Set.of("StoragePrimitive","SdkPrivate").contains(attribute.name())) { + java.util.Set.of("StoragePrimitive","IdentityPrimitive","SdkPrivate").contains(attribute.name())) { continue; } if (!isOrdinaryMode()) { diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsEditorialSupportService.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsEditorialSupportService.java index 5986bb30..de8d3bbf 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsEditorialSupportService.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsEditorialSupportService.java @@ -759,7 +759,7 @@ public final class PbsEditorialSupportService { final Map completions = new LinkedHashMap<>(); var symbolic = symbolicStruct(receiverType); if (symbolic != null) { - for (var field : symbolic.fields()) if(!p.studio.compiler.pbs.PbsSdkCollections.isIndexedCollection(symbolic)||field.isPublic()) completions.put(field.name(), new PbsEditorialCompletionCandidate( + for (var field : symbolic.fields()) if(!p.studio.compiler.pbs.PbsSdkCollections.isCollection(symbolic)||field.isPublic()) completions.put(field.name(), new PbsEditorialCompletionCandidate( field.name(), PbsEditorialSymbolKind.FIELD, field.typeRef().surface(), symbolic.name())); for (var method : symbolic.methods()) if(p.studio.compiler.pbs.PbsSdkCollections.attribute(method.attributes(),"SdkPrivate")==null) completions.put(method.name(), new PbsEditorialCompletionCandidate( method.name(), PbsEditorialSymbolKind.METHOD, signatureFromFunction(method.name(), method.parameters(), @@ -778,7 +778,7 @@ public final class PbsEditorialSupportService { final StructInfo structInfo = model.structs.get(receiverType.name()); if (structInfo != null) { for (final var field : structInfo.fields().entrySet()) { - if(model.isSdkIndexedCollection(receiverType)&&!field.getValue().isPublic())continue; + if(model.isSdkCollection(receiverType)&&!field.getValue().isPublic())continue; completions.put(field.getKey(), new PbsEditorialCompletionCandidate( field.getKey(), PbsEditorialSymbolKind.FIELD, diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowExpressionAnalyzer.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowExpressionAnalyzer.java index 65799fb2..340c19a6 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowExpressionAnalyzer.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowExpressionAnalyzer.java @@ -74,6 +74,12 @@ final class PbsFlowExpressionAnalyzer { final PbsAst.Expression expression, final PbsFlowExpressionContext context) { var result = analyzeExpressionUnchecked(expression, context); + if (context.use() == ExprUse.VALUE && context.expectedType() != null + && (context.model().isGenericStruct(result.type()) || context.model().isGenericStruct(context.expectedType())) + && !typeOps.compatible(result.type(), context.expectedType())) { + p.studio.compiler.source.diagnostics.Diagnostics.error(context.diagnostics(), "E_SEM_GENERIC_TYPE_MISMATCH", + "Generic struct applications require the exact declared type arguments", expression.span()); + } if (context.use() == ExprUse.VALUE && context.expectedType() != null && (context.model().isOpaqueBuiltin(result.type()) || context.model().isOpaqueBuiltin(context.expectedType())) && !typeOps.compatible(result.type(), context.expectedType())) { diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowSemanticSupport.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowSemanticSupport.java index 49bdf8c3..e641bdbd 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowSemanticSupport.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/java/p/studio/compiler/pbs/semantics/PbsFlowSemanticSupport.java @@ -202,6 +202,10 @@ final class PbsFlowSemanticSupport { return type != null && p.studio.compiler.pbs.PbsSdkCollections.isIndexedCollection(contractTypes.declaration( type.sourceType() == null ? PbsAst.TypeRef.simple(type.name(), Span.none()) : type.sourceType())); } + boolean isSdkCollection(TypeView type) { + return type != null && p.studio.compiler.pbs.PbsSdkCollections.isCollection(contractTypes.declaration( + type.sourceType() == null ? PbsAst.TypeRef.simple(type.name(), Span.none()) : type.sourceType())); + } boolean isSdkPrivateMember(TypeView type, String member) { if (type == null) return false; var declaration = contractTypes.declaration(type.sourceType() == null @@ -271,6 +275,12 @@ final class PbsFlowSemanticSupport { type.functionInputs(), type.functionOutput(), contractTypes.key(reference), reference, type.implementers()); } + boolean isGenericStruct(TypeView type) { + return type.kind() == Kind.STRUCT && type.sourceType() != null + && p.studio.compiler.pbs.PbsContractTypes.applicationOrigin( + contractTypes.declaration(type.sourceType())) != null; + } + TypeView contractView(PbsAst.TypeRef reference) { var instance = contractTypes.resolve(reference); if (instance == null) return TypeView.unknown(); diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/main.pbs b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/main.pbs index dcf01eb1..09e80365 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/main.pbs +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/main.pbs @@ -307,3 +307,196 @@ declare struct linked(head: optional _LinkedNode, tail: optional _LinkedNo return new _SnapshotCursor(captured) as Cursor; } } + +// Equality policy is independent of private Set storage and reusable by Map. +declare contract Identity { + fn hash(value: T) -> long; + fn equals(left: T, right: T) -> bool; +} + +[IdentityPrimitive(name = "defaultHash")] +fn _collectionHash(value: T) -> long { return 0; } + +[IdentityPrimitive(name = "defaultEquals")] +fn _collectionEquals(left: T, right: T) -> bool { return false; } + +fn _setBucket(hash: long, capacity: long) -> long { + let bucket: long = hash % capacity; + if bucket < (0 as long) { bucket = bucket + capacity; } + return bucket; +} + +fn _setNextSize(length: long) -> long { + let maximum: long = 9223372036854775807; + _bounds(length, maximum); + return length + 1; +} + +fn _setCapacity(capacity: long, required: long) -> long { + let maximum: long = 4294967295; + if capacity == (0 as long) { return 8; } + if capacity < maximum && required > capacity * (3 as long) / (4 as long) { + let candidate: long = capacity * (2 as long); + if candidate > maximum { return maximum; } + return candidate; + } + return capacity; +} + +declare struct _SetNode(pub hash: long, pub value: T, pub mut next: optional _SetNode) { + ctor make(hash: long, value: T, next: optional _SetNode) { + this.hash = hash; + this.value = value; + this.next = next; + } +} + +[SdkSet] +declare struct set(buckets: optional array<_SetNode>, length: long, strategy: optional Identity, busy: bool) { + ctor make() { + this.buckets = none; + this.length = 0; + this.strategy = none; + this.busy = false; + } + ctor make(identity: Identity) { + this.buckets = none; + this.length = 0; + this.strategy = some(identity); + this.busy = false; + } + fn size() -> long { return this.length; } + fn isEmpty() -> bool { return this.length == (0 as long); } + + [SdkPrivate] + fn _check() { if this.busy { _fail(); } } + [SdkPrivate] + fn _begin() { this._check(); this.busy = true; } + [SdkPrivate] + fn _hash(value: T) -> long { + if let identity = this.strategy { return identity.hash(value); } + return _collectionHash(value); + } + [SdkPrivate] + fn _equals(left: T, right: T) -> bool { + if let identity = this.strategy { return identity.equals(left, right); } + return _collectionEquals(left, right); + } + [SdkPrivate] + fn _find(hash: long, value: T) -> bool { + if let buckets = this.buckets { + let current: optional _SetNode = buckets[_setBucket(hash, buckets.length)]; + while current.hasSome() { + if let node = current { + if node.hash == hash && this._equals(node.value, value) { return true; } + current = node.next; + } + } + } + return false; + } + [SdkPrivate] + fn _rehash(capacity: long) -> array<_SetNode> { + let target: array<_SetNode> = new array<>(capacity); + if let buckets = this.buckets { + let index: long = 0; + while index < buckets.length { + let current: optional _SetNode = buckets[index]; + while current.hasSome() { + if let node = current { + let bucket: long = _setBucket(node.hash, capacity); + let copied = new _SetNode(node.hash, node.value, target[bucket]); + target[bucket] = copied; + current = node.next; + } + } + index = index + 1; + } + } + return target; + } + fn contains(value: T) -> bool { + this._begin(); + let hash: long = this._hash(value); + let found: bool = this._find(hash, value); + this.busy = false; + return found; + } + fn add(value: T) -> bool { + this._begin(); + let hash: long = this._hash(value); + if this._find(hash, value) { this.busy = false; return false; } + let required: long = _setNextSize(this.length); + let capacity: long = 0; + if let buckets = this.buckets { capacity = buckets.length; } + let nextCapacity: long = _setCapacity(capacity, required); + if nextCapacity != capacity { + let target = this._rehash(nextCapacity); + let bucket: long = _setBucket(hash, nextCapacity); + let inserted = new _SetNode(hash, value, target[bucket]); + target[bucket] = inserted; + let published: optional array<_SetNode> = some(target); + this.buckets = published; + } else { + if let buckets = this.buckets { + let bucket: long = _setBucket(hash, capacity); + let inserted = new _SetNode(hash, value, buckets[bucket]); + buckets[bucket] = inserted; + } + } + this.length = required; + this.busy = false; + return true; + } + fn remove(value: T) -> bool { + this._begin(); + let hash: long = this._hash(value); + if let buckets = this.buckets { + let bucket: long = _setBucket(hash, buckets.length); + let previous: optional _SetNode = none; + let current: optional _SetNode = buckets[bucket]; + while current.hasSome() { + if let node = current { + if node.hash == hash && this._equals(node.value, value) { + let next: optional _SetNode = node.next; + let length: long = this.length - 1; + if let predecessor = previous { predecessor.next = next; } + else { + if let successor = next { buckets[bucket] = successor; } + else { buckets.clear(bucket); } + } + this.length = length; + this.busy = false; + return true; + } + previous = current; + current = node.next; + } + } + } + this.busy = false; + return false; + } + fn clear() { + this._check(); + this.buckets = none; + this.length = 0; + } + fn cursor() -> Cursor { + let head: optional _SnapshotNode = none; + if let buckets = this.buckets { + let index: long = 0; + while index < buckets.length { + let current: optional _SetNode = buckets[index]; + while current.hasSome() { + if let node = current { + head = some(new _SnapshotNode(node.value, head)); + current = node.next; + } + } + index = index + 1; + } + } + return new _SnapshotCursor(head) as Cursor; + } +} diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/mod.barrel b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/mod.barrel index a983ef18..939eb532 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/mod.barrel +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/collections/mod.barrel @@ -1,3 +1,5 @@ pub struct list; pub contract Cursor; pub struct linked; +pub struct set; +pub contract Identity; diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/hash/main.pbs b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/hash/main.pbs new file mode 100644 index 00000000..e50dacd3 --- /dev/null +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/hash/main.pbs @@ -0,0 +1,26 @@ +[Doc(markdown = """ +Runtime Hash-v1 operations. Results preserve all signed long digest bits. +Reference queries validate complete values and observe instance identity. +""")] +declare service hash { + [IntrinsicCall(name = "hash.i64", version = 1)] + fn i64(value: long) -> long; + [IntrinsicCall(name = "hash.float", version = 1)] + fn f64(value: float) -> long; + [IntrinsicCall(name = "hash.string", version = 1)] + fn text(value: str) -> long; +} + +[Doc(markdown = """ +Hashes a Struct, Array, Fn, contract receiver or Random by instance. +The hash stays stable while the object lives and does not retain that object. +""")] +[IdentityPrimitive(name = "referenceHash")] +fn referenceHash(value: T) -> long { return 0; } + +[Doc(markdown = """ +Compares fully validated references of the same logical type by instance. +Contract views compare receivers, after validating the complete view groups. +""")] +[IdentityPrimitive(name = "referenceEquals")] +fn referenceEquals(left: T, right: T) -> bool { return false; } diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/hash/mod.barrel b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/hash/mod.barrel new file mode 100644 index 00000000..9f64fc4a --- /dev/null +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/game/stdlib/1/sdk/hash/mod.barrel @@ -0,0 +1,3 @@ +pub service hash; +pub fn referenceHash(value: T) -> long; +pub fn referenceEquals(left: T, right: T) -> bool; diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/hashing.pbs b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/hashing.pbs new file mode 100644 index 00000000..b390f72d --- /dev/null +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/hashing.pbs @@ -0,0 +1,19 @@ +import {hash, referenceHash, referenceEquals} from @sdk:hash; + +declare struct HashExampleObject(pub mut value: int); + +fn hashingExample() -> int { + // Hash-v1 preserves signed digest bits; negative hashes are ordinary results. + let expected: long = -8804195676797548855; + if hash.i64(-1) != expected { return 0; } + if hash.f64(0.0) != hash.f64(-0.0) { return 0; } + if hash.text("hel" + "lo") != hash.text("hello") { return 0; } + let first = new HashExampleObject(20); + let other = new HashExampleObject(20); + let saved: long = referenceHash(first); + first.value = 42; + if saved != referenceHash(first) { return 0; } + if referenceEquals(first, first) == false { return 0; } + if referenceEquals(first, other) { return 0; } + return first.value; +} diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/mod.barrel b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/mod.barrel index 69d88a0f..02ae897d 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/mod.barrel +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/mod.barrel @@ -4,3 +4,5 @@ pub fn contractExample() -> int; pub fn genericsExample() -> int; pub fn collectionsExample() -> int; pub fn linkedExample() -> int; +pub fn setExample() -> int; +pub fn hashingExample() -> int; diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/sets.pbs b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/sets.pbs new file mode 100644 index 00000000..f3deb4b9 --- /dev/null +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/main/resources/pbs-knowledge/examples/game/1/src/sets.pbs @@ -0,0 +1,25 @@ +import {set, Cursor} from @sdk:collections; + +fn sumSetSnapshot(snapshot: Cursor) -> int { + let total: int = 0; + while true { + if let value = snapshot.current() { total = total + value; } + else { break; } + if snapshot.hasNext() { snapshot.next(); } + else { break; } + } + return total; +} + +fn setExample() -> int { + let values: set = new set(); + values.add(20); + values.add(22); + if values.add(20) { return 0; } // Duplicate inclusion preserves the first value. + let captured: Cursor = values.cursor(); + values.remove(20); + values.clear(); + if values.isEmpty() == false { return 0; } + // The capture owns both values; their traversal order is unspecified. + return sumSetSnapshot(captured); +} diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/PbsGenericStructsTest.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/PbsGenericStructsTest.java index b837f586..2da130b2 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/PbsGenericStructsTest.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/PbsGenericStructsTest.java @@ -6,6 +6,36 @@ import p.studio.compiler.source.identifiers.FileId; import static org.junit.jupiter.api.Assertions.*; class PbsGenericStructsTest { + @Test void nominalApplicationsStayInvariantInExpectedValueContexts() { + rejects(BOX+"fn main(){let value:Box=new Box(42);}", "E_SEM_GENERIC_TYPE_MISMATCH"); + rejects(BOX+"fn main(){let value:Box=new Box(42);value=new Box(42);}", "E_SEM_GENERIC_TYPE_MISMATCH"); + rejects(BOX+"fn main()->Box{return new Box(42);}", "E_SEM_GENERIC_TYPE_MISMATCH"); + accepts(BOX+"fn main(){let value:Box=new Box(42);value=new Box(43);}"); + } + @Test void optionalGenericStrategiesAndEveryConcreteOwnerFamilyKeepLogicalScope() { + accepts(""" + declare contract Policy{fn same(a:T,b:T)->bool;} + declare struct Compared(policy:optional Policy){ + fn same(a:T,b:T)->bool{if let policy=this.policy{return policy.same(a,b);}return false;} + } + declare contract Read{fn read()->T;} + declare struct Cell(pub mut value:T){fn replace(value:T){this.value=value;}} + implements Read for Cell using cell {fn read()->T{return cell.value;}} + fn main()->int{ + let a=new Cell(20);let b=new Cell(22);let viewA:Read=a;let viewB:Read=b; + a.replace(20);b.replace(22);return viewA.read()+(viewB.read() as int); + } + """); + rejects(""" + declare struct Broken(value:optional T){ + fn invalid()->optional T{if let value=this.value{return some(value+value);}return none;} + } + ""","E_SEM_GENERIC_CAPABILITY"); + accepts(""" + declare struct set(value:T){fn get()->T{return this.value;}} + fn main()->int{let userSet=new set(some(42));return userSet.get() else 0;} + """); + } @Test void recursiveOptionalBindingsAndContractViewsKeepTheirDefinitionShapes() { accepts(""" declare contract Reader {fn read()->optional T;} @@ -41,7 +71,7 @@ class PbsGenericStructsTest { } private void accepts(String source) { var diagnostics = compile(source); - assertFalse(diagnostics.hasErrors(), () -> diagnostics.stream().map(d -> d.getCode()+": "+d.getMessage()).toList().toString()); + assertFalse(diagnostics.hasErrors(), () -> diagnostics.stream().map(d -> d.getCode()+": "+d.getMessage()+" at "+d.getSpan().getStart()+":"+d.getSpan().getEnd()).toList().toString()); } private void rejects(String source, String code) { var diagnostics = compile(source); diff --git a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/semantics/PbsListCursorEditorialTest.java b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/semantics/PbsListCursorEditorialTest.java index 57c09099..604f3cd0 100644 --- a/prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/semantics/PbsListCursorEditorialTest.java +++ b/prometeu-compiler/frontends/prometeu-frontend-pbs/src/test/java/p/studio/compiler/pbs/semantics/PbsListCursorEditorialTest.java @@ -12,7 +12,7 @@ import static org.junit.jupiter.api.Assertions.*; class PbsListCursorEditorialTest { @org.junit.jupiter.params.ParameterizedTest - @org.junit.jupiter.params.provider.ValueSource(strings={"list","linked"}) + @org.junit.jupiter.params.provider.ValueSource(strings={"list","linked","set"}) void concreteApiHidesStorageAndKeepsSdkDefinitionOrigins(String collection) throws Exception { var diagnostics=DiagnosticSink.empty();var sdkId=new FileId(1); String sdk; @@ -36,11 +36,11 @@ class PbsListCursorEditorialTest { var typeHover=service.hover(source,ast,supplemental,source.indexOf("Values")).orElseThrow(); assertFalse(typeHover.signatures().stream().anyMatch(s->s.label().startsWith("_"))); var constructors=service.signatureHelp(source,ast,supplemental,source.indexOf("new Values(")+11).orElseThrow().signatures(); - assertEquals(collection.equals("list")?2:1,constructors.size()); + assertEquals(collection.equals("linked")?1:2,constructors.size()); assertTrue(constructors.stream().allMatch(s->!s.label().contains("storage")&&!s.label().contains("$generic$"))); var completions=service.completion(source,ast,supplemental,member); assertTrue(completions.stream().anyMatch(c->c.label().equals("add")&&c.detail().contains("int"))); - assertFalse(completions.stream().anyMatch(c->java.util.Set.of("storage","length","head","tail","_at","_put","_node").contains(c.label()))); + assertFalse(completions.stream().anyMatch(c->java.util.Set.of("storage","length","head","tail","buckets","strategy","busy","_at","_put","_node","_hash","_find","_begin","_rehash").contains(c.label()))); var definition=service.definition(source,ast,supplemental,member); assertEquals(sdkId,definition.getFirst().span().getFileId()); int current=source.indexOf("cursor.current")+7; diff --git a/prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/backend/bytecode/BytecodeOpcodeLayout.java b/prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/backend/bytecode/BytecodeOpcodeLayout.java index d7324a1d..aea8f92c 100644 --- a/prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/backend/bytecode/BytecodeOpcodeLayout.java +++ b/prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/backend/bytecode/BytecodeOpcodeLayout.java @@ -8,8 +8,8 @@ final class BytecodeOpcodeLayout { 0x30,0x31,0x32,0x33,0x34,0x35,0x36,0x37,0x38,0x39,0x3a,0x3b,0x3c,0x3d,0x3e,0x51,0x80 -> 2; case 0x16 -> 3; case 0x02,0x03,0x04,0x10,0x17,0x18,0x40,0x41,0x42,0x43,0x50,0x53,0x57,0x70,0x71,0x72, - 0x90,0x91,0x92,0xa0,0xa3,0xa4,0xa5,0xa6,0xa9 -> 6; - case 0x14,0x15,0x52,0x58,0x93,0x94,0x95,0x96,0xa1,0xa2 -> 10; + 0x90,0x91,0x92,0x97,0xa0,0xa3,0xa4,0xa5,0xa6,0xa9 -> 6; + case 0x14,0x15,0x52,0x58,0x93,0x94,0x95,0x96,0x98,0xa1,0xa2 -> 10; default -> throw new BytecodeMarshalingException(BytecodeMarshalingErrorCode.MARSHAL_VERIFY_PRECHECK_UNKNOWN_OPCODE, "unknown or retired opcode 0x%04X".formatted(opcode)); }; diff --git a/prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/backend/bytecode/BytecodePreloadVerifierService.java b/prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/backend/bytecode/BytecodePreloadVerifierService.java index bde139f9..b44f819e 100644 --- a/prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/backend/bytecode/BytecodePreloadVerifierService.java +++ b/prometeu-compiler/prometeu-build-pipeline/src/main/java/p/studio/compiler/backend/bytecode/BytecodePreloadVerifierService.java @@ -56,6 +56,7 @@ public class BytecodePreloadVerifierService { case 0x58 -> method(r,a,b); case 0x90,0x91,0x92 -> type(r,a); case 0x93,0x94,0x95,0x96 -> {var src=type(r,a).body();var dst=type(r,b).body();check(src instanceof Struct||src instanceof Array||src instanceof Trait,"reference source category");check(op==0x94||op==0x95?dst instanceof Trait:dst instanceof Struct||dst instanceof Array,"reference target category");} + case 0x97,0x98 -> {identitySource(r,a);if(op==0x98)identitySource(r,b);} case 0xa0 -> check(type(r,a).body() instanceof Struct,"Struct category"); case 0xa1,0xa2 -> field(r,a,b); case 0xa3,0xa4,0xa5,0xa6,0xa9 -> array(r,a); @@ -159,6 +160,8 @@ public class BytecodePreloadVerifierService { case 0x91 -> {dynamic(pop(s,2),typed);produce(s,facts(r,type(r,a).identity()),i.pc());} case 0x92 -> {dynamic(pop(s,2),typed);s.stack.add(carrier("bool"));} case 0x93,0x94,0x95,0x96 -> {consume(s,facts(r,type(r,a).identity()),typed);if(op==0x93||op==0x94)s.stack.add(carrier("bool"));else produce(s,facts(r,type(r,b).identity()),i.pc());} + case 0x97 -> {consume(s,facts(r,type(r,a).identity()),typed);s.stack.add(carrier("i64"));} + case 0x98 -> {var expected=new ArrayList<>(facts(r,type(r,a).identity()));expected.addAll(facts(r,type(r,b).identity()));consume(s,expected,typed);s.stack.add(carrier("bool"));} case 0xa0 -> produce(s,facts(r,type(r,a).identity()),i.pc()); case 0xa1 -> {consume(s,facts(r,type(r,a).identity()),typed);produce(s,facts(r,field(r,a,b).type()),i.pc());} case 0xa2 -> {consume(s,facts(r,field(r,a,b).type()),typed);consume(s,facts(r,type(r,a).identity()),typed);} @@ -266,6 +269,7 @@ public class BytecodePreloadVerifierService { check((mask(actual.get(i+1).carrier())&64)!=0,"invalid null group pair"); } } + private static void identitySource(LinkedRegistry r,int id){var body=type(r,id).body();check(body instanceof Struct||body instanceof Array||body instanceof Fn||body instanceof Trait||body instanceof Builtin builtin&&builtin.id()==0x16,"identity source category");} private static TypeDeclaration type(LinkedRegistry r,int id){check(id>=0&&id=0&&member { + if(!identitySource(body))throw new IllegalArgumentException("identity source category"); + pops=registry.width(instruction.type());pushes=1; + if(instruction.kind()==IRRegistryInstruction.Kind.REF_IDENTITY_EQ) { + if(!identitySource(registry.type(instruction.targetType()).body()))throw new IllegalArgumentException("identity right category"); + pops=Math.addExact(pops,registry.width(instruction.targetType())); + second=registry.id(instruction.targetType()).index(); + } + } case STRUCT_NEW,STRUCT_GET,STRUCT_SET -> { if(!(body instanceof Struct struct))throw new IllegalArgumentException("Struct category required"); if(instruction.kind()==IRRegistryInstruction.Kind.STRUCT_NEW)pushes=1; @@ -64,4 +73,8 @@ public final class RegistryInstructionLowerer { int bytes=second==null?4:8; return new IRVMInstruction(new IRVMOp("REGISTRY_"+instruction.kind(),instruction.kind().opcode(),bytes,pops,pushes,false,false,false),first,second); } + private static boolean identitySource(TypeBody body) { + return body instanceof Struct||body instanceof Array||body instanceof Fn||body instanceof Trait + ||body instanceof Builtin builtin&&builtin.id()==0x16; + } } diff --git a/prometeu-compiler/prometeu-build-pipeline/src/test/java/p/studio/compiler/backend/registry/IdentityHashingPipelineTest.java b/prometeu-compiler/prometeu-build-pipeline/src/test/java/p/studio/compiler/backend/registry/IdentityHashingPipelineTest.java new file mode 100644 index 00000000..bd049c74 --- /dev/null +++ b/prometeu-compiler/prometeu-build-pipeline/src/test/java/p/studio/compiler/backend/registry/IdentityHashingPipelineTest.java @@ -0,0 +1,108 @@ +package p.studio.compiler.backend.registry; + +import org.junit.jupiter.api.Test; +import p.studio.compiler.backend.bytecode.*; +import p.studio.compiler.backend.irvm.*; +import p.studio.compiler.models.*; +import p.studio.compiler.models.registry.*; +import p.studio.compiler.models.registry.IRRegistry.*; +import p.studio.compiler.source.identifiers.*; +import p.studio.utilities.structures.ReadOnlyList; +import java.nio.file.*; +import java.util.*; +import static p.studio.compiler.models.IRBackendExecutableFunction.InstructionKind.*; +import static p.studio.compiler.models.registry.IRRegistryInstruction.Kind.*; +import static org.junit.jupiter.api.Assertions.*; + +/** Neutral producer: no PBS type, spelling or collection binding reaches the backend. */ +class IdentityHashingPipelineTest { + private static final TypeRef LONG=TypeRef.builtin(0x11),BOOL=TypeRef.builtin(0x13), + OWNER=new TypeRef("neutral:object"),VIEW=new TypeRef("neutral:view"); + private final List code=new ArrayList<>(); + private void emit(IRBackendExecutableFunction.InstructionKind op,String label,Integer index) { + code.add(new IRBackendExecutableFunction.Instruction(op,null,null,null,null,null,label,null,index,null,null)); + } + private void typed(IRRegistryInstruction.Kind op,TypeRef left,TypeRef right,int field) { + code.add(new IRBackendExecutableFunction.Instruction(REGISTRY,null,null,null,null,null,null,null,null,null,null, + new IRRegistryInstruction(op,left,right,null,field))); + } + @Test void completeTraitViewsAndConcreteAliasesUseBothTypedQueries() throws Exception { + var registry=new IRRegistry(ReadOnlyList.from( + new TypeDeclaration(LONG,null,new Builtin(0x11)),new TypeDeclaration(BOOL,null,new Builtin(0x13)), + new TypeDeclaration(OWNER,"Object",new Struct(ReadOnlyList.from(new NamedType(LONG,"value")))), + new TypeDeclaration(VIEW,"View",new Trait(null))), + ReadOnlyList.from(new Implementation("neutral:implementation",OWNER,VIEW,null))); + typed(STRUCT_NEW,OWNER,null,0);emit(SET_LOCAL,null,0); + emit(GET_LOCAL,null,0);typed(REF_IDENTITY_HASH,OWNER,null,0);emit(SET_LOCAL,null,1); + emit(GET_LOCAL,null,0);emit(PUSH_I64,"42",null);typed(STRUCT_SET,OWNER,null,0); + emit(GET_LOCAL,null,0);typed(REF_TO_TRAIT,OWNER,VIEW,0);typed(REF_IDENTITY_HASH,VIEW,null,0); + emit(GET_LOCAL,null,1);emit(EQ,null,null); + emit(GET_LOCAL,null,0);emit(GET_LOCAL,null,0);typed(REF_TO_TRAIT,OWNER,VIEW,0); + typed(REF_IDENTITY_EQ,OWNER,VIEW,0);emit(AND,null,null); + emit(GET_LOCAL,null,0);typed(STRUCT_NEW,OWNER,null,0);typed(REF_IDENTITY_EQ,OWNER,OWNER,0); + emit(NOT,null,null);emit(AND,null,null);emit(RET,null,null); + var f=new IRBackendExecutableFunction(new FileId(0),new ModuleId(0),"main",new CallableId(0),0,0,0,2,1,5, + ReadOnlyList.wrap(code),null,FunctionMetadata.ordinary(new Signature(null,ReadOnlyList.from(BOOL)))); + var backend=IRBackend.builder().entryPointModuleId(new ModuleId(0)).entryPointCallableName("main") + .registry(registry).executableFunctions(ReadOnlyList.from(f)).build(); + for(boolean optimized:new boolean[]{false,true}) { + var program=new LowerToIRVMService().lower(backend); + if(optimized)program=new OptimizeIRVMService().optimize(program); + var queries=program.module().functions().getFirst().instructions().stream() + .filter(i->i.op().opcode()==0x97||i.op().opcode()==0x98).toList(); + assertEquals(4,queries.size()); + assertEquals(List.of(6,6,10,10),queries.stream().map(IRVMInstruction::encodedSize).toList()); + assertEquals(List.of(1,2,3,2),queries.stream().map(i->i.op().pops()).toList()); + var module=new BytecodeEmitter().emit(program.coherentEmissionPlan());new BytecodePreloadVerifierService().verify(module); + var directory=Path.of("build/registry-conformance");Files.createDirectories(directory); + Files.write(directory.resolve("common-identity"+(optimized?"-optimized":"")+".pbx"),module.serialize()); + int pc=0,hashPc=-1,eqPc=-1; + for(var instruction:program.module().functions().getFirst().instructions()) { + if(hashPc<0&&instruction.op().opcode()==0x97)hashPc=pc; + if(eqPc<0&&instruction.op().opcode()==0x98)eqPc=pc; + pc+=instruction.encodedSize(); + } + int boolId=LinkedRegistry.link(registry).id(BOOL).index(); + for(var negative:new String[]{"bad-category","bad-right","dead-bad-category","bad-typeid"}) { + byte[] bad=module.code().clone();var buffer=java.nio.ByteBuffer.wrap(bad).order(java.nio.ByteOrder.LITTLE_ENDIAN); + if(negative.equals("bad-right"))buffer.putInt(eqPc+6,boolId); + else buffer.putInt(hashPc+2,negative.equals("bad-typeid")?-1:boolId); + if(negative.startsWith("dead"))for(int offset=0;offset<6;offset+=2)buffer.putShort(offset,(short)1); + var malformed=new BytecodeModule(module.version(),module.constPool(),module.functions(),bad,module.debugInfo(),module.exports(),module.syscalls(),module.registry(),module.intrinsicSignatures()); + assertThrows(BytecodeMarshalingException.class,()->new BytecodePreloadVerifierService().verify(malformed),negative); + Files.write(directory.resolve("common-identity-"+negative+(optimized?"-optimized":"")+".pbx"),malformed.serialize()); + } + } + } + @Test void neutralUnknownInputsKeepRuntimeValidationOfTheCompleteRightView()throws Exception { + var registry=new IRRegistry(ReadOnlyList.from( + new TypeDeclaration(LONG,null,new Builtin(0x11)),new TypeDeclaration(BOOL,null,new Builtin(0x13)), + new TypeDeclaration(OWNER,"Object",new Struct(null)),new TypeDeclaration(VIEW,"View",new Trait(null))),null); + var linked=LinkedRegistry.link(registry);int owner=linked.id(OWNER).index(),view=linked.id(VIEW).index(); + for(var name:new String[]{"null-views","right-after-null","right-after-distinct","partial","truncated"}) { + var bytes=new java.io.ByteArrayOutputStream(); + if(name.equals("truncated")){word(bytes,0x97);} + else { + if(name.equals("right-after-distinct"))instruction(bytes,0xa0,owner);else instruction(bytes,0x10,0); + if(name.startsWith("right")) {instruction(bytes,0x40,0);instruction(bytes,0x40,1);} + else {instruction(bytes,0x10,0);if(!name.equals("partial"))instruction(bytes,0x10,0);} + instruction(bytes,0x98,owner);integer(bytes,view);word(bytes,0x51); + } + byte[] raw=bytes.toByteArray(); + var module=new BytecodeModule(0,ReadOnlyList.from(new BytecodeModule.NullConstant()), + ReadOnlyList.from(new BytecodeModule.FunctionMeta(0,raw.length,0,0,1,3, + FunctionMetadata.ordinary(new Signature(null,ReadOnlyList.from(BOOL))))),raw,null,ReadOnlyList.empty(),ReadOnlyList.empty(),registry); + if(name.equals("partial")||name.equals("truncated"))assertThrows(BytecodeMarshalingException.class,()->new BytecodePreloadVerifierService().verify(module)); + else new BytecodePreloadVerifierService().verify(module); + var directory=Path.of("build/registry-conformance");Files.createDirectories(directory); + Files.write(directory.resolve("common-identity-"+name+".pbx"),module.serialize()); + } + } + private static void word(java.io.ByteArrayOutputStream out,int n){out.write(n);out.write(n>>>8);} + private static void integer(java.io.ByteArrayOutputStream out,int n){for(int i=0;i<4;i++)out.write(n>>>(8*i));} + private static void instruction(java.io.ByteArrayOutputStream out,int op,int n){word(out,op);integer(out,n);} + @Test void identityEqualityRequiresTwoTypeOperands() { + assertThrows(NullPointerException.class,()->new IRRegistryInstruction(REF_IDENTITY_EQ,OWNER,null,null,0)); + assertThrows(IllegalArgumentException.class,()->new IRRegistryInstruction(REF_IDENTITY_HASH,OWNER,VIEW,null,0)); + } +} diff --git a/prometeu-compiler/prometeu-frontend-api/src/main/java/p/studio/compiler/models/registry/IRRegistryInstruction.java b/prometeu-compiler/prometeu-frontend-api/src/main/java/p/studio/compiler/models/registry/IRRegistryInstruction.java index c99f2299..a855814d 100644 --- a/prometeu-compiler/prometeu-frontend-api/src/main/java/p/studio/compiler/models/registry/IRRegistryInstruction.java +++ b/prometeu-compiler/prometeu-frontend-api/src/main/java/p/studio/compiler/models/registry/IRRegistryInstruction.java @@ -10,6 +10,7 @@ public record IRRegistryInstruction(Kind kind, IRRegistry.TypeRef type, IRRegist MAKE_CLOSURE(0x52), CALL_CLOSURE(0x53), GET_CAPTURE(0x57), CALL_TRAIT(0x58), DYN_PACK(0x90), DYN_UNPACK(0x91), DYN_CAN_UNPACK(0x92), REF_IS_EXACT(0x93), REF_IMPLEMENTS(0x94), REF_TO_TRAIT(0x95), REF_CAST(0x96), + REF_IDENTITY_HASH(0x97), REF_IDENTITY_EQ(0x98), STRUCT_NEW(0xa0), STRUCT_GET(0xa1), STRUCT_SET(0xa2), ARRAY_NEW(0xa3), ARRAY_LEN(0xa4), ARRAY_GET(0xa5), ARRAY_SET(0xa6), ARRAY_COPY(0xa9); @@ -23,7 +24,7 @@ public record IRRegistryInstruction(Kind kind, IRRegistry.TypeRef type, IRRegist if(kind!=Kind.GET_CAPTURE)Objects.requireNonNull(type,"type"); if(kind==Kind.MAKE_CLOSURE) {Objects.requireNonNull(function,"function");function.getIndex();} else if(function!=null)throw new IllegalArgumentException("unexpected function operand"); - boolean pair=(kind.opcode()>=0x93&&kind.opcode()<=0x96); + boolean pair=(kind.opcode()>=0x93&&kind.opcode()<=0x96)||kind==Kind.REF_IDENTITY_EQ; if(pair)Objects.requireNonNull(targetType,"targetType"); else if(targetType!=null)throw new IllegalArgumentException("unexpected target type"); if(kind==Kind.GET_CAPTURE&&type!=null)throw new IllegalArgumentException("capture index is not a TypeId"); diff --git a/tools/pbx-conformance/README.md b/tools/pbx-conformance/README.md index 564d8414..ab287c15 100644 --- a/tools/pbx-conformance/README.md +++ b/tools/pbx-conformance/README.md @@ -15,7 +15,7 @@ The Java tests generate PBX in the build-pipeline module's `build/registry-conformance`. `run.py` creates a temporary Cargo project, copies the runtime lockfile and references its bytecode/hal/vm/system crates by path. It never modifies the runtime checkout. Add `--online` for an uncached machine; -by default Cargo uses only cached dependencies. Java 25, Rust and the runtime +by default Cargo uses only cached dependencies. Java 21, Rust and the runtime checkout's dependencies are required. The output identifies runtime revision, OS/architecture and load configuration. @@ -304,3 +304,60 @@ Evidence prints consumer/provider source hashes, selected revision and clean sta toolchain/platform/profile, lockfile/catalog hashes, capabilities, default ceilings and lowered refusal limits. Keep new qualification separate from historical List/ Linked evidence; prior successful providers are not relabeled as the new target. + +## PBS hashing, Identity and Set + +`IdentityHashingPipelineTest` qualifies neutral 0x97/0x98 production, complete +concrete/Trait groups and both optimizer paths. It also emits malformed-category, +right-TypeId, unknown-TypeId, dead-code, partial-group and truncated fixtures. +Unknown global inputs in two neutral cases reach production runtime validation: +an absent/different left cannot hide the invalid complete right view. Refusal +retains all three input slots, charges seven cycles and executes zero successful +query steps; zero budget executes nothing. + +`PbsIdentityHashingTest` selects all 30 scalar/String rows from the unchanged +118-row independent provider C XXH64 oracle. Both producer paths preserve exact +signed digest bits and attempted costs. Separate source fixtures qualify Struct, +Array, Fn, Random, complete contracts, mutation, aliases and discarded scalar and +reference results. The reference-query source gate ran before Set algorithm work. +The consumer oracle copy is checked against the selected provider on every +explicit harness invocation. Ordinary Gradle compilation uses local resources. + +`PbsSetTest` exercises the complete source API, contextual/default/explicit +construction, optional/default diagnostics, nominal origin, shared complete values, +content opt-in, collisions, exact growth arithmetic, callbacks, aliases and Cursor. +Counter strategies demonstrate that rehash and capture do not call hash/equals. +SDK aliases, generic-function reexports and installed examples compile through +actual workspace builders; installed compilation uses only installDist JARs in an +external directory and writes mandatory PBX fixtures for runtime execution. + +```sh +./gradlew :prometeu-compiler:prometeu-build-pipeline:test --tests '*IdentityHashingPipelineTest' +./gradlew :prometeu-architecture-tests:test --tests '*PbsIdentityHashingTest' --tests '*PbsSetTest' +./gradlew :prometeu-app:installedKnowledgeTest +CARGO_TARGET_DIR=/tmp/studio-pbx-target python3 tools/pbx-conformance/run.py --runtime ../runtime --identity-hashing-only +CARGO_TARGET_DIR=/tmp/studio-pbx-target python3 tools/pbx-conformance/run.py --runtime ../runtime --set-only +``` + +The Set quota corpus measures old/candidate coexistence and compares every +original-object instruction prefix with a successful run. It treats guard writes +separately from structural writes. Natural quota cases cover insertion, growth, +duplicate inclusion, removal, clear and capture with no claim that all failures +preserve the entire Set or that every theoretical failure boundary occurs at the +sampled limits. Current natural runs refuse before structural mutation; this is +reported explicitly by their summaries. + +A **separate test-only instrumented source fixture** inserts a controlled Array +allocation after the real candidate-table store and before size assignment. A +lowered guest quota refuses that probe. The old size six, new table capacity 16, +seven reachable nodes and active guard remain, while the refused instruction +preserves its own entry state. This demonstrates the post-publication failure +boundary; it is not a production SDK allocation, callback, algorithm or claim about +natural refusal frequency. Its ordinary/optimized fixtures are named +`pbs-set-injected-refusal-growth*` and are generated from an in-memory SDK copy. + +Real safepoints qualify source Set node/candidate release, removal/clear, snapshot +prefix reclamation and sticky final retention. Set GC tests do not assume an +iteration order. Add `--release` to qualify the Rust release profile independently +of the two producer variants; omit focused flags for the complete mandatory corpus. +All harness builds remain outside the runtime checkout, which is consumed unchanged. diff --git a/tools/pbx-conformance/main.rs b/tools/pbx-conformance/main.rs index 6663445b..e19d483b 100644 --- a/tools/pbx-conformance/main.rs +++ b/tools/pbx-conformance/main.rs @@ -41,6 +41,8 @@ fn main() { for resource in [Q::GuestBytes,Q::HandleSlots,Q::AuxiliaryBytes,Q::TemporaryBytes,Q::StringBytes,Q::StringAllocations,Q::IndividualStringBytes,Q::CallDepth] { println!("DEFAULT VM LIMIT {resource:?}={}",limits.get(resource)); } + if std::env::args().any(|arg| arg == "--set-only") { verify_pbs_set_fixtures(&root); return; } + if std::env::args().any(|arg| arg == "--identity-hashing-only") { verify_identity_hashing_fixtures(&root); return; } if std::env::args().any(|arg| arg == "--linked-only") { verify_common_storage_fixtures(&root); verify_pbs_linked_fixtures(&root); return; } if std::env::args().any(|arg| arg == "--list-cursor-only") { verify_common_storage_fixtures(&root); verify_pbs_list_cursor_fixtures(&root); return; } if std::env::args().any(|arg| arg == "--generic-contracts-only") { verify_pbs_generic_contract_fixtures(&root); return; } @@ -49,6 +51,7 @@ fn main() { verify_pbs_math_fixtures(&root); if std::env::args().any(|arg| arg == "--math-only") { return; } verify_pbs_random_fixtures(&root); + verify_identity_hashing_fixtures(&root); verify_catalog_fixtures(&root); verify_pbs_fixtures(&root); verify_pbs_structured_fixtures(&root); @@ -57,6 +60,7 @@ fn main() { verify_common_storage_fixtures(&root); verify_pbs_list_cursor_fixtures(&root); verify_pbs_linked_fixtures(&root); + verify_pbs_set_fixtures(&root); verify_pbs_resource_refusals(&root); verify_pbs_closure_frames(&root); for name in [ @@ -497,7 +501,7 @@ fn verify_pbs_fixtures(root: &std::path::Path) { for entry in std::fs::read_dir(root).unwrap() { let path = entry.unwrap().path(); let name = path.file_stem().unwrap().to_str().unwrap(); - if name.starts_with("pbs-random-") || name.starts_with("pbs-math-") || name.starts_with("pbs-structured-") || name.starts_with("pbs-generic-contract-") || name.starts_with("pbs-generic-struct-") || name.starts_with("pbs-list-") || name.starts_with("pbs-linked-") || !name.starts_with("pbs-") || path.extension().and_then(|v| v.to_str()) != Some("pbx") { continue; } + if name.starts_with("pbs-random-") || name.starts_with("pbs-math-") || name.starts_with("pbs-structured-") || name.starts_with("pbs-generic-contract-") || name.starts_with("pbs-generic-struct-") || name.starts_with("pbs-list-") || name.starts_with("pbs-linked-") || name.starts_with("pbs-hash-") || name.starts_with("pbs-set-") || !name.starts_with("pbs-") || path.extension().and_then(|v| v.to_str()) != Some("pbx") { continue; } count += 1; let bytes = std::fs::read(&path).unwrap(); let image = ValidatedProgramImage::load(&bytes, &mut LoadBudget::new(LoadLimits::default()), caps::NONE) @@ -1236,8 +1240,9 @@ fn verify_collection_cursor_gc(root:&std::path::Path,collection:&str) { let named=|name:&str|objects.iter().filter(|o|image.registry().declarations().types[o.type_id.0 as usize].name.as_deref()==Some(name)).collect::>(); assert_eq!(named("_SnapshotNode").len(),nodes,"prefix nodes round {round}"); if collection=="linked" {assert!(named("_LinkedNode").is_empty(),"snapshot does not retain original Linked nodes");} + if collection=="set" {assert!(named("_SetNode").is_empty(),"snapshot does not retain original Set nodes");} let values=named("Item");assert_eq!(values.len(),items,"captured object roots round {round}"); - if items==1 {assert_eq!(values[0].groups[0],[V::Int32(1199)],"sticky last payload remains live");} + if items==1 && collection!="set" {assert_eq!(values[0].groups[0],[V::Int32(1199)],"sticky last payload remains live");} println!("PBS {} CURSOR GC PASS round={round} nodes={nodes} items={items} collected={}",collection.to_uppercase(),snapshot.gc.reclaimed); } let report=vm.run_budget(100_000,&mut NoNative,&mut HostContext::new(None)).unwrap(); @@ -1355,7 +1360,9 @@ fn verify_collection_distribution(root:&std::path::Path,collection:&str,last:i32 } retained.sort_unstable(); let expected=if collection=="linked"&&name=="installed" {vec![20,22]} else {vec![last]}; - assert_eq!(retained,expected,"{collection} {name}: complete traversal retains each final value"); + if collection=="set" { + assert_eq!(retained.len(),1);assert!([20,22].contains(&retained[0]),"Set has no order guarantee"); + }else{assert_eq!(retained,expected,"{collection} {name}: complete traversal retains each final value");} println!("PBS {} DISTRIBUTION LOAD/EXEC PASS {name}",collection.to_uppercase()); } } @@ -1509,3 +1516,316 @@ fn verify_linked_collection_gc(root:&std::path::Path) { let report=vm.run_budget(100_000,&mut NoNative,&mut HostContext::new(None)).unwrap(); assert!(matches!(report.reason,End::Halted|End::EndOfRom));assert_eq!(vm.operand_stack_top(1),vec![Value::Int32(42)]); } + + +fn verify_identity_hashing_fixtures(root: &std::path::Path) { + use prometeu_vm::LogicalFrameEndingReason as End; + use prometeu_bytecode::{isa::core::CoreOpCode as Op,registry::TypeId}; + let corpus=std::fs::read_to_string(root.join("hash-vectors.tsv")).expect("mandatory hashing oracle manifest"); + let mut originals=std::collections::BTreeMap::new();let mut count=0; + for row in corpus.lines() { + let parts:Vec<_>=row.split_whitespace().collect();let name=parts[0]; + let expected=u64::from_str_radix(parts[1],16).unwrap() as i64; + let id:u32=parts[2].parse().unwrap();let cost:u64=parts[3].parse().unwrap(); + let bytes=std::fs::read(root.join(format!("{name}.pbx"))).unwrap(); + let image=ValidatedProgramImage::load(&bytes,&mut LoadBudget::new(LoadLimits::default()),caps::NONE).unwrap(); + let code=image.code().to_vec();let mut vm=VirtualMachine::from_image(image,Default::default()); + vm.prepare_boot_call().unwrap();let mut total=0;let mut calls=0; + loop { + let pc=vm.pc();let op=Op::try_from(u16::from_le_bytes(code[pc..pc+2].try_into().unwrap())).unwrap(); + let charge=if op==Op::Intrinsic { + assert_eq!(u32::from_le_bytes(code[pc+2..pc+6].try_into().unwrap()),id,"{name}"); + let before=vm.operand_stack_top(1).to_vec();let zero=vm.run_budget(0,&mut NoNative,&mut HostContext::new(None)).unwrap(); + assert_eq!((vm.pc(),zero.cycles_used,zero.steps_executed),(pc,0,0)); + assert_eq!(vm.operand_stack_top(1),before);calls+=1;cost + }else{op.cycles()}; + let report=vm.run_budget(1,&mut NoNative,&mut HostContext::new(None)).unwrap(); + assert_eq!(report.cycles_used,charge,"{name} at {pc}");total+=charge; + if matches!(report.reason,End::EndOfRom|End::Halted){break;} + assert!(matches!(report.reason,End::BudgetExhausted),"{name}: {report:?}"); + assert!(total<100_000); + } + assert_eq!(calls,1,"{name}");assert_eq!(vm.operand_stack_top(1),vec![Value::Int64(expected)],"{name}"); + if let Some(base)=name.strip_suffix("-optimized") {assert_eq!(originals.get(base),Some(&total),"{name}: optimizer charging");} + else{originals.insert(name.to_string(),total);} + println!("HASH ORACLE/COST/FUEL PASS {name} result={expected} cycles={total}");count+=1; + } + assert_eq!(count,60,"all 30 source scalar/String vectors in both optimizer paths"); + for prefix in ["common-identity","pbs-hash-object","pbs-hash-contract","pbs-hash-array","pbs-hash-function","pbs-hash-random","pbs-hash-discard","pbs-hash-discard-reference"] { + for suffix in ["","-optimized"] { + let name=format!("{prefix}{suffix}");let bytes=std::fs::read(root.join(format!("{name}.pbx"))).expect("mandatory identity fixture"); + let image=ValidatedProgramImage::load(&bytes,&mut LoadBudget::new(LoadLimits::default()),caps::NONE).unwrap_or_else(|e|panic!("{name}: {e:?}")); + let code=image.code().to_vec();let registry=image.registry().clone(); + let mut vm=VirtualMachine::from_image(image,Default::default());let observer=vm.resource_observer(); + vm.prepare_boot_call().unwrap();let mut steps=0;let mut queries=0; + loop { + let pc=vm.pc();let op=Op::try_from(u16::from_le_bytes(code[pc..pc+2].try_into().unwrap())).unwrap(); + let width=|at:usize|registry.type_layout(TypeId(u32::from_le_bytes(code[at..at+4].try_into().unwrap()))).unwrap().storage.slots as u64; + let charge=match op {Op::RefIdentityHash=>Some(8+width(pc+2)),Op::RefIdentityEq=>Some(4+width(pc+2)+width(pc+6)),_=>None}; + let report=vm.run_budget(1,&mut NoNative,&mut HostContext::new(None)).unwrap(); + if let Some(charge)=charge {queries+=1;assert_eq!(report.cycles_used,charge,"{name}: typed query charge");} + if matches!(report.reason,End::EndOfRom|End::Halted){break;} + assert!(matches!(report.reason,End::BudgetExhausted),"{name}: {report:?}");steps+=1;assert!(steps<100_000); + } + if prefix=="pbs-hash-discard-reference"{assert_eq!(queries,2,"unused reference queries retain charged work");} + let expected=if prefix=="common-identity"{Value::Boolean(true)}else{Value::Int32(42)}; + assert_eq!(vm.operand_stack_top(1),vec![expected],"{name}");drop(vm); + for resource in [prometeu_vm::resource_budget::RuntimeResource::GuestBytes,prometeu_vm::resource_budget::RuntimeResource::HandleSlots,prometeu_vm::resource_budget::RuntimeResource::StringBytes] { + assert_eq!(observer.used(resource),0,"{name}: owner release"); + } + println!("IDENTITY COMPLETE GROUP/ALIAS/COST PASS {name}"); + } + } + verify_identity_negative_fixtures(root); + +} + + +fn verify_pbs_set_fixtures(root:&std::path::Path) { + use prometeu_vm::{LogicalFrameEndingReason as End,resource_budget::RuntimeResource as Q}; + let successes=["basic","construction","arithmetic","scalars","objects","collisions","content","tuple", + "cursor-empty","cursor-single","snapshot","callback-reads","references","random","vec2","pixel","evaluation","contract-snapshot","string-snapshot","false-snapshot"]; + let faults=[("fault-callback-1",prometeu_bytecode::TRAP_EXPLICIT),("fault-callback-2",prometeu_bytecode::TRAP_EXPLICIT), + ("fault-callback-3",prometeu_bytecode::TRAP_EXPLICIT),("fault-callback-4",prometeu_bytecode::TRAP_EXPLICIT), + ("fault-callback-5",prometeu_bytecode::TRAP_DIV_ZERO),("fault-overflow",prometeu_bytecode::TRAP_EXPLICIT)]; + for (base,fault) in successes.into_iter().map(|n|(n,None)).chain(faults.into_iter().map(|(n,f)|(n,Some(f)))) { + for suffix in ["","-optimized"] { + let name=format!("{base}{suffix}");let bytes=std::fs::read(root.join(format!("pbs-set-{name}.pbx"))).unwrap_or_else(|e|panic!("mandatory Set {name}: {e}")); + let image=ValidatedProgramImage::load(&bytes,&mut LoadBudget::new(LoadLimits::default()),caps::NONE).unwrap_or_else(|e|panic!("Set {name}: {e:?}")); + let registry=image.registry().clone();let mut vm=VirtualMachine::from_image(image,Default::default());let observer=vm.resource_observer(); + vm.prepare_boot_call().unwrap();let report=vm.run_budget(10_000_000,&mut NoNative,&mut HostContext::new(None)).unwrap(); + if let Some(code)=fault { + let End::Trap(info)=report.reason else{panic!("{name}: {report:?}")};assert_eq!(info.code,code,"{name}: {info:?}"); + if base.starts_with("fault-callback") { + use prometeu_vm::resource_diagnostics::StorageValue as V; + let objects=vm.heap().diagnostic_typed_storage(); + let set=objects.iter().find(|o|registry.declarations().types[o.type_id.0 as usize].name.as_deref()==Some("set")).expect("faulted Set retained"); + assert_eq!(set.groups[0],vec![V::Null],"{name}: unpublished buckets"); + assert_eq!(set.groups[1],vec![V::Int64(0)],"{name}: old size"); + assert_eq!(set.groups[3],vec![V::Boolean(true)],"{name}: guard is not cleaned after fault"); + } + }else { + assert!(matches!(report.reason,End::Halted|End::EndOfRom),"{name}: {report:?}"); + assert_eq!(vm.operand_stack_top(1),vec![Value::Int32(42)],"{name}"); + } + drop(vm); + for resource in [Q::GuestBytes,Q::HandleSlots,Q::AuxiliaryBytes,Q::TemporaryBytes,Q::StringBytes,Q::StringAllocations] { + assert_eq!(observer.used(resource),0,"{name}: final resource release {resource:?}"); + } + println!("SET SOURCE/LOAD/EXEC/GUARD PASS {name}"); + } + } + verify_set_refusals(root); + verify_set_postpublication_injection(root); + verify_collection_cursor_gc(root,"set"); + verify_set_collection_gc(root); + verify_collection_distribution(root,"set",0); + verify_installed_hash(root); + +} + + +fn set_state(vm:&VirtualMachine,image:&ValidatedProgramImage)->ObservedStorage { + use prometeu_vm::resource_diagnostics::StorageValue as V; + let objects=vm.heap().diagnostic_typed_storage(); + let owner=objects.iter().find(|o|image.registry().declarations().types[o.type_id.0 as usize].name.as_deref()==Some("set")).expect("source Set"); + let mut pending=vec![owner.reference];let mut state:ObservedStorage=Vec::new(); + while let Some(reference)=pending.pop() { + if state.iter().any(|o|o.reference==reference){continue;} + let object=objects.iter().find(|o|o.reference==reference).expect("live complete Set group"); + for value in object.groups.iter().flatten(){if let V::Reference(reference)=value{pending.push(*reference);}} + state.push(object.clone()); + } + state.sort_by_key(|o|(o.reference.index,o.reference.generation));state +} +fn set_without_guard(mut state:ObservedStorage,image:&ValidatedProgramImage)->ObservedStorage { + for object in &mut state { + if image.registry().declarations().types[object.type_id.0 as usize].name.as_deref()==Some("set") { + object.groups[3]=vec![prometeu_vm::resource_diagnostics::StorageValue::Boolean(false)]; + } + } + state +} +fn validate_set(vm:&VirtualMachine,image:&ValidatedProgramImage,expected:i64)->usize { + use prometeu_vm::resource_diagnostics::StorageValue as V; + let state=set_state(vm,image); + let owner=state.iter().find(|o|image.registry().declarations().types[o.type_id.0 as usize].name.as_deref()==Some("set")).unwrap(); + assert_eq!(owner.groups[1],vec![V::Int64(expected)]);assert_eq!(owner.groups[3],vec![V::Boolean(false)]); + let get=|reference|state.iter().find(|o|o.reference==reference).expect("reachable object"); + let V::Reference(carrier)=owner.groups[0][0] else{assert_eq!(expected,0);return 0;}; + let V::Reference(table)=get(carrier).groups[0][0] else{panic!("bucket carrier")}; + let buckets=get(table);let capacity=buckets.groups.len();let mut nodes=std::collections::HashSet::new(); + for (bucket,group) in buckets.groups.iter().enumerate() { + if *group==vec![V::Null,V::Null]{continue;} + let [V::Int64(tag),V::Reference(first)]=group.as_slice() else{panic!("complete bucket group")}; + assert_eq!(image.registry().declarations().types[*tag as usize].name.as_deref(),Some("_SetNode")); + let mut next=Some(*first); + while let Some(reference)=next { + assert!(nodes.insert(reference),"each node appears once, no cycles");let node=get(reference); + let V::Int64(hash)=node.groups[0][0] else{panic!("cached complete hash")}; + assert_eq!(hash.rem_euclid(capacity as i64) as usize,bucket); + next=match node.groups[2][0]{V::Null=>None,V::Reference(carrier)=>{let V::Reference(value)=get(carrier).groups[0][0] else{panic!("next node carrier")};Some(value)},_=>panic!("next group")}; + } + } + assert_eq!(nodes.len(),expected as usize);capacity +} +fn verify_set_refusals(root:&std::path::Path) { + use prometeu_vm::{LogicalFrameEndingReason as End,resource_budget::{RuntimeLimits,RuntimeResource as Q}}; + use prometeu_bytecode::{decode_next,isa::core::CoreOpCode as Op,TRAP_RESOURCE_LIMIT}; + let mut node_refusal=false;let mut snapshot_refusal=false;let mut table_refusal=false;let mut guard_effect=false; + for name in ["growth","add","duplicate","remove","clear","cursor"] { + for suffix in ["","-optimized"] { + let bytes=std::fs::read(root.join(format!("pbs-set-refusal-{name}{suffix}.pbx"))).expect("mandatory Set resource fixture"); + let image=ValidatedProgramImage::load(&bytes,&mut LoadBudget::new(LoadLimits::default()),caps::NONE).unwrap(); + let marker=|value:i32|{let mut pc=0;let mut found=Vec::new();while pc")).count()); + max_tables=max_tables.max(objects.iter().filter(|o|matches!(image.registry().declarations().types[o.type_id.0 as usize].kind,prometeu_bytecode::registry::TypeKind::Array(_))).count()); + successful.push((baseline.pc(),observe_originals(&baseline,&old))); + let report=baseline.run_budget(1,&mut NoNative,&mut HostContext::new(None)).unwrap(); + if baseline.pc()==after_pc{break;} + assert!(matches!(report.reason,End::BudgetExhausted),"Set {name}: {report:?}");assert!(successful.len()<200_000); + } + let after=baseline.resource_snapshot();let expected=match name{"growth"|"add"=>size+1,"remove"=>size-1,"clear"=>0,_=>size}; + let capacity=validate_set(&baseline,&image,expected); + assert_eq!(capacity,if name=="growth"{16}else if name=="clear"{0}else{8}); + if name=="growth"{assert!(max_nodes>=13,"six old + six copied + inserted");assert!(max_tables>=2);} + if name=="duplicate"||name=="cursor"{assert_eq!(set_state(&baseline,&image),old);} + println!("SET PEAK {name}{suffix} nodes={max_nodes} tables={max_tables} before={:?} after={:?}",before.budget.peaks,after.budget.peaks); + let mut refusals=0;let mut structural_refusals=0; + for resource in [Q::GuestBytes,Q::HandleSlots,Q::AuxiliaryBytes,Q::TemporaryBytes,Q::CallDepth] { + let lower=before.budget.peaks[resource as usize];let upper=after.budget.peaks[resource as usize];if lower>=upper{continue;} + let mut limits=vec![lower,lower+(upper-lower)/4,lower+(upper-lower)/2,upper-1]; + if resource==Q::HandleSlots{limits.extend(lower..upper.min(lower+24));}limits.sort_unstable();limits.dedup(); + for limit in limits { + let mut vm=prepare(RuntimeLimits::default().lowered(resource,limit).unwrap());let observer=vm.resource_observer(); + assert!(matches!(vm.run_budget(20_000_000,&mut NoNative,&mut HostContext::new(None)).unwrap().reason,End::Breakpoint),"Set setup {name} {resource:?}={limit}"); + let original=set_state(&vm,&image);vm.remove_breakpoint(before_pc); + let (report,prefix,_)=trace_collection_attempt(&mut vm,&original,after_pc);assert_mutation_prefix(&prefix,&successful); + if let End::Trap(info)=report.reason { + assert_eq!(info.code,TRAP_RESOURCE_LIMIT,"Set {name} {resource:?}={limit}: {info:?}"); + let touched=prefix.iter().any(|(_,state)|set_without_guard(state.clone(),&image)!=set_without_guard(original.clone(),&image)); + if !touched {assert_eq!(set_without_guard(observe_originals(&vm,&original),&image),set_without_guard(original.clone(),&image));} + if name=="cursor"{assert_eq!(set_state(&vm,&image),original);} + let now=observe_originals(&vm,&original);guard_effect|=!touched&&now!=original; + structural_refusals+=usize::from(touched); + let instruction=decode_next(info.pc as usize,image.code()).unwrap();table_refusal|=name=="growth"&&instruction.opcode==Op::ArrayNew; + if instruction.opcode==Op::StructNew { + let named=image.registry().declarations().types[instruction.imm_u32().unwrap() as usize].name.as_deref(); + node_refusal|=named==Some("_SetNode");snapshot_refusal|=named==Some("_SnapshotNode"); + } + refusals+=1;println!("SET PHASE REFUSAL {name}{suffix} structural={touched} resource={resource:?} limit={limit} opcode={:?}",instruction.opcode); + }else{assert!(matches!(report.reason,End::BudgetExhausted|End::Breakpoint)&&vm.pc()==after_pc);} + drop(vm);for q in [Q::GuestBytes,Q::HandleSlots,Q::AuxiliaryBytes,Q::TemporaryBytes]{assert_eq!(observer.used(q),0);} + } + } + assert!(refusals>0,"Set {name}: resource refusal evidence"); + println!("SET PHASE SUMMARY {name}{suffix} refusals={refusals} after_structural_write={structural_refusals}"); + } + } + assert!(node_refusal&&snapshot_refusal&&table_refusal&&guard_effect,"nodes/snapshot/table/guard refusal evidence required"); +} +fn verify_set_collection_gc(root:&std::path::Path) { + use prometeu_vm::LogicalFrameEndingReason as End; + let bytes=std::fs::read(root.join("pbs-set-gc-collection.pbx")).expect("mandatory Set collection GC fixture"); + let image=ValidatedProgramImage::load(&bytes,&mut LoadBudget::new(LoadLimits::default()),caps::NONE).unwrap(); + let mut vm=VirtualMachine::from_image(image.clone(),Default::default());vm.prepare_boot_call().unwrap();let mut previous=0; + for (round,count) in [64,61,0,0].into_iter().enumerate() { + let report=vm.run_budget(30_000_000,&mut NoNative,&mut HostContext::new(None)).unwrap();assert!(matches!(report.reason,End::FrameSync),"Set GC {round}: {report:?}"); + let collections=vm.resource_snapshot().gc.collections;assert!(collections>previous);previous=collections; + let objects=vm.heap().diagnostic_typed_storage(); + for name in ["_SetNode","Item"] { + let actual=objects.iter().filter(|o|image.registry().declarations().types[o.type_id.0 as usize].name.as_deref()==Some(name)).count();assert_eq!(actual,count,"Set GC {round}: {name}"); + } + println!("SET COLLECTION/OLD-CANDIDATE GC PASS round={round} live_nodes={count}"); + } + let report=vm.run_budget(100_000,&mut NoNative,&mut HostContext::new(None)).unwrap();assert!(matches!(report.reason,End::Halted|End::EndOfRom));assert_eq!(vm.operand_stack_top(1),vec![Value::Int32(42)]); +} + + +// Controlled test-only source instrumentation, never a production SDK algorithm. +// A quota probe is inserted after the real candidate-table store and before size. +// Natural production-quota coverage and its refusal frequencies remain separate. +fn verify_set_postpublication_injection(root:&std::path::Path) { + use prometeu_vm::{LogicalFrameEndingReason as End,resource_budget::{RuntimeLimits,RuntimeResource as Q},resource_diagnostics::StorageValue as V}; + use prometeu_bytecode::{decode_next,isa::core::CoreOpCode as Op,TRAP_RESOURCE_LIMIT}; + for suffix in ["","-optimized"] { + let bytes=std::fs::read(root.join(format!("pbs-set-injected-refusal-growth{suffix}.pbx"))).expect("explicit test-only post-publication injection"); + let image=ValidatedProgramImage::load(&bytes,&mut LoadBudget::new(LoadLimits::default()),caps::NONE).unwrap(); + let limits=RuntimeLimits::default().lowered(Q::GuestBytes,500_000).unwrap(); + let mut vm=VirtualMachine::from_image(image.clone(),limits);let observer=vm.resource_observer();vm.prepare_boot_call().unwrap(); + let mut found=false; + for _ in 0..200_000 { + let instruction=decode_next(vm.pc(),image.code()).unwrap(); + if instruction.opcode==Op::ArrayNew&&vm.operand_stack_top(1)==vec![Value::Int64(1_000_000)] { + let original=vm.heap().diagnostic_typed_storage();let state=set_state(&vm,&image); + let owner=state.iter().find(|o|image.registry().declarations().types[o.type_id.0 as usize].name.as_deref()==Some("set")).unwrap(); + assert_eq!(owner.groups[1],vec![V::Int64(6)]);assert_eq!(owner.groups[3],vec![V::Boolean(true)]); + assert_eq!(state.iter().filter(|o|image.registry().declarations().types[o.type_id.0 as usize].name.as_deref()==Some("_SetNode")).count(),7); + assert!(state.iter().any(|o|matches!(image.registry().declarations().types[o.type_id.0 as usize].kind,prometeu_bytecode::registry::TypeKind::Array(_))&&o.groups.len()==16)); + let input=vm.operand_stack_top(1).to_vec();let report=vm.run_budget(1,&mut NoNative,&mut HostContext::new(None)).unwrap(); + let End::Trap(info)=report.reason else{panic!("post-publication injection: {report:?}")};assert_eq!(info.code,TRAP_RESOURCE_LIMIT); + assert_eq!(vm.heap().diagnostic_typed_storage(),original,"refused probe preserves its entry state, retaining earlier table publication"); + assert_eq!(vm.operand_stack_top(1),input); + println!("SET TEST-ONLY POST-PUBLICATION QUOTA INJECTION PASS {suffix}: new table=16 nodes=7 old size=6 guard=true");found=true;break; + } + let report=vm.run_budget(1,&mut NoNative,&mut HostContext::new(None)).unwrap();assert!(matches!(report.reason,End::BudgetExhausted),"before injection: {report:?}"); + } + assert!(found);drop(vm);for q in [Q::GuestBytes,Q::HandleSlots,Q::AuxiliaryBytes,Q::TemporaryBytes]{assert_eq!(observer.used(q),0);} + } +} + + +fn verify_identity_negative_fixtures(root:&std::path::Path) { + use prometeu_vm::LogicalFrameEndingReason as End; + use prometeu_bytecode::{decode_next,isa::core::CoreOpCode as Op}; + for base in ["bad-category","bad-right","dead-bad-category","bad-typeid"] { + for suffix in ["","-optimized"] { + let name=format!("common-identity-{base}{suffix}");let bytes=std::fs::read(root.join(format!("{name}.pbx"))).unwrap(); + assert!(ValidatedProgramImage::load(&bytes,&mut LoadBudget::new(LoadLimits::default()),caps::NONE).is_err(),"{name}"); + println!("IDENTITY NEUTRAL ADMISSION REJECT PASS {name}"); + } + } + for base in ["partial","truncated"] { + let bytes=std::fs::read(root.join(format!("common-identity-{base}.pbx"))).unwrap(); + assert!(ValidatedProgramImage::load(&bytes,&mut LoadBudget::new(LoadLimits::default()),caps::NONE).is_err()); + println!("IDENTITY PARTIAL/TRUNCATED ADMISSION REJECT PASS {base}"); + } + for base in ["null-views","right-after-null","right-after-distinct"] { + let bytes=std::fs::read(root.join(format!("common-identity-{base}.pbx"))).unwrap(); + let image=ValidatedProgramImage::load(&bytes,&mut LoadBudget::new(LoadLimits::default()),caps::NONE).unwrap_or_else(|e|panic!("{base}: {e:?}")); + let mut vm=VirtualMachine::from_image(image.clone(),Default::default());vm.prepare_boot_call().unwrap(); + loop { + let instruction=decode_next(vm.pc(),image.code()).unwrap(); + if instruction.opcode==Op::RefIdentityEq { + let operands=vm.operand_stack_top(3).to_vec(); + let zero=vm.run_budget(0,&mut NoNative,&mut HostContext::new(None)).unwrap();assert_eq!((zero.cycles_used,zero.steps_executed),(0,0)); + let report=vm.run_budget(1,&mut NoNative,&mut HostContext::new(None)).unwrap();assert_eq!(report.cycles_used,7); + if base=="null-views" { + assert!(matches!(report.reason,End::BudgetExhausted));assert_eq!(vm.operand_stack_top(1),vec![Value::Boolean(true)]); + }else { + let End::Trap(info)=report.reason else{panic!("{base}: right validation was skipped: {report:?}")}; + assert_eq!(info.code,prometeu_bytecode::TRAP_TYPE);assert_eq!(report.steps_executed,0);assert_eq!(vm.operand_stack_top(3),operands); + } + println!("IDENTITY COMPLETE RIGHT/NULL/FUEL/COST PASS {base}");break; + } + let report=vm.run_budget(1,&mut NoNative,&mut HostContext::new(None)).unwrap();assert!(matches!(report.reason,End::BudgetExhausted)); + } + } +} +fn verify_installed_hash(root:&std::path::Path) { + use prometeu_vm::LogicalFrameEndingReason as End; + let bytes=std::fs::read(root.join("pbs-hash-installed.pbx")).expect("mandatory installed hashing example"); + let image=ValidatedProgramImage::load(&bytes,&mut LoadBudget::new(LoadLimits::default()),caps::NONE).unwrap(); + let mut vm=VirtualMachine::from_image(image,Default::default());vm.prepare_boot_call().unwrap(); + let report=vm.run_budget(1_000_000,&mut NoNative,&mut HostContext::new(None)).unwrap(); + assert!(matches!(report.reason,End::FrameSync|End::Halted|End::EndOfRom),"installed hashing: {report:?}"); + println!("HASH INSTALLED JAR/SDK/EXAMPLE LOAD/EXEC PASS"); +} diff --git a/tools/pbx-conformance/run.py b/tools/pbx-conformance/run.py index f29e712f..6abc0a9a 100644 --- a/tools/pbx-conformance/run.py +++ b/tools/pbx-conformance/run.py @@ -12,6 +12,8 @@ parser.add_argument("--runtime", type=pathlib.Path, default=pathlib.Path("../run parser.add_argument("--fixtures", type=pathlib.Path, default=pathlib.Path("prometeu-compiler/prometeu-build-pipeline/build/registry-conformance")) parser.add_argument("--online", action="store_true", help="Allow Cargo to fetch uncached dependencies") parser.add_argument("--release", action="store_true", help="Execute an optimized runtime harness") +parser.add_argument("--set-only", action="store_true", help="Run mandatory PBS Set corpus") +parser.add_argument("--identity-hashing-only", action="store_true", help="Run mandatory neutral and PBS identity/hash corpus") parser.add_argument("--math-only", action="store_true", help="Run the complete PBS math corpus only") parser.add_argument("--random-only", action="store_true", help="Run the complete PBS Random corpus only") parser.add_argument("--generic-contracts-only", action="store_true", help="Run the mandatory generic-contract source corpus only") @@ -25,6 +27,10 @@ if not args.math_only: consumer_vectors = pathlib.Path("prometeu-architecture-tests/src/test/resources/random/random-conformance.tsv") if provider_vectors.read_bytes() != consumer_vectors.read_bytes(): raise SystemExit("Random oracle differs from the selected provider; update provenance and requalify") +provider_hash_vectors = runtime / "crates/console/prometeu-vm/tests/fixtures/hash-conformance.tsv" +consumer_hash_vectors = pathlib.Path("prometeu-architecture-tests/src/test/resources/hash/hash-conformance.tsv") +if provider_hash_vectors.read_bytes() != consumer_hash_vectors.read_bytes(): + raise SystemExit("Hash oracle differs from selected provider") print(subprocess.check_output(["rustc", "-Vv"], text=True).strip(), flush=True) for source in [pathlib.Path(__file__), pathlib.Path(__file__).with_name("main.rs"), pathlib.Path("prometeu-architecture-tests/src/test/java/p/studio/compiler/backend/irvm/PbsRuntimeRandomTest.java"), @@ -52,4 +58,4 @@ with tempfile.TemporaryDirectory(prefix="pbx-conformance-") as directory: (root / "Cargo.lock").write_text((runtime / "Cargo.lock").read_text()) (root / "src").mkdir() (root / "src/main.rs").write_text(pathlib.Path(__file__).with_name("main.rs").read_text()) - subprocess.run(["cargo", "run", *(["--release"] if args.release else []), *([] if args.online else ["--offline"]), "--manifest-path", str(root / "Cargo.toml"), "--", str(args.fixtures.resolve()), str(runtime / "devtools/headless-protocol/response.schema.json"), *(["--math-only"] if args.math_only else []), *(["--random-only"] if args.random_only else []), *(["--generic-contracts-only"] if args.generic_contracts_only else []), *(["--generic-structs-only"] if args.generic_structs_only else []), *(["--list-cursor-only"] if args.list_cursor_only else []), *(["--linked-only"] if args.linked_only else [])], check=True) + subprocess.run(["cargo", "run", *(["--release"] if args.release else []), *([] if args.online else ["--offline"]), "--manifest-path", str(root / "Cargo.toml"), "--", str(args.fixtures.resolve()), str(runtime / "devtools/headless-protocol/response.schema.json"), *(["--set-only"] if args.set_only else []), *(["--identity-hashing-only"] if args.identity_hashing_only else []), *(["--math-only"] if args.math_only else []), *(["--random-only"] if args.random_only else []), *(["--generic-contracts-only"] if args.generic_contracts_only else []), *(["--generic-structs-only"] if args.generic_structs_only else []), *(["--list-cursor-only"] if args.list_cursor_only else []), *(["--linked-only"] if args.linked_only else [])], check=True)