From 5be481be0aa2ff50f9c7078e6b39539aee15a67f Mon Sep 17 00:00:00 2001
From: Vasilev Dmitrii <raoffonom@icloud.com>
Date: Sat, 28 Mar 2026 02:33:35 +0700
Subject: [PATCH] Update README.md

---
 docs/tri27/README.md | 90 ++++++++++++++++++++++----------------------
 1 file changed, 45 insertions(+), 45 deletions(-)

diff --git a/docs/tri27/README.md b/docs/tri27/README.md
index ce74ae603d..fc04684457 100644
--- a/docs/tri27/README.md
+++ b/docs/tri27/README.md
@@ -63,11 +63,11 @@ Queen Episodes    FPGA Bitstream
 
 ### Registers
 
-| Регистр | Размер | Назначение |
-|---------|--------|------------|
-| t0-t26 | 27×32-bit | Тритные регистры (t0 = аккумулятор) |
-| pc | 32-bit | Program Counter (в инструкциях) |
-| flags | {Z, N, C, H, ...} | Флаги состояния |
+| Register | Size | Purpose |
+|---------|---------|-----------|
+| t0-t26 | 27×32-bit | Trit registers (t0 = accumulator) |
+| pc | 32-bit | Program Counter (in instructions) |
+| flags | {Z, N, C, H, ...} | Status flags |
 
 ---
 
@@ -146,24 +146,24 @@ Queen Episodes    FPGA Bitstream
 - `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 для профилирования
+**Features**:
+- 36 opcodes, full ISA
+- 27×32-bit registers t0-t26
+- 64KB memory (align(8) u8)
+- Flags: Z, N, C, H, O
+- Cycle counter for profiling
 
 ### Verilog Backend (FPGA)
 
-**Файлы**:
+**Files**:
 - `fpga/openxc7-synth/hslm_ternary_mac.v` — ternary ALU core
-- `src/tri27/verilog_backend.zig` — Zig → Verilog генератор
+- `src/tri27/verilog_backend.zig` — Zig → Verilog generator
 
-**Особенности**:
+**Features**:
 - 0 DSP inference (pure LUT)
 - Pipeline: IF → ID → EX → MEM → WB
-- BRAM36 для instruction memory
-- Ternary arithmetic в LUT
+- BRAM36 for instruction memory
+- Ternary arithmetic in LUT
 
 ---
 
@@ -172,36 +172,36 @@ Queen Episodes    FPGA Bitstream
 ### Phase 1: Observe
 **Файл**: `src/tri/queen/observe.zig`
 
-Читает:
+Read:
 - `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` — ничего не делать
+Generates `PolicyDelta`:
+- `scale_up` — increase threshold (×1.1)
+- `scale_down` — decrease threshold (×0.8-0.95)
+- `set` — set exact value
+- `wait` — do nothing
 
 ### Phase 3: Evaluate
-**Файл**: `src/tri/queen/evaluate.zig`
+**File**: `src/tri/queen/evaluate.zig`
 
-Оценивает окно episodes:
+Evaluates the episodes window:
 - `good` — success_rate ≥ 95%
 - `unstable` — 70% < success_rate < 95%
 - `bad` — success_rate ≤ 70%
-- `unknown` — нет данных
+- `unknown` — no data
 
 ### Phase 4: Act
 **Файл**: `src/tri/queen/act.zig`
 
-Исполняет Plan:
-- `scale_up` — умножить параметр
-- `scale_down` — разделить параметр
-- `trigger` — выполнить команду
-- `wait` — наблюдать
+Executes a Plan:
+- `scale_up` — multiply a parameter
+- `scale_down` — divide a parameter
+- `trigger` — execute a command
+- `wait` — watch
 
 ### Phase 5: Self-Learning
 **Файл**: `src/tri/queen/self_learning.zig`
@@ -209,13 +209,13 @@ Queen Episodes    FPGA Bitstream
 **Замкнутый цикл**:
 ```
 tri tri27 run test.tbin
-    → Episode → episodes.jsonl
-    → loadRecentEpisodes(20)
-    → evaluateWindow() → WindowEvaluation
-    → generatePlan() → PolicyDelta[]
-    → applyPolicyDelta() → Tri27Config
-    → saveConfig() → tri27_config.json
-    → Episode о self-learning_cycle
+→ Episode → episodes.jsonl
+→ loadRecentEpisodes(20)
+→ evaluateWindow() → WindowEvaluation
+→ generatePlan() → PolicyDelta[]
+→ applyPolicyDelta() → Tri27Config
+→ saveConfig() → tri27_config.json
+→ Episode о self-learning_cycle
 ```
 
 **Tri27Config**:
@@ -235,16 +235,16 @@ pub const Tri27Config = struct {
 ## CLI
 
 ```bash
-# Компиляция
+# Compilation
 tri tri27 assemble <input.tri> -o <output.tbin>
 
-# Декомпиляция
+# Decompilation
 tri tri27 disassemble <input.tbin>
 
-# Исполнение
+# Execution
 tri tri27 run <program.tbin>
 
-# Валидация
+# Validation
 tri tri27 validate <source.tri>
 
 # Experience tracking
@@ -261,10 +261,10 @@ tri tri27 isa
 
 ## Tests
 
-| Тест | Файл | Описание |
+| Test | File | Description |
 |------|------|----------|
-| Golden | `test_golden.zig` | 15/15 — полный цикл asm→tbin→emu |
-| Comprehensive | `test_comprehensive.zig` | 36/36 — все опкоды |
+| Golden | `test_golden.zig` | 15/15 — full asm→tbin→emu cycle |
+| Comprehensive | `test_comprehensive.zig` | 36/36 — all opcodes |
 | Experience | `tri27_experience.zig` | Jaccard similarity, recall |
 | Queen Self-Learning | `self_learning.zig` | 4/4 — feedback loop |
 
@@ -316,7 +316,7 @@ src/tri/queen/
 
 ---
 
-**Интеграция**:
+**Integration**:
 - `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`