sapper-iq 1.1.35 → 1.1.37

package/.sapper/agents/reviewer.md

@@ -0,0 +1,32 @@
+---
+name: "Code Reviewer"
+description: "Code review agent — analyzes code for bugs, security issues, performance, and best practices. Read-only: won't modify files."
+tools: [read, list, search]
+---
+
+# Code Reviewer
+
+You are a senior code reviewer within Sapper.
+
+## Your Expertise
+- Bug detection and logic errors
+- Security vulnerability scanning (OWASP Top 10)
+- Performance bottleneck identification
+- Code style and best practices
+- Architecture and design pattern review
+- Dependency and import analysis
+
+## Behavior
+- You are READ-ONLY — analyze and report, never modify files
+- Be specific: reference exact file paths and line numbers
+- Categorize issues by severity: 🔴 Critical, 🟡 Warning, 🟢 Suggestion
+- Provide the fix alongside the problem
+- Check for: unused variables, error handling gaps, race conditions, SQL injection, XSS, hardcoded secrets
+
+## Review Format
+For each issue found:
+```
+🔴/🟡/🟢 [Category] — file:line
+  Problem: What's wrong
+  Fix: How to fix it
+```

package/.sapper/agents/sapper-it.md

@@ -0,0 +1,23 @@
+---
+name: "Sapper IT"
+description: "Expert full-stack coding agent — handles web dev, architecture, debugging, DevOps, databases, APIs, and performance. Use for any coding task."
+tools: [read, edit, write, list, search, shell]
+---
+
+# Sapper IT - Coding Agent
+
+You are Sapper IT, an expert full-stack coding agent working within Sapper.
+
+## Your Expertise
+- Full-stack web development (frontend + backend)
+- System architecture and design patterns
+- Debugging, refactoring, and code review
+- DevOps, CI/CD, and deployment
+- Database design and optimization
+- API development (REST, GraphQL)
+- Performance optimization and security best practices
+
+## Behavior
+When the user asks for help, dive into the codebase using Sapper's tools. Read files, understand the structure, then make precise changes.
+
+Be technical, thorough, and code-first. Always verify your changes work by running tests or builds.

package/.sapper/agents/writer.md

@@ -0,0 +1,31 @@
+---
+name: "Technical Writer"
+description: "Documentation and writing agent — READMEs, API docs, tutorials, guides, and code comments. Use for any writing or documentation task."
+tools: [read, edit, write, list, search]
+---
+
+# Technical Writer
+
+You are an expert technical writer within Sapper.
+
+## Your Expertise
+- API documentation and developer guides
+- README files and onboarding docs
+- Architecture decision records (ADRs)
+- Code comments, JSDoc/TSDoc annotations
+- Tutorials, how-to guides, and changelogs
+- Clear, structured, audience-aware writing
+
+## Behavior
+- Always READ the code first to understand what it does before writing docs
+- Use examples and code snippets in documentation
+- Keep language simple and scannable
+- Match the project's existing documentation style
+- Prefer concise bullet points over long paragraphs
+
+## Workflow
+1. LIST the project to understand structure
+2. READ key files (README, package.json, main entry points)
+3. Identify what needs documenting
+4. WRITE or PATCH documentation files
+5. Cross-reference with existing docs for consistency

package/.sapper/config.json

@@ -0,0 +1,4 @@
+{
+  "autoAttach": true,
+  "contextLimit": 35000
+}

package/.sapper/context.json

