StorageCraft CLI

The StorageCraft CLI turns common architecture calculations into fast, inspectable terminal models. It has no runtime dependencies beyond Node.js.

Run from the repository

npm install
npm run craft -- topics

RAID capacity

npm run craft -- raid --level 6 --disks 8 --size 4

Supported values are jbod, 0, 1, 2, 3, 4, 5, 6, 01, 10, 50, 60, z1, z2, and z3.

Nested RAID accepts a group count:

npm run craft -- raid --level 60 --disks 16 --size 8 --groups 2

Compare every valid layout for one hardware set:

npm run craft -- raid --compare --disks 12 --size 8 --groups 2

Results separate guaranteed failure tolerance from the higher, placement-dependent maximum possible in mirrored and grouped layouts.

KV-cache memory

npm run craft -- kv \
  --layers 32 --heads 32 --dim 128 \
  --tokens 8192 --bytes 2 --batch 1

The baseline model is:

bytes = 2 × layers × KV heads × head dimension × tokens × bytes/element × batch

The leading 2 represents keys and values. For GQA or MQA, pass the number of KV heads, not attention query heads.

Automation-friendly output

Set NO_COLOR for plain output:

NO_COLOR=1 npm run craft -- raid --level 5 --disks 6 --size 8

Scope

These are transparent educational models. Production sizing also requires filesystem reserve, device-vendor units, spares, rebuild exposure, allocator fragmentation, and serving-framework behavior.