agents-inc 0.149.2 → 0.151.0

package/dist/chunk-PV2HNW4I.js

@@ -0,0 +1,382 @@
+#!/usr/bin/env node
+import {
+  validateKebabCaseName
+} from "./chunk-PG4G4IIK.js";
+import {
+  FEATURE_FLAGS,
+  featureDisabledError
+} from "./chunk-IHO75PMZ.js";
+import {
+  BaseCommand,
+  EXIT_CODES
+} from "./chunk-7QIHKQL5.js";
+import {
+  LOCAL_DEFAULTS,
+  computeSkillFolderHash,
+  detectInstallation,
+  loadConfig,
+  loadConfigTypesDataInBackground,
+  resolveAuthor,
+  toTitleCase,
+  writeScaffoldedEntityTypes,
+  yamlSchemaComment
+} from "./chunk-TVHRMRD3.js";
+import {
+  ensureDir,
+  fileExists,
+  getErrorMessage,
+  skillCategoriesFileSchema,
+  verbose,
+  writeFile
+} from "./chunk-3LIU2ZEF.js";
+import {
+  CLI_INVOKE_COMMAND,
+  DEFAULT_VERSION,
+  LOCAL_SKILLS_PATH,
+  SCHEMA_PATHS,
+  SKILLS_DIR_PATH,
+  SKILL_CATEGORIES_PATH,
+  SKILL_RULES_PATH,
+  STANDARD_FILES,
+  marketplaceManifestPath
+} from "./chunk-O5ASLZ2K.js";
+import {
+  init_esm_shims
+} from "./chunk-P56WJ5FA.js";
+
+// src/cli/commands/new/skill.ts
+init_esm_shims();
+import { Args, Flags } from "@oclif/core";
+import path from "path";
+
+// src/cli/lib/skills/generators.ts
+init_esm_shims();
+var DEFAULT_CATEGORY_ORDER = 99;
+var CATEGORIES_TS_COMMENT = "// Skill category definitions";
+var RULES_TS_COMMENT = "// Skill rules configuration";
+function formatTsExport(comment, data) {
+  const body = JSON.stringify(data, null, 2);
+  return `${comment}
+export default ${body};
+`;
+}
+function buildCategoryEntry(category, domain) {
+  const categoryPart = category.includes("-") ? category.slice(category.indexOf("-") + 1) : category;
+  return {
+    id: category,
+    displayName: toTitleCase(categoryPart),
+    description: `Skills for ${toTitleCase(categoryPart)}`,
+    exclusive: true,
+    required: false,
+    order: DEFAULT_CATEGORY_ORDER,
+    custom: true,
+    domain
+  };
+}
+function generateSkillCategoriesTs(category, domain) {
+  const entry = buildCategoryEntry(category, domain);
+  const data = {
+    version: DEFAULT_VERSION,
+    categories: {
+      [category]: entry
+    }
+  };
+  return formatTsExport(CATEGORIES_TS_COMMENT, data);
+}
+function generateSkillRulesTs() {
+  const data = {
+    version: DEFAULT_VERSION,
+    relationships: {
+      conflicts: [],
+      discourages: [],
+      recommends: [],
+      requires: [],
+      alternatives: []
+    }
+  };
+  return formatTsExport(RULES_TS_COMMENT, data);
+}
+
+// src/cli/commands/new/skill.ts
+var NewSkill = class _NewSkill extends BaseCommand {
+  static summary = "Create a new local skill with proper structure";
+  static description = "Create a new local skill scaffold with SKILL.md and metadata.yaml files";
+  static examples = [
+    {
+      description: "Scaffold a skill in the local marketplace",
+      command: "<%= config.bin %> <%= command.id %> my-skill"
+    },
+    {
+      description: "Scaffold with explicit category and domain",
+      command: "<%= config.bin %> <%= command.id %> my-skill --category web/forms --domain web"
+    },
+    {
+      description: "Overwrite an existing skill",
+      command: "<%= config.bin %> <%= command.id %> my-skill --force"
+    }
+  ];
+  static args = {
+    name: Args.string({
+      description: "Name of the skill to create (kebab-case)",
+      required: true
+    })
+  };
+  // Override parent baseFlags to drop --source (new skill auto-detects marketplace context)
+  static baseFlags = {};
+  static flags = {
+    author: Flags.string({
+      char: "a",
+      description: "Author identifier (e.g., @myhandle)",
+      required: false
+    }),
+    category: Flags.string({
+      char: "c",
+      description: "Skill category",
+      default: LOCAL_DEFAULTS.CATEGORY
+    }),
+    domain: Flags.string({
+      char: "d",
+      description: "Domain for the skill (e.g., web, api, cli)",
+      required: false
+    }),
+    force: Flags.boolean({
+      char: "f",
+      description: "Overwrite existing skill",
+      default: false
+    })
+  };
+  async run() {
+    if (!FEATURE_FLAGS.NEW_SKILL_COMMAND) {
+      this.error(featureDisabledError("new skill"), {
+        exit: EXIT_CODES.ERROR
+      });
+    }
+    const { args, flags } = await this.parse(_NewSkill);
+    const projectDir = process.cwd();
+    await this.ensureInstallation(projectDir);
+    const configTypesReady = loadConfigTypesDataInBackground(void 0, projectDir);
+    this.printHeader();
+    this.validateName(args.name);
+    const author = await resolveAuthorOrDefault(flags.author, projectDir);
+    const category = flags.category;
+    const domain = flags.domain ?? LOCAL_DEFAULTS.DOMAIN;
+    const skillsBasePath = await this.resolveSkillsBasePath(projectDir);
+    const skillDir = path.join(skillsBasePath, args.name);
+    await this.checkExistingDir(skillDir, flags.force);
+    this.logSkillInfo(args.name, author, category, skillDir);
+    await this.createSkillFiles(
+      args.name,
+      author,
+      category,
+      domain,
+      skillDir,
+      projectDir,
+      configTypesReady
+    );
+  }
+  async ensureInstallation(projectDir) {
+    const installation = await detectInstallation(projectDir);
+    if (!installation) {
+      this.error(`No installation found. Run '${CLI_INVOKE_COMMAND} init' first.`, {
+        exit: EXIT_CODES.ERROR
+      });
+    }
+  }
+  printHeader() {
+    this.log("");
+    this.log("Create New Skill");
+    this.log("");
+  }
+  validateName(name) {
+    const validationError = validateKebabCaseName(name, "Skill");
+    if (validationError) {
+      this.error(validationError, { exit: EXIT_CODES.INVALID_ARGS });
+    }
+  }
+  async resolveSkillsBasePath(projectDir) {
+    const marketplacePath = marketplaceManifestPath(projectDir);
+    if (await fileExists(marketplacePath)) {
+      this.log(`Detected marketplace context, creating skill in ${SKILLS_DIR_PATH}/`);
+      return path.join(projectDir, SKILLS_DIR_PATH);
+    }
+    return path.join(projectDir, LOCAL_SKILLS_PATH);
+  }
+  async checkExistingDir(skillDir, force) {
+    await this.ensureDirOverwritable(skillDir, force, {
+      exists: `Skill directory already exists: ${skillDir}`,
+      overwriting: `Overwriting existing skill at ${skillDir}`
+    });
+  }
+  logSkillInfo(name, author, category, skillDir) {
+    this.log(`Skill name: ${name}`);
+    this.log(`Author: ${author}`);
+    this.log(`Category: ${category}`);
+    this.log(`Directory: ${skillDir}`);
+    this.log("");
+  }
+  async createSkillFiles(name, author, category, domain, skillDir, projectDir, configTypesReady) {
+    this.log("Creating skill files...");
+    try {
+      const result = await scaffoldSkillFiles({
+        name,
+        author,
+        category,
+        domain,
+        skillDir
+      });
+      this.log("");
+      this.logSuccess(`Created ${STANDARD_FILES.SKILL_MD} at ${result.skillMdPath}`);
+      this.logSuccess(`Created ${STANDARD_FILES.METADATA_YAML} at ${result.metadataPath}`);
+      const marketplacePath = marketplaceManifestPath(projectDir);
+      if (await fileExists(marketplacePath)) {
+        try {
+          await updateSkillRegistryConfig({ projectRoot: projectDir, category, domain });
+        } catch (error) {
+          this.warn(`Could not update config files: ${getErrorMessage(error)}`);
+        }
+      }
+      try {
+        await writeScaffoldedEntityTypes(projectDir, configTypesReady, {
+          extraSkillIds: [name],
+          extraDomains: [domain],
+          extraCategories: [category]
+        });
+      } catch (error) {
+        this.warn(`Could not update ${STANDARD_FILES.CONFIG_TYPES_TS}: ${getErrorMessage(error)}`);
+      }
+      this.log("");
+      this.log(
+        `Skill created successfully! Run '${CLI_INVOKE_COMMAND} compile' to include it in your agents.`
+      );
+      this.log("");
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+};
+async function resolveAuthorOrDefault(authorFlag, projectDir) {
+  if (authorFlag) return authorFlag;
+  return await resolveAuthor(projectDir) || LOCAL_DEFAULTS.AUTHOR;
+}
+function generateSkillMd(name) {
+  const titleName = toTitleCase(name);
+  return `---
+name: ${name}
+description: Brief description of this skill
+---
+
+# ${titleName}
+
+> **Quick Guide:** Add a brief summary of what this skill teaches.
+
+---
+
+<critical_requirements>
+
+## CRITICAL: Before Using This Skill
+
+**(Add critical requirements here)**
+
+</critical_requirements>
+
+---
+
+**When to use:**
+
+- Add use cases here
+
+**Key patterns covered:**
+
+- Add patterns here
+
+---
+
+<patterns>
+
+## Core Patterns
+
+### Pattern 1: Example Pattern
+
+Add your patterns here.
+
+</patterns>
+
+---
+
+<critical_reminders>
+
+## CRITICAL REMINDERS
+
+**(Repeat critical requirements here)**
+
+</critical_reminders>
+`;
+}
+function generateMetadataYaml(name, author, category, contentHash, domain) {
+  const titleName = toTitleCase(name);
+  return `${yamlSchemaComment(SCHEMA_PATHS.customMetadata)}
+custom: true
+domain: ${domain}
+category: ${category}
+author: "${author}"
+displayName: ${titleName}
+slug: ${name}
+cliDescription: Brief description
+usageGuidance: Use when <guidance>.
+contentHash: ${contentHash}
+`;
+}
+async function scaffoldSkillFiles(options) {
+  const { name, author, category, domain, skillDir } = options;
+  const skillMdContent = generateSkillMd(name);
+  const skillMdPath = path.join(skillDir, STANDARD_FILES.SKILL_MD);
+  const metadataPath = path.join(skillDir, STANDARD_FILES.METADATA_YAML);
+  await writeFile(skillMdPath, skillMdContent);
+  const contentHash = await computeSkillFolderHash(skillDir);
+  const metadataContent = generateMetadataYaml(name, author, category, contentHash, domain);
+  await writeFile(metadataPath, metadataContent);
+  return { skillMdPath, metadataPath, contentHash };
+}
+async function updateSkillRegistryConfig(options) {
+  const { projectRoot, category, domain } = options;
+  const categoriesPath = path.join(projectRoot, SKILL_CATEGORIES_PATH);
+  const rulesPath = path.join(projectRoot, SKILL_RULES_PATH);
+  if (await fileExists(categoriesPath)) {
+    const parsed = await loadConfig(categoriesPath, skillCategoriesFileSchema);
+    if (!parsed) {
+      throw new Error(
+        `Config at ${categoriesPath} has no default export \u2014 delete the file or add \`export default { version, categories: {} }\``
+      );
+    }
+    const categories = parsed.categories;
+    if (!categories[category]) {
+      const updated = {
+        ...parsed,
+        categories: { ...categories, [category]: buildCategoryEntry(category, domain) }
+      };
+      await writeFile(categoriesPath, formatTsExport(CATEGORIES_TS_COMMENT2, updated));
+      verbose(`Added category '${category}' to ${SKILL_CATEGORIES_PATH}`);
+    }
+  } else {
+    await ensureDir(path.dirname(categoriesPath));
+    await writeFile(categoriesPath, generateSkillCategoriesTs(category, domain));
+    verbose(`Created ${SKILL_CATEGORIES_PATH}`);
+  }
+  if (!await fileExists(rulesPath)) {
+    await ensureDir(path.dirname(rulesPath));
+    await writeFile(rulesPath, generateSkillRulesTs());
+    verbose(`Created ${SKILL_RULES_PATH}`);
+  }
+}
+var CATEGORIES_TS_COMMENT2 = "// Skill category definitions";
+
+export {
+  generateSkillCategoriesTs,
+  generateSkillRulesTs,
+  NewSkill,
+  resolveAuthorOrDefault,
+  generateSkillMd,
+  generateMetadataYaml,
+  scaffoldSkillFiles
+};
+//# sourceMappingURL=chunk-PV2HNW4I.js.map

package/dist/chunk-PV2HNW4I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/commands/new/skill.ts","../src/cli/lib/skills/generators.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport path from \"path\";\nimport { BaseCommand } from \"../../base-command.js\";\nimport { resolveAuthor } from \"../../lib/configuration/index.js\";\nimport { loadConfig } from \"../../lib/configuration/config-loader.js\";\nimport { skillCategoriesFileSchema } from \"../../lib/schemas.js\";\nimport { loadConfigTypesDataInBackground } from \"../../lib/configuration/config-types-writer.js\";\nimport { writeScaffoldedEntityTypes } from \"../../lib/config-gate/index.js\";\nimport { fileExists, writeFile, ensureDir } from \"../../utils/fs.js\";\nimport { getErrorMessage } from \"../../utils/errors.js\";\nimport { verbose } from \"../../utils/logger.js\";\nimport { computeSkillFolderHash } from \"../../lib/versioning.js\";\nimport { validateKebabCaseName } from \"../../lib/validate-kebab-name.js\";\nimport {\n  CLI_INVOKE_COMMAND,\n  LOCAL_SKILLS_PATH,\n  marketplaceManifestPath,\n  SCHEMA_PATHS,\n  SKILL_CATEGORIES_PATH,\n  SKILL_RULES_PATH,\n  SKILLS_DIR_PATH,\n  STANDARD_FILES,\n} from \"../../consts.js\";\nimport { EXIT_CODES } from \"../../lib/exit-codes.js\";\nimport { FEATURE_FLAGS, featureDisabledError } from \"../../lib/feature-flags.js\";\nimport { yamlSchemaComment } from \"../../utils/yaml-schema.js\";\nimport { detectInstallation } from \"../../lib/installation/index.js\";\nimport { LOCAL_DEFAULTS } from \"../../lib/metadata-keys.js\";\nimport type { CategoryDefinition, CategoryPath } from \"../../types/index.js\";\nimport {\n  generateSkillCategoriesTs,\n  generateSkillRulesTs,\n  buildCategoryEntry,\n  formatTsExport,\n} from \"../../lib/skills/generators.js\";\nimport { toTitleCase } from \"../../utils/string.js\";\n\nexport default class NewSkill extends BaseCommand {\n  static summary = \"Create a new local skill with proper structure\";\n  static description = \"Create a new local skill scaffold with SKILL.md and metadata.yaml files\";\n\n  static examples = [\n    {\n      description: \"Scaffold a skill in the local marketplace\",\n      command: \"<%= config.bin %> <%= command.id %> my-skill\",\n    },\n    {\n      description: \"Scaffold with explicit category and domain\",\n      command: \"<%= config.bin %> <%= command.id %> my-skill --category web/forms --domain web\",\n    },\n    {\n      description: \"Overwrite an existing skill\",\n      command: \"<%= config.bin %> <%= command.id %> my-skill --force\",\n    },\n  ];\n\n  static args = {\n    name: Args.string({\n      description: \"Name of the skill to create (kebab-case)\",\n      required: true,\n    }),\n  };\n\n  // Override parent baseFlags to drop --source (new skill auto-detects marketplace context)\n  static baseFlags = {} as (typeof BaseCommand)[\"baseFlags\"];\n\n  static flags = {\n    author: Flags.string({\n      char: \"a\",\n      description: \"Author identifier (e.g., @myhandle)\",\n      required: false,\n    }),\n    category: Flags.string({\n      char: \"c\",\n      description: \"Skill category\",\n      default: LOCAL_DEFAULTS.CATEGORY,\n    }),\n    domain: Flags.string({\n      char: \"d\",\n      description: \"Domain for the skill (e.g., web, api, cli)\",\n      required: false,\n    }),\n    force: Flags.boolean({\n      char: \"f\",\n      description: \"Overwrite existing skill\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    if (!FEATURE_FLAGS.NEW_SKILL_COMMAND) {\n      this.error(featureDisabledError(\"new skill\"), {\n        exit: EXIT_CODES.ERROR,\n      });\n    }\n\n    const { args, flags } = await this.parse(NewSkill);\n    const projectDir = process.cwd();\n\n    await this.ensureInstallation(projectDir);\n    const configTypesReady = loadConfigTypesDataInBackground(undefined, projectDir);\n\n    this.printHeader();\n    this.validateName(args.name);\n\n    const author = await resolveAuthorOrDefault(flags.author, projectDir);\n    // Boundary cast: CLI flag accepts custom category values not in the generated union\n    const category = flags.category as CategoryPath;\n    const domain = flags.domain ?? LOCAL_DEFAULTS.DOMAIN;\n    const skillsBasePath = await this.resolveSkillsBasePath(projectDir);\n    const skillDir = path.join(skillsBasePath, args.name);\n\n    await this.checkExistingDir(skillDir, flags.force);\n    this.logSkillInfo(args.name, author, category, skillDir);\n    await this.createSkillFiles(\n      args.name,\n      author,\n      category,\n      domain,\n      skillDir,\n      projectDir,\n      configTypesReady,\n    );\n  }\n\n  private async ensureInstallation(projectDir: string): Promise<void> {\n    const installation = await detectInstallation(projectDir);\n    if (!installation) {\n      this.error(`No installation found. Run '${CLI_INVOKE_COMMAND} init' first.`, {\n        exit: EXIT_CODES.ERROR,\n      });\n    }\n  }\n\n  private printHeader(): void {\n    this.log(\"\");\n    this.log(\"Create New Skill\");\n    this.log(\"\");\n  }\n\n  private validateName(name: string): void {\n    const validationError = validateKebabCaseName(name, \"Skill\");\n    if (validationError) {\n      this.error(validationError, { exit: EXIT_CODES.INVALID_ARGS });\n    }\n  }\n\n  private async resolveSkillsBasePath(projectDir: string): Promise<string> {\n    const marketplacePath = marketplaceManifestPath(projectDir);\n    if (await fileExists(marketplacePath)) {\n      this.log(`Detected marketplace context, creating skill in ${SKILLS_DIR_PATH}/`);\n      return path.join(projectDir, SKILLS_DIR_PATH);\n    }\n    return path.join(projectDir, LOCAL_SKILLS_PATH);\n  }\n\n  private async checkExistingDir(skillDir: string, force: boolean): Promise<void> {\n    await this.ensureDirOverwritable(skillDir, force, {\n      exists: `Skill directory already exists: ${skillDir}`,\n      overwriting: `Overwriting existing skill at ${skillDir}`,\n    });\n  }\n\n  private logSkillInfo(\n    name: string,\n    author: string,\n    category: CategoryPath,\n    skillDir: string,\n  ): void {\n    this.log(`Skill name: ${name}`);\n    this.log(`Author: ${author}`);\n    this.log(`Category: ${category}`);\n    this.log(`Directory: ${skillDir}`);\n    this.log(\"\");\n  }\n\n  private async createSkillFiles(\n    name: string,\n    author: string,\n    category: CategoryPath,\n    domain: string,\n    skillDir: string,\n    projectDir: string,\n    configTypesReady: ReturnType<typeof loadConfigTypesDataInBackground>,\n  ): Promise<void> {\n    this.log(\"Creating skill files...\");\n\n    try {\n      const result = await scaffoldSkillFiles({\n        name,\n        author,\n        category,\n        domain,\n        skillDir,\n      });\n\n      this.log(\"\");\n      this.logSuccess(`Created ${STANDARD_FILES.SKILL_MD} at ${result.skillMdPath}`);\n      this.logSuccess(`Created ${STANDARD_FILES.METADATA_YAML} at ${result.metadataPath}`);\n\n      const marketplacePath = marketplaceManifestPath(projectDir);\n      if (await fileExists(marketplacePath)) {\n        try {\n          await updateSkillRegistryConfig({ projectRoot: projectDir, category, domain });\n        } catch (error) {\n          this.warn(`Could not update config files: ${getErrorMessage(error)}`);\n        }\n      }\n\n      try {\n        await writeScaffoldedEntityTypes(projectDir, configTypesReady, {\n          extraSkillIds: [name],\n          extraDomains: [domain],\n          extraCategories: [category],\n        });\n      } catch (error) {\n        this.warn(`Could not update ${STANDARD_FILES.CONFIG_TYPES_TS}: ${getErrorMessage(error)}`);\n      }\n\n      this.log(\"\");\n      this.log(\n        `Skill created successfully! Run '${CLI_INVOKE_COMMAND} compile' to include it in your agents.`,\n      );\n      this.log(\"\");\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n}\n\ntype ScaffoldSkillOptions = {\n  name: string;\n  author: string;\n  category: CategoryPath;\n  domain: string;\n  skillDir: string;\n};\n\ntype ScaffoldSkillResult = {\n  skillMdPath: string;\n  metadataPath: string;\n  contentHash: string;\n};\n\ntype RegistryUpdateOptions = {\n  projectRoot: string;\n  category: CategoryPath;\n  domain: string;\n};\n\nexport async function resolveAuthorOrDefault(\n  authorFlag: string | undefined,\n  projectDir: string,\n): Promise<string> {\n  if (authorFlag) return authorFlag;\n  return (await resolveAuthor(projectDir)) || LOCAL_DEFAULTS.AUTHOR;\n}\n\nexport function generateSkillMd(name: string): string {\n  const titleName = toTitleCase(name);\n\n  return `---\nname: ${name}\ndescription: Brief description of this skill\n---\n\n# ${titleName}\n\n> **Quick Guide:** Add a brief summary of what this skill teaches.\n\n---\n\n<critical_requirements>\n\n## CRITICAL: Before Using This Skill\n\n**(Add critical requirements here)**\n\n</critical_requirements>\n\n---\n\n**When to use:**\n\n- Add use cases here\n\n**Key patterns covered:**\n\n- Add patterns here\n\n---\n\n<patterns>\n\n## Core Patterns\n\n### Pattern 1: Example Pattern\n\nAdd your patterns here.\n\n</patterns>\n\n---\n\n<critical_reminders>\n\n## CRITICAL REMINDERS\n\n**(Repeat critical requirements here)**\n\n</critical_reminders>\n`;\n}\n\nexport function generateMetadataYaml(\n  name: string,\n  author: string,\n  category: CategoryPath,\n  contentHash: string,\n  domain: string,\n): string {\n  const titleName = toTitleCase(name);\n\n  return `${yamlSchemaComment(SCHEMA_PATHS.customMetadata)}\ncustom: true\ndomain: ${domain}\ncategory: ${category}\nauthor: \"${author}\"\ndisplayName: ${titleName}\nslug: ${name}\ncliDescription: Brief description\nusageGuidance: Use when <guidance>.\ncontentHash: ${contentHash}\n`;\n}\n\nexport async function scaffoldSkillFiles(\n  options: ScaffoldSkillOptions,\n): Promise<ScaffoldSkillResult> {\n  const { name, author, category, domain, skillDir } = options;\n\n  const skillMdContent = generateSkillMd(name);\n  const skillMdPath = path.join(skillDir, STANDARD_FILES.SKILL_MD);\n  const metadataPath = path.join(skillDir, STANDARD_FILES.METADATA_YAML);\n\n  await writeFile(skillMdPath, skillMdContent);\n\n  const contentHash = await computeSkillFolderHash(skillDir);\n  const metadataContent = generateMetadataYaml(name, author, category, contentHash, domain);\n  await writeFile(metadataPath, metadataContent);\n\n  return { skillMdPath, metadataPath, contentHash };\n}\n\nasync function updateSkillRegistryConfig(options: RegistryUpdateOptions): Promise<void> {\n  const { projectRoot, category, domain } = options;\n\n  const categoriesPath = path.join(projectRoot, SKILL_CATEGORIES_PATH);\n  const rulesPath = path.join(projectRoot, SKILL_RULES_PATH);\n\n  if (await fileExists(categoriesPath)) {\n    const parsed = await loadConfig(categoriesPath, skillCategoriesFileSchema);\n    if (!parsed) {\n      throw new Error(\n        `Config at ${categoriesPath} has no default export — delete the file or add \\`export default { version, categories: {} }\\``,\n      );\n    }\n    // Boundary cast: CategoryMap keys are strict Category; CLI flag may introduce custom category IDs\n    const categories = parsed.categories as Record<string, CategoryDefinition>;\n    if (!categories[category]) {\n      const updated = {\n        ...parsed,\n        categories: { ...categories, [category]: buildCategoryEntry(category, domain) },\n      };\n      await writeFile(categoriesPath, formatTsExport(CATEGORIES_TS_COMMENT, updated));\n      verbose(`Added category '${category}' to ${SKILL_CATEGORIES_PATH}`);\n    }\n  } else {\n    await ensureDir(path.dirname(categoriesPath));\n    await writeFile(categoriesPath, generateSkillCategoriesTs(category, domain));\n    verbose(`Created ${SKILL_CATEGORIES_PATH}`);\n  }\n\n  if (!(await fileExists(rulesPath))) {\n    await ensureDir(path.dirname(rulesPath));\n    await writeFile(rulesPath, generateSkillRulesTs());\n    verbose(`Created ${SKILL_RULES_PATH}`);\n  }\n}\n\nconst CATEGORIES_TS_COMMENT = \"// Skill category definitions\";\n","import { DEFAULT_VERSION } from \"../../consts\";\nimport { toTitleCase } from \"../../utils/string\";\nimport type { CategoryPath } from \"../../types/index\";\n\nconst DEFAULT_CATEGORY_ORDER = 99;\n\nconst CATEGORIES_TS_COMMENT = \"// Skill category definitions\";\nconst RULES_TS_COMMENT = \"// Skill rules configuration\";\n\nexport function formatTsExport(comment: string, data: unknown): string {\n  const body = JSON.stringify(data, null, 2);\n  return `${comment}\\nexport default ${body};\\n`;\n}\n\nexport function buildCategoryEntry(\n  category: CategoryPath,\n  domain: string,\n): Record<string, unknown> {\n  const categoryPart = category.includes(\"-\")\n    ? category.slice(category.indexOf(\"-\") + 1)\n    : category;\n  return {\n    id: category,\n    displayName: toTitleCase(categoryPart),\n    description: `Skills for ${toTitleCase(categoryPart)}`,\n    exclusive: true,\n    required: false,\n    order: DEFAULT_CATEGORY_ORDER,\n    custom: true,\n    domain,\n  };\n}\n\nexport function generateSkillCategoriesTs(category: CategoryPath, domain: string): string {\n  const entry = buildCategoryEntry(category, domain);\n  const data = {\n    version: DEFAULT_VERSION,\n    categories: {\n      [category]: entry,\n    },\n  };\n  return formatTsExport(CATEGORIES_TS_COMMENT, data);\n}\n\nexport function generateSkillRulesTs(): string {\n  const data = {\n    version: DEFAULT_VERSION,\n    relationships: {\n      conflicts: [],\n      discourages: [],\n      recommends: [],\n      requires: [],\n      alternatives: [],\n    },\n  };\n  return formatTsExport(RULES_TS_COMMENT, data);\n}\n"],"mappings":"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","names":["CATEGORIES_TS_COMMENT"]}

