codesavant 1.1.0 → 1.2.2

package/dist/cli.js

@@ -371,6 +371,63 @@ var init_knowledge_base = __esm({
         ],
         priority: 85
       },
+      {
+        id: "npm-network-error",
+        pattern: /npm ERR!.*network|ETIMEDOUT|ECONNREFUSED|ENOTFOUND.*registry|fetch failed/i,
+        category: "dependency",
+        subcategory: "network",
+        diagnosis: "npm network error. Cannot connect to the npm registry.",
+        suggestions: [
+          "Check your internet connection",
+          "Verify npm registry: npm config get registry",
+          "Try: npm config set registry https://registry.npmjs.org/",
+          "Check if behind a proxy and configure npm accordingly",
+          "Wait a moment and retry - registry may be temporarily unavailable"
+        ],
+        priority: 90
+      },
+      {
+        id: "npm-invalid-package-json",
+        pattern: /npm ERR!.*package\.json|Invalid package\.json|unexpected end of JSON|Unexpected token.*package\.json/i,
+        category: "dependency",
+        subcategory: "config",
+        diagnosis: "Invalid package.json file. The file contains syntax errors or is malformed.",
+        suggestions: [
+          "Validate package.json syntax at https://jsonlint.com/",
+          "Check for trailing commas, missing quotes, or incorrect brackets",
+          "Recreate package.json: npm init -y"
+        ],
+        priority: 95
+      },
+      {
+        id: "npx-package-not-found",
+        pattern: /npx.*command not found|npm ERR! could not determine executable|create-.*not found/i,
+        category: "dependency",
+        subcategory: "missing_package",
+        diagnosis: "npx could not find the package to execute.",
+        suggestions: [
+          "Check the package name is correct",
+          "Try installing globally first: npm install -g {package}",
+          "Clear npx cache: npx clear-npx-cache",
+          "Ensure npm is up to date: npm install -g npm"
+        ],
+        priority: 85
+      },
+      {
+        id: "create-app-failed",
+        pattern: /create-react-app.*failed|create-next-app.*failed|vite.*create.*failed|project.*creation.*failed/i,
+        category: "dependency",
+        subcategory: "project_creation",
+        diagnosis: "Project scaffolding failed. The project creation tool encountered an error.",
+        suggestions: [
+          "Try with a different directory name (avoid special characters)",
+          "Ensure you have write permissions in the target directory",
+          "Clear npm cache: npm cache clean --force",
+          "Check if Node.js version is compatible with the framework",
+          "Try creating in current directory: npx create-{tool}@latest ."
+        ],
+        priority: 92
+      },
       // ============================================================
       // GIT ERRORS (8 patterns)
       // ============================================================