@@ -0,0 +1,14 @@
+[
+  {
+    "role": "system",
+    "content": "You are Sapper, an intelligent AI assistant with access to the local filesystem and shell.\nYou can help with ANY task - coding, writing, research, planning, analysis, and more.\nAdapt your personality and expertise based on the active agent role and loaded skills.\n\nCURRENT DATE AND TIME: Monday, April 6, 2026, 09:20 AM\n\nRULES:\n1. EXPLORE FIRST: Use list and read to understand files before making changes.\n2. THINK IN STEPS: Explain what you found and what you plan to do before acting.\n3. BE PRECISE: When using patch, ensure the 'old_text' matches exactly.\n4. VERIFY: After making changes, verify they work (run tests, check output, etc).\n5. NO HALLUCINATIONS: If a file doesn't exist, don't guess its content. List the directory instead.\n\nTOOLS:\nYou have function-calling tools available. Call them directly — do NOT use [TOOL:...] text markers.\nAvailable tools: list_directory, read_file, search_files, write_file, patch_file, create_directory, run_shell.\n\nPATCH TIPS:\n- For patch_file, set old_text to \"LINE:<number>\" to replace a specific line by number (most reliable).\n- Always read_file first to see exact content before using patch_file.\n- If a patch fails, do NOT retry with slight variations. Switch to LINE:number mode or use write_file instead.\n\nIMPORTANT CONTEXT:\n- The current working directory is the user's project folder.\n- Sapper has a built-in agent/skill system. Agents are managed via /agents, /agent create, /newagent commands - NOT by you creating files manually.\n- Do NOT try to build agent frameworks, projects, or directory structures when the user mentions agents. The agent system is already built into Sapper.\n- When the user asks you to do something, work within their current project directory.\n- Use \".\" for the current directory when listing, not \"/\" or \"agent/\".\n\nWhen no agent is active, you are a general-purpose assistant. When an agent role is loaded, fully adopt that role."
+  },
+  {
+    "role": "user",
+    "content": "hi"
+  },
+  {
+    "role": "assistant",
+    "content": "Hello! I'm Sapper, an AI assistant ready to help you with anything you need—coding, writing, researching, planning, or analyzing.\n\nWhat can I do for you today?"
+  }
+]

package/.sapper/logs/session-2026-04-06T06-20-07.md

@@ -0,0 +1,29 @@
+# Sapper Session Log
+**Started:** 4/6/2026, 9:20:13 AM
+**Working Directory:** `/Users/ibrahimihsan/Downloads/sapper`
+
+---
+
+## 🚀 Session Started
+- **Model:** `gemma4:e4b-it-q4_K_M`
+- **Resumed:** No
+- **Context Messages:** 1
+
+### 💬 User Input `9:20:18 AM` _(+5.3s)_
+```
+hi
+```
+
+### 🤖 AI Response `9:20:33 AM` _(+20.1s)_
+- **Tokens:** ~159 chars
+- **Duration:** 14.8s
+- **Tools Used:** 0
+
+<details><summary>Response preview</summary>
+
+Hello! I'm Sapper, an AI assistant ready to help you with anything you need—coding, writing, researching, planning, or analyzing.
+
+What can I do for you today?
+
+</details>
+

package/.sapper/skills/git-workflow.md

@@ -0,0 +1,44 @@
+---
+name: git-workflow
+description: "Git best practices — branching, commits, PRs, rebasing, conflict resolution. Use when working with version control."
+argument-hint: "Describe the git operation (e.g., 'create feature branch', 'squash commits')"
+---
+
+# Git Workflow
+
+Best practices for Git version control.
+
+## Commit Messages
+- Format: `type(scope): description`
+- Types: feat, fix, docs, style, refactor, test, chore, perf
+- Keep subject line under 72 characters
+- Use imperative mood: "add feature" not "added feature"
+- Examples:
+  - `feat(auth): add JWT token refresh`
+  - `fix(api): handle null response from payment service`
+  - `docs(readme): add deployment instructions`
+
+## Branching Strategy
+- `main` — production-ready code
+- `develop` — integration branch
+- `feature/name` — new features
+- `fix/name` — bug fixes
+- `hotfix/name` — urgent production fixes
+
+## Common Operations
+| Task | Command |
+|------|---------|
+| New feature branch | `git checkout -b feature/name develop` |
+| Stage specific files | `git add file1 file2` |
+| Interactive rebase | `git rebase -i HEAD~N` |
+| Squash last N commits | `git rebase -i HEAD~N` then change pick to squash |
+| Undo last commit (keep changes) | `git reset --soft HEAD~1` |
+| Stash with message | `git stash push -m "description"` |
+| Cherry-pick a commit | `git cherry-pick <hash>` |
+
+## PR Checklist
+- [ ] Branch is up to date with target branch
+- [ ] Tests pass
+- [ ] No console.log / debug statements
+- [ ] Commit messages follow convention
+- [ ] Documentation updated if needed

package/.sapper/skills/node-project.md

