autodoc-agent-kit 1.0.0

package/tools/cli/installers/lib/modules/manager.js

@@ -0,0 +1,59 @@
+'use strict';
+
+const path = require('node:path');
+const fs = require('fs-extra');
+const yaml = require('js-yaml');
+
+const MODULES_DIR = path.join(__dirname, '..', '..', '..', '..', '..', 'src', 'modules');
+
+class ModuleManager {
+  /**
+   * Resolves all skill source directories for a given list of module codes.
+   *
+   * @param {string[]} moduleCodes - e.g. ['engineering', 'qa']
+   * @returns {{ moduleCode: string, skillName: string, srcPath: string }[]}
+   */
+  resolveSkills(moduleCodes) {
+    const skills = [];
+
+    for (const code of moduleCodes) {
+      const skillsDir = path.join(MODULES_DIR, code, 'skills');
+
+      if (!fs.existsSync(skillsDir)) {
+        throw new Error(`Module not found: ${code} (expected skills at ${skillsDir})`);
+      }
+
+      const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+
+        const skillPath = path.join(skillsDir, entry.name);
+        const skillMd = path.join(skillPath, 'SKILL.md');
+
+        if (!fs.existsSync(skillMd)) {
+          console.warn(`  Warning: ${entry.name} has no SKILL.md — skipping`);
+          continue;
+        }
+
+        skills.push({
+          moduleCode: code,
+          skillName: entry.name,
+          srcPath: skillPath,
+        });
+      }
+    }
+
+    return skills;
+  }
+
+  /**
+   * Returns the module.yaml definition for a given module code.
+   */
+  getModuleDef(code) {
+    const moduleYaml = path.join(MODULES_DIR, code, 'module.yaml');
+    if (!fs.existsSync(moduleYaml)) return null;
+    return yaml.load(fs.readFileSync(moduleYaml, 'utf8'));
+  }
+}
+
+module.exports = { ModuleManager };

package/tools/cli/lib/ui.js

