CLI command design

megamaid

Decomposes an Altium project into reusable generated libraries, document JSON, notes JSONC, BOM/netlist outputs, embedded assets, and a manifest.

Usage

altium-cruncher megamaid Hydroscope.PrjPcb -o output/megamaid

Arguments

file is a .PrjPcb. -o selects the output root. --config accepts the same BOM/PnP JSON or JSONC config used by the bom and pnp commands for aliases, variants, and output naming. The command owns its generated subtrees and should avoid deleting unrelated output files.

Output

Outputs include decomposed libraries, project-wide combined and flat split SchLib outputs, per-board combined and split PcbLib outputs, serialized SchDoc/PcbDoc JSON, combined and split SchLib/PcbLib JSON dumps, sparse structured notes JSONC, schematic images, embedded 3D models, BOM/PnP artifacts, netlist artifacts, and megamaid_manifest.json with generated artifact counts and relative paths. The BOM artifacts are written through the shared BOM command path and include flat raw JSON plus the default grouped XLSX output; megamaid intentionally does not emit grouped BOM JSON. PnP artifacts are written through the shared PnP command path under pnp/.

Tests

L3 runs Hydroscope through the public CLI, verifies document JSON, combined and split library JSON, project-wide SchLib split shape, BOM/PnP artifacts, notes JSONC, image/model counts, decoded schematic image payloads, and keeps optional native parity coverage.