atomism 0.1.0

package/dist/chunk-RS2IEGW3.js

@@ -0,0 +1,10 @@
+// src/utils/paths.ts
+import { isAbsolute, resolve } from "path";
+function resolveAtomPath(path, baseDir) {
+  return isAbsolute(path) ? path : resolve(baseDir, path);
+}
+
+export {
+  resolveAtomPath
+};
+//# sourceMappingURL=chunk-RS2IEGW3.js.map

package/dist/chunk-RS2IEGW3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/paths.ts"],"sourcesContent":["import { isAbsolute, resolve } from 'node:path';\n\n/**\n * Resolve a potentially relative path against a base directory.\n *\n * If the path is already absolute it is returned as-is; otherwise it is\n * resolved relative to `baseDir`.\n */\nexport function resolveAtomPath(path: string, baseDir: string): string {\n  return isAbsolute(path) ? path : resolve(baseDir, path);\n}\n"],"mappings":";AAAA,SAAS,YAAY,eAAe;AAQ7B,SAAS,gBAAgB,MAAc,SAAyB;AACrE,SAAO,WAAW,IAAI,IAAI,OAAO,QAAQ,SAAS,IAAI;AACxD;","names":[]}

package/dist/chunk-S6Z5G5DB.js

@@ -0,0 +1,84 @@
+// src/cli/format.ts
+var codes = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  magenta: "\x1B[35m",
+  cyan: "\x1B[36m",
+  gray: "\x1B[90m"
+};
+var useColors = process.stdout.isTTY && !process.env["NO_COLOR"] && process.env["TERM"] !== "dumb";
+function colorize(code, text) {
+  if (!useColors) return text;
+  return `${codes[code]}${text}${codes.reset}`;
+}
+var fmt = {
+  // Colors
+  red: (text) => colorize("red", text),
+  green: (text) => colorize("green", text),
+  yellow: (text) => colorize("yellow", text),
+  blue: (text) => colorize("blue", text),
+  magenta: (text) => colorize("magenta", text),
+  cyan: (text) => colorize("cyan", text),
+  gray: (text) => colorize("gray", text),
+  // Styles
+  bold: (text) => colorize("bold", text),
+  dim: (text) => colorize("dim", text),
+  // Semantic helpers
+  success: (text) => colorize("green", text),
+  error: (text) => colorize("red", text),
+  warning: (text) => colorize("yellow", text),
+  info: (text) => colorize("blue", text),
+  hint: (text) => colorize("cyan", text),
+  // Error type colors
+  errorType: (type) => {
+    switch (type) {
+      case "validation":
+        return colorize("yellow", type);
+      case "execution":
+        return colorize("red", type);
+      case "dependency":
+        return colorize("magenta", type);
+      case "timeout":
+        return colorize("cyan", type);
+      default:
+        return colorize("red", type);
+    }
+  }
+};
+function formatAtomError(error) {
+  const lines = [];
+  lines.push(`${fmt.error("Error")} ${fmt.gray("[")}${fmt.errorType(error.type)}${fmt.gray("]")}`);
+  lines.push(`  ${error.message}`);
+  if (error.suggestion) {
+    lines.push(`  ${fmt.hint("Suggestion:")} ${error.suggestion}`);
+  }
+  lines.push(
+    `  ${fmt.gray("Recoverable:")} ${error.recoverable ? fmt.green("yes") : fmt.red("no")}`
+  );
+  if (error.context && Object.keys(error.context).length > 0) {
+    lines.push(`  ${fmt.gray("Context:")}`);
+    for (const [key, value] of Object.entries(error.context)) {
+      lines.push(`    ${fmt.dim(key)}: ${JSON.stringify(value)}`);
+    }
+  }
+  return lines.join("\n");
+}
+function formatSuccess(atomName, duration) {
+  return `${fmt.success("\u2713")} ${fmt.bold(atomName)} ${fmt.gray(`completed in ${duration}ms`)}`;
+}
+function formatFailure(atomName) {
+  return `${fmt.error("\u2717")} ${fmt.bold(atomName)} ${fmt.gray("failed")}`;
+}
+
+export {
+  fmt,
+  formatAtomError,
+  formatSuccess,
+  formatFailure
+};
+//# sourceMappingURL=chunk-S6Z5G5DB.js.map