package/dist/chunk-QQLRX4KI.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+import {
+  CLI_COLORS,
+  UI_SYMBOLS
+} from "./chunk-O5ASLZ2K.js";
+import {
+  init_esm_shims
+} from "./chunk-P56WJ5FA.js";
+
+// src/cli/components/wizard/selection-card.tsx
+init_esm_shims();
+import { Box, Text } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
+var SelectionCard = ({
+  label,
+  description,
+  isFocused,
+  marginBottom
+}) => {
+  const descriptionLines = Array.isArray(description) ? description : [description];
+  return /* @__PURE__ */ jsx(
+    Box,
+    {
+      borderStyle: "round",
+      borderColor: isFocused ? CLI_COLORS.PRIMARY : CLI_COLORS.NEUTRAL,
+      paddingX: 2,
+      paddingY: 1,
+      marginBottom,
+      width: "100%",
+      children: /* @__PURE__ */ jsxs(Box, { flexDirection: "column", gap: 1, children: [
+        /* @__PURE__ */ jsx(Text, { color: isFocused ? CLI_COLORS.PRIMARY : void 0, bold: isFocused, children: isFocused ? `${UI_SYMBOLS.CHEVRON} ${label}` : label }),
+        descriptionLines.map((line, index) => /* @__PURE__ */ jsx(Text, { dimColor: true, children: line }, index))
+      ] })
+    }
+  );
+};
+
+export {
+  SelectionCard
+};
+//# sourceMappingURL=chunk-QQLRX4KI.js.map

