@groupby/ai-dev 0.1.0

package/dist/index.js

@@ -0,0 +1,612 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/list.ts
+import chalk from "chalk";
+
+// src/lib/discovery.ts
+import path from "path";
+import { fileURLToPath } from "url";
+import fg from "fast-glob";
+import fs from "fs-extra";
+
+// src/lib/frontmatter.ts
+import matter from "gray-matter";
+function parseFrontmatter(content) {
+  const parsed = matter(content);
+  return {
+    data: parsed.data,
+    content: parsed.content
+  };
+}
+function generateStub(frontmatter, skillName) {
+  const body = `
+See \`docs/ai/skills/${skillName}/SKILL.md\` and follow closely.
+`;
+  return matter.stringify(body, frontmatter);
+}
+
+// src/lib/discovery.ts
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
+var PACKAGE_ROOT = path.resolve(__dirname, "..");
+async function discoverSkills() {
+  const libraryPattern = "skills/library/*/SKILL.md";
+  const teamPattern = "teams/*/skills/*/SKILL.md";
+  const matches = await fg([libraryPattern, teamPattern], {
+    cwd: PACKAGE_ROOT,
+    absolute: true
+  });
+  const skills = [];
+  for (const match of matches) {
+    const content = await fs.readFile(match, "utf-8");
+    const { data } = parseFrontmatter(content);
+    const skillFolder = path.dirname(match);
+    const relativePath = path.relative(PACKAGE_ROOT, match);
+    let sourceType;
+    let teamName;
+    if (relativePath.startsWith("skills/library/")) {
+      sourceType = "library";
+    } else {
+      sourceType = "team";
+      const parts = relativePath.split(path.sep);
+      teamName = parts[1];
+    }
+    skills.push({
+      name: data.name || path.basename(skillFolder),
+      description: data.description || "",
+      sourcePath: skillFolder,
+      sourceType,
+      teamName,
+      frontmatter: data
+    });
+  }
+  return skills;
+}
+async function discoverTeams() {
+  const skills = await discoverSkills();
+  const teamMap = /* @__PURE__ */ new Map();
+  for (const skill of skills) {
+    if (skill.sourceType === "team" && skill.teamName) {
+      const existing = teamMap.get(skill.teamName) || [];
+      existing.push(skill);
+      teamMap.set(skill.teamName, existing);
+    }
+  }
+  return Array.from(teamMap.entries()).map(([name, skills2]) => ({
+    name,
+    skills: skills2
+  }));
+}
+async function findSkill(name) {
+  const skills = await discoverSkills();
+  return skills.find((s) => s.name === name && s.sourceType === "library") || skills.find((s) => s.name === name);
+}
+
+// src/commands/list.ts
+function formatTeamName(name) {
+  return name.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
+function truncate(str, max) {
+  if (str.length <= max) return str;
+  return str.slice(0, max - 3) + "...";
+}
+async function listSkills() {
+  const skills = await discoverSkills();
+  if (skills.length === 0) {
+    console.log(chalk.yellow("No skills found in package. This may indicate a build issue."));
+    process.exit(1);
+  }
+  const librarySkills = skills.filter((s) => s.sourceType === "library");
+  const teamSkills = skills.filter((s) => s.sourceType === "team");
+  if (librarySkills.length > 0) {
+    console.log(chalk.bold("\nLibrary"));
+    for (const s of librarySkills) {
+      console.log(`  ${chalk.cyan(s.name.padEnd(24))} ${truncate(s.description, 60)}`);
+    }
+  }
+  const teamMap = /* @__PURE__ */ new Map();
+  for (const s of teamSkills) {
+    const team = s.teamName || "unknown";
+    const existing = teamMap.get(team) || [];
+    existing.push(s);
+    teamMap.set(team, existing);
+  }
+  for (const [team, skillList] of teamMap) {
+    console.log(chalk.bold(`
+${formatTeamName(team)}`));
+    for (const s of skillList) {
+      console.log(`  ${chalk.cyan(s.name.padEnd(24))} ${truncate(s.description, 60)}`);
+    }
+  }
+  console.log();
+}
+async function listTeams() {
+  const teams = await discoverTeams();
+  if (teams.length === 0) {
+    console.log(chalk.yellow("No teams found."));
+    return;
+  }
+  console.log(chalk.bold("\nTeams"));
+  for (const t of teams) {
+    console.log(
+      `  ${chalk.cyan(formatTeamName(t.name).padEnd(24))} ${t.skills.length} skill${t.skills.length !== 1 ? "s" : ""}`
+    );
+  }
+  console.log();
+}
+async function listAll() {
+  await listSkills();
+  const teams = await discoverTeams();
+  if (teams.length > 0) {
+    console.log(chalk.bold("Teams"));
+    for (const t of teams) {
+      console.log(
+        `  ${chalk.cyan(formatTeamName(t.name).padEnd(24))} ${t.skills.length} skill${t.skills.length !== 1 ? "s" : ""}`
+      );
+    }
+    console.log();
+  }
+}
+function registerListCommand(program2) {
+  const list = program2.command("list").description("List available skills and teams");
+  list.command("skills").description("List all available skills").action(listSkills);
+  list.command("teams").description("List teams and their skill counts").action(listTeams);
+  list.action(listAll);
+}
+
+// src/commands/install.ts
+import path4 from "path";
+import chalk3 from "chalk";
+
+// src/lib/clients.ts
+import path2 from "path";
+import fs2 from "fs-extra";
+var ALL_CLIENTS = [
+  { name: "Copilot", skillsDir: ".github/skills", detectDir: ".github" },
+  { name: "Claude Code", skillsDir: ".claude/skills", detectDir: ".claude" },
+  { name: "Codex", skillsDir: ".agents/skills", detectDir: ".agents" }
+];
+async function detectClients(targetDir) {
+  const detected = [];
+  for (const client of ALL_CLIENTS) {
+    const dirPath = path2.join(targetDir, client.detectDir);
+    if (await fs2.pathExists(dirPath)) {
+      detected.push(client);
+    }
+  }
+  return detected;
+}
+
+// src/lib/installer.ts
+import path3 from "path";
+import fs3 from "fs-extra";
+async function handleFile(srcPath, destPath, options, result, onConflict, contentOverride) {
+  const relativeDest = path3.relative(options.targetDir, destPath);
+  if (await fs3.pathExists(destPath)) {
+    const existingContent = await fs3.readFile(destPath, "utf-8");
+    const newContent = contentOverride ?? await fs3.readFile(srcPath, "utf-8");
+    if (existingContent === newContent) {
+      result.skipped.push(relativeDest);
+      return;
+    }
+    if (options.force) {
+      if (!options.dryRun) {
+        await fs3.ensureDir(path3.dirname(destPath));
+        await fs3.writeFile(destPath, newContent);
+      }
+      result.overwritten.push(relativeDest);
+    } else if (options.skipExisting) {
+      result.skipped.push(relativeDest);
+    } else if (onConflict) {
+      const choice = await onConflict(relativeDest);
+      if (choice === "overwrite") {
+        if (!options.dryRun) {
+          await fs3.ensureDir(path3.dirname(destPath));
+          await fs3.writeFile(destPath, newContent);
+        }
+        result.overwritten.push(relativeDest);
+      } else {
+        result.skipped.push(relativeDest);
+      }
+    } else {
+      result.skipped.push(relativeDest);
+    }
+  } else {
+    if (!options.dryRun) {
+      await fs3.ensureDir(path3.dirname(destPath));
+      if (contentOverride) {
+        await fs3.writeFile(destPath, contentOverride);
+      } else {
+        await fs3.copy(srcPath, destPath);
+      }
+    }
+    result.created.push(relativeDest);
+  }
+}
+async function installSkill(skill, options, onConflict) {
+  const result = {
+    skill: skill.name,
+    created: [],
+    skipped: [],
+    overwritten: []
+  };
+  const destFolder = path3.join(options.targetDir, "docs", "ai", "skills", skill.name);
+  const sourceFiles = await fs3.readdir(skill.sourcePath);
+  for (const file of sourceFiles) {
+    const srcFile = path3.join(skill.sourcePath, file);
+    const stat = await fs3.stat(srcFile);
+    if (stat.isFile()) {
+      const destFile = path3.join(destFolder, file);
+      await handleFile(srcFile, destFile, options, result, onConflict);
+    }
+  }
+  for (const client of options.clients) {
+    const stubPath = path3.join(
+      options.targetDir,
+      client.skillsDir,
+      skill.name,
+      "SKILL.md"
+    );
+    const stubContent = generateStub(skill.frontmatter, skill.name);
+    await handleFile("", stubPath, options, result, onConflict, stubContent);
+  }
+  return result;
+}
+async function installSkills(skills, options, onConflict) {
+  const results = [];
+  for (const skill of skills) {
+    results.push(await installSkill(skill, options, onConflict));
+  }
+  return results;
+}
+
+// src/lib/prompts.ts
+import { select, checkbox, confirm } from "@inquirer/prompts";
+import chalk2 from "chalk";
+async function promptSelectSkills(skills) {
+  const librarySkills = skills.filter((s) => s.sourceType === "library");
+  const teamSkills = skills.filter((s) => s.sourceType === "team");
+  const choices = [];
+  if (librarySkills.length > 0) {
+    choices.push(
+      ...librarySkills.map((s) => ({
+        name: `${chalk2.dim("[Library]")} ${s.name} \u2014 ${truncate2(s.description, 60)}`,
+        value: s
+      }))
+    );
+  }
+  const teamMap = /* @__PURE__ */ new Map();
+  for (const s of teamSkills) {
+    const team = s.teamName || "unknown";
+    const existing = teamMap.get(team) || [];
+    existing.push(s);
+    teamMap.set(team, existing);
+  }
+  for (const [team, teamSkillList] of teamMap) {
+    choices.push(
+      ...teamSkillList.map((s) => ({
+        name: `${chalk2.dim(`[${formatTeamName2(team)}]`)} ${s.name} \u2014 ${truncate2(s.description, 60)}`,
+        value: s
+      }))
+    );
+  }
+  return checkbox({
+    message: "Select skills to install:",
+    choices,
+    required: true
+  });
+}
+async function promptSelectTeam(teams) {
+  return select({
+    message: "Select a team:",
+    choices: teams.map((t) => ({
+      name: `${formatTeamName2(t.name)} (${t.skills.length} skill${t.skills.length !== 1 ? "s" : ""})`,
+      value: t
+    }))
+  });
+}
+async function promptSelectClients(allClients, detectedClients) {
+  const detectedNames = new Set(detectedClients.map((c) => c.name));
+  return checkbox({
+    message: "Select LLM clients for stub installation:",
+    choices: allClients.map((c) => ({
+      name: detectedNames.has(c.name) ? `${c.name} ${chalk2.green("(detected)")}` : c.name,
+      value: c,
+      checked: detectedNames.has(c.name)
+    }))
+  });
+}
+async function promptIncludeLibrary() {
+  return confirm({
+    message: "Also install library skills?",
+    default: false
+  });
+}
+async function promptConfirmInstall(skills, clients, targetDir) {
+  console.log();
+  console.log(chalk2.bold("Install summary:"));
+  console.log(`  Skills: ${skills.map((s) => s.name).join(", ")}`);
+  console.log(`  Clients: ${clients.map((c) => c.name).join(", ") || chalk2.dim("none")}`);
+  console.log(`  Target: ${targetDir}`);
+  console.log();
+  return confirm({ message: "Proceed with installation?", default: true });
+}
+async function promptConflict(filePath) {
+  const answer = await select({
+    message: `File already exists with different content: ${chalk2.yellow(filePath)}`,
+    choices: [
+      { name: "Overwrite", value: "overwrite" },
+      { name: "Skip", value: "skip" }
+    ]
+  });
+  return answer;
+}
+function truncate2(str, max) {
+  if (str.length <= max) return str;
+  return str.slice(0, max - 3) + "...";
+}
+function formatTeamName2(name) {
+  return name.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
+
+// src/commands/install.ts
+function printResults(results, options) {
+  const prefix = options.dryRun ? chalk3.yellow("[DRY RUN] ") : "";
+  const createdWord = options.dryRun ? "would create" : "created";
+  const skippedWord = "up to date";
+  const overwrittenWord = options.dryRun ? "would overwrite" : "overwritten";
+  console.log(`
+${prefix}${chalk3.bold("Install complete")}
+`);
+  console.log("  Skill                   Status");
+  console.log("  " + "\u2500".repeat(50));
+  for (const r of results) {
+    const parts = [];
+    if (r.created.length > 0) parts.push(chalk3.green(`${r.created.length} ${createdWord}`));
+    if (r.skipped.length > 0) parts.push(chalk3.dim(`${r.skipped.length} ${skippedWord}`));
+    if (r.overwritten.length > 0) parts.push(chalk3.yellow(`${r.overwritten.length} ${overwrittenWord}`));
+    console.log(`  ${chalk3.cyan(r.skill.padEnd(24))} ${parts.join(", ")}`);
+  }
+  console.log(`
+  Target: ${options.targetDir}`);
+  console.log(`  Clients: ${options.clients.map((c) => c.name).join(", ") || chalk3.dim("none")}`);
+  console.log();
+}
+async function installSkillCmd(name, _opts, cmd) {
+  const parentOpts = cmd.parent.opts();
+  const force = Boolean(parentOpts.force);
+  const skipExisting = Boolean(parentOpts.skipExisting);
+  const dryRun = Boolean(parentOpts.dryRun);
+  const targetDir = path4.resolve(
+    parentOpts.target || process.cwd()
+  );
+  const skill = await findSkill(name);
+  if (!skill) {
+    const all = await discoverSkills();
+    console.log(chalk3.red(`Skill "${name}" not found.`));
+    console.log(`Available skills: ${all.map((s) => s.name).join(", ")}`);
+    process.exit(1);
+  }
+  const detected = await detectClients(targetDir);
+  let clients;
+  if (force) {
+    clients = detected.length > 0 ? detected : ALL_CLIENTS;
+  } else {
+    clients = await promptSelectClients(ALL_CLIENTS, detected);
+  }
+  const options = {
+    targetDir,
+    clients,
+    force,
+    skipExisting,
+    dryRun
+  };
+  const result = await installSkill(skill, options, force || skipExisting ? void 0 : promptConflict);
+  printResults([result], options);
+}
+async function installTeamCmd(name, _opts, cmd) {
+  const parentOpts = cmd.parent.opts();
+  const force = Boolean(parentOpts.force);
+  const skipExisting = Boolean(parentOpts.skipExisting);
+  const dryRun = Boolean(parentOpts.dryRun);
+  const targetDir = path4.resolve(
+    parentOpts.target || process.cwd()
+  );
+  const teams = await discoverTeams();
+  const team = teams.find(
+    (t) => t.name === name || t.name.toLowerCase() === name.toLowerCase()
+  );
+  if (!team) {
+    console.log(chalk3.red(`Team "${name}" not found.`));
+    console.log(`Available teams: ${teams.map((t) => t.name).join(", ")}`);
+    process.exit(1);
+  }
+  let skillsToInstall = [...team.skills];
+  const includeLibrary = await promptIncludeLibrary();
+  if (includeLibrary) {
+    const allSkills = await discoverSkills();
+    const librarySkills = allSkills.filter((s) => s.sourceType === "library");
+    skillsToInstall.push(...librarySkills);
+  }
+  const detected = await detectClients(targetDir);
+  let clients;
+  if (force) {
+    clients = detected.length > 0 ? detected : ALL_CLIENTS;
+  } else {
+    clients = await promptSelectClients(ALL_CLIENTS, detected);
+  }
+  const options = {
+    targetDir,
+    clients,
+    force,
+    skipExisting,
+    dryRun
+  };
+  const results = await installSkills(
+    skillsToInstall,
+    options,
+    force || skipExisting ? void 0 : promptConflict
+  );
+  printResults(results, options);
+}
+function registerInstallCommand(program2) {
+  const install = program2.command("install").description("Install skills").option("--force", "Overwrite existing files without prompting").option("--skip-existing", "Skip files that already exist without prompting").option("--dry-run", "Show what would be installed without writing files").option("--target <dir>", "Install to a different directory (default: CWD)");
+  install.command("skill <name>").description("Install a specific skill").action(installSkillCmd);
+  install.command("team <name>").description("Install all skills for a team").action(installTeamCmd);
+}
+
+// src/commands/interactive.ts
+import { select as select2 } from "@inquirer/prompts";
+import chalk4 from "chalk";
+function printResults2(results, options) {
+  const prefix = options.dryRun ? chalk4.yellow("[DRY RUN] ") : "";
+  const createdWord = options.dryRun ? "would create" : "created";
+  const skippedWord = "up to date";
+  const overwrittenWord = options.dryRun ? "would overwrite" : "overwritten";
+  console.log(`
+${prefix}${chalk4.bold("Install complete")}
+`);
+  console.log("  Skill                   Status");
+  console.log("  " + "\u2500".repeat(50));
+  for (const r of results) {
+    const parts = [];
+    if (r.created.length > 0) parts.push(chalk4.green(`${r.created.length} ${createdWord}`));
+    if (r.skipped.length > 0) parts.push(chalk4.dim(`${r.skipped.length} ${skippedWord}`));
+    if (r.overwritten.length > 0) parts.push(chalk4.yellow(`${r.overwritten.length} ${overwrittenWord}`));
+    console.log(`  ${chalk4.cyan(r.skill.padEnd(24))} ${parts.join(", ")}`);
+  }
+  console.log(`
+  Target: ${options.targetDir}`);
+  console.log(`  Clients: ${options.clients.map((c) => c.name).join(", ") || chalk4.dim("none")}`);
+  console.log();
+}
+async function listAll2() {
+  const skills = await discoverSkills();
+  const teams = await discoverTeams();
+  if (skills.length === 0) {
+    console.log(chalk4.yellow("No skills found in package. This may indicate a build issue."));
+    return;
+  }
+  const librarySkills = skills.filter((s) => s.sourceType === "library");
+  const teamSkills = skills.filter((s) => s.sourceType === "team");
+  const formatTeamName3 = (name) => name.split("-").map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+  const truncate3 = (str, max) => str.length <= max ? str : str.slice(0, max - 3) + "...";
+  if (librarySkills.length > 0) {
+    console.log(chalk4.bold("\nLibrary"));
+    for (const s of librarySkills) {
+      console.log(`  ${chalk4.cyan(s.name.padEnd(24))} ${truncate3(s.description, 60)}`);
+    }
+  }
+  const teamMap = /* @__PURE__ */ new Map();
+  for (const s of teamSkills) {
+    const team = s.teamName || "unknown";
+    const existing = teamMap.get(team) || [];
+    existing.push(s);
+    teamMap.set(team, existing);
+  }
+  for (const [team, skillList] of teamMap) {
+    console.log(chalk4.bold(`
+${formatTeamName3(team)}`));
+    for (const s of skillList) {
+      console.log(`  ${chalk4.cyan(s.name.padEnd(24))} ${truncate3(s.description, 60)}`);
+    }
+  }
+  if (teams.length > 0) {
+    console.log(chalk4.bold("\nTeams"));
+    for (const t of teams) {
+      console.log(
+        `  ${chalk4.cyan(formatTeamName3(t.name).padEnd(24))} ${t.skills.length} skill${t.skills.length !== 1 ? "s" : ""}`
+      );
+    }
+  }
+  console.log();
+}
+async function runInteractive() {
+  console.log(chalk4.bold("\n@groupby/ai-dev \u2014 AI Skills Installer\n"));
+  const action = await select2({
+    message: "What would you like to do?",
+    choices: [
+      { name: "Install skill(s)", value: "install-skills" },
+      { name: "Install team skills", value: "install-team" },
+      { name: "List available skills & teams", value: "list" }
+    ]
+  });
+  if (action === "list") {
+    await listAll2();
+    return;
+  }
+  const targetDir = process.cwd();
+  if (action === "install-skills") {
+    const allSkills = await discoverSkills();
+    if (allSkills.length === 0) {
+      console.log(chalk4.yellow("No skills found in package. This may indicate a build issue."));
+      process.exit(1);
+    }
+    const selectedSkills = await promptSelectSkills(allSkills);
+    const detected = await detectClients(targetDir);
+    const clients = await promptSelectClients(ALL_CLIENTS, detected);
+    const confirmed = await promptConfirmInstall(selectedSkills, clients, targetDir);
+    if (!confirmed) {
+      console.log(chalk4.dim("Cancelled."));
+      return;
+    }
+    const options = {
+      targetDir,
+      clients,
+      force: false,
+      skipExisting: false,
+      dryRun: false
+    };
+    const results = await installSkills(selectedSkills, options, promptConflict);
+    printResults2(results, options);
+  } else if (action === "install-team") {
+    const teams = await discoverTeams();
+    if (teams.length === 0) {
+      console.log(chalk4.yellow("No teams found."));
+      return;
+    }
+    const team = await promptSelectTeam(teams);
+    let skillsToInstall = [...team.skills];
+    const includeLibrary = await promptIncludeLibrary();
+    if (includeLibrary) {
+      const allSkills = await discoverSkills();
+      const librarySkills = allSkills.filter((s) => s.sourceType === "library");
+      skillsToInstall.push(...librarySkills);
+    }
+    const detected = await detectClients(targetDir);
+    const clients = await promptSelectClients(ALL_CLIENTS, detected);
+    const confirmed = await promptConfirmInstall(skillsToInstall, clients, targetDir);
+    if (!confirmed) {
+      console.log(chalk4.dim("Cancelled."));
+      return;
+    }
+    const options = {
+      targetDir,
+      clients,
+      force: false,
+      skipExisting: false,
+      dryRun: false
+    };
+    const results = await installSkills(skillsToInstall, options, promptConflict);
+    printResults2(results, options);
+  }
+}
+
+// src/index.ts
+var program = new Command();
+program.name("ai-dev").description("Interactive installer for GroupBy AI development skills").version("0.1.0").action(runInteractive);
+registerListCommand(program);
+registerInstallCommand(program);
+program.addHelpText(
+  "after",
+  `
+Examples:
+  $ npx @groupby/ai-dev                              Interactive mode
+  $ npx @groupby/ai-dev list                          List skills and teams
+  $ npx @groupby/ai-dev install skill frontend-design Install a single skill
+  $ npx @groupby/ai-dev install team brain-studio     Install all team skills
+  $ npx @groupby/ai-dev install team brain-studio --dry-run`
+);
+program.parse();

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@groupby/ai-dev",
+  "version": "0.1.0",
+  "description": "Interactive installer for Rezolve Ai development skills",
+  "type": "module",
+  "bin": {
+    "ai-dev": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "skills/",
+    "teams/"
+  ],
+  "scripts": {
+    "prebuild": "cp -r ../skills ./skills && cp -r ../teams ./teams",
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rezolved/ai-dev-shared.git",
+    "directory": "cli"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0",
+    "gray-matter": "^4.0.3",
+    "fast-glob": "^3.3.0",
+    "fs-extra": "^11.2.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/node": "^20.0.0",
+    "@types/fs-extra": "^11.0.0",
+    "tsup": "^8.0.0"
+  }
+}