# V38 Parity Matrix (Phase 1)

## Status
- Date: 2026-03-04
- Phase: 1 + secondary-scope execution recipe validated (non-retiring blast run green, including full-v38 toggle lane)
- Scope lock: `engine/tests/core`, `engine/tests/vm`, `engine/tests/story`, `engine/tests/service`
- Explicitly out of first-pass classification scope: `engine/tests/integration`, `engine/tests/loaders`, `engine/tests/ir` (now tracked as secondary execution scope)

## Purpose
This matrix classifies each in-scope legacy test module exactly once and maps it to either:
- `PORT_*`: move test intent into v38 behavior/contracts.
- `RETIRE_*`: remove from parity gate because behavior is gone, moved, or irrelevant.

This document tracks both mapping decisions and current parity execution status for mapped `PORT_*` targets.

## Phase 1.5 Execution Recipe (Validated)
This experiment is now the active migration recipe:
1. Normalize non-retiring imports to top-level surfaces (`tangl.core`, `tangl.vm`, `tangl.story`, `tangl.service`) so blast radius is measurable.
2. Add/keep thin compatibility bridges only where needed (selector/caller aliasing, record-like acceptance, type aliases).
3. Pin explicit legacy semantics only where behavior is still intentionally legacy (for example `StoryGraph` in selected tests).
4. Convert eager legacy imports in loader/service entrypoints to lazy imports so v38 flows do not pull legacy internals by accident.
5. Re-run the non-retiring blast gate and only keep bridges still required by passing behavior.

## Secondary Scope Bridge Matrix (Integration/Loaders/IR)
| concern | temporary bridge (now) | end-state target | test policy |
|---|---|---|---|
| Deep import drift bypassing shims | Replace deep imports with top-level package imports in non-retiring modules/tests | Remove legacy package shims entirely; import `core38`/`vm38`/`story38`/`service38` directly | Keep tests if they validate externally observable behavior |
| Legacy story-graph semantics still required by some tests | Use `StoryGraph` explicitly in tests that still require legacy runtime behavior | Port those tests to v38 semantics or retire if no external behavior is covered | Retire tests that only assert legacy graph internals |
| Legacy matcher syntax (`matches(**criteria)` / filter helpers) | Translate to selector-first matching where low-risk (`Selector(...).matches(entity)`) | Remove compatibility aliases once callsites are migrated | Keep only behavior-focused assertions, not matcher implementation details |
| Loader/service eager legacy imports | Convert to lazy imports in runtime37-only paths | Remove runtime37 code paths when fully retired | Keep loader tests that validate world discovery/compile outputs |
| Legacy-internal assertions in secondary suites | Explicitly classify as retirement candidates | Drop from parity gate unless tied to missing public behavior | If no external consumer-facing gap exists, retire |

## Secondary Scope Test Retirement Policy
- Keep tests that validate observable contracts: API outputs, journal/choice behavior, loader/compiler outputs, replay/provision invariants.
- Retire tests that only inspect legacy internal classes, private fields, or historical execution mechanics with no v38 contract value.
- Keep or reintroduce a retired test only when it demonstrates a legitimately missing feature relied on by another non-retiring area.
- For media while v37/v38 mechanics are in transition, keep only stable contracts (resource indexing and RIT/URL dereference shape); retire legacy phase-runner/media-dependency internal assertions.

## Secondary Scope File Matrix (Integration/Loaders/IR, 2026-03-05 pass 3)
| path | disposition | rationale | status |
|---|---|---|---|
| `engine/tests/integration/test_choice_availability_e2e.py` | `RETIRE_LEGACY_INTERNAL` | Hard-coupled to `StoryGraph` + legacy phase runner internals; no longer a v38 contract gate. | retired (module skipped) |
| `engine/tests/integration/test_media_e2e.py` | `RETIRE_LEGACY_INTERNAL` | Depends on legacy v37 phase-runner/media-dependency mechanics that are not vm38 contract assertions. | retired (module skipped) |
| `engine/tests/integration/test_service_layer.py` | `PORT_ADAPT` | Integration smoke flow now runs through `create_story38`/`resolve_choice38`/`get_story_update38` on service-layer orchestrator wiring. | ported to runtime38 |
| `engine/tests/integration/test_system_media_e2e.py` | `KEEP_DIRECT` | Validates system-media URL dereference contract; runtime-version agnostic. | kept |
| `engine/tests/loaders/test_world_loader.py::test_compile_anthology_shares_domain_and_media` | `RETIRE_LEGACY_INTERNAL` | Asserts runtime37-only world internals (`domain_manager`/`resource_manager`) with no added v38 signal. | retired (test skipped) |
| `engine/tests/loaders/test_world_loader.py::test_loader_creates_runtime38_world_with_media_registry` | `PORT_ADAPT` | Same intent as legacy media-registry smoke test, now asserted against runtime38 world facets (`resources`, `bundle`). | ported to runtime38 |
| `engine/tests/loaders/test_world_loader.py::test_compiler_adds_bundle_root_for_domain_imports` | `PORT_ADAPT` | Preserves domain import-path contract while asserting runtime38 world domain facet wiring. | ported to runtime38 |
| `engine/tests/loaders/test_round_tripping.py` | `RETIRE_LEGACY_INTERNAL` | Relied on legacy ScriptManager template-shape assumptions that do not map 1:1 to story38 template bundle/runtime representation. | retired (module skipped) |
| `engine/tests/loaders/test_world_bundle.py` | `KEEP_DIRECT` | Bundle manifest/path normalization contract is runtime-neutral and still required. | kept |
| `engine/tests/loaders/test_world_manifest.py` | `KEEP_DIRECT` | Manifest schema/normalization contract is runtime-neutral and still required. | kept |
| `engine/tests/ir/test_base_script_item_path.py` | `RETIRE_LEGACY_INTERNAL` | Asserts live parent-chain path semantics from legacy `HierarchicalTemplate`; v38 scope parity is covered by core38 `admission_scope` tests. | retired (module skipped) |
| `engine/tests/ir/test_base_script_item_selectable.py` | `RETIRE_LEGACY_INTERNAL` | Depends on legacy `Entity.matches` selector internals and `ancestor_tags` scope gates; those contracts are retired for v38 parity. | retired (module skipped) |
| `engine/tests/ir/test_script_item_selection.py` | `RETIRE_LEGACY_INTERNAL` | Validates legacy criteria shape (`has_path` + `has_ancestor_tags`) rather than v38 template admission behavior. | retired (module skipped) |
| `engine/tests/ir/test_template_field_conversion.py` | `RETIRE_MOVED` | Front-end tree conversion (`visit_field` + implicit path inference) belongs to codec/compiler migration track, not core template parity. | retired (module skipped) |
| `engine/tests/ir/test_round_trip.py` | `RETIRE_MOVED` | YAML IR round-trip asserts legacy script shape; equivalent parity is already covered by core38 template compile/decompile/roundtrip tests. | retired (module skipped) |
| `engine/tests/ir/test_script_round_trip.py` | `RETIRE_REMOVED` | `ancestor_tags` serialization is no longer a v38 template feature; scope matching now maps to admission-scope semantics. | retired (module skipped) |
| `engine/tests/ir/{test_base_script_item.py,test_block_media_script.py,test_ir.py,test_role_setting_scripts.py,test_role_setting_shorthands.py,test_scene_block_templates.py}` | `KEEP_ADAPT` | These still validate active IR schema/shorthand/reference/media parsing contracts not duplicated by core38 template unit coverage. | kept |

### IR Coverage Hand-Off to `core38.template`
- Scope admission behavior (`path_pattern` parity lane) is covered by:
  - `engine/tests/core38/template/test_template.py::test_admitted_to_matches_scope_prefix`
  - `engine/tests/core38/template/test_template.py::test_admitted_to_non_wildcard_scope_requires_leaf_segment`
  - `engine/tests/core38/template/test_template.py::test_selector_can_filter_with_admitted_to`
