aicoding-rules 0.2.0 → 0.3.0

package/bin/cli.js

@@ -8,6 +8,17 @@ import { selectRules, selectSkills } from "../src/interactive.js";
 const config = loadConfig();
 const targetDir = process.cwd();
 
+function wrapAction(fn) {
+  return async (...args) => {
+    try {
+      await fn(...args);
+    } catch (err) {
+      console.error(`Error: ${err.message}`);
+      process.exit(1);
+    }
+  };
+}
+
 const program = new Command();
 
 program
@@ -18,53 +29,54 @@ program
 program
   .command("cursor")
   .description("Install Cursor rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "cursor", targetDir);
-  });
+  }));
 
 program
   .command("claude")
   .description("Install Claude rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "claude", targetDir);
-  });
+  }));
 
 program
   .command("antigravity")
   .description("Install Antigravity rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "antigravity", targetDir);
-  });
+  }));
 
 program
   .command("copilot")
   .description("Install Copilot prompts")
-  .action(async () => {
+  .action(wrapAction(async () => {
     await downloadAndExtract(config, "copilot", targetDir);
-  });
+  }));
 
 program
   .command("all")
   .description("Install all rules")
-  .action(async () => {
+  .action(wrapAction(async () => {
     const allKeys = getRuleKeys(config);
     await downloadMultiple(config, allKeys, targetDir);
-  });
+  }));
 
 program
   .command("skills")
   .description("Install AI coding skills (interactive selection)")
-  .action(async () => {
+  .option("--replace", "Remove existing folders that match the zip contents before extracting (only those folders; other skills stay intact)")
+  .action(wrapAction(async (opts) => {
     const { selectedSkills, targetDir: skillsDir } = await selectSkills(config);
     if (selectedSkills.length > 0) {
-      await downloadMultipleSkills(config, selectedSkills, skillsDir);
+      await downloadMultipleSkills(config, selectedSkills, skillsDir, { replaceExtracted: opts.replace });
     }
-  });
+  }));
 
 program
-  .action(async () => {
+  .action(wrapAction(async () => {
     const selectedKeys = await selectRules(config);
     await downloadMultiple(config, selectedKeys, targetDir);
-  });
+  }));
 
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aicoding-rules",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Download and install AI coding rules for Cursor, Claude, Antigravity, and Copilot",
   "license": "MIT",
   "type": "module",

package/src/download.js

@@ -1,10 +1,45 @@
 import AdmZip from "adm-zip";
-import { mkdirSync } from "fs";
+import { mkdirSync, rmSync, existsSync } from "fs";
+import { join } from "path";
 import { getAuthenticatedClient } from "./auth.js";
 
+const OVERWRITE_FILES = true;
+
+function getZipTopLevelNames(zip) {
+  const entries = zip.getEntries();
+  const topLevel = new Set();
+  for (const entry of entries) {
+    const name = entry.entryName.replace(/^\/+/, "");
+    if (!name) continue;
+
+    const firstSegment = name.split("/")[0];
+    if (firstSegment && firstSegment !== ".") {
+      topLevel.add(firstSegment);
+    }
+  }
+  return [...topLevel];
+}
+
+function removePathsInDir(targetDir, pathNames) {
+  for (const name of pathNames) {
+    const fullPath = join(targetDir, name);
+    if (existsSync(fullPath)) {
+      try {
+        rmSync(fullPath, { recursive: true, force: true });
+      } catch (err) {
+        throw new Error(`Failed to remove ${fullPath}: ${err.message}`);
+      }
+    }
+  }
+}
+
+function extractZip(zip, outputPath) {
+  zip.extractAllTo(outputPath, OVERWRITE_FILES);
+}
+
 function extractZipBuffer(buffer, outputPath) {
   const zip = new AdmZip(buffer);
-  zip.extractAllTo(outputPath, true);
+  zip.extractAllTo(outputPath, OVERWRITE_FILES);
 }
 
 function ensureDir(dirPath) {
@@ -44,7 +79,8 @@ export async function downloadMultiple(config, ruleKeys, targetDir) {
   }
 }
 
-export async function downloadSkill(config, skillKey, targetDir) {
+export async function downloadSkill(config, skillKey, targetDir, options = {}) {
+  const { replaceExtracted = false } = options;
   const skill = config.skills?.[skillKey];
   if (!skill) {
     throw new Error(`Unknown skill: ${skillKey}`);
@@ -71,15 +107,21 @@ export async function downloadSkill(config, skillKey, targetDir) {
 
   ensureDir(targetDir);
 
-  const attachmentBuffer = response.body;
-  extractZipBuffer(attachmentBuffer, targetDir);
+  const zip = new AdmZip(response.body);
+  if (replaceExtracted) {
+    const topLevelNames = getZipTopLevelNames(zip);
+    if (topLevelNames.length > 0) {
+      console.log(`  Replacing: ${topLevelNames.join(", ")}`);
+    }
+    removePathsInDir(targetDir, topLevelNames);
+  }
+  extractZip(zip, targetDir);
   
   console.log(`${skill.name} installed to ${targetDir}`);
 }
 
-export async function downloadMultipleSkills(config, skillKeys, targetDir) {
-  ensureDir(targetDir);
+export async function downloadMultipleSkills(config, skillKeys, targetDir, options = {}) {
   for (const key of skillKeys) {
-    await downloadSkill(config, key, targetDir);
+    await downloadSkill(config, key, targetDir, options);
   }
 }