Ingestion & normalization

def function_name(self, func: Function) -> str | None:
    """Best available name: name section > export > import field."""
    if func.index in self.names.function_names:
        return self.names.function_names[func.index]
    if func.export_names:
        return func.export_names[0]
    if func.is_import and func.import_field:
        return f"{func.import_module}.{func.import_field}"
    return None

try:
    func.instructions = _disassemble_body(code_bytes)
except (UnsupportedOpcode, IndexError, ValueError) as exc:
    func.disasm_error = str(exc)

from warden.ingest import parse_glue_file

info = parse_glue_file("app.js")
print(info.emscripten_version)    # e.g. "3.1.55"
print(info.dyncall_signatures)    # e.g. ["ii", "iii", "viii"]
print(info.uses_pthreads)         # True / False
print(info.proxy_to_pthread)      # True / False

warden init                                          # create warden.db
warden ingest app_v1.wasm --glue app_v1.js --label v1

              Ingested 'v1'
 ─────────────────────────────────
  functions        1 847
    imported         312
    defined        1 535
  seeded symbols     427
  emscripten       3.1.55
  shared memory    yes

from warden.kb import KnowledgeBase
from warden.project import ingest_into_kb

kb = KnowledgeBase("warden.db")

result = ingest_into_kb(
    kb,
    "app_v1.wasm",
    label="v1",
    glue_path="app_v1.js",   # optional
    notes="initial analysis",
)

print(result.num_functions)    # total functions (imported + defined)
print(result.num_imported)     # functions from the import section
print(result.seeded_symbols)   # names written for free before Oracle/agents
print(result.emscripten_version)  # from glue, or None
print(result.shared_memory)    # True if shared-memory flag is set in the binary

kb.close()

from warden.ingest import parse_file

module = parse_file("app_v1.wasm")

print(module.version)              # should be 1 for all current modules
print(len(module.functions))       # all functions, imported and defined
print(module.shared_memory())      # True if threads are in use
print(module.function_name(module.functions[42]))  # best available name

# Inspect one function's disassembly
f = module.defined_functions[0]
if f.instructions is not None:
    for ins in f.instructions[:5]:
        print(ins.mnemonic, ins.immediates)
elif f.disasm_error:
    print("partial disassembly:", f.disasm_error)
    # f.body still contains the raw bytes

# Extract strings from active data segments
for addr, s in module.strings(minimum_length=4):
    print(f"0x{addr:08x}  {s!r}")