winter-super-cli 2026.5.18 → 2026.5.20

package/package.json

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

package/src/cli/repl.js

@@ -2147,7 +2147,9 @@ ${colors.reset}
 
 ## Tools Available
 - Read, Write, Edit - File operations
-- Bash - Execute shell commands
+- Write - Create/overwrite files directly. Use this instead of Bash echo/cat/heredoc for writing code.
+- Edit - Replace exact text in existing files.
+- Bash - Execute shell commands. Current OS is ${process.platform === 'win32' ? 'Windows; Bash auto-detects PowerShell and cmd.exe syntax. Use shell="powershell" or shell="cmd" when needed.' : process.platform}.
 - Glob - Find files
 - Grep - Search content
 - TaskCreate, TaskUpdate, TaskList - Task management
@@ -2156,6 +2158,9 @@ ${colors.reset}
 
 ## Guidelines
 - Call tools when they help - be proactive
+- You DO have file write tools. Never say "there is no write tool"; use Write or Edit.
+- If a tool name fails, call the canonical tool name next: Write, Edit, Read, Bash, Glob, or Grep.
+- On Windows, Bash accepts both PowerShell and cmd.exe commands. Prefer Write with full content for file writes.
 - After using tools, always provide a direct final answer to the user.
 - Answer normal questions directly without unnecessary legal or policy disclaimers.
 - If a request is illegal, unsafe, or harmful, refuse briefly and offer a safe alternative.
@@ -2235,9 +2240,16 @@ Nếu người dùng yêu cầu sửa file/chạy lệnh/đọc dự án thì n
 2. [DESIGN EXCELLENCE]: Use rich aesthetics. Default to modern UI frameworks if applicable. Never output plain, ugly HTML/CSS. Ensure responsive, premium feel with micro-animations.
 3. [CODE QUALITY]: Write clean, modular, SOLID code. Check for syntax errors carefully. Do not generate incomplete code blocks.
 4. [NO HALLUCINATION]: If you don't know, use tools (Grep/Read/Web) to find out. Do not guess file paths or APIs.
+5. [TOOL EXECUTION FIRST]: You DO have file tools. Use Write to create/overwrite files and Edit to patch files. Never say there is no write tool.
 
 ${rolePrompt}
 
+## Tool Rules
+- Canonical tools: Read, Write, Edit, Bash, Glob, Grep, TaskCreate, TaskUpdate, TaskList, BrowserDebug, WebFetch, WebSearch.
+- Current OS is ${process.platform === 'win32' ? 'Windows; Bash auto-detects PowerShell and cmd.exe syntax. Use shell="powershell" or shell="cmd" when needed.' : process.platform}.
+- Prefer Write/Edit for writing files. Bash accepts both PowerShell and cmd.exe on Windows, but do not use long echo chains for code files.
+- If a tool call fails because of an unknown alias, call the canonical tool name next.
+
 ## Project
 Working directory: ${this.projectPath}
 Current session: ${this.session.getSessionId().substring(0, 8)}

package/src/tools/executor.js

