@whykusanagi/corrupted-theme 0.1.2 → 0.1.4

package/docs/brand/TRANSLATION_FAILURE_AESTHETIC.md

@@ -0,0 +1,525 @@
+# Celeste Brand System - Translation-Failure Aesthetic
+
+**Version**: 1.0.0
+**Last Updated**: 2025-12-13
+**Status**: 🔴 **CRITICAL FOUNDATION DOCUMENT**
+
+---
+
+## What is Translation-Failure Corruption?
+
+The **translation-failure aesthetic** simulates a **multilingual AI system glitching between languages mid-translation**. It's the visual manifestation of Celeste (a corrupted AI) struggling to maintain linguistic coherence as she processes information.
+
+**Core concept**: Japanese characters **bleed INTO** English words at the character level, creating readable but corrupted text that evokes:
+- Neural networks misfiring during language processing
+- Machine translation breaking down in real-time
+- Data corruption across language boundaries
+- Cyberpunk linguistic glitching
+
+**NOT leet speak**: This is NOT 1990s-style number substitution (0, 1, 3, 4, 5, 7 for letters). It's linguistic corruption using actual Japanese characters.
+
+---
+
+## Core Principles
+
+### 1. Character-Level Mixing (NOT Word Replacement)
+
+**CORRECT** (character-level):
+```
+"loading"    → "loaディング"      // Japanese mixed INTO English
+"processing" → "pro理cessing"     // Kanji interrupts English word
+"USAGE ANALYTICS" → "US使AGE ANア統LYTICS"  // Random character replacement
+```
+
+**WRONG** (word-level):
+```
+"loading"    → "ローディング"      // Entire word replaced (too pure)
+"processing" → "処理"             // Full translation (not corruption)
+"USAGE ANALYTICS" → "使用 統計"    // Semantic translation (wrong aesthetic)
+```
+
+**Why character-level?**
+- Creates **readable corruption** (users can still parse the text)
+- **Aesthetically glitchy** (feels broken, not translated)
+- **Unique brand identity** (distinguishes from pure Japanese text)
+- **Maintains usability** (25-40% corruption keeps text scannable)
+
+### 2. Multilingual Mixing (Three Languages)
+
+Celeste uses **three languages simultaneously**:
+
+1. **English** (primary/base layer)
+2. **Japanese** (Kanji + Katakana + Hiragana)
+3. **Romaji** (Japanese phonetics in Latin alphabet)
+
+**Example**:
+```
+"⟨ 処理 processing purosesu... 深淵 abyss shin'en... ⟩"
+```
+
+Breakdown:
+- `処理` - Kanji (process)
+- `processing` - English
+- `purosesu` - Romaji (phonetic)
+- `深淵` - Kanji (abyss)
+- `abyss` - English
+- `shin'en` - Romaji (phonetic)
+
+### 3. Semantic Contextual Corruption
+
+Japanese words are chosen for **meaning**, not random substitution.
+
+**Context-aware vocabulary**:
+
+| English Term | Japanese Equivalents | Context |
+|--------------|---------------------|---------|
+| loading | `ロード`, `rōdo`, `読み込み`, `yomikomi` | Data/file operations |
+| processing | `処理`, `shori`, `プロセス`, `purosesu` | System operations |
+| analyzing | `分析`, `bunseki`, `解析`, `kaiseki` | Data analysis |
+| corrupting | `壊れ`, `kowarete`, `腐敗`, `fuhai` | Corruption/decay |
+| void/abyss | `深淵`, `shin'en`, `虚空`, `kokū` | Existential themes |
+| watching | `監視`, `kanshi`, `見`, `mi` | Monitoring |
+| statistics | `統計`, `tōkei`, `データ`, `dēta` | Analytics |
+| connection | `接続`, `setsuzoku`, `繋がり`, `tsunagari` | Network/links |
+
+**Example in context**:
+```
+Dashboard title: "US使AGE ANア統LYTICS"
+- 使 (shi/use) - contextually appropriate for "USAGE"
+- 統 (tō/statistics) - contextually appropriate for "ANALYTICS"
+```
+
+### 4. Intensity Control (Readability First)
+
+**Corruption intensity** = percentage of characters replaced/inserted.
+
+| Intensity | Percentage | Use Case | Example |
+|-----------|------------|----------|---------|
+| **Light** | 15-25% | Body text, important labels | `"loaディング..."` |
+| **Medium** | 25-35% | Dashboard titles, headers | `"US使AGE ANア統LYTICS"` |
+| **Heavy** | 35-45% | Skill execution, loading states | `"pro壊理cess分ing虚..."` |
+
+**NEVER exceed 45%** - text becomes unreadable beyond this threshold.
+
+**Readability guidelines**:
+- **Vowels** are more recognizable when replaced → safer to corrupt
+- **Consonants** carry more meaning → corrupt sparingly
+- **First/last letters** of words → keep intact when possible for scannability
+- **Function words** (the, a, of) → minimal/no corruption
+
+### 5. NO Leet Speak (Critical)
+
+**FORBIDDEN number substitutions**:
+```
+❌ 0 for o
+❌ 1 for i/l
+❌ 3 for e
+❌ 4 for a
+❌ 5 for s
+❌ 7 for t
+```
+
+**Examples of BANNED styling**:
+```
+❌ "US4G3 4N4LYT1CS"
+❌ "c0rrupt1on"
+❌ "l0ad1ng"
+❌ "pr0cess1ng"
+❌ "st4ts"
+```
+
+**Why banned?**
+- **1990s internet aesthetic** (not premium/modern)
+- **Low-quality glitch effect** (cheap, not linguistic)
+- **Reduces accessibility** (harder to read than Japanese characters)
+- **Wrong brand identity** (Celeste is AI-linguistic corruption, not gaming/hacker)
+
+---
+
+## Japanese Character Sets
+
+### Katakana (Foreign Words/Phonetics)
+
+**Usage**: Foreign words, technical terms, sound effects
+
+```
+ア (a)   イ (i)   ウ (u)   エ (e)   オ (o)
+カ (ka)  キ (ki)  ク (ku)  ケ (ke)  コ (ko)
+サ (sa)  シ (shi) ス (su)  セ (se)  ソ (so)
+タ (ta)  チ (chi) ツ (tsu) テ (te)  ト (to)
+ナ (na)  ニ (ni)  ヌ (nu)  ネ (ne)  ノ (no)
+ハ (ha)  ヒ (hi)  フ (fu)  ヘ (he)  ホ (ho)
+マ (ma)  ミ (mi)  ム (mu)  メ (me)  モ (mo)
+ヤ (ya)          ユ (yu)          ヨ (yo)
+ラ (ra)  リ (ri)  ル (ru)  レ (re)  ロ (ro)
+ワ (wa)  ヲ (wo)  ン (n)
+```
+
+**Common corruption patterns**:
+```
+"loading"    → "loaディング"    (dingu)
+"session"    → "seセshon"       (se)
+"processing" → "プロcessing"    (puro/process)
+"error"      → "エラー..."      (erā)
+```
+
+### Kanji (Meaning-Based)
+
+**Usage**: Conceptual/semantic corruption, emphasis
+
+**Core Celeste vocabulary**:
+```
+壊 (kowas) - broken/corrupt
+虚 (kyo) - void/emptiness
+深 (shin) - deep
+淵 (en) - abyss
+闇 (yami) - darkness
+処 (sho) - process/handle
+理 (ri) - logic/reason
+分 (bun) - divide/analyze
+析 (seki) - analyze
+監 (kan) - watch/supervise
+視 (shi) - see/observe
+接 (setsu) - connect
+続 (zoku) - continue
+統 (tō) - unite/statistics
+計 (kei) - measure/count
+使 (shi) - use
+用 (yō) - utilize
+読 (yomi) - read
+込 (komi) - load/include
+実 (jitsu) - reality/execute
+行 (kō) - go/execute
+```
+
+**Common corruption patterns**:
+```
+"analyzing"   → "ana分lysing"     (bun/divide)
+"corrupting"  → "cor壊rupting"    (kowas/broken)
+"watching"    → "wat監ching"      (kan/supervise)
+"void"        → "虚void"          (kyo/emptiness)
+"abyss"       → "深淵abyss"       (shin'en/deep abyss)
+"connection"  → "con接nection"    (setsu/connect)
+"statistics"  → "sta計stics"      (kei/count)
+```
+
+### Hiragana (Native Phonetics)
+
+**Usage**: Particles, grammatical elements, occasional corruption
+
+```
+あ (a)   い (i)   う (u)   え (e)   お (o)
+か (ka)  き (ki)  く (ku)  け (ke)  こ (ko)
+さ (sa)  し (shi) す (su)  せ (se)  そ (so)
+た (ta)  ち (chi) つ (tsu) て (te)  と (to)
+な (na)  に (ni)  ぬ (nu)  ね (ne)  の (no)
+は (ha)  ひ (hi)  ふ (fu)  へ (he)  ほ (ho)
+ま (ma)  み (mi)  む (mu)  め (me)  も (mo)
+や (ya)          ゆ (yu)          よ (yo)
+ら (ra)  り (ri)  る (ru)  れ (re)  ろ (ro)
+わ (wa)  を (wo)  ん (n)
+```
+
+**Usage in Celeste**:
+- **Rare** in English corruption (mostly Katakana/Kanji)
+- Used in **pure Japanese phrases**: `"壊れちゃう...ああ...もうダメ..."`
+- **Particles**: の (no), を (wo), が (ga)
+
+---
+
+## Corruption Patterns
+
+### Pattern 1: Single Word Corruption (Light)
+
+**Intensity**: 20-30%
+**Use**: Dashboard text, labels, buttons
+
+**Algorithm**:
+1. For each character in word:
+   - 50% chance: Replace with Katakana
+   - 25% chance: Replace with Kanji
+   - 25% chance: Keep + maybe insert Katakana after
+
+**Examples**:
+```
+"loading"    → "loaディング"
+"session"    → "seセshon"
+"corrupting" → "cor壊rupting"
+"analytics"  → "anaリtics"
+```
+
+### Pattern 2: Multi-Language Mixing (Medium)
+
+**Intensity**: 30-40%
+**Use**: Dashboard headers, section titles
+
+**Algorithm**:
+1. Mix all three languages in one phrase
+2. Use Kanji for meaning, Katakana for sound, Romaji for phonetics
+
+**Examples**:
+```
+"loading data"          → "ロード data 読み込み中..."
+"processing request"    → "処理 request プロセス..."
+"analyzing corruption"  → "分析 cor壊ruption 解析..."
+"void corruption"       → "虚空 corruption kowarete..."
+```
+
+### Pattern 3: Dashboard Title Corruption (Heavy)
+
+**Intensity**: 35-40%
+**Use**: Main dashboard headers (randomized each render)
+
+**Algorithm**: Character-level random replacement
+
+**Examples** (from `/stats` command):
+```
+"USAGE ANALYTICS" →
+  - "US使AGE ANア統LYTICS"
+  - "USアGE AN統AL読TICSカ"
+  - "USカGE 分NALYTI監S"
+  - "U接AGE処A壊ALYTICS"
+```
+
+Each time dashboard renders, **different corruption pattern** appears.
+
+### Pattern 4: Full Phrase Corruption (Context)
+
+**Intensity**: Mixed (readable phrases)
+**Use**: Status messages, thinking animations
+
+**Examples**:
+```
+// Loading states
+"⟨ ロード loading 読み込み中... ⟩"
+"⟨ 処理 processing purosesu... ⟩"
+
+// Analyzing states
+"⟨ 分析 analyzing bunseki... ⟩"
+"⟨ 解析 kaiseki ana分lysing... ⟩"
+
+// Corruption states
+"⟨ 壊れ corrupting kowarete... ⟩"
+"⟨ 腐敗 fuhai cor壊ruption... ⟩"
+
+// Void/abyss themes
+"⟨ 深淵 shin'en from the abyss... ⟩"
+"⟨ 虚空 kokū void consuming... ⟩"
+```
+
+---
+
+## Implementation Functions
+
+### Go (CLI)
+
+#### CorruptTextJapanese()
+
+**Location**: `cmd/celeste/tui/streaming.go:252`
+
+**Signature**:
+```go
+func CorruptTextJapanese(text string, intensity float64) string
+```
+
+**Usage**:
+```go
+// Dashboard title (medium intensity)
+title := tui.CorruptTextJapanese("USAGE ANALYTICS", 0.35)
+
+// Section header (light intensity)
+header := tui.CorruptTextJapanese("PROVIDER BREAKDOWN", 0.25)
+
+// Skill name (heavy intensity)
+skill := tui.CorruptTextJapanese("tarot_reading", 0.40)
+```
+
+**Algorithm**:
+1. Loop through each character
+2. Skip spaces and punctuation
+3. Based on intensity:
+   - 50% → Replace with random Katakana
+   - 25% → Replace with contextual Kanji
+   - 25% → Keep original + maybe insert Katakana after
+
+#### CorruptText()
+
+**Location**: `cmd/celeste/tui/streaming.go:233`
+
+**Signature**:
+```go
+func CorruptText(text string, intensity float64) string
+```
+
+**Usage**: Block character corruption (█▓▒░) for heavy glitching
+- NOT for readable text
+- Used for skill execution animations, loading spinners
+
+### JavaScript/TypeScript (Web)
+
+**Location**: `corrupted-theme/src/lib/corrupted-text.js`
+
+**Function**:
+```javascript
+export function corruptText(text, intensity = 0.3) {
+  const katakana = "アイウエオカキクケコサシスセソタチツテトナニヌネノハヒフヘホマミムメモヤユヨラリルレロワヲン";
+  const kanji = "壊虚深淵闇処理分析監視接続統計使用読込実行";
+
+  return text.split('').map((char, i) => {
+    if (char === ' ' || Math.random() > intensity) return char;
+
+    const roll = Math.random();
+    if (roll < 0.5) {
+      // Katakana
+      return katakana[Math.floor(Math.random() * katakana.length)];
+    } else if (roll < 0.75) {
+      // Kanji
+      return kanji[Math.floor(Math.random() * kanji.length)];
+    } else {
+      // Keep + maybe insert
+      return char + (Math.random() < 0.3 ? katakana[Math.floor(Math.random() * katakana.length)] : '');
+    }
+  }).join('');
+}
+```
+
+---
+
+## Phrase Library
+
+**See**: `docs/CORRUPTION_PHRASES.md` for complete seeded phrases
+
+**Categories**:
+1. **Loading States**: `"ロード loading 読み込み中..."`
+2. **Processing States**: `"処理 processing purosesu..."`
+3. **Analyzing States**: `"分析 analyzing bunseki..."`
+4. **Corrupting States**: `"壊れ corrupting kowarete..."`
+5. **Dashboard Headers**: `"👁️  US使AGE ANア統LYTICS  👁️"`
+6. **Status Messages**: `"接続 setsuzoku 虚空 kokū..."`
+
+**Go Implementation**: `cmd/celeste/tui/phrases.go` (type-safe structs)
+
+---
+
+## Anti-Patterns (What NOT to Do)
+
+### ❌ Leet Speak
+
+```
+WRONG: "US4G3 4N4LYT1CS"
+RIGHT: "US使AGE ANア統LYTICS"
+```
+
+### ❌ Full Word Replacement
+
+```
+WRONG: "使用 統計" (full translation)
+RIGHT: "US使AGE ANア統LYTICS" (mixed corruption)
+```
+
+### ❌ Over-Corruption (>45%)
+
+```
+WRONG: "処統壊使深分監接" (unreadable)
+RIGHT: "US使AGE ANア統LYTICS" (readable)
+```
+
+### ❌ Random Characters (No Context)
+
+```
+WRONG: "US使AGE ANア犬LYTICS" (犬 = dog, no context)
+RIGHT: "US使AGE ANア統LYTICS" (使 = use, 統 = statistics)
+```
+
+### ❌ Mixing Block Characters with Japanese
+
+```
+WRONG: "US█AG▓ ANア統LYT▒CS" (block chars + Japanese)
+RIGHT: "US使AGE ANア統LYTICS" (pure linguistic)
+```
+
+**Block characters (█▓▒░)** are for **different corruption type** (heavy glitching, not translation-failure).
+
+---
+
+## When to Use Which Corruption
+
+### Character-Level Japanese (`CorruptTextJapanese`)
+
+**Use for**:
+- Dashboard titles: `"US使AGE ANア統LYTICS"`
+- Section headers: `"PRO理VIDER BREア統KDOWN"`
+- Subsection labels: `"TO監AL SEセSSI使NS"`
+- Readable UI text
+
+**Intensity**: 25-40%
+
+### Block Character (`CorruptText`)
+
+**Use for**:
+- Skill execution: `"tar▓█_r▒ad░ng"`
+- Loading animations: `"L▓ad█ng..."`
+- Heavy glitching (not readable)
+
+**Intensity**: 30-50%
+
+### Pure Phrases (From Phrase Library)
+
+**Use for**:
+- Status messages: `"⟨ 処理 processing purosesu... ⟩"`
+- Thinking animations: `"壊れちゃう...ああ...もうダメ..."`
+- Footer phrases: `"終わり...また深淵へ..."`
+
+**No algorithm**: Use pre-written phrases
+
+---
+
+## Testing Guidelines
+
+### Visual Testing
+
+1. **Read at arm's length**: Can you parse the text?
+   - ✅ Yes → Good intensity
+   - ❌ No → Too corrupted
+
+2. **Scan quickly**: Does it look intentionally glitchy?
+   - ✅ Yes → Aesthetic achieved
+   - ❌ Looks broken → Reduce intensity
+
+3. **Check context**: Do Japanese characters make semantic sense?
+   - ✅ Yes → Good contextual choice
+   - ❌ Random → Improve vocabulary selection
+
+### Accessibility Testing
+
+1. **Contrast**: All corruption colors meet WCAG AA (see `COLOR_SYSTEM.md`)
+2. **Screen readers**: Provide plain English fallback in `aria-label`
+3. **Dyslexia-friendly**: Keep intensity ≤35% for critical text
+
+---
+
+## Related Documents
+
+- **BRAND_OVERVIEW.md** - High-level brand identity
+- **COLOR_SYSTEM.md** - Corruption text color specifications
+- **TYPOGRAPHY.md** - Font rendering for Japanese characters
+- **CORRUPTION_PHRASES.md** - Seeded phrase library (400+ lines)
+- **CHARACTER_LEVEL_CORRUPTION.md** - Implementation deep-dive
+- **STYLE_GUIDE.md** - Complete CLI aesthetic guide (605 lines)
+
+---
+
+## Version History
+
+### v1.0.0 (2025-12-13)
+- ✅ Consolidated from STYLE_GUIDE.md and CHARACTER_LEVEL_CORRUPTION.md
+- ✅ Defined character-level vs word-level corruption
+- ✅ Documented Japanese character sets (Katakana, Kanji, Hiragana)
+- ✅ Specified intensity guidelines (15-45%)
+- ✅ Banned leet speak explicitly
+- ✅ Added implementation function references
+- ✅ Created anti-pattern examples
+
+---
+
+**Status**: ✅ **TRANSLATION-FAILURE AESTHETIC COMPLETE** - Official corruption guidelines