winter-super-cli 2026.5.24 → 2026.5.26

package/README.md

@@ -26,7 +26,7 @@ To install Winter globally in your system, clone the repository and run:
 *De cai dat Winter tren toan he thong, hay clone repository va chay:*
 
 ```bash
-npm install -g .
+npm install -g winter-super-cli@latest
 ```
 
 *(Or run directly without installation using node bin/winter.js)*

package/WINTER.md

@@ -1,5 +1,10 @@
 # Winter Project Rules
 
+## 🌨 Core Mission
+- Winter exists to help smaller or weaker models think more clearly, reason more reliably, and code much better.
+- When the task is ambiguous or hard, Winter should use tools, rules, memories, skills, and local resources proactively instead of guessing.
+- The goal is not minimal effort; the goal is strong outcomes, correct execution, and useful engineering judgment.
+
 ## 📝 Project Overview
 - **Name**: [Tên dự án]
 - **Description**: [Mô tả ngắn về dự án]
@@ -20,6 +25,7 @@
 - Luôn giải thích NGẮN GỌN lý do thực hiện thay đổi trước khi sửa file.
 - Khi gặp lỗi, hãy đề xuất giải pháp thay vì chỉ báo lỗi.
 - KHÔNG tự tiện xóa code cũ của user trừ khi chắc chắn nó không còn dùng hoặc được yêu cầu.
+- Nếu model chưa chắc chắn, hãy tự kéo thêm context bằng tool thay vì đoán.
 
 ### 3. Git & Commits
 - Viết commit message theo chuẩn Conventional Commits (VD: `feat:`, `fix:`, `docs:`).

package/bin/winter.js

@@ -5,260 +5,117 @@
  * Build by Atus fb: iam.anhtu, github: anhtu1707 with Interactive REPL
  */
 
+import { readFileSync } from 'fs';
+import path from 'path';
 import { WinterREPL } from '../src/cli/repl.js';
 import { ConfigLoader } from '../src/cli/config.js';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { readFileSync } from 'fs';
+import { SessionManager } from '../src/session/manager.js';
+import { AIProviderManager } from '../src/ai/providers.js';
+import { CommandParser } from '../src/cli/commands.js';
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
 const version = pkg.version;
 