- Template compile/decompile and round-trip behavior is covered by:
  - `engine/tests/core38/template/test_template.py::test_unstructure_structure_roundtrip`
  - `engine/tests/core38/template/test_template.py::test_template_group_decompile_roundtrip`
  - `engine/tests/core38/template/test_template.py::test_template_group_compile_yields_depth_first`

## IR Legacy-Only Triage Snapshot (2026-03-05 pass 4)
- Module-level skips added for legacy IR mechanics now covered by `core38.template` or moved to compiler/codec migration:
  - `engine/tests/ir/test_base_script_item_path.py`
  - `engine/tests/ir/test_base_script_item_selectable.py`
  - `engine/tests/ir/test_script_item_selection.py`
  - `engine/tests/ir/test_template_field_conversion.py`
  - `engine/tests/ir/test_round_trip.py`
  - `engine/tests/ir/test_script_round_trip.py`
- Validation runs:
  - Command: `poetry run pytest -q engine/tests/ir`
  - Result: `22 passed, 17 skipped, 1 xfailed`
  - Command: `poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1621 passed, 68 skipped, 9 xfailed`
  - Command: `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=v38 poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1621 passed, 68 skipped, 9 xfailed`

## Deferred Track: Media Planning (2026-03-04)
- Status: deferred by design for a dedicated follow-up track.
- Why deferred: loader/codec and IR ingestion are still evolving, and legacy media planning internals are not a stable parity target.
- Diagnostic policy now: keep skip-based diagnostics on legacy-coupled media integration tests (`engine/tests/integration/test_media_e2e.py`) while preserving stable system-media contracts (`engine/tests/integration/test_system_media_e2e.py`).
- Exit criteria for this deferred track:
  - vm38-native media planning/provision hook for media dependencies,
  - parity coverage for world-vs-system media resolution behavior,
  - service-layer dereference contract coverage for media URLs/content.

## Non-Retiring Blast Snapshot (2026-03-04)
- Validation run:
  - Command: `poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1640 passed, 48 skipped, 10 xfailed`
- Full-v38 toggle validation run (updated):
  - Command: `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=v38 poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1636 passed, 52 skipped, 10 xfailed`
- Additional bridge reductions validated in this run:
  - `engine/tests/persistence/test_ledger_persistence.py` exercises `tangl.vm.Ledger` + `CheckpointRecord` directly.
  - `tangl.core.record.base_fragment.BaseFragment` now derives from `tangl.core.Record` while keeping alias/serialization compatibility (`fragment_type`, `content`, `has_channel`).

## Vocabulary Migration Snapshot (2026-03-04 pass 3)
- Historical snapshot only. A later 2026-03-15 cleanup removed the remaining
  active `obj_cls` compatibility paths, fixtures, and authored data from the
  live repo, so the bullets below describe the intermediate migration state
  rather than current engine behavior.
- `obj_cls -> kind` migration is now mechanically adopted in non-retiring mechanics/media callsites via compat wrappers (`kind` first, fallback to `obj_cls` where needed for mixed lanes).
- Persistence structuring now accepts `kind` (preferred) and legacy `obj_cls`, and emits both keys for cross-lane compatibility.
- Coverage added: `engine/tests/persistence/test_structuring_handler.py` validates `kind`/`obj_cls` dual support.
- Focused validation run:
  - Command: `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=v38 poetry run pytest -q engine/tests/mechanics/games/test_has_game.py engine/tests/mechanics/games/test_game_handlers.py engine/tests/mechanics/games/test_rps_integration.py engine/tests/media/test_system_media_integration.py engine/tests/persistence/test_structuring_handler.py`
  - Result: `25 passed, 2 skipped`

## VM Constructor Migration Snapshot (2026-03-04 pass 4)
- Active mechanics game callsites now use explicit capability checks instead of exception-driven compatibility branches.
  - Updated source/test adapters:
    - `engine/src/tangl/mechanics/games/has_game.py`
    - `engine/tests/mechanics/games/test_has_game.py`
    - `engine/tests/mechanics/games/test_game_handlers.py`
    - `engine/tests/mechanics/games/test_rps_integration.py`
- Focused validation run:
  - Command: `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=v38 poetry run pytest -q engine/tests/mechanics/games/test_has_game.py engine/tests/mechanics/games/test_game_handlers.py engine/tests/mechanics/games/test_rps_integration.py engine/tests/mechanics/games/test_step_turn_round.py`
  - Result: `33 passed`
- Full non-retiring lane remained stable:
  - Command: `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=v38 poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1636 passed, 52 skipped, 10 xfailed`
- Skip inventory check:
  - deferred/retired skip reasons are unchanged; no new trivial feature-gap regressions were introduced in this pass.

## Domain Registration + Persistence Snapshot (2026-03-04 pass 5)
- Domain class registration now accepts explicit core38 entity inheritance (recorded before shim package defaults were later flipped to v38):
  - `tangl.story.fabula.domain_manager._is_entity_subclass(...)` includes `tangl.core.Entity`.
  - `load_domain_module(...)` excludes `Entity38` base types from registration.
- Domain facet now explicitly exposes dispatch authorities for runtime38 world authority cascades:
  - `tangl.story.fabula.domain_manager.DomainManager.get_authorities()` returns the domain `dispatch_registry`.
- Runtime38 loader coverage now authors domain classes against `tangl.core.Entity` in active tests:
  - `engine/tests/loaders/test_world_loader.py::test_compile_anthology_runtime38_shares_world_facets`
  - `engine/tests/loaders/test_world_loader.py::test_compiler_adds_bundle_root_for_domain_imports`
  - `engine/tests/story38/test_story_init.py::test_loader_compiler_runtime_38_path`
- Persistence vm38 vocabulary cleanup:
  - `engine/tests/persistence/test_ledger_persistence.py` now uses `Ledger.from_graph(...)` and `output_stream` assertions.
- Focused validation runs:
  - Command: `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=v38 poetry run pytest -q engine/tests/loaders/test_world_loader.py::test_compile_anthology_runtime38_shares_world_facets engine/tests/loaders/test_world_loader.py::test_compiler_adds_bundle_root_for_domain_imports`
  - Result: `2 passed`
  - Command: `poetry run pytest -q engine/tests/loaders/test_world_loader.py::test_compile_anthology_runtime38_shares_world_facets engine/tests/loaders/test_world_loader.py::test_compiler_adds_bundle_root_for_domain_imports`
  - Result: `2 passed` (verifies runtime38 domain registration without shim env overrides)
  - Coverage expansion:
    - loader runtime38 assertions now verify world authority exposure includes domain dispatch registry.
  - Command: `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=v38 poetry run pytest -q engine/tests/persistence/test_ledger_persistence.py`
  - Result: `14 passed, 8 skipped`
  - Command: `poetry run pytest -q engine/tests/story38/test_story_init.py::test_loader_compiler_runtime_38_path`
  - Result: `1 passed`
- Full non-retiring lane remained stable:
  - Command: `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=v38 poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1636 passed, 52 skipped, 10 xfailed`

## VM/Story Surface Cleanup Snapshot (2026-03-04 pass 6)
- Mechanics game tests now run v38-native surfaces directly (core38/vm38/story38) with constructor-vocabulary compatibility branches removed:
  - `engine/tests/mechanics/games/test_has_game.py`
  - `engine/tests/mechanics/games/test_game_handlers.py`
  - `engine/tests/mechanics/games/test_rps_integration.py`
  - `engine/tests/mechanics/games/test_step_turn_round.py`
- Mechanics runtime sources aligned to v38 edge/action classes to avoid mixed-lane edge objects:
  - `engine/src/tangl/mechanics/games/has_game.py` uses `vm38.TraversableEdge`/`ResolutionPhase` in game-block edge wiring.
  - `engine/src/tangl/mechanics/games/handlers.py` provisions `story38.Action` edges.
- Runtime38 loader parity assertion expanded:
  - `engine/tests/story38/test_story_init.py::test_loader_compiler_runtime_38_path` now asserts domain dispatch registry presence in `compiled.get_authorities()`.
