winter-super-cli 2026.5.17 → 2026.5.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "winter-super-cli",
-  "version": "2026.5.17",
+  "version": "2026.5.19",
   "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 runs through PowerShell, not Linux bash. Use PowerShell-compatible commands.' : 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.
+- Do not use Linux-only heredoc/echo chains to write files on Windows. Prefer Write with full content.
 - 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 runs through PowerShell, not Linux bash. Use PowerShell-compatible commands.' : process.platform}.
+- Prefer Write/Edit for writing files. Do not use Linux-only heredoc or 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

@@ -5,11 +5,12 @@
 
 import { promises as fs } from 'fs';
 import path from 'path';
-import { exec } from 'child_process';
+import { exec, execFile } from 'child_process';
 import { promisify } from 'util';
 import { diffLines } from 'diff';
 
 const execAsync = promisify(exec);
+const execFileAsync = promisify(execFile);
 
 export class ToolExecutor {
   constructor(repl) {
@@ -36,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: {
@@ -49,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: {
@@ -63,7 +64,7 @@ export class ToolExecutor {
       {
         type: 'function',
         name: 'Bash',
-        description: 'Execute shell command. Returns stdout/stderr.',
+        description: 'Execute a shell command. On Windows this runs in PowerShell, not Linux bash. Prefer Write/Edit for file writes.',
         parameters: {
           type: 'object',
           properties: {
@@ -235,7 +236,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": "..." }.',
+        };
     }
   }
 
@@ -262,6 +268,7 @@ export class ToolExecutor {
       bash: 'Bash',
       shell: 'Bash',
       command: 'Bash',
+      commandexecutor: 'Bash',
       executecommand: 'Bash',
       runcommand: 'Bash',
       terminal: 'Bash',
@@ -445,6 +452,9 @@ export class ToolExecutor {
     timeout = parseInt(timeout, 10);
     if (isNaN(timeout) || timeout < 0) timeout = 60000;
 
+    const heredocResult = await this.tryHandleHeredocWrite(command, cwd);
+    if (heredocResult) return heredocResult;
+
     command = await this.translateWindowsCommand(command);
 
     // Security check
@@ -456,7 +466,14 @@ export class ToolExecutor {
     }
 
     try {
-      const { stdout, stderr } = await execAsync(command, { cwd, timeout, shell: true });
+      const { stdout, stderr } = process.platform === 'win32'
+        ? await execFileAsync('powershell.exe', ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-Command', command], {
+            cwd,
+            timeout,
+            windowsHide: true,
+            maxBuffer: 10 * 1024 * 1024,
+          })
+        : await execAsync(command, { cwd, timeout, shell: true, maxBuffer: 10 * 1024 * 1024 });
       return {
         success: true,
         stdout: stdout || '',
@@ -557,16 +574,17 @@ export class ToolExecutor {
     if (process.platform !== 'win32') return command;
 
     const trimmed = command.trim();
-    const lsRecursive = trimmed.match(/^ls\s+-R\s+(.+)$/i);
-    if (lsRecursive) {
-      const target = lsRecursive[1].trim();
-      return `powershell -NoProfile -Command "Get-ChildItem -LiteralPath ${this.quotePowerShellString(target)} -Recurse -Force | Select-Object -ExpandProperty FullName"`;
-    }
-
-    const ls = trimmed.match(/^ls\s+(.+)$/i);
+    const ls = trimmed.match(/^ls(?:\s+(.+))?$/i);
     if (ls) {
-      const target = ls[1].trim();
-      return `powershell -NoProfile -Command "Get-ChildItem -LiteralPath ${this.quotePowerShellString(target)} -Force | Select-Object -ExpandProperty Name"`;
+      const parsed = this.parseLsArgs(ls[1] || '');
+      const target = parsed.target || '.';
+      const recurse = parsed.flags.has('r') || parsed.flags.has('recursive');
+      const long = parsed.flags.has('l') || parsed.flags.has('la') || parsed.flags.has('al');
+      const force = parsed.flags.has('a') || parsed.flags.has('force') || parsed.flags.has('la') || parsed.flags.has('al');
+      const fields = long
+        ? 'Mode,Length,LastWriteTime,Name'
+        : 'Name';
+      return `Get-ChildItem -LiteralPath ${this.quotePowerShellString(target)}${recurse ? ' -Recurse' : ''}${force ? ' -Force' : ''} | Select-Object ${fields}`;
     }
 
     const cat = trimmed.match(/^cat\s+(.+)$/i);
@@ -576,15 +594,82 @@ export class ToolExecutor {
       try {
         const stat = await fs.stat(normalizedTarget);
         if (stat.isDirectory()) {
-          return `powershell -NoProfile -Command "Get-ChildItem -LiteralPath ${this.quotePowerShellString(target)} -Force | Select-Object -ExpandProperty Name"`;
+          return `Get-ChildItem -LiteralPath ${this.quotePowerShellString(target)} -Force | Select-Object -ExpandProperty Name`;
         }
       } catch {}
-      return `powershell -NoProfile -Command "Get-Content -LiteralPath ${this.quotePowerShellString(target)}"`;
+      return `Get-Content -LiteralPath ${this.quotePowerShellString(target)}`;
     }
 
     return command;
   }
 
+  async tryHandleHeredocWrite(command, cwd) {
+    const match = String(command || '').match(/^cat\s*>\s*(.+?)\s*<<\s*['"]?([A-Za-z0-9_-]+)['"]?\r?\n([\s\S]*?)\r?\n\2\s*$/);
+    if (!match) return null;
+
+    const [, rawTarget, , content] = match;
+    const target = this.resolveInputPath(rawTarget.trim(), cwd);
+    return await this.writeFile(target, content.endsWith('\n') ? content : `${content}\n`);
+  }
+
+  parseLsArgs(rawArgs) {
+    const tokens = this.splitShellLike(rawArgs);
+    const flags = new Set();
+    const paths = [];
+
+    for (const token of tokens) {
+      if (token.startsWith('-') && token.length > 1) {
+        const flag = token.replace(/^-+/, '').toLowerCase();
+        flags.add(flag);
+        if (!flag.includes('=')) {
+          for (const ch of flag) flags.add(ch);
+        }
+      } else {
+        paths.push(token);
+      }
+    }
+
+    return { flags, target: paths.join(' ') };
+  }
+
+  splitShellLike(text) {
+    const tokens = [];
+    let current = '';
+    let quote = null;
+    let escaped = false;
+
+    for (const ch of String(text || '')) {
+      if (escaped) {
+        current += ch;
+        escaped = false;
+        continue;
+      }
+      if (ch === '\\') {
+        escaped = true;
+        continue;
+      }
+      if ((ch === '"' || ch === "'") && !quote) {
+        quote = ch;
+        continue;
+      }
+      if (ch === quote) {
+        quote = null;
+        continue;
+      }
+      if (/\s/.test(ch) && !quote) {
+        if (current) {
+          tokens.push(current);
+          current = '';
+        }
+        continue;
+      }
+      current += ch;
+    }
+
+    if (current) tokens.push(current);
+    return tokens;
+  }
+
   quotePowerShellString(value) {
     const unquoted = value.replace(/^['"]|['"]$/g, '');
     return `'${unquoted.replace(/'/g, "''")}'`;

package/src/tools/executor.test.js

@@ -14,12 +14,23 @@ 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() });
 
   assert.equal(tools.normalizeToolName('read_file'), 'Read');
   assert.equal(tools.normalizeToolName('write_to_file'), 'Write');
   assert.equal(tools.normalizeToolName('replace_in_file'), 'Edit');
+  assert.equal(tools.normalizeToolName('command_executor'), 'Bash');
   assert.equal(tools.normalizeToolName('execute_command'), 'Bash');
   assert.equal(tools.normalizeToolName('list_files'), 'Glob');
   assert.equal(tools.normalizeToolName('search_files'), 'Grep');
@@ -27,6 +38,40 @@ test('tool names accept common model aliases', () => {
   assert.equal(tools.normalizeToolName('web-search'), 'WebSearch');
 });
 
+test('Bash supports model-style heredoc file writes', async () => {
+  const root = await mkdtemp(path.join(tmpdir(), 'winter-heredoc-'));
+  const tools = new ToolExecutor({ projectPath: root });
+  const result = await tools.execute('command_executor', {
+    command: "cat > src/components/InstallSection.tsx << 'EOF'\nconst ok = true;\nEOF",
+  });
+
+  assert.equal(result.success, true);
+  assert.equal(result.path, path.join(root, 'src', 'components', 'InstallSection.tsx'));
+
+  const read = await tools.execute('Read', { file_path: 'src/components/InstallSection.tsx' });
+  assert.equal(read.content, 'const ok = true;\n');
+});
+
+test('Windows Bash runs PowerShell commands and translates ls flags', async (t) => {
+  if (process.platform !== 'win32') {
+    t.skip('Windows-only shell behavior');
+    return;
+  }
+
+  const root = await mkdtemp(path.join(tmpdir(), 'winter-powershell-'));
+  await mkdir(path.join(root, 'src', 'components'), { recursive: true });
+  await writeFile(path.join(root, 'src', 'components', 'a.txt'), 'hello');
+
+  const tools = new ToolExecutor({ projectPath: root });
+  const ls = await tools.execute('Bash', { command: 'ls -la src/components/' });
+  assert.equal(ls.success, true);
+  assert.match(ls.stdout, /a\.txt/);
+
+  const ps = await tools.execute('Bash', { command: 'Get-ChildItem -Path src/components/ -Name' });
+  assert.equal(ps.success, true);
+  assert.match(ps.stdout, /a\.txt/);
+});
+
 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'));