@@ -0,0 +1,199 @@
+'use strict';
+
+const path = require('node:path');
+const fs = require('fs-extra');
+const yaml = require('js-yaml');
+const { intro, outro, text, select, multiselect, confirm, spinner, log, cancel } = require('@clack/prompts');
+const { printWelcome } = require('./welcome');
+
+const MODULES_DIR = path.join(__dirname, '..', '..', '..', 'src', 'modules');
+const PLATFORM_CODES_PATH = path.join(
+  __dirname,
+  '..',
+  'installers',
+  'lib',
+  'ide',
+  'platform-codes.yaml'
+);
+
+class UI {
+  /**
+   * Loads module definitions from src/modules/{module}/module.yaml
+   */
+  loadModules() {
+    const modules = [];
+    const entries = fs.readdirSync(MODULES_DIR, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const moduleYaml = path.join(MODULES_DIR, entry.name, 'module.yaml');
+      if (fs.existsSync(moduleYaml)) {
+        const def = yaml.load(fs.readFileSync(moduleYaml, 'utf8'));
+        modules.push(def);
+      }
+    }
+    return modules;
+  }
+
+  /**
+   * Loads IDE platform definitions from platform-codes.yaml
+   */
+  loadPlatforms() {
+    const raw = yaml.load(fs.readFileSync(PLATFORM_CODES_PATH, 'utf8'));
+    return raw.platforms;
+  }
+
+  /**
+   * Main interactive install flow.
+   * Returns a config object for the Installer, or { cancelled: true }.
+   */
+  async promptInstall(options = {}) {
+    printWelcome();
+    intro('autodoc-agent-kit — AI dev team installer');
+
+    // ── 1. Scope (global vs project) ─────────────────────────────────────────
+    let scope;
+    if (options.global) {
+      scope = 'global';
+    } else if (options.yes) {
+      scope = 'project';
+    } else {
+      const result = await select({
+        message: 'Where do you want to install the skills?',
+        options: [
+          {
+            value: 'project',
+            label: 'This project',
+            hint: 'installs into .{ide}/skills inside the current project directory',
+          },
+          {
+            value: 'global',
+            label: 'Globally (all projects)',
+            hint: 'installs into ~/.{ide}/skills — available in every project on this machine',
+          },
+        ],
+      });
+      if (typeof result === 'symbol') return { cancelled: true };
+      scope = result;
+    }
+
+    // ── 2. Target directory (project scope only) ─────────────────────────────
+    let targetDir;
+    if (scope === 'global') {
+      targetDir = process.cwd(); // unused for path resolution, but kept for manifest context
+      log.info('Installing globally into ~/.{ide}/skills for each selected IDE');
+    } else if (options.directory) {
+      targetDir = path.resolve(options.directory.replace(/^~/, process.env.HOME));
+      log.info(`Installing into: ${targetDir}`);
+    } else if (options.yes) {
+      targetDir = process.cwd();
+      log.info(`Installing into: ${targetDir}`);
+    } else {
+      const input = await text({
+        message: 'Install into which directory?',
+        placeholder: process.cwd(),
+        initialValue: process.cwd(),
+        validate: (v) => {
+          const resolved = path.resolve(v || process.cwd());
+          if (!fs.existsSync(resolved)) return `Directory not found: ${resolved}`;
+        },
+      });
+      if (typeof input === 'symbol') return { cancelled: true };
+      targetDir = path.resolve(input || process.cwd());
+      log.info(`Installing into: ${targetDir}`);
+    }
+
+    // ── 3. Check existing install ────────────────────────────────────────────
+    const os = require('node:os');
+    const manifestBase = scope === 'global' ? os.homedir() : targetDir;
+    const manifestPath = path.join(manifestBase, '.autodoc', 'manifest.yaml');
+    const isReinstall = fs.existsSync(manifestPath);
+    if (isReinstall) {
+      log.warn('Existing installation found — reinstalling will back up changed files.');
+    }
+
+    // ── 4. Module selection ──────────────────────────────────────────────────
+    const allModules = this.loadModules();
+    let selectedModuleCodes;
+
+    if (options.modules) {
+      selectedModuleCodes = options.modules.split(',').map((m) => m.trim());
+    } else if (options.yes) {
+      selectedModuleCodes = allModules.filter((m) => m.default_selected).map((m) => m.code);
+    } else {
+      const result = await multiselect({
+        message: 'Which modules do you want to install?',
+        options: allModules.map((m) => ({
+          value: m.code,
+          label: m.name,
+          hint: m.description,
+        })),
+        initialValues: allModules.filter((m) => m.default_selected).map((m) => m.code),
+        required: true,
+      });
+      if (typeof result === 'symbol') return { cancelled: true };
+      selectedModuleCodes = result;
+    }
+
+    // ── 5. IDE selection ─────────────────────────────────────────────────────
+    const platforms = this.loadPlatforms();
+    const platformEntries = Object.entries(platforms).filter(
+      ([, p]) => p.installer && !p.suspended
+    );
+
+    // Sort: preferred first, then alphabetical
+    platformEntries.sort(([, a], [, b]) => {
+      if (a.preferred && !b.preferred) return -1;
+      if (!a.preferred && b.preferred) return 1;
+      return a.name.localeCompare(b.name);
+    });
+
+    let selectedIdeCodes;
+
+    if (options.ides) {
+      selectedIdeCodes = options.ides.split(',').map((i) => i.trim());
+    } else if (options.yes) {
+      selectedIdeCodes = platformEntries.filter(([, p]) => p.preferred).map(([code]) => code);
+    } else {
+      const result = await multiselect({
+        message: 'Which AI tools/IDEs do you want to configure?',
+        options: platformEntries.map(([code, p]) => ({
+          value: code,
+          label: p.preferred ? `${p.name} ★` : p.name,
+          hint: p.description,
+        })),
+        initialValues: platformEntries.filter(([, p]) => p.preferred).map(([code]) => code),
+        required: true,
+      });
+      if (typeof result === 'symbol') return { cancelled: true };
+      selectedIdeCodes = result;
+    }
+
+    // ── 6. Confirm ───────────────────────────────────────────────────────────
+    const selectedModuleNames = selectedModuleCodes
+      .map((code) => allModules.find((m) => m.code === code)?.name || code)
+      .join(', ');
+    const selectedIdeNames = selectedIdeCodes
+      .map(([code, p]) => platforms[code]?.name || code)
+      .join(', ') || selectedIdeCodes.map((code) => platforms[code]?.name || code).join(', ');
+
+    if (!options.yes) {
+      log.info(`Scope:   ${scope === 'global' ? 'global (~/.{ide}/skills)' : `project (${targetDir})`}`);
+      log.info(`Modules: ${selectedModuleNames}`);
+      log.info(`IDEs:    ${selectedIdeNames}`);
+
+      const ok = await confirm({ message: 'Proceed with installation?' });
+      if (typeof ok === 'symbol' || !ok) return { cancelled: true };
+    }
+
+    return {
+      cancelled: false,
+      targetDir,
+      scope,
+      modules: selectedModuleCodes,
+      ides: selectedIdeCodes,
+      isReinstall,
+    };
+  }
+}
+
+module.exports = { UI };