- Deferred media planning now uses explicit module skip in `engine/tests/media/test_system_media_integration.py` (consistent with deferred-track policy).
- Focused validation run:
  - Command: `poetry run pytest -q engine/tests/mechanics/games/test_has_game.py engine/tests/mechanics/games/test_game_handlers.py engine/tests/mechanics/games/test_rps_integration.py engine/tests/mechanics/games/test_step_turn_round.py`
  - Result: `33 passed`
- Non-retiring blast validation:
  - Default lane: `1640 passed, 48 skipped, 10 xfailed`
  - Full-v38 lane: `1636 passed, 52 skipped, 10 xfailed`
- Remaining callsite inventory (current):
  - VM constructor/vocabulary: `2` active helper callsites (`frame._make_ctx()` in mechanics tests), `16` legacy callsites in skipped/deferred modules (`integration/*`, `media/*`, `test_game_journal_content.py`).
  - Domain registration/authority: `0` active blockers; `1` remaining legacy entity import callsite in skipped runtime37 loader fixture.
  - IR/template authoring: `1` core bridge file (`tangl.ir.core_ir.base_script_model` -> `HierarchicalTemplate`) plus associated IR tests; this remains the architectural migration tail.

## Remaining Shim Work (Primary)
- `core.factory` remains active in IR authoring models:
  - `engine/src/tangl/ir/core_ir/base_script_model.py` still subclasses legacy `HierarchicalTemplate`.
  - This is the largest remaining conceptual bridge until IR/template authoring migrates to `core38.template`/`TemplateRegistry`.
- Legacy matcher semantics still appear in retired/legacy-coupled tests:
  - `engine/tests/ir/test_base_script_item_selectable.py` continues to assert `matches(...)` internals (already classified retirement candidate).
- `core.domain` retirement status is on track:
  - no active non-retiring imports from `tangl.core.domain`;
  - `tangl.story.fabula.domain_manager` remains the intentional world-specific class/dispatch registry seam.

## Shim Switchboard (2026-03-04)
- Added env-driven symbol switches to compatibility shims:
  - `tangl.core`:
    - package default: `TANGL_SHIM_CORE_DEFAULT`
    - per symbol: `TANGL_SHIM_CORE_ENTITY|REGISTRY|GRAPHITEM|GRAPH|EDGE|SUBGRAPH|RECORD|SNAPSHOT|NODE`
  - `tangl.vm`:
    - package default: `TANGL_SHIM_VM_DEFAULT`
    - per symbol: `TANGL_SHIM_VM_BUILDRECEIPT|CHOICEEDGE|CONTEXT|FRAME|LEDGER|PLANNINGRECEIPT|RESOLUTIONPHASE`
  - `tangl.story`:
    - package default: `TANGL_SHIM_STORY_DEFAULT`
    - per symbol: `TANGL_SHIM_STORY_ACTION|BLOCK|SCENE|STORYGRAPH`
  - `tangl.service`:
    - package default: `TANGL_SHIM_SERVICE_DEFAULT`
    - per symbol: `TANGL_SHIM_SERVICE_APIENDPOINT|ORCHESTRATOR`
- Value semantics:
  - legacy: `legacy/old/0/false/off`
  - v38: `v38/new/1/true/on`
- Initial switchboard rollout kept package defaults unchanged; later cutover to v38 defaults is tracked under
  `Shim Default Cutover (2026-03-05)`.
- First canary cut:
  - Command: `TANGL_SHIM_STORY_BLOCK=v38 poetry run pytest ... --maxfail=20`
  - Result: `10 failed, 1629 passed, 46 skipped, 10 xfailed`
  - Signal: expected mixed-runtime breakage in mechanics/media paths that combine legacy story graph/runtime with a v38 block type.

### Service Switchboard Validation (2026-03-05)
- Added service switchboard in `tangl.service` for `ApiEndpoint` and `Orchestrator`.
- Active integration service smoke now imports v38 orchestrator directly (`engine/tests/integration/test_service_layer.py`),
  retiring dependence on shim-selected legacy service behavior.
- Retired `engine/tests/mechanics/games/test_game_journal_content.py` from parity gate as legacy story-dispatch internals.
- Non-retiring gate with service forced to v38:
  - Command: `TANGL_SHIM_SERVICE_DEFAULT=v38 poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1621 passed, 68 skipped, 9 xfailed`
- Full-v38 gate with service forced to v38:
  - Command: `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=v38 TANGL_SHIM_SERVICE_DEFAULT=v38 poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1621 passed, 68 skipped, 9 xfailed`
- Legacy canary (service default legacy):
  - Command: `TANGL_SHIM_SERVICE_DEFAULT=legacy poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1621 passed, 68 skipped, 9 xfailed`
  - Signal: no remaining non-retiring dependence on legacy `tangl.service.Orchestrator`.
- Per-symbol canaries (service default v38):
  - Command: `TANGL_SHIM_SERVICE_DEFAULT=v38 TANGL_SHIM_SERVICE_ORCHESTRATOR=legacy poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1621 passed, 68 skipped, 9 xfailed`
  - Command: `TANGL_SHIM_SERVICE_DEFAULT=v38 TANGL_SHIM_SERVICE_APIENDPOINT=legacy poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1621 passed, 68 skipped, 9 xfailed`

### Shim Default Cutover (2026-03-05)
- Compatibility package defaults now prefer v38 while preserving env overrides:
  - `tangl.core`: `_pick(..., default="v38")`
  - `tangl.vm`: `_pick(..., default="v38")`
  - `tangl.story`: `_pick(..., default="v38")`
- Validation:
  - Command: `poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1621 passed, 68 skipped, 9 xfailed`
  - Command: `TANGL_SHIM_CORE_DEFAULT=legacy TANGL_SHIM_VM_DEFAULT=legacy TANGL_SHIM_STORY_DEFAULT=legacy TANGL_SHIM_SERVICE_DEFAULT=legacy poetry run pytest -q engine/tests --ignore=engine/tests/core --ignore=engine/tests/service --ignore=engine/tests/vm --ignore=engine/tests/story --maxfail=200`
  - Result: `1621 passed, 68 skipped, 9 xfailed`

### Switchboard Deep-Dive (2026-03-04)
- Toggle matrix against the same non-retiring gate:
  - `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=legacy TANGL_SHIM_STORY_DEFAULT=legacy`
    - Result: `23 failed, 1616 passed, 46 skipped, 10 xfailed`
    - Fail clusters: `ir` (`6`), `loaders` (`2`), `story38` (`15`)
  - `TANGL_SHIM_CORE_DEFAULT=legacy TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=legacy`
    - Result: `35 failed, 1604 passed, 46 skipped, 10 xfailed`
    - Fail clusters: `mechanics/games` (`33`), `media` (`2`)
  - `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=legacy TANGL_SHIM_STORY_DEFAULT=v38`
    - Result: `34 failed, 1605 passed, 46 skipped, 10 xfailed`
    - Fail clusters: core-only set + mixed story/runtime mechanics/media (`11`)
  - `TANGL_SHIM_CORE_DEFAULT=v38 TANGL_SHIM_VM_DEFAULT=v38 TANGL_SHIM_STORY_DEFAULT=v38`
    - Result: `58 failed, 1581 passed, 46 skipped, 10 xfailed`

- First-cause signatures:
  - Core-v38 only:
    - Legacy type anchoring in template/fabula stack:
      - `tangl.core.factory.template` validates `obj_cls` against legacy `tangl.core.entity.Entity`.
      - `tangl.story.fabula.domain_manager` registers only subclasses of legacy `Entity`.
    - Strict selector typing in legacy `Selectable.matches(selector=...)` rejects core38 graph items.
  - VM-v38 only:
    - Constructor/shape drift:
      - `Frame(graph=..., cursor_id=...)` (legacy) vs vm38 expects `Frame(graph=..., cursor=...)`.
      - `Ledger(..., records=StreamRegistry())` (legacy) vs vm38 expects core38-shaped graph/output stream.
  - Core+Story mixed with legacy VM:
    - Mixed-runtime dispatch drift (legacy VM planning/journal phases with v38 story/core call sites) causes handler non-selection and empty/None journal/update outputs.

