| --- |
| title: ARB System Rename |
| date: 2026-05-18 |
| context: System renamed from MORPH to ARB (Any Relational Bit) |
| --- |
| |
| # ARB System — Rename Note |
|
|
| ## New Name |
|
|
| The system has been renamed from **MORPH** to **ARB** (Any Relational Bit). |
|
|
| - **ARB** = Any Relational Bit — the core ternary architecture |
| - **ARBS** = ARB System — the full software system |
| - **ARBitor** = The Python package name (`arbitor/`) |
|
|
| ## Package Structure |
|
|
| All core system files now live under `arbitor/`: |
|
|
| ``` |
| models/Trigram/ |
| ├── arbitor/ # Core ARB system package |
| │ ├── __init__.py # Public API exports |
| │ ├── trigram.py # Core model (ARBModel replaces MORPHTernaryModel) |
| │ ├── tscale.py # Ternary scale tensors |
| │ ├── convert_to_ternary.py # 5-trit packing |
| │ ├── convert_to_ternary*.py # Legacy converters |
| │ ├── flash_vq.py # FlashVQ codebook |
| │ ├── ternary_audit.py # Model state auditor |
| │ ├── profiling.py # Profiling utilities |
| │ ├── train.py # Training pipeline |
| │ ├── optim/ |
| │ │ └── sign_sgd.py # SignSGD optimizer |
| │ └── encoders/ # Float sidecar encoders |
| │ ├── __init__.py |
| │ ├── audio_codec.py |
| │ ├── audio_vq_encoder.py |
| │ └── video_vae.py |
| ├── testing/ # Tests (import from arbitor) |
| ├── .planning/ # Planning docs (P0-P10 complete) |
| ├── TRUE-TERNARY-REFACTOR*.md # Architecture refactor notes |
| ├── BENCHMARK.md # Benchmark docs |
| └── benchmark_true_ternary.py # Benchmark scripts |
| ``` |
|
|
| ## Import Changes |
|
|
| | Before | After | |
| |--------|-------| |
| | `from trigram import ARBModel` | `from arbitor.trigram import ARBModel` | |
| | `from tscale import TernaryScaleTensor` | `from arbitor.tscale import TernaryScaleTensor` | |
| | `from optim.sign_sgd import SignSGD` | `from arbitor.optim.sign_sgd import SignSGD` | |
| | `from encoders.video_vae import load_vae` | `from arbitor.encoders.video_vae import load_vae` | |
| | `from arbitor import ARBModel` | Shorthand via `arbitor/__init__.py` | |
| | `import trigram` | `from arbitor import trigram` | |
|
|
| ## Class Rename |
|
|
| | Before | After | |
| |--------|-------| |
| | `MORPHTernaryModel` | `ARBModel` | |
|
|
