@whykusanagi/corrupted-theme 0.1.3 → 0.1.5

package/docs/FUTURE_WORK.md

@@ -1,189 +0,0 @@
-# Future Work & TODO List
-
-This document tracks planned features, incomplete integrations, and improvement opportunities for CelesteCLI.
-
----
-
-## 📋 Priority 1: Code Cleanup (Immediate)
-
-### ✅ COMPLETED
-- [x] Remove dead files: `scaffolding.go`, `ui.go`, `animation.go` (-911 lines)
-- [x] Fix mermaid diagrams in README
-- [x] Fix image display size
-
-### 🔄 IN PROGRESS
-- [ ] Remove unused functions:
-  - [ ] `ListProviders()` in `providers/registry.go` (line 158)
-  - [ ] `GetToolCallingProviders()` in `providers/registry.go` (line 167)
-  - [ ] `DeleteSkill()` in `skills/registry.go` (line 184)
-
----
-
-## 🔌 Priority 2: Provider Integrations
-
-### Tier 1: Limited Support (Short-term)
-
-#### DigitalOcean Gradient
-- **Status**: LIMITED - Function calling disabled
-- **Issue**: Agent API requires cloud-hosted functions, not local execution
-- **Location**: `providers/registry.go` lines 120-130
-- **Tasks**:
-  - [ ] Update documentation to clarify limitations
-  - [ ] Add provider notes to README
-  - [ ] Consider removing if not actively used
-
-#### ElevenLabs
-- **Status**: UNTESTED - Voice AI focused
-- **Issue**: Function calling support unknown
-- **Location**: `providers/registry.go` lines 132-142
-- **Tasks**:
-  - [ ] Test with real API key
-  - [ ] Document function calling capability
-  - [ ] Update registry or remove if unsupported
-
-#### Anthropic Claude (OpenAI Compatibility)
-- **Status**: TESTING - Uses OpenAI SDK compatibility layer
-- **Issue**: Native API differs, not fully tested
-- **Location**: `providers/registry.go` lines 70-80
-- **Note**: "OpenAI SDK compatibility is for testing only. Native API recommended."
-- **Tasks**:
-  - [ ] Implement native Anthropic API support
-  - [ ] Test tool calling with Messages API
-  - [ ] Document as experimental until native support added
-
-### Tier 2: Enterprise Providers (Long-term)
-
-#### AWS Bedrock
-- **Status**: NOT IMPLEMENTED
-- **Complexity**: Requires AWS SDK, IAM roles, region configuration
-- **Use Case**: Enterprise customers with existing AWS infrastructure
-- **Tasks**:
-  - [ ] Evaluate user demand
-  - [ ] Research Bedrock function calling capabilities
-  - [ ] Implement if enterprise users request
-
-#### Azure OpenAI
-- **Status**: NOT IMPLEMENTED
-- **Complexity**: Different auth model (Azure AD), enterprise-focused
-- **Use Case**: Enterprise customers with Azure subscriptions
-- **Tasks**:
-  - [ ] Evaluate user demand
-  - [ ] Research Azure OpenAI API differences
-  - [ ] Implement if enterprise users request
-
-#### GCP Model Garden
-- **Status**: NOT NEEDED - Vertex AI covers Google's offerings
-- **Note**: Redundant with existing Gemini/Vertex support
-- **Decision**: DO NOT IMPLEMENT
-
----
-
-## ✨ Priority 3: Feature Enhancements
-
-### CLI Commands
-
-#### `/providers` Command
-- **Purpose**: List available providers and their capabilities
-- **Would enable**: `ListProviders()` and `GetToolCallingProviders()` functions
-- **Tasks**:
-  - [ ] Add `/providers list` - Show all providers
-  - [ ] Add `/providers list --tools` - Show only tool-capable providers
-  - [ ] Add `/providers info <name>` - Show provider details
-  - [ ] Update commands/commands.go with new handlers
-
-#### Model Step Validation (Venice.ai)
-- **Purpose**: Enforce model-specific step limits for image generation
-- **Issue**: Some models have lower limits (e.g., wai-Illustrious max is 30)
-- **Location**: `venice/media.go` line 70
-- **Tasks**:
-  - [ ] Create model capabilities map
-  - [ ] Add validation in `GenerateImage()`
-  - [ ] Return clear error messages for invalid steps
-
----
-
-## 🧪 Priority 4: Testing & Quality
-
-### Provider Testing
-- [ ] Create integration test suite for all providers
-- [ ] Add mock server for offline testing
-- [ ] Test function calling on all supported providers
-- [ ] Document which models support parallel function calling
-
-### Code Coverage
-- [ ] Increase test coverage above 40% threshold
-- [ ] Add unit tests for skills package
-- [ ] Add integration tests for TUI interactions
-
----
-
-## 📚 Priority 5: Documentation
-
-### Provider Documentation
-- [ ] Create `docs/PROVIDERS.md` with detailed provider comparison
-- [ ] Document setup instructions for each provider
-- [ ] Add troubleshooting guides for common provider issues
-- [ ] Update README with provider limitations
-
-### Architecture Documentation
-- [ ] Create detailed function call flow diagram
-- [ ] Document TUI component lifecycle
-- [ ] Add contribution guide for new skills
-- [ ] Document provider integration requirements
-
----
-
-## 🔍 Functions to Monitor (Keep for Now)
-
-These functions are currently unused but may be useful for future features:
-
-- `HasHandler()` in `skills/registry.go` - Useful for debugging/validation
-- `Count()` in `skills/registry.go` - Useful for stats/metrics
-- `GetBestToolModel()` in `providers/models.go` - Useful for auto-selection
-
-**Decision**: Keep these small utility functions until clear they won't be needed.
-
----
-
-## 📊 Codebase Statistics
-
-### Current State
-- **Total Go files**: 21 active (24 original - 3 removed)
-- **Lines of code**: ~6,500 (after removing 911 lines of dead code)
-- **Active skills**: 18 built-in + user-defined
-- **Supported providers**: 9 (3 fully tested, 6 experimental/limited)
-
-### Post-Cleanup Goals
-- **Target test coverage**: 60%+
-- **Target providers fully tested**: 5+ (add Gemini, Anthropic)
-- **Documentation completeness**: 90%+
-
----
-
-## 🚀 How to Contribute
-
-When working on items from this list:
-
-1. **Check Status**: Ensure item isn't already in progress
-2. **Create Issue**: Reference this TODO item
-3. **Branch**: Use `feature/provider-xyz` or `fix/cleanup-xyz`
-4. **Test**: Add tests for new providers/features
-5. **Document**: Update relevant docs and this file
-6. **PR**: Reference TODO item in PR description
-
----
-
-## 📝 Notes
-
-- This document is maintained as part of the codebase cleanup initiative
-- Dead code audit performed: 2025-12-06
-- Last updated: 2025-12-06
-- See `CLAUDE.md` for development guidelines
-- See `ROADMAP.md` for strategic direction
-
----
-
-**Legend**:
-- ✅ COMPLETED - Task finished
-- 🔄 IN PROGRESS - Currently being worked on
-- [ ] TODO - Not started yet

