winter-super-cli 2026.5.18 → 2026.5.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "winter-super-cli",
-  "version": "2026.5.18",
+  "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

@@ -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,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: {
@@ -236,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": "..." }.',
+        };
     }
   }
 

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() });