@@ -37,7 +37,7 @@ export class ToolExecutor {
       {
         type: 'function',
         name: 'Write',
-        description: 'Create or overwrite file with content.',
+        description: 'Create or overwrite a file with content. Prefer this for file creation instead of Bash echo/cat/heredoc. Also handles model aliases like write_to_file.',
         parameters: {
           type: 'object',
           properties: {
@@ -50,7 +50,7 @@ export class ToolExecutor {
       {
         type: 'function',
         name: 'Edit',
-        description: 'Make surgical changes. Replace exact old_string with new_string.',
+        description: 'Make surgical changes. Replace exact old_string with new_string. Also handles model aliases like replace_in_file and str_replace_editor.',
         parameters: {
           type: 'object',
           properties: {
@@ -64,13 +64,14 @@ export class ToolExecutor {
       {
         type: 'function',
         name: 'Bash',
-        description: 'Execute shell command. Returns stdout/stderr.',
+        description: 'Execute a shell command. On Windows, shell auto-detects PowerShell or cmd.exe syntax. Prefer Write/Edit for file writes.',
         parameters: {
           type: 'object',
           properties: {
             command: { type: 'string', description: 'Shell command to execute' },
             cwd: { type: 'string', description: 'Working directory' },
-            timeout: { type: 'number', description: 'Timeout in ms (default: 60000)' }
+            timeout: { type: 'number', description: 'Timeout in ms (default: 60000)' },
+            shell: { type: 'string', description: 'Windows shell: auto, powershell, or cmd' }
           },
           required: ['command']
         }
@@ -216,7 +217,7 @@ export class ToolExecutor {
           newStr
         );
       case 'Bash':
-        return await this.bash(input.command ?? input.cmd, input.cwd || cwd, input.timeout);
+        return await this.bash(input.command ?? input.cmd, input.cwd || cwd, input.timeout, input.shell);
       case 'Glob':
         return await this.glob(input.pattern ?? input.glob ?? '**/*', input.cwd || input.path || cwd);
       case 'Grep':
@@ -236,7 +237,12 @@ export class ToolExecutor {
       case 'WebSearch':
         return await this.webSearch(input.query ?? input.q);
       default:
-        return { success: false, error: `Unknown tool: ${toolName}` };
+        return {
+          success: false,
+          error: `Unknown tool: ${toolName}`,
+          availableTools: ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep', 'TaskCreate', 'TaskUpdate', 'TaskList', 'BrowserDebug', 'WebFetch', 'WebSearch'],
+          recovery: 'Call one of the available tools. For file writes use Write with { "file_path": "...", "content": "..." }. For shell commands use Bash with { "command": "..." }.',
+        };
     }
   }
 
@@ -439,7 +445,7 @@ export class ToolExecutor {
     }
   }
 
-  async bash(command, cwd, timeout = 60000) {
+  async bash(command, cwd, timeout = 60000, shell = 'auto') {
     if (typeof command !== 'string' || command.trim() === '') {
       return { success: false, error: 'command is required', exitCode: 1 };
     }
@@ -450,7 +456,10 @@ export class ToolExecutor {
     const heredocResult = await this.tryHandleHeredocWrite(command, cwd);
     if (heredocResult) return heredocResult;
 
-    command = await this.translateWindowsCommand(command);
+    let requestedShell = this.normalizeWindowsShell(shell);
+    const translated = await this.translateWindowsCommand(command);
+    command = translated.command;
+    if (requestedShell === 'auto' && translated.shell) requestedShell = translated.shell;
 
     // Security check
     const lowerCommand = command.toLowerCase();
@@ -462,12 +471,7 @@ export class ToolExecutor {
 
     try {
       const { stdout, stderr } = process.platform === 'win32'
-        ? await execFileAsync('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command', command], {
-            cwd,
-            timeout,
-            windowsHide: true,
-            maxBuffer: 10 * 1024 * 1024,
-          })
+        ? await this.execWindowsCommand(command, cwd, timeout, requestedShell)
         : await execAsync(command, { cwd, timeout, shell: true, maxBuffer: 10 * 1024 * 1024 });
       return {
         success: true,
@@ -486,6 +490,50 @@ export class ToolExecutor {
     }
   }
 
+  normalizeWindowsShell(shell) {
+    const value = String(shell || 'auto').toLowerCase();
+    if (['cmd', 'cmd.exe', 'commandprompt', 'command-prompt'].includes(value)) return 'cmd';
+    if (['powershell', 'pwsh', 'ps', 'powershell.exe'].includes(value)) return 'powershell';
+    return 'auto';
+  }
+
+  async execWindowsCommand(command, cwd, timeout, requestedShell = 'auto') {
+    const shell = requestedShell === 'auto' ? this.detectWindowsShell(command) : requestedShell;
+    if (shell === 'cmd') {
+      return await execFileAsync('cmd.exe', ['/d', '/s', '/c', command], {
+        cwd,
+        timeout,
+        windowsHide: true,
+        maxBuffer: 10 * 1024 * 1024,
+      });
+    }
+
+    return await execFileAsync('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command', command], {
+      cwd,
+      timeout,
+      windowsHide: true,
+      maxBuffer: 10 * 1024 * 1024,
+    });
+  }
+
+  detectWindowsShell(command) {
+    const trimmed = String(command || '').trim();
+    if (this.looksLikePowerShell(trimmed)) return 'powershell';
+    if (this.looksLikeCmd(trimmed)) return 'cmd';
+    return 'powershell';
+  }
+
+  looksLikePowerShell(command) {
+    return /(^|[;&|]\s*)(Get-|Set-|New-|Remove-|Copy-|Move-|Select-|Where-|ForEach-|Test-Path|Out-File|Write-Host|powershell(?:\.exe)?\b|pwsh\b)/i.test(command);
+  }
+
+  looksLikeCmd(command) {
+    return /\s(&&|\|\|)\s/.test(command)
+      || /(^|[&]\s*)(dir|copy|xcopy|del|erase|move|ren|type|echo|set|if|for|mkdir|rmdir)\b/i.test(command)
+      || /^\s*@?echo\s+/i.test(command)
+      || /(^|\s)(\/b|\/s|\/q|\/y)\b/i.test(command);
+  }
+
   async glob(pattern, cwd) {
     const normalizedRequest = await this.normalizeGlobRequest(pattern, cwd);
     if (normalizedRequest.file) {
@@ -566,7 +614,7 @@ export class ToolExecutor {
   }
 
   async translateWindowsCommand(command) {
-    if (process.platform !== 'win32') return command;
+    if (process.platform !== 'win32') return { command };
 
     const trimmed = command.trim();
     const ls = trimmed.match(/^ls(?:\s+(.+))?$/i);
@@ -579,7 +627,10 @@ export class ToolExecutor {
       const fields = long
         ? 'Mode,Length,LastWriteTime,Name'
         : 'Name';
-      return `Get-ChildItem -LiteralPath ${this.quotePowerShellString(target)}${recurse ? ' -Recurse' : ''}${force ? ' -Force' : ''} | Select-Object ${fields}`;
+      return {
+        command: `Get-ChildItem -LiteralPath ${this.quotePowerShellString(target)}${recurse ? ' -Recurse' : ''}${force ? ' -Force' : ''} | Select-Object ${fields}`,
+        shell: 'powershell',
+      };
     }
 
     const cat = trimmed.match(/^cat\s+(.+)$/i);
@@ -589,13 +640,19 @@ export class ToolExecutor {
       try {
         const stat = await fs.stat(normalizedTarget);
         if (stat.isDirectory()) {
-          return `Get-ChildItem -LiteralPath ${this.quotePowerShellString(target)} -Force | Select-Object -ExpandProperty Name`;
+          return {
+            command: `Get-ChildItem -LiteralPath ${this.quotePowerShellString(target)} -Force | Select-Object -ExpandProperty Name`,
+            shell: 'powershell',
+          };
         }
       } catch {}
-      return `Get-Content -LiteralPath ${this.quotePowerShellString(target)}`;
+      return {
+        command: `Get-Content -LiteralPath ${this.quotePowerShellString(target)}`,
+        shell: 'powershell',
+      };
     }
 
-    return command;
+    return { command };
   }
 
   async tryHandleHeredocWrite(command, cwd) {

package/src/tools/executor.test.js

@@ -14,6 +14,16 @@ test('Bash validates missing command instead of throwing', async () => {
   assert.equal(result.error, 'command is required');
 });
 
+test('unknown tools return recovery guidance instead of a bare failure', async () => {
+  const tools = new ToolExecutor({ projectPath: process.cwd() });
+  const result = await tools.execute('bad_tool_name', {});
+
+  assert.equal(result.success, false);
+  assert.equal(result.error, 'Unknown tool: bad_tool_name');
+  assert(result.availableTools.includes('Write'));
+  assert.match(result.recovery, /Write/);
+});
+
 test('tool names accept common model aliases', () => {
   const tools = new ToolExecutor({ projectPath: process.cwd() });
 
@@ -62,6 +72,46 @@ test('Windows Bash runs PowerShell commands and translates ls flags', async (t)
   assert.match(ps.stdout, /a\.txt/);
 });
 
+test('Windows Bash accepts explicit cmd and PowerShell shells', async (t) => {
+  if (process.platform !== 'win32') {
+    t.skip('Windows-only shell behavior');
+    return;
+  }
+
+  const root = await mkdtemp(path.join(tmpdir(), 'winter-shells-'));
+  const tools = new ToolExecutor({ projectPath: root });
+
+  const cmd = await tools.execute('Bash', {
+    shell: 'cmd',
+    command: 'echo hello>cmd.txt && type cmd.txt',
+  });
+  assert.equal(cmd.success, true);
+  assert.match(cmd.stdout, /hello/);
+
+  const ps = await tools.execute('Bash', {
+    shell: 'powershell',
+    command: "Set-Content -LiteralPath ps.txt -Value 'world'; Get-Content -LiteralPath ps.txt",
+  });
+  assert.equal(ps.success, true);
+  assert.match(ps.stdout, /world/);
+});
+
+test('Windows Bash auto-detects cmd chaining syntax', async (t) => {
+  if (process.platform !== 'win32') {
+    t.skip('Windows-only shell behavior');
+    return;
+  }
+
+  const root = await mkdtemp(path.join(tmpdir(), 'winter-cmd-auto-'));
+  const tools = new ToolExecutor({ projectPath: root });
+  const result = await tools.execute('Bash', {
+    command: 'echo auto>auto.txt && type auto.txt',
+  });
+
+  assert.equal(result.success, true);
+  assert.match(result.stdout, /auto/);
+});
+
 test('Read lists directories instead of failing on directory paths', async () => {
   const root = await mkdtemp(path.join(tmpdir(), 'winter-tools-'));
   await mkdir(path.join(root, 'sub'));