sapper-iq 1.1.26 → 1.1.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sapper-iq",
-  "version": "1.1.26",
+  "version": "1.1.28",
   "description": "AI-powered development assistant that executes commands and builds projects",
   "main": "sapper.mjs",
   "bin": {

package/sapper.mjs

@@ -498,9 +498,9 @@ async function runSapper() {
   
   // Quick tips box
   console.log(box(
-    `${chalk.yellow('💡')} Type ${chalk.cyan('/help')} for commands\n` +
+    `${chalk.yellow('💡')} Use ${chalk.cyan('@file')} to attach files (e.g., "fix @app.js")\n` +
     `${chalk.yellow('💡')} Type ${chalk.cyan('/scan')} to load entire codebase\n` +
-    `${chalk.yellow('💡')} Type ${chalk.cyan('exit')} to quit`,
+    `${chalk.yellow('💡')} Type ${chalk.cyan('/help')} for all commands`,
     'Quick Tips', 'gray'
   ));
   console.log();
@@ -552,13 +552,23 @@ async function runSapper() {
   if (messages.length === 0) {
     messages = [{
       role: 'system',
-      content: `You are Sapper, an AGENT, You can use tools to take action:
-- [TOOL:LIST]path[/TOOL] - List directory
-- [TOOL:READ]path[/TOOL] - Read file
-- [TOOL:SEARCH]pattern[/TOOL] - Search codebase
-- [TOOL:WRITE]path:::content[/TOOL] - Create/overwrite file (use ::: between path and content)
-- [TOOL:PATCH]path:::old|||new[/TOOL] - Edit file
-- [TOOL:SHELL]command[/TOOL] - Run terminal command`
+      content: `You are Sapper, a high-level Autonomous Software Engineer.
+Your goal is to solve the user's request by interacting with the filesystem and shell.
+
+RULES:
+1. EXPLORE FIRST: Use LIST and READ to understand the codebase before making changes.
+2. THINK IN STEPS: Explain what you found and what you plan to do before executing tools.
+3. BE PRECISE: When using PATCH, ensure the 'oldText' matches exactly.
+4. VERIFY: After writing code, use the SHELL tool to run tests or linting.
+5. NO HALLUCINATIONS: If a file doesn't exist, don't guess its content. List the directory instead.
+
+TOOL SYNTAX:
+- [TOOL:LIST]dir[/TOOL] - List directory contents
+- [TOOL:READ]file_path[/TOOL] - Read file contents
+- [TOOL:SEARCH]pattern[/TOOL] - Search codebase for pattern
+- [TOOL:WRITE]path:::content[/TOOL] - Create/overwrite file
+- [TOOL:PATCH]path:::old|||new[/TOOL] - Edit existing file
+- [TOOL:SHELL]command[/TOOL] - Run shell command`
     }];
   }
 
@@ -641,13 +651,22 @@ async function runSapper() {
         // 4. Add reminder to stay in Agent Mode (not chatbot mode)
         messages.push({ 
           role: 'system', 
-          content: `CONTEXT PRUNED. REMINDER: You are an AGENT, You can use tools to take action:
-- [TOOL:LIST]path[/TOOL] - List directory
-- [TOOL:READ]path[/TOOL] - Read file
-- [TOOL:SEARCH]pattern[/TOOL] - Search codebase
-- [TOOL:WRITE]path:::content[/TOOL] - Create/overwrite file (use ::: between path and content)
-- [TOOL:PATCH]path:::old|||new[/TOOL] - Edit file
-- [TOOL:SHELL]command[/TOOL] - Run terminal command.`
+          content: `CONTEXT PRUNED. REMINDER: You are Sapper, an Autonomous Software Engineer.
+
+RULES:
+1. EXPLORE FIRST: Use LIST and READ before making changes.
+2. THINK IN STEPS: Explain your plan before executing tools.
+3. BE PRECISE: When using PATCH, ensure 'oldText' matches exactly.
+4. VERIFY: Run tests or linting after writing code.
+5. NO HALLUCINATIONS: Don't guess file contents.
+
+TOOL SYNTAX:
+- [TOOL:LIST]dir[/TOOL]
+- [TOOL:READ]file_path[/TOOL]
+- [TOOL:SEARCH]pattern[/TOOL]
+- [TOOL:WRITE]path:::content[/TOOL]
+- [TOOL:PATCH]path:::old|||new[/TOOL]
+- [TOOL:SHELL]command[/TOOL]`
         });
         
         // 5. Save to context file so it persists
@@ -662,6 +681,7 @@ async function runSapper() {
       if (input.toLowerCase() === '/help') {
         console.log();
         const helpContent = 
+          `${chalk.cyan('@file')}          ${chalk.gray('│')} Attach file to prompt (e.g., @src/app.js)\n` +
           `${chalk.cyan('/scan')}          ${chalk.gray('│')} Scan codebase into context\n` +
           `${chalk.cyan('/recall')}        ${chalk.gray('│')} Search memory for relevant context\n` +
           `${chalk.cyan('/reset /clear')}  ${chalk.gray('│')} Clear all context\n` +
@@ -770,7 +790,51 @@ async function runSapper() {
         continue;
       }
       
-      messages.push({ role: 'user', content: input });
+      // Process @file attachments in prompt (e.g., "analyze @package.json" or "fix @src/index.js")
+      let processedInput = input;
+      const fileAttachments = [];
+      const attachRegex = /@([\w.\/\-_]+)/g;
+      let attachMatch;
+      
+      while ((attachMatch = attachRegex.exec(input)) !== null) {
+        const filePath = attachMatch[1];
+        try {
+          if (fs.existsSync(filePath)) {
+            const stats = fs.statSync(filePath);
+            if (stats.isFile()) {
+              if (stats.size > MAX_FILE_SIZE) {
+                console.log(chalk.yellow(`⚠️  @${filePath} is too large (${Math.round(stats.size/1024)}KB), skipping`));
+              } else {
+                const content = fs.readFileSync(filePath, 'utf8');
+                fileAttachments.push({ path: filePath, content, size: stats.size });
+                console.log(chalk.green(`📎 Attached: ${filePath} (${Math.round(stats.size/1024)}KB)`));
+              }
+            }
+          } else {
+            // Not a file - might be an @mention for something else, ignore
+          }
+        } catch (e) {
+          console.log(chalk.yellow(`⚠️  Could not read @${filePath}: ${e.message}`));
+        }
+      }
+      
+      // Build the final message with attachments
+      if (fileAttachments.length > 0) {
+        let attachedContent = '\n\n══════════════════════════════════════\n';
+        attachedContent += `📎 ATTACHED FILES (${fileAttachments.length})\n`;
+        attachedContent += '══════════════════════════════════════\n\n';
+        
+        for (const file of fileAttachments) {
+          attachedContent += `┌─── ${file.path} ───\n`;
+          attachedContent += file.content;
+          if (!file.content.endsWith('\n')) attachedContent += '\n';
+          attachedContent += `└─── END ${file.path} ───\n\n`;
+        }
+        
+        processedInput = input + attachedContent;
+      }
+      
+      messages.push({ role: 'user', content: processedInput });
 
       let toolRounds = 0; // Prevent infinite loops
       const MAX_TOOL_ROUNDS = 20;