dangernoodle-io / TaipanMiner / 28223101054

90%

push

github

feat: ELF archival + fleet decode (TA-445 Phase 1) (#578)

* feat: add ELF archive store (TA-445 Phase 1)

- fleetlib/elfstore.py: archive, list, find (prefix match), prune
  - archive key = sha256(elf_bytes).hexdigest() — matches esp_app_desc_t.app_elf_sha256
  - panic app_sha256 is the first CONFIG_APP_RETRIEVE_LEN_ELF_SHA chars (default 9)
    of the full key; find() resolves via prefix match
  - prune-on-write: after every archive() call with configurable keep + max_age
  - protected_shas for fleet-aware GC (never delete in-use ELFs)
  - _archived_at override param for deterministic test control
- tests/test_elfstore.py: 19 tests covering all paths (archive, find, prune)
- .gitignore: add .elf-archive/

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat: auto-archive ELF on ota push (TA-445 Phase 1)

- fleetlib/ota.py push(): look for sibling firmware.elf alongside firmware.bin
  (.pio/build/<env>/firmware.elf) and archive it before the HTTP push
- non-fatal: a missing .elf logs a warning but does not block the push
- _resolve_sibling_elf(): checks explicit elf_path, then <bin_stem>.elf
- _archive_elf_for_push(): calls elfstore.archive(), swallows exceptions

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat: add fleetlib.decode + fleet decode command (TA-445 Phase 1)

- fleetlib/decode.py:
  - chip_arch(): map chip_model -> xtensa|riscv
  - find_addr2line(): auto-discover from ~/.platformio/packages/toolchain-*/bin/,
    FLEET_ADDR2LINE env var, or system PATH; toolchain_path override
  - addr2line_decode(): shell to addr2line -e <elf> -f -C; parse function@file:line
  - cause_name(): xtensa EXCCAUSE + riscv mcause name tables (28=LoadProhibited etc.)
  - decode_panic(): full flow (GET /api/diag/panic -> archive lookup -> addr2line)
  - DecodeResult with frames labeled exc_pc / bt[N]
- fleet.py cmd_decode: host arg, --elf override, --toolchain-path, auto-arch from
  /api/info chip_model; graceful no-panic and no-ELF... (continued)

2886 of 3627 branches covered (79.57%)

Branch coverage included in aggregate %.

5384 of 5539 relevant lines covered (97.2%)

149122.39 hits per line