package/dist/chunk-S6Z5G5DB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/format.ts"],"sourcesContent":["/**\n * Terminal formatting utilities for CLI output\n */\n\n// ANSI escape codes for colors\nconst codes = {\n  reset: '\\x1b[0m',\n  bold: '\\x1b[1m',\n  dim: '\\x1b[2m',\n  red: '\\x1b[31m',\n  green: '\\x1b[32m',\n  yellow: '\\x1b[33m',\n  blue: '\\x1b[34m',\n  magenta: '\\x1b[35m',\n  cyan: '\\x1b[36m',\n  gray: '\\x1b[90m',\n};\n\n// Check if colors should be used (has TTY, respects NO_COLOR standard, excludes dumb terminals)\nconst useColors =\n  process.stdout.isTTY &&\n  !process.env['NO_COLOR'] &&\n  process.env['TERM'] !== 'dumb';\n\nfunction colorize(code: keyof typeof codes, text: string): string {\n  if (!useColors) return text;\n  return `${codes[code]}${text}${codes.reset}`;\n}\n\nexport const fmt = {\n  // Colors\n  red: (text: string) => colorize('red', text),\n  green: (text: string) => colorize('green', text),\n  yellow: (text: string) => colorize('yellow', text),\n  blue: (text: string) => colorize('blue', text),\n  magenta: (text: string) => colorize('magenta', text),\n  cyan: (text: string) => colorize('cyan', text),\n  gray: (text: string) => colorize('gray', text),\n\n  // Styles\n  bold: (text: string) => colorize('bold', text),\n  dim: (text: string) => colorize('dim', text),\n\n  // Semantic helpers\n  success: (text: string) => colorize('green', text),\n  error: (text: string) => colorize('red', text),\n  warning: (text: string) => colorize('yellow', text),\n  info: (text: string) => colorize('blue', text),\n  hint: (text: string) => colorize('cyan', text),\n\n  // Error type colors\n  errorType: (type: string): string => {\n    switch (type) {\n      case 'validation':\n        return colorize('yellow', type);\n      case 'execution':\n        return colorize('red', type);\n      case 'dependency':\n        return colorize('magenta', type);\n      case 'timeout':\n        return colorize('cyan', type);\n      default:\n        return colorize('red', type);\n    }\n  },\n};\n\n/**\n * Format an AtomError for CLI display\n */\nexport function formatAtomError(error: {\n  type: string;\n  message: string;\n  recoverable: boolean;\n  suggestion?: string;\n  context?: Record<string, unknown>;\n}): string {\n  const lines: string[] = [];\n\n  lines.push(`${fmt.error('Error')} ${fmt.gray('[')}${fmt.errorType(error.type)}${fmt.gray(']')}`);\n  lines.push(`  ${error.message}`);\n\n  if (error.suggestion) {\n    lines.push(`  ${fmt.hint('Suggestion:')} ${error.suggestion}`);\n  }\n\n  lines.push(\n    `  ${fmt.gray('Recoverable:')} ${error.recoverable ? fmt.green('yes') : fmt.red('no')}`\n  );\n\n  if (error.context && Object.keys(error.context).length > 0) {\n    lines.push(`  ${fmt.gray('Context:')}`);\n    for (const [key, value] of Object.entries(error.context)) {\n      lines.push(`    ${fmt.dim(key)}: ${JSON.stringify(value)}`);\n    }\n  }\n\n  return lines.join('\\n');\n}\n\n/**\n * Format a success message\n */\nexport function formatSuccess(atomName: string, duration: number): string {\n  return `${fmt.success('✓')} ${fmt.bold(atomName)} ${fmt.gray(`completed in ${duration}ms`)}`;\n}\n\n/**\n * Format a failure message\n */\nexport function formatFailure(atomName: string): string {\n  return `${fmt.error('✗')} ${fmt.bold(atomName)} ${fmt.gray('failed')}`;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-UVUDQ4XP.js