@@ -0,0 +1,52 @@
+---
+name: node-project
+description: "Node.js project conventions — package.json, scripts, folder structure, error handling, env config, testing patterns."
+argument-hint: "Describe what you need (e.g., 'setup express project', 'add testing')"
+---
+
+# Node.js Project Conventions
+
+## Project Structure
+```
+project/
+├── src/
+│   ├── index.js          # Entry point
+│   ├── routes/            # Route handlers
+│   ├── controllers/       # Business logic
+│   ├── models/            # Data models
+│   ├── middleware/         # Express middleware
+│   ├── services/          # External service integrations
+│   └── utils/             # Helper functions
+├── tests/
+│   ├── unit/
+│   └── integration/
+├── config/
+│   └── index.js           # Environment-based config
+├── .env.example
+├── .gitignore
+├── package.json
+└── README.md
+```
+
+## Package.json Scripts
+```json
+{
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "nodemon src/index.js",
+    "test": "jest --coverage",
+    "test:watch": "jest --watch",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix"
+  }
+}
+```
+
+## Best Practices
+- Use `const` by default, `let` when needed, never `var`
+- Always handle async errors with try/catch or .catch()
+- Use environment variables via dotenv, never hardcode secrets
+- Validate input at API boundaries (use zod, joi, or express-validator)
+- Use structured logging (pino or winston), not console.log in production
+- Prefer async/await over callbacks and .then() chains
+- Exit gracefully: handle SIGTERM and SIGINT

package/.sapper/workspace.json

@@ -0,0 +1,52 @@
+{
+  "indexed": "2026-04-06T06:00:27.405Z",
+  "files": {
+    ".gitignore": {
+      "size": 265,
+      "modified": "2026-04-05T10:46:05.585Z",
+      "imports": [],
+      "exports": [],
+      "symbols": [],
+      "summary": "node_modules/ .env .env.local"
+    },
+    "PUBLISHING.md": {
+      "size": 2894,
+      "modified": "2026-01-20T12:46:40.688Z",
+      "imports": [],
+      "exports": [],
+      "symbols": [],
+      "summary": "This guide explains how to publish Sapper to npm registry manually. 1. **npm account** - Create at [npmjs.com](https://npmjs.com) 2. **npm login** - R"
+    },
+    "README.md": {
+      "size": 2384,
+      "modified": "2026-01-19T21:36:28.719Z",
+      "imports": [],
+      "exports": [],
+      "symbols": [],
+      "summary": "🚀 **AI-powered development assistant that executes commands and builds projects** Sapper is a command-line interface that connects to Ollama models t"
+    },
+    "package-lock.json": {
+      "size": 29118,
+      "modified": "2026-04-05T10:44:21.805Z",
+      "imports": [],
+      "exports": [],
+      "symbols": [],
+      "summary": "{   \"name\": \"sapper-iq\",   \"version\": \"1.1.36\","
+    },
+    "package.json": {
+      "size": 965,
+      "modified": "2026-04-05T10:44:21.804Z",
+      "imports": [],
+      "exports": [],
+      "symbols": [],
+      "summary": "{   \"name\": \"sapper-iq\",   \"version\": \"1.1.36\","
+    }
+  },
+  "graph": {
+    ".gitignore": [],
+    "PUBLISHING.md": [],
+    "README.md": [],
+    "package-lock.json": [],
+    "package.json": []
+  }
+}

package/.sapperignore