- Classification outcome for current failing set:
  - `MECHANICAL_ADAPT` (majority):
    - Update call sites/helpers to vm38 constructor and payload vocabulary.
    - Replace legacy hard imports (`tangl.core.entity`, `tangl.core.graph.*`) in bridging layers with shim-safe imports.
    - Relax/translate legacy selector typing to accept core38 entities or translate to `core38.Selector`.
  - `REQUIRED_BRIDGE_FIX`:
    - Domain class/module loading in runtime38 paths must accept classes deriving from shimmed/v38 entity types.
  - `RETIRE_CANDIDATE`:
    - Any remaining assertions that require exact legacy `obj_cls` export strings or legacy internal MRO shape (not observable in v38 contracts).

## Inventory Snapshot
- Total in-scope legacy modules: `128`
- By feature area:
  - `core`: 15
  - `vm`: 41
  - `story`: 56
  - `service`: 16
- By disposition:
  - `PORT_DIRECT`: 16
  - `PORT_ADAPT`: 72
  - `RETIRE_REMOVED`: 24
  - `RETIRE_MOVED`: 12
  - `RETIRE_IRRELEVANT`: 4
- By risk level:
  - `low`: 20
  - `medium`: 57
  - `high`: 51

## Disposition Legend
- `PORT_DIRECT`: same behavior intent, mostly namespace/type rename.
- `PORT_ADAPT`: behavior intent retained, assertions must be rewritten for v38 contracts.
- `RETIRE_REMOVED`: intentionally removed from v38 behavior.
- `RETIRE_MOVED`: concern moved out of this in-scope parity effort.
- `RETIRE_IRRELEVANT`: no meaningful mapping to v38 architecture.

## Target Resolution Status (PORT rows)
- `PORT_*` rows: `88`
- Missing `target_v38_test_path`: `0`
- Unique target modules: `36`
  - Existing targets: `36`
  - Planned targets: `0`

Planned target modules referenced by `PORT_*` rows:
- None.

## Current Port Coverage Snapshot (2026-03-03)
- `PORT_*` rows with existing target tests: `88 / 88` (`100.0%`)
- By feature area:
  - `core`: `13 / 13`
  - `vm`: `30 / 30`
  - `story`: `33 / 33`
  - `service`: `12 / 12`
- Remaining `PORT_*` gaps:
  - None.
- Validation run:
  - Command: `poetry run pytest -q engine/tests/core38 engine/tests/vm38 engine/tests/story38 engine/tests/service38`
  - Result: `909 passed, 11 warnings`

## Cutover Execution Status (2026-03-06)
- Three-lane validation baseline is green:
  - Lane A: `918 passed`
  - Lane B: `665 passed, 62 skipped, 9 xfailed`
  - Lane C: `36 passed, 3 skipped, 1 xfailed`
- Import gates are clean via `scripts/audit_cutover_edges.py`:
  - Pre-swap:
    - `IR bridge: 0`
    - `Bypass imports: 0`
    - `Intentional bridges: 0` (tracked in `scripts/cutover_import_allowlist.txt`)
  - Post-swap:
    - `IR bridge: 0`
    - `Post-swap disallowed legacy imports: 0`
    - `Post-swap disallowed *38 imports: 0`
- Active CI gate now runs in post-swap mode.
- Legacy source and retired legacy test trees are archived under `scratch/legacy/...`.
- Compatibility wrapper packages (`tangl.core38`, `tangl.vm38`, `tangl.story38`, `tangl.service38`) have been retired from production source trees.
- Legacy call-routing shim plumbing removed in active app/service code:
  - CLI no longer exposes `call_legacy_endpoint(...)` and no longer uses `_call_legacy(...)` controller helpers.
  - `tangl.service.api_endpoint` no longer contains dead conditional legacy bridge initialization.
- App hygiene decisions are enforced:
  - `/story/drop` returns v38-style success status (`"ok"`).
  - Deferred debug endpoints remain routed but return explicit `501 Not Implemented`.
- Service operation routing now targets canonical runtime endpoint names, with
  `*38` endpoint-name aliases retained for compatibility during cleanup.

## Legacy vs V38 Surface Audit (2026-03-03)
- Scope-completeness check:
  - In-scope legacy test modules discovered under scope lock: `128`
  - Matrix rows: `128` (unique legacy paths: `128`)
  - Missing rows: `0`; duplicate rows: `0`
- Surface comparison snapshot (package/module level, implementation-facing):
  - `core` modules: `36` → `core38` modules: `15` (name-overlap modules: `8`)
  - `vm` modules: `40` → `vm38` modules: `25` (name-overlap modules: `11`)
  - `story` modules: `38` → `story38` modules: `23` (name-overlap modules: `12`)
  - `service` modules: `25` → `service38` modules: `14` (name-overlap modules: `6`)
- Interpretation:
  - Lower direct module-name overlap is expected from v38 consolidation/refactoring (trait split, phase-driven VM runtime, service gateway/adapter model).
  - Parity remains test-intent based; non-overlap modules are represented through `PORT_ADAPT`/`RETIRE_*` dispositions rather than 1:1 module renames.
- Audit delta found during this pass:
  - Added previously missing in-scope service rows (all `PORT_DIRECT`): `test_auth38.py`, `test_operations38.py`, `test_rest_adapter38.py`.

