@ecc-hgy/ae 0.4.0 → 0.6.0

package/src/commands/setup.js

@@ -1,103 +1,162 @@
-import { mkdir, stat } from 'node:fs/promises';
-import path from 'node:path';
-import { copyTreeIdempotent } from '../utils/copy.js';
-import { skillsPath } from '../utils/paths.js';
-import { formatSetupReport } from '../utils/report.js';
-
-const HELP = `Usage: ae setup [options]
-
-Options:
-  --target <path>  Install AE assets into this project directory. Defaults to cwd.
-  --dry-run        Show what would be installed without writing files.
-  -h, --help       Show help`;
-
-export async function run(argv = []) {
-  const options = parseArgs(argv);
-
-  if (options.help) {
-    console.log(HELP);
-    return 0;
-  }
-
-  const target = path.resolve(options.target ?? process.cwd());
-
-  try {
-    await ensureTargetDirectory(target, options.dryRun);
-
-    const created = [];
-    const skipped = [];
-    const skillGroups = [
-      {
-        dest: path.join(target, '.claude', 'skills'),
-        prefix: path.join('.claude', 'skills'),
-      },
-      {
-        dest: path.join(target, '.codex', 'skills'),
-        prefix: path.join('.codex', 'skills'),
-      },
-    ];
-
-    for (const group of skillGroups) {
-      const result = await copyTreeIdempotent(skillsPath(), group.dest, {
-        dryRun: options.dryRun,
-      });
-      created.push(...result.created.map((item) => toDisplayPath(path.join(group.prefix, item))));
-      skipped.push(...result.skipped.map((item) => toDisplayPath(path.join(group.prefix, item))));
-    }
-
-    console.log(formatSetupReport({ created, skipped, target, dryRun: options.dryRun }));
-    return 0;
-  } catch (error) {
-    console.error(`AE setup failed: ${error instanceof Error ? error.message : String(error)}`);
-    process.exitCode = 1;
-    return 1;
-  }
-}
-
-function parseArgs(argv) {
-  const options = {
-    target: undefined,
-    dryRun: false,
-    help: false,
-  };
-
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (arg === '--help' || arg === '-h') {
-      options.help = true;
-    } else if (arg === '--dry-run') {
-      options.dryRun = true;
-    } else if (arg === '--target') {
-      const value = argv[index + 1];
-      if (!value) {
-        throw new Error('--target requires a path');
-      }
-      options.target = value;
-      index += 1;
-    } else {
-      throw new Error(`Unknown option for setup: ${arg}`);
-    }
-  }
-
-  return options;
-}
-
-async function ensureTargetDirectory(target, dryRun) {
-  try {
-    const current = await stat(target);
-    if (!current.isDirectory()) {
-      throw new Error(`target exists but is not a directory: ${target}`);
-    }
-  } catch (error) {
-    if (error?.code !== 'ENOENT') {
-      throw error;
-    }
-    if (!dryRun) {
-      await mkdir(target, { recursive: true });
-    }
-  }
-}
-
-function toDisplayPath(value) {
-  return value.split(path.sep).join('/');
-}
+import { mkdir, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { createInterface } from 'node:readline/promises';
+import { copyTreeIdempotent } from '../utils/copy.js';
+import { skillsPath } from '../utils/paths.js';
+import { formatSetupReport } from '../utils/report.js';
+import {
+  PLATFORMS,
+  detectPlatforms,
+  getPlatformSkillsDir,
+  listPlatformIds,
+  parsePlatformList,
+  resolvePlatforms,
+} from '../platforms.js';
+
+const HELP = `Usage: ae setup [options]
+
+Options:
+  --target <path>  Install AE assets into this project directory. Defaults to cwd.
+  --platform <ids> Install for comma-separated platforms, e.g. claude,codex,cursor.
+  --dry-run        Show what would be installed without writing files.
+  -h, --help       Show help
+
+Platforms:
+  ${listPlatformIds().join(', ')}`;
+
+export async function run(argv = []) {
+  const options = parseArgs(argv);
+
+  if (options.help) {
+    console.log(HELP);
+    return 0;
+  }
+
+  const target = path.resolve(options.target ?? process.cwd());
+
+  try {
+    const explicitPlatforms =
+      options.platformIds.length > 0 ? resolvePlatforms(options.platformIds) : undefined;
+    await ensureTargetDirectory(target, options.dryRun);
+    const selectedPlatforms = explicitPlatforms ?? (await selectPlatforms(target));
+
+    const created = [];
+    const skipped = [];
+    const skillGroups = selectedPlatforms.map((platform) => {
+      const skillsDir = getPlatformSkillsDir(platform);
+      return {
+        dest: path.join(target, skillsDir),
+        prefix: skillsDir,
+      };
+    });
+
+    for (const group of skillGroups) {
+      const result = await copyTreeIdempotent(skillsPath(), group.dest, {
+        dryRun: options.dryRun,
+      });
+      created.push(...result.created.map((item) => toDisplayPath(path.join(group.prefix, item))));
+      skipped.push(...result.skipped.map((item) => toDisplayPath(path.join(group.prefix, item))));
+    }
+
+    console.log(formatSetupReport({ created, skipped, target, dryRun: options.dryRun }));
+    return 0;
+  } catch (error) {
+    console.error(`AE setup failed: ${error instanceof Error ? error.message : String(error)}`);
+    process.exitCode = 1;
+    return 1;
+  }
+}
+
+function parseArgs(argv) {
+  const options = {
+    target: undefined,
+    platformIds: [],
+    dryRun: false,
+    help: false,
+  };
+
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    if (arg === '--help' || arg === '-h') {
+      options.help = true;
+    } else if (arg === '--dry-run') {
+      options.dryRun = true;
+    } else if (arg === '--platform') {
+      const value = argv[index + 1];
+      if (!value) {
+        throw new Error('--platform requires a comma-separated platform list');
+      }
+      options.platformIds.push(...parsePlatformList(value));
+      index += 1;
+    } else if (arg === '--target') {
+      const value = argv[index + 1];
+      if (!value) {
+        throw new Error('--target requires a path');
+      }
+      options.target = value;
+      index += 1;
+    } else {
+      throw new Error(`Unknown option for setup: ${arg}`);
+    }
+  }
+
+  return options;
+}
+
+async function selectPlatforms(target) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    throw new Error(
+      `No platforms selected. In non-interactive mode, pass --platform <ids>. Available: ${listPlatformIds().join(', ')}`,
+    );
+  }
+
+  const detected = await detectPlatforms(target);
+  const detectedIds = detected.map((platform) => platform.id);
+  const defaultIds = detectedIds;
+
+  console.log('Select target platforms for AE skills:');
+  for (const [index, platform] of PLATFORMS.entries()) {
+    const marker = defaultIds.includes(platform.id) ? '*' : ' ';
+    console.log(`  ${index + 1}. [${marker}] ${platform.name} (${platform.id}) -> ${getPlatformSkillsDir(platform)}/`);
+  }
+
+  const defaultPrompt = defaultIds.length > 0 ? ` [${defaultIds.join(',')}]` : '';
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await rl.question(`Platform ids or numbers, comma-separated${defaultPrompt}: `);
+    const selected = answer.trim() ? parseInteractivePlatformAnswer(answer) : defaultIds;
+    return resolvePlatforms(selected);
+  } finally {
+    rl.close();
+  }
+}
+
+function parseInteractivePlatformAnswer(answer) {
+  return parsePlatformList(answer).map((item) => {
+    const number = Number(item);
+    if (Number.isInteger(number) && number >= 1 && number <= PLATFORMS.length) {
+      return PLATFORMS[number - 1].id;
+    }
+    return item;
+  });
+}
+
+async function ensureTargetDirectory(target, dryRun) {
+  try {
+    const current = await stat(target);
+    if (!current.isDirectory()) {
+      throw new Error(`target exists but is not a directory: ${target}`);
+    }
+  } catch (error) {
+    if (error?.code !== 'ENOENT') {
+      throw error;
+    }
+    if (!dryRun) {
+      await mkdir(target, { recursive: true });
+    }
+  }
+}
+
+function toDisplayPath(value) {
+  return value.split(path.sep).join('/');
+}

