Files
prometeu-studio/docs/vm-arch
bquarkz 603ed01227 feat(compiler): port runtime catalogs and enforce target ABI (AGD77)
Import both runtime catalogs and provenance, port all intrinsic metadata and exact constants, and validate target signatures and carriers through the common pipeline. Package matching compiler/SDK resources and add active parity plus production runtime conformance checks.

Validation: 420 compiler/PBS tests passed, with 12 existing skips; provider export, runtime execution and installed catalog checks passed. The pre-existing Gfx.clear typed-metadata failure remains active and assigned to AGD78 under the explicitly accepted scope revision recorded in LSN-0080.
2026-10-15 13:07:49 +01:00
..
2026-09-19 00:19:45 +01:00
2026-09-19 00:19:45 +01:00

VM Architecture Mirror Policy

The Prometeu runtime repository is the normative authority for PBX binary layout, Core ISA, loader behavior, verification, and PVM execution semantics. The files in this directory are convenience mirrors for Studio-side compiler and integration work; they are not an independent architectural authority.

Canonical runtime sources:

  • ../runtime/docs/vm-arch/ARCHITECTURE.md
  • ../runtime/docs/vm-arch/ISA_CORE.md
  • ../runtime/docs/vm-arch/INTRINSICS.csv
  • ../runtime/docs/vm-arch/BUILTIN_CONSTANTS.csv

When these mirrors are retained, an integration change that updates a canonical runtime source MUST update the corresponding Studio mirror in the same logical change. Verify synchronization from the Studio repository root with:

diff -u docs/vm-arch/ARCHITECTURE.md ../runtime/docs/vm-arch/ARCHITECTURE.md
diff -u docs/vm-arch/ISA_CORE.md ../runtime/docs/vm-arch/ISA_CORE.md
diff -u docs/vm-arch/INTRINSICS.csv ../runtime/docs/vm-arch/INTRINSICS.csv
diff -u docs/vm-arch/BUILTIN_CONSTANTS.csv ../runtime/docs/vm-arch/BUILTIN_CONSTANTS.csv

All four commands MUST exit successfully with no output before a change claims that the mirrors are synchronized. If the runtime repository is not available in the same checkout, synchronization evidence must be produced against the canonical runtime revision before merging.

Compiler-owned transformation contracts remain under docs/specs/compiler. Those specifications define IRBackend -> IRVM -> PBX emission, but they MUST conform to the runtime-owned PBX and ISA contracts and MUST NOT redefine runtime execution semantics.

Catalog provenance

runtime-catalog.properties identifies the selected provider revision and hashes of both CSVs. The compiler and PBS SDK package these artifacts with their own resource namespaces. Catalog synchronization alone does not claim the other architecture mirrors are synchronized or that all PBS facades are implemented.

Run the explicit source/exporter verification from the Studio root:

python3 tools/runtime-catalog/verify.py --runtime ../runtime

This command requires a clean checkout of the recorded provider revision, compares committed bytes and hashes, and runs its real catalog exporter parity test with build output in a temporary directory. Missing or different evidence sources fail explicitly. Ordinary builds and local catalog tests never invoke this command.

The manual port and consumer requirements are defined in Runtime catalog support.