healer-man/scripts/runewaker-pipeline/RUNEWAKER_ENCOUNTER_IMPLEMENTATION_REPORT.md

# RuneWaker encounter implementation and fidelity ledger

Structural validation: **green**
Content completion: **review-required**

This report is deterministic and offline. Its JSON companion inventories every deferred
source spawn row and every direct mechanics evidence record. A regex category membership
is a review label, not a unique mechanic; one evidence record may belong to several categories.

## Coverage

- 30 dungeon packages.
- 4113 deferred source rows with stable spawn IDs.
- 1524 unique mechanics evidence records: 329 Lua lines and 1195 template references.
- 1146 overlapping category memberships; this number is intentionally not reported as mechanics.
- 388 evidence records have an exact executable source-spell mapping.
- 1136 evidence records remain source-review gaps.

## Status definitions

- `verified`: an exact source identifier is present in executable runtime data and checked by the audit.
- `implemented`: executable behavior exists, but source fidelity is incomplete or explicitly authored.
- `deferred-source-gap`: source context does not prove the full behavior; the generator never guesses it.
- `deferred-asset-gap`: behavior is understood but a required asset is unavailable.
- `deferred-runtime-gap`: behavior is understood but the runtime primitive is unavailable.
- `excluded-non-gameplay`: a reviewed source item is confirmed to have no gameplay behavior.
- `intentional-empty`: the authoritative packaged snapshot contains no population rows.

## Per-dungeon inventory

| Dungeon | Source rows | Deferred rows | Evidence | Verified | Source gaps | Bosses | Package status |
| --- | ---: | ---: | ---: | ---: | ---: | ---: | --- |
| aeternal-circle | 514 | 391 | 47 | 13 | 34 | 0 | deferred-source-gap |
| barren-caves | 63 | 15 | 14 | 7 | 7 | 1 | verified |
| cave-water-dragon | 144 | 47 | 15 | 2 | 13 | 2 | verified |
| demon-stronghold | 439 | 256 | 38 | 12 | 26 | 1 | verified |
| demon-stronghold-125 | 0 | 0 | 0 | 0 | 0 | 0 | intentional-empty |
| dungeon-of-dalanis | 229 | 162 | 26 | 5 | 21 | 0 | deferred-source-gap |
| forsaken-abbey | 251 | 101 | 77 | 0 | 77 | 8 | verified |
| grafu-castle | 249 | 193 | 50 | 10 | 40 | 0 | deferred-source-gap |
| hall-of-survivors | 363 | 201 | 84 | 34 | 50 | 9 | verified |
| hoto | 401 | 94 | 95 | 28 | 67 | 5 | verified |
| ice-dwarf-kingdom | 651 | 52 | 87 | 36 | 51 | 5 | verified |
| kal-turok-hive | 4 | 3 | 10 | 4 | 6 | 0 | deferred-source-gap |
| kalins-shrine | 289 | 124 | 294 | 17 | 277 | 5 | verified |
| kawaks-tomb | 293 | 176 | 46 | 7 | 39 | 1 | verified |
| kulech-bones-nest | 287 | 133 | 59 | 18 | 41 | 1 | verified |
| lair-demon-dragon | 532 | 429 | 28 | 9 | 19 | 0 | deferred-source-gap |
| mystic-altar | 398 | 147 | 68 | 26 | 42 | 3 | verified |
| paspers-shrine | 255 | 31 | 22 | 6 | 16 | 5 | verified |
| raksha-temple | 487 | 364 | 85 | 21 | 64 | 1 | verified |
| sand-vortex | 2 | 1 | 2 | 0 | 2 | 1 | verified |
| sardo-castle | 247 | 176 | 53 | 12 | 41 | 3 | verified |
| the-origin | 510 | 322 | 65 | 29 | 36 | 2 | verified |
| tomb-seven-heroes | 439 | 199 | 101 | 32 | 69 | 0 | deferred-source-gap |
| treasure-trove | 685 | 188 | 81 | 34 | 47 | 3 | verified |
| warnorken-arena | 40 | 39 | 2 | 0 | 2 | 0 | deferred-source-gap |
| ystra-labyrinth-boss1 | 17 | 14 | 12 | 2 | 10 | 3 | verified |
| ystra-labyrinth-boss2 | 3 | 2 | 3 | 1 | 2 | 1 | verified |
| ystra-labyrinth-boss3 | 7 | 6 | 2 | 0 | 2 | 1 | verified |
| zurhidon-stronghold | 400 | 247 | 58 | 23 | 35 | 0 | deferred-source-gap |
| zurhidon-stronghold-124 | 0 | 0 | 0 | 0 | 0 | 0 | intentional-empty |

