winter-super-cli 2026.6.10 → 2026.6.12

package/README.md

@@ -2,17 +2,16 @@
 
 > **Winter** is a powerful, AI-driven CLI coding assistant designed to supercharge your development workflow directly from the terminal. Inspired by Claude Code and Codex CLI, Winter brings a beautiful Cyberpunk aesthetic, smart session management, autonomous agent capabilities, and 25+ AI tools to your local environment.
 >
-> *Winter la mot tro ly lap trinh CLI manh me duoc dieu khien boi AI, giup tang toc quy trinh phat trien truc tiep tu terminal. Lay cam hung tu Claude Code va Codex CLI, Winter mang den giao dien Cyberpunk dep mat, quan ly phien lam viec thong minh, kha nang agent tu tri, va hon 25 cong cu AI.*
+> *Winter là một trợ lý lập trình CLI mạnh mẽ được điều khiển bởi AI, giúp tăng tốc quy trình phát triển trực tiếp từ terminal. Lấy cảm hứng từ Claude Code và Codex CLI, Winter mang đến giao diện Cyberpunk đẹp mắt, quản lý phiên làm việc thông minh, khả năng agent tự trị, và hơn 25 công cụ AI.*
 
 ---
 
 ## Key Features
 
 | Feature | Description |
-|---|---|
+|---------|-------------|
 | **26 AI Tools** | Read, Write, Edit, Bash, Glob, Grep, Notebook, Todo, Scheduler, Agent, MCP & more |
 | **Multi-Provider** | Anthropic, OpenAI, Ollama, Groq -- with **smart context routing** |
-| **26 Tools** | Full parity with Claude Code + extra tools (WebArchive, HtmlEffectiveness, Notebook, Todo, Scheduler, InsertText, StrReplaceAll) |
 | **Context Router** | Auto-selects best provider per task (Claude for code, OpenAI for docs, Groq for speed, Ollama for privacy) |
 | **Session Management** | Isolated sessions with persistent memory, plans, and context |
 | **MCP Support** | Model Context Protocol -- connect VS Code, GitHub, databases & more |
@@ -30,20 +29,22 @@
 | **Clipboard Integration** | `/paste` command reads clipboard directly |
 | **Image Support** | Analyze images & screenshots via `/image` |
 | **Cross-Platform** | Windows, macOS, Linux -- full shell support |
+| **Codebase Index** | Fast semantic search with optional CodeGraph integration |
+| **Embedded Context Corpus** | Built-in knowledge base from 7,900+ embedded documents |
 
 ---
 
 ## Project Stats
 
 | Metric | Value |
-|---|---|
-| **Total Lines of Code** | ~13,500 |
-| **Source Files** | 40+ |
+|--------|-------|
+| **Total Source Files** | 125 |
+| **Source Lines of Code** | 26,080 |
+| **Source Code Size** | ~1 MB |
 | **Tools** | **26** |
-| **Tests** | **213** (all passing) |
-| **Exported Symbols** | 78 |
-| **AI Providers** | 4 (Anthropic, OpenAI, Ollama, Groq) |
 | **Slash Commands** | 50+ |
+| **AI Providers** | 4 (Anthropic, OpenAI, Ollama, Groq) |
+| **Bundled Resources** | 8,578 files (design guides, agent docs, karpathy tools, page agents) |
 | **Node.js** | >= 18.0.0 |
 
 ---
@@ -99,7 +100,7 @@ winter chat "explain this" --no-interactive
 Winter supports **4 AI providers** with automatic context routing:
 
 | Provider | Config Key | Default Model | Best For |
-|---|---|---|---|
+|----------|------------|---------------|----------|
 | **Anthropic** | `anthropic` | `claude-sonnet-4-20250514` | Code review, refactoring, debugging |
 | **OpenAI** | `openai` | `gpt-4-turbo` | Documentation, explanations |
 | **Ollama** (local) | `ollama` | `llama3` | Privacy, offline use |
@@ -228,7 +229,7 @@ GROQ_API_KEY=gsk-...
 Winter provides **26 tools** -- fully compatible with Claude Code's tool interface + extras:
 
 | # | Tool | Description |
-|---|---|---|
+|----|------|-------------|
 | 1 | **Read** | Read files with line numbers |
 | 2 | **Write** | Create new files |
 | 3 | **Edit** | Surgical string replacement (search & replace) |
@@ -272,12 +273,51 @@ Grep tool supports:
 
 ---
 