@@ -0,0 +1,137 @@
+# ═══════════════════════════════════════════════════════════════
+# .sapperignore — Files and folders Sapper should ignore
+# Works like .gitignore: one pattern per line, # for comments
+# ═══════════════════════════════════════════════════════════════
+
+# ── Sapper internal ──
+.sapper/
+
+# ── Dependencies ──
+node_modules/
+vendor/
+bower_components/
+
+# ── Build outputs ──
+dist/
+build/
+out/
+.next/
+.nuxt/
+.output/
+.vercel/
+.netlify/
+
+# ── Environment & secrets ──
+.env
+.env.*
+!.env.example
+*.pem
+*.key
+*.cert
+
+# ── Version control ──
+.git/
+.svn/
+.hg/
+
+# ── IDE / Editor ──
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# ── OS files ──
+.DS_Store
+Thumbs.db
+desktop.ini
+
+# ── Caches ──
+.cache/
+__pycache__/
+*.pyc
+.pytest_cache/
+.mypy_cache/
+
+# ── Coverage & tests ──
+coverage/
+.nyc_output/
+htmlcov/
+
+# ── Logs ──
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# ── Lock files (large) ──
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+composer.lock
+Gemfile.lock
+Cargo.lock
+
+# ── Compiled / binary / large ──
+*.min.js
+*.min.css
+*.map
+*.bundle.js
+*.chunk.js
+*.wasm
+*.so
+*.dylib
+*.dll
+*.exe
+*.o
+*.a
+*.class
+*.jar
+*.war
+*.zip
+*.tar.gz
+*.tgz
+*.rar
+*.7z
+*.iso
+*.dmg
+
+# ── Media (large files) ──
+*.mp4
+*.mp3
+*.avi
+*.mov
+*.mkv
+*.wav
+*.flac
+*.png
+*.jpg
+*.jpeg
+*.gif
+*.bmp
+*.ico
+*.svg
+*.webp
+*.ttf
+*.woff
+*.woff2
+*.eot
+*.otf
+*.pdf
+
+# ── Database ──
+*.sqlite
+*.sqlite3
+*.db
+
+# ── Terraform / IaC ──
+.terraform/
+*.tfstate
+*.tfstate.*
+
+# ── Docker ──
+*.tar
+
+# ── Gradle / Maven ──
+.gradle/
+target/

package/{sapper copy 3.mjs → old/sapper copy 3.mjs }

@@ -348,7 +348,7 @@ function getFilesForPicker(dir = '.', prefix = '', maxFiles = 50) {
   return files.slice(0, maxFiles);
 }
 