package/src/platforms.js

@@ -0,0 +1,132 @@
+import { stat } from 'node:fs/promises';
+import path from 'node:path';
+
+export const PLATFORMS = [
+  { id: 'claude', name: 'Claude Code', skillsDir: '.claude', aliases: ['claude-code'] },
+  { id: 'codex', name: 'Codex', skillsDir: '.codex' },
+  { id: 'windsurf', name: 'Windsurf', skillsDir: '.windsurf' },
+  {
+    id: 'github-copilot',
+    name: 'GitHub Copilot',
+    skillsDir: '.github',
+    aliases: ['copilot', 'github'],
+    detectionPaths: [
+      '.github/copilot-instructions.md',
+      '.github/instructions',
+      '.github/prompts',
+      '.github/skills',
+    ],
+  },
+  { id: 'kilocode', name: 'Kilo Code', skillsDir: '.kilocode', aliases: ['kilo-code'] },
+  { id: 'kimicode', name: 'Kimi Code', skillsDir: '.kimi-code', aliases: ['kimi', 'kimi-code'] },
+  { id: 'codebuddy', name: 'CodeBuddy', skillsDir: '.codebuddy', aliases: ['codebuddy-code'] },
+  { id: 'qoder', name: 'Qoder', skillsDir: '.qoder' },
+  { id: 'trae', name: 'Trae', skillsDir: '.trae' },
+  { id: 'cursor', name: 'Cursor', skillsDir: '.cursor' },
+  { id: 'opencode', name: 'OpenCode', skillsDir: '.opencode', aliases: ['open-code'] },
+  { id: 'antigravity', name: 'Antigravity', skillsDir: '.agents' },
+  { id: 'gemini', name: 'Gemini CLI', skillsDir: '.gemini', aliases: ['gemini-cli'] },
+  { id: 'qwen', name: 'Qwen Code', skillsDir: '.qwen', aliases: ['qwen-code'] },
+  { id: 'kiro', name: 'Kiro', skillsDir: '.kiro' },
+];
+
+const PLATFORM_BY_ID_OR_ALIAS = new Map(
+  PLATFORMS.flatMap((platform) => [
+    [platform.id, platform],
+    ...(platform.aliases ?? []).map((alias) => [alias, platform]),
+  ]),
+);
+
+export function listPlatformIds() {
+  return PLATFORMS.map((platform) => platform.id);
+}
+
+export function resolvePlatforms(ids) {
+  const resolved = [];
+  const seen = new Set();
+  const unknown = [];
+
+  for (const rawId of ids) {
+    const id = rawId.trim().toLowerCase();
+    if (!id) {
+      continue;
+    }
+
+    const platform = PLATFORM_BY_ID_OR_ALIAS.get(id);
+    if (!platform) {
+      unknown.push(rawId);
+      continue;
+    }
+
+    if (!seen.has(platform.id)) {
+      resolved.push(platform);
+      seen.add(platform.id);
+    }
+  }
+
+  if (unknown.length > 0) {
+    throw new Error(`Unknown platform(s): ${unknown.join(', ')}. Available: ${listPlatformIds().join(', ')}`);
+  }
+
+  if (resolved.length === 0) {
+    throw new Error(`No platforms selected. Available: ${listPlatformIds().join(', ')}`);
+  }
+
+  return resolved;
+}
+
+export function parsePlatformList(value) {
+  return value
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean);
+}
+
+export function getPlatformSkillsDir(platform) {
+  return path.join(platform.skillsDir, 'skills');
+}
+
+export async function detectPlatforms(target) {
+  const detected = [];
+
+  for (const platform of PLATFORMS) {
+    if (platform.detectionPaths?.length > 0) {
+      for (const detectionPath of platform.detectionPaths) {
+        if (await pathExists(path.join(target, detectionPath))) {
+          detected.push(platform);
+          break;
+        }
+      }
+      continue;
+    }
+
+    if (await isDirectory(path.join(target, platform.skillsDir))) {
+      detected.push(platform);
+    }
+  }
+
+  return detected;
+}
+
+async function pathExists(value) {
+  try {
+    await stat(value);
+    return true;
+  } catch (error) {
+    if (error?.code === 'ENOENT') {
+      return false;
+    }
+    throw error;
+  }
+}
+
+async function isDirectory(value) {
+  try {
+    return (await stat(value)).isDirectory();
+  } catch (error) {
+    if (error?.code === 'ENOENT') {
+      return false;
+    }
+    throw error;
+  }
+}

