@neyugn/agent-kits 0.1.0

package/dist/cli.js

@@ -0,0 +1,422 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import * as p from "@clack/prompts";
+import fs2 from "fs";
+import os2 from "os";
+import path3 from "path";
+import pc from "picocolors";
+
+// src/config.ts
+import os from "os";
+import path from "path";
+function getGlobalPath(tool) {
+  const folderName = tool.globalPathPattern.replace("~/", "");
+  return path.join(os.homedir(), folderName);
+}
+function getGlobalPathDisplay(tool) {
+  if (process.platform === "win32") {
+    return getGlobalPath(tool);
+  }
+  return tool.globalPathPattern;
+}
+var AI_TOOLS = [
+  {
+    id: "claude",
+    name: "Claude Code",
+    icon: "\u{1F7E0}",
+    path: ".claude",
+    globalPathPattern: "~/.claude",
+    // Resolved to home dir at runtime
+    rulesFile: "CLAUDE.md",
+    kitRulesFile: "CLAUDE.md"
+  },
+  {
+    id: "gemini",
+    name: "Gemini CLI",
+    icon: "\u{1F535}",
+    path: ".gemini",
+    globalPathPattern: "~/.gemini",
+    rulesFile: "GEMINI.md",
+    kitRulesFile: "GEMINI.md"
+  },
+  {
+    id: "codex",
+    name: "Codex CLI",
+    icon: "\u{1F7E2}",
+    path: ".codex",
+    globalPathPattern: "~/.codex",
+    rulesFile: "CODEX.md",
+    kitRulesFile: "CODEX.md"
+  },
+  {
+    id: "antigravity",
+    name: "Antigravity",
+    icon: "\u{1F7E3}",
+    path: ".agent",
+    globalPathPattern: "~/.agent",
+    rulesFile: "GEMINI.md",
+    kitRulesFile: "GEMINI.md"
+  },
+  {
+    id: "cursor",
+    name: "Cursor",
+    icon: "\u26AA",
+    path: ".cursor",
+    globalPathPattern: "~/.cursor",
+    rulesFile: ".cursorrules",
+    kitRulesFile: ".cursorrules"
+  },
+  {
+    id: "custom",
+    name: "Custom",
+    icon: "\u2699\uFE0F",
+    path: ".ai",
+    globalPathPattern: "~/.ai",
+    rulesFile: "RULES.md",
+    kitRulesFile: "GEMINI.md"
+    // Use GEMINI.md as base for custom
+  }
+];
+var KITS = [
+  {
+    id: "coder",
+    name: "Coder",
+    icon: "\u{1F4BB}",
+    description: "22 agents, 39 skills, 7 workflows for software development",
+    agents: 22,
+    skills: 39,
+    workflows: 7,
+    available: true
+  },
+  {
+    id: "writer",
+    name: "Writer",
+    icon: "\u270D\uFE0F",
+    description: "Content creation, copywriting, documentation",
+    agents: 0,
+    skills: 0,
+    workflows: 0,
+    available: false
+  },
+  {
+    id: "researcher",
+    name: "Researcher",
+    icon: "\u{1F52C}",
+    description: "Research, analysis, synthesis",
+    agents: 0,
+    skills: 0,
+    workflows: 0,
+    available: false
+  },
+  {
+    id: "designer",
+    name: "Designer",
+    icon: "\u{1F3A8}",
+    description: "UI/UX design, branding, visual assets",
+    agents: 0,
+    skills: 0,
+    workflows: 0,
+    available: false
+  }
+];
+
+// src/installers/index.ts
+import fs from "fs/promises";
+import path2 from "path";
+import { fileURLToPath } from "url";
+var __dirname = path2.dirname(fileURLToPath(import.meta.url));
+var KITS_DIR = path2.resolve(__dirname, "../../kits");
+var COMMON_DIR = path2.resolve(__dirname, "../../common");
+async function installKit(options) {
+  const { aiTool, kits, targetPath } = options;
+  const results = [];
+  for (const kitId of kits) {
+    const kit = KITS.find((k) => k.id === kitId);
+    if (!kit || !kit.available) {
+      throw new Error(`Kit "${kitId}" is not available`);
+    }
+    const kitSourcePath = path2.join(KITS_DIR, kitId);
+    const kitTargetPath = path2.join(targetPath, aiTool.path);
+    await fs.mkdir(kitTargetPath, { recursive: true });
+    await copyDirectory(kitSourcePath, kitTargetPath, ["rules"]);
+    const rulesSource = path2.join(kitSourcePath, "rules", aiTool.kitRulesFile);
+    const rulesTarget = path2.join(targetPath, aiTool.rulesFile);
+    try {
+      let rulesContent = await fs.readFile(rulesSource, "utf-8");
+      rulesContent = rulesContent.replace(
+        /\.(agent|claude|gemini|cursor|codex)\//g,
+        `${aiTool.path}/`
+      );
+      await fs.writeFile(rulesTarget, rulesContent);
+    } catch {
+      try {
+        const fallbackSource = path2.join(kitSourcePath, "rules", "GEMINI.md");
+        let rulesContent = await fs.readFile(fallbackSource, "utf-8");
+        rulesContent = rulesContent.replace(
+          /\.(agent|claude|gemini|cursor|codex)\//g,
+          `${aiTool.path}/`
+        );
+        await fs.writeFile(rulesTarget, rulesContent);
+      } catch {
+      }
+    }
+    try {
+      const commonSkillsPath = path2.join(COMMON_DIR, "skills");
+      const commonWorkflowsPath = path2.join(COMMON_DIR, "workflows");
+      const commonDocPath = path2.join(COMMON_DIR, "COMMON.md");
+      const targetSkillsPath = path2.join(kitTargetPath, "skills");
+      await fs.mkdir(targetSkillsPath, { recursive: true });
+      await copyDirectory(commonSkillsPath, targetSkillsPath);
+      const targetWorkflowsPath = path2.join(kitTargetPath, "workflows");
+      await fs.mkdir(targetWorkflowsPath, { recursive: true });
+      await copyDirectory(commonWorkflowsPath, targetWorkflowsPath);
+      const targetCommonDoc = path2.join(kitTargetPath, "COMMON.md");
+      await fs.copyFile(commonDocPath, targetCommonDoc);
+    } catch {
+    }
+    const agents = await countItems(path2.join(kitTargetPath, "agents"));
+    const skills = await countItems(path2.join(kitTargetPath, "skills"));
+    const workflows = await countItems(path2.join(kitTargetPath, "workflows"));
+    results.push({
+      kit: kit.name,
+      agents,
+      skills,
+      workflows
+    });
+  }
+  return results;
+}
+async function copyDirectory(src, dest, exclude = []) {
+  await fs.mkdir(dest, { recursive: true });
+  const entries = await fs.readdir(src, { withFileTypes: true });
+  for (const entry of entries) {
+    if (exclude.includes(entry.name)) {
+      continue;
+    }
+    const srcPath = path2.join(src, entry.name);
+    const destPath = path2.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      await copyDirectory(srcPath, destPath, exclude);
+    } else {
+      await fs.copyFile(srcPath, destPath);
+    }
+  }
+}
+async function countItems(dirPath) {
+  try {
+    const entries = await fs.readdir(dirPath);
+    return entries.length;
+  } catch {
+    return 0;
+  }
+}
+
+// src/cli.ts
+function expandPath(inputPath) {
+  if (inputPath.startsWith("~")) {
+    return path3.join(os2.homedir(), inputPath.slice(1));
+  }
+  return inputPath;
+}
+function directoryExists(dirPath) {
+  try {
+    return fs2.existsSync(dirPath) && fs2.statSync(dirPath).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function getInstallPath(aiTool, scope, workspacePath) {
+  if (scope === "global") {
+    return getGlobalPath(aiTool);
+  }
+  return path3.join(workspacePath, aiTool.path);
+}
+function getDisplayPath(absolutePath) {
+  const home = os2.homedir();
+  const isWindows = process.platform === "win32";
+  if (!isWindows && absolutePath.startsWith(home)) {
+    return "~" + absolutePath.slice(home.length);
+  }
+  return absolutePath;
+}
+async function main() {
+  console.clear();
+  console.log(
+    pc.cyan(`
+\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557
+\u2551                                                               \u2551
+\u2551     \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557               \u2551
+\u2551    \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u255A\u2550\u2550\u2588\u2588\u2554\u2550\u2550\u255D               \u2551
+\u2551    \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551   \u2588\u2588\u2551                  \u2551
+\u2551    \u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u255A\u2588\u2588\u2557\u2588\u2588\u2551   \u2588\u2588\u2551                  \u2551
+\u2551    \u2588\u2588\u2551  \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u255A\u2588\u2588\u2588\u2588\u2551   \u2588\u2588\u2551                  \u2551
+\u2551    \u255A\u2550\u255D  \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D  \u255A\u2550\u2550\u2550\u255D   \u255A\u2550\u255D                  \u2551
+\u2551                    ${pc.bold("K I T S")}                                   \u2551
+\u2551                                                               \u2551
+\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D
+`)
+  );
+  p.intro(pc.bgCyan(pc.black(" Universal AI Agent Toolkit ")));
+  const aiToolResult = await p.select({
+    message: "Which AI tool are you using?",
+    options: AI_TOOLS.map((tool) => ({
+      value: tool.id,
+      label: `${tool.icon} ${tool.name}`,
+      hint: `workspace: ${tool.path} | global: ${getGlobalPathDisplay(tool)}`
+    }))
+  });
+  if (p.isCancel(aiToolResult)) {
+    p.cancel("Installation cancelled.");
+    process.exit(0);
+  }
+  const aiTool = AI_TOOLS.find((t) => t.id === aiToolResult);
+  const scopeResult = await p.select({
+    message: "Where do you want to install?",
+    options: [
+      {
+        value: "workspace",
+        label: "\u{1F4C1} Workspace (Current Project)",
+        hint: `Install to ${path3.join(process.cwd(), aiTool.path)}`
+      },
+      {
+        value: "global",
+        label: "\u{1F30D} Global (All Projects)",
+        hint: `Install to ${getGlobalPathDisplay(aiTool)}`
+      }
+    ]
+  });
+  if (p.isCancel(scopeResult)) {
+    p.cancel("Installation cancelled.");
+    process.exit(0);
+  }
+  const scope = scopeResult;
+  let workspacePath = process.cwd();
+  if (scope === "workspace") {
+    const pathResult = await p.text({
+      message: "Workspace path:",
+      placeholder: process.cwd(),
+      defaultValue: process.cwd(),
+      validate: (value) => {
+        if (!value) return "Path is required";
+        const expanded = expandPath(value);
+        if (!directoryExists(expanded)) {
+          return `Directory does not exist: ${expanded}`;
+        }
+      }
+    });
+    if (p.isCancel(pathResult)) {
+      p.cancel("Installation cancelled.");
+      process.exit(0);
+    }
+    workspacePath = expandPath(pathResult);
+  }
+  const finalInstallPath = getInstallPath(aiTool, scope, workspacePath);
+  const rulesFilePath = scope === "global" ? path3.join(os2.homedir(), aiTool.rulesFile) : path3.join(workspacePath, aiTool.rulesFile);
+  if (directoryExists(finalInstallPath)) {
+    p.log.warn(
+      `${pc.yellow("\u26A0")} Existing installation detected at: ${pc.cyan(getDisplayPath(finalInstallPath))}`
+    );
+    const replaceResult = await p.select({
+      message: "What would you like to do?",
+      options: [
+        {
+          value: "replace",
+          label: "\u{1F504} Replace",
+          hint: "Remove existing and install fresh"
+        },
+        {
+          value: "merge",
+          label: "\u{1F500} Merge",
+          hint: "Keep config files, update skills only"
+        },
+        {
+          value: "skip",
+          label: "\u23ED\uFE0F Skip",
+          hint: "Keep existing, don't install"
+        },
+        {
+          value: "cancel",
+          label: "\u274C Cancel",
+          hint: "Exit installer"
+        }
+      ]
+    });
+    if (p.isCancel(replaceResult) || replaceResult === "cancel") {
+      p.cancel("Installation cancelled.");
+      process.exit(0);
+    }
+    if (replaceResult === "skip") {
+      p.log.info("Skipping installation. Existing files preserved.");
+      process.exit(0);
+    }
+    if (replaceResult === "replace") {
+      p.log.step(`Removing existing installation...`);
+      fs2.rmSync(finalInstallPath, { recursive: true, force: true });
+    }
+  }
+  const selectedKits = await p.multiselect({
+    message: "Select kits to install:",
+    options: KITS.filter((kit) => kit.available).map((kit) => ({
+      value: kit.id,
+      label: `${kit.icon} ${kit.name}`,
+      hint: kit.description
+    })),
+    required: true
+  });
+  if (p.isCancel(selectedKits)) {
+    p.cancel("Installation cancelled.");
+    process.exit(0);
+  }
+  const displayInstallPath = getDisplayPath(finalInstallPath);
+  const displayRulesPath = getDisplayPath(rulesFilePath);
+  const summaryLines = [
+    `${pc.bold("AI Tool:")} ${aiTool.icon} ${aiTool.name}`,
+    `${pc.bold("Scope:")} ${scope === "global" ? "\u{1F30D} Global" : "\u{1F4C1} Workspace"}`,
+    `${pc.bold("Install Path:")} ${pc.cyan(displayInstallPath)}`,
+    `${pc.bold("Rules File:")} ${pc.cyan(displayRulesPath)}`,
+    `${pc.bold("Kits:")} ${selectedKits.join(", ")}`
+  ];
+  p.note(summaryLines.join("\n"), "Installation Summary");
+  const confirmed = await p.confirm({
+    message: `Proceed with installation?`
+  });
+  if (p.isCancel(confirmed) || !confirmed) {
+    p.cancel("Installation cancelled.");
+    process.exit(0);
+  }
+  const s = p.spinner();
+  s.start(`Installing to ${pc.cyan(displayInstallPath)}...`);
+  try {
+    const results = await installKit({
+      aiTool,
+      kits: selectedKits,
+      targetPath: scope === "global" ? os2.homedir() : workspacePath,
+      scope
+    });
+    s.stop("Installation complete!");
+    p.note(
+      [
+        `${pc.bold("\u{1F4CD} Location:")} ${displayInstallPath}`,
+        `${pc.bold("\u{1F4DC} Rules:")} ${displayRulesPath}`,
+        "",
+        ...results.map(
+          (r) => `${pc.green("\u2713")} ${r.kit}: ${r.agents} agents, ${r.skills} skills, ${r.workflows} workflows`
+        )
+      ].join("\n"),
+      "Installed Successfully"
+    );
+    const archPath = scope === "global" ? `${getGlobalPathDisplay(aiTool)}/ARCHITECTURE.md` : `${aiTool.path}/ARCHITECTURE.md`;
+    p.outro(
+      pc.green("Success! ") + pc.dim("Next steps:\n") + `  ${pc.cyan("\u2022")} Use ${pc.bold("/filter")} to optimize skills for your project
+  ${pc.cyan("\u2022")} Use ${pc.bold("/plan")} to create project plans
+  ${pc.cyan("\u2022")} Use ${pc.bold("@backend-specialist")} for APIs
+  ${pc.cyan("\u2022")} Read ${pc.bold(archPath)}`
+    );
+  } catch (error) {
+    s.stop("Installation failed!");
+    p.log.error(error instanceof Error ? error.message : "Unknown error");
+    process.exit(1);
+  }
+}
+main().catch(console.error);