@@ -0,0 +1,259 @@
+import {
+  fmt
+} from "./chunk-S6Z5G5DB.js";
+import {
+  toErrorMessage
+} from "./chunk-PLQJM2KT.js";
+
+// src/commands/skills-scan.ts
+import { readdir, readFile, stat, realpath } from "fs/promises";
+import { join, basename } from "path";
+import { homedir } from "os";
+import { z } from "zod";
+var MCPSkillSchema = z.object({
+  name: z.string().optional(),
+  description: z.string().optional()
+});
+var MCPServerSchema = z.object({
+  skills: z.array(MCPSkillSchema).optional()
+});
+var MCPConfigSchema = z.object({
+  mcpServers: z.record(z.string(), MCPServerSchema).optional()
+});
+function parseFrontmatter(content) {
+  const normalized = content.replace(/\r\n/g, "\n");
+  const frontmatterMatch = normalized.match(/^---\n([\s\S]*?)\n---/);
+  if (!frontmatterMatch || !frontmatterMatch[1]) {
+    return {};
+  }
+  const frontmatter = frontmatterMatch[1];
+  const result = {};
+  const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
+  if (nameMatch && nameMatch[1]) {
+    result.name = nameMatch[1].trim();
+  }
+  const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
+  if (descMatch && descMatch[1]) {
+    result.description = descMatch[1].trim();
+  }
+  return result;
+}
+function truncateDescription(description, maxLength = 80) {
+  if (description.length <= maxLength) {
+    return description;
+  }
+  return description.substring(0, maxLength - 3) + "...";
+}
+async function scanSkillEntry(entryPath, source) {
+  try {
+    const stats = await stat(entryPath);
+    let skillPath = entryPath;
+    let resolvedPath;
+    try {
+      const realPath = await realpath(entryPath);
+      if (realPath !== entryPath) {
+        resolvedPath = realPath;
+      }
+    } catch {
+    }
+    if (stats.isDirectory()) {
+      skillPath = join(entryPath, "SKILL.md");
+      try {
+        await stat(skillPath);
+      } catch {
+        return null;
+      }
+    } else if (!entryPath.endsWith(".md")) {
+      return null;
+    }
+    const content = await readFile(skillPath, "utf-8");
+    const { name, description } = parseFrontmatter(content);
+    if (!name) {
+      const derivedName = basename(entryPath, ".md");
+      return {
+        name: derivedName,
+        description: description || "",
+        location: entryPath,
+        source,
+        resolvedPath
+      };
+    }
+    return {
+      name,
+      description: description || "",
+      location: entryPath,
+      source,
+      resolvedPath
+    };
+  } catch {
+    return null;
+  }
+}
+async function scanSkillsDirectory(dirPath, source) {
+  const skills = [];
+  const errors = [];
+  try {
+    const entries = await readdir(dirPath);
+    for (const entry of entries) {
+      if (entry.startsWith(".")) {
+        continue;
+      }
+      const entryPath = join(dirPath, entry);
+      const skill = await scanSkillEntry(entryPath, source);
+      if (skill) {
+        skills.push(skill);
+      }
+    }
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT") {
+      errors.push(`Failed to scan ${dirPath}: ${toErrorMessage(err)}`);
+    }
+  }
+  return { skills, errors };
+}
+function getProjectSkillsPath() {
+  return join(process.cwd(), ".claude", "skills");
+}
+function getGlobalSkillsPath() {
+  return join(homedir(), ".claude", "skills");
+}
+async function detectMCPSkills() {
+  const skills = [];
+  const errors = [];
+  const mcpConfigPaths = [
+    join(homedir(), ".claude", "mcp.json"),
+    join(homedir(), ".config", "claude", "mcp.json"),
+    join(process.cwd(), ".claude", "mcp.json")
+  ];
+  for (const configPath of mcpConfigPaths) {
+    try {
+      const content = await readFile(configPath, "utf-8");
+      const json = JSON.parse(content);
+      const parseResult = MCPConfigSchema.safeParse(json);
+      if (!parseResult.success) {
+        continue;
+      }
+      const config = parseResult.data;
+      if (config.mcpServers) {
+        const servers = config.mcpServers;
+        for (const serverName of Object.keys(servers)) {
+          const serverConfig = servers[serverName];
+          if (serverConfig?.skills) {
+            for (const skill of serverConfig.skills) {
+              skills.push({
+                name: skill.name || serverName,
+                description: skill.description || "",
+                location: configPath,
+                source: "mcp"
+              });
+            }
+          }
+        }
+      }
+    } catch {
+    }
+  }
+  return { skills, errors };
+}
+async function scanSkills() {
+  const allSkills = [];
+  const allErrors = [];
+  const projectResult = await scanSkillsDirectory(getProjectSkillsPath(), "project");
+  allSkills.push(...projectResult.skills);
+  allErrors.push(...projectResult.errors);
+  const globalResult = await scanSkillsDirectory(getGlobalSkillsPath(), "global");
+  allSkills.push(...globalResult.skills);
+  allErrors.push(...globalResult.errors);
+  const mcpResult = await detectMCPSkills();
+  allSkills.push(...mcpResult.skills);
+  allErrors.push(...mcpResult.errors);
+  allSkills.sort((a, b) => {
+    const sourceOrder = { project: 0, global: 1, mcp: 2 };
+    const sourceDiff = sourceOrder[a.source] - sourceOrder[b.source];
+    if (sourceDiff !== 0) return sourceDiff;
+    return a.name.localeCompare(b.name);
+  });
+  return { skills: allSkills, errors: allErrors };
+}
+async function skillsScanCommand(options) {
+  try {
+    const result = await scanSkills();
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (result.skills.length === 0) {
+      console.log(fmt.bold("Skills Scan"));
+      console.log("\nNo skills found.\n");
+      console.log("Skills can be placed in:");
+      console.log(`  - Project: ${getProjectSkillsPath()}`);
+      console.log(`  - Global:  ${getGlobalSkillsPath()}`);
+      return;
+    }
+    console.log(fmt.bold("Available Skills"));
+    console.log("");
+    const projectSkills = result.skills.filter((s) => s.source === "project");
+    const globalSkills = result.skills.filter((s) => s.source === "global");
+    const mcpSkills = result.skills.filter((s) => s.source === "mcp");
+    if (projectSkills.length > 0) {
+      console.log(fmt.cyan(`Project Skills (${getProjectSkillsPath()})`));
+      for (const skill of projectSkills) {
+        console.log(`  ${fmt.green(skill.name)}`);
+        if (skill.description) {
+          console.log(`    ${fmt.dim(truncateDescription(skill.description))}`);
+        }
+      }
+      console.log("");
+    }
+    if (globalSkills.length > 0) {
+      console.log(fmt.cyan(`Global Skills (${getGlobalSkillsPath()})`));
+      for (const skill of globalSkills) {
+        console.log(`  ${fmt.green(skill.name)}`);
+        if (skill.description) {
+          console.log(`    ${fmt.dim(truncateDescription(skill.description))}`);
+        }
+      }
+      console.log("");
+    }
+    if (mcpSkills.length > 0) {
+      console.log(fmt.cyan("MCP-Provided Skills"));
+      for (const skill of mcpSkills) {
+        console.log(`  ${fmt.green(skill.name)}`);
+        if (skill.description) {
+          console.log(`    ${fmt.dim(truncateDescription(skill.description))}`);
+        }
+      }
+      console.log("");
+    }
+    const count = result.skills.length;
+    console.log(fmt.success(`Found ${count} skill${count === 1 ? "" : "s"}`));
+    if (result.errors.length > 0) {
+      console.log("");
+      for (const err of result.errors) {
+        console.log(fmt.error(`Error: ${err}`));
+      }
+    }
+  } catch (err) {
+    const message = toErrorMessage(err);
+    if (options.json) {
+      console.log(JSON.stringify({ error: message }, null, 2));
+    } else {
+      console.log(fmt.error(`Skills scan failed: ${message}`));
+    }
+    process.exit(1);
+  }
+}
+
+export {
+  parseFrontmatter,
+  truncateDescription,
+  scanSkillEntry,
+  scanSkillsDirectory,
+  getProjectSkillsPath,
+  getGlobalSkillsPath,
+  detectMCPSkills,
+  scanSkills,
+  skillsScanCommand
+};
+//# sourceMappingURL=chunk-UVUDQ4XP.js.map

