File size: 2,371 Bytes
d8bc908
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
---
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` |