package/src/skeleton.js

@@ -1,129 +1,164 @@
-import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
-import path from 'node:path';
-
-const DEFAULT_DRY_RUN = false;
-
-const SKELETON_DIRS = [
+import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+
+const DEFAULT_DRY_RUN = false;
+
+const CORE_DIRS = [
   'spec',
   path.join('spec', 'needs'),
   path.join('spec', 'ADR'),
-  'reference',
+  'docs',
   'data',
-  'scripts',
 ];
 
-const GITKEEP_DIRS = [
+const CORE_GITKEEP_DIRS = [
   path.join('spec', 'needs'),
   path.join('spec', 'ADR'),
-  'reference',
+  'docs',
   'data',
-  'scripts',
-];
-
-const ENTRY_FILES = [
-  'README.md',
-  'AGENTS.md',
-  'CLAUDE.md',
-  'handoff.md',
-  path.join('spec', 'README.md'),
-  path.join('spec', 'INDEX.md'),
-  path.join('spec', 'AGENTS.md'),
-  path.join('spec', 'CLAUDE.md'),
-  path.join('spec', 'ADR', 'AGENTS.md'),
-  path.join('spec', 'ADR', 'CLAUDE.md'),
 ];
 
+const ALTERNATE_SOURCE_ROOTS = ['app', 'apps', 'lib', 'packages'];
+const ALTERNATE_TEST_ROOTS = ['test', '__tests__'];
+
+const ENTRY_FILES = [
+  'README.md',
+  'AGENTS.md',
+  'CLAUDE.md',
+  'handoff.md',
+  path.join('spec', 'README.md'),
+  path.join('spec', 'INDEX.md'),
+  path.join('spec', 'AGENTS.md'),
+  path.join('spec', 'CLAUDE.md'),
+  path.join('spec', 'ADR', 'AGENTS.md'),
+  path.join('spec', 'ADR', 'CLAUDE.md'),
+];
+
 export async function createDirectories(target, options = {}) {
   const dryRun = Boolean(options.dryRun ?? DEFAULT_DRY_RUN);
   const created = [];
   const skipped = [];
   const updated = [];
+  const skeletonDirs = [...CORE_DIRS];
+  const gitkeepDirs = [...CORE_GITKEEP_DIRS];
 
-  for (const dir of SKELETON_DIRS) {
-    const absolute = path.join(target, dir);
-    const display = `${normalizeRelative(dir)}/`;
-
-    if (await exists(absolute)) {
-      const current = await stat(absolute);
-      if (!current.isDirectory()) {
-        throw new Error(`expected directory but found file: ${absolute}`);
-      }
-      skipped.push(display);
-    } else {
-      created.push(display);
-      if (!dryRun) {
-        await mkdir(absolute, { recursive: true });
-      }
-    }
+  if (await shouldIncludeDefaultRoot(target, 'src', ALTERNATE_SOURCE_ROOTS)) {
+    skeletonDirs.push('src');
+    gitkeepDirs.push('src');
   }
 
-  for (const dir of GITKEEP_DIRS) {
-    const file = path.join(target, dir, '.gitkeep');
-    const display = normalizeRelative(path.join(dir, '.gitkeep'));
-
-    if (await exists(file)) {
-      skipped.push(display);
-    } else {
-      created.push(display);
-      if (!dryRun) {
-        await mkdir(path.dirname(file), { recursive: true });
-        await writeFile(file, '');
-      }
-    }
+  if (await shouldIncludeDefaultRoot(target, 'tests', ALTERNATE_TEST_ROOTS)) {
+    skeletonDirs.push('tests');
+    gitkeepDirs.push('tests');
   }
 
-  return { created, skipped, updated };
+  for (const dir of skeletonDirs) {
+    const absolute = path.join(target, dir);
+    const display = `${normalizeRelative(dir)}/`;
+
+    if (await exists(absolute)) {
+      const current = await stat(absolute);
+      if (!current.isDirectory()) {
+        throw new Error(`expected directory but found file: ${absolute}`);
+      }
+      skipped.push(display);
+    } else {
+      created.push(display);
+      if (!dryRun) {
+        await mkdir(absolute, { recursive: true });
+      }
+    }
+  }
+
+  for (const dir of gitkeepDirs) {
+    const file = path.join(target, dir, '.gitkeep');
+    const display = normalizeRelative(path.join(dir, '.gitkeep'));
+
+    if (await exists(file)) {
+      skipped.push(display);
+    } else {
+      created.push(display);
+      if (!dryRun) {
+        await mkdir(path.dirname(file), { recursive: true });
+        await writeFile(file, '');
+      }
+    }
+  }
+
+  return { created, skipped, updated };
+}
+
+export async function renderEntryFiles(target, templateRoot, options = {}) {
+  const dryRun = Boolean(options.dryRun ?? DEFAULT_DRY_RUN);
+  const projectName = options.projectName ?? path.basename(target);
+  const projectGoal = options.projectGoal ?? 'TODO: 用一句话说明这个项目要解决什么问题。';
+  const created = [];
+  const skipped = [];
+  const updated = [];
+
+  for (const file of ENTRY_FILES) {
+    const source = path.join(templateRoot, file);
+    const dest = path.join(target, file);
+    const display = normalizeRelative(file);
+
+    if (await exists(dest)) {
+      skipped.push(display);
+      continue;
+    }
+
+    const template = await readFile(source, 'utf8');
+    const rendered = renderTemplate(template, { projectName, projectGoal });
+    created.push(display);
+
+    if (!dryRun) {
+      await mkdir(path.dirname(dest), { recursive: true });
+      await writeFile(dest, rendered);
+    }
+  }
+
+  return { created, skipped, updated };
+}
+
+function renderTemplate(template, replacements) {
+  return template
+    .replaceAll('{{PROJECT_NAME}}', replacements.projectName)
+    .replaceAll('{{PROJECT_GOAL}}', replacements.projectGoal);
+}
+
+async function exists(value) {
+  try {
+    await stat(value);
+    return true;
+  } catch (error) {
+    if (error?.code === 'ENOENT') {
+      return false;
+    }
+    throw error;
+  }
 }
 
-export async function renderEntryFiles(target, templateRoot, options = {}) {
-  const dryRun = Boolean(options.dryRun ?? DEFAULT_DRY_RUN);
-  const projectName = options.projectName ?? path.basename(target);
-  const projectGoal = options.projectGoal ?? 'TODO: 用一句话说明这个项目要解决什么问题。';
-  const created = [];
-  const skipped = [];
-  const updated = [];
-
-  for (const file of ENTRY_FILES) {
-    const source = path.join(templateRoot, file);
-    const dest = path.join(target, file);
-    const display = normalizeRelative(file);
-
-    if (await exists(dest)) {
-      skipped.push(display);
-      continue;
-    }
-
-    const template = await readFile(source, 'utf8');
-    const rendered = renderTemplate(template, { projectName, projectGoal });
-    created.push(display);
-
-    if (!dryRun) {
-      await mkdir(path.dirname(dest), { recursive: true });
-      await writeFile(dest, rendered);
+async function hasDirectory(target, candidates) {
+  for (const candidate of candidates) {
+    try {
+      if ((await stat(path.join(target, candidate))).isDirectory()) {
+        return true;
+      }
+    } catch (error) {
+      if (error?.code !== 'ENOENT') {
+        throw error;
+      }
     }
   }
-
-  return { created, skipped, updated };
-}
-
-function renderTemplate(template, replacements) {
-  return template
-    .replaceAll('{{PROJECT_NAME}}', replacements.projectName)
-    .replaceAll('{{PROJECT_GOAL}}', replacements.projectGoal);
+  return false;
 }
 
-async function exists(value) {
-  try {
-    await stat(value);
+async function shouldIncludeDefaultRoot(target, defaultRoot, alternatives) {
+  if (await exists(path.join(target, defaultRoot))) {
     return true;
-  } catch (error) {
-    if (error?.code === 'ENOENT') {
-      return false;
-    }
-    throw error;
   }
+  return !(await hasDirectory(target, alternatives));
 }
-
-function normalizeRelative(value) {
-  return value.split(path.sep).join('/');
-}
+
+function normalizeRelative(value) {
+  return value.split(path.sep).join('/');
+}