package/dist/chunk-UVUDQ4XP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/skills-scan.ts"],"sourcesContent":["/**\n * Skills Scanner - Discover available Claude Code skills.\n *\n * Story 6.6: AOP-1257\n *\n * Acceptance Criteria:\n * - Skills listed with: name, description, location\n * - Skills from project .claude/skills/ included\n * - Skills from ~/.claude/skills/ included\n * - MCP-provided skills detected if available\n */\n\nimport { readdir, readFile, stat, realpath } from 'node:fs/promises';\nimport { join, basename } from 'node:path';\nimport { homedir } from 'node:os';\nimport { z } from 'zod';\nimport { fmt } from '../cli/format.js';\nimport { toErrorMessage } from '../utils/errors.js';\n\n/**\n * Skill information extracted from skill files.\n */\nexport interface SkillInfo {\n  name: string;\n  description: string;\n  location: string;\n  source: 'project' | 'global' | 'mcp';\n  /** If the skill is a symlink, this is the resolved path */\n  resolvedPath?: string;\n}\n\n/**\n * Result of skills scan operation.\n */\nexport interface SkillsScanResult {\n  skills: SkillInfo[];\n  errors: string[];\n}\n\n/**\n * Zod schema for MCP skill definition within config.\n */\nconst MCPSkillSchema = z.object({\n  name: z.string().optional(),\n  description: z.string().optional(),\n});\n\n/**\n * Zod schema for MCP server configuration.\n */\nconst MCPServerSchema = z.object({\n  skills: z.array(MCPSkillSchema).optional(),\n});\n\n/**\n * Zod schema for MCP config file.\n */\nconst MCPConfigSchema = z.object({\n  mcpServers: z.record(z.string(), MCPServerSchema).optional(),\n});\n\n/**\n * Parse YAML frontmatter from a markdown file.\n */\nexport function parseFrontmatter(content: string): { name?: string; description?: string } {\n  // Normalize line endings for cross-platform compatibility (Windows CRLF -> LF)\n  const normalized = content.replace(/\\r\\n/g, '\\n');\n  const frontmatterMatch = normalized.match(/^---\\n([\\s\\S]*?)\\n---/);\n  if (!frontmatterMatch || !frontmatterMatch[1]) {\n    return {};\n  }\n\n  const frontmatter = frontmatterMatch[1];\n  const result: { name?: string; description?: string } = {};\n\n  // Parse name\n  const nameMatch = frontmatter.match(/^name:\\s*(.+)$/m);\n  if (nameMatch && nameMatch[1]) {\n    result.name = nameMatch[1].trim();\n  }\n\n  // Parse description (may be multi-line)\n  const descMatch = frontmatter.match(/^description:\\s*(.+)$/m);\n  if (descMatch && descMatch[1]) {\n    result.description = descMatch[1].trim();\n  }\n\n  return result;\n}\n\n/**\n * Truncate a description to fit within a maximum length.\n */\nexport function truncateDescription(description: string, maxLength = 80): string {\n  if (description.length <= maxLength) {\n    return description;\n  }\n  return description.substring(0, maxLength - 3) + '...';\n}\n\n/**\n * Scan a skill file or directory for skill information.\n */\nexport async function scanSkillEntry(\n  entryPath: string,\n  source: 'project' | 'global' | 'mcp'\n): Promise<SkillInfo | null> {\n  try {\n    const stats = await stat(entryPath);\n    let skillPath = entryPath;\n    let resolvedPath: string | undefined;\n\n    // Check if it's a symlink\n    try {\n      const realPath = await realpath(entryPath);\n      if (realPath !== entryPath) {\n        resolvedPath = realPath;\n      }\n    } catch {\n      // Not a symlink or can't resolve\n    }\n\n    if (stats.isDirectory()) {\n      // Look for SKILL.md in the directory\n      skillPath = join(entryPath, 'SKILL.md');\n      try {\n        await stat(skillPath);\n      } catch {\n        // No SKILL.md, skip this directory\n        return null;\n      }\n    } else if (!entryPath.endsWith('.md')) {\n      // Not a markdown file\n      return null;\n    }\n\n    const content = await readFile(skillPath, 'utf-8');\n    const { name, description } = parseFrontmatter(content);\n\n    if (!name) {\n      // No name in frontmatter, derive from path\n      const derivedName = basename(entryPath, '.md');\n      return {\n        name: derivedName,\n        description: description || '',\n        location: entryPath,\n        source,\n        resolvedPath,\n      };\n    }\n\n    return {\n      name,\n      description: description || '',\n      location: entryPath,\n      source,\n      resolvedPath,\n    };\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Scan a directory for skills.\n */\nexport async function scanSkillsDirectory(\n  dirPath: string,\n  source: 'project' | 'global' | 'mcp'\n): Promise<{ skills: SkillInfo[]; errors: string[] }> {\n  const skills: SkillInfo[] = [];\n  const errors: string[] = [];\n\n  try {\n    const entries = await readdir(dirPath);\n\n    for (const entry of entries) {\n      // Skip hidden files and common non-skill entries\n      if (entry.startsWith('.')) {\n        continue;\n      }\n\n      const entryPath = join(dirPath, entry);\n      const skill = await scanSkillEntry(entryPath, source);\n      if (skill) {\n        skills.push(skill);\n      }\n    }\n  } catch (err) {\n    const code = (err as NodeJS.ErrnoException).code;\n    if (code !== 'ENOENT') {\n      errors.push(`Failed to scan ${dirPath}: ${toErrorMessage(err)}`);\n    }\n    // ENOENT is fine - directory doesn't exist\n  }\n\n  return { skills, errors };\n}\n\n/**\n * Get the project skills directory path.\n */\nexport function getProjectSkillsPath(): string {\n  return join(process.cwd(), '.claude', 'skills');\n}\n\n/**\n * Get the global skills directory path.\n */\nexport function getGlobalSkillsPath(): string {\n  return join(homedir(), '.claude', 'skills');\n}\n\n/**\n * Detect MCP-provided skills by checking environment or MCP config.\n *\n * MCP skills are provided by MCP servers and can be detected through:\n * 1. Claude Code's internal skill registry (if accessible)\n * 2. MCP server configuration files\n * 3. Environment variables set by Claude Code\n *\n * This is a best-effort detection since MCP skills are runtime-provided.\n */\nexport async function detectMCPSkills(): Promise<{ skills: SkillInfo[]; errors: string[] }> {\n  const skills: SkillInfo[] = [];\n  const errors: string[] = [];\n\n  // Check for common MCP skill locations\n  const mcpConfigPaths = [\n    join(homedir(), '.claude', 'mcp.json'),\n    join(homedir(), '.config', 'claude', 'mcp.json'),\n    join(process.cwd(), '.claude', 'mcp.json'),\n  ];\n\n  for (const configPath of mcpConfigPaths) {\n    try {\n      const content = await readFile(configPath, 'utf-8');\n      const json = JSON.parse(content) as unknown;\n      const parseResult = MCPConfigSchema.safeParse(json);\n\n      if (!parseResult.success) {\n        // Invalid config structure, skip this file\n        continue;\n      }\n\n      const config = parseResult.data;\n\n      // Look for skill providers in MCP config\n      if (config.mcpServers) {\n        const servers = config.mcpServers;\n        for (const serverName of Object.keys(servers)) {\n          const serverConfig = servers[serverName];\n          if (serverConfig?.skills) {\n            for (const skill of serverConfig.skills) {\n              skills.push({\n                name: skill.name || serverName,\n                description: skill.description || '',\n                location: configPath,\n                source: 'mcp',\n              });\n            }\n          }\n        }\n      }\n    } catch {\n      // Config doesn't exist or isn't valid JSON - that's fine\n    }\n  }\n\n  return { skills, errors };\n}\n\n/**\n * Scan for all available skills from all sources.\n */\nexport async function scanSkills(): Promise<SkillsScanResult> {\n  const allSkills: SkillInfo[] = [];\n  const allErrors: string[] = [];\n\n  // Scan project skills\n  const projectResult = await scanSkillsDirectory(getProjectSkillsPath(), 'project');\n  allSkills.push(...projectResult.skills);\n  allErrors.push(...projectResult.errors);\n\n  // Scan global skills\n  const globalResult = await scanSkillsDirectory(getGlobalSkillsPath(), 'global');\n  allSkills.push(...globalResult.skills);\n  allErrors.push(...globalResult.errors);\n\n  // Detect MCP skills\n  const mcpResult = await detectMCPSkills();\n  allSkills.push(...mcpResult.skills);\n  allErrors.push(...mcpResult.errors);\n\n  // Sort by source (project first, then global, then mcp), then by name\n  allSkills.sort((a, b) => {\n    const sourceOrder = { project: 0, global: 1, mcp: 2 };\n    const sourceDiff = sourceOrder[a.source] - sourceOrder[b.source];\n    if (sourceDiff !== 0) return sourceDiff;\n    return a.name.localeCompare(b.name);\n  });\n\n  return { skills: allSkills, errors: allErrors };\n}\n\n/**\n * CLI command handler for skills scan.\n */\nexport async function skillsScanCommand(options: { json?: boolean }): Promise<void> {\n  try {\n    const result = await scanSkills();\n\n    if (options.json) {\n      console.log(JSON.stringify(result, null, 2));\n      return;\n    }\n\n    if (result.skills.length === 0) {\n      console.log(fmt.bold('Skills Scan'));\n      console.log('\\nNo skills found.\\n');\n      console.log('Skills can be placed in:');\n      console.log(`  - Project: ${getProjectSkillsPath()}`);\n      console.log(`  - Global:  ${getGlobalSkillsPath()}`);\n      return;\n    }\n\n    console.log(fmt.bold('Available Skills'));\n    console.log('');\n\n    // Group by source\n    const projectSkills = result.skills.filter((s) => s.source === 'project');\n    const globalSkills = result.skills.filter((s) => s.source === 'global');\n    const mcpSkills = result.skills.filter((s) => s.source === 'mcp');\n\n    if (projectSkills.length > 0) {\n      console.log(fmt.cyan(`Project Skills (${getProjectSkillsPath()})`));\n      for (const skill of projectSkills) {\n        console.log(`  ${fmt.green(skill.name)}`);\n        if (skill.description) {\n          console.log(`    ${fmt.dim(truncateDescription(skill.description))}`);\n        }\n      }\n      console.log('');\n    }\n\n    if (globalSkills.length > 0) {\n      console.log(fmt.cyan(`Global Skills (${getGlobalSkillsPath()})`));\n      for (const skill of globalSkills) {\n        console.log(`  ${fmt.green(skill.name)}`);\n        if (skill.description) {\n          console.log(`    ${fmt.dim(truncateDescription(skill.description))}`);\n        }\n      }\n      console.log('');\n    }\n\n    if (mcpSkills.length > 0) {\n      console.log(fmt.cyan('MCP-Provided Skills'));\n      for (const skill of mcpSkills) {\n        console.log(`  ${fmt.green(skill.name)}`);\n        if (skill.description) {\n          console.log(`    ${fmt.dim(truncateDescription(skill.description))}`);\n        }\n      }\n      console.log('');\n    }\n\n    const count = result.skills.length;\n    console.log(fmt.success(`Found ${count} skill${count === 1 ? '' : 's'}`));\n\n    // Report errors if any\n    if (result.errors.length > 0) {\n      console.log('');\n      for (const err of result.errors) {\n        console.log(fmt.error(`Error: ${err}`));\n      }\n    }\n  } catch (err) {\n    const message = toErrorMessage(err);\n    if (options.json) {\n      console.log(JSON.stringify({ error: message }, null, 2));\n    } else {\n      console.log(fmt.error(`Skills scan failed: ${message}`));\n    }\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}