+## Bundled Resources
+
+Winter ships with **7 integrated resource corpora** (8,578 files total):
+
+| Resource | Files | Size | Description |
+|----------|-------|------|-------------|
+| **codex** | 206 | 116 MB | Codex CLI documentation & examples |
+| **page-agent** | 239 | - | Alibaba GUI agent framework |
+| **awesome-design-md** | 142 | 14 MB | 71 design systems (Airbnb, Apple, BMW, Claude, Coinbase, Cursor, Figma...) |
+| **claude** | 795 | 3 MB | Claude Code prompts & patterns |
+| **agents.md** | 62 | 2 MB | Agent documentation & examples |
+| **karpathy-tools** | 2 | 1.3 MB | Karpathy's coding principles (Think Before Coding, Simplicity First, Surgical Changes, Goal-Driven Execution) |
+| **ecc** | 7,932 | - | Embedded Context Corpus - searchable knowledge base |
+
+### Resource Commands
+
+```bash
+# Browse karpathy-tools
+/karpathy
+
+# Browse codex resources
+/codex
+
+# Browse claude resources
+/claude
+
+# Browse agents.md
+/agents
+
+# Show all bundled resources
+/resources
+
+# Search ECC (Embedded Context Corpus)
+winter ecc search "error handling"
+winter ecc browse skills/error-handling
+```
+
+---
+
 ## Slash Commands
 
 ### Project & Session
 
 | Command | Description |
-|---|---|
+|---------|-------------|
 | `/project` | Show/set current project |
 | `/pwd` | Show current directory |
 | `/cd <path>` | Change directory |
@@ -288,7 +328,7 @@ Grep tool supports:
 ### Memory & Plans
 
 | Command | Description |
-|---|---|
+|---------|-------------|
 | `/remember <text>` | Store in memory |
 | `/memories` | Show stored memories |
 | `/forget [pattern]` | Clear memories |
@@ -301,7 +341,7 @@ Grep tool supports:
 ### Git & Automation
 
 | Command | Description |
-|---|---|
+|---------|-------------|
 | `/commit` | Auto-generate commit message & commit |
 | `/review` | AI code review on current diff |
 | `/diff` | Preview git diff |
@@ -316,7 +356,7 @@ Grep tool supports:
 ### Tool Shortcuts
 
 | Command | Description |
-|---|---|
+|---------|-------------|
 | `/read <file>` | Quick file read |
 | `/write <file>` | Quick file write (via editor) |
 | `/edit <file>` | Quick file edit |
@@ -329,7 +369,7 @@ Grep tool supports:
 ### Resources & Design
 
 | Command | Description |
-|---|---|
+|---------|-------------|
 | `/codex` | Browse ~/.codex resources |
 | `/claude` | Browse ~/.claude resources |
 | `/karpathy` | Browse karpathy-tools |
@@ -340,6 +380,8 @@ Grep tool supports:
 | `/design add <brand>` | Add design system |
 | `/design list` | List design systems |
 | `/design preview <brand>` | Preview design system |
+| `/ecc search <query>` | Search Embedded Context Corpus |
+| `/ecc browse <path>` | Browse ECC section |
 | `/skill list` | List skills |
 | `/skill enable <name>` | Enable a skill |
 | `/skill create <name>` | Create a custom skill |
@@ -349,7 +391,7 @@ Grep tool supports:
 ### Provider & Config
 
 | Command | Description |
-|---|---|
+|---------|-------------|
 | `/provider [name]` | Show/switch provider |
 | `/providers` | List all providers |
 | `/model [id]` | Show/set model |
@@ -364,7 +406,7 @@ Grep tool supports:
 ### Help & Exit
 
 | Command | Description |
-|---|---|
+|---------|-------------|
 | `/help` or `/?` | Show help |
 | `/exit` or `/quit` | Exit Winter |
 
@@ -415,8 +457,8 @@ Tools with the `mcp__` prefix are automatically routed to the appropriate MCP se
 
 ```
 mcp__vscode__openFile  ->  VS Code extension server
-mcp__github__createPR  ->  GitHub integration server
-mcp__db__query         ->  Database server
+mcp__github__createPR ->  GitHub integration server
+mcp__db__query        ->  Database server
 ```
 
 ---
@@ -443,7 +485,7 @@ winter session list      # List all sessions
 ### Three-Tier Memory System
 
 | Level | Scope | Purpose |
