snow-ai 0.2.7 → 0.2.9

package/dist/mcp/filesystem.d.ts

@@ -76,8 +76,8 @@ export declare class FilesystemMCPService {
     }>;
     /**
      * Edit a file by replacing lines within a specified range
-     * IMPORTANT: This tool enforces small, precise edits (max 15 lines per edit) to ensure accuracy.
-     * For larger changes, make multiple sequential edits instead of one large edit.
+     * BEST PRACTICE: Keep edits small and focused (≤15 lines recommended) for better accuracy.
+     * For larger changes, make multiple parallel edits to non-overlapping sections instead of one large edit.
      *
      * @param filePath - Path to the file to edit
      * @param startLine - Starting line number (1-indexed, inclusive) - get from filesystem_read output
@@ -85,7 +85,7 @@ export declare class FilesystemMCPService {
      * @param newContent - New content to replace the specified lines (WITHOUT line numbers)
      * @param contextLines - Number of context lines to return before and after the edit (default: 8)
      * @returns Object containing success message, precise before/after comparison, and diagnostics
-     * @throws Error if file editing fails or if the edit range is too large
+     * @throws Error if file editing fails
      */
     editFile(filePath: string, startLine: number, endLine: number, newContent: string, contextLines?: number): Promise<{
         message: string;

package/dist/mcp/filesystem.js

@@ -206,8 +206,8 @@ export class FilesystemMCPService {
     }
     /**
      * Edit a file by replacing lines within a specified range
-     * IMPORTANT: This tool enforces small, precise edits (max 15 lines per edit) to ensure accuracy.
-     * For larger changes, make multiple sequential edits instead of one large edit.
+     * BEST PRACTICE: Keep edits small and focused (≤15 lines recommended) for better accuracy.
+     * For larger changes, make multiple parallel edits to non-overlapping sections instead of one large edit.
      *
      * @param filePath - Path to the file to edit
      * @param startLine - Starting line number (1-indexed, inclusive) - get from filesystem_read output
@@ -215,7 +215,7 @@ export class FilesystemMCPService {
      * @param newContent - New content to replace the specified lines (WITHOUT line numbers)
      * @param contextLines - Number of context lines to return before and after the edit (default: 8)
      * @returns Object containing success message, precise before/after comparison, and diagnostics
-     * @throws Error if file editing fails or if the edit range is too large
+     * @throws Error if file editing fails
      */
     async editFile(filePath, startLine, endLine, newContent, contextLines = 8) {
         try {
@@ -240,18 +240,7 @@ export class FilesystemMCPService {
             }
             // Adjust endLine if it exceeds file length
             const adjustedEndLine = Math.min(endLine, totalLines);
-            // ENFORCE SMALL EDITS: Limit to max 15 lines per edit for precision
             const linesToModify = adjustedEndLine - startLine + 1;
-            const MAX_LINES_PER_EDIT = 15;
-            if (linesToModify > MAX_LINES_PER_EDIT) {
-                throw new Error(`❌ Edit range too large (${linesToModify} lines). Maximum allowed: ${MAX_LINES_PER_EDIT} lines.\n\n` +
-                    `💡 Best Practice: Make SMALL, PRECISE edits instead of large changes.\n` +
-                    `   - Break your changes into multiple sequential edits\n` +
-                    `   - Each edit should modify at most ${MAX_LINES_PER_EDIT} lines\n` +
-                    `   - This ensures accuracy and prevents syntax errors\n\n` +
-                    `Current request: lines ${startLine}-${adjustedEndLine} (${linesToModify} lines)\n` +
-                    `Suggested approach: Split into ${Math.ceil(linesToModify / MAX_LINES_PER_EDIT)} smaller edits`);
-            }
             // Backup file before editing
             await incrementalSnapshotManager.backupFile(fullPath);
             // Extract the lines that will be replaced (for comparison)
@@ -317,8 +306,18 @@ export class FilesystemMCPService {
                 const errorCount = diagnostics.filter(d => d.severity === 'error').length;
                 const warningCount = diagnostics.filter(d => d.severity === 'warning').length;
                 if (errorCount > 0 || warningCount > 0) {
-                    result.message += `\n\n⚠️  Diagnostics detected: ${errorCount} error(s), ${warningCount} warning(s)\n` +
-                        `   ⚡ TIP: Check the diagnostics and make another small edit to fix issues`;
+                    result.message += `\n\n⚠️  Diagnostics detected: ${errorCount} error(s), ${warningCount} warning(s)`;
+                    // Format diagnostics for better readability
+                    const formattedDiagnostics = diagnostics
+                        .filter(d => d.severity === 'error' || d.severity === 'warning')
+                        .map(d => {
+                        const icon = d.severity === 'error' ? '❌' : '⚠️';
+                        const location = `${filePath}:${d.line}:${d.character}`;
+                        return `   ${icon} [${d.source || 'unknown'}] ${location}\n      ${d.message}`;
+                    })
+                        .join('\n\n');
+                    result.message += `\n\n📋 Diagnostic Details:\n${formattedDiagnostics}`;
+                    result.message += `\n\n   ⚡ TIP: Review the errors above and make another small edit to fix them`;
                 }
             }
             return result;
@@ -441,7 +440,7 @@ export const filesystemService = new FilesystemMCPService();
 export const mcpTools = [
     {
         name: 'filesystem_read',
-        description: 'Read the content of a file within specified line range. The returned content includes line numbers (format: "lineNum→content") for precise editing. You MUST specify startLine and endLine. To read the entire file, use startLine=1 and a large endLine value (e.g., 999999). IMPORTANT: When you need to edit a file, you MUST read it first to see the exact line numbers and current content. NOTE: If the path points to a directory, this tool will automatically list its contents instead of throwing an error.',
+        description: 'Read the content of a file within specified line range. The returned content includes line numbers (format: "lineNum→content") for precise editing. You MUST specify startLine and endLine. To read the entire file, use startLine=1 and a large endLine value (e.g., 500). IMPORTANT: When you need to edit a file, you MUST read it first to see the exact line numbers and current content. NOTE: If the path points to a directory, this tool will automatically list its contents instead of throwing an error.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -514,7 +513,7 @@ export const mcpTools = [
     },
     {
         name: 'filesystem_edit',
-        description: '🎯 PREFERRED tool for precise file editing. **CRITICAL CONSTRAINTS**: (1) Maximum 15 lines per edit - larger changes will be REJECTED, (2) Must use exact line numbers from filesystem_read output. **BEST PRACTICES**: Use SMALL, INCREMENTAL edits instead of large changes. Multiple small edits are SAFER and MORE ACCURATE than one large edit. This prevents syntax errors and bracket mismatches. **WORKFLOW**: (1) Read target section with filesystem_read to get exact line numbers, (2) Edit SMALL sections (≤15 lines), (3) Verify with diagnostics, (4) Make next small edit if needed. Returns precise before/after comparison with line numbers and VS Code diagnostics.',
+        description: '🎯 PREFERRED tool for precise file editing. **BEST PRACTICES**: (1) Use SMALL, INCREMENTAL edits (recommended ≤15 lines per edit) instead of large changes - this is SAFER and MORE ACCURATE, preventing syntax errors and bracket mismatches. (2) For large changes, make MULTIPLE PARALLEL edits to different sections of the file instead of one large edit. (3) Must use exact line numbers from filesystem_read output. **WORKFLOW**: (1) Read target section with filesystem_read to get exact line numbers, (2) Edit small sections, (3) Verify with diagnostics, (4) If editing multiple sections, you can make parallel edits to non-overlapping line ranges. Returns precise before/after comparison with line numbers and VS Code diagnostics.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -528,7 +527,7 @@ export const mcpTools = [
                 },
                 endLine: {
                     type: 'number',
-                    description: '⚠️  CRITICAL: Ending line number (1-indexed, inclusive). MUST match exact line number from filesystem_read output. Range CANNOT exceed 15 lines (endLine - startLine + 1 ≤ 15).'
+                    description: '⚠️  CRITICAL: Ending line number (1-indexed, inclusive). MUST match exact line number from filesystem_read output. 💡 TIP: Keep edits small (≤15 lines recommended) for better accuracy.'
                 },
                 newContent: {
                     type: 'string',

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "snow-ai",
-	"version": "0.2.7",
+	"version": "0.2.9",
 	"description": "Intelligent Command Line Assistant powered by AI",
 	"license": "MIT",
 	"bin": {

package/readme.md

@@ -6,4 +6,57 @@
 
 ```bash
 $ npm install --global snow-ai
-```
+```
+
+## Start
+```bash
+$ snow
+```
+
+## Update
+```bash
+$ snow --update
+```
+
+## Config example  `./User/.snow/config.json`
+```json
+{
+  "openai": {
+    "baseUrl": "https://api.openai.com/v1",
+    "apiKey": "your-api-key",
+    "requestMethod": "responses",
+    "advancedModel": "gpt-5-codex",
+    "basicModel": "gpt-5-codex",
+    "maxContextTokens": 200000,
+    "compactModel": {
+      "baseUrl": "https://api.openai.com/v1",
+      "apiKey": "your-api-key",
+      "modelName": "gpt-4.1-mini"
+    }
+  }
+}
+```
+
+## Uninstall
+```bash
+$ npm uninstall --global snow-ai
+```
+
+## Install VSCode Extension
+
+* download [VSIX/snow-cli-0.2.5.vsix](https://github.com/MayDay-wpf/snow-cli/blob/main/VSIX/snow-cli-0.2.5.vsix)
+
+* open VSCode, click `Extensions` -> `Install from VSIX...` -> select `snow-cli-0.2.5.vsix`
+
+## Live View
+* **Welcome & Settings**
+
+![alt text](image.png)
+
+* **Agent**
+
+![alt text](image-1.png)
+
+* **Commands**
+
+![alt text](image-2.png)