@ecc-hgy/ae 0.5.0 → 0.6.0

package/src/commands/setup.js

@@ -1,162 +1,162 @@
-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('/');
-}
+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

@@ -1,132 +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;
-  }
-}
+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;
+  }
+}