## Four explicit fallback bosses

| Boss | Runtime ID | Status | Fidelity | Blocker |
| --- | --- | --- | --- | --- |
| Necromage | `rw-fa-100070` | implemented | healer-man-authored | Preserved source evidence does not expose an executable original combat kit. |
| Flowing Chaos | `rw-fa-100561` | implemented | healer-man-authored | Preserved source evidence does not expose an executable original combat kit. |
| Cruel Eater | `rw-fa-100562` | implemented | healer-man-authored | Preserved source evidence does not expose an executable original combat kit. |
| Hollow Shell | `rw-fa-100563` | implemented | healer-man-authored | Preserved source evidence does not expose an executable original combat kit. |

These attacks are intentionally playable and telegraphed HealerMan behavior. They are not
presented as original RuneWaker mechanics until authoritative source behavior is recovered.

## Non-empty packages without confirmed boss objectives

- `aeternal-circle`: 514 rows; The portable source package contains population rows but no source-confirmed boss membership. Next: Recover and review authoritative boss membership and objective order; do not promote ordinary templates heuristically.
- `dungeon-of-dalanis`: 229 rows; The portable source package contains population rows but no source-confirmed boss membership. Next: Recover and review authoritative boss membership and objective order; do not promote ordinary templates heuristically.
- `grafu-castle`: 249 rows; The portable source package contains population rows but no source-confirmed boss membership. Next: Recover and review authoritative boss membership and objective order; do not promote ordinary templates heuristically.
- `kal-turok-hive`: 4 rows; The portable source package contains population rows but no source-confirmed boss membership. Next: Recover and review authoritative boss membership and objective order; do not promote ordinary templates heuristically.
- `lair-demon-dragon`: 532 rows; The portable source package contains population rows but no source-confirmed boss membership. Next: Recover and review authoritative boss membership and objective order; do not promote ordinary templates heuristically.
- `tomb-seven-heroes`: 439 rows; The portable source package contains population rows but no source-confirmed boss membership. Next: Recover and review authoritative boss membership and objective order; do not promote ordinary templates heuristically.
- `warnorken-arena`: 40 rows; The portable source package contains population rows but no source-confirmed boss membership. Next: Recover and review authoritative boss membership and objective order; do not promote ordinary templates heuristically.
- `zurhidon-stronghold`: 400 rows; The portable source package contains population rows but no source-confirmed boss membership. Next: Recover and review authoritative boss membership and objective order; do not promote ordinary templates heuristically.

## Intentional empty variants

- `demon-stronghold-125` (Zone 125): The authoritative packaged snapshot contains no active population rows.
- `zurhidon-stronghold-124` (Zone 124): The authoritative packaged snapshot contains no active population rows.

## Evidence category memberships

| Category | Evidence records carrying the label |
| --- | ---: |
| death | 100 |
| door | 23 |
| interaction | 166 |
| loot | 77 |
| movement | 6 |
| phase | 58 |
| spell | 679 |
| summon | 11 |
| timer | 26 |

## Remaining work ledger

| Blocker group | Items | Clearing work |
| --- | ---: | --- |
| deferredSourceRows | 4113 | Review source semantics and add explicit source-spawn encounter mappings. |
| unresolvedMechanicsEvidence | 1136 | Review surrounding Lua/template context; specify full trigger, effect, and reset behavior. |
| adaptedSpellFormula | 388 | Recover native formula inputs before claiming coefficient-level fidelity. |
| sourceGapFallbackBosses | 4 | Recover authoritative combat kits and replace only with source-backed modular mechanics. |
| nonEmptyZeroBossPackages | 8 | Recover authoritative boss membership and objective order. |

The exhaustive per-item blocker, next-work instruction, clearing test, source IDs, source
files, and SHA-256 hashes are in `RUNEWAKER_ENCOUNTER_IMPLEMENTATION_REPORT.json`.

## Validation issues

- None.