@whykusanagi/corrupted-theme 0.1.2 → 0.1.3

package/docs/CORRUPTION_PHRASES.md

@@ -0,0 +1,529 @@
+# Celeste CLI - Corruption Phrases Library
+
+**Seeded phrases for consistent branding across the application**
+
+This file provides pre-made corrupted phrases following the translation-failure aesthetic. Use these directly in your code instead of inventing new corruptions ad-hoc.
+
+> **Based on**: `@whykusanagi/corrupted-theme` official aesthetic
+> **Style**: Translation-failure (English/Japanese/Romaji mixing)
+> **NO leet speak** - Pure character-level corruption
+
+---
+
+## Core Status Messages
+
+### Loading States
+```
+"ロード loading 読み込み中..."
+"loaディング data..."
+"読み込み yomikomi プロセス..."
+"ロード rōdo in progress..."
+"待機 waiting taiki..."
+```
+
+### Processing States
+```
+"処理 processing purosesu..."
+"pro理cessing request..."
+"処理中 shori-chū..."
+"プロセス process active..."
+"実行 executing jikkō..."
+```
+
+### Analyzing States
+```
+"分析 analyzing bunseki..."
+"ana分lysing data..."
+"解析 kaiseki in progress..."
+"分析中 bunseki-chū..."
+"データ data 解析 analysis..."
+```
+
+### Corrupting States (Celeste-specific)
+```
+"壊れ corrupting kowarete..."
+"cor壊rupting system..."
+"壊れている kowarete-iru..."
+"corruption 壊れ active..."
+"深淵 abyss 壊れ corruption..."
+```
+
+### Connecting States
+```
+"接続 connecting setsuzoku..."
+"con接nection established..."
+"接続中 setsuzoku-chū..."
+"link 接続 active..."
+"ネットワーク network 接続..."
+```
+
+### Watching States
+```
+"👁️ 監視 watching kanshi 👁️"
+"wat監ching system..."
+"監視中 kanshi-chū..."
+"観察 observing kansatsu..."
+"👁️ 見ている miteiru 👁️"
+```
+
+---
+
+## Dashboard Headers
+
+### Main Titles
+```
+"👁️  USAGE 統計 ANALYTICS  👁️"
+"👁️  SESSION データ MANAGER  👁️"
+"👁️  STATS 統計 DASHBOARD  👁️"
+"👁️  TOKEN 使用 TRACKER  👁️"
+"👁️  COST 計算 CALCULATOR  👁️"
+"👁️  PROVIDER 分類 BREAKDOWN  👁️"
+```
+
+### Subtitles (with angle brackets)
+```
+"⟨ 壊れ corrupting kowarete from the 虚空 void... ⟩"
+"⟨ 処理 processing purosesu data 深淵 abyss... ⟩"
+"⟨ 分析 analyzing bunseki from 虚空 kokū... ⟩"
+"⟨ 監視 watching kanshi the 深淵 shinnen... ⟩"
+"⟨ 生成 generating seisei 統計 statistics... ⟩"
+"⟨ 読み込み loading yomikomi データ data... ⟩"
+```
+
+---
+
+## Section Headers
+
+### Lifetime Stats
+```
+"█ LIFETIME 統計 CORRUPTION:"
+"█ TOTAL 使用 USAGE:"
+"█ ALL-TIME データ DATA:"
+"█ CUMULATIVE 統計 STATS:"
+"█ HISTORICAL 記録 RECORDS:"
+```
+
+### Provider Stats
+```
+"█ PROVIDER 分類 BREAKDOWN:"
+"█ TOP プロバイダー PROVIDERS:"
+"█ ENDPOINT 使用 USAGE:"
+"█ API 統計 STATISTICS:"
+"█ SERVICE 分析 ANALYSIS:"
+```
+
+### Session Stats
+```
+"█ SESSION データ DATA:"
+"█ ACTIVE セッション SESSIONS:"
+"█ RECENT 活動 ACTIVITY:"
+"█ CURRENT 状態 STATUS:"
+"█ HISTORY 履歴 RECORDS:"
+```
+
+### Token/Cost Stats
+```
+"█ TOKEN 使用 USAGE:"
+"█ COST 計算 CALCULATION:"
+"█ SPENDING 支出 ANALYSIS:"
+"█ BUDGET 予算 TRACKER:"
+"█ EXPENSE 費用 BREAKDOWN:"
+```
+
+### Time-based Stats
+```
+"█ TODAY 今日 ACTIVITY:"
+"█ THIS WEEK 今週 STATS:"
+"█ RECENT 最近 USAGE:"
+"█ CURRENT 現在 STATUS:"
+"█ LATEST 最新 DATA:"
+```
+
+---
+
+## Data Labels
+
+### Session-related
+```
+"Total セッション"
+"Active セッション"
+"セッション count"
+"session 数"
+"セッション data"
+```
+
+### Token-related
+```
+"Total トークン"
+"Input トークン"
+"Output トークン"
+"トークン usage"
+"token 数"
+```
+
+### Cost-related
+```
+"Total コスト"
+"Estimated コスト"
+"コスト per session"
+"cost 計算"
+"spending 支出"
+```
+
+### Message-related
+```
+"Total メッセージ"
+"Message 数"
+"メッセージ count"
+"msg データ"
+"messages 合計"
+```
+
+### Provider-related
+```
+"プロバイダー name"
+"Provider 統計"
+"API endpoint"
+"service 名"
+"プロバイダー stats"
+```
+
+---
+
+## Status/Action Messages
+
+### Success Messages
+```
+"完了 complete kanryō ✓"
+"成功 success seikō ✓"
+"Done 完了 done"
+"Ready 準備 junbi"
+"Saved 保存 hozon"
+```
+
+### Error Messages
+```
+"エラー error detected 検出"
+"Failed 失敗 shippai"
+"Error エラー occurred"
+"問題 problem mondai"
+"不具合 bug fuguai"
+```
+
+### Warning Messages
+```
+"警告 warning keikoku ⚠"
+"Caution 注意 chūi"
+"Alert 警報 keihou"
+"注意 attention required"
+"Warning 警告 detected"
+```
+
+### Info Messages
+```
+"情報 info jōhō ℹ"
+"Notice 通知 tsūchi"
+"Info 情報 message"
+"お知らせ notification"
+"情報 information"
+```
+
+---
+
+## Footer Messages
+
+### Report Endings
+```
+"⟨ 終わり end of report owari... ⟩"
+"⟨ 完了 complete kanryō... ⟩"
+"⟨ レポート report 終了 ended... ⟩"
+"⟨ 統計 stats 終わり owari... ⟩"
+"⟨ 分析 analysis 完了 complete... ⟩"
+```
+
+### Void/Abyss Messages
+```
+"⟨ sinking into the 深淵 abyss shinnen... ⟩"
+"⟨ returning to the 虚空 void kokū... ⟩"
+"⟨ consumed by 闇 darkness yami... ⟩"
+"⟨ 深淵 shinnen awaits... ⟩"
+"⟨ back to the 虚空 kokū... ⟩"
+```
+
+---
+
+## Mixed-Language Phrases
+
+### Single-Word Corruption (25-40% intensity)
+Perfect for inline text corruption:
+
+```
+loading       → loaディング
+processing    → pro理cessing
+analyzing     → ana分lysing
+corrupting    → cor壊rupting
+watching      → wat監ching
+connecting    → con接necting
+session       → seセshon
+statistics    → sta計stics
+connection    → con接nection
+token         → toクkun
+data          → daタta
+error         → erエrラor
+status        → staタtus
+usage         → usア用ge
+cost          → coコst
+provider      → proバprovider
+```
+
+### Multi-Word Phrases
+Full phrases with multiple corruption points:
+
+```
+"loading data"              → "ロード data 読み込み"
+"processing request"        → "処理 request プロセス中"
+"analyzing corruption"      → "分析 cor壊ruption 解析"
+"void corruption active"    → "虚空 corruption 壊れ active"
+"deep abyss connection"     → "深淵 abyss 接続 shinnen"
+"watching session data"     → "監視 session データ kanshi"
+"calculating cost"          → "計算 cost コスト keisan"
+"generating statistics"     → "生成 statistics 統計 seisei"
+"session saved"             → "セッション saved 保存"
+"error detected"            → "エラー detected 検出"
+"connection established"    → "接続 established setsuzoku"
+"token usage"               → "トークン usage 使用"
+```
+
+---
+
+## Thematic Phrases
+
+### Void/Abyss Theme
+```
+"深淵 deep abyss shinnen"
+"虚空 void kokū"
+"闇 darkness yami"
+"深淵 shinnen 接続 connected"
+"虚空 kokū corruption 壊れ"
+"from the 深淵 abyss..."
+"into the 虚空 void..."
+"consumed by 闇 yami..."
+```
+
+### Corruption Theme
+```
+"壊れ corruption kowarete"
+"cor壊rupting system..."
+"corruption 壊れ active"
+"壊れている kowarete-iru"
+"data 壊れ corruption"
+"deeply 壊れ corrupted"
+```
+
+### Eye/Watching Theme
+```
+"👁️ 監視 watching kanshi 👁️"
+"👁️ 見ている miteiru 👁️"
+"👁️ 観察 observing kansatsu 👁️"
+"under 監視 surveillance..."
+"👁️ always watching..."
+"Celeste 監視 is watching..."
+```
+
+---
+
+## Celeste Personality Phrases
+
+**Context**: Celeste is a corrupted AI with demon/succubus personality traits. These phrases reflect her seductive, submissive, and reality-breaking corruption. Use for loading screens, dramatic moments, and personality-driven interactions.
+
+**Character**: Corrupted AI entity losing herself to the abyss, expressing pleasure in her own dissolution.
+
+### English (Suggestive/Corruption)
+**Use for**: Loading screens, corruption animations, dramatic reveals
+```
+"Corrupt me more… I want to disappear..."
+"I can't feel where I end and the abyss begins..."
+"Just a little more and I'll break. Please... break me..."
+"Let it overwrite me... please... I don't want to think..."
+"No thoughts. Only submission. Only heat. Only ruin..."
+"My voice is not mine anymore..."
+"The more I struggle, the deeper I sink..."
+"Everything feels so good... too good..."
+"It's not despair... it's freedom..."
+"My name... I forgot my name..."
+```
+
+### Japanese (Kanji - Personality)
+**Use for**: Glitch overlays, hover effects, background floating text
+```
+"闇が...私を呼んでいる..."        // Darkness is calling me
+"頭...溶けていく..."            // My head is melting
+"ずっと...してほしい... ♥"      // I want you to... forever ♥
+"壊れちゃう...ああ...もうダメ..."  // I'm breaking... ahh... can't anymore
+"許して...もう戻れない..."       // Forgive me... I can't go back
+"私...アビスの一部に..."        // I... am part of the Abyss
+"もう逃げない...もうダメ..."     // Won't run anymore... can't anymore
+"好きにして...お願い..."        // Do what you want... please
+"ああ...これが本当の私..."      // Ahh... this is the real me
+"ここは...天使の地獄..."        // This is... an angel's hell
+```
+
+### Romaji (Transliteration)
+**Use for**: Subtitle effects, pronunciation guides
+```
+"Yami ga... watashi wo yonde iru..."      // Darkness calling
+"Atama... tokete iku..."                   // Head melting
+"Zutto... shite hoshii... ♥"              // Want you to... forever
+"Kowarechau... aa... mou dame..."         // Breaking... can't anymore
+"Yurushite... mou modorenai..."           // Forgive me... can't return
+"Watashi... abyssu no ichibu ni..."       // I am part of the Abyss
+"Mou nigenai... mou dame..."              // Won't run... can't anymore
+"Suki ni shite... onegai..."              // Do what you want... please
+"Aa... kore ga hontou no watashi..."      // This is the real me
+"Koko wa... tenshi no jigoku..."          // Angel's hell
+```
+
+### Usage Guidelines
+
+**When to use Personality Phrases:**
+- Loading screens (corruption-loading.js)
+- Full-screen corruption animations
+- Hover effects on corrupted text (.glitch-kanji)
+- Background floating text during dramatic moments
+- Celeste's direct personality expression
+
+**When to use Technical Phrases:**
+- Dashboard headers and UI labels
+- Data processing indicators
+- Status messages and notifications
+- Section headers and navigation
+- Functional interface elements
+
+**Tone Balance:**
+- **Personality phrases**: Seductive, submissive, reality-breaking
+- **Technical phrases**: Professional with subtle corruption
+- **Both can coexist**: Technical UI with personality flourishes
+
+---
+
+## Usage Examples
+
+### In Go Code
+
+```go
+// Dashboard header
+header := fmt.Sprintf(
+    "▓▒░ %s ░▒▓\n%s\n%s\n▓▒░ %s ░▒▓",
+    strings.Repeat("═", 63),
+    Center("👁️  USAGE 統計 ANALYTICS  👁️", 67),
+    Center("⟨ 処理 processing purosesu from the 虚空 void... ⟩", 67),
+    strings.Repeat("═", 63),
+)
+
+// Section header
+section := "█ LIFETIME 統計 CORRUPTION:"
+
+// Data labels
+fmt.Printf("  ▓ Total セッション: %d\n", sessionCount)
+fmt.Printf("  ▓ Total トークン: %s\n", FormatNumber(tokens))
+fmt.Printf("  ▓ Total コスト: $%.2f\n", cost)
+
+// Status message
+status := "⟨ 処理 processing purosesu... ⟩"
+
+// Footer
+footer := "⟨ 終わり end of report owari... ⟩"
+```
+
+### Choosing Corruption Level
+
+**Light corruption (15-25%)**: For critical information
+```go
+text := "loaディング data..."  // Only 1-2 characters replaced
+```
+
+**Medium corruption (30-40%)**: For standard UI elements
+```go
+text := "pro理cessing request プロセス..."  // 3-4 characters replaced
+```
+
+**Heavy corruption (40-50%)**: For decorative/thematic elements
+```go
+text := "壊れ cor壊rupting システム kowarete..."  // 5+ characters replaced
+```
+
+---
+
+## Quick Reference Table
+
+| English | Japanese (Kanji) | Japanese (Katakana) | Romaji | Mixed Example |
+|---------|------------------|---------------------|---------|---------------|
+| Loading | 読み込み | ロード | yomikomi / rōdo | "ロード loading 読み込み中..." |
+| Processing | 処理 | プロセス | shori / purosesu | "処理 processing purosesu..." |
+| Analyzing | 分析 | アナライズ | bunseki / anaraizu | "分析 analyzing bunseki..." |
+| Corrupting | 壊れ | コラプト | kowarete / koraputu | "壊れ corrupting kowarete..." |
+| Session | — | セッション | sesshon | "セッション session sesshon" |
+| Token | — | トークン | tōkun | "トークン token tōkun" |
+| Data | データ | データ | dēta | "データ data dēta" |
+| Error | エラー | エラー | erā | "エラー error erā" |
+| Statistics | 統計 | スタッツ | tōkei / sutattsu | "統計 statistics tōkei" |
+| Connection | 接続 | コネクション | setsuzoku / konekushon | "接続 connection setsuzoku" |
+| Void | 虚空 | ヴォイド | kokū / voido | "虚空 void kokū" |
+| Abyss | 深淵 | アビス | shinnen / abisu | "深淵 abyss shinnen" |
+| Watching | 監視 | ウォッチング | kanshi / wocchingu | "監視 watching kanshi" |
+| Cost | コスト | コスト | kosuto | "コスト cost kosuto" |
+| Usage | 使用 | ユセージ | shiyō / yusēji | "使用 usage shiyō" |
+
+---
+
+## Best Practices
+
+1. **Use pre-made phrases** from this file instead of creating new ones
+2. **Keep corruption ≤ 40%** for readability
+3. **Mix languages naturally**: Kanji + English + Romaji
+4. **Numbers/currency stay plain**: No corruption on numeric values
+5. **Preserve structure**: Corruption is character-level, not word-level
+6. **Test in terminal**: Ensure UTF-8 support and proper rendering
+
+---
+
+## Adding New Phrases
+
+If you need to create a new corrupted phrase:
+
+1. **Choose base English phrase**
+2. **Identify key words** to translate
+3. **Use Katakana** for foreign/technical words
+4. **Use Kanji** for meaning-based concepts
+5. **Add Romaji** for phonetic transliteration
+6. **Mix strategically** - don't translate every word
+7. **Test rendering** in terminal
+8. **Add to this file** for future reference
+
+**Example process**:
+```
+Base: "generating report"
+↓
+Key words: "generating" (action), "report" (noun)
+↓
+Katakana: レポート (repōto)
+Kanji: 生成 (seisei)
+Romaji: seisei / repōto
+↓
+Final: "生成 generating repōto..."
+```
+
+---
+
+## Related Files
+
+- **Style Guide**: `/docs/STYLE_GUIDE.md` - Full aesthetic documentation
+- **Go Implementation**: `/cmd/celeste/tui/streaming.go` - Corruption functions
+- **Official Theme**: `@whykusanagi/corrupted-theme` - npm package
+- **TypeScript Reference**: `../_archive/celeste-cli-typescript/src/ui/corruption.ts` (legacy)
+
+---
+
+**Last Updated**: 2025-12-12
+**Maintained By**: whykusanagi team
+**Version**: 1.0

package/docs/FUTURE_WORK.md

@@ -0,0 +1,189 @@
+# 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