Aarkam / Aarkam Wiki / AM CLI / Erasure Coding, Storage Engines & Self-Healing Reference ARK-CLI-0305
Aarkam - SAT (Storage Substrate) Engines & Math AM CLI • ARK-CLI-0305

Erasure Coding, Storage Engines & Self-Healing Reference

Authoritative command reference for am ec (Cauchy Reed-Solomon SIMD Math), am kdouja (LSM State Sync), am abodi (SMART Telemetry), am repair (Scrubbing), and am transcode.

Last updated: Nov 03, 2026 Classification: Sovereign Tier-4 Enterprise
Document Identifier ARK-CLI-0305
Standard Status
Production Standard
Architecture Tier Aarkam - SAT (Storage Substrate)
Release Version V-1.0.0-GA (Production Stable)
Architecture Tier Scope: Aarkam - SAT (Standalone Tier) These commands govern the mathematical, kernel, and hardware engines embedded directly within Rokka and Abodi. They manage the Ahmodi AVX-512 Cauchy Reed-Solomon codec, the Kdouja direct NVMe LSM PageStore, predictive SMART wear telemetry, cryptographic scrubbing, and dynamic policy transcoding.

This reference details the low-level mathematical and storage engine commands in am, enabling operators to benchmark Galois Field arithmetic, verify LSM write-ahead logs, query NVMe thermal wear, and execute background scrubbing.

1. am ec — Ahmodi Cauchy Reed-Solomon Codec & Benchmarks

1.1 SIMD Vectorization Benchmark (am ec bench)

Measures local CPU SIMD Galois Field $\text{GF}(2^8)$ matrix multiplication throughput across AVX2, AVX-512, or ARM NEON vector units:

bash 
# Benchmark 8+3 Cauchy RS layout with 128 MB buffer over 50 iterations
am ec bench --size-mb 128 --policy 8+3 --iterations 50

1.2 Direct Erasure Coded File Ingestion (am ec upload & download)

bash 
# Encode, encrypt (AES-256-GCM), and stream file across racks with 8+3 parity
am ec upload /data/large-dataset.tar.gz \
  --policy 8+3 \
  --domain Rack \
  --key-file ~/.rokka/master.key \
  -o manifest.json

# Reconstruct file from distributed shards using SIMD Galois math & hedged reads
am ec download manifest.json /tmp/restored-dataset.tar.gz --key-file ~/.rokka/master.key

2. am kdouja — LSM Storage Engine Internals & State Sync

Inspects and forces reconciliation across the in-process Kdouja log-structured merge-tree write-ahead log (WAL) and SSTable manifests:

bash 
# Query active replication health and consistency status across nodes
am kdouja sync-status

# Force metadata reconciliation and stream missing SSTable chunk manifests
am kdouja reconcile

3. am abodi — Predictive Diagnostics & SMART Analytics

Interacts directly with the Abodi diagnostic plane running on Port 7776 / 57776:

bash 
# Check connectivity and reachability of the Abodi service
am abodi status

# Display live exponential moving average (EMA) latency scores & hedged read penalties
am abodi scores --sort-by latency

# Inspect NVMe device endurance, wear percentage, temperature, and RUL failure forecast
am abodi smart storage-01 --device nvme0n1

4. am repair — Self-Healing & Cryptographic Scrubbing

Monitors autonomous shard re-silvering and triggers deep cryptographic disk sector validation:

bash 
# Monitor active chunk reconstruction workers and queue backlog
am repair status --watch 2s

# Initiate deep cryptographic scrub on storage-03 (forces disk cache bypass)
am repair scrub storage-03 --deep

# Dynamically throttle repair bandwidth (e.g. 25 MB/s during peak hours)
am repair throttle 25

5. am transcode — Live Storage Policy Migration

Executes live, background transcoding of datasets between redundancy policies (e.g. converting legacy 3x replicated objects to Ahmodi 8+3 Cauchy RS):

bash 
# Launch background transcoding job migrating to 8+3 layout throttled at 50 MB/s
am transcode start --target-policy 8+3 --rate 50

# Inspect active transcoding progress and reclaimed storage capacity
am transcode status

# Temporarily pause background transcode during high user traffic
am transcode pause
← Previous Article
S3 Storage, Buckets & Cryptographic Tenancy Reference
 Next Article →
Operations, Maintenance & Disaster Recovery Reference