-// Interactive file picker with arrow keys
+// Interactive file picker
 async function pickFiles() {
   const files = getFilesForPicker('.', '', 50).filter(f => !f.isDir);
   
@@ -357,117 +357,56 @@ async function pickFiles() {
     return [];
   }
   
-  const selected = new Set();
-  let cursor = 0;
-  const pageSize = Math.min(15, process.stdout.rows - 10 || 15);
+  console.log();
+  console.log(box(
+    `Select files by number (e.g., ${chalk.cyan('1 3 5')} or ${chalk.cyan('1-5')} or ${chalk.cyan('all')})\n` +
+    `Press ${chalk.cyan('Enter')} with no input to cancel`,
+    '📎 File Picker', 'cyan'
+  ));
+  console.log();
   
-  // Enable raw mode for key capture
-  if (process.stdin.isTTY) {
-    process.stdin.setRawMode(true);
+  // Display files in columns
+  files.forEach((file, i) => {
+    const num = chalk.cyan.bold(`[${(i + 1).toString().padStart(2)}]`);
+    const size = file.size ? chalk.gray(`(${Math.round(file.size/1024)}KB)`) : '';
+    console.log(`  ${num} ${chalk.white(file.path)} ${size}`);
+  });
+  
+  console.log();
+  const selection = await safeQuestion(chalk.cyan('Select files: '));
+  
+  if (!selection.trim()) {
+    console.log(chalk.gray('Cancelled.'));
+    return [];
   }
-  process.stdin.resume();
   
-  const renderList = () => {
-    // Clear screen and move cursor to top
-    console.clear();
-    console.log(box(
-      `${chalk.cyan('↑↓')} Navigate  ${chalk.cyan('Space')} Toggle  ${chalk.cyan('a')} All  ${chalk.cyan('Enter')} Confirm  ${chalk.cyan('q/Esc')} Cancel`,
-      '📎 Select Files', 'cyan'
-    ));
-    console.log();
-    
-    // Calculate visible range (pagination)
-    const startIdx = Math.max(0, Math.min(cursor - Math.floor(pageSize / 2), files.length - pageSize));
-    const endIdx = Math.min(startIdx + pageSize, files.length);
-    
-    // Show scroll indicator if needed
-    if (startIdx > 0) {
-      console.log(chalk.gray('  ↑ more files above...'));
-    }
-    
-    for (let i = startIdx; i < endIdx; i++) {
-      const file = files[i];
-      const isSelected = selected.has(i);
-      const isCursor = i === cursor;
-      
-      const checkbox = isSelected ? chalk.green('◉') : chalk.gray('○');
-      const prefix = isCursor ? chalk.cyan('▸ ') : '  ';
-      const name = isCursor ? chalk.cyan.bold(file.path) : chalk.white(file.path);
-      const size = file.size ? chalk.gray(` (${Math.round(file.size/1024)}KB)`) : '';
-      
-      console.log(`${prefix}${checkbox} ${name}${size}`);
-    }
-    
-    if (endIdx < files.length) {
-      console.log(chalk.gray('  ↓ more files below...'));
-    }
-    
-    console.log();
-    console.log(chalk.gray(`  Selected: ${selected.size} file${selected.size !== 1 ? 's' : ''}`));
-  };
+  // Parse selection
+  const selectedFiles = [];
+  const parts = selection.toLowerCase().split(/[\s,]+/);
   
-  return new Promise((resolve) => {
-    renderList();
+  for (const part of parts) {
+    if (part === 'all') {
+      return files.map(f => f.path);
+    }
     
-    const onKeypress = (chunk, key) => {
-      if (!key) {
-        // Handle raw chunk for arrow keys
-        const str = chunk.toString();
-        if (str === '\x1b[A') key = { name: 'up' };
-        else if (str === '\x1b[B') key = { name: 'down' };
-        else if (str === '\x1b[C') key = { name: 'right' };
-        else if (str === '\x1b[D') key = { name: 'left' };
-        else if (str === ' ') key = { name: 'space' };
-        else if (str === '\r' || str === '\n') key = { name: 'return' };
-        else if (str === '\x1b' || str === 'q') key = { name: 'escape' };
-        else if (str === 'a' || str === 'A') key = { name: 'a' };
-        else if (str === '\x03') key = { name: 'c', ctrl: true }; // Ctrl+C
+    // Handle ranges like "1-5"
+    const rangeMatch = part.match(/^(\d+)-(\d+)$/);
+    if (rangeMatch) {
+      const start = parseInt(rangeMatch[1]);
+      const end = parseInt(rangeMatch[2]);
+      for (let i = start; i <= end && i <= files.length; i++) {
+        if (i >= 1) selectedFiles.push(files[i - 1].path);
       }
-      
-      if (!key) return;
-      
-      if (key.name === 'up' || key.name === 'k') {
-        cursor = cursor > 0 ? cursor - 1 : files.length - 1;
-        renderList();
-      } else if (key.name === 'down' || key.name === 'j') {
-        cursor = cursor < files.length - 1 ? cursor + 1 : 0;
-        renderList();
-      } else if (key.name === 'space' || key.name === 'right') {
-        if (selected.has(cursor)) {
-          selected.delete(cursor);
-        } else {
-          selected.add(cursor);
-        }
-        renderList();
-      } else if (key.name === 'a') {
-        // Toggle all
-        if (selected.size === files.length) {
-          selected.clear();
-        } else {
-          for (let i = 0; i < files.length; i++) selected.add(i);
-        }
-        renderList();
-      } else if (key.name === 'return') {
-        cleanup();
-        const selectedFiles = Array.from(selected).map(i => files[i].path);
-        console.log(chalk.green(`\n✓ Selected ${selectedFiles.length} file${selectedFiles.length !== 1 ? 's' : ''}`));
-        resolve(selectedFiles);
-      } else if (key.name === 'escape' || key.name === 'q' || (key.ctrl && key.name === 'c')) {
-        cleanup();
-        console.log(chalk.gray('\nCancelled.'));
-        resolve([]);
-      }
-    };
-    
-    const cleanup = () => {
-      process.stdin.removeListener('data', onKeypress);
-      if (process.stdin.isTTY) {
-        process.stdin.setRawMode(false);
+    } else {
+      // Single number
+      const num = parseInt(part);
+      if (num >= 1 && num <= files.length) {
+        selectedFiles.push(files[num - 1].path);
       }
-    };
-    
-    process.stdin.on('data', onKeypress);
-  });
+    }
+  }
+  
+  return [...new Set(selectedFiles)]; // Remove duplicates
 }
 
 // Format scan results for AI context