@@ -1,9 +1,11 @@
 ---
-eatmycode_version: "2.0.0"
+eatmycode_version: "2.1.0"
 ---
 
 # Qiling Architecture
 
+Generated with [eatmycode](https://github.com/xwings/eatmycode).
+
 ## Read First
 
 Before planning code changes or reviewing code, read
 
@@ -1,5 +1,5 @@
 ---
-eatmycode_version: "2.0.0"
+eatmycode_version: "2.1.0"
 ---
 
 # Agent Rules
 
@@ -1,5 +1,5 @@
 ---
-eatmycode_version: "2.0.0"
+eatmycode_version: "2.1.0"
 ---
 
 # Firmware Routes
 
@@ -1,5 +1,5 @@
 ---
-eatmycode_version: "2.0.0"
+eatmycode_version: "2.1.0"
 ---
 
 # Operating System Routes
 
@@ -1,5 +1,5 @@
 ---
-eatmycode_version: "2.0.0"
+eatmycode_version: "2.1.0"
 ---
 
 # Runtime Routes
 
@@ -1,5 +1,5 @@
 ---
-eatmycode_version: "2.0.0"
+eatmycode_version: "2.1.0"
 ---
 
 # CPU Architecture and Calling Conventions
@@ -21,7 +21,7 @@ or cross-platform compatibility certification.
 | --- | --- |
 | [arch/arch.py](../../qiling/arch/arch.py): `QlArch` | CPU, pointer width, stack, context interface |
 | [arch/register.py](../../qiling/arch/register.py): `QlRegisterManager` | Name-to-Unicorn registers and PC/SP aliases |
-| [arch/](../../qiling/arch/), [arch/models.py](../../qiling/arch/models.py) | Concrete x86/ARM/MIPS/RISC-V/PPC/Cortex-M adapters and CPU enums |
+| [arch/](../../qiling/arch/), [arch/models.py](../../qiling/arch/models.py), `*_const.py` | Concrete x86/ARM/MIPS/RISC-V/PPC/Cortex-M adapters, CPU enums, register maps and `EXCP` exception codes |
 | [cc/__init__.py](../../qiling/cc/__init__.py): `QlCC`, `QlCommonBaseCC` | Register/stack slots, result, return address, frame unwind |
 | [arch/cortex_m.py](../../qiling/arch/cortex_m.py): `QlArchCORTEX_M` | Exception/vector state and task-aware Unicorn |
 | [test_cpu_models.py](../../tests/test_cpu_models.py), [test_riscv.py](../../tests/test_riscv.py), [test_shellcode.py](../../tests/test_shellcode.py) | Model selection and instruction/ABI samples |
@@ -43,8 +43,13 @@ versions come from the root manifest, not individual adapters.
   multiword arguments, shadow space, register exhaustion, stack return
   addresses and unwind rules differ (`cc/__init__.py`, `cc/intel.py`).
 - Endianness, CPU mode and Thumb PC handling affect execution and instruction
-  decoding. Preserve `effective_pc` and Cortex-M exception return behavior
-  when changing ARM mode; inspect the core Thumb workaround too.
+  decoding. Preserve the ARM adapter's `effective_pc` (consumers fall back
+  to `arch_pc` via `getattr`) and Cortex-M exception return behavior when
+  changing ARM mode; inspect the core Thumb workaround too.
+- Interrupt numbers delivered to `hook_intno` are QEMU exception codes.
+  **Observed:** ARM/ARM64 and MIPS Linux traps use the `EXCP` enums in
+  `cortex_m_const.py` and `mips_const.py`; x86/RISC-V/PPC still pass
+  literals. Prefer an existing enum and extend it for new codes.
 - Concrete adapters instantiate engine/assembler/disassembler objects;
   supported enums do not imply support for every OS/CPU combination.
   Cortex-M uses `MultiTaskUnicorn` and hardware interrupt state.
@@ -73,8 +78,9 @@ never substitute host pointer size for a guest ABI.
 
 From `tests/`: `python -m unittest test_cpu_models test_riscv test_shellcode`
 with root dependencies and relevant rootfs samples. All selected modules
-passed during rebuild; CPU-model suite has 7 tests. Their scope is selected
-models/instructions and guest execution, not instruction-set conformance.
+passed during the latest refresh (11 CPU-model/RISC-V and 8 shellcode
+cases). Their scope is selected models/instructions and guest execution,
+not instruction-set conformance.
 For PPC changes use `test_elf.ELFTest.test_elf_linux_powerpc`; for ABI changes
 run the consuming OS API/syscall regression as well.
 
 