package/tools/cli/lib/welcome.js

@@ -0,0 +1,82 @@
+'use strict';
+
+const chalk = require('chalk');
+const packageJson = require('../../../package.json');
+
+// ─── ASCII art logo ───────────────────────────────────────────────────────────
+const LOGO = `
+ █████╗ ██╗   ██╗████████╗ ██████╗ ██████╗  ██████╗  ██████╗
+██╔══██╗██║   ██║╚══██╔══╝██╔═══██╗██╔══██╗██╔═══██╗██╔════╝
+███████║██║   ██║   ██║   ██║   ██║██║  ██║██║   ██║██║
+██╔══██║██║   ██║   ██║   ██║   ██║██║  ██║██║   ██║██║
+██║  ██║╚██████╔╝   ██║   ╚██████╔╝██████╔╝╚██████╔╝╚██████╗
+╚═╝  ╚═╝ ╚═════╝    ╚═╝    ╚═════╝ ╚═════╝  ╚═════╝  ╚═════╝
+`;
+
+const TAGLINE = 'Your AI Dev Team, Installed in Seconds';
+
+const TERMINAL_WIDTH = process.stdout.columns || 80;
+const SEPARATOR = chalk.dim('─'.repeat(TERMINAL_WIDTH));
+
+// ─── Welcome message ──────────────────────────────────────────────────────────
+function printWelcome() {
+  const gold = chalk.hex('#ef0b45');
+  const cyan = chalk.cyan;
+  const dim = chalk.dim;
+  const bold = chalk.bold;
+
+  // Top border with version embedded in top-left (BMAD-style)
+  const version = `v${packageJson.version}`;
+  const topBorder = version + '─'.repeat(Math.max(0, TERMINAL_WIDTH - version.length));
+  console.log(cyan(topBorder));
+  console.log();
+
+  // Logo (centered as a block — all lines use the same left-pad based on widest line)
+  const logoLines = LOGO.split('\n').filter((l) => l.trim() !== '');
+  const maxLogoWidth = Math.max(...logoLines.map((l) => l.length));
+  const logoPad = Math.max(0, Math.floor((TERMINAL_WIDTH - maxLogoWidth) / 2));
+  console.log();
+  for (const line of logoLines) {
+    console.log(gold(' '.repeat(logoPad) + line));
+  }
+  console.log();
+
+  // Tagline (centered, gold italic)
+  const tagPad = Math.max(0, Math.floor((TERMINAL_WIDTH - TAGLINE.length) / 2));
+  console.log(gold.italic(' '.repeat(tagPad) + TAGLINE));
+  console.log();
+
+  // Bottom border
+  console.log(cyan('─'.repeat(TERMINAL_WIDTH)));
+  console.log();
+
+  // Welcome section
+  console.log(bold('🚀  Welcome to autodoc-agent-kit!'));
+  console.log();
+  console.log('    Install a complete AI dev team into any project — skills for Product,');
+  console.log('    Engineering, QA, Design, and DevOps across 14 AI IDEs and CLIs.');
+  console.log();
+  console.log(`    ${dim('─')} Select the modules that match your team\'s needs`);
+  console.log(`    ${dim('─')} Works with Claude Code, Cursor, Gemini CLI, Windsurf, and more`);
+  console.log(`    ${dim('─')} Skills install once and work in all your projects`);
+  console.log(`    ${dim('─')} Documentation: ${chalk.cyan('https://github.com/autodocdev/autodoc-agent-kit')}`);
+  console.log();
+
+  // Open source section
+  console.log(bold('⭐  Free & Open Source'));
+  console.log(`    ${dim('─')} MIT licensed — use it, fork it, extend it`);
+  console.log(`    ${dim('─')} Add your own skills to any module`);
+  console.log(`    ${dim('─')} Contributions welcome`);
+  console.log();
+
+  // Help grow section
+  console.log(bold('🙌  Help us grow'));
+  console.log(`    ${dim('─')} Star on GitHub: ${chalk.cyan('https://github.com/autodocdev/autodoc-agent-kit')}`);
+  console.log(`    ${dim('─')} Share with your team`);
+  console.log(`    ${dim('─')} Open issues and PRs — all feedback welcome`);
+  console.log();
+  console.log(SEPARATOR);
+  console.log();
+}
+
+module.exports = { printWelcome };