Skip to content

README.md

Latest commit

 

History

History
322 lines (257 loc) · 9.75 KB

README.md

File metadata and controls

322 lines (257 loc) · 9.75 KB

TRI‑27 — Ternary Computing ISA

Trinity S³AI DNA: φ² + 1/φ² = 3

Strand III — Language & Hardware Bridge

Overview

TRI‑27 — тритный (ternary) RISC процессор с 27 тритными регистрами и полным стеком разработки: от ISA до FPGA.

In Trinity S³AI

TRI-27 is the Central Execution Engine of Trinity S³AI:

Aspect Role in Trinity
Kernel Executes all Trinity workloads — from VSA operations to HSLM training
φ-Structure 27 registers = 3³ reflects φ² + 1/φ² = 3
Strand III Language & Hardware Bridge between math (Strand I) and brain (Strand II)
Dual Target Zig CPU emulator for development + Verilog FPGA for production 
Trinity S³AI Stack:
┌─────────────────────────────────────────┐
│  Strand I: Math (φ² + 1/φ² = 3)        │
├─────────────────────────────────────────┤
│  Strand II: Brain (Cognitive Arch)     │
├─────────────────────────────────────────┤
│  Strand III: TRI-27 Kernel ← YOU ARE   │
│    • 27×32-bit registers (t0-t26)      │
│    • 36 opcodes (arith, logic, ternary) │
│    • Zig CPU + Verilog FPGA targets     │
└─────────────────────────────────────────┘

Back to Trinity Architecture | Trinity S³AI Architecture

Architecture

.tri spec (Single Source of Truth)
    ↓
TRI-27 Language (Ternary types, AST)
    ↓              ↓
Zig Backend (CPU)  Verilog Backend (FPGA)
    ↓              ↓
  tri27 CLI        openxc7-synth
    ↓              ↓
Queen Episodes    FPGA Bitstream

Word Layout (32-bit instruction)

Bits Field Description
[31:26] opcode 6-bit operation code (36 opcodes)
[25:20] dst Destination register (t0-t26)
[19:14] src1 Source register 1
[13:8] src2 Source register 2 (or shift amount)
[7:0] imm8 8-bit immediate (or unused)

Registers

Регистр Размер Назначение
t0-t26 27×32-bit Тритные регистры (t0 = аккумулятор)
pc 32-bit Program Counter (в инструкциях)
flags {Z, N, C, H, ...} Флаги состояния

ISA — 36 Opcodes

Arithmetic (6)

Opcode Mnemonic Description
0x60 ADD dst = src1 + src2
0x61 SUB dst = src1 - src2
0x62 MUL dst = src1 × src2
0x63 DIV dst = src1 ÷ src2
0x64 INC dst++
0x65 DEC dst--

Logic (6)

Opcode Mnemonic Description
0x18 AND dst = src1 & src2
0x19 OR dst = src1 | src2
0x1A XOR dst = src1 ^ src2
0x1B NOT dst = ~dst
0x1C SHL dst = src1 << shift
0x1D SHR dst = src1 >> shift

Ternary/VSA (4)

Opcode Mnemonic Description
0x60 DOT ternary dot product
0x6A BIND VSA bind operation
0x6B BUNDLE2 majority vote (2 inputs)
0x6C BUNDLE3 majority vote (3 inputs)

Sacred (4)

Opcode Mnemonic Description
0x80 PHI_CONST dst = φ (1.618...)
0x81 PI_CONST dst = π (3.141...)
0x82 E_CONST dst = e (2.718...)
0x92 SACR sacred arithmetic (op, dst, src)

Memory (8)

Opcode Mnemonic Description
0x01 LDI load immediate
0x02 LD load from [src1]
0x03 ST store to [dst]
0x04 LDR load register indirect
0x05 MOV move register
0x06 LDTI load with type
0x07 STO store with offset
0x08 SAI store aligned immediate

Control Flow (8)

Opcode Mnemonic Description
0x10 JUMP PC ← PC + offset
0x11 JZ jump if dst == 0
0x12 JNZ jump if dst != 0
0x13 CALL push PC, PC ← addr
0x14 RET pop PC
0x15 PUSH push to stack
0x16 POP pop from stack
0x17 HALT stop execution

Backends

Zig Backend (CPU Emulator)

Файлы:

  • src/tri27/emu/cpu_state.zig — CPU state, registers, memory
  • src/tri27/emu/decoder.zig — instruction decoder
  • src/tri27/emu/executor.zig — execution engine
  • src/tri27/emu/asm_parser.zig — .tri assembler
  • src/tri27/tri27_cli.zig — CLI entrypoint

Особенности:

  • 36 опкодов, полный ISA
  • 27×32-bit регистры t0-t26
  • 64KB память (align(8) u8)
  • Флаги: Z, N, C, H, O
  • Cycle counter для профилирования

Verilog Backend (FPGA)

