@anh3d0nic/qwen-code-termux-ice 16.0.8 → 20.0.0

package/README.md

@@ -1,147 +1,238 @@
-# @anh3d0nic/qwen-code-termux-ice v12.0.0
+# Qwen Code ICE v20
 
-Unified Pipeline + Auto-Run Loop for Termux AI coding.
+Termux-optimized Qwen Code CLI with ICE (Intelligent Compounding Environment) — pattern learning, quality scoring, and session persistence.
 
 ## Installation
 
 ```bash
-npm install -g @anh3d0nic/qwen-code-termux-ice@latest
+npm install -g @anh3d0nic/qwen-code-termux-ice
 ```
 
-## Pipeline Diagram
+## Quick Start
 
-```
-userInput
-  → IntentLadder.classify() — decode surface/real/deep intent
-  → ConfidenceGating.assess() — decide response mode
-  → ActiveContextEngine.update() — add context block
-  → [generate response based on intent]
-  → SelfCritiqueLoop.process() — 7 questions, attack, fix
-  → CodeQualityGate.check() — if code in response
-  → AutoRunLoop.exec() — if code block found, run it (3 retries)
-  → DomainMemory.addPattern() — learn from this interaction
-  → send final response
-```
+```bash
+# Interactive mode
+qwen-ice
 
-## Usage
+# Single query
+qwen-ice "fix sudo error"
 
-### Run Unified Pipeline
+# YOLO mode (auto-approve actions)
+qwen-ice -y "npm install"
 
-```bash
-ice-v12 "fix sudo error"
+# Check version
+qwen-ice --version
 ```
 
-**What happens:**
-1. Analyzes intent (SURFACE/REAL/DEEP)
-2. Assesses confidence level
-3. Updates active context
-4. Generates response
-5. Self-critique (7 questions)
-6. Code quality check (if code present)
-7. Auto-run code (if code block present, 3 retries)
-8. Saves pattern to domain memory
+## CLI Commands
+
+### bin/qwen-ice
+
+| Command | Description |
+|---------|-------------|
+| `qwen-ice` | Interactive mode |
+| `qwen-ice "query"` | Single query |
+| `qwen-ice --version` | Show version |
+| `qwen-ice --help` | Show help |
+| `qwen-ice --status` | Show pipeline status |
+| `qwen-ice -y "query"` | YOLO mode (auto-approve) |
+| `qwen-ice --model groq` | Use specific model |
+| `qwen-ice api-setup` | Configure API keys |
+| `qwen-ice reset` | Clear memory (keep API keys) |
+| `qwen-ice uninstall` | Clean uninstall |
+
+### bin/qwen-ice-api-setup
+
+Interactive API key manager:
+- Add/view/remove API keys
+- Test API connectivity
+- Configure fallback order
 
-**Failure behavior:**
-- If auto-run fails 3 times: Adds warning to response
-- If confidence <60%: Shows UNCERTAIN level
-- If no pattern match: Returns generic intent
+## ICE Features (Implemented)
 
-### Parallel Task Splitter
+### 1. Pattern Prevention (`preventPatterns`)
 
+Automatically fixes Termux-incompatible commands before execution:
+
+- Strips `sudo` (not available in Termux)
+- Replaces `/usr/bin/` → `$PREFIX/bin/`
+- Replaces `apt-get` → `pkg`
+
+**Example:**
 ```bash
