================================================================
 OreBolt OS v1.7 -- Build Manifest
================================================================
 Generated: 2026-07-15
 Target:    HiFiWalker H2 (Ingenic X1000E, MIPS32r2, mipsel-linux-musl)
 Host:      Arch Linux x86_64

 ----------------------------------------------------------------
 CHANGES VS v1.6 (full diff in CHANGELOG.md)
 ----------------------------------------------------------------
  CHANGED:
   - Module count: 17 .mod binaries + 1 daemon (unchanged)
   - All documentation language revised for clarity and consistency
   - retro.mod game launcher documented and listed across all docs
   - Makefile.h2-core-v6.2 -> v6.5
   - h2_ui.h: module enum unchanged
   - main.c: all module versions bumped to 1.7
   - S99broker: OREBOLT_VERSION set to 1.7

  STILL STUBS (4 modules):
   - rfid, glitch, pwdb, bitchat

 ----------------------------------------------------------------
 FILE INVENTORY (counts)
 ----------------------------------------------------------------
  Top-level build files:        6   (Makefile, 2 sub-Makefiles, build.sh,
                                       inject_payloads.sh, lv_conf.h.dist)
  Headers:                      2   (h2_ui.h, log_manager.h)
  Master launcher:              1   (main.c)
  Userland modules (.c):       21   (17 .mod + retro_input_mapper + 2 in retro + 1 proxalarm header)
  HW library (.c):              7   (src/modules/mod_*.c)
  Proxalarm internal headers:   3   (bledsp.h, proxvec.h, radar_ui.h)
  Proxalarm sources:             4   (bledsp.c, proxvec.c, radar_ui.c, proxalarm.c)
  HW library header:            1   (src/modules/panic_purge_api.h)
  Init scripts:                 3   (S98retro-input, S99broker,
                                       bt_input_daemon.sh)
  Overlay scripts:              2   (enable_vault_usb.sh, enable_vault_ble.sh)
  ROM directories:             11   (nes, snes, gb, gbc, gba, genesis,
                                       sms, gg, pce, atari2600, ngp)
  Vault data files:             3   (syslog.log, failures.dat, Provision.txt)
  BT config:                    1   (paired_macs.txt)
  Chat config:                  1   (macros.txt)
  Linux payloads (.dd):        50   (reference set; macos/windows generated
                                       at build time)
  Documentation:                8   (README, QUICKSTART, PREREQUISITES, HEADERS, LICENSE,
                                       ARCHITECTURE, CHANGELOG, BUILD_MANIFEST)
  License stubs:                3   (AGPL-3.0, GPL-2.0, MIT)
  Integrity manifest:           1   (SHA256SUMS)

  TOTAL source/doc files:      111
  TOTAL Linux .dd payloads:     50
  GRAND TOTAL:                 161

 ----------------------------------------------------------------
 MODULE INVENTORY (17 .mod + 1 daemon)
 ----------------------------------------------------------------
  ID  Name                     License          Status
  --  ----                     -------          ------
  0   vault                    GPL-2.0-or-later v1.7 (full PIN auth)
  1   nettaps                  GPL-2.0-or-later v1.7 (full impl)
  2   scalpel                  GPL-2.0-or-later v1.7 (audio synth)
  3   deploy                   GPL-2.0-or-later v1.7 (full impl)
  4   studio                   GPL-2.0-or-later v1.7 (UAC2 mixer console)
  5   probe                    GPL-2.0-or-later v1.7 (full impl)
  6   vterm                    GPL-2.0-or-later v1.7 (full impl)
  7   pauto                    GPL-2.0-or-later v1.7 (full impl)
  8   extract                  GPL-2.0-or-later v1.7 (full impl)
  9   noise                    GPL-2.0-or-later v1.7 (full impl)
  10  reset                    GPL-2.0-or-later v1.7 (full impl)
  11  retro                    GPL-2.0-or-later v1.7 (retro game launcher)
  12  rfid                     GPL-2.0-or-later stub
  13  glitch                   GPL-2.0-or-later stub
  14  pwdb                     GPL-2.0-or-later stub
  15  proxalarm                GPL-2.0-or-later v1.7 (BLE/WiFi proximity alarm)
  16  bitchat                  AGPL-3.0-only    stub
  --  retro_input_mapper      GPL-2.0-or-later v1.7 (uinput gamepad daemon)

 ----------------------------------------------------------------
 HARDWARE LIBRARY (liborebolt.a, 7 modules)
 ----------------------------------------------------------------
  mod_core_hid.c                 GPL-2.0-or-later stub
  mod_forensics.c                GPL-2.0-or-later stub
  mod_panic_hardware_purge.c     GPL-2.0-or-later stub
  mod_panic_purge.c              GPL-2.0-or-later stub
  mod_radio_input_multiplex.c    GPL-2.0-or-later stub
  mod_ui_frame_graphics.c        GPL-2.0-or-later stub
  mod_bitchat_mesh.c             AGPL-3.0-only    (full license header)

 ----------------------------------------------------------------
 KNOWN LIMITATIONS
 ----------------------------------------------------------------
  - 3 modules remain stubs (rfid, glitch, pwdb).
    These require hardware-specific or design-phase work.
  - bitchat is a stub with full AGPL compliance infrastructure.
  - licenses/AGPL-3.0.txt is a stub.  Run:
      curl -o licenses/AGPL-3.0.txt https://www.gnu.org/licenses/agpl-3.0.txt
  - BITCHAT_SOURCE_URL in mod_bitchat_mesh.c is a placeholder.
  - macos/ and windows/ payload folders are populated at build time by
    inject_payloads.sh; only linux/ is shipped as a reference set.
  - Dual-reader input limitation: LVGL encoder driver AND module
    manual handler both open /dev/input/event0.  Works because fork/exec
    gives each module its own input fd, but simultaneous readers on
    the same fd in a single process would need arbitration.

 ----------------------------------------------------------------
 BUILD COMMANDS
 ----------------------------------------------------------------
  ./build.sh                       # full build
  ./build.sh --deploy              # build + deploy to SD card
  ./build.sh --clean               # remove build artifacts
  make headers-check               # verify KERNEL_HEADERS
  make payloads                    # regenerate 150-payload matrix only

 ----------------------------------------------------------------
 REFERENCES
 ----------------------------------------------------------------
  PREREQUISITES.md  -- host setup, toolchain, SD card prep
  QUICKSTART.md     -- fastest path from fresh host to deployed H2
  HEADERS.md        -- kernel headers sourcing (FiiO M3K + XBurst BSP)
  LICENSE.md        -- multi-tier licensing (AGPL for bitchat)
  ARCHITECTURE.md   -- module layout, SoC, build pipeline
  CHANGELOG.md      -- v1.3 -> v1.7 diff
================================================================