kiro-memory 1.2.1 → 1.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiro-memory",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Persistent cross-session memory for Kiro CLI. Automatically tracks context, observations, and summaries across coding sessions.",
   "keywords": [
     "kiro",

package/plugin/dist/cli/contextkit.js

@@ -1082,10 +1082,11 @@ function createContextKit(config) {
 
 // src/cli/contextkit.ts
 import { execSync } from "child_process";
-import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync } from "fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync, appendFileSync as appendFileSync2 } from "fs";
 import { join as join3, dirname as dirname2 } from "path";
 import { homedir as homedir3, platform, release } from "os";
 import { fileURLToPath as fileURLToPath2 } from "url";
+import { createInterface } from "readline";
 var args = process.argv.slice(2);
 var command = args[0];
 var __filename = fileURLToPath2(import.meta.url);
@@ -1201,6 +1202,17 @@ function runEnvironmentChecks() {
         message: "Unable to determine npm prefix"
       });
     }
+    try {
+      const npmPath = execSync("which npm", { encoding: "utf8" }).trim();
+      const npmOnWindows = isWindowsPath(npmPath);
+      checks.push({
+        name: "WSL: npm binary",
+        ok: !npmOnWindows,
+        message: npmOnWindows ? `npm is the Windows version: ${npmPath}` : `Native Linux npm: ${npmPath}`,
+        fix: npmOnWindows ? "Your npm binary is the Windows version running inside WSL.\n  This causes EPERM/UNC errors when installing packages.\n  Install Node.js (includes npm) natively in WSL:\n    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash\n    source ~/.bashrc\n    nvm install 22\n  Or:\n    curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -\n    sudo apt-get install -y nodejs" : void 0
+      });
+    } catch {
+    }
   }
   const nodeVersion = parseInt(process.versions.node.split(".")[0]);
   checks.push({
@@ -1260,15 +1272,169 @@ function printChecks(checks) {
   console.log("");
   return { hasErrors };
 }
+function askUser(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+function detectShellRc() {
+  const shell = process.env.SHELL || "/bin/bash";
+  if (shell.includes("zsh")) return { name: "zsh", rcFile: join3(homedir3(), ".zshrc") };
+  if (shell.includes("fish")) return { name: "fish", rcFile: join3(homedir3(), ".config/fish/config.fish") };
+  return { name: "bash", rcFile: join3(homedir3(), ".bashrc") };
+}
+var AUTOFIXABLE_CHECKS = /* @__PURE__ */ new Set([
+  "WSL: npm global prefix",
+  "WSL: npm binary",
+  "Build tools (native modules)",
+  "better-sqlite3"
+]);
+async function tryAutoFix(failedChecks) {
+  const fixable = failedChecks.filter((c) => !c.ok && AUTOFIXABLE_CHECKS.has(c.name));
+  if (fixable.length === 0) return { fixed: false, needsRestart: false };
+  const { rcFile } = detectShellRc();
+  let anyFixed = false;
+  let needsRestart = false;
+  console.log(`  \x1B[36mFound ${fixable.length} issue(s) that can be fixed automatically:\x1B[0m
+`);
+  for (const check of fixable) {
+    console.log(`    - ${check.name}: ${check.message}`);
+  }
+  console.log("");
+  const answer = await askUser("  Fix automatically? [Y/n] ");
+  if (answer !== "" && answer !== "y" && answer !== "yes") {
+    console.log("\n  Skipped auto-fix. Fix manually and run: kiro-memory install\n");
+    return { fixed: false, needsRestart: false };
+  }
+  console.log("");
+  const prefixCheck = fixable.find((c) => c.name === "WSL: npm global prefix");
+  if (prefixCheck) {
+    console.log("  Fixing npm global prefix...");
+    try {
+      const npmGlobalDir = join3(homedir3(), ".npm-global");
+      mkdirSync3(npmGlobalDir, { recursive: true });
+      execSync(`npm config set prefix "${npmGlobalDir}"`, { stdio: "ignore" });
+      const exportLine = 'export PATH="$HOME/.npm-global/bin:$PATH"';
+      let alreadyInRc = false;
+      if (existsSync3(rcFile)) {
+        const content = readFileSync2(rcFile, "utf8");
+        alreadyInRc = content.includes(".npm-global/bin");
+      }
+      if (!alreadyInRc) {
+        appendFileSync2(rcFile, `
+# npm global prefix (added by kiro-memory)
+${exportLine}
+`);
+      }
+      process.env.PATH = `${npmGlobalDir}/bin:${process.env.PATH}`;
+      console.log(`  \x1B[32m\u2713\x1B[0m npm prefix set to ${npmGlobalDir}`);
+      console.log(`  \x1B[32m\u2713\x1B[0m PATH updated in ${rcFile}`);
+      anyFixed = true;
+    } catch (err) {
+      console.log(`  \x1B[31m\u2717\x1B[0m Could not fix npm prefix: ${err.message}`);
+    }
+  }
+  const npmBinaryCheck = fixable.find((c) => c.name === "WSL: npm binary");
+  if (npmBinaryCheck) {
+    console.log("\n  Fixing npm binary (installing nvm + Node.js 22)...");
+    const nvmDir = join3(homedir3(), ".nvm");
+    try {
+      if (existsSync3(nvmDir)) {
+        console.log(`  nvm already installed at ${nvmDir}`);
+      } else {
+        console.log("  Downloading nvm...");
+        execSync("curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash", {
+          stdio: "inherit",
+          timeout: 6e4
+        });
+        console.log(`  \x1B[32m\u2713\x1B[0m nvm installed`);
+      }
+      console.log("  Installing Node.js 22 via nvm...");
+      execSync('bash -c "source $HOME/.nvm/nvm.sh && nvm install 22"', {
+        stdio: "inherit",
+        timeout: 12e4
+      });
+      console.log(`  \x1B[32m\u2713\x1B[0m Node.js 22 installed`);
+      anyFixed = true;
+      needsRestart = true;
+    } catch (err) {
+      console.log(`  \x1B[31m\u2717\x1B[0m Could not install nvm/Node: ${err.message}`);
+      console.log("  Install manually:");
+      console.log("    curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash");
+      console.log("    source ~/.bashrc");
+      console.log("    nvm install 22");
+    }
+  }
+  const buildCheck = fixable.find((c) => c.name === "Build tools (native modules)");
+  if (buildCheck) {
+    console.log("\n  Fixing build tools (requires sudo)...");
+    try {
+      execSync("sudo apt-get update -qq && sudo apt-get install -y build-essential python3", {
+        stdio: "inherit",
+        timeout: 12e4
+      });
+      console.log(`  \x1B[32m\u2713\x1B[0m Build tools installed`);
+      anyFixed = true;
+    } catch (err) {
+      console.log(`  \x1B[31m\u2717\x1B[0m Could not install build tools: ${err.message}`);
+      console.log("  Install manually: sudo apt-get install -y build-essential python3");
+    }
+  }
+  const sqliteCheck = fixable.find((c) => c.name === "better-sqlite3");
+  if (sqliteCheck) {
+    console.log("\n  Rebuilding better-sqlite3...");
+    try {
+      const globalDir = execSync("npm prefix -g", { encoding: "utf8" }).trim();
+      const sqlitePkg = join3(globalDir, "lib", "node_modules", "kiro-memory");
+      if (existsSync3(sqlitePkg)) {
+        execSync(`cd "${sqlitePkg}" && npm rebuild better-sqlite3`, {
+          stdio: "inherit",
+          timeout: 6e4
+        });
+      } else {
+        execSync("npm rebuild better-sqlite3", { stdio: "inherit", timeout: 6e4 });
+      }
+      console.log(`  \x1B[32m\u2713\x1B[0m better-sqlite3 rebuilt`);
+      anyFixed = true;
+    } catch (err) {
+      console.log(`  \x1B[31m\u2717\x1B[0m Could not rebuild: ${err.message}`);
+      console.log("  Try: npm install -g kiro-memory --build-from-source");
+    }
+  }
+  console.log("");
+  return { fixed: anyFixed, needsRestart };
+}
 async function installKiro() {
   console.log("\n=== Kiro Memory - Installation ===\n");
-  console.log("[1/3] Running environment checks...");
-  const checks = runEnvironmentChecks();
-  const { hasErrors } = printChecks(checks);
+  console.log("[1/4] Running environment checks...");
+  let checks = runEnvironmentChecks();
+  let { hasErrors } = printChecks(checks);
   if (hasErrors) {
-    console.log("\x1B[31mInstallation aborted.\x1B[0m Fix the issues above and retry.");
-    console.log("After fixing, run: kiro-memory install\n");
-    process.exit(1);
+    const { fixed, needsRestart } = await tryAutoFix(checks);
+    if (needsRestart) {
+      console.log("  \x1B[33m\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\x1B[0m");
+      console.log("  \x1B[33m\u2502\x1B[0m  Node.js was installed via nvm. To activate it:         \x1B[33m\u2502\x1B[0m");
+      console.log("  \x1B[33m\u2502\x1B[0m                                                         \x1B[33m\u2502\x1B[0m");
+      console.log("  \x1B[33m\u2502\x1B[0m  1. Close and reopen your terminal                      \x1B[33m\u2502\x1B[0m");
+      console.log("  \x1B[33m\u2502\x1B[0m  2. Run: \x1B[1mnpm install -g kiro-memory\x1B[0m                     \x1B[33m\u2502\x1B[0m");
+      console.log("  \x1B[33m\u2502\x1B[0m  3. Run: \x1B[1mkiro-memory install\x1B[0m                            \x1B[33m\u2502\x1B[0m");
+      console.log("  \x1B[33m\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\x1B[0m\n");
+      process.exit(0);
+    }
+    if (fixed) {
+      console.log("  Re-running checks...\n");
+      checks = runEnvironmentChecks();
+      ({ hasErrors } = printChecks(checks));
+    }
+    if (hasErrors) {
+      console.log("\x1B[31mInstallation aborted.\x1B[0m Fix the remaining issues and retry.");
+      console.log("After fixing, run: kiro-memory install\n");
+      process.exit(1);
+    }
   }
   const distDir = DIST_DIR;
   const kiroDir = process.env.KIRO_CONFIG_DIR || join3(homedir3(), ".kiro");
@@ -1276,7 +1442,7 @@ async function installKiro() {
   const settingsDir = join3(kiroDir, "settings");
   const steeringDir = join3(kiroDir, "steering");
   const dataDir = process.env.CONTEXTKIT_DATA_DIR || join3(homedir3(), ".contextkit");
-  console.log("[2/3] Installing Kiro configuration...\n");
+  console.log("[2/4] Installing Kiro configuration...\n");
   for (const dir of [agentsDir, settingsDir, steeringDir, dataDir]) {
     mkdirSync3(dir, { recursive: true });
   }
@@ -1303,14 +1469,57 @@ async function installKiro() {
   writeFileSync(steeringDestPath, STEERING_CONTENT, "utf8");
   console.log(`  \u2192 Steering:     ${steeringDestPath}`);
   console.log(`  \u2192 Data dir:     ${dataDir}`);
-  console.log("\n[3/3] Installation complete!\n");
-  console.log("To use Kiro with persistent memory:");
-  console.log("  kiro-cli --agent contextkit-memory\n");
-  console.log("To create a permanent alias:");
-  console.log(`  echo 'alias kiro="kiro-cli --agent contextkit-memory"' >> ~/.bashrc`);
-  console.log("  source ~/.bashrc\n");
-  console.log("The worker starts automatically when a Kiro session begins.");
-  console.log(`Web dashboard: http://localhost:3001
+  console.log("\n[3/4] Shell alias setup\n");
+  const { rcFile } = detectShellRc();
+  const aliasLine = 'alias kiro="kiro-cli --agent contextkit-memory"';
+  let aliasAlreadySet = false;
+  if (existsSync3(rcFile)) {
+    const rcContent = readFileSync2(rcFile, "utf8");
+    aliasAlreadySet = rcContent.includes("alias kiro=") && rcContent.includes("contextkit-memory");
+  }
+  if (aliasAlreadySet) {
+    console.log(`  \x1B[32m\u2713\x1B[0m Alias already configured in ${rcFile}`);
+  } else {
+    console.log("  \x1B[36m\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\x1B[0m");
+    console.log("  \x1B[36m\u2502\x1B[0m  Without an alias, you must type every time:            \x1B[36m\u2502\x1B[0m");
+    console.log("  \x1B[36m\u2502\x1B[0m    \x1B[2mkiro-cli --agent contextkit-memory\x1B[0m                    \x1B[36m\u2502\x1B[0m");
+    console.log("  \x1B[36m\u2502\x1B[0m                                                         \x1B[36m\u2502\x1B[0m");
+    console.log("  \x1B[36m\u2502\x1B[0m  With the alias, just type:                              \x1B[36m\u2502\x1B[0m");
+    console.log("  \x1B[36m\u2502\x1B[0m    \x1B[1m\x1B[32mkiro\x1B[0m                                                 \x1B[36m\u2502\x1B[0m");
+    console.log("  \x1B[36m\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\x1B[0m");
+    console.log("");
+    const answer = await askUser(`  Add alias to ${rcFile}? [Y/n] `);
+    if (answer === "" || answer === "y" || answer === "yes") {
+      try {
+        appendFileSync2(rcFile, `
+# Kiro Memory \u2014 persistent memory alias
+${aliasLine}
+`);
+        console.log(`
+  \x1B[32m\u2713\x1B[0m Alias added to ${rcFile}`);
+        console.log(`  \x1B[33m\u2192\x1B[0m Run \x1B[1msource ${rcFile}\x1B[0m or open a new terminal to activate it.`);
+      } catch (err) {
+        console.log(`
+  \x1B[31m\u2717\x1B[0m Could not write to ${rcFile}: ${err.message}`);
+        console.log(`  \x1B[33m\u2192\x1B[0m Add manually: ${aliasLine}`);
+      }
+    } else {
+      console.log(`
+  Skipped. You can add it manually later:`);
+      console.log(`    echo '${aliasLine}' >> ${rcFile}`);
+    }
+  }
+  console.log("\n[4/4] Done!\n");
+  console.log("  \x1B[32m\u2550\u2550\u2550 Installation complete! \u2550\u2550\u2550\x1B[0m\n");
+  console.log("  Start Kiro with memory:");
+  if (aliasAlreadySet) {
+    console.log("    \x1B[1mkiro\x1B[0m");
+  } else {
+    console.log("    \x1B[1mkiro-cli --agent contextkit-memory\x1B[0m");
+  }
+  console.log("");
+  console.log("  The worker starts automatically when a Kiro session begins.");
+  console.log(`  Web dashboard: \x1B[4mhttp://localhost:3001\x1B[0m
 `);
 }
 async function runDoctor() {