atomism 0.1.0

package/dist/signatures-K5QIL4WG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parser/signatures.ts"],"sourcesContent":["/**\n * AST Signature Extraction — extract function signatures from parsed ASTs.\n *\n * Shared between `extract --code` (G4) and `suggest` (G3).\n * Uses oxc-parser's typed Program AST to find exported functions\n * with their parameter types, return types, and metadata.\n */\n\nimport type { Program } from '@oxc-project/types';\n\nexport interface ExtractedParam {\n  name: string;\n  type?: string;\n  rest?: boolean;\n  hasDefault?: boolean;\n}\n\nexport interface AstComment {\n  type: 'Block' | 'Line';\n  value: string;\n  start: number;\n  end: number;\n}\n\nexport interface ExtractedSignature {\n  name: string;\n  line: number;\n  endLine: number;\n  exported: boolean;\n  exportDefault: boolean;\n  async: boolean;\n  params: ExtractedParam[];\n  returnType?: string;\n  hasJSDoc: boolean;\n}\n\n/**\n * Convert an oxc TSTypeAnnotation node to a human-readable type string.\n */\nfunction typeAnnotationToString(typeAnnotation: unknown): string | undefined {\n  if (!typeAnnotation || typeof typeAnnotation !== 'object') return undefined;\n  const ta = typeAnnotation as Record<string, unknown>;\n\n  // Unwrap TSTypeAnnotation wrapper\n  const inner = ta['type'] === 'TSTypeAnnotation'\n    ? ta['typeAnnotation'] as Record<string, unknown>\n    : ta;\n\n  if (!inner || typeof inner !== 'object') return undefined;\n\n  switch (inner['type']) {\n    case 'TSStringKeyword': return 'string';\n    case 'TSNumberKeyword': return 'number';\n    case 'TSBooleanKeyword': return 'boolean';\n    case 'TSVoidKeyword': return 'void';\n    case 'TSAnyKeyword': return 'any';\n    case 'TSUnknownKeyword': return 'unknown';\n    case 'TSNullKeyword': return 'null';\n    case 'TSUndefinedKeyword': return 'undefined';\n    case 'TSNeverKeyword': return 'never';\n    case 'TSBigIntKeyword': return 'bigint';\n    case 'TSSymbolKeyword': return 'symbol';\n    case 'TSObjectKeyword': return 'object';\n\n    case 'TSArrayType': {\n      const elemType = typeAnnotationToString(inner['elementType']);\n      return elemType ? `${elemType}[]` : 'unknown[]';\n    }\n\n    case 'TSTypeReference': {\n      const typeName = inner['typeName'] as Record<string, unknown> | undefined;\n      const name = typeName?.['name'] as string | undefined;\n      if (!name) return undefined;\n\n      const typeArgs = inner['typeArguments'] as Record<string, unknown> | undefined;\n      if (typeArgs && Array.isArray(typeArgs['params'])) {\n        const args = (typeArgs['params'] as unknown[])\n          .map(a => typeAnnotationToString(a))\n          .filter(Boolean);\n        if (args.length > 0) return `${name}<${args.join(', ')}>`;\n      }\n      return name;\n    }\n\n    case 'TSUnionType': {\n      const types = (inner['types'] as unknown[] | undefined);\n      if (!types) return undefined;\n      const parts = types.map(t => typeAnnotationToString(t)).filter(Boolean);\n      return parts.join(' | ');\n    }\n\n    case 'TSIntersectionType': {\n      const types = (inner['types'] as unknown[] | undefined);\n      if (!types) return undefined;\n      const parts = types.map(t => typeAnnotationToString(t)).filter(Boolean);\n      return parts.join(' & ');\n    }\n\n    case 'TSLiteralType': {\n      const literal = inner['literal'] as Record<string, unknown> | undefined;\n      if (!literal) return undefined;\n      if (literal['type'] === 'StringLiteral') return `'${literal['value']}'`;\n      if (literal['type'] === 'NumericLiteral') return String(literal['value']);\n      if (literal['type'] === 'BooleanLiteral') return String(literal['value']);\n      return undefined;\n    }\n\n    case 'TSTupleType': {\n      const elems = (inner['elementTypes'] as unknown[] | undefined);\n      if (!elems) return undefined;\n      const parts = elems.map(t => typeAnnotationToString(t)).filter(Boolean);\n      return `[${parts.join(', ')}]`;\n    }\n\n    case 'TSFunctionType': return 'Function';\n    case 'TSTypePredicate': return 'boolean';\n\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Extract parameter info from an oxc function parameter node.\n */\nfunction extractParam(param: Record<string, unknown>): ExtractedParam | undefined {\n  switch (param['type']) {\n    case 'Identifier': {\n      return {\n        name: param['name'] as string,\n        type: typeAnnotationToString(param['typeAnnotation']),\n      };\n    }\n\n    case 'AssignmentPattern': {\n      // Default parameter: left is the identifier, right is the default value\n      const left = param['left'] as Record<string, unknown> | undefined;\n      if (!left) return undefined;\n      const base = extractParam(left);\n      if (base) base.hasDefault = true;\n      return base;\n    }\n\n    case 'RestElement': {\n      const arg = param['argument'] as Record<string, unknown> | undefined;\n      if (!arg) return undefined;\n      const name = arg['name'] as string | undefined;\n      // Type annotation may be on RestElement itself or on the argument\n      const typeAnno = param['typeAnnotation'] ?? arg['typeAnnotation'];\n      return {\n        name: name ?? '...args',\n        type: typeAnnotationToString(typeAnno),\n        rest: true,\n      };\n    }\n\n    case 'ObjectPattern':\n      return { name: 'options', type: typeAnnotationToString(param['typeAnnotation']) };\n\n    case 'ArrayPattern':\n      return { name: 'items', type: typeAnnotationToString(param['typeAnnotation']) };\n\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Check if a JSDoc block comment immediately precedes the given position.\n * Uses AST comment nodes instead of regex scanning through source.\n * Allows whitespace and keywords (export, default, async) between comment and node.\n */\nfunction hasJSDocBefore(nodeStart: number, sourceCode: string, comments: AstComment[]): boolean {\n  // Find the closest block comment that ends before this node\n  for (let i = comments.length - 1; i >= 0; i--) {\n    const comment = comments[i]!;\n    if (comment.type !== 'Block' || !comment.value.startsWith('*')) continue;\n    if (comment.end > nodeStart) continue;\n    // Check that only whitespace/keywords appear between comment end and node start\n    const between = sourceCode.substring(comment.end, nodeStart);\n    if (/^\\s*(export\\s+)?(default\\s+)?(async\\s+)?$/.test(between)) return true;\n    // If there's non-whitespace/keyword content, this comment isn't for this node\n    break;\n  }\n  return false;\n}\n\n/**\n * Extract function signature from a function/arrow node.\n */\nfunction extractFunctionSignature(\n  node: Record<string, unknown>,\n  name: string,\n  exported: boolean,\n  exportDefault: boolean,\n  sourceCode: string,\n  comments: AstComment[],\n): ExtractedSignature | undefined {\n  const params = (node['params'] as unknown[]) ?? [];\n  const extractedParams: ExtractedParam[] = [];\n\n  for (const p of params) {\n    if (p && typeof p === 'object') {\n      const ep = extractParam(p as Record<string, unknown>);\n      if (ep) extractedParams.push(ep);\n    }\n  }\n\n  const start = node['start'] as number | undefined;\n  const end = node['end'] as number | undefined;\n\n  // Calculate line numbers from character offsets\n  let line = 1;\n  let endLine = 1;\n  if (start !== undefined) {\n    line = sourceCode.substring(0, start).split('\\n').length;\n  }\n  if (end !== undefined) {\n    endLine = sourceCode.substring(0, end).split('\\n').length;\n  }\n\n  const hasJSDoc = start !== undefined ? hasJSDocBefore(start, sourceCode, comments) : false;\n\n  return {\n    name,\n    line,\n    endLine,\n    exported,\n    exportDefault,\n    async: (node['async'] as boolean) ?? false,\n    params: extractedParams,\n    returnType: typeAnnotationToString(node['returnType']),\n    hasJSDoc,\n  };\n}\n\n/**\n * Extract all function signatures from a parsed AST Program.\n * @param comments - AST comment nodes from oxc-parser for JSDoc detection. Falls back to regex scan if omitted.\n */\nexport function extractSignatures(ast: Program, sourceCode: string, comments: AstComment[] = []): ExtractedSignature[] {\n  const signatures: ExtractedSignature[] = [];\n  const body = (ast as unknown as Record<string, unknown>)['body'] as unknown[];\n  if (!Array.isArray(body)) return signatures;\n\n  // Pre-scan: collect names exported via specifiers (e.g. `export { foo, bar }`)\n  const exportedNames = new Set<string>();\n  for (const node of body) {\n    if (!node || typeof node !== 'object') continue;\n    const n = node as Record<string, unknown>;\n    if (n['type'] === 'ExportNamedDeclaration' && !n['declaration']) {\n      const specifiers = n['specifiers'] as unknown[] | undefined;\n      if (specifiers) {\n        for (const spec of specifiers) {\n          const s = spec as Record<string, unknown>;\n          // exported.name is the public name; fall back to local.name\n          const exported = s['exported'] as Record<string, unknown> | undefined;\n          const local = s['local'] as Record<string, unknown> | undefined;\n          const name = (exported?.['name'] ?? local?.['name']) as string | undefined;\n          if (name) exportedNames.add(name);\n        }\n      }\n    }\n  }\n\n  for (const node of body) {\n    if (!node || typeof node !== 'object') continue;\n    const n = node as Record<string, unknown>;\n\n    switch (n['type']) {\n      case 'ExportNamedDeclaration': {\n        const decl = n['declaration'] as Record<string, unknown> | undefined;\n        if (!decl) break; // specifier-only exports handled via pre-scan\n\n        if (decl['type'] === 'FunctionDeclaration') {\n          const id = decl['id'] as Record<string, unknown> | undefined;\n          const name = id?.['name'] as string | undefined;\n          if (name) {\n            const sig = extractFunctionSignature(decl, name, true, false, sourceCode, comments);\n            if (sig) signatures.push(sig);\n          }\n        } else if (decl['type'] === 'VariableDeclaration') {\n          const declarators = decl['declarations'] as unknown[] | undefined;\n          if (declarators) {\n            for (const d of declarators) {\n              const declarator = d as Record<string, unknown>;\n              const id = declarator['id'] as Record<string, unknown> | undefined;\n              const init = declarator['init'] as Record<string, unknown> | undefined;\n              const name = id?.['name'] as string | undefined;\n\n              if (name && init && (init['type'] === 'ArrowFunctionExpression' || init['type'] === 'FunctionExpression')) {\n                const sig = extractFunctionSignature(init, name, true, false, sourceCode, comments);\n                if (sig) signatures.push(sig);\n              }\n            }\n          }\n        }\n        break;\n      }\n\n      case 'ExportDefaultDeclaration': {\n        const decl = n['declaration'] as Record<string, unknown> | undefined;\n        if (!decl) break;\n\n        if (decl['type'] === 'FunctionDeclaration') {\n          const id = decl['id'] as Record<string, unknown> | undefined;\n          const name = (id?.['name'] as string) ?? 'default';\n          const sig = extractFunctionSignature(decl, name, true, true, sourceCode, comments);\n          if (sig) signatures.push(sig);\n        } else if (decl['type'] === 'ArrowFunctionExpression' || decl['type'] === 'FunctionExpression') {\n          const sig = extractFunctionSignature(decl, 'default', true, true, sourceCode, comments);\n          if (sig) signatures.push(sig);\n        }\n        break;\n      }\n\n      case 'FunctionDeclaration': {\n        // Top-level function — may be exported via `export { name }`\n        const id = n['id'] as Record<string, unknown> | undefined;\n        const name = id?.['name'] as string | undefined;\n        if (name) {\n          const exported = exportedNames.has(name);\n          const sig = extractFunctionSignature(n, name, exported, false, sourceCode, comments);\n          if (sig) signatures.push(sig);\n        }\n        break;\n      }\n\n      case 'VariableDeclaration': {\n        // Top-level arrow/function expressions — may be exported via `export { name }`\n        const declarators = n['declarations'] as unknown[] | undefined;\n        if (declarators) {\n          for (const d of declarators) {\n            const declarator = d as Record<string, unknown>;\n            const id = declarator['id'] as Record<string, unknown> | undefined;\n            const init = declarator['init'] as Record<string, unknown> | undefined;\n            const name = id?.['name'] as string | undefined;\n\n            if (name && init && (init['type'] === 'ArrowFunctionExpression' || init['type'] === 'FunctionExpression')) {\n              const exported = exportedNames.has(name);\n              const sig = extractFunctionSignature(init, name, exported, false, sourceCode, comments);\n              if (sig) signatures.push(sig);\n            }\n          }\n        }\n        break;\n      }\n    }\n  }\n\n  return signatures;\n}\n"],"mappings":"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","names":[]}

package/dist/skills-assign-IHOXX4AI.js

@@ -0,0 +1,182 @@
+import {
+  getRegistryPath,
+  loadRegistry,
+  saveRegistry
+} from "./chunk-YKJO3ZFY.js";
+import {
+  fmt
+} from "./chunk-S6Z5G5DB.js";
+import {
+  toErrorMessage
+} from "./chunk-PLQJM2KT.js";
+
+// src/commands/skills-assign.ts
+function getSkills(atom) {
+  const skills = atom.skills ? [...atom.skills] : [];
+  if (atom.skill && !skills.includes(atom.skill)) {
+    skills.push(atom.skill);
+  }
+  return skills;
+}
+async function assignSkill(atomName, skillName) {
+  const projectRoot = process.cwd();
+  const registry = await loadRegistry(getRegistryPath(projectRoot));
+  const atom = registry.atoms[atomName];
+  if (!atom) {
+    throw new Error(`Atom "${atomName}" not found in registry. Register it first with \`atomic register\`.`);
+  }
+  const currentSkills = getSkills(atom);
+  if (currentSkills.includes(skillName)) {
+    return {
+      success: true,
+      atomName,
+      skills: currentSkills,
+      action: "assigned",
+      message: `Skill "${skillName}" is already assigned to atom "${atomName}"`
+    };
+  }
+  const newSkills = [...currentSkills, skillName];
+  registry.atoms[atomName] = {
+    ...atom,
+    skills: newSkills
+  };
+  await saveRegistry(getRegistryPath(projectRoot), registry);
+  return {
+    success: true,
+    atomName,
+    skills: newSkills,
+    action: "assigned"
+  };
+}
+async function removeSkill(atomName, skillName) {
+  const projectRoot = process.cwd();
+  const registry = await loadRegistry(getRegistryPath(projectRoot));
+  const atom = registry.atoms[atomName];
+  if (!atom) {
+    throw new Error(`Atom "${atomName}" not found in registry.`);
+  }
+  const currentSkills = getSkills(atom);
+  if (!currentSkills.includes(skillName)) {
+    return {
+      success: true,
+      atomName,
+      skills: currentSkills,
+      action: "removed",
+      message: `Skill "${skillName}" is not assigned to atom "${atomName}"`
+    };
+  }
+  const newSkills = currentSkills.filter((s) => s !== skillName);
+  registry.atoms[atomName] = {
+    ...atom,
+    skills: newSkills,
+    // Clear legacy skill field if it matches
+    skill: atom.skill === skillName ? void 0 : atom.skill
+  };
+  await saveRegistry(getRegistryPath(projectRoot), registry);
+  return {
+    success: true,
+    atomName,
+    skills: newSkills,
+    action: "removed"
+  };
+}
+async function listAtomSkills(atomName) {
+  const projectRoot = process.cwd();
+  const registry = await loadRegistry(getRegistryPath(projectRoot));
+  const atom = registry.atoms[atomName];
+  if (!atom) {
+    throw new Error(`Atom "${atomName}" not found in registry.`);
+  }
+  const skills = getSkills(atom);
+  return {
+    success: true,
+    atomName,
+    skills,
+    action: "listed"
+  };
+}
+async function skillsAssignCommand(atomName, options) {
+  try {
+    const result = await assignSkill(atomName, options.skill);
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (result.message) {
+      console.log(fmt.dim(result.message));
+    } else {
+      console.log(fmt.success(`Assigned skill "${options.skill}" to atom "${atomName}"`));
+    }
+    console.log(`  Skills: ${result.skills.join(", ") || "(none)"}`);
+  } catch (err) {
+    const message = toErrorMessage(err);
+    if (options.json) {
+      console.log(JSON.stringify({ success: false, error: message }, null, 2));
+    } else {
+      console.log(fmt.error(`Skill assignment failed: ${message}`));
+    }
+    process.exit(1);
+  }
+}
+async function skillsRemoveCommand(atomName, options) {
+  try {
+    const result = await removeSkill(atomName, options.skill);
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    if (result.message) {
+      console.log(fmt.dim(result.message));
+    } else {
+      console.log(fmt.success(`Removed skill "${options.skill}" from atom "${atomName}"`));
+    }
+    console.log(`  Skills: ${result.skills.join(", ") || "(none)"}`);
+  } catch (err) {
+    const message = toErrorMessage(err);
+    if (options.json) {
+      console.log(JSON.stringify({ success: false, error: message }, null, 2));
+    } else {
+      console.log(fmt.error(`Skill removal failed: ${message}`));
+    }
+    process.exit(1);
+  }
+}
+async function skillsListAtomCommand(atomName, options) {
+  try {
+    const result = await listAtomSkills(atomName);
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(fmt.bold(`Skills for "${atomName}"`));
+    console.log("");
+    if (result.skills.length === 0) {
+      console.log(fmt.dim("No skills assigned to this atom."));
+      console.log("");
+      console.log(`Use ${fmt.cyan("atomic skills assign " + atomName + " --skill <name>")} to assign a skill.`);
+    } else {
+      for (const skill of result.skills) {
+        console.log(`  ${fmt.green(skill)}`);
+      }
+      console.log("");
+      console.log(fmt.dim(`${result.skills.length} skill${result.skills.length === 1 ? "" : "s"} assigned`));
+    }
+  } catch (err) {
+    const message = toErrorMessage(err);
+    if (options.json) {
+      console.log(JSON.stringify({ success: false, error: message }, null, 2));
+    } else {
+      console.log(fmt.error(`Failed to list skills: ${message}`));
+    }
+    process.exit(1);
+  }
+}
+export {
+  assignSkill,
+  listAtomSkills,
+  removeSkill,
+  skillsAssignCommand,
+  skillsListAtomCommand,
+  skillsRemoveCommand
+};
+//# sourceMappingURL=skills-assign-IHOXX4AI.js.map

package/dist/skills-assign-IHOXX4AI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/skills-assign.ts"],"sourcesContent":["/**\n * Skill Assignment - Assign, list, and remove skills from atoms.\n *\n * Story 6.8: AOP-1259\n *\n * Acceptance Criteria:\n * - atomic skills assign <atom> --skill <name> updates atom's skill field\n * - Registration updated in .atomic/registry.json\n * - Subsequent executions load the skill\n * - atomic skills list <atom> shows assigned skills\n * - atomic skills remove <atom> --skill <name> removes assignment\n */\n\nimport { fmt } from '../cli/format.js';\nimport { loadRegistry, saveRegistry, getRegistryPath } from '../storage/index.js';\nimport type { RegistryAtom } from '../schemas/registry.js';\nimport { toErrorMessage } from '../utils/errors.js';\n\n/**\n * Result of skill assignment operations.\n */\nexport interface SkillAssignResult {\n  success: boolean;\n  atomName: string;\n  skills: string[];\n  action: 'assigned' | 'removed' | 'listed';\n  message?: string;\n}\n\n/**\n * Get the skills array from an atom entry.\n * Handles both the old 'skill' field and new 'skills' array.\n */\nfunction getSkills(atom: RegistryAtom): string[] {\n  const skills: string[] = atom.skills ? [...atom.skills] : [];\n  // Include legacy 'skill' field if not already in skills array\n  if (atom.skill && !skills.includes(atom.skill)) {\n    skills.push(atom.skill);\n  }\n  return skills;\n}\n\n/**\n * Assign a skill to an atom.\n */\nexport async function assignSkill(\n  atomName: string,\n  skillName: string\n): Promise<SkillAssignResult> {\n  const projectRoot = process.cwd();\n  const registry = await loadRegistry(getRegistryPath(projectRoot));\n\n  const atom = registry.atoms[atomName];\n  if (!atom) {\n    throw new Error(`Atom \"${atomName}\" not found in registry. Register it first with \\`atomic register\\`.`);\n  }\n\n  const currentSkills = getSkills(atom);\n\n  if (currentSkills.includes(skillName)) {\n    return {\n      success: true,\n      atomName,\n      skills: currentSkills,\n      action: 'assigned',\n      message: `Skill \"${skillName}\" is already assigned to atom \"${atomName}\"`,\n    };\n  }\n\n  // Add the skill\n  const newSkills = [...currentSkills, skillName];\n  registry.atoms[atomName] = {\n    ...atom,\n    skills: newSkills,\n  };\n\n  await saveRegistry(getRegistryPath(projectRoot), registry);\n\n  return {\n    success: true,\n    atomName,\n    skills: newSkills,\n    action: 'assigned',\n  };\n}\n\n/**\n * Remove a skill from an atom.\n */\nexport async function removeSkill(\n  atomName: string,\n  skillName: string\n): Promise<SkillAssignResult> {\n  const projectRoot = process.cwd();\n  const registry = await loadRegistry(getRegistryPath(projectRoot));\n\n  const atom = registry.atoms[atomName];\n  if (!atom) {\n    throw new Error(`Atom \"${atomName}\" not found in registry.`);\n  }\n\n  const currentSkills = getSkills(atom);\n\n  if (!currentSkills.includes(skillName)) {\n    return {\n      success: true,\n      atomName,\n      skills: currentSkills,\n      action: 'removed',\n      message: `Skill \"${skillName}\" is not assigned to atom \"${atomName}\"`,\n    };\n  }\n\n  // Remove the skill\n  const newSkills = currentSkills.filter((s) => s !== skillName);\n  registry.atoms[atomName] = {\n    ...atom,\n    skills: newSkills,\n    // Clear legacy skill field if it matches\n    skill: atom.skill === skillName ? undefined : atom.skill,\n  };\n\n  await saveRegistry(getRegistryPath(projectRoot), registry);\n\n  return {\n    success: true,\n    atomName,\n    skills: newSkills,\n    action: 'removed',\n  };\n}\n\n/**\n * List skills assigned to an atom.\n */\nexport async function listAtomSkills(atomName: string): Promise<SkillAssignResult> {\n  const projectRoot = process.cwd();\n  const registry = await loadRegistry(getRegistryPath(projectRoot));\n\n  const atom = registry.atoms[atomName];\n  if (!atom) {\n    throw new Error(`Atom \"${atomName}\" not found in registry.`);\n  }\n\n  const skills = getSkills(atom);\n\n  return {\n    success: true,\n    atomName,\n    skills,\n    action: 'listed',\n  };\n}\n\n/**\n * CLI command handler for skills assign.\n */\nexport async function skillsAssignCommand(\n  atomName: string,\n  options: { skill: string; json?: boolean }\n): Promise<void> {\n  try {\n    const result = await assignSkill(atomName, options.skill);\n\n    if (options.json) {\n      console.log(JSON.stringify(result, null, 2));\n      return;\n    }\n\n    if (result.message) {\n      console.log(fmt.dim(result.message));\n    } else {\n      console.log(fmt.success(`Assigned skill \"${options.skill}\" to atom \"${atomName}\"`));\n    }\n    console.log(`  Skills: ${result.skills.join(', ') || '(none)'}`);\n  } catch (err) {\n    const message = toErrorMessage(err);\n    if (options.json) {\n      console.log(JSON.stringify({ success: false, error: message }, null, 2));\n    } else {\n      console.log(fmt.error(`Skill assignment failed: ${message}`));\n    }\n    process.exit(1);\n  }\n}\n\n/**\n * CLI command handler for skills remove.\n */\nexport async function skillsRemoveCommand(\n  atomName: string,\n  options: { skill: string; json?: boolean }\n): Promise<void> {\n  try {\n    const result = await removeSkill(atomName, options.skill);\n\n    if (options.json) {\n      console.log(JSON.stringify(result, null, 2));\n      return;\n    }\n\n    if (result.message) {\n      console.log(fmt.dim(result.message));\n    } else {\n      console.log(fmt.success(`Removed skill \"${options.skill}\" from atom \"${atomName}\"`));\n    }\n    console.log(`  Skills: ${result.skills.join(', ') || '(none)'}`);\n  } catch (err) {\n    const message = toErrorMessage(err);\n    if (options.json) {\n      console.log(JSON.stringify({ success: false, error: message }, null, 2));\n    } else {\n      console.log(fmt.error(`Skill removal failed: ${message}`));\n    }\n    process.exit(1);\n  }\n}\n\n/**\n * CLI command handler for skills list <atom>.\n */\nexport async function skillsListAtomCommand(\n  atomName: string,\n  options: { json?: boolean }\n): Promise<void> {\n  try {\n    const result = await listAtomSkills(atomName);\n\n    if (options.json) {\n      console.log(JSON.stringify(result, null, 2));\n      return;\n    }\n\n    console.log(fmt.bold(`Skills for \"${atomName}\"`));\n    console.log('');\n\n    if (result.skills.length === 0) {\n      console.log(fmt.dim('No skills assigned to this atom.'));\n      console.log('');\n      console.log(`Use ${fmt.cyan('atomic skills assign ' + atomName + ' --skill <name>')} to assign a skill.`);\n    } else {\n      for (const skill of result.skills) {\n        console.log(`  ${fmt.green(skill)}`);\n      }\n      console.log('');\n      console.log(fmt.dim(`${result.skills.length} skill${result.skills.length === 1 ? '' : 's'} assigned`));\n    }\n  } catch (err) {\n    const message = toErrorMessage(err);\n    if (options.json) {\n      console.log(JSON.stringify({ success: false, error: message }, null, 2));\n    } else {\n      console.log(fmt.error(`Failed to list skills: ${message}`));\n    }\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/skills-load-JSD5UG2K.js

@@ -0,0 +1,20 @@
+import {
+  extractSkillInstructions,
+  formatLoadedSkills,
+  loadSkill,
+  loadSkillsForAtom
+} from "./chunk-55AP34JO.js";
+import {
+  buildSkillContext
+} from "./chunk-6MDHM2B4.js";
+import "./chunk-UVUDQ4XP.js";
+import "./chunk-S6Z5G5DB.js";
+import "./chunk-PLQJM2KT.js";
+export {
+  buildSkillContext,
+  extractSkillInstructions,
+  formatLoadedSkills,
+  loadSkill,
+  loadSkillsForAtom
+};
+//# sourceMappingURL=skills-load-JSD5UG2K.js.map

package/dist/skills-load-JSD5UG2K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/skills-scan-WACJFRJN.js

@@ -0,0 +1,25 @@
+import {
+  detectMCPSkills,
+  getGlobalSkillsPath,
+  getProjectSkillsPath,
+  parseFrontmatter,
+  scanSkillEntry,
+  scanSkills,
+  scanSkillsDirectory,
+  skillsScanCommand,
+  truncateDescription
+} from "./chunk-UVUDQ4XP.js";
+import "./chunk-S6Z5G5DB.js";
+import "./chunk-PLQJM2KT.js";
+export {
+  detectMCPSkills,
+  getGlobalSkillsPath,
+  getProjectSkillsPath,
+  parseFrontmatter,
+  scanSkillEntry,
+  scanSkills,
+  scanSkillsDirectory,
+  skillsScanCommand,
+  truncateDescription
+};
+//# sourceMappingURL=skills-scan-WACJFRJN.js.map

package/dist/skills-scan-WACJFRJN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/skills-suggest-JFI2NUJI.js

@@ -0,0 +1,269 @@
+import {
+  StorageNotInitializedError,
+  getRegistryPath,
+  loadRegistry
+} from "./chunk-YKJO3ZFY.js";
+import {
+  scanSkills
+} from "./chunk-UVUDQ4XP.js";
+import {
+  fmt
+} from "./chunk-S6Z5G5DB.js";
+import {
+  toErrorMessage
+} from "./chunk-PLQJM2KT.js";
+
+// src/commands/skills-suggest.ts
+var SKILL_CATEGORIES = [
+  {
+    name: "testing",
+    keywords: ["test", "testing", "spec", "assertion", "expect", "verify", "validate"],
+    descriptionKeywords: ["test", "verify", "validate", "check", "assert"],
+    inputKeywords: ["test", "spec", "fixture", "mock", "stub"],
+    outputKeywords: ["result", "pass", "fail", "coverage", "report"],
+    explanationTemplate: "This atom appears to involve testing or validation. A testing skill can help with writing comprehensive test cases and assertions."
+  },
+  {
+    name: "code-review",
+    keywords: ["review", "lint", "analyze", "quality", "style", "format"],
+    descriptionKeywords: ["review", "analyze", "check", "quality", "lint", "format"],
+    inputKeywords: ["code", "source", "file", "diff", "patch"],
+    outputKeywords: ["issues", "suggestions", "warnings", "errors", "feedback"],
+    explanationTemplate: "This atom works with code analysis or quality checks. A code-review skill can provide structured feedback and improvement suggestions."
+  },
+  {
+    name: "documentation",
+    keywords: ["doc", "document", "readme", "markdown", "comment", "explain"],
+    descriptionKeywords: ["document", "explain", "describe", "write", "generate"],
+    inputKeywords: ["code", "function", "api", "module", "interface"],
+    outputKeywords: ["markdown", "readme", "doc", "documentation", "comment"],
+    explanationTemplate: "This atom involves documentation generation or management. A documentation skill can help create clear, comprehensive docs."
+  },
+  {
+    name: "refactoring",
+    keywords: ["refactor", "restructure", "improve", "optimize", "clean"],
+    descriptionKeywords: ["refactor", "improve", "optimize", "restructure", "simplify"],
+    inputKeywords: ["code", "function", "class", "module", "component"],
+    outputKeywords: ["code", "improved", "optimized", "refactored", "cleaned"],
+    explanationTemplate: "This atom focuses on code improvement or restructuring. A refactoring skill can guide systematic code improvements."
+  },
+  {
+    name: "generation",
+    keywords: ["generate", "create", "scaffold", "template", "boilerplate"],
+    descriptionKeywords: ["generate", "create", "scaffold", "build", "produce"],
+    inputKeywords: ["config", "params", "options", "template", "schema"],
+    outputKeywords: ["code", "file", "component", "module", "template"],
+    explanationTemplate: "This atom generates code or content from templates. A generation skill can help produce consistent, well-structured output."
+  },
+  {
+    name: "data-processing",
+    keywords: ["data", "transform", "parse", "convert", "process", "extract"],
+    descriptionKeywords: ["transform", "parse", "convert", "process", "extract", "map"],
+    inputKeywords: ["data", "json", "csv", "xml", "input", "raw"],
+    outputKeywords: ["data", "result", "transformed", "processed", "output"],
+    explanationTemplate: "This atom processes or transforms data. A data-processing skill can help with data validation and transformation patterns."
+  },
+  {
+    name: "api-integration",
+    keywords: ["api", "http", "request", "fetch", "endpoint", "rest", "graphql"],
+    descriptionKeywords: ["api", "fetch", "request", "call", "integrate", "connect"],
+    inputKeywords: ["url", "endpoint", "params", "headers", "body", "query"],
+    outputKeywords: ["response", "data", "result", "status", "error"],
+    explanationTemplate: "This atom interacts with external APIs. An API integration skill can help with proper error handling and response processing."
+  },
+  {
+    name: "file-operations",
+    keywords: ["file", "read", "write", "path", "directory", "filesystem"],
+    descriptionKeywords: ["file", "read", "write", "save", "load", "store"],
+    inputKeywords: ["path", "file", "directory", "filename", "content"],
+    outputKeywords: ["content", "file", "saved", "written", "created"],
+    explanationTemplate: "This atom works with files or the filesystem. A file-operations skill can help with safe file handling and path management."
+  }
+];
+function extractSchemaKeywords(schema) {
+  const keywords = [];
+  let schemaStr;
+  try {
+    schemaStr = JSON.stringify(schema);
+  } catch {
+    return [];
+  }
+  const fieldMatches = schemaStr.match(/"([a-z_][a-z0-9_]*)"/gi) || [];
+  for (const match of fieldMatches) {
+    const field = match.replace(/"/g, "").toLowerCase();
+    if (field.length > 2 && !["type", "object", "string", "number", "boolean"].includes(field)) {
+      keywords.push(field);
+    }
+  }
+  return [...new Set(keywords)];
+}
+function calculateKeywordMatch(targetKeywords, categoryKeywords) {
+  const matched = [];
+  let score = 0;
+  for (const target of targetKeywords) {
+    const targetLower = target.toLowerCase();
+    for (const keyword of categoryKeywords) {
+      if (targetLower.includes(keyword) || keyword.includes(targetLower)) {
+        matched.push(keyword);
+        score += targetLower === keyword ? 1 : 0.5;
+      }
+    }
+  }
+  return { score, matched: [...new Set(matched)] };
+}
+function analyzeAtom(atomName, description, inputKeywords, outputKeywords) {
+  const suggestions = [];
+  const descWords = description.toLowerCase().split(/\s+/).filter((word) => word.length > 2);
+  for (const category of SKILL_CATEGORIES) {
+    let totalScore = 0;
+    const allMatched = [];
+    const descMatch = calculateKeywordMatch(descWords, category.descriptionKeywords);
+    totalScore += descMatch.score * 2;
+    allMatched.push(...descMatch.matched);
+    const inputMatch = calculateKeywordMatch(inputKeywords, category.inputKeywords);
+    totalScore += inputMatch.score;
+    allMatched.push(...inputMatch.matched);
+    const outputMatch = calculateKeywordMatch(outputKeywords, category.outputKeywords);
+    totalScore += outputMatch.score;
+    allMatched.push(...outputMatch.matched);
+    const nameMatch = calculateKeywordMatch([atomName], category.keywords);
+    totalScore += nameMatch.score * 1.5;
+    allMatched.push(...nameMatch.matched);
+    const MATCH_RATE_BASELINE = 0.3;
+    const maxPossibleScore = (category.descriptionKeywords.length * 2 + category.inputKeywords.length + category.outputKeywords.length + category.keywords.length * 1.5) * MATCH_RATE_BASELINE;
+    const confidence = Math.min(totalScore / maxPossibleScore, 1);
+    if (confidence > 0.1) {
+      suggestions.push({
+        skillName: category.name,
+        confidence,
+        explanation: category.explanationTemplate,
+        matchedKeywords: [...new Set(allMatched)],
+        category: category.name
+      });
+    }
+  }
+  suggestions.sort((a, b) => b.confidence - a.confidence);
+  return suggestions;
+}
+async function loadAtomDefinition(atomName) {
+  try {
+    const registryPath = getRegistryPath(process.cwd());
+    const registry = await loadRegistry(registryPath);
+    const atom = registry.atoms[atomName];
+    if (atom) {
+      return {
+        description: atom.description,
+        input: atom.inputSchema ?? {},
+        output: atom.outputSchema ?? {}
+      };
+    }
+    return null;
+  } catch (error) {
+    if (!(error instanceof StorageNotInitializedError)) {
+      const message = toErrorMessage(error);
+      console.error(`Warning: Failed to load atom "${atomName}" from registry: ${message}`);
+    }
+    return null;
+  }
+}
+async function suggestSkills(atomName) {
+  const atomDef = await loadAtomDefinition(atomName);
+  let description = "";
+  let inputKeywords = [];
+  let outputKeywords = [];
+  if (atomDef) {
+    description = atomDef.description;
+    inputKeywords = extractSchemaKeywords(atomDef.input);
+    outputKeywords = extractSchemaKeywords(atomDef.output);
+  } else {
+    description = atomName.replace(/[_-]/g, " ");
+  }
+  const suggestions = analyzeAtom(atomName, description, inputKeywords, outputKeywords);
+  let availableSkills = [];
+  try {
+    const scanResult = await scanSkills();
+    availableSkills = scanResult.skills;
+  } catch {
+  }
+  for (const suggestion of suggestions) {
+    const categoryTokens = suggestion.category.toLowerCase().split(/[-_]/);
+    const matchingSkill = availableSkills.find((s) => {
+      const skillName = s.name.toLowerCase();
+      const skillTokens = skillName.split(/[-_]/);
+      if (skillName === suggestion.category) {
+        return true;
+      }
+      return skillTokens.some((token) => categoryTokens.includes(token)) || categoryTokens.some((token) => skillTokens.includes(token));
+    });
+    if (matchingSkill) {
+      suggestion.explanation += ` The "${matchingSkill.name}" skill is available for this.`;
+    }
+  }
+  return {
+    atomName,
+    suggestions,
+    availableSkills
+  };
+}
+async function skillsSuggestCommand(atomName, options) {
+  try {
+    const result = await suggestSkills(atomName);
+    if (options.json) {
+      console.log(JSON.stringify(result, null, 2));
+      return;
+    }
+    console.log(fmt.bold(`Skill Suggestions for "${atomName}"`));
+    console.log("");
+    if (result.suggestions.length === 0) {
+      console.log(fmt.dim("No skill suggestions found for this atom."));
+      console.log("");
+      console.log("This could mean:");
+      console.log("  - The atom name/description is too generic");
+      console.log("  - No matching skill categories were found");
+      console.log("");
+      return;
+    }
+    for (const suggestion of result.suggestions) {
+      const confidencePercent = Math.round(suggestion.confidence * 100);
+      const barLength = Math.round(suggestion.confidence * 20);
+      const bar = "\u2588".repeat(barLength) + "\u2591".repeat(20 - barLength);
+      console.log(fmt.cyan(`${suggestion.skillName}`));
+      console.log(`  ${fmt.dim("Confidence:")} ${bar} ${confidencePercent}%`);
+      console.log(`  ${fmt.dim("Why:")} ${suggestion.explanation}`);
+      if (suggestion.matchedKeywords.length > 0) {
+        console.log(`  ${fmt.dim("Matched:")} ${suggestion.matchedKeywords.join(", ")}`);
+      }
+      console.log("");
+    }
+    const relevantSkills = result.availableSkills.filter(
+      (skill) => result.suggestions.some(
+        (s) => skill.name.toLowerCase().includes(s.category) || s.category.includes(skill.name.toLowerCase())
+      )
+    );
+    if (relevantSkills.length > 0) {
+      console.log(fmt.bold("Available Skills"));
+      for (const skill of relevantSkills) {
+        console.log(`  ${fmt.green(skill.name)} (${skill.source})`);
+      }
+      console.log("");
+    }
+  } catch (err) {
+    const message = toErrorMessage(err);
+    if (options.json) {
+      console.log(JSON.stringify({ error: message }, null, 2));
+    } else {
+      console.log(fmt.error(`Skill suggestion failed: ${message}`));
+    }
+    process.exit(1);
+  }
+}
+export {
+  SKILL_CATEGORIES,
+  analyzeAtom,
+  calculateKeywordMatch,
+  extractSchemaKeywords,
+  loadAtomDefinition,
+  skillsSuggestCommand,
+  suggestSkills
+};
+//# sourceMappingURL=skills-suggest-JFI2NUJI.js.map

package/dist/skills-suggest-JFI2NUJI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/skills-suggest.ts"],"sourcesContent":["/**\n * Skill Suggestion - Recommend skills for an atom.\n *\n * Story 6.7: AOP-1258\n *\n * Acceptance Criteria:\n * - System analyzes atom description and input/output\n * - Suggests relevant skills (e.g., 'testing', 'code-review')\n * - Shows confidence score for each suggestion\n * - Explains why each skill might be useful\n */\n\nimport { fmt } from '../cli/format.js';\nimport { loadRegistry, getRegistryPath, StorageNotInitializedError } from '../storage/index.js';\nimport { scanSkills, SkillInfo } from './skills-scan.js';\nimport { toErrorMessage } from '../utils/errors.js';\n\n/**\n * Skill category with matching keywords and explanation template.\n */\nexport interface SkillCategory {\n  name: string;\n  keywords: string[];\n  descriptionKeywords: string[];\n  inputKeywords: string[];\n  outputKeywords: string[];\n  explanationTemplate: string;\n}\n\n/**\n * Built-in skill categories for matching.\n */\nexport const SKILL_CATEGORIES: SkillCategory[] = [\n  {\n    name: 'testing',\n    keywords: ['test', 'testing', 'spec', 'assertion', 'expect', 'verify', 'validate'],\n    descriptionKeywords: ['test', 'verify', 'validate', 'check', 'assert'],\n    inputKeywords: ['test', 'spec', 'fixture', 'mock', 'stub'],\n    outputKeywords: ['result', 'pass', 'fail', 'coverage', 'report'],\n    explanationTemplate:\n      'This atom appears to involve testing or validation. A testing skill can help with writing comprehensive test cases and assertions.',\n  },\n  {\n    name: 'code-review',\n    keywords: ['review', 'lint', 'analyze', 'quality', 'style', 'format'],\n    descriptionKeywords: ['review', 'analyze', 'check', 'quality', 'lint', 'format'],\n    inputKeywords: ['code', 'source', 'file', 'diff', 'patch'],\n    outputKeywords: ['issues', 'suggestions', 'warnings', 'errors', 'feedback'],\n    explanationTemplate:\n      'This atom works with code analysis or quality checks. A code-review skill can provide structured feedback and improvement suggestions.',\n  },\n  {\n    name: 'documentation',\n    keywords: ['doc', 'document', 'readme', 'markdown', 'comment', 'explain'],\n    descriptionKeywords: ['document', 'explain', 'describe', 'write', 'generate'],\n    inputKeywords: ['code', 'function', 'api', 'module', 'interface'],\n    outputKeywords: ['markdown', 'readme', 'doc', 'documentation', 'comment'],\n    explanationTemplate:\n      'This atom involves documentation generation or management. A documentation skill can help create clear, comprehensive docs.',\n  },\n  {\n    name: 'refactoring',\n    keywords: ['refactor', 'restructure', 'improve', 'optimize', 'clean'],\n    descriptionKeywords: ['refactor', 'improve', 'optimize', 'restructure', 'simplify'],\n    inputKeywords: ['code', 'function', 'class', 'module', 'component'],\n    outputKeywords: ['code', 'improved', 'optimized', 'refactored', 'cleaned'],\n    explanationTemplate:\n      'This atom focuses on code improvement or restructuring. A refactoring skill can guide systematic code improvements.',\n  },\n  {\n    name: 'generation',\n    keywords: ['generate', 'create', 'scaffold', 'template', 'boilerplate'],\n    descriptionKeywords: ['generate', 'create', 'scaffold', 'build', 'produce'],\n    inputKeywords: ['config', 'params', 'options', 'template', 'schema'],\n    outputKeywords: ['code', 'file', 'component', 'module', 'template'],\n    explanationTemplate:\n      'This atom generates code or content from templates. A generation skill can help produce consistent, well-structured output.',\n  },\n  {\n    name: 'data-processing',\n    keywords: ['data', 'transform', 'parse', 'convert', 'process', 'extract'],\n    descriptionKeywords: ['transform', 'parse', 'convert', 'process', 'extract', 'map'],\n    inputKeywords: ['data', 'json', 'csv', 'xml', 'input', 'raw'],\n    outputKeywords: ['data', 'result', 'transformed', 'processed', 'output'],\n    explanationTemplate:\n      'This atom processes or transforms data. A data-processing skill can help with data validation and transformation patterns.',\n  },\n  {\n    name: 'api-integration',\n    keywords: ['api', 'http', 'request', 'fetch', 'endpoint', 'rest', 'graphql'],\n    descriptionKeywords: ['api', 'fetch', 'request', 'call', 'integrate', 'connect'],\n    inputKeywords: ['url', 'endpoint', 'params', 'headers', 'body', 'query'],\n    outputKeywords: ['response', 'data', 'result', 'status', 'error'],\n    explanationTemplate:\n      'This atom interacts with external APIs. An API integration skill can help with proper error handling and response processing.',\n  },\n  {\n    name: 'file-operations',\n    keywords: ['file', 'read', 'write', 'path', 'directory', 'filesystem'],\n    descriptionKeywords: ['file', 'read', 'write', 'save', 'load', 'store'],\n    inputKeywords: ['path', 'file', 'directory', 'filename', 'content'],\n    outputKeywords: ['content', 'file', 'saved', 'written', 'created'],\n    explanationTemplate:\n      'This atom works with files or the filesystem. A file-operations skill can help with safe file handling and path management.',\n  },\n];\n\n/**\n * Result of skill suggestion analysis.\n */\nexport interface SkillSuggestion {\n  skillName: string;\n  confidence: number;\n  explanation: string;\n  matchedKeywords: string[];\n  category: string;\n}\n\n/**\n * Result of the suggest operation.\n */\nexport interface SuggestResult {\n  atomName: string;\n  suggestions: SkillSuggestion[];\n  availableSkills: SkillInfo[];\n}\n\n/**\n * Extract keywords from a Zod schema for matching.\n */\nexport function extractSchemaKeywords(schema: unknown): string[] {\n  const keywords: string[] = [];\n  let schemaStr: string;\n  try {\n    schemaStr = JSON.stringify(schema);\n  } catch {\n    // Handle circular references or other stringify errors\n    return [];\n  }\n\n  // Extract potential field names from the schema string\n  const fieldMatches = schemaStr.match(/\"([a-z_][a-z0-9_]*)\"/gi) || [];\n  for (const match of fieldMatches) {\n    const field = match.replace(/\"/g, '').toLowerCase();\n    if (field.length > 2 && !['type', 'object', 'string', 'number', 'boolean'].includes(field)) {\n      keywords.push(field);\n    }\n  }\n\n  return [...new Set(keywords)];\n}\n\n/**\n * Calculate similarity score between two keyword sets.\n */\nexport function calculateKeywordMatch(\n  targetKeywords: string[],\n  categoryKeywords: string[]\n): { score: number; matched: string[] } {\n  const matched: string[] = [];\n  let score = 0;\n\n  for (const target of targetKeywords) {\n    const targetLower = target.toLowerCase();\n    for (const keyword of categoryKeywords) {\n      if (targetLower.includes(keyword) || keyword.includes(targetLower)) {\n        matched.push(keyword);\n        // Exact match scores higher\n        score += targetLower === keyword ? 1.0 : 0.5;\n      }\n    }\n  }\n\n  return { score, matched: [...new Set(matched)] };\n}\n\n/**\n * Analyze an atom and suggest relevant skills.\n */\nexport function analyzeAtom(\n  atomName: string,\n  description: string,\n  inputKeywords: string[],\n  outputKeywords: string[]\n): SkillSuggestion[] {\n  const suggestions: SkillSuggestion[] = [];\n  // Filter empty/short tokens to avoid false positives (empty string matches everything)\n  const descWords = description\n    .toLowerCase()\n    .split(/\\s+/)\n    .filter((word) => word.length > 2);\n\n  for (const category of SKILL_CATEGORIES) {\n    let totalScore = 0;\n    const allMatched: string[] = [];\n\n    // Match description\n    const descMatch = calculateKeywordMatch(descWords, category.descriptionKeywords);\n    totalScore += descMatch.score * 2; // Description weighted higher\n    allMatched.push(...descMatch.matched);\n\n    // Match input schema keywords\n    const inputMatch = calculateKeywordMatch(inputKeywords, category.inputKeywords);\n    totalScore += inputMatch.score;\n    allMatched.push(...inputMatch.matched);\n\n    // Match output schema keywords\n    const outputMatch = calculateKeywordMatch(outputKeywords, category.outputKeywords);\n    totalScore += outputMatch.score;\n    allMatched.push(...outputMatch.matched);\n\n    // Match atom name\n    const nameMatch = calculateKeywordMatch([atomName], category.keywords);\n    totalScore += nameMatch.score * 1.5;\n    allMatched.push(...nameMatch.matched);\n\n    // Normalize score to 0-1 range\n    // We use 30% of max possible matches as our \"perfect score\" baseline,\n    // since typical good matches won't hit every keyword\n    const MATCH_RATE_BASELINE = 0.3;\n    const maxPossibleScore =\n      (category.descriptionKeywords.length * 2 +\n        category.inputKeywords.length +\n        category.outputKeywords.length +\n        category.keywords.length * 1.5) *\n      MATCH_RATE_BASELINE;\n    const confidence = Math.min(totalScore / maxPossibleScore, 1.0);\n\n    if (confidence > 0.1) {\n      // Only suggest if above threshold\n      suggestions.push({\n        skillName: category.name,\n        confidence,\n        explanation: category.explanationTemplate,\n        matchedKeywords: [...new Set(allMatched)],\n        category: category.name,\n      });\n    }\n  }\n\n  // Sort by confidence descending\n  suggestions.sort((a, b) => b.confidence - a.confidence);\n\n  return suggestions;\n}\n\n/**\n * Load an atom definition from the registry.\n */\nexport async function loadAtomDefinition(\n  atomName: string\n): Promise<{ description: string; input: unknown; output: unknown } | null> {\n  try {\n    const registryPath = getRegistryPath(process.cwd());\n    const registry = await loadRegistry(registryPath);\n\n    const atom = registry.atoms[atomName];\n    if (atom) {\n      return {\n        description: atom.description,\n        input: atom.inputSchema ?? {},\n        output: atom.outputSchema ?? {},\n      };\n    }\n\n    return null;\n  } catch (error) {\n    // Storage not initialized is expected - atom may not be in registry\n    if (!(error instanceof StorageNotInitializedError)) {\n      const message = toErrorMessage(error);\n      console.error(`Warning: Failed to load atom \"${atomName}\" from registry: ${message}`);\n    }\n    return null;\n  }\n}\n\n/**\n * Suggest skills for an atom.\n */\nexport async function suggestSkills(atomName: string): Promise<SuggestResult> {\n  // Load atom definition\n  const atomDef = await loadAtomDefinition(atomName);\n\n  let description = '';\n  let inputKeywords: string[] = [];\n  let outputKeywords: string[] = [];\n\n  if (atomDef) {\n    description = atomDef.description;\n    inputKeywords = extractSchemaKeywords(atomDef.input);\n    outputKeywords = extractSchemaKeywords(atomDef.output);\n  } else {\n    // If atom not found in registry, use the name for basic matching\n    description = atomName.replace(/[_-]/g, ' ');\n  }\n\n  // Analyze and get suggestions\n  const suggestions = analyzeAtom(atomName, description, inputKeywords, outputKeywords);\n\n  // Get available skills to cross-reference\n  let availableSkills: SkillInfo[] = [];\n  try {\n    const scanResult = await scanSkills();\n    availableSkills = scanResult.skills;\n  } catch {\n    // Continue without available skills if scan fails\n  }\n\n  // Enhance suggestions with actual skill availability\n  for (const suggestion of suggestions) {\n    const categoryTokens = suggestion.category.toLowerCase().split(/[-_]/);\n    const matchingSkill = availableSkills.find((s) => {\n      const skillName = s.name.toLowerCase();\n      const skillTokens = skillName.split(/[-_]/);\n      // Exact match\n      if (skillName === suggestion.category) {\n        return true;\n      }\n      // Token-based matching: skill tokens contain category or vice versa\n      return (\n        skillTokens.some((token) => categoryTokens.includes(token)) ||\n        categoryTokens.some((token) => skillTokens.includes(token))\n      );\n    });\n    if (matchingSkill) {\n      suggestion.explanation += ` The \"${matchingSkill.name}\" skill is available for this.`;\n    }\n  }\n\n  return {\n    atomName,\n    suggestions,\n    availableSkills,\n  };\n}\n\n/**\n * CLI command handler for skills suggest.\n */\nexport async function skillsSuggestCommand(\n  atomName: string,\n  options: { json?: boolean }\n): Promise<void> {\n  try {\n    const result = await suggestSkills(atomName);\n\n    if (options.json) {\n      console.log(JSON.stringify(result, null, 2));\n      return;\n    }\n\n    console.log(fmt.bold(`Skill Suggestions for \"${atomName}\"`));\n    console.log('');\n\n    if (result.suggestions.length === 0) {\n      console.log(fmt.dim('No skill suggestions found for this atom.'));\n      console.log('');\n      console.log('This could mean:');\n      console.log('  - The atom name/description is too generic');\n      console.log('  - No matching skill categories were found');\n      console.log('');\n      return;\n    }\n\n    for (const suggestion of result.suggestions) {\n      // Confidence bar\n      const confidencePercent = Math.round(suggestion.confidence * 100);\n      const barLength = Math.round(suggestion.confidence * 20);\n      const bar = '█'.repeat(barLength) + '░'.repeat(20 - barLength);\n\n      console.log(fmt.cyan(`${suggestion.skillName}`));\n      console.log(`  ${fmt.dim('Confidence:')} ${bar} ${confidencePercent}%`);\n      console.log(`  ${fmt.dim('Why:')} ${suggestion.explanation}`);\n      if (suggestion.matchedKeywords.length > 0) {\n        console.log(`  ${fmt.dim('Matched:')} ${suggestion.matchedKeywords.join(', ')}`);\n      }\n      console.log('');\n    }\n\n    // Show available skills that might help\n    const relevantSkills = result.availableSkills.filter((skill) =>\n      result.suggestions.some(\n        (s) =>\n          skill.name.toLowerCase().includes(s.category) ||\n          s.category.includes(skill.name.toLowerCase())\n      )\n    );\n\n    if (relevantSkills.length > 0) {\n      console.log(fmt.bold('Available Skills'));\n      for (const skill of relevantSkills) {\n        console.log(`  ${fmt.green(skill.name)} (${skill.source})`);\n      }\n      console.log('');\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(`Skill suggestion failed: ${message}`));\n    }\n    process.exit(1);\n  }\n}\n"],"mappings":"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","names":[]}