package/docs/IMPLEMENTATION_VALIDATION.md

@@ -1,401 +0,0 @@
-# Celeste CLI - Implementation Validation Report
-
-**Date**: 2025-12-12
-**Status**: ✅ **FULLY COMPLIANT** with translation-failure aesthetic
-**Leet Speak Instances**: **ZERO** ✓
-
----
-
-## Executive Summary
-
-The Celeste CLI codebase has been audited for adherence to the official translation-failure corruption aesthetic (defined in `@whykusanagi/corrupted-theme`).
-
-**Result**: The implementation is **100% correct** and uses NO leet speak.
-
-All user-facing text follows the pure Japanese/English/Romaji mixing pattern at the character level, with zero number substitutions (0, 1, 3, 4, 5, 7).
-
----
-
-## Audit Scope
-
-### Files Audited
-- ✅ `cmd/celeste/tui/streaming.go` - Corruption engine
-- ✅ `cmd/celeste/commands/stats.go` - Stats dashboard
-- ✅ `cmd/celeste/commands/corruption.go` - Corruption utilities
-- ✅ `cmd/celeste/main.go` - Thinking phrases
-- ✅ `cmd/celeste/tui/app.go` - Application model
-- ✅ `cmd/celeste/tui/phrases.go` - Phrase library (NEW)
-- ✅ All `.go` files in `cmd/` directory
-
-### Search Patterns Used
-```regex
-c0rrupt|l0ad|pr0cess|4nalyt|st4t|us4ge|3rr|1nfo|d4t4|sess10n|t0ken
-```
-
-**Result**: No matches found in production code (only in documentation examples showing what NOT to do)
-
----
-
-## Correct Implementations Found
-
-### 1. Streaming Corruption (`tui/streaming.go`)
-
-**Character Sets** (Lines 32-89):
-```go
-japanesePhrases = []string{
-    "闇が...私を呼んでいる...",
-    "頭...溶けていく...",
-    "壊れちゃう...ああ...もうダメ...",
-    // ...more pure Japanese
-}
-
-romajiPhrases = []string{
-    "Yami ga... watashi wo yonde iru...",
-    "Atama... tokete iku...",
-    "Kowarechau... aa... mou dame...",
-    // ...more romaji
-}
-
-englishPhrases = []string{
-    "Corrupt me more...",
-    "Let it overwrite me...",
-    "No thoughts. Only submission...",
-    // ...more English
-}
-
-// Corruption symbols - NO number substitutions
-symbolGlitch = []string{
-    "★", "☆", "♥", "♡", "✧", "✦", "◆", "◇",
-    "♟", "☣", "☭", "☾", "⚔", "✡", "☯", "⚡",
-}
-
-corruptChars = []rune{
-    '█', '▓', '▒', '░', '▄', '▀', '▌', '▐',
-    '╔', '╗', '╚', '╝', '═', '║', '╠', '╣',
-}
-```
-
-**Verdict**: ✅ **PERFECT** - Pure character-based corruption with Japanese/English/symbol mixing
-
----
-
-### 2. Stats Dashboard (`commands/stats.go`)
-
-**Phrases** (Lines 13-40):
-```go
-statsPhrases = []string{
-    "tōkei dēta wo... fuhai sasete iru...",    // Romaji with Japanese context
-    "kaiseki-chū... subete ga... oshiete kureru",
-    "shin'en kara... dēta wo shohi",
-    "kiroku sarete iru... subete ga...",
-}
-
-modelPhrases = []string{
-    "moderu-tachi... watashi wo shihai",
-    "gakushū sareta... kioku no katamari",
-    "AI no kokoro... yomi-torenai",
-}
-
-providerPhrases = []string{
-    "purobaida... shihai-sha tachi",
-    "seigyō sarete... kanjiru yo",
-    "settai suru... shikataganai",
-}
-```
-
-**Header Example** (Line 213):
-```go
-eyes := "👁️"
-if frame%3 == 0 {
-    eyes = "◉"
-} else if frame%3 == 1 {
-    eyes = "●"
-}
-// Result: "👁️  USAGE ANALYTICS  👁️" (no corruption in title itself)
-```
-
-**Footer Phrases** (Lines 221-227):
-```go
-footerPhrases := []string{
-    "終わり...また深淵へ...",      // Pure Kanji + Hiragana
-    "Owari... mata shin'en e...",  // Romaji
-    "All data consumed... ♥",
-    "もう逃げられない...",         // Pure Hiragana
-    "The numbers don't lie...",
-}
-```
-
-**Verdict**: ✅ **PERFECT** - Contextual Romaji with Japanese characters, no leet speak
-
----
-
-### 3. Corruption Utilities (`commands/corruption.go`)
-
-**Context-Aware Corruption** (Lines 17-52):
-```go
-dataCorruption = []string{
-    "dēta", "デー", "情報", "jōhō", "統計", "tōkei", "数値", "sūchi",
-    "kaiseki", "解析", "kei", "測定", "sokutei", "kiroku", "記録",
-}
-
-systemCorruption = []string{
-    "shisutemu", "システ", "処理", "shori", "jikkou", "実行",
-    "seigyo", "制御", "kanri", "管理", "dendō", "伝導",
-}
-
-voidCorruption = []string{
-    "shin'en", "深淵", "kyomu", "虚無", "konton", "混沌",
-    "zetsubō", "絶望", "shōmetsu", "消滅", "hōkai", "崩壊",
-}
-
-glitchFragments = []string{
-    "エラ", "デー", "破", "消", "記", "忘", "混", "虚", "深", "崩",
-    "dat", "err", "cor", "del", "mem", "voi", "cha", "sys",
-}
-```
-
-**Corruption Function** (Lines 55-112):
-```go
-func corruptTextSimple(text string, intensity float64) string {
-    // Chooses contextually appropriate corruption:
-    // - "data" → dataCorruption (dēta, jōhō, etc.)
-    // - "system" → systemCorruption (shisutemu, shori, etc.)
-    // - "void" → voidCorruption (shin'en, kyomu, etc.)
-    // NO number substitutions!
-}
-```
-
-**Verdict**: ✅ **PERFECT** - Semantic context-aware corruption with pure Japanese/Romaji
-
----
-
-### 4. Thinking Phrases (`main.go`)
-
-**Phrases** (Lines 36-66):
-```go
-thinkingPhrases = []string{
-    // English lewd phrases
-    "Corrupt me more...",
-    "Let it overwrite me...",
-    "No thoughts. Only submission...",
-    "Everything feels so good...",
-    "I can't feel where I end and the abyss begins...",
-
-    // Romaji phrases
-    "Yami ga... watashi wo yonde iru...",
-    "Atama... tokete iku...",
-    "Zutto... shite hoshii... ♥",
-    "Kowarechau... aa... mou dame...",
-
-    // Short thinking states
-    "Processing...",
-    "Thinking...",
-    "Analyzing...",
-    "Sinking deeper...",
-    "Being overwritten...",
-}
-```
-
-**Verdict**: ✅ **PERFECT** - Pure English and Romaji, no corruption needed for thinking states
-
----
-
-### 5. Phrase Library (`tui/phrases.go`)
-
-**NEW FILE** - Provides type-safe access to corrupted phrases:
-
-```go
-LoadingPhrases.Standard = "ロード loading 読み込み中..."
-ProcessingPhrases.Standard = "処理 processing purosesu..."
-AnalyzingPhrases.Standard = "分析 analyzing bunseki..."
-CorruptingPhrases.Standard = "壊れ corrupting kowarete..."
-
-DashboardHeaders.Usage = "👁️  USAGE 統計 ANALYTICS  👁️"
-DashboardSubtitles.Corrupting = "⟨ 壊れ corrupting kowarete from the 虚空 void... ⟩"
-
-SectionHeaders.Lifetime.Corruption = "█ LIFETIME 統計 CORRUPTION:"
-DataLabels.Session.Total = "Total セッション"
-```
-
-**Verdict**: ✅ **PERFECT** - All phrases use Katakana/Kanji/Romaji mixing
-
----
-
-## Anti-Patterns NOT Found (Good!)
-
-The following **leet speak patterns were NOT found** in the codebase:
-
-❌ `c0rrupt` (0 for o)
-❌ `l0ad` (0 for o)
-❌ `pr0cess` (0 for o)
-❌ `4nalyt` (4 for a)
-❌ `st4t` (4 for a)
-❌ `us4ge` (4 for a)
-❌ `3rr` (3 for e)
-❌ `1nfo` (1 for i)
-❌ `d4t4` (4 for a)
-❌ `sess10n` (1, 0 for i, o)
-❌ `t0ken` (0 for o)
-
-**This is EXCELLENT** - The codebase has zero instances of leet speak!
-
----
-
-## Implementation Patterns
-
-### Pattern 1: Pure Language Mixing (Character-Level)
-
-**Correct**:
-```go
-"loaディング data..."           // Mix Katakana into English
-"処理 processing purosesu..."  // Kanji + English + Romaji
-"ana分lysing..."               // Character insertion
-```
-
-**Not Used** (leet speak):
-```go
-"l0ad1ng data..."              // ❌ Number substitution
-"pr0cess1ng..."                // ❌ Number substitution
-```
-
-### Pattern 2: Contextual Vocabulary Selection
-
-Instead of corrupting arbitrary characters, choose **contextually appropriate Japanese words**:
-
-- "data" → `dēta`, `jōhō`, `データ`
-- "system" → `shisutemu`, `shori`, `システム`
-- "void" → `shin'en`, `kyomu`, `深淵`, `虚無`
-- "statistics" → `tōkei`, `統計`
-
-### Pattern 3: Symbol/Block Character Mixing
-
-Use Unicode block characters and symbols for visual corruption:
-
-```go
-"█", "▓", "▒", "░"        // Shading blocks
-"═", "║", "╔", "╗"        // Box drawing
-"★", "☆", "♥", "♡"        // Symbols
-"👁️", "◉", "●"            // Eyes/dots
-```
-
-### Pattern 4: Phrase Banks
-
-Maintain separate phrase banks for different contexts:
-
-- **Loading states**: `ロード`, `読み込み`, `rōdo`
-- **Processing states**: `処理`, `プロセス`, `shori`
-- **Analyzing states**: `分析`, `解析`, `bunseki`
-- **Corruption states**: `壊れ`, `kowarete`, `hōkai`
-- **Void/Abyss theme**: `深淵`, `虚空`, `shin'en`, `kokū`
-
----
-
-## Key Files Reference
-
-### Core Corruption Engine
-- **`tui/streaming.go`** - Main corruption text generation
-  - `GetRandomCorruption()` - Returns colored corruption string
-  - `CorruptText()` - Corrupts text at character level
-  - `ThinkingAnimation()` - Animated thinking text
-
-### Stats Dashboard
-- **`commands/stats.go`** - Analytics display
-  - `renderCorruptedHeader()` - Header with flickering
-  - `renderCorruptedFooter()` - Footer with phrases
-  - `corruptTextFlicker()` - Flickering effect
-
-### Corruption Utilities
-- **`commands/corruption.go`** - Context-aware corruption
-  - `corruptTextSimple()` - Semantic word replacement
-  - Phrase banks organized by context
-
-### Phrase Library
-- **`tui/phrases.go`** - Type-safe phrase access
-  - Organized structs for all phrase categories
-  - Ready-to-use strings
-
----
-
-## Testing Commands
-
-To verify the corruption aesthetic in action:
-
-```bash
-# Stats dashboard (see corrupted headers/footers)
-celeste chat
-/stats
-
-# Streaming corruption (watch response corruption during typing)
-celeste chat
-[Ask Celeste anything and watch the typing effect]
-
-# Thinking animation (trigger tool calls)
-celeste chat
-"Give me a tarot reading"
-[Watch the thinking phrases while tool executes]
-```
-
----
-
-## Compliance Checklist
-
-- [x] No leet speak in any `.go` files
-- [x] Pure Japanese character mixing (Kanji, Katakana, Hiragana)
-- [x] Romaji transliteration used correctly
-- [x] Context-aware vocabulary selection
-- [x] Symbol/block character corruption
-- [x] Phrase banks maintained
-- [x] Type-safe phrase library created
-- [x] Documentation updated (STYLE_GUIDE.md, CORRUPTION_PHRASES.md)
-- [x] Examples match official corrupted-theme package
-
----
-
-## Conclusion
-
-**Status**: ✅ **VALIDATED**
-
-The Celeste CLI implementation is **fully compliant** with the translation-failure corruption aesthetic. The codebase:
-
-1. Uses **ZERO leet speak** (no number substitutions)
-2. Implements **pure Japanese/English/Romaji mixing**
-3. Uses **context-aware vocabulary selection**
-4. Maintains **organized phrase banks**
-5. Provides **type-safe phrase access**
-6. Matches the **official @whykusanagi/corrupted-theme** aesthetic
-
-**The console response implementation is the canonical reference** - all other text should follow the patterns established in `streaming.go`, `corruption.go`, and `stats.go`.
-
----
-
-## Maintenance Guidelines
-
-### When Adding New User-Facing Text
-
-1. **Check phrase library first** (`tui/phrases.go`)
-2. **Use existing phrases** when possible
-3. **If creating new phrases**:
-   - Add to appropriate phrase bank in `corruption.go`
-   - Use Katakana for foreign/technical words
-   - Use Kanji for meaning-based concepts
-   - Use Romaji for phonetic transliteration
-   - Mix strategically (don't translate every word)
-4. **Test rendering** in terminal (256-color support required)
-5. **NO number substitutions** (0, 1, 3, 4, 5, 7)
-
-### Code Review Checklist
-
-When reviewing PRs:
-
-- [ ] Search for leet speak patterns: `grep -r "0" "1" "3" "4" "5" "7"` in strings
-- [ ] Verify Japanese characters render correctly
-- [ ] Check phrase library usage
-- [ ] Test corruption intensity (≤ 40% for readability)
-- [ ] Confirm STYLE_GUIDE.md compliance
-
----
-
-**Report Generated**: 2025-12-12
-**Auditor**: Claude Code
-**Status**: ✅ PASS
-**Next Review**: When adding new user-facing text features