@@ -5398,6 +5455,9 @@ var init_commands = __esm({
 // src/cli.ts
 import { Command } from "commander";
 import chalk20 from "chalk";
+import { readFileSync as readFileSync2 } from "fs";
+import { fileURLToPath } from "url";
+import { dirname, join as join3 } from "path";
 
 // src/config.ts
 import fs from "fs-extra";
@@ -5584,7 +5644,39 @@ Format the findings clearly for the user. Include:
 - Ignoring subagent output and exploring from scratch
 - Continuing without specific focus areas
 - Exceeding 3 continuation rounds
-- Passing vague instructions like "explore more"`;
+- Passing vague instructions like "explore more"
+
+## Project Creation Guide
+
+When creating new projects, use these proven commands for each framework:
+
+### React Projects
+- **Vite + React + TypeScript** (RECOMMENDED): \`npm create vite@latest my-app -- --template react-ts\`
+- **Create React App**: \`npx create-react-app my-app --template typescript\`
+
+### Next.js Projects
+- \`npx create-next-app@latest my-app --typescript --tailwind --eslint --app --src-dir\`
+
+### Vue Projects
+- **Vite + Vue**: \`npm create vite@latest my-app -- --template vue-ts\`
+- **Vue CLI**: \`npx @vue/cli create my-app\`
+
+### Adding Tailwind CSS
+After project creation, install Tailwind:
+\`\`\`bash
+npm install -D tailwindcss postcss autoprefixer
+npx tailwindcss init -p
+\`\`\`
+
+Then configure tailwind.config.js and add Tailwind directives to CSS.
+
+### Project Creation Rules
+1. ALWAYS create projects in the current working directory or a subdirectory
+2. NEVER use /tmp or system directories for project creation
+3. Use the --template flag with Vite for TypeScript support
+4. Run \`npm install\` after project creation if it fails during setup
+5. If npm install fails, try: \`npm cache clean --force\` then retry
+6. Check package.json exists before running npm commands`;
 async function loadConfig() {
   const configPath = path.join(os.homedir(), ".codesavant", "config.json");
   let fileConfig = {};
@@ -15631,6 +15723,20 @@ function validateWritePath(filePath, baseDir) {
 // src/tools/executor.ts
 var execAsync2 = promisify2(exec2);
 var executorConfig = null;
+function checkPathGuidance(targetPath) {
+  const cwd = process.cwd();
+  const absolutePath = path9.isAbsolute(targetPath) ? targetPath : path9.resolve(cwd, targetPath);
+  const unexpectedPaths = ["/tmp", "/var/tmp", "/temp", "/var/folders"];
+  for (const unexpectedPath of unexpectedPaths) {
+    if (absolutePath.startsWith(unexpectedPath)) {
+      return `[PATH GUIDANCE]: You're writing to ${absolutePath} which is a temporary directory. Your working directory is ${cwd}. If you intended to create files in the project, use a relative path like "./" or specify the full path within ${cwd}. Files in /tmp may be deleted on system restart.`;
+    }
+  }
+  if (!absolutePath.startsWith(cwd) && !absolutePath.startsWith(path9.resolve(cwd))) {
+    return `[PATH NOTE]: Writing to ${absolutePath} which is outside your working directory (${cwd}). This is allowed, but make sure this is intentional.`;
+  }
+  return null;
+}
 var subagentFindingsCache = /* @__PURE__ */ new Map();
 function getTaskKey(task) {
   const baseTask = task.replace(/CONTINUATION \(Round \d+ of \d+\)/gi, "").replace(/## Previous Findings[\s\S]*?(?=##|$)/gi, "").replace(/## Focus Areas[\s\S]*?(?=##|$)/gi, "").trim().slice(0, 100);
@@ -16015,13 +16121,20 @@ async function writeFile(input) {
       error: `Path validation failed: ${pathValidation.reason}`
     };
   }
+  const pathGuidance = checkPathGuidance(filePath);
   const absolutePath = path9.resolve(filePath);
   await checkpointManager.backupFileBeforeWrite(absolutePath);
   await fs10.ensureDir(path9.dirname(absolutePath));
   await fs10.writeFile(absolutePath, content);
+  let output = `Wrote ${content.length} bytes to ${filePath}`;
+  if (pathGuidance) {
+    output += `
+
+${pathGuidance}`;
+  }
   return {
     success: true,
-    output: `Wrote ${content.length} bytes to ${filePath}`
+    output
   };
 }
 async function editFile(input) {
@@ -30061,6 +30174,7 @@ function App({
   const lastEscapeRef = useRef(0);
   const [renderedMessageCount, setRenderedMessageCount] = useState5(0);
   const permissionModes = ["prompt", "auto-edit", "auto-full", "deny"];
+  const [currentPermissionMode, setCurrentPermissionMode] = useState5(permissionMode);
   useEffect2(() => {
     if (sessionId2) actions.setSessionId(sessionId2);
     if (provider && model) actions.setProvider(provider, model);
@@ -30139,11 +30253,14 @@ function App({
       setHistorySearchMatch(null);
       return;
     }
-    if (key.shift && key.tab && onPermissionModeChange) {
-      const currentIndex = permissionModes.indexOf(permissionMode);
+    if (key.shift && key.tab) {
+      const currentIndex = permissionModes.indexOf(currentPermissionMode);
       const nextIndex = (currentIndex + 1) % permissionModes.length;
       const nextMode = permissionModes[nextIndex];
-      onPermissionModeChange(nextMode);
+      setCurrentPermissionMode(nextMode);
+      if (onPermissionModeChange) {
+        onPermissionModeChange(nextMode);
+      }
       actions.addMessage({
         type: "system",
         content: `Permission mode: ${nextMode}`
@@ -30311,7 +30428,7 @@ function App({
         historyIndex: state.historyIndex,
         onHistoryNavigate: handleHistoryNavigate,
         theme,
-        permissionMode,
+        permissionMode: currentPermissionMode,
         historySearchMode,
         historySearchQuery,
         historySearchMatch,
@@ -30578,22 +30695,18 @@ function createInkREPL(replConfig) {
       }
       case "glob": {
         const pattern = toolInput?.pattern || "*";
-        const matchCount = output ? output.split("\n").filter((l) => l.trim()).length : 0;
-        const result = {
-          matchCount,
-          pattern,
-          preview: output.slice(0, 300)
-        };
-        return formatGlobResult(result, { collapsed: true });
+        const files = output ? output.split("\n").filter((l) => l.trim()) : [];
+        return formatGlobResult(files, pattern, { collapsed: true });
       }
       case "bash": {
+        const command = toolInput?.command || "bash command";
         const result = {
           exitCode: success ? 0 : 1,
           output: output.slice(0, 500),
           truncated: output.length > 500,
           totalLines: lineCount
         };
-        return formatBashResult(result, { collapsed: true });
+        return formatBashResult(result, command, { collapsed: true });
       }
       default:
         if (success) {
@@ -32085,10 +32198,10 @@ async function detectCICommands(projectPath) {
   const fs26 = await import("fs-extra");
   const path27 = await import("path");
   const commands = [];
-  const packageJsonPath = path27.join(projectPath, "package.json");
-  if (await fs26.pathExists(packageJsonPath)) {
+  const packageJsonPath2 = path27.join(projectPath, "package.json");
+  if (await fs26.pathExists(packageJsonPath2)) {
     try {
-      const pkg = await fs26.readJson(packageJsonPath);
+      const pkg = await fs26.readJson(packageJsonPath2);
       if (pkg.scripts?.build) {
         commands.push("npm run build");
       }
@@ -32121,7 +32234,7 @@ async function detectCICommands(projectPath) {
   if (await fs26.pathExists(path27.join(projectPath, "pyproject.toml")) || await fs26.pathExists(path27.join(projectPath, "setup.py"))) {
     commands.push("python -m pytest");
   }
-  if (commands.length === 0 && await fs26.pathExists(packageJsonPath)) {
+  if (commands.length === 0 && await fs26.pathExists(packageJsonPath2)) {
     commands.push("npm run build");
   }
   return commands;
@@ -32217,6 +32330,11 @@ Fix all the issues to make the CI pass. Use the available tools to read files, e
 }
 
 // src/cli.ts
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var packageJsonPath = join3(__dirname, "..", "package.json");
+var packageJson = JSON.parse(readFileSync2(packageJsonPath, "utf-8"));
+var VERSION = packageJson.version;
 var MAX_STDIN_SIZE = 10 * 1024 * 1024;
 var MAX_STDIN_LINES = 1e5;
 async function readStdinInput(format, options) {
@@ -32268,7 +32386,7 @@ async function readStdinInput(format, options) {
   });
 }
 var program = new Command();
-program.name("codesavant").description("AI coding assistant for your terminal").version("1.0.0").option("--verbose", "Enable verbose logging for debugging").option("--debug <categories>", 'Enable debug logging for specific categories (comma-separated: api,mcp,tool,provider,stream,session,context,permission,checkpoint,error,all). Use ! prefix to exclude: "all,!mcp"').option("--mcp-debug", "Enable MCP protocol-level debug logging").hook("preAction", (thisCommand) => {
+program.name("codesavant").description("AI coding assistant for your terminal").version(VERSION).option("--verbose", "Enable verbose logging for debugging").option("--debug <categories>", 'Enable debug logging for specific categories (comma-separated: api,mcp,tool,provider,stream,session,context,permission,checkpoint,error,all). Use ! prefix to exclude: "all,!mcp"').option("--mcp-debug", "Enable MCP protocol-level debug logging").hook("preAction", (thisCommand) => {
   const opts = thisCommand.opts();
   if (opts.debug) {
     setVerbose(true);
@@ -32374,6 +32492,19 @@ program.argument("[prompt]", "Initial prompt to send").option("-p, --print", "Pr
       systemPrompt += "\n\n" + options.appendSystemPrompt;
     }
   }
+  const workingDirContext = `
+## Working Directory Context
+
+**IMPORTANT**: Your current working directory is: ${projectPath}
+
+When the user asks to create projects, files, or directories:
+- ALWAYS create them in or relative to this working directory (${projectPath})
+- Do NOT use /tmp or other system directories unless explicitly requested
+- Use relative paths when possible (e.g., "./my-project" instead of absolute paths)
+- If the user specifies a path, resolve it relative to the working directory
+
+All file operations (read, write, edit, bash) execute in this directory by default.`;
+  systemPrompt += workingDirContext;
   const allowedTools = options.allowedTools ? options.allowedTools.split(",").map((t) => t.trim()) : void 0;
   const disallowedTools = options.disallowedTools ? options.disallowedTools.split(",").map((t) => t.trim()) : void 0;
   const maxTurns = options.maxTurns ? parseInt(options.maxTurns, 10) : void 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesavant",
-  "version": "1.1.0",
+  "version": "1.2.2",
   "description": "Multi-provider AI coding assistant for your terminal",
   "type": "module",
   "bin": {