@vuau/agent-memory 0.2.1 → 0.3.0

package/dist/bin/cli.js

@@ -1,5 +1,10 @@
 #!/usr/bin/env node
 
+// bin/cli.ts
+import * as readline from "readline";
+import { existsSync as existsSync3 } from "fs";
+import { join as join3 } from "path";
+
 // src/core/scaffold.ts
 import { existsSync, mkdirSync, writeFileSync, readFileSync } from "fs";
 import { join, resolve, dirname } from "path";
@@ -12,6 +17,8 @@ var MEMORY_FILE = ".agents/MEMORY.md";
 var TASKS_FILE = ".agents/TASKS.md";
 var AGENTS_MD = "AGENTS.md";
 var COPILOT_INSTRUCTIONS = ".github/copilot-instructions.md";
+var CURSOR_RULES = ".cursorrules";
+var WINDSURF_RULES = ".windsurfrules";
 
 // src/core/scaffold.ts
 function getTemplatesDir() {
@@ -25,6 +32,9 @@ function getTemplatesDir() {
 var TEMPLATES_DIR = getTemplatesDir();
 function readTemplate(name) {
   const templatePath = join(TEMPLATES_DIR, name);
+  if (!existsSync(templatePath)) {
+    throw new Error(`Template not found: ${templatePath}`);
+  }
   return readFileSync(templatePath, "utf-8");
 }
 function applyVars(content, vars) {
@@ -34,15 +44,21 @@ function applyVars(content, vars) {
   }
   return result;
 }
-function scaffold(projectDir, config = {}, force = false) {
+function scaffold(projectDir, options = {}) {
   const result = { created: [], skipped: [] };
-  const projectName = config.projectName || guessProjectName(projectDir);
+  const projectName = options.projectName || guessProjectName(projectDir);
   const vars = { PROJECT_NAME: projectName };
+  const force = options.force || false;
+  const hasAnyIde = options.opencode || options.copilot || options.cursor || options.windsurf;
+  const useOpencode = hasAnyIde ? options.opencode : true;
+  const useCopilot = options.copilot || false;
+  const useCursor = options.cursor || false;
+  const useWindsurf = options.windsurf || false;
   const dirs = [
     join(projectDir, AGENTS_DIR),
     join(projectDir, SPEC_DIR)
   ];
-  if (config.copilotInstructions !== false) {
+  if (useCopilot) {
     dirs.push(join(projectDir, ".github"));
   }
   for (const dir of dirs) {
@@ -50,18 +66,11 @@ function scaffold(projectDir, config = {}, force = false) {
       mkdirSync(dir, { recursive: true });
     }
   }
-  const files = [
-    { target: AGENTS_MD, template: "AGENTS.md" },
+  const coreFiles = [
     { target: MEMORY_FILE, template: "MEMORY.md" },
     { target: TASKS_FILE, template: "TASKS.md" }
   ];
-  if (config.copilotInstructions !== false) {
-    files.push({
-      target: COPILOT_INSTRUCTIONS,
-      template: "copilot-instructions.md"
-    });
-  }
-  for (const { target, template } of files) {
+  for (const { target, template } of coreFiles) {
     const targetPath = join(projectDir, target);
     if (existsSync(targetPath) && !force) {
       result.skipped.push(target);
@@ -76,56 +85,51 @@ function scaffold(projectDir, config = {}, force = false) {
     writeFileSync(specKeep, "");
     result.created.push(`${SPEC_DIR}/.gitkeep`);
   }
-  if (config.opencode) {
-    scaffoldOpenCode(projectDir, result, force);
+  if (useOpencode) {
+    writeFileIfNeeded(
+      join(projectDir, AGENTS_MD),
+      applyVars(readTemplate("AGENTS.md"), vars),
+      AGENTS_MD,
+      result,
+      force
+    );
   }
-  return result;
-}
-function scaffoldOpenCode(projectDir, result, force) {
-  const PACKAGE_NAME = "@vuau/agent-memory";
-  const opencodePkgPath = join(projectDir, ".opencode", "package.json");
-  const opencodeDir = join(projectDir, ".opencode");
-  if (!existsSync(opencodeDir)) {
-    mkdirSync(opencodeDir, { recursive: true });
+  if (useCopilot) {
+    writeFileIfNeeded(
+      join(projectDir, COPILOT_INSTRUCTIONS),
+      applyVars(readTemplate("copilot-instructions.md"), vars),
+      COPILOT_INSTRUCTIONS,
+      result,
+      force
+    );
   }
-  if (!existsSync(opencodePkgPath)) {
-    writeFileSync(
-      opencodePkgPath,
-      JSON.stringify({ dependencies: { [PACKAGE_NAME]: "latest" } }, null, 2) + "\n"
+  if (useCursor) {
+    writeFileIfNeeded(
+      join(projectDir, CURSOR_RULES),
+      applyVars(readTemplate("cursorrules.md"), vars),
+      CURSOR_RULES,
+      result,
+      force
     );
-    result.created.push(".opencode/package.json");
-  } else {
-    const pkg = JSON.parse(readFileSync(opencodePkgPath, "utf-8"));
-    const deps = pkg.dependencies || {};
-    if (!deps[PACKAGE_NAME] || force) {
-      deps[PACKAGE_NAME] = "latest";
-      pkg.dependencies = deps;
-      writeFileSync(opencodePkgPath, JSON.stringify(pkg, null, 2) + "\n");
-      if (!deps[PACKAGE_NAME]) {
-        result.created.push(".opencode/package.json");
-      }
-    } else {
-      result.skipped.push(".opencode/package.json");
-    }
   }
-  const opencodeJsonPath = join(projectDir, "opencode.json");
-  if (!existsSync(opencodeJsonPath)) {
-    writeFileSync(
-      opencodeJsonPath,
-      JSON.stringify({ plugin: [PACKAGE_NAME] }, null, 2) + "\n"
+  if (useWindsurf) {
+    writeFileIfNeeded(
+      join(projectDir, WINDSURF_RULES),
+      applyVars(readTemplate("windsurfrules.md"), vars),
+      WINDSURF_RULES,
+      result,
+      force
     );
-    result.created.push("opencode.json");
-  } else {
-    const config = JSON.parse(readFileSync(opencodeJsonPath, "utf-8"));
-    const plugins = config.plugin || [];
-    if (!plugins.includes(PACKAGE_NAME)) {
-      config.plugin = [...plugins, PACKAGE_NAME];
-      writeFileSync(opencodeJsonPath, JSON.stringify(config, null, 2) + "\n");
-      result.created.push("opencode.json (merged plugin)");
-    } else {
-      result.skipped.push("opencode.json");
-    }
   }
+  return result;
+}
+function writeFileIfNeeded(targetPath, content, displayName, result, force) {
+  if (existsSync(targetPath) && !force) {
+    result.skipped.push(displayName);
+    return;
+  }
+  writeFileSync(targetPath, content);
+  result.created.push(displayName);
 }
 function guessProjectName(dir) {
   const pkgPath = join(dir, "package.json");
@@ -250,6 +254,32 @@ function doctor(projectDir) {
 // bin/cli.ts
 var args = process.argv.slice(2);
 var command = args[0];
+var rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout
+});
+function ask(question) {
+  return new Promise((resolve2) => {
+    rl.question(question, (answer) => resolve2(answer.trim()));
+  });
+}
+function askYesNo(question, defaultYes = true) {
+  const hint = defaultYes ? "(Y/n)" : "(y/N)";
+  return ask(`${question} ${hint} `).then((answer) => {
+    if (!answer) return defaultYes;
+    return answer.toLowerCase().startsWith("y");
+  });
+}
+async function askMultiSelect(question, options) {
+  console.log(`
+${question}`);
+  for (const opt of options) {
+    console.log(`  [${opt.key}] ${opt.label}`);
+  }
+  const answer = await ask("Enter choices (e.g., 1,2 or 1 2): ");
+  const selected = answer.split(/[,\s]+/).filter(Boolean);
+  return selected;
+}
 function printUsage() {
   console.log(`
 @vuau/agent-memory \u2014 Structured AI memory for codebases
@@ -260,27 +290,99 @@ Usage:
   agent-memory help              Show this help
 
 Options (init):
-  --force                        Overwrite existing files
+  --opencode                     Create AGENTS.md for OpenCode
+  --copilot                      Create .github/copilot-instructions.md for GitHub Copilot
+  --cursor                       Create .cursorrules for Cursor
+  --windsurf                     Create .windsurfrules for Windsurf
+  --all                          Create config for all IDEs
+  --force                        Overwrite existing files without asking
   --name <name>                  Project name (default: from package.json)
-  --no-copilot                   Skip .github/copilot-instructions.md
-  --opencode                     Wire up OpenCode plugin (.opencode/package.json + opencode.json)
+
+Examples:
+  npx @vuau/agent-memory init                    # Interactive mode
+  npx @vuau/agent-memory init --opencode         # OpenCode only
+  npx @vuau/agent-memory init --copilot --cursor # Copilot + Cursor
+  npx @vuau/agent-memory init --all              # All IDEs
 `);
 }
-function runInit() {
+async function runInit() {
+  const cwd = process.cwd();
   const force = args.includes("--force");
-  const noCopilot = args.includes("--no-copilot");
-  const opencode = args.includes("--opencode");
+  const hasOpencode = args.includes("--opencode");
+  const hasCopilot = args.includes("--copilot");
+  const hasCursor = args.includes("--cursor");
+  const hasWindsurf = args.includes("--windsurf");
+  const hasAll = args.includes("--all");
   const nameIdx = args.indexOf("--name");
   const projectName = nameIdx !== -1 ? args[nameIdx + 1] : void 0;
-  const cwd = process.cwd();
-  console.log(`Initializing agent memory in ${cwd}...`);
-  const result = scaffold(cwd, {
+  let selectedIdes = [];
+  if (hasAll) {
+    selectedIdes = ["1", "2", "3", "4"];
+  } else if (hasOpencode || hasCopilot || hasCursor || hasWindsurf) {
+    if (hasOpencode) selectedIdes.push("1");
+    if (hasCopilot) selectedIdes.push("2");
+    if (hasCursor) selectedIdes.push("3");
+    if (hasWindsurf) selectedIdes.push("4");
+  } else {
+    console.log("\n@vuau/agent-memory \u2014 Structured AI memory for codebases\n");
+    selectedIdes = await askMultiSelect("What are your coding tools?", [
+      { key: "1", label: "OpenCode (AGENTS.md)" },
+      { key: "2", label: "GitHub Copilot (.github/copilot-instructions.md)" },
+      { key: "3", label: "Cursor (.cursorrules)" },
+      { key: "4", label: "Windsurf (.windsurfrules)" }
+    ]);
+    if (selectedIdes.length === 0) {
+      console.log("\nNo tools selected. Defaulting to OpenCode.\n");
+      selectedIdes = ["1"];
+    }
+  }
+  const options = {
     projectName,
-    copilotInstructions: !noCopilot,
-    opencode
-  }, force);
+    opencode: selectedIdes.includes("1"),
+    copilot: selectedIdes.includes("2"),
+    cursor: selectedIdes.includes("3"),
+    windsurf: selectedIdes.includes("4")
+  };
+  if (!force) {
+    const filesToCheck = [
+      { path: MEMORY_FILE, name: ".agents/MEMORY.md" },
+      { path: TASKS_FILE, name: ".agents/TASKS.md" }
+    ];
+    if (options.opencode) {
+      filesToCheck.push({ path: AGENTS_MD, name: "AGENTS.md" });
+    }
+    if (options.copilot) {
+      filesToCheck.push({ path: COPILOT_INSTRUCTIONS, name: ".github/copilot-instructions.md" });
+    }
+    if (options.cursor) {
+      filesToCheck.push({ path: ".cursorrules", name: ".cursorrules" });
+    }
+    if (options.windsurf) {
+      filesToCheck.push({ path: ".windsurfrules", name: ".windsurfrules" });
+    }
+    const existingFiles = filesToCheck.filter((f) => existsSync3(join3(cwd, f.path)));
+    if (existingFiles.length > 0) {
+      console.log("\nExisting files found:");
+      for (const f of existingFiles) {
+        console.log(`  - ${f.name}`);
+      }
+      const overwrite = await askYesNo("\nOverwrite these files?", false);
+      if (!overwrite) {
+        console.log("\nAborted. Use --force to overwrite without asking.\n");
+        rl.close();
+        return;
+      }
+      options.force = true;
+    }
+  } else {
+    options.force = true;
+  }
+  console.log(`
+Initializing agent memory in ${cwd}...
+`);
+  const result = scaffold(cwd, options);
   if (result.created.length > 0) {
-    console.log("\nCreated:");
+    console.log("Created:");
     for (const f of result.created) {
       console.log(`  \u2713 ${f}`);
     }
@@ -291,18 +393,12 @@ function runInit() {
       console.log(`  - ${f}`);
     }
   }
-  if (result.created.length === 0 && result.skipped.length > 0) {
-    console.log("\nAll files already exist. Use --force to overwrite.");
-  }
   console.log("\nNext steps:");
-  console.log("  1. Edit AGENTS.md \u2014 add your project-specific rules");
+  console.log("  1. Edit your IDE config file \u2014 add project-specific rules");
   console.log("  2. Add spec files to .agents/spec/ for detailed documentation");
-  if (opencode) {
-    console.log("  3. Restart OpenCode to activate the plugin");
-  } else {
-    console.log("  3. For OpenCode: run with --opencode flag to wire up the plugin");
-  }
+  console.log("  3. Agent will read rules and write to .agents/MEMORY.md automatically");
   console.log("");
+  rl.close();
 }
 function runDoctor() {
   const cwd = process.cwd();
@@ -325,7 +421,11 @@ function runDoctor() {
 }
 switch (command) {
   case "init":
-    runInit();
+    runInit().catch((err) => {
+      console.error("Error:", err.message);
+      rl.close();
+      process.exit(1);
+    });
     break;
   case "doctor":
     runDoctor();
@@ -333,9 +433,15 @@ switch (command) {
   case "help":
   case "--help":
   case "-h":
-  case void 0:
     printUsage();
     break;
+  case void 0:
+    runInit().catch((err) => {
+      console.error("Error:", err.message);
+      rl.close();
+      process.exit(1);
+    });
+    break;
   default:
     console.error(`Unknown command: ${command}`);
     printUsage();