Файлы:

  • fpga/openxc7-synth/hslm_ternary_mac.v — ternary ALU core
  • src/tri27/verilog_backend.zig — Zig → Verilog генератор

Особенности:

  • 0 DSP inference (pure LUT)
  • Pipeline: IF → ID → EX → MEM → WB
  • BRAM36 для instruction memory
  • Ternary arithmetic в LUT

Queen Integration — Lotus Cycle

Phase 1: Observe

Файл: src/tri/queen/observe.zig

Читает:

  • policy.json — kill_threshold, crash_rate_limit, byzantine_rate_limit
  • senses.json — farm_best_ppl, test_rate, dirty_files, etc.

Phase 2: Plan

Файл: src/tri/queen/plan.zig

Генерирует PolicyDelta:

  • scale_up — увеличить threshold (×1.1)
  • scale_down — уменьшить threshold (×0.8-0.95)
  • set — установить точное значение
  • wait — ничего не делать

Phase 3: Evaluate

Файл: src/tri/queen/evaluate.zig

Оценивает окно episodes:

  • good — success_rate ≥ 95%
  • unstable — 70% < success_rate < 95%
  • bad — success_rate ≤ 70%
  • unknown — нет данных

Phase 4: Act

Файл: src/tri/queen/act.zig

Исполняет Plan:

  • scale_up — умножить параметр
  • scale_down — разделить параметр
  • trigger — выполнить команду
  • wait — наблюдать

Phase 5: Self-Learning

Файл: src/tri/queen/self_learning.zig

Замкнутый цикл:

tri tri27 run test.tbin
    → Episode → episodes.jsonl
    → loadRecentEpisodes(20)
    → evaluateWindow() → WindowEvaluation
    → generatePlan() → PolicyDelta[]
    → applyPolicyDelta() → Tri27Config
    → saveConfig() → tri27_config.json
    → Episode о self-learning_cycle

Tri27Config:

pub const Tri27Config = struct {
    kill_threshold: f64 = 5.0,        // PPL threshold
    crash_rate_limit: f64 = 0.1,      // Max crash rate
    byzantine_rate_limit: f64 = 0.1,  // Max byzantine ratio
    env_status: EnvStatus = .active,   // Environment status
    max_retries: u32 = 3,             // Max retries
    auto_adapt: bool = true,           // Enable self-learning
};

CLI

# Компиляция
tri tri27 assemble <input.tri> -o <output.tbin>

# Декомпиляция
tri tri27 disassemble <input.tbin>

# Исполнение
tri tri27 run <program.tbin>

# Валидация
tri tri27 validate <source.tri>

# Experience tracking
tri tri27 experience init
tri tri27 experience log <file> [ASM|DISASM|RUN|VAL]
tri tri27 experience status
tri tri27 experience record <issue>

# ISA reference
tri tri27 isa

Tests

Тест Файл Описание
Golden test_golden.zig 15/15 — полный цикл asm→tbin→emu
Comprehensive test_comprehensive.zig 36/36 — все опкоды
Experience tri27_experience.zig Jaccard similarity, recall
Queen Self-Learning self_learning.zig 4/4 — feedback loop

Запуск:

zig build test-tri27-golden        # Golden tests
zig build test-tri27-comprehensive # Comprehensive tests
zig build test-tri27-experience    # Experience tests
zig build test-queen-self-learning # Self-learning tests

File Structure

src/tri27/
├── emu/
│   ├── cpu_state.zig       # CPU state, registers, memory
│   ├── decoder.zig         # Instruction decoder (36 opcodes)
│   ├── executor.zig        # Execution engine
│   ├── asm_parser.zig      # .tri assembler
│   ├── test_golden.zig     # 15 golden tests
│   └── test_comprehensive.zig  # 36 opcode tests
├── tri27_cli.zig           # CLI entrypoint
├── tri27_experience.zig    # Experience tracking
├── tri27_experience_jsonl.zig  # JSONL integration
└── verilog_backend.zig     # Zig → Verilog generator

src/tri/queen/
├── observe.zig             # Phase 1: read policy/senses
├── plan.zig                # Phase 2: generate PolicyDelta
├── evaluate.zig            # Phase 3: evaluate window
├── act.zig                 # Phase 4: execute action
└── self_learning.zig       # Phase 5: closed-loop learning

Status

✅ ISA — 36 opcod ✅ Zig Backend — CPU emulator ✅ Verilog Backend — FPGA synthesis ✅ CLI — assemble/disassemble/run/validate ✅ Queen Integration — Phases 1-5 ✅ Self-Learning — closed feedback loop ✅ Tests — 68/68 passing

Интеграция:

  • src/tri27/ ↔ src/tri/queen/ — Episode tracking
  • src/tri27/tri27_experience.zig → .trinity/queen/episodes.jsonl
  • src/tri/queen/self_learning.zig → .trinity/queen/tri27_config.json