feat(extractor): extract scene modules (SCENE:DLLS=) like engines

A module DLL has no engine factory: its CMC_ExternObject::resolve compares
TYPE (CXString::equals or operator==), allocates and constructs. The
runner of each type is the vftable its constructor or a virtual installs
whose prepare slot chains to CMC_Runner::prepareMthHashSet (defined when
analysis left it out); registrations, dispatch, signatures, per-type
events and fields then come from the engine passes, limited to the
module's own runners. Snapshots record module_of (the host engine DLL).

An unoptimised run() keeps the switch index in a stack slot; its bounds
are followed through that slot only when the register match finds none.
The batch queue extracts plugins too, the inventory knows MATRIX, QMAN,
INERTIA and BOARD, and the tracker marks module-mapped types.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Patryk Gensch
2026-10-28 20:58:40 +01:00
co-authored by Claude Opus 5.5
parent f71cd9a90f
commit 4e65268a1e
7 changed files with 301 additions and 49 deletions
+6 -2
View File
@@ -1,4 +1,4 @@
"""Resumable, SHA-addressed engine extraction queue (POSIX)."""
"""Resumable, SHA-addressed extraction queue for engines and scene modules (POSIX)."""
from __future__ import annotations
import argparse
@@ -115,6 +115,10 @@ def execute_worker(source, output, log, timeout, env):
raise RuntimeError('Extractor exited with code ' + str(code))
# Engines and the scene modules (SCENE:DLLS=) that add script types; the extractor handles both.
EXTRACTED_SCOPES = ('engine', 'plugin')
def run_queue(manifest, out_dir, *, ghidra_home=None, timeout=1800, limit=None,
retry_failed=False, worker=execute_worker):
if timeout <= 0 or (limit is not None and limit < 0):
@@ -146,7 +150,7 @@ def _run(builds, directory, ghidra_home, timeout, limit, retry_failed, worker):
report = {'schema': 'extraction-batch/1', 'attempted': 0, 'succeeded': 0,
'pending': 0, 'skipped_success': 0, 'skipped_failed': 0, 'skipped_scope': 0, 'failures': []}
for build in builds:
if build.get('scope') != 'engine':
if build.get('scope') not in EXTRACTED_SCOPES:
report['skipped_scope'] += 1
continue
sha = build['sha256']