@@ -1,5 +1,5 @@
 ---
-eatmycode_version: "2.0.0"
+eatmycode_version: "2.1.0"
 ---
 
 # Bare-metal Execution
@@ -71,16 +71,17 @@ semantics into unrelated POSIX/Windows run loops.
 ## Verification
 
 From `tests/`: `python -m unittest test_mcu.MCUTest.test_mcu_snapshot_stm32f411 test_mcu.MCUTest.test_mcu_usart_input_stm32f411 test_blob.BlobTest.test_uboot_arm`
-passed 3 cases during rebuild. Root dependencies and matching STM32/U-Boot
-fixtures are required. Run `python test_mcu.py` for broader device/timing
+passed 3 cases during the latest refresh. Root dependencies and matching
+STM32/U-Boot fixtures are required. Run `python test_mcu.py` for broader device/timing
 changes and `python test_blob.py` for raw behavior; the full suites are not
 certified by the selected cases.
 
 ## Known Gaps
 
 `test_blob.BlobTest.test_blob_raw` fails because rootfs lacks
 `blob/example_raw.bin`; [fixture source](../../examples/src/blob/Makefile)
-exists but was not built or copied into the submodule during this rebuild.
+exists but is not built or copied into the submodule; the case still
+errors with a missing-file error.
 Fast-mode faults currently stop cleanly instead of delivering hardware
 HardFault. Timeout units differ by execution path; full scheduler timing
 and MCU exception fidelity remain unverified.
@@ -1,5 +1,5 @@
 ---
-eatmycode_version: "2.0.0"
+eatmycode_version: "2.1.0"
 ---
 
 # CLI, Packaging and Development Tooling
@@ -95,10 +95,12 @@ CLI/version/profile behavior and TUI import outside the checkout. For
 checkout behavior from `tests/`: `python test_qltool.py`; rootfs samples
 are required for argument, JSON, filter and coverage cases.
 
-Rebuild evidence: sdist plus wheel-from-sdist build passed, artifact metadata
-checks and `poetry check --lock` passed, 8 selected CLI tests passed, and 3 installed-wheel cases
-passed in a second fresh environment. See [root verification](../../ARCHITECTURE.md#verification)
-for common setup and Linux aggregate. No configured lint/type-check command exists.
+Latest refresh evidence: sdist plus wheel-from-sdist build, `twine check
+--strict` and `poetry check --lock` passed; 5 checkout CLI cases and 3
+installed-wheel cases passed in a second fresh environment; the wheel
+contains `qltui.py`, the 7 profiles and 43 GDB XML files. See
+[root verification](../../ARCHITECTURE.md#verification) for common setup
+and Linux aggregate. No configured lint/type-check command exists.
 
 ## Known Gaps
 
 
@@ -1,5 +1,5 @@
 ---
-eatmycode_version: "2.0.0"
+eatmycode_version: "2.1.0"
 ---
 
 # Core Runtime
@@ -45,6 +45,9 @@ by `hookcallback` and re-raised by `emu_start`, not silently consumed.
 - Factories derive modules/class names from enums with explicit format/arch
   mappings. A new enum alone is insufficient (`utils.py`). Hook callback
   signatures and `QL_HOOK_BLOCK` behavior must survive dispatcher changes.
+  Interrupt, memory-fault and invalid-instruction events that no hook
+  handles raise `QlErrorCoreHook` (`core_hooks.py`); OS personalities
+  choose which interrupt numbers they hook.
 - Profiles use defaults plus OS/user overrides; MCU uses YAML-derived maps
   (`profile_setup`). Parsing belongs here; the consumer owns each key.
 - `save` includes only selected components. `restore` applies only included
@@ -80,7 +83,8 @@ not a claim that the tree is an acyclic import graph.
 
 From `tests/`, after root setup: `python -m unittest test_shellcode`;
 `python -m unittest test_elf.ELFTest.test_memory_search` checks memory-facing
-facade behavior. Both passed during rebuild on Linux/Python 3.13/Unicorn 2.1.3.
+facade behavior. Both passed during the latest refresh on Linux/Python
+3.13/Unicorn 2.1.3.
 For snapshot changes use matching cases in `test_elf.py` and
 `test_mcu.MCUTest.test_mcu_snapshot_stm32f411` (the MCU case also passed).
 Fixtures are relative to `tests/`. Passing these does not certify every
 
@@ -1,5 +1,5 @@
 ---
-eatmycode_version: "2.0.0"
+eatmycode_version: "2.1.0"
 ---
 
 # Debuggers