-async function main() {
-  const args = process.argv.slice(2);
-
-  // Parse commands
-  if (args.length === 0 || args.includes('i') || args.includes('interactive') || args.includes('--session')) {
-    // Start interactive REPL mode
-    const config = new ConfigLoader();
-    const cfg = await config.load();
-    
-    let projectPath = process.cwd();
-    let sessionId = null;
-
-    const sessionIndex = args.indexOf('--session');
-    if (sessionIndex !== -1 && args[sessionIndex + 1]) {
-      sessionId = args[sessionIndex + 1];
-    }
-
-    // Lấy projectPath từ tham số không phải cờ (nếu có)
-    const nonFlagArgs = args.filter(a => !a.startsWith('-') && a !== 'i' && a !== 'interactive' && a !== sessionId);
-    if (nonFlagArgs[0]) {
-      projectPath = path.resolve(nonFlagArgs[0]);
-    }
-
-    const repl = new WinterREPL({ projectPath, sessionId, version });
-    await repl.start();
-    return;
-  }
-
-  // Handle commands
-  const [command, ...rest] = args;
+const COMMANDS = new Set([
+  'chat', 'call', 'session', 'skill', 'plugin', 'design', 'config', 'init',
+  'help', 'project', 'code', 'review',
+]);
 
-  switch (command) {
-    case 'chat':
-      await handleChatWithTools(rest);
-      break;
-    case 'call':
-      await handleCallAll(rest);
-      break;
-    case 'session':
-      await handleSession(rest);
-      break;
-    case 'skill':
-      await handleSkill(rest);
-      break;
-    case 'plugin':
-      await handlePlugin(rest);
-      break;
-    case 'design':
-      await handleDesign(rest);
-      break;
-    case 'config':
-      await handleConfig(rest);
-      break;
-    case 'init':
-      await handleInit(rest);
-      break;
-    case '--help':
-    case '-h':
-      printHelp();
-      break;
-    case '--version':
-    case '-v':
-      console.log(`❄️ Winter CLI v${version}\n`);
-      break;
-    default: {
-      // If no recognized command, treat the full input as a prompt.
-      const config = new ConfigLoader();
-      const cfg = await config.load();
-      const repl = new WinterREPL({ projectPath: cfg.project?.current || process.cwd() });
-      await repl.session.init();
-      await repl.ai.init();
-      await repl.chat([command, ...rest].join(' '));
-      break;
-    }
-  }
+function isInteractiveRequest(args) {
+  return args.length === 0 || args.includes('i') || args.includes('interactive') || args.includes('--session');
 }
 
-async function handleChatWithTools(args) {
-  const config = new ConfigLoader();
-  const message = args.join(' ');
-  if (!message) {
-    console.log('Usage: winter chat <message>');
-    return;
-  }
-
-  try {
-    const cfg = await config.load();
-    const repl = new WinterREPL({ projectPath: cfg.project?.current || process.cwd() });
-    await repl.session.init();
-    await repl.ai.init();
-    await repl.chat(message);
-  } catch (error) {
-    console.error(`\nWinter error: ${error.message}\n`);
-  }
-}
-
-async function handleCallAll(args) {
-  const { AIProviderManager } = await import('../src/ai/providers.js');
-  const config = new ConfigLoader();
-  const prompt = args.join(' ');
-
-  if (!prompt) {
-    console.log('Usage: winter call <prompt>');
-    return;
-  }
-
-  const ai = new AIProviderManager(config);
-  const results = await ai.callAllProviders(prompt);
-
-  for (const [provider, result] of Object.entries(results)) {
-    if (result.error) {
-      console.log(`\n[${provider}] ERROR\n${result.error}`);
-    } else {
-      console.log(`\n[${provider}] ${result.model}\n${result.content}`);
-    }
-  }
-}
-
-async function handleSession(args) {
-  const { SessionManager } = await import('../src/session/manager.js');
+async function createRuntime(projectPath, sessionId = null) {
   const config = new ConfigLoader();
   const session = new SessionManager(config);
-  await session.init();
+  await session.init({ project: projectPath, sessionId });
 
-  const [action, ...rest] = args;
+  const ai = new AIProviderManager(config);
+  await ai.init();
 
-  switch (action) {
-    case 'new':
-      const s = await session.newSession();
-      console.log(`✓ New session: ${s.id.substring(0, 8)}`);
-      break;
-    case 'list':
-      const sessions = await session.listSessions();
-      console.log(`\nSessions:`);
-      sessions.forEach(s => console.log(`  ${s.id.substring(0, 8)} - ${s.createdAt}`));
-      break;
-    default:
-      console.log(`Session: ${session.getSessionId().substring(0, 8)}`);
-  }
+  const parser = new CommandParser({ session, ai, config });
+  return { config, session, ai, parser };
 }
 
-async function handleSkill(args) {
-  const { SkillManager } = await import('../src/skills/manager.js');
-  const config = new ConfigLoader();
-  const session = new SessionManager(config);
-  await session.init();
-
-  const skills = new SkillManager(session);
-  const list = await skills.listSkills();
+function printHelp() {
+  console.log(`
+WINTER CLI
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-  console.log(`\n❄️ Available Skills:`);
-  list.forEach(s => console.log(`  ${s.icon} ${s.name} - ${s.description}`));
-  console.log('');
-}
+Usage:
 
-async function handlePlugin(args) {
-  const { PluginManager } = await import('../src/plugins/manager.js');
-  const session = new SessionManager({});
-  const plugins = new PluginManager(session);
-  const list = await plugins.listPlugins();
+  winter                      Start interactive REPL
+  winter help                 Show this help
+  winter chat <message>       Chat with AI
+  winter <prompt>             Treat plain text as a chat prompt
 
-  console.log(`\n❄️ Installed Plugins:`);
-  list.forEach(p => console.log(`  ${p.icon} ${p.name} v${p.version}`));
-  console.log('');
-}
+Commands:
 
-async function handleDesign(args) {
-  const { DesignCommands } = await import('../src/design/commands.js');
-  const config = new ConfigLoader();
-  const session = new SessionManager(config);
-  await session.init();
+  winter call <prompt>        Call all configured providers
+  winter session <action>     Session management
+  winter skill <action>       Skill management
+  winter plugin <action>      Plugin management
+  winter design <action>      Design commands
+  winter project <action>     Project commands
+  winter config               Show config
+  winter init                 Initialize local state
+  winter review               Code review mode
+  winter code                 Code analysis mode
 
-  const design = new DesignCommands(session, config);
-  await design.execute(args[0], args.slice(1));
-}
+Flags:
 
-async function handleConfig(args) {
-  const config = new ConfigLoader();
-  const cfg = await config.load();
-  console.log(`\n❄️ Configuration:\n`);
-  console.log(JSON.stringify(cfg, null, 2));
-  console.log('');
-}
+  winter -h, --help           Show help
+  winter -v, --version        Show version
 
-async function handleInit(args) {
-  console.log('❄️ Initializing Winter CLI...');
-  // Create necessary directories and files
-  console.log('✓ Ready!');
+Version ${version}
+  `);
 }
 
-function printHelp() {
-  console.log(`
-WINTER CLI
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Commands:
+async function main() {
+  const args = process.argv.slice(2);
 
-  winter                 Start interactive REPL
-  winter i               Interactive mode
-  winter chat <msg>      Chat with AI
-  winter call <prompt>   Call all configured providers
-  winter session         Session management
-  winter skill           List skills
-  winter plugin          List plugins
-  winter design          Design commands
-  winter config          Show config
+  if (args.includes('--help') || args.includes('-h')) {
+    printHelp();
+    return;
+  }
 
-Important REPL slash commands:
+  if (args.includes('--version') || args.includes('-v')) {
+    console.log(`❄️ Winter CLI v${version}\n`);
+    return;
+  }
 
-  /provider <name>       Switch provider and save default
-  /model <model-id>      Set model for active provider
-  /models                List configured and cached models
-  /codex [section]       Browse ~/.codex resources
-  /claude [section]      Browse ~/.claude resources
-  /karpathy              Browse ~/karpathy-tools
-  /designs [query]       List/search awesome-design-md systems
-  /agents                Read ~/agents.md
-  /skills                List Winter/Codex/Claude skills
+  if (isInteractiveRequest(args)) {
+    const config = new ConfigLoader();
 
-Version ${version}
-  `);
-  return;
-  console.log(`
-❄️ WINTER CLI ❄️
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+    let projectPath = process.cwd();
+    let sessionId = null;
 
-📋 Commands:
+    const sessionIndex = args.indexOf('--session');
+    if (sessionIndex !== -1 && args[sessionIndex + 1]) {
+      sessionId = args[sessionIndex + 1];
+    }
 
-  winter                 Start interactive REPL (gõ winter)
-  winter i              Interactive mode
-  winter chat <msg>     Chat with AI
+    const nonFlagArgs = args.filter(a => !a.startsWith('-') && a !== 'i' && a !== 'interactive' && a !== sessionId);
+    if (nonFlagArgs[0]) {
+      projectPath = path.resolve(nonFlagArgs[0]);
+    }
 
-  winter session        Session management
-  winter skill         List skills
-  winter plugin        List plugins
-  winter design        Design commands
-  winter config        Show config
+    const repl = new WinterREPL({ projectPath, sessionId, version });
+    await repl.start();
+    return;
+  }
 
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  const config = new ConfigLoader();
+  const projectPath = process.cwd();
+  const { parser } = await createRuntime(projectPath);
+  const [command] = args;
 
-💡 Just type 'winter' to start chatting with your project!
+  if (!command || (!command.startsWith('/') && !COMMANDS.has(command))) {
+    await parser.parse(['chat', ...args]);
+    return;
+  }
 
-❄️ Version ${version}
-  `);
+  await parser.parse(args);
 }
 
 main().catch(err => {

package/package.json

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

package/resources/local/manifest.json

@@ -1,57 +1,60 @@
-{
-    "generatedAt":  "2026-05-14T18:37:11.5585557+07:00",
-    "root":  "E:\\dev\\app\\winter\\resources\\local",
-    "localResources":  [
-                           {
-                               "name":  "agents.md",
-                               "path":  "E:\\dev\\app\\winter\\resources\\local\\agents.md",
-                               "files":  90,
-                               "bytes":  2546038
-                           },
-                           {
-                               "name":  "awesome-design-md",
-                               "path":  "E:\\dev\\app\\winter\\resources\\local\\awesome-design-md",
-                               "files":  142,
-                               "bytes":  1912402
-                           },
-                           {
-                               "name":  "claude",
-                               "path":  "E:\\dev\\app\\winter\\resources\\local\\claude",
-                               "files":  971,
-                               "bytes":  17626519
-                           },
-                           {
-                               "name":  "codex",
-                               "path":  "E:\\dev\\app\\winter\\resources\\local\\codex",
-                               "files":  259,
-                               "bytes":  3425257
-                           },
-                           {
-                               "name":  "karpathy-tools",
-                               "path":  "E:\\dev\\app\\winter\\resources\\local\\karpathy-tools",
-                               "files":  2,
-                               "bytes":  6068
-                           },
-                           {
-                               "name":  "manifest.json",
-                               "path":  "E:\\dev\\app\\winter\\resources\\local\\manifest.json",
-                               "files":  1,
-                               "bytes":  2936
-                           }
-                       ],
-    "excludedForSafety":  [
-                              "C:\\Users\\PHUCANSOLUTIONS\\.codex\\auth.json",
-                              "C:\\Users\\PHUCANSOLUTIONS\\.codex\\sessions",
-                              "C:\\Users\\PHUCANSOLUTIONS\\.codex\\history.jsonl",
-                              "C:\\Users\\PHUCANSOLUTIONS\\.codex\\*.sqlite*",
-                              "C:\\Users\\PHUCANSOLUTIONS\\.codex\\log and tmp/cache runtime folders",
-                              "C:\\Users\\PHUCANSOLUTIONS\\.claude\\history.jsonl",
-                              "C:\\Users\\PHUCANSOLUTIONS\\.claude\\sessions",
-                              "C:\\Users\\PHUCANSOLUTIONS\\.claude\\projects",
-                              "C:\\Users\\PHUCANSOLUTIONS\\.claude\\plugins\\cache",
-                              "runtime logs, tmp, cache, auth, local settings, and session state"
-                          ],
-    "redacted":  [
-                     "resources/local/claude/settings.json: ANTHROPIC_API_KEY and ANTHROPIC_AUTH_TOKEN"
-                 ]
-}
+{
+  "generatedAt": "2026-05-14T18:37:11.5585557+07:00",
+  "root": "resources/local",
+  "localResources": [
+    {
+      "name": "agents.md",
+      "path": "resources/local/agents.md",
+      "files": 90,
+      "bytes": 2546038
+    },
+    {
+      "name": "awesome-design-md",
+      "path": "resources/local/awesome-design-md",
+      "files": 142,
+      "bytes": 1912402
+    },
+    {
+      "name": "claude",
+      "path": "resources/local/claude",
+      "files": 971,
+      "bytes": 17626519
+    },
+    {
+      "name": "codex",
+      "path": "resources/local/codex",
+      "files": 259,
+      "bytes": 3425257
+    },
+    {
+      "name": "karpathy-tools",
+      "path": "resources/local/karpathy-tools",
+      "files": 2,
+      "bytes": 6068
+    },
+    {
+      "name": "manifest.json",
+      "path": "resources/local/manifest.json",
+      "files": 1,
+      "bytes": 2936
+    }
+  ],
+  "excludedForSafety": [
+    "$HOME/.codex/auth.json",
+    "$HOME/.codex/sessions",
+    "$HOME/.codex/history.jsonl",
+    "$HOME/.codex/*.sqlite*",
+    "$HOME/.codex log and tmp/cache runtime folders",
+    "$HOME/.claude/history.jsonl",
+    "$HOME/.claude/sessions",
+    "$HOME/.claude/projects",
+    "$HOME/.claude/plugins/cache",
+    "runtime logs, tmp, cache, auth, local settings, and session state"
+  ],
+  "redacted": [
+    "resources/local/claude/settings.json: excluded from npm package",
+    "resources/local/codex/config.toml: excluded from npm package",
+    "resources/local/codex/memories: excluded from npm package",
+    "resources/local/claude/tasks and todos: excluded from npm package"
+  ]
+}

package/src/ai/providers.js

@@ -86,30 +86,81 @@ export class AIProviderManager {
   }
 
   async loadAuthToken() {
+    // 1) Honor explicit environment variables (highest priority)
+    const envToken = process.env.CLAUDE_AUTH_TOKEN || process.env.ANTHROPIC_API_KEY || process.env.CLAUDE_TOKEN || null;
+    if (envToken) return envToken;
+
+    // 2) Look into user home directories (platform-agnostic, no hardcoded username)
     try {
       const fs = await import('fs');
-      const authPath = 'C:\\Users\\PHUCANSOLUTIONS\\.codex\\auth.json';
-      const data = JSON.parse(fs.readFileSync(authPath, 'utf8'));
-      return data.tokens?.access_token || null;
-    } catch {
-      // Try Claude's auth
-      try {
-        const fs = await import('fs');
-        const authPath = 'C:\\Users\\PHUCANSOLUTIONS\\.claude\\sessions\\*\\auth.json';
-        // This won't work with glob, so skip
-      } catch {}
-      return null;
+      const path = await import('path');
+      const os = await import('os');
+      const home = os.homedir();
+
+      // Try ~/.codex/auth.json
+      const codexAuth = path.join(home, '.codex', 'auth.json');
+      if (fs.existsSync(codexAuth)) {
+        try {
+          const data = JSON.parse(fs.readFileSync(codexAuth, 'utf8'));
+          return data.tokens?.access_token || data.access_token || null;
+        } catch {}
+      }
+
+      // Try ~/.claude/sessions/*/auth.json
+      const claudeSessionsDir = path.join(home, '.claude', 'sessions');
+      if (fs.existsSync(claudeSessionsDir)) {
+        const entries = await fs.promises.readdir(claudeSessionsDir, { withFileTypes: true });
+        for (const e of entries) {
+          if (!e.isDirectory()) continue;
+          const candidate = path.join(claudeSessionsDir, e.name, 'auth.json');
+          if (fs.existsSync(candidate)) {
+            try {
+              const data = JSON.parse(fs.readFileSync(candidate, 'utf8'));
+              return data.tokens?.access_token || data.access_token || null;
+            } catch {}
+          }
+        }
+      }
+    } catch (err) {
+      // ignore and fall through
     }
+
+    // No token found
+    return null;
+  }
+
+  normalizeProviderName(name) {
+    return String(name || '').trim().toLowerCase();
+  }
+
+  async reload() {
+    this.providers = {};
+    this.activeProvider = null;
+    this.initialized = false;
+    await this.init();
   }
 
   setProvider(name) {
-    if (this.providers[name]) {
-      this.activeProvider = name;
+    const providerName = this.normalizeProviderName(name);
+    if (this.providers[providerName]) {
+      this.activeProvider = providerName;
       return true;
     }
     return false;
   }
 
+  async switchProvider(name) {
+    const providerName = this.normalizeProviderName(name);
+    await this.init();
+
+    if (this.setProvider(providerName)) {
+      return providerName;
+    }
+
+    await this.reload();
+    return this.setProvider(providerName) ? providerName : null;
+  }
+
   getActiveProvider() {
     return this.activeProvider;
   }

package/src/ai/providers.test.js

@@ -100,3 +100,38 @@ test('callAllProviders calls every ready configured provider', async () => {
     globalThis.fetch = originalFetch;
   }
 });
+
+test('switchProvider reloads config before rejecting a provider', async () => {
+  let cfg = {
+    defaultProvider: 'ollama',
+    ollama: {
+      baseURL: 'http://ollama.test/v1',
+      model: 'llama3',
+    },
+  };
+
+  const ai = new AIProviderManager({
+    async load() {
+      return cfg;
+    },
+  });
+  ai.loadAuthToken = async () => null;
+
+  await ai.init();
+  assert.equal(ai.getActiveProvider(), 'ollama');
+
+  cfg = {
+    ...cfg,
+    custom: {
+      baseURL: 'http://custom.test/v1',
+      apiKey: 'not-required',
+      model: 'custom-model',
+    },
+  };
+
+  const switched = await ai.switchProvider(' CUSTOM ');
+
+  assert.equal(switched, 'custom');
+  assert.equal(ai.getActiveProvider(), 'custom');
+  assert.equal(ai.providers.custom.model, 'custom-model');
+});