## Classification Matrix
| legacy_test_path | feature_area | disposition | target_v38_test_path | v38_feature_anchor | rationale | risk_level | status |
|---|---|---|---|---|---|---|---|
| engine/tests/core/behavior/test_behavior.py | core | PORT_ADAPT | engine/tests/core38/behavior/test_behavior.py | tangl.core.behavior.BehaviorRegistry.chain_execute | Behavior chaining remains core functionality but aggregation and naming contracts changed in core38. | low | mapped |
| engine/tests/core/dispatch/test_hooked_reg.py | core | RETIRE_REMOVED |  | tangl.core.dispatch.dispatch | v38 removed HookedRegistry-specific behavior wrappers and consolidated lifecycle hooks into the core38 dispatch registry. | medium | mapped |
| engine/tests/core/entity/test_entity.py | core | PORT_ADAPT | engine/tests/core38/entity/test_entity.py | tangl.core.entity.Entity.structure | Entity identity and structuring behavior is retained with core38 trait composition and updated dispatch context semantics. | low | mapped |
| engine/tests/core/entity/test_structuring.py | core | PORT_ADAPT | engine/tests/core38/entity/test_entity.py | tangl.core.entity.Entity.structure | Entity identity and structuring behavior is retained with core38 trait composition and updated dispatch context semantics. | low | mapped |
| engine/tests/core/factory/test_templates.py | core | PORT_ADAPT | engine/tests/core38/template/test_template.py | tangl.core.template.TemplateRegistry | Legacy template factory concerns map to core38 template registry/materialization contracts with renamed APIs. | medium | mapped |
| engine/tests/core/factory/test_token_factory.py | core | PORT_ADAPT | engine/tests/core38/token/test_token.py | tangl.core.token.TokenCatalog | Legacy token factory coverage maps to core38 token wrapper and catalog materialization semantics. | medium | mapped |
| engine/tests/core/graph/test_edge.py | core | PORT_ADAPT | engine/tests/core38/graph/test_graph.py | tangl.core.graph.Graph | Graph topology behavior persists in v38 with consolidated graph item types and updated endpoint naming. | low | mapped |
| engine/tests/core/graph/test_graph.py | core | PORT_ADAPT | engine/tests/core38/graph/test_graph.py | tangl.core.graph.Graph | Graph topology behavior persists in v38 with consolidated graph item types and updated endpoint naming. | low | mapped |
| engine/tests/core/graph/test_node.py | core | PORT_ADAPT | engine/tests/core38/graph/test_graph.py | tangl.core.graph.Graph | Graph topology behavior persists in v38 with consolidated graph item types and updated endpoint naming. | low | mapped |
| engine/tests/core/graph/test_token_37.py | core | PORT_ADAPT | engine/tests/core38/token/test_token.py | tangl.core.token.Token | Graph token behavior is still needed but should follow the v38 token wrapper model instead of v37 token-node conventions. | medium | mapped |
| engine/tests/core/record/test_content_addressable.py | core | RETIRE_REMOVED |  | tangl.core.record.Record.get_hashable_content | v38 no longer carries a standalone ContentAddressable model and folds content hashing semantics into core38 record/entity traits. | low | mapped |
| engine/tests/core/record/test_record_stream.py | core | PORT_ADAPT | engine/tests/core38/record/test_record.py | tangl.core.record.OrderedRegistry | Record stream behaviors continue via core38 ordered registry with different naming and slice/query helpers. | low | mapped |
| engine/tests/core/registry/test_registry.py | core | PORT_DIRECT | engine/tests/core38/registry/test_registry.py | tangl.core.registry.Registry | Registry CRUD and selection semantics remain first-class in core38 with directly comparable contracts. | low | mapped |
| engine/tests/core/registry/test_selection.py | core | PORT_ADAPT | engine/tests/core38/selector/test_selector.py | tangl.core.selector.Selector.matches | Selection remains in scope but moved to explicit Selector-driven matching rather than legacy inline matcher assumptions. | low | mapped |
| engine/tests/core/singleton/test_singleton.py | core | PORT_DIRECT | engine/tests/core38/singleton/test_singleton.py | tangl.core.singleton.Singleton | Singleton uniqueness and inheritance semantics still exist in core38 and should remain gated directly. | low | mapped |
| engine/tests/service/controllers/test_runtime_controller.py | service | PORT_ADAPT | engine/tests/service38/controllers/test_runtime_controller.py | tangl.service.controllers.runtime_controller.RuntimeController.create_story38 | Runtime controller lifecycle checks remain needed but should target the v38 runtime endpoint set only. | high | mapped |
| engine/tests/service/controllers/test_runtime_controller38.py | service | PORT_DIRECT | engine/tests/service/controllers/test_runtime_controller38.py | tangl.service.controllers.runtime_controller.RuntimeController.resolve_choice38 | This suite already validates v38 runtime-controller flows and should be retained as direct parity coverage. | low | mapped |
| engine/tests/service/controllers/test_runtime_controller_media.py | service | RETIRE_MOVED |  | tangl.story.fragments.MediaFragment | Runtime media controller behavior is outside the in-scope service38/story38 parity gate and remains demoted for a later media-focused track. | medium | mapped |
| engine/tests/service/controllers/test_user_controller.py | service | PORT_ADAPT | engine/tests/service38/controllers/test_user_controller.py | tangl.service.controllers.user_controller.UserController | User endpoint behavior stays in scope but should be asserted through the service38 gateway/orchestrator flow. | medium | mapped |
| engine/tests/service/response/test_exports.py | service | PORT_ADAPT | engine/tests/service38/response/test_exports.py | tangl.service.__all__ | Export contract checks should move to service38 package exports and operation/gateway surface. | medium | mapped |
| engine/tests/service/response/test_info_models.py | service | RETIRE_REMOVED |  | tangl.service.gateway.ServiceGateway.execute | Legacy native response/info model contracts are superseded by service38 gateway operation and runtime-envelope contracts. | high | mapped |
| engine/tests/service/response/test_native_response.py | service | RETIRE_REMOVED |  | tangl.service.gateway.ServiceGateway.execute | Legacy native response/info model contracts are superseded by service38 gateway operation and runtime-envelope contracts. | high | mapped |
| engine/tests/service/response/test_runtime38_response.py | service | PORT_DIRECT | engine/tests/service/response/test_runtime38_response.py | tangl.service.response.RuntimeEnvelope | RuntimeEnvelope is already v38-specific and should remain as direct transport contract coverage. | low | mapped |
| engine/tests/service/test_api_endpoints.py | service | PORT_ADAPT | engine/tests/service38/test_api_endpoint.py | tangl.service.api_endpoint.ApiEndpoint.annotate | Endpoint annotation metadata remains required but should validate service38 policy-aware endpoint wrappers. | medium | mapped |
| engine/tests/service/test_auth38.py | service | PORT_DIRECT | engine/tests/service/test_auth38.py | tangl.service.auth.user_id_by_key | API-key auth resolution and access-level mapping are already v38-specific and should remain direct parity coverage. | medium | mapped |
| engine/tests/service/test_operations38.py | service | PORT_DIRECT | engine/tests/service/test_operations38.py | tangl.service.operations.endpoint_for_operation | Operation-to-endpoint routing and bootstrap registration are already encoded as service38 contracts and should stay directly gated. | low | mapped |
| engine/tests/service/test_orchestrator.py | service | PORT_ADAPT | engine/tests/service38/test_orchestrator.py | tangl.service.orchestrator.Orchestrator.execute | Orchestrator behavior remains core but should be validated against service38 hydration, policy, and writeback semantics. | high | mapped |
| engine/tests/service/test_orchestrator38.py | service | PORT_DIRECT | engine/tests/service/test_orchestrator38.py | tangl.service.orchestrator.Orchestrator | This suite already targets service38 orchestrator behavior and should stay as direct parity evidence. | low | mapped |
| engine/tests/service/test_orchestrator_basic.py | service | PORT_ADAPT | engine/tests/service38/test_orchestrator.py | tangl.service.orchestrator.Orchestrator.execute | Orchestrator behavior remains core but should be validated against service38 hydration, policy, and writeback semantics. | high | mapped |
| engine/tests/service/test_response_contract.py | service | RETIRE_REMOVED |  | tangl.service.gateway.ServiceGateway.execute | Legacy native response/info model contracts are superseded by service38 gateway operation and runtime-envelope contracts. | high | mapped |
| engine/tests/service/test_rest_adapter38.py | service | PORT_DIRECT | engine/tests/service/test_rest_adapter38.py | tangl.service.rest_adapter.GatewayRestAdapter.execute_operation | Transport adapter request/auth forwarding is already service38-native behavior and should remain direct parity coverage. | medium | mapped |
| engine/tests/story/asset/test_asset_bag.py | story | RETIRE_MOVED |  | tangl.story.fabula.StoryMaterializer | Legacy story-level asset workflows are demoted from in-scope v38 parity and moved outside the core refactor gate. | medium | mapped |
| engine/tests/story/asset/test_asset_manager2.py | story | RETIRE_MOVED |  | tangl.story.fabula.StoryMaterializer | Legacy story-level asset workflows are demoted from in-scope v38 parity and moved outside the core refactor gate. | medium | mapped |
| engine/tests/story/asset/test_asset_wallet.py | story | RETIRE_MOVED |  | tangl.story.fabula.StoryMaterializer | Legacy story-level asset workflows are demoted from in-scope v38 parity and moved outside the core refactor gate. | medium | mapped |
| engine/tests/story/asset/test_countable_asset.py | story | RETIRE_MOVED |  | tangl.story.fabula.StoryMaterializer | Legacy story-level asset workflows are demoted from in-scope v38 parity and moved outside the core refactor gate. | medium | mapped |
| engine/tests/story/asset/test_discrete_asset.py | story | RETIRE_MOVED |  | tangl.story.fabula.StoryMaterializer | Legacy story-level asset workflows are demoted from in-scope v38 parity and moved outside the core refactor gate. | medium | mapped |
| engine/tests/story/concepts/test_actor.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.concepts.Actor | Concept entity coverage remains necessary but should validate story38 concept contracts and wiring semantics. | medium | mapped |
| engine/tests/story/concepts/test_concept.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.concepts.Actor | Concept entity coverage remains necessary but should validate story38 concept contracts and wiring semantics. | medium | mapped |
| engine/tests/story/concepts/test_location.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.concepts.Actor | Concept entity coverage remains necessary but should validate story38 concept contracts and wiring semantics. | medium | mapped |
| engine/tests/story/discourse/test_dialog_handler.py | story | RETIRE_MOVED |  | tangl.story.system_handlers.render_block | Dialog microblock discourse parsing is currently out of scope and not part of the story38 core parity target. | medium | mapped |
| engine/tests/story/episode/test_action.py | story | PORT_ADAPT | engine/tests/story38/test_system_handlers.py | tangl.story.episode.Action | Action choice rendering remains in scope with story38 choice fragment fields and vm38 trigger-phase semantics. | medium | mapped |
| engine/tests/story/episode/test_block.py | story | PORT_ADAPT | engine/tests/story38/test_system_handlers.py | tangl.story.system_handlers.render_block | Block journaling behavior remains needed but is implemented via story38 journal handlers and fragment records. | high | mapped |
| engine/tests/story/episode/test_block_dialog.py | story | RETIRE_MOVED |  | tangl.story.system_handlers.render_block | Dialog-specific block rendering is out of scope for the current v38 story/runtime parity effort. | medium | mapped |
| engine/tests/story/episode/test_block_journal_concepts.py | story | PORT_ADAPT | engine/tests/story38/test_system_handlers.py | tangl.story.system_handlers.render_block | Block journaling behavior remains needed but is implemented via story38 journal handlers and fragment records. | high | mapped |
| engine/tests/story/episode/test_block_journal_order.py | story | PORT_ADAPT | engine/tests/story38/test_journal_order.py | tangl.story.system_handlers.render_block | Fragment ordering guarantees should be retained with story38 handlers but require updated order assertions. | high | mapped |
| engine/tests/story/episode/test_block_journal_pipeline.py | story | PORT_ADAPT | engine/tests/story38/test_system_handlers.py | tangl.story.system_handlers.render_block | Block journaling behavior remains needed but is implemented via story38 journal handlers and fragment records. | high | mapped |
| engine/tests/story/episode/test_block_media_dependencies.py | story | RETIRE_MOVED |  | tangl.story.fragments.MediaFragment | Media dependency/journal wiring is demoted from this in-scope story38 parity phase. | medium | mapped |
| engine/tests/story/episode/test_block_media_journal.py | story | RETIRE_MOVED |  | tangl.story.fragments.MediaFragment | Media dependency/journal wiring is demoted from this in-scope story38 parity phase. | medium | mapped |
| engine/tests/story/episode/test_block_post_process.py | story | RETIRE_REMOVED |  | tangl.story.system_handlers.render_block | Legacy post-process content pipeline layers were removed in favor of direct story38 render handler output. | medium | mapped |
| engine/tests/story/episode/test_deps_in_ns.py | story | PORT_ADAPT | engine/tests/story38/test_system_handlers.py | tangl.vm.system_handlers.contribute_satisfied_deps | Dependency projection into namespace remains relevant and should be verified through vm38/story38 handler integration. | high | mapped |
| engine/tests/story/episode/test_menu_block.py | story | RETIRE_REMOVED |  | tangl.story.episode.Block | MenuBlock dynamic provisioning semantics were intentionally dropped from story38 node vocabulary. | high | mapped |
| engine/tests/story/episode/test_scene.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.episode.Scene.finalize_container_contract | Scene container/source-sink behavior remains required and should align to story38 scene finalization contracts. | medium | mapped |
| engine/tests/story/fabula/test_asset_manager.py | story | RETIRE_MOVED |  | tangl.story.fabula.StoryCompiler | Fabula asset manager behavior is out of the in-scope story38 parity set and will be handled separately if revived. | medium | mapped |
| engine/tests/story/fabula/test_custom_world_handlers.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.story_graph.StoryGraph.get_authorities | Custom world authority registration remains relevant via story38 graph authority composition. | medium | mapped |
| engine/tests/story/fabula/test_managers.py | story | RETIRE_REMOVED |  | tangl.story.fabula.StoryCompiler.compile | Script/domain manager orchestration was replaced by story38 compiler+materializer bundle flow. | high | mapped |
| engine/tests/story/fabula/test_materialize_dispatch.py | story | RETIRE_REMOVED |  | tangl.story.fabula.StoryMaterializer.create_story | Legacy materialize dispatch task buses were removed and replaced by explicit story38 materialization passes. | high | mapped |
| engine/tests/story/fabula/test_phase2_revision.py | story | RETIRE_IRRELEVANT |  | tangl.story.fabula.InitMode | Legacy phased revision milestones no longer map to the story38 initialization model. | medium | mapped |
| engine/tests/story/fabula/test_role_resolution_integration.py | story | PORT_DIRECT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryMaterializer._wire_dependencies_for_specs | Role/setting dependency wiring is a direct story38 materializer responsibility and should stay gated. | medium | mapped |
| engine/tests/story/fabula/test_role_setting_wiring.py | story | PORT_DIRECT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryMaterializer._wire_dependencies_for_specs | Role/setting dependency wiring is a direct story38 materializer responsibility and should stay gated. | medium | mapped |
| engine/tests/story/fabula/test_role_wiring_modes.py | story | PORT_DIRECT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryMaterializer._wire_dependencies_for_specs | Role/setting dependency wiring is a direct story38 materializer responsibility and should stay gated. | medium | mapped |
| engine/tests/story/fabula/test_script_manager.py | story | RETIRE_REMOVED |  | tangl.story.fabula.StoryCompiler.compile | ScriptManager APIs were retired in story38 and replaced by compiler normalization over StoryScript payloads. | high | mapped |
| engine/tests/story/fabula/test_script_manager_anchored_lookup.py | story | RETIRE_REMOVED |  | tangl.story.fabula.StoryCompiler.compile | ScriptManager APIs were retired in story38 and replaced by compiler normalization over StoryScript payloads. | high | mapped |
| engine/tests/story/fabula/test_script_manager_helpers.py | story | RETIRE_REMOVED |  | tangl.story.fabula.StoryCompiler.compile | ScriptManager APIs were retired in story38 and replaced by compiler normalization over StoryScript payloads. | high | mapped |
| engine/tests/story/fabula/test_script_manager_scope_rank.py | story | RETIRE_REMOVED |  | tangl.story.fabula.StoryCompiler.compile | ScriptManager APIs were retired in story38 and replaced by compiler normalization over StoryScript payloads. | high | mapped |
| engine/tests/story/fabula/test_story_graph.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.story_graph.StoryGraph | Story graph contracts remain relevant with updated authority/template scope helpers in story38. | medium | mapped |
| engine/tests/story/fabula/test_story_script_model_rebuild.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryCompiler.compile | Script model rebuild intent remains useful but should assert story38 compiler model validation and bundle output. | medium | mapped |
| engine/tests/story/fabula/test_template_factory_integration.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryTemplateBundle.template_registry | Template registry integration remains needed with story38 template bundles and materializer lineage mapping. | medium | mapped |
| engine/tests/story/fabula/test_template_registry.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryTemplateBundle.template_registry | Template registry integration remains needed with story38 template bundles and materializer lineage mapping. | medium | mapped |
| engine/tests/story/fabula/test_world_ensure_scope.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryMaterializer.create_story | World initialization/materialization boundaries remain essential and should be asserted against story38 world entrypoints. | high | mapped |
| engine/tests/story/fabula/test_world_materialization.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryMaterializer.create_story | World initialization/materialization boundaries remain essential and should be asserted against story38 world entrypoints. | high | mapped |
| engine/tests/story/fabula/test_world_vm_boundary.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryMaterializer.create_story | World initialization/materialization boundaries remain essential and should be asserted against story38 world entrypoints. | high | mapped |
| engine/tests/story/test_branching_playthrough.py | story | PORT_ADAPT | engine/tests/story38/test_traversal_playthrough.py | tangl.vm.runtime.ledger.Ledger.resolve_choice | Playthrough behavior is still required but must run through story38 world + vm38 ledger traversal. | high | mapped |
| engine/tests/story/test_complex_conditions.py | story | PORT_ADAPT | engine/tests/story38/test_choice_availability.py | tangl.story.system_handlers._choice_unavailable_reason | Condition and gating assertions remain important but should target story38 choice availability and blocker diagnostics. | high | mapped |
| engine/tests/story/test_concept_gating.py | story | PORT_ADAPT | engine/tests/story38/test_choice_availability.py | tangl.story.system_handlers._choice_unavailable_reason | Condition and gating assertions remain important but should target story38 choice availability and blocker diagnostics. | high | mapped |
| engine/tests/story/test_demo_script.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.World.from_script_data | Script-to-world compilation remains relevant and should validate story38 bundle/compiler/materializer flow. | medium | mapped |
| engine/tests/story/test_full_world_factory.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.World.from_script_data | Script-to-world compilation remains relevant and should validate story38 bundle/compiler/materializer flow. | medium | mapped |
| engine/tests/story/test_lazy_provisioning_integration.py | story | RETIRE_REMOVED |  | tangl.story.fabula.InitMode | Legacy lazy world/provisioning mode is intentionally absent from story38 initialization modes. | high | mapped |
| engine/tests/story/test_lazy_world.py | story | RETIRE_REMOVED |  | tangl.story.fabula.InitMode | Legacy lazy world/provisioning mode is intentionally absent from story38 initialization modes. | high | mapped |
| engine/tests/story/test_phase4_integration.py | story | RETIRE_IRRELEVANT |  | tangl.story.fabula.StoryInitResult | Legacy phase-tier milestone tests do not align with the simplified story38 initialization/reporting model. | medium | mapped |
| engine/tests/story/test_role_provisioning.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryMaterializer._prelink_all_dependencies | Role provisioning behavior remains in scope but should assert story38 dependency prelinking outcomes. | medium | mapped |
| engine/tests/story/test_role_provisioning2.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.StoryMaterializer._prelink_all_dependencies | Role provisioning behavior remains in scope but should assert story38 dependency prelinking outcomes. | medium | mapped |
| engine/tests/story/test_script_to_graph_integration.py | story | PORT_ADAPT | engine/tests/story38/test_story_init.py | tangl.story.fabula.World.from_script_data | Script-to-world compilation remains relevant and should validate story38 bundle/compiler/materializer flow. | medium | mapped |
| engine/tests/story/test_simple_story.py | story | PORT_ADAPT | engine/tests/story38/test_traversal_playthrough.py | tangl.vm.runtime.ledger.Ledger.resolve_choice | Playthrough behavior is still required but must run through story38 world + vm38 ledger traversal. | high | mapped |
| engine/tests/story/test_story_state_conditions.py | story | PORT_ADAPT | engine/tests/story38/test_choice_availability.py | tangl.story.system_handlers._choice_unavailable_reason | Condition and gating assertions remain important but should target story38 choice availability and blocker diagnostics. | high | mapped |
| engine/tests/story/test_template_provisioner_scope.py | story | PORT_ADAPT | engine/tests/story38/test_compiler_scope_resolution.py | tangl.story.story_graph.StoryGraph.get_template_scope_groups | Template scope ranking remains relevant but now depends on story38 template lineage and scope group APIs. | high | mapped |
| engine/tests/story/test_tier2_integration.py | story | RETIRE_IRRELEVANT |  | tangl.story.fabula.StoryInitResult | Legacy phase-tier milestone tests do not align with the simplified story38 initialization/reporting model. | medium | mapped |
| engine/tests/story/test_world_template_registry.py | story | PORT_ADAPT | engine/tests/story38/test_compiler_scope_resolution.py | tangl.story.story_graph.StoryGraph.get_template_scope_groups | Template scope ranking remains relevant but now depends on story38 template lineage and scope group APIs. | high | mapped |
| engine/tests/vm/context/test_materialization_context.py | vm | RETIRE_REMOVED |  | tangl.story.fabula.StoryMaterializer.create_story | Legacy MaterializationContext was removed and story initialization now uses story38 compiler/materializer orchestration. | high | mapped |
| engine/tests/vm/dispatch/test_materialize_task.py | vm | RETIRE_REMOVED |  | tangl.story.fabula.StoryMaterializer._materialize_one | MaterializeTask phase bus hooks were removed in favor of direct story38 materializer passes. | high | mapped |
| engine/tests/vm/dispatch/test_namespace_concepts.py | vm | PORT_ADAPT | engine/tests/vm38/test_system_handlers.py | tangl.vm.system_handlers.contribute_satisfied_deps | Namespace concept projection still matters but is now provided by vm38 gather_ns handlers and phase context. | medium | mapped |
| engine/tests/vm/events/test_event_canonicalize.py | vm | RETIRE_REMOVED |  | tangl.vm.replay.DiffReplayEngine.build_delta | Event canonicalization from the legacy watcher stack is intentionally removed from the vm38 diff-replay MVP architecture. | medium | mapped |
| engine/tests/vm/events/test_events.py | vm | PORT_ADAPT | engine/tests/vm38/test_replay_mvp.py | tangl.vm.replay.Event.apply | Replay event CRUD remains in scope but should target vm38 patch/event contracts instead of watcher-backed streams. | medium | mapped |
| engine/tests/vm/events/test_snapshot.py | vm | PORT_ADAPT | engine/tests/vm38/test_ledger.py | tangl.vm.runtime.ledger.Ledger.save_snapshot | Snapshot/restore behavior persists in vm38 through ledger checkpoints rather than legacy snapshot stream conventions. | medium | mapped |
| engine/tests/vm/events/test_watched.py | vm | RETIRE_REMOVED |  | tangl.vm.replay.DiffReplayEngine | Watched proxy/observer event sourcing was explicitly deprecated by vm38 in favor of simpler incremental graph diff deltas. | high | mapped |
| engine/tests/vm/planning/test_offer_pipeline.py | vm | PORT_ADAPT | engine/tests/vm38/test_provision_pipeline.py | tangl.vm.dispatch.do_provision | Planning pipeline behavior remains required but vm38 uses side-effect provisioning hooks with updated offer/resolver contracts. | high | mapped |
| engine/tests/vm/planning/test_planning_flow.py | vm | PORT_ADAPT | engine/tests/vm38/test_provision_pipeline.py | tangl.vm.dispatch.do_provision | Planning pipeline behavior remains required but vm38 uses side-effect provisioning hooks with updated offer/resolver contracts. | high | mapped |
| engine/tests/vm/planning/test_planning_integration.py | vm | PORT_ADAPT | engine/tests/vm38/test_provision_pipeline.py | tangl.vm.dispatch.do_provision | Planning pipeline behavior remains required but vm38 uses side-effect provisioning hooks with updated offer/resolver contracts. | high | mapped |
| engine/tests/vm/planning/test_planning_receipt.py | vm | RETIRE_REMOVED |  | tangl.vm.resolution_phase.ResolutionPhase.PLANNING | Planning receipt aggregation was removed because vm38 planning handlers are side-effect-only and return no aggregated receipt. | medium | mapped |
| engine/tests/vm/planning/test_planning_refactored.py | vm | PORT_ADAPT | engine/tests/vm38/test_provision_pipeline.py | tangl.vm.dispatch.do_provision | Planning pipeline behavior remains required but vm38 uses side-effect provisioning hooks with updated offer/resolver contracts. | high | mapped |
| engine/tests/vm/planning/test_reqs_in_ns.py | vm | PORT_ADAPT | engine/tests/vm38/test_system_handlers.py | tangl.vm.system_handlers.contribute_satisfied_deps | Requirement-to-namespace visibility is still needed and should be asserted through vm38 namespace contributor handlers. | medium | mapped |
| engine/tests/vm/provision/test_asset_provisioner.py | vm | RETIRE_MOVED |  | tangl.story.system_handlers.render_block | Asset/media-specific provisioners are out of current scope and demoted from the v38 parity gate. | medium | mapped |
| engine/tests/vm/provision/test_build_receipt_provenance.py | vm | RETIRE_REMOVED |  | tangl.vm.provision.Resolver.resolve_dependency | Build/provenance receipts were removed from vm38 provisioning in favor of direct resolver decisions and replay deltas. | high | mapped |
| engine/tests/vm/provision/test_provision_int1.py | vm | PORT_ADAPT | engine/tests/vm38/test_provision_pipeline.py | tangl.vm.provision.Resolver.resolve_dependency | Provision integration coverage remains critical but must target vm38 resolver/policy behavior and new provisioning entry points. | high | mapped |
| engine/tests/vm/provision/test_provision_int2.py | vm | PORT_ADAPT | engine/tests/vm38/test_provision_pipeline.py | tangl.vm.provision.Resolver.resolve_dependency | Provision integration coverage remains critical but must target vm38 resolver/policy behavior and new provisioning entry points. | high | mapped |
| engine/tests/vm/provision/test_provision_pure.py | vm | PORT_ADAPT | engine/tests/vm38/test_provision_pipeline.py | tangl.vm.provision.Resolver.resolve_dependency | Provision integration coverage remains critical but must target vm38 resolver/policy behavior and new provisioning entry points. | high | mapped |
| engine/tests/vm/provision/test_provisioner1.py | vm | PORT_ADAPT | engine/tests/vm38/test_provision_pipeline.py | tangl.vm.provision.Resolver.resolve_dependency | Provision integration coverage remains critical but must target vm38 resolver/policy behavior and new provisioning entry points. | high | mapped |
| engine/tests/vm/provision/test_provisioner2.py | vm | PORT_ADAPT | engine/tests/vm38/test_provision_pipeline.py | tangl.vm.provision.Resolver.resolve_dependency | Provision integration coverage remains critical but must target vm38 resolver/policy behavior and new provisioning entry points. | high | mapped |
| engine/tests/vm/provision/test_requirement_token_ref.py | vm | PORT_ADAPT | engine/tests/vm38/test_requirement.py | tangl.vm.provision.Requirement | Requirement identifier semantics remain relevant but are expressed through vm38 requirement fields and resolver matching rules. | medium | mapped |
| engine/tests/vm/provision/test_template_provisioner.py | vm | PORT_ADAPT | engine/tests/vm38/test_resolver.py | tangl.vm.provision.TemplateProvisioner | Template-based provisioning still exists but is now exercised through vm38 resolver/template scope APIs. | high | mapped |
| engine/tests/vm/provision/test_template_provisioner_delegation.py | vm | PORT_ADAPT | engine/tests/vm38/test_resolver.py | tangl.vm.provision.TemplateProvisioner | Template-based provisioning still exists but is now exercised through vm38 resolver/template scope APIs. | high | mapped |
| engine/tests/vm/provision/test_template_provisioner_scope.py | vm | PORT_ADAPT | engine/tests/vm38/test_resolver.py | tangl.vm.provision.TemplateProvisioner | Template-based provisioning still exists but is now exercised through vm38 resolver/template scope APIs. | high | mapped |
| engine/tests/vm/provision/test_token_provisioner.py | vm | RETIRE_REMOVED |  | tangl.vm.provision.InlineTemplateProvisioner | Dedicated token provisioner paths were removed and replaced by generic resolver/template provisioners in vm38. | medium | mapped |
| engine/tests/vm/test_call_return_integration.py | vm | PORT_ADAPT | engine/tests/vm38/test_call_stack.py | tangl.vm.runtime.ledger.Ledger.push_call | Call/return stack behavior remains required but should be ported to vm38 frame+ledger stack semantics. | high | mapped |
| engine/tests/vm/test_call_stack.py | vm | PORT_ADAPT | engine/tests/vm38/test_call_stack.py | tangl.vm.runtime.ledger.Ledger.push_call | Call/return stack behavior remains required but should be ported to vm38 frame+ledger stack semantics. | high | mapped |
| engine/tests/vm/test_call_stack_persistence.py | vm | PORT_ADAPT | engine/tests/vm38/test_call_stack.py | tangl.vm.runtime.ledger.Ledger.push_call | Call/return stack behavior remains required but should be ported to vm38 frame+ledger stack semantics. | high | mapped |
| engine/tests/vm/test_context.py | vm | PORT_ADAPT | engine/tests/vm38/test_frame.py | tangl.vm.runtime.frame.PhaseCtx.get_ns | Legacy VM context responsibilities were refactored into vm38 PhaseCtx and should be asserted against the new accessors. | medium | mapped |
| engine/tests/vm/test_context_journal_state.py | vm | PORT_ADAPT | engine/tests/vm38/test_system_handlers.py | tangl.vm.runtime.frame.Frame.follow_edge | Journal-time state expectations remain valid but should be tested through vm38 phase sequencing and system handlers. | medium | mapped |
| engine/tests/vm/test_cost_model.py | vm | RETIRE_IRRELEVANT |  | tangl.vm.provision.ProvisionPolicy | Legacy cost model heuristics are not part of vm38 MVP provisioning policy semantics. | medium | mapped |
| engine/tests/vm/test_cursor_history.py | vm | PORT_DIRECT | engine/tests/vm38/test_traversal.py | tangl.vm.traversal.get_visit_count | Cursor history and visit counting are directly represented in vm38 traversal query helpers. | low | mapped |
| engine/tests/vm/test_cursor_history_integration.py | vm | PORT_DIRECT | engine/tests/vm38/test_traversal.py | tangl.vm.traversal.get_visit_count | Cursor history and visit counting are directly represented in vm38 traversal query helpers. | low | mapped |
| engine/tests/vm/test_frame.py | vm | PORT_DIRECT | engine/tests/vm38/test_frame.py | tangl.vm.runtime.frame.Frame.resolve_choice | Frame-driven phase execution remains core runtime behavior and has a direct vm38 counterpart. | low | mapped |
| engine/tests/vm/test_integration.py | vm | PORT_ADAPT | engine/tests/vm38/test_phase_integration.py | tangl.vm.runtime.frame.Frame.follow_edge | End-to-end VM integration is still required but should align to vm38 phase names, redirect traces, and replay records. | high | mapped |
| engine/tests/vm/test_ledger.py | vm | PORT_DIRECT | engine/tests/vm38/test_ledger.py | tangl.vm.runtime.ledger.Ledger.resolve_choice | Ledger lifecycle behavior is still central and has a direct vm38 runtime ledger implementation. | low | mapped |
| engine/tests/vm/test_ledger_structures.py | vm | PORT_ADAPT | engine/tests/vm38/test_ledger.py | tangl.vm.runtime.ledger.Ledger.structure | Ledger structuring contracts remain relevant but now serialize vm38 graph/output_stream/replay fields. | medium | mapped |
| engine/tests/vm/test_ns.py | vm | PORT_ADAPT | engine/tests/vm38/test_system_handlers.py | tangl.vm.dispatch.do_gather_ns | Namespace assembly remains required but now flows through vm38 gather_ns dispatch and PhaseCtx caching. | medium | mapped |
| engine/tests/vm/test_stack_event_sourcing.py | vm | RETIRE_REMOVED |  | tangl.vm.replay.DiffReplayEngine | Legacy stack event-sourcing infrastructure is deprecated by vm38 in favor of simpler diff patches and step records. | high | mapped |
| engine/tests/vm/test_traversal_utilities.py | vm | PORT_DIRECT | engine/tests/vm38/test_traversal.py | tangl.vm.traversal.steps_since_last_visit | Traversal utility behavior is directly represented by vm38 traversal query functions. | low | mapped |
| engine/tests/vm/test_update_markers.py | vm | RETIRE_REMOVED |  | tangl.vm.runtime.ledger.Ledger.get_journal | Marker-channel update slicing was replaced by step-based fragment retrieval in vm38 output streams. | medium | mapped |