-init-

ARCHITECTURE.md

@@ -0,0 +1,72 @@
+User Input (Tab×2 or CLI)
+↓
+┌───────────────────────────────────────┐
+│ Entry Points                          │
+├───────────────────────────────────────┤
+│ • _finishsh() - Tab completion        │
+│ • command_command() - CLI mode        │
+└───────────────┬───────────────────────┘
+↓
+┌───────────────────────────────────────┐
+│ Configuration Layer                   │
+├───────────────────────────────────────┤
+│ acsh_load_config()                    │
+│ • Read ~/.finish/config               │
+│ • Set ACSH_PROVIDER, ACSH_ENDPOINT    │
+│ • Set ACSH_ACTIVE_API_KEY (if needed) │
+└───────────────┬───────────────────────┘
+↓
+┌───────────────────────────────────────┐
+│ Cache Layer                           │
+├───────────────────────────────────────┤
+│ • Check cache_dir/acsh-{hash}.txt     │
+│ • Return cached completions if exists │
+└───────────────┬───────────────────────┘
+↓ (cache miss)
+┌───────────────────────────────────────┐
+│ Context Builder                       │
+├───────────────────────────────────────┤
+│ _build_prompt()                       │
+│ • Command history (sanitized)         │
+│ • Terminal info (env vars, cwd)       │
+│ • Recent files (ls -ld)               │
+│ • Help message (cmd --help)           │
+└───────────────┬───────────────────────┘
+↓
+┌───────────────────────────────────────┐
+│ Payload Builder                       │
+├───────────────────────────────────────┤
+│ _build_payload()                      │
+│ • Format: {model, messages, temp}     │
+│ • Provider-specific options:          │
+│   - Ollama: {format:"json"}           │
+│   - LMStudio: {stream:true}           │
+│   - OpenAI: {response_format}         │
+└───────────────┬───────────────────────┘
+↓
+┌───────────────────────────────────────┐
+│ LLM Provider Layer                    │
+├───────────────────────────────────────┤
+│ openai_completion()                   │
+│ • curl to endpoint                    │
+│ • Ollama: no auth header              │
+│ • Others: Authorization header if key │
+│ • Parse response (JSON/streaming)     │
+└───────────────┬───────────────────────┘
+↓
+┌───────────────────────────────────────┐
+│ Response Parser                       │
+├───────────────────────────────────────┤
+│ • Extract completions array           │
+│ • Fallback parsing for non-JSON      │
+│ • Filter command-like lines           │
+└───────────────┬───────────────────────┘
+↓
+┌───────────────────────────────────────┐
+│ Output Layer                          │
+├───────────────────────────────────────┤
+│ • Write to cache                      │
+│ • Log usage (tokens, cost)            │
+│ • Return COMPREPLY array (completion) │
+│ • or stdout (CLI mode)                │
+└───────────────────────────────────────┘