-ice-v12 parallel "build login page"
+qwen-ice "sudo apt-get install python"
+# Auto-converts to: "pkg install python"
+```
+
+### 2. Intent Analysis (`analyzeIntent`)
+
+Decodes user intent at three levels:
+- **Surface**: What was typed
+- **Real**: What user needs
+- **Deep**: Underlying goal
+
+**Output:**
+```
+🎯 Intent: "fix error" → working solution → stable production code
 ```
 
-**What happens:** Detects 4 independent parts, executes via Promise.all()
+### 3. Session Memory
 
-**Failure behavior:** Returns atomic task if no parts detected
+Persists across sessions:
+- `~/.qwen-ice/memory/session_memory.json` — Learned patterns
+- `~/.qwen-ice/memory/quality_history.json` — Quality scores
+- `~/.qwen-ice/memory/session_summary.json` — Session stats
 
-### Initialize Config
+### 4. Quality Scoring (`scoreResponse`)
 
-```bash
-ice-v12 init
+Scores each response 1-10 based on:
+- Code execution success (+3)
+- Brevity under 200 tokens (+1)
+- Termux compatibility (+1)
+- Self-critique passed (+1)
+
+**Output:**
+```
+📊 Quality Score: 9/10
 ```
 
-**What happens:** Creates ~/.qwen/*.json config files
+### 5. Cold Start Welcome (`showColdStartWelcome`)
 
-**Failure behavior:** Creates directory if missing
+Shows session stats on startup:
+```
+❄️  Qwen Code ICE v20
+📊 Last: 42 queries, 8.5/10 | 🧠 15 patterns
+```
 
-## Self-Critique (7 Questions)
+### 6. Session Summary (`saveSessionSummary`)
 
-1. What is wrong with this?
-2. What did I miss?
-3. Will this break on Termux?
-4. Is this the shortest correct solution?
-5. Am I answering what they actually want, not what they typed?
-6. Does this have any hardcoded paths that break on mobile?
-7. Would a senior dev approve this?
+On exit, displays:
+```
+📊 SESSION SUMMARY
+   Total queries: 42
+   Avg quality: 8.5/10
+   Patterns learned: 15
+   Errors fixed: 8
+   Top intent: stable production code
+```
 
-## Auto-Run Loop
+## Directory Structure
 
-When response contains code block:
-- Extracts code
-- Runs with `child_process.execSync()` (Termux paths)
-- If exit code != 0: Feeds error back, max 3 retries
-- Only sends response after code runs successfully
-- If all 3 retries fail: Adds explicit warning
+After installation:
+```
+~/.qwen-ice/
+├── bin/
+│   ├── qwen-ice
+│   └── qwen-ice-api-setup
+├── core/
+│   ├── ice-v13.js
+│   ├── ice-v14.js
+│   ├── ice-v15.js
+│   ├── ice-v16.js
+│   ├── install.js
+│   └── uninstall.js
+├── config/
+│   ├── api-keys.json
+│   └── settings.json
+├── memory/
+│   ├── session_memory.json
+│   ├── quality_history.json
+│   ├── confidence_history.json
+│   └── session_summary.json
+├── sessions/
+└── logs/
+    ├── errors.log
+    └── yolo.log
+```
 
 ## Configuration Files
 
-| File | Location | Created |
-|------|----------|---------|
-| Session | `~/.qwen/ice_session.json` | On first pipeline run |
-| Active Context | `~/.qwen/ice_active_context.json` | On first pipeline run |
-| Domain Memory | `~/.qwen/session_memory.json` | On first pipeline run |
-| Confidence History | `~/.qwen/confidence_history.json` | On first confidence gate |
-| Manifest | `~/.qwen/v12_manifest.json` | On `ice-v12 init` |
+### ~/.qwen-ice/config/api-keys.json
+
+```json
+{
+  "keys": [
+    {
+      "id": "qwen-oauth",
+      "provider": "qwen",
+      "type": "oauth",
+      "model": "qwen3-coder-plus",
+      "active": true
+    }
+  ],
+  "default_provider": "qwen",
+  "fallback_order": ["qwen", "gemini", "groq", "openai", "dashscope"]
+}
+```
+
+### ~/.qwen-ice/config/settings.json
+
+```json
+{
+  "version": "20.0.0",
+  "theme": "default",
+  "yolo_mode": false,
+  "auto_approve_commands": [],
+  "max_context_length": 8192,
+  "quality_threshold": 5
+}
+```
+
+## TypeScript CLI (packages/cli)
 
-## Package Info
+Built TypeScript version with ICE injection:
 
-- **Version:** 12.0.0
-- **License:** MIT
-- **Dependencies:** None
-- **Binaries:** qwen-code-ice, qwen-ice, ice-v12
+```bash
+cd packages/cli
+npm run build
+node dist/index.js --version
+# 17.0.0-ice
+```
 
-## Changelog
+### ICE Injection Points
 
-### v12.0.0 (2026-03-21)
+1. **Startup** — `showColdStartWelcome()`
+2. **Pre-API** — `preventPatterns(input)`
+3. **Pre-API** — `analyzeIntent(enhancedQuery)`
+4. **Post-response** — ICE logging
+5. **Exit** — `saveSessionSummary()`
 
-**STEP 1 — PIPELINE AUDIT**
-- Found all 19 features from v11 were DISCONNECTED
-- Each CLI case called ONE feature independently
-- 7 features marked as DISCONNECTED (never in response flow)
+## API Providers
 
-**STEP 2 — WIRE THE PIPELINE**
-- Created `UnifiedPipeline` class
-- Connected: IntentLadder → ConfidenceGating → ActiveContext → Generate → SelfCritique → CodeQualityGate → AutoRunLoop → DomainMemory
-- All 10 core features now called in sequence
+| Provider | Default Model | Key Prefix |
+|----------|---------------|------------|
+| qwen (OAuth) | qwen3-coder-plus | N/A |
+| groq | llama-3.1-70b-versatile | gsk_ |
+| gemini | gemini-2.0-flash | AIza |
+| openai | gpt-4o | sk- |
+| dashscope | qwen-turbo | sk- |
 
-**STEP 3 — REMOVE DEAD CODE**
-- Discarded: hexToRgb, applyTheme, formatDesktopResponse, demo* functions
-- Reason: Cosmetic only or replaced by pipeline
+## Scripts
 
-**STEP 4 — STRENGTHEN SELF-CRITIQUE**
-- Expanded from 2 questions to 7 questions
-- Added: Termux compatibility, shortest solution, actual intent, hardcoded paths, senior dev approval
+| Script | Purpose |
+|--------|---------|
+| `scripts/postinstall.cjs` | Auto-installs to ~/.qwen-ice |
+| `scripts/api-caller.js` | Qwen/Gemini/Groq API client |
+| `core/install.js` | Postinstall script |
+| `core/uninstall.js` | Preuninstall script |
 
-**STEP 5 — ADD AUTO-RUN LOOP**
-- New `AutoRunLoop` class
-- Extracts code blocks, runs with execSync()
-- 3 retries on failure
-- Adds warning if all retries fail
+## Termux Compatibility
 
-**STEP 6 — UPDATE MANIFEST**
-- Created v12_manifest.json
-- Removed dead code entries
-- Added pipeline diagram
-- Added auto-run loop entry
+All commands are Termux-aware:
+- No sudo/root required
+- Uses `pkg` instead of `apt-get`
+- Paths use `$PREFIX` (`/data/data/com.termux/files/usr`)
+- ARM64 architecture only
 
-### v11.0.0 (2026-03-21)
+## Uninstall
 
-Complete audit - all 19 features preserved, no code changes from v10.0.0.
+```bash
+qwen-ice uninstall
+# Or manually:
+npm uninstall -g @anh3d0nic/qwen-code-termux-ice
+rm -rf ~/.qwen-ice
+```
 
-## Repository
+## License
 
-- **Source:** https://github.com/anh3d0nic/qwen-code-termux-ice
-- **npm:** https://www.npmjs.com/package/@anh3d0nic/qwen-code-termux-ice
-- **Manifest:** `~/.qwen/v12_manifest.json`
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anh3d0nic/qwen-code-termux-ice",
-  "version": "16.0.8",
+  "version": "20.0.0",
   "description": "Qwen Code ICE v16.0.5 — Compounding Intelligence with proper npm install structure",
   "main": "core/ice-v16.js",
   "bin": {