@culeo/specx 0.1.0

package/specx.js

@@ -0,0 +1,385 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import { fileURLToPath } from "url";
+import path from "path";
+import fs from "fs";
+import os from "os";
+import readline from "readline";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// ─── Paths ───────────────────────────────────────────────────────
+const SPECX_HOME = process.env.SPECX_HOME || path.resolve(__dirname);
+const SKILLS_DIR = path.join(SPECX_HOME, "skills");
+
+// ─── Registered CLI Targets ──────────────────────────────────────
+const CLI_TARGETS = [
+  {
+    id: "claude",
+    label: "Claude Code",
+    dir: () => path.join(process.env.CLAUDE_HOME || path.join(os.homedir(), ".claude"), "skills"),
+  },
+  {
+    id: "codex",
+    label: "Codex",
+    dir: () => path.join(process.env.CODEX_HOME || path.join(os.homedir(), ".codex"), "skills"),
+  },
+];
+
+// ─── Interactive Multi-Select ────────────────────────────────────
+function isTTY() {
+  return process.stdin.isTTY;
+}
+
+async function interactiveSelect(items, prompt, preSelected, showStatus) {
+  let cursor = 0;
+  const selected = new Set(preSelected);
+
+  const render = () => {
+    const lines = [];
+    lines.push(`\n${prompt}\n`);
+    for (let i = 0; i < items.length; i++) {
+      const isSel = selected.has(items[i].id);
+      const isCur = i === cursor;
+      const status = showStatus ? (items[i].detected ? "" : " (not detected)") : "";
+      lines.push(`${isCur ? "›" : " "} ${isSel ? "✓" : "○"} ${items[i].label}${status}`);
+    }
+    lines.push("\n  ↑↓ navigate · space toggle · enter confirm\n");
+    return lines;
+  };
+
+  const clearScreen = (lines) => {
+    readline.cursorTo(process.stdout, 0);
+    readline.moveCursor(process.stdout, 0, -(lines.length));
+    for (let i = 0; i < lines.length; i++) {
+      readline.clearLine(process.stdout, 0);
+      readline.moveCursor(process.stdout, 0, 1);
+    }
+    readline.moveCursor(process.stdout, 0, -lines.length);
+  };
+
+  if (process.stdin.setRawMode) process.stdin.setRawMode(true);
+  process.stdout.write(render().join("\n"));
+
+  return new Promise((resolve) => {
+    const handler = (key) => {
+      const keyStr = key.toString();
+      const lines = render();
+
+      if (keyStr === "\u001b[A") {
+        cursor = (cursor - 1 + items.length) % items.length;
+        clearScreen(lines);
+        process.stdout.write(lines.join("\n"));
+      } else if (keyStr === "\u001b[B") {
+        cursor = (cursor + 1) % items.length;
+        clearScreen(lines);
+        process.stdout.write(lines.join("\n"));
+      } else if (keyStr === " ") {
+        const item = items[cursor];
+        if (selected.has(item.id)) selected.delete(item.id);
+        else selected.add(item.id);
+        clearScreen(lines);
+        process.stdout.write(lines.join("\n"));
+      } else if (keyStr === "\r" || keyStr === "\n") {
+        process.stdin.removeListener("data", handler);
+        if (process.stdin.setRawMode) process.stdin.setRawMode(false);
+        resolve(Array.from(selected));
+      }
+    };
+    process.stdin.on("data", handler);
+  });
+}
+
+async function interactiveSelectTargets(targets) {
+  const enriched = targets.map((t) => ({
+    ...t,
+    detected: fs.existsSync(t.dir()),
+  }));
+  const detected = enriched.filter((t) => t.detected);
+  const notDetected = enriched.filter((t) => !t.detected);
+  const all = [...detected, ...notDetected];
+
+  if (all.length === 0) {
+    console.log("No supported CLI tools detected. Install one of:");
+    for (const t of targets) console.log(`  - ${t.label}`);
+    process.exit(1);
+  }
+
+  return interactiveSelect(
+    all,
+    "📦 Select AI CLI tools to install specx skills into:",
+    detected.map((t) => t.id),
+    true
+  );
+}
+
+async function interactiveScopeSelect() {
+  const items = [
+    { id: "user", label: "User (install to ~/.{tool}/skills/)" },
+    { id: "project", label: `Project (install to ./.{tool}/skills/)` },
+  ];
+  const result = await interactiveSelect(items, "📁 Select scope:", ["user"], false);
+  return result.includes("project") ? "project" : "user";
+}
+
+// ─── CLI Setup ───────────────────────────────────────────────────
+const program = new Command();
+
+program
+  .name("specx")
+  .description("specx CLI — install specx skills to AI coding agents")
+  .version("0.1.0");
+
+// ─── Resolve scope helper ────────────────────────────────────────
+function resolveScope(options) {
+  if (options.project !== undefined) return { isProject: true, projectDir: typeof options.project === "string" ? options.project : process.cwd() };
+  if (options.user) return { isProject: false };
+  return null; // not specified
+}
+
+function getFinalDir(targetId, isProject, projectDir) {
+  if (isProject) return path.join(projectDir, `.${targetId}`, "skills");
+  const target = CLI_TARGETS.find((t) => t.id === targetId);
+  return target.dir();
+}
+
+// ─── Install Command ─────────────────────────────────────────────
+program
+  .command("install")
+  .description("Install specx skills to AI CLI tools")
+  .option("--claude", "Install to Claude Code")
+  .option("--codex", "Install to Codex")
+  .option("--user", "Install user-wide (~/.claude/skills/ or ~/.codex/skills/)")
+  .option("--project [dir]", "Install project-wide (e.g. .claude/skills/ in project dir)")
+  .option("--all", "Install to all detected CLI tools (non-interactive)")
+  .action(async (options) => {
+    const explicitTargets = [];
+    if (options.claude) explicitTargets.push("claude");
+    if (options.codex) explicitTargets.push("codex");
+
+    // Resolve target list
+    let targetIds;
+    if (explicitTargets.length > 0) {
+      targetIds = explicitTargets;
+    } else if (options.all || !isTTY()) {
+      targetIds = CLI_TARGETS.filter((t) => fs.existsSync(t.dir())).map((t) => t.id);
+      if (targetIds.length === 0) {
+        console.error("✖ No supported CLI tools detected.");
+        process.exit(1);
+      }
+    } else {
+      // Interactive: step 1 — select targets
+      targetIds = await interactiveSelectTargets(CLI_TARGETS);
+      if (targetIds.length === 0) {
+        console.log("No targets selected. Aborting.");
+        return;
+      }
+    }
+
+    // Resolve scope
+    const scope = resolveScope(options);
+    let isProject, projectDir;
+    if (scope) {
+      isProject = scope.isProject;
+      projectDir = scope.projectDir;
+    } else if (isTTY() && explicitTargets.length === 0 && !options.all) {
+      // Interactive: step 2 — select scope
+      const scopeChoice = await interactiveScopeSelect();
+      isProject = scopeChoice === "project";
+      projectDir = process.cwd();
+    } else {
+      isProject = options.project !== undefined;
+      projectDir = typeof options.project === "string" ? options.project : process.cwd();
+    }
+
+    const skillsToInstall = getAvailableSkills();
+    if (skillsToInstall.length === 0) {
+      console.error("✖ No specx skills found.");
+      process.exit(1);
+    }
+
+    for (const targetId of targetIds) {
+      const target = CLI_TARGETS.find((t) => t.id === targetId);
+      const finalDir = getFinalDir(targetId, isProject, projectDir);
+
+      let installCount = 0;
+      for (const skillName of skillsToInstall) {
+        const destDir = path.join(finalDir, skillName);
+        if (fs.existsSync(destDir)) {
+          console.log(`  ○ ${target.label}: ${skillName} already installed`);
+          continue;
+        }
+        const srcDir = path.join(SKILLS_DIR, skillName);
+        if (!fs.existsSync(srcDir)) {
+          console.log(`  ✖ ${skillName}: source not found, skipping`);
+          continue;
+        }
+        fs.mkdirSync(finalDir, { recursive: true });
+        copyDirSync(srcDir, destDir);
+        console.log(`  ✓ ${target.label}: ${skillName}`);
+        installCount++;
+      }
+
+      if (installCount > 0) {
+        console.log(`\n✓ Installed ${installCount} skill(s) to ${target.label} (${isProject ? "project" : "user"} level)`);
+      }
+    }
+  });
+
+// ─── Uninstall Command ───────────────────────────────────────────
+program
+  .command("uninstall")
+  .description("Remove installed specx skills from AI CLI tools")
+  .option("--claude", "Uninstall from Claude Code")
+  .option("--codex", "Uninstall from Codex")
+  .option("--user", "Target user-wide installation")
+  .option("--project [dir]", "Target project-wide installation")
+  .option("--all", "Uninstall from all targets (non-interactive)")
+  .action(async (options) => {
+    const explicitTargets = [];
+    if (options.claude) explicitTargets.push("claude");
+    if (options.codex) explicitTargets.push("codex");
+
+    let targetIds;
+    if (explicitTargets.length > 0) {
+      targetIds = explicitTargets;
+    } else if (options.all || !isTTY()) {
+      targetIds = CLI_TARGETS.filter((t) => fs.existsSync(t.dir())).map((t) => t.id);
+      if (targetIds.length === 0) {
+        console.error("✖ No supported CLI tools detected.");
+        process.exit(1);
+      }
+    } else {
+      targetIds = await interactiveSelectTargets(CLI_TARGETS);
+      if (targetIds.length === 0) {
+        console.log("No targets selected. Aborting.");
+        return;
+      }
+    }
+
+    const scope = resolveScope(options);
+    let isProject, projectDir;
+    if (scope) {
+      isProject = scope.isProject;
+      projectDir = scope.projectDir;
+    } else if (isTTY() && explicitTargets.length === 0 && !options.all) {
+      const scopeChoice = await interactiveScopeSelect();
+      isProject = scopeChoice === "project";
+      projectDir = process.cwd();
+    } else {
+      isProject = options.project !== undefined;
+      projectDir = typeof options.project === "string" ? options.project : process.cwd();
+    }
+
+    for (const targetId of targetIds) {
+      const target = CLI_TARGETS.find((t) => t.id === targetId);
+      const finalDir = getFinalDir(targetId, isProject, projectDir);
+
+      if (!fs.existsSync(finalDir)) {
+        console.log(`${target.label}: No skills installed.`);
+        continue;
+      }
+
+      let removedCount = 0;
+      const entries = fs.readdirSync(finalDir);
+      for (const name of entries) {
+        const dir = path.join(finalDir, name);
+        if (fs.statSync(dir).isDirectory() && fs.existsSync(path.join(dir, "SKILL.md")) && name.startsWith("specx-")) {
+          fs.rmSync(dir, { recursive: true, force: true });
+          console.log(`  ✖ ${target.label}: ${name}`);
+          removedCount++;
+        }
+      }
+
+      if (removedCount > 0) {
+        console.log(`\n✓ Removed ${removedCount} skill(s) from ${target.label} (${isProject ? "project" : "user"} level)`);
+      } else {
+        console.log(`${target.label}: No specx skills installed.`);
+      }
+    }
+  });
+
+// ─── List Command ────────────────────────────────────────────────
+program
+  .command("list")
+  .description("List installed specx skills")
+  .action(() => {
+    for (const target of CLI_TARGETS) {
+      const targetDir = target.dir();
+      if (!fs.existsSync(targetDir)) {
+        console.log(`\n📦 ${target.label}: not installed or not detected`);
+        continue;
+      }
+
+      const installed = fs.readdirSync(targetDir)
+        .filter((name) => {
+          const dir = path.join(targetDir, name);
+          return fs.statSync(dir).isDirectory() && fs.existsSync(path.join(dir, "SKILL.md")) && name.startsWith("specx-");
+        })
+        .sort();
+
+      if (installed.length === 0) {
+        console.log(`\n📦 ${target.label}: no specx skills installed`);
+      } else {
+        console.log(`\n📦 ${target.label}:`);
+        for (const s of installed) console.log(`  ✓ ${s}`);
+      }
+    }
+  });
+
+// ─── Available Command ───────────────────────────────────────────
+program
+  .command("available")
+  .description("List all available specx skills")
+  .action(() => {
+    listAvailableSkills();
+  });
+
+// ─── Core Logic ──────────────────────────────────────────────────
+
+function getAvailableSkills() {
+  if (!fs.existsSync(SKILLS_DIR)) {
+    console.error(`✖ Skills directory not found: ${SKILLS_DIR}`);
+    process.exit(1);
+  }
+  return fs.readdirSync(SKILLS_DIR)
+    .filter((name) => {
+      const skillDir = path.join(SKILLS_DIR, name);
+      return fs.statSync(skillDir).isDirectory() && fs.existsSync(path.join(skillDir, "SKILL.md"));
+    })
+    .sort();
+}
+
+function listAvailableSkills() {
+  const skills = getAvailableSkills();
+  console.log("\n📦 Available specx skills:");
+  for (const s of skills) {
+    const skillMd = path.join(SKILLS_DIR, s, "SKILL.md");
+    let desc = "";
+    try {
+      const content = fs.readFileSync(skillMd, "utf-8");
+      const match = content.match(/description:\s*(.+)/);
+      if (match) desc = match[1];
+    } catch {}
+    console.log(`  ${s.padEnd(35)} ${desc}`);
+  }
+  console.log("\nInstall with: specx install");
+}
+
+function copyDirSync(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+// ─── Run ─────────────────────────────────────────────────────────
+program.parse();