package/dist/chunk-QQLRX4KI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/components/wizard/selection-card.tsx"],"sourcesContent":["import { Box, Text } from \"ink\";\nimport React from \"react\";\nimport { CLI_COLORS, UI_SYMBOLS } from \"../../consts.js\";\n\ntype SelectionCardProps = {\n  label: string;\n  description: string | string[];\n  isFocused: boolean;\n  marginBottom?: number;\n};\n\nexport const SelectionCard: React.FC<SelectionCardProps> = ({\n  label,\n  description,\n  isFocused,\n  marginBottom,\n}) => {\n  const descriptionLines = Array.isArray(description) ? description : [description];\n\n  return (\n    <Box\n      borderStyle=\"round\"\n      borderColor={isFocused ? CLI_COLORS.PRIMARY : CLI_COLORS.NEUTRAL}\n      paddingX={2}\n      paddingY={1}\n      marginBottom={marginBottom}\n      width=\"100%\"\n    >\n      <Box flexDirection=\"column\" gap={1}>\n        <Text color={isFocused ? CLI_COLORS.PRIMARY : undefined} bold={isFocused}>\n          {isFocused ? `${UI_SYMBOLS.CHEVRON} ${label}` : label}\n        </Text>\n        {descriptionLines.map((line, index) => (\n          <Text key={index} dimColor>\n            {line}\n          </Text>\n        ))}\n      </Box>\n    </Box>\n  );\n};\n"],"mappings":";;;;;;;;;;AAAA;AAAA,SAAS,KAAK,YAAY;AA4BpB,SACE,KADF;AAjBC,IAAM,gBAA8C,CAAC;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,mBAAmB,MAAM,QAAQ,WAAW,IAAI,cAAc,CAAC,WAAW;AAEhF,SACE;AAAA,IAAC;AAAA;AAAA,MACC,aAAY;AAAA,MACZ,aAAa,YAAY,WAAW,UAAU,WAAW;AAAA,MACzD,UAAU;AAAA,MACV,UAAU;AAAA,MACV;AAAA,MACA,OAAM;AAAA,MAEN,+BAAC,OAAI,eAAc,UAAS,KAAK,GAC/B;AAAA,4BAAC,QAAK,OAAO,YAAY,WAAW,UAAU,QAAW,MAAM,WAC5D,sBAAY,GAAG,WAAW,OAAO,IAAI,KAAK,KAAK,OAClD;AAAA,QACC,iBAAiB,IAAI,CAAC,MAAM,UAC3B,oBAAC,QAAiB,UAAQ,MACvB,kBADQ,KAEX,CACD;AAAA,SACH;AAAA;AAAA,EACF;AAEJ;","names":[]}