-|---|---|---|
+|-------|-------|---------|
 | **Working Memory** | Current session | Task context, conversation history |
 | **Project Memory** | Project-wide | Project-specific learnings & rules |
 | **Long-term Memory** | Cross-project | Reusable patterns & knowledge |
@@ -457,7 +499,7 @@ Winter supports hot-reloadable skills for specialized tasks.
 ### Built-in Skills
 
 | Skill | Description |
-|---|---|
+|-------|-------------|
 | `coding` | Code analysis, generation, review |
 | `design` | Design system integration |
 | `debug` | Debugging assistance |
@@ -493,6 +535,31 @@ winter plugin remove <name>            # Remove plugin
 
 ---
 
+## Embedded Context Corpus (ECC)
+
+Winter includes a **searchable knowledge base** with 7,932 embedded documents covering:
+
+- Error handling patterns
+- Testing strategies
+- Security best practices
+- Performance optimization
+- And more...
+
+### ECC Commands
+
+```bash
+# Search the corpus
+winter ecc search "error handling"
+winter ecc search "async await best practices"
+
+# Browse sections
+winter ecc browse skills
+winter ecc browse skills/error-handling
+winter ecc browse testing/patterns
+```
+
+---
+
 ## Architecture
 
 ```
@@ -502,52 +569,69 @@ winter/
 |- src/
 |   |- agent/
 |   |   - swe-agent.js       # SWE-agent integration
+|   |   - runtime.js         # Agent runtime
+|   |   - agent-definitions.js
 |   |- ai/
 |   |   - providers.js       # AI provider management + streaming
+|   |   - orchestrator.js   # AI orchestration
+|   |   - reasoning.js       # Reasoning patterns
+|   |   - small-model-amplifier.js
+|   |   - workflow-selector.js
 |   |- cache/
-|   |   - system.js          # Caching layer
+|   |   - system.js         # Caching layer
+|   |   - embeddings.js     # Embedding cache
 |   |- cli/
-|   |   - commands.js        # CLI command parser (50+ commands)
-|   |   - config.js          # Config loader + secret management
-|   |   - conversation-format.js  # Utility functions
-|   |   - markdown-format.js # Markdown rendering
-|   |   - prompt-builder.js  # System prompt assembly
-|   |   - repl-commands.js   # Slash command handlers (extracted)
-|   |   - repl.js            # Interactive REPL loop
-|   |   - secret-env.js      # Env file loader + redaction
-|   |   - slash-commands.js  # Command definitions
-|   |   - snowflake-logo.js  # Cyberpunk UI branding
-|   |   - spinner.js         # Terminal spinner
-|   |   - terminal-ui.js     # Terminal rendering utilities
+|   |   - commands.js       # CLI command parser (50+ commands)
+|   |   - config.js         # Config loader + secret management
+|   |   - conversation-format.js
+|   |   - markdown-format.js
+|   |   - prompt-builder.js
+|   |   - repl-commands.js
+|   |   - repl.js           # Interactive REPL loop
+|   |   - secret-env.js     # Env file loader + redaction
+|   |   - slash-commands.js
+|   |   - snowflake-logo.js # Cyberpunk UI branding
+|   |   - spinner.js
+|   |   - terminal-ui.js
+|   |   - context-loader.js # Resource loading
+|   |   - ecc.js            # Embedded Context Corpus
+|   |   - codebase-index/  # Fast semantic search
 |   |- context/
-|   |   - compress.js        # Conversation compression
-|   |   - router.js          # Smart provider routing
+|   |   - compress.js       # Conversation compression
+|   |   - router.js         # Smart provider routing
+|   |   - resource-loader.js
 |   |- design/
-|   |   - commands.js        # Design system commands
+|   |   - commands.js       # Design system commands
 |   |- mcp/
-|   |   - client.js          # MCP client
-|   |   - protocol.js        # MCP protocol implementation
+|   |   - client.js         # MCP client
+|   |   - protocol.js       # MCP protocol implementation
 |   |- plugins/
-|   |   - manager.js         # Plugin manager
+|   |   - manager.js        # Plugin manager
 |   |- session/
-|   |   - manager.js         # Session manager
+|   |   - manager.js        # Session manager
 |   |- skills/
-|   |   - manager.js         # Skills manager
+|   |   - manager.js        # Skills manager
 |   - tools/
-|       - executor.js        # Tool executor (25 tools)
-|       - notebook.js        # Jupyter notebook tools
-|       - todo.js            # Todo tools
-|       - scheduler.js       # Schedule wakeup tool
-|       - interactive.js     # Ask user tool
-|       - agent.js           # Sub-agent tool
-|       - insert-text.js     # Insert text tool
+|       - executor.js       # Tool executor (25 tools)
+|       - notebook.js       # Jupyter notebook tools
+|       - todo.js           # Todo tools
+|       - scheduler.js      # Schedule wakeup tool
+|       - interactive.js    # Ask user tool
+|       - agent.js          # Sub-agent tool
+|       - insert-text.js    # Insert text tool
 |       - str-replace-all.js # Batch replace tool
-|       - web-archive.js     # Web archive tool
-|       - permission.js      # Permission manager
-|       - analytics.js       # Tool usage tracking
-|       - retry.js           # Retry utility
+|       - web-archive.js    # Web archive tool
+|       - permission.js     # Permission manager
+|- resources/local/
+|   |- codex/              # Codex CLI resources (206 files)
+|   |- page-agent/         # GUI automation (239 files)
+|   |- awesome-design-md/  # Design systems (142 files)
+|   |- claude/             # Claude patterns (795 files)
+|   |- agents.md/          # Agent docs (62 files)
+|   |- karpathy-tools/     # Coding principles (2 files)
+|   |- ecc/                # Embedded Context Corpus (7,932 files)
 |- README.md
-|- WINTER.md                  # Project rules for AI
+|- WINTER.md               # Project rules for AI
 |- package.json
 ```
 
@@ -555,17 +639,17 @@ winter/
 
 ## Core Philosophy
 
-Winter operates on three core principles:
+Winter operates on **four core principles**:
 
 ### 1. Think Before Coding
-*Nghi truoc khi code*
+*Nghi trước khi code*
 
 - State assumptions explicitly. If uncertain, ask.
 - Surface tradeoffs and alternatives -- don't pick silently.
 - If a simpler approach exists, say so. Push back when warranted.
 
 ### 2. Simplicity First
-*Don gian la tren het*
+*Đơn giản là trên hết*
 
 - Minimum code that solves the problem. Nothing speculative.
 - No features beyond what was asked.
@@ -573,13 +657,22 @@ Winter operates on three core principles:
 - No error handling for impossible scenarios.
 
 ### 3. Surgical Changes
-*Sua doi chinh xac*
+*Sửa đổi chính xác*
 
 - Touch only what you must. Clean up only your own mess.
 - Don't "improve" adjacent code, comments, or formatting.
 - Don't refactor things that aren't broken.
 - Match existing style, even if you'd do it differently.
 
+### 4. Goal-Driven Execution
+*Thực thi theo mục tiêu*
+
+- Define success criteria clearly.
+- Loop until verified -- don't claim completion without tool results.
+- Verify each step with the closest command available.
+
+> *These principles are integrated from [Karpathy Tools](resources/local/karpathy-tools/CLAUDE.md) and applied throughout Winter's operation.*
+
 ---
 
 ## Streaming & Real-time
@@ -600,7 +693,7 @@ User input -> REPL -> collectAssistantStream()
 ## Cross-Platform Support
 
 | Platform | Shell Support | Status |
-|---|---|---|
+|----------|----------------|--------|
 | **Windows** | cmd, PowerShell, Git Bash | Full support |
 | **macOS** | zsh, bash | Full support |
 | **Linux** | bash, sh, zsh | Full support |
@@ -611,21 +704,6 @@ Winter auto-detects your platform and shell:
 
 ---
 
-## Testing
-
-```bash
-# Run all tests (213)
-npm test
-
-# Run specific test file
-node --test src/tools/executor.test.js
-
-# Run tests with watch mode
-node --test --watch src/**/*.test.js
-```
-
----
-
 ## License
 
 MIT License -- see [LICENSE](LICENSE) for details.
@@ -638,4 +716,4 @@ MIT License -- see [LICENSE](LICENSE) for details.
 
 ---
 
-*Built with care -- Winter is the AI assistant that never sleeps.*
+*Built with care -- Winter is the AI assistant that never sleeps.*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "winter-super-cli",
-  "version": "2026.6.10",
+  "version": "2026.6.12",
   "description": "❄️ AI-Powered Development CLI with Interactive REPL",
   "type": "module",
   "main": "bin/winter.js",