@agents-inc/cli 0.72.0 → 0.73.0

package/dist/chunk-V5HR77EY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/lib/__tests__/test-fixtures.ts","../src/cli/lib/__tests__/helpers.ts","../src/cli/lib/__tests__/content-generators.ts"],"sourcesContent":["import type { ResolvedSkill } from \"../../types\";\nimport { createMockSkill, createMockCategory } from \"./helpers\";\n\n// ---------------------------------------------------------------------------\n// Canonical SKILLS registry — single source of truth for all test ResolvedSkills.\n// Use SKILLS.react, SKILLS.hono etc. directly in new test code.\n// ---------------------------------------------------------------------------\n\nexport const SKILLS = {\n  // Web domain\n  react: createMockSkill(\"web-framework-react\"),\n  vue: createMockSkill(\"web-framework-vue-composition-api\"),\n  zustand: createMockSkill(\"web-state-zustand\", {\n    compatibleWith: [\"web-framework-react\"],\n  }),\n  pinia: createMockSkill(\"web-state-pinia\", {\n    compatibleWith: [\"web-framework-vue-composition-api\"],\n  }),\n  scss: createMockSkill(\"web-styling-scss-modules\"),\n  tailwind: createMockSkill(\"web-styling-tailwind\"),\n  vitest: createMockSkill(\"web-testing-vitest\"),\n  // API domain\n  hono: createMockSkill(\"api-framework-hono\"),\n  drizzle: createMockSkill(\"api-database-drizzle\"),\n  // Methodology\n  antiOverEng: createMockSkill(\"meta-methodology-anti-over-engineering\", {\n    description: \"Surgical implementation, not architectural innovation\",\n  }),\n} satisfies Record<string, ResolvedSkill>;\n\n// ---------------------------------------------------------------------------\n// Shared base category fixtures — canonical defaults with no overrides.\n// Use spread for per-test customization: `{ ...TEST_CATEGORIES.framework, required: true }`\n// ---------------------------------------------------------------------------\n\nexport const TEST_CATEGORIES = {\n  // Web domain\n  framework: createMockCategory(\"web-framework\", \"Framework\"),\n  clientState: createMockCategory(\"web-client-state\", \"Client State\"),\n  styling: createMockCategory(\"web-styling\", \"Styling\"),\n  testing: createMockCategory(\"web-testing\", \"Testing\"),\n  serverState: createMockCategory(\"web-server-state\", \"Server State\"),\n  animation: createMockCategory(\"web-animation\", \"Animation\"),\n  accessibility: createMockCategory(\"web-accessibility\", \"Accessibility\"),\n  // API domain\n  api: createMockCategory(\"api-api\", \"Backend Framework\"),\n  database: createMockCategory(\"api-database\", \"Database\"),\n  observability: createMockCategory(\"api-observability\", \"Observability\"),\n  // Shared domain\n  methodology: createMockCategory(\"shared-methodology\", \"Methodology\"),\n  tooling: createMockCategory(\"shared-tooling\", \"Tooling\"),\n  security: createMockCategory(\"shared-security\", \"Security\"),\n  // CLI domain\n  cliFramework: createMockCategory(\"cli-framework\", \"CLI Framework\"),\n  // Mobile domain\n  mobileFramework: createMockCategory(\"mobile-framework\", \"Mobile Framework\"),\n};\n","import path from \"path\";\nimport { fileURLToPath } from \"url\";\nimport { mkdir, writeFile, readFile } from \"fs/promises\";\nimport { parse as parseYaml, stringify as stringifyYaml } from \"yaml\";\nimport { run, Errors } from \"@oclif/core\";\nimport ansis from \"ansis\";\nimport { createJiti } from \"jiti\";\nimport {\n  CLAUDE_DIR,\n  CLAUDE_SRC_DIR,\n  DEFAULT_PLUGIN_NAME,\n  PLUGINS_SUBDIR,\n  STANDARD_DIRS,\n  STANDARD_FILES,\n} from \"../../consts\";\nimport { matrix } from \"../matrix/matrix-provider\";\nimport { typedEntries } from \"../../utils/typed-object\";\nimport { computeSkillFolderHash } from \"../versioning\";\nimport { renderSkillMd, renderAgentYaml, renderConfigTs } from \"./content-generators\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nexport const CLI_ROOT = path.resolve(__dirname, \"../../../..\");\n\n/** Resolve @agents-inc/cli/config to the source config-exports.ts so jiti can load it in dev. */\nconst CONFIG_EXPORTS_PATH = path.resolve(__dirname, \"../../config-exports.ts\");\n\n/**\n * Run a CLI command and capture its output.\n *\n * Bun's `console.log` does not go through `process.stdout.write`, so\n * `@oclif/test`'s `runCommand` (which only intercepts `process.stdout.write`)\n * returns empty stdout/stderr in bun. This helper intercepts both layers\n * to work correctly in both Node.js and bun environments.\n */\nexport async function runCliCommand(args: string[]) {\n  const origStdoutWrite = process.stdout.write;\n  const origStderrWrite = process.stderr.write;\n  const origLog = console.log;\n  const origWarn = console.warn;\n  const origError = console.error;\n\n  const stdoutBuf: string[] = [];\n  const stderrBuf: string[] = [];\n\n  // Intercept process.stdout/stderr.write (Node.js path)\n  process.stdout.write = function (str: unknown, encoding?: unknown, cb?: unknown): boolean {\n    stdoutBuf.push(String(str));\n    if (typeof encoding === \"function\") {\n      (encoding as () => void)();\n    } else if (typeof cb === \"function\") {\n      (cb as () => void)();\n    }\n    return true;\n  } as typeof process.stdout.write;\n\n  process.stderr.write = function (str: unknown, encoding?: unknown, cb?: unknown): boolean {\n    stderrBuf.push(String(str));\n    if (typeof encoding === \"function\") {\n      (encoding as () => void)();\n    } else if (typeof cb === \"function\") {\n      (cb as () => void)();\n    }\n    return true;\n  } as typeof process.stderr.write;\n\n  // Intercept console methods (bun path — console.log bypasses process.stdout.write)\n  console.log = (...logArgs: unknown[]) => {\n    stdoutBuf.push(logArgs.map(String).join(\" \") + \"\\n\");\n  };\n  console.warn = (...warnArgs: unknown[]) => {\n    stderrBuf.push(warnArgs.map(String).join(\" \") + \"\\n\");\n  };\n  console.error = (...errArgs: unknown[]) => {\n    stderrBuf.push(errArgs.map(String).join(\" \") + \"\\n\");\n  };\n\n  let error: (Error & Partial<Errors.CLIError>) | undefined;\n  try {\n    await run(args, { root: CLI_ROOT });\n  } catch (e) {\n    if (e instanceof Error) {\n      error = Object.assign(e, { message: ansis.strip(e.message) }) as Error &\n        Partial<Errors.CLIError>;\n    }\n  } finally {\n    process.stdout.write = origStdoutWrite;\n    process.stderr.write = origStderrWrite;\n    console.log = origLog;\n    console.warn = origWarn;\n    console.error = origError;\n  }\n\n  return {\n    stdout: stdoutBuf.map((s) => ansis.strip(s)).join(\"\"),\n    stderr: stderrBuf.map((s) => ansis.strip(s)).join(\"\"),\n    error,\n  };\n}\nimport type {\n  AgentConfig,\n  AgentDefinition,\n  AgentName,\n  AgentScopeConfig,\n  CategoryDefinition,\n  CategoryPath,\n  CompiledAgentData,\n  CompileAgentConfig,\n  CompileConfig,\n  CompileContext,\n  Domain,\n  DomainSelections,\n  ExtractedSkillMetadata,\n  Marketplace,\n  MarketplacePlugin,\n  MergedSkillsMatrix,\n  ProjectConfig,\n  ResolvedSkill,\n  ResolvedStack,\n  Skill,\n  SkillAssignment,\n  SkillConfig,\n  SkillDefinition,\n  SkillSlug,\n  SkillSlugMap,\n  SkillId,\n  SkillSource,\n  SkillSourceType,\n  RelationshipDefinitions,\n  RawStacksConfig,\n  Stack,\n  StackAgentConfig,\n  Category,\n} from \"../../types\";\nimport type { CompiledStackPlugin } from \"../stacks/stack-plugin-compiler\";\nimport type { WizardResultV2 } from \"../../components/wizard/wizard\";\nimport type { SourceLoadResult } from \"../loading/source-loader\";\nimport type { ResolvedConfig } from \"../configuration/config\";\nimport { useWizardStore } from \"../../stores/wizard-store\";\nimport { resolveAlias, validateSelection } from \"../matrix\";\nimport type { TestProjectConfig, TestSkill } from \"./fixtures/create-test-source\";\nimport { SKILLS, TEST_CATEGORIES } from \"./test-fixtures\";\n\nexport { fileExists, directoryExists } from \"./test-fs-utils\";\n\nexport async function readTestYaml<T>(filePath: string): Promise<T> {\n  const content = await readFile(filePath, \"utf-8\");\n  // Boundary cast: YAML parse returns `unknown`, caller provides expected type\n  return parseYaml(content) as T;\n}\n\n/**\n * Load a config file using jiti. Handles defineConfig(), satisfies, and plain exports.\n */\nexport async function readTestTsConfig<T>(filePath: string): Promise<T> {\n  const jiti = createJiti(import.meta.url, {\n    moduleCache: false,\n    interopDefault: true,\n    alias: { \"@agents-inc/cli/config\": CONFIG_EXPORTS_PATH },\n  });\n  // Boundary cast: jiti returns unknown, caller provides expected type\n  const result = await jiti.import(filePath, { default: true });\n  return result as T;\n}\n\n/** Writes a config file with the given object into the given subdirectory (defaults to CLAUDE_SRC_DIR) */\nexport async function writeTestTsConfig(\n  projectDir: string,\n  config: Record<string, unknown>,\n  configSubdir: string = CLAUDE_SRC_DIR,\n): Promise<void> {\n  const configDir = path.join(projectDir, configSubdir);\n  await mkdir(configDir, { recursive: true });\n  await writeFile(path.join(configDir, STANDARD_FILES.CONFIG_TS), renderConfigTs(config));\n}\n\nexport function buildSourceConfig(overrides?: Record<string, unknown>): Record<string, unknown> {\n  return {\n    source: \"github:test-org/skills\",\n    ...overrides,\n  };\n}\n\nexport function buildProjectConfig(overrides?: Partial<ProjectConfig>): ProjectConfig {\n  return {\n    name: \"test-project\",\n    agents: [{ name: \"web-developer\", scope: \"project\" }],\n    skills: buildSkillConfigs([\"web-framework-react\"]),\n    ...overrides,\n  };\n}\n\nexport function buildWizardResult(\n  skills: SkillConfig[],\n  overrides?: Partial<WizardResultV2>,\n): WizardResultV2 {\n  return {\n    skills,\n    selectedAgents: [],\n    agentConfigs: [],\n    selectedStackId: null,\n    domainSelections: {} as DomainSelections,\n    selectedDomains: [],\n    cancelled: false,\n    validation: { valid: true, errors: [], warnings: [] },\n    ...overrides,\n  };\n}\n\n/** Build a SkillConfig array from skill IDs with default scope and source */\nexport function buildSkillConfigs(\n  skillIds: SkillId[],\n  overrides?: Partial<Omit<SkillConfig, \"id\">>,\n): SkillConfig[] {\n  return skillIds.map((id) => ({\n    id,\n    scope: overrides?.scope ?? \"project\",\n    source: overrides?.source ?? \"local\",\n  }));\n}\n\nexport function buildAgentConfigs(\n  agentNames: string[],\n  overrides?: Partial<Omit<AgentScopeConfig, \"name\">>,\n): AgentScopeConfig[] {\n  return agentNames.map((name) => ({\n    // Boundary cast: test factory accepts arbitrary agent names for test isolation\n    name: name as AgentName,\n    scope: overrides?.scope ?? \"project\",\n  }));\n}\n\nexport function buildSourceResult(\n  matrix: MergedSkillsMatrix,\n  sourcePath: string,\n  overrides?: Partial<SourceLoadResult>,\n): SourceLoadResult {\n  const sourceConfig: ResolvedConfig = {\n    source: sourcePath,\n    sourceOrigin: \"flag\",\n  };\n  return {\n    matrix,\n    sourceConfig,\n    sourcePath,\n    isLocal: true,\n    ...overrides,\n  };\n}\n\n/**\n * Lightweight frontmatter parser for test assertions.\n * Returns raw key-value pairs (unlike the production parseFrontmatter which\n * returns typed SkillFrontmatter with Zod validation).\n */\nexport function parseTestFrontmatter(content: string): Record<string, unknown> | null {\n  if (!content.startsWith(\"---\")) {\n    return null;\n  }\n\n  const endIndex = content.indexOf(\"---\", 3);\n  if (endIndex === -1) {\n    return null;\n  }\n\n  const yamlContent = content.slice(3, endIndex).trim();\n  try {\n    // Boundary cast: YAML parse returns `unknown`\n    return parseYaml(yamlContent) as Record<string, unknown>;\n  } catch {\n    return null;\n  }\n}\n\nimport { createTempDir, cleanupTempDir } from \"./test-fs-utils\";\nexport { createTempDir, cleanupTempDir };\n\nexport interface PluginTestDirs {\n  tempDir: string;\n  projectDir: string;\n  pluginDir: string;\n  skillsDir: string;\n  agentsDir: string;\n}\n\nexport async function createTestDirs(prefix = \"ai-test-\"): Promise<PluginTestDirs> {\n  const tempDir = await createTempDir(prefix);\n  const projectDir = path.join(tempDir, \"project\");\n  const pluginDir = path.join(projectDir, CLAUDE_DIR, PLUGINS_SUBDIR, DEFAULT_PLUGIN_NAME);\n  const skillsDir = path.join(pluginDir, STANDARD_DIRS.SKILLS);\n  const agentsDir = path.join(pluginDir, \"agents\");\n\n  await mkdir(skillsDir, { recursive: true });\n  await mkdir(agentsDir, { recursive: true });\n\n  return { tempDir, projectDir, pluginDir, skillsDir, agentsDir };\n}\n\nexport async function cleanupTestDirs(dirs: PluginTestDirs): Promise<void> {\n  await cleanupTempDir(dirs.tempDir);\n}\n\n/**\n * Canonical category for known test skills.\n * createMockSkill() looks up from here when no category override is provided.\n * Custom/novel skills must pass { category } in overrides.\n *\n * Uses a lazy singleton to avoid circular initialization issues:\n * test-fixtures.ts calls createMockSkill() at module level during import,\n * and ESM hoists all imports before evaluating any `const` declarations.\n */\n// eslint-disable-next-line no-var -- `var` avoids TDZ in circular ESM imports (let/const would throw)\n// Boundary cast: test factory maps arbitrary skill IDs to category strings (not all are valid Category union members)\nvar _canonicalSkillCategories: Record<string, string> | undefined;\nfunction getCanonicalSkillCategories(): Record<string, string> {\n  if (!_canonicalSkillCategories) {\n    _canonicalSkillCategories = {\n      \"web-framework-react\": \"web-framework\",\n      \"web-framework-vue-composition-api\": \"web-framework\",\n      \"web-framework-original\": \"web-framework\",\n      \"web-framework-simple\": \"web-framework\",\n      \"web-framework-arbitrary\": \"web-framework\",\n      \"web-framework-unknown\": \"web-framework\",\n      \"web-styling-tailwind\": \"web-styling\",\n      \"web-styling-scss-modules\": \"web-styling\",\n      \"web-styling-custom\": \"web-styling\",\n      \"web-state-zustand\": \"web-client-state\",\n      \"web-state-pinia\": \"web-client-state\",\n      \"web-state-mobx\": \"web-client-state\",\n      \"web-testing-vitest\": \"web-testing\",\n      \"web-testing-copier\": \"web-testing\",\n      \"web-testing-metadata\": \"web-testing\",\n      \"web-testing-playwright\": \"web-testing\",\n      \"web-testing-cypress-e2e\": \"web-testing\",\n      \"web-testing-playwright-e2e\": \"web-testing\",\n      \"web-server-state-react-query\": \"web-server-state\",\n      \"web-data-fetching-react-query\": \"web-server-state\",\n      \"web-tooling-vite\": \"shared-tooling\",\n      \"web-tooling-acme\": \"web-tooling\",\n      \"web-tooling-custom\": \"web-tooling\",\n      \"web-tooling-nometadata\": \"web-tooling\",\n      \"web-tooling-personal\": \"web-tooling\",\n      \"web-tooling-valid\": \"web-tooling\",\n      \"web-tooling-incomplete\": \"web-tooling\",\n      \"web-tooling-my-skill\": \"web-tooling\",\n      \"web-tooling-forked-skill\": \"web-tooling\",\n      \"web-tooling-test-minimal\": \"web-tooling\",\n      \"web-tooling-local-skill\": \"web-tooling\",\n      \"web-skill-a\": \"web-framework\",\n      \"web-skill-a-v\": \"web-framework\",\n      \"web-skill-b\": \"web-framework\",\n      \"web-skill-b-v\": \"web-framework\",\n      \"web-skill-c\": \"web-framework\",\n      \"web-skill-d\": \"web-framework\",\n      \"web-skill-setup\": \"web-framework\",\n      \"web-skill-usage\": \"web-framework\",\n      \"web-local-skill\": \"local\",\n      \"web-custom-skill\": \"web-framework\",\n      \"web-missing-skill\": \"web-framework\",\n      \"web-unknown-skill\": \"web-framework\",\n      \"web-nonexistent-skill\": \"web-framework\",\n      \"api-framework-hono\": \"api-api\",\n      \"api-framework-express\": \"api-api\",\n      \"api-database-drizzle\": \"api-database\",\n      \"api-security-auth-patterns\": \"api-security\",\n      \"api-observability-datadog\": \"api-observability\",\n      \"cli-framework-commander\": \"cli-framework\",\n      \"infra-setup-env\": \"shared-tooling\",\n      \"infra-tooling-linter\": \"unmapped-category\",\n      \"infra-tooling-docker\": \"shared-tooling\",\n      \"infra-ci-cd-github-actions\": \"shared-ci-cd\",\n      \"infra-ci-cd-gitlab-ci\": \"shared-ci-cd\",\n      \"web-accessibility-a11y\": \"web-accessibility\",\n      \"web-animation-framer\": \"web-animation\",\n      \"meta-methodology-investigation\": \"shared-methodology\",\n      \"meta-methodology-success-criteria\": \"shared-methodology\",\n      \"meta-methodology-investigation-requirements\": \"shared-methodology\",\n      \"meta-methodology-anti-over-engineering\": \"shared-methodology\",\n      \"meta-methodology-write-verification\": \"shared-methodology\",\n      \"meta-methodology-improvement-protocol\": \"shared-methodology\",\n      \"meta-methodology-context-management\": \"shared-methodology\",\n      \"meta-company-patterns\": \"local\",\n      \"meta-test-skill\": \"shared-methodology\",\n      \"web-framework-nonexistent\": \"web-framework\",\n      \"web-framework-react-pro\": \"web-framework\",\n      \"web-framework-react-strict\": \"web-framework\",\n      \"web-framework-react-minimal\": \"web-framework\",\n    };\n  }\n  return _canonicalSkillCategories;\n}\n\n/** Maps non-domain SkillIdPrefix values to their corresponding Domain */\nconst DOMAIN_PREFIX_MAP: Record<string, Domain> = {\n  meta: \"shared\",\n  infra: \"shared\",\n  security: \"shared\",\n};\n\n/**\n * Creates a TestSkill for disk-based integration tests (createTestSource).\n * Derives slug, displayName, domain, and category from the skill ID,\n * using the canonical category registry for correct category mapping.\n */\nexport function createTestSkill(\n  id: SkillId,\n  description: string,\n  overrides?: Partial<TestSkill>,\n): TestSkill {\n  const segments = id.split(\"-\");\n  const rawPrefix = segments[0] ?? \"web\";\n  const domain = (DOMAIN_PREFIX_MAP[rawPrefix] ?? rawPrefix) as Domain;\n  const canonicalCategories = getCanonicalSkillCategories();\n  // Boundary cast: category registry returns arbitrary strings for non-canonical IDs\n  const category = (canonicalCategories[id] ?? `${segments[0]}-${segments[1]}`) as CategoryPath;\n  const slug = (segments.length >= 3 ? segments.slice(2).join(\"-\") : id) as SkillSlug;\n  const displayName = slug\n    .split(\"-\")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n\n  return {\n    id,\n    slug,\n    displayName,\n    description,\n    category,\n    author: \"@test\",\n    domain,\n    tags: [],\n    ...overrides,\n  };\n}\n\nexport function createMockSkill(id: SkillId, overrides?: Partial<ResolvedSkill>): ResolvedSkill {\n  // Boundary cast: category registry returns arbitrary strings for non-canonical IDs\n  const category = (overrides?.category ?? getCanonicalSkillCategories()[id]) as\n    | CategoryPath\n    | undefined;\n\n  if (!category) {\n    throw new Error(\n      `createMockSkill: \"${id}\" not in canonical registry — provide { category } in overrides`,\n    );\n  }\n\n  // Derive slug from skill ID: strip domain-category prefix to get the last segment(s)\n  // e.g., \"web-framework-react\" -> \"react\", \"meta-methodology-anti-over-engineering\" -> \"anti-over-engineering\"\n  const segments = id.split(\"-\");\n  const defaultSlug = (segments.length >= 3 ? segments.slice(2).join(\"-\") : id) as SkillSlug;\n\n  // Derive display name from slug: title-case each segment\n  const defaultDisplayName = defaultSlug\n    .split(\"-\")\n    .map((word) => word.charAt(0).toUpperCase() + word.slice(1))\n    .join(\" \");\n\n  return {\n    id,\n    slug: defaultSlug,\n    displayName: defaultDisplayName,\n    description: `${id} skill`,\n    category,\n    tags: [],\n    author: \"@test\",\n    conflictsWith: [],\n    isRecommended: false,\n    requires: [],\n    alternatives: [],\n    discourages: [],\n    compatibleWith: [],\n    path: `skills/${category}/${id}/`,\n    ...overrides,\n  };\n}\n\nexport function createMockSkillSource(\n  type: SkillSourceType,\n  overrides?: Partial<SkillSource>,\n): SkillSource {\n  const defaults: Record<SkillSourceType, SkillSource> = {\n    public: { name: \"public\", type: \"public\", installed: false },\n    private: {\n      name: \"private-source\",\n      type: \"private\",\n      url: \"github:org/skills\",\n      installed: false,\n    },\n    local: { name: \"local\", type: \"local\", installed: true, installMode: \"local\" },\n  };\n  return { ...defaults[type], ...overrides };\n}\n\n/**\n * Creates a mock ExtractedSkillMetadata for testing.\n * Used when mocking extractAllSkills() return values.\n */\nexport function createMockExtractedSkill(\n  id: SkillId,\n  overrides?: Partial<ExtractedSkillMetadata>,\n): ExtractedSkillMetadata {\n  // Derive directory path and category from the skill ID convention: \"domain-category-name\"\n  const segments = id.split(\"-\");\n  const domain = segments[0] ?? \"web\";\n  const category = segments[1] ?? \"framework\";\n  const name = segments.slice(2).join(\"-\") || \"skill\";\n  const directoryPath = `${domain}/${category}/${name}`;\n\n  return {\n    id,\n    directoryPath,\n    description: `${id} skill`,\n    category: `${domain}-${category}` as CategoryPath,\n    author: \"@test\",\n    tags: [],\n    path: `skills/${directoryPath}/`,\n    domain: domain as Domain,\n    displayName: name,\n    slug: name as SkillSlug,\n    ...overrides,\n  };\n}\n\nexport function createMockMatrix(\n  skillsOrFirstSkill?: Record<string, ResolvedSkill> | ResolvedSkill,\n  ...rest: (ResolvedSkill | Partial<MergedSkillsMatrix>)[]\n): MergedSkillsMatrix {\n  let skillsRecord: Record<string, ResolvedSkill>;\n  let overrides: Partial<MergedSkillsMatrix> | undefined;\n\n  if (skillsOrFirstSkill === undefined) {\n    // Empty call: createMockMatrix()\n    skillsRecord = {};\n  } else if (\n    \"id\" in skillsOrFirstSkill &&\n    typeof (skillsOrFirstSkill as ResolvedSkill).id === \"string\" &&\n    \"slug\" in skillsOrFirstSkill\n  ) {\n    // New spread syntax: createMockMatrix(skill1, skill2, ..., optionalOverrides?)\n    const allArgs = [skillsOrFirstSkill, ...rest];\n    const lastArg = allArgs[allArgs.length - 1];\n\n    // Detect if last arg is overrides (has no 'id' + 'slug' properties)\n    if (lastArg && !(\"id\" in lastArg && \"slug\" in lastArg)) {\n      overrides = lastArg as Partial<MergedSkillsMatrix>;\n      const skills = allArgs.slice(0, -1) as ResolvedSkill[];\n      skillsRecord = {};\n      for (const skill of skills) {\n        skillsRecord[skill.id] = skill;\n      }\n    } else {\n      const skills = allArgs as ResolvedSkill[];\n      skillsRecord = {};\n      for (const skill of skills) {\n        skillsRecord[skill.id] = skill;\n      }\n    }\n  } else {\n    // Old record syntax: createMockMatrix({ \"id\": skill }, overrides?)\n    skillsRecord = skillsOrFirstSkill as Record<string, ResolvedSkill>;\n    overrides = rest[0] as Partial<MergedSkillsMatrix> | undefined;\n  }\n\n  // Boundary cast: empty objects are populated in the loop below\n  const autoSlugToId = {} as Record<SkillSlug, SkillId>;\n  const autoIdToSlug = {} as Record<SkillId, SkillSlug>;\n  for (const [, skill] of typedEntries(skillsRecord)) {\n    if (skill.slug) {\n      autoSlugToId[skill.slug] = skill.id;\n      autoIdToSlug[skill.id] = skill.slug;\n    }\n  }\n\n  return {\n    version: \"1.0.0\",\n    categories: {} as Record<Category, import(\"../../types\").CategoryDefinition>,\n    skills: skillsRecord,\n    suggestedStacks: [],\n    slugMap: { slugToId: autoSlugToId, idToSlug: autoIdToSlug },\n    generatedAt: new Date().toISOString(),\n    ...overrides,\n  };\n}\n\nexport function createMockAgent(\n  name: string,\n  overrides?: Partial<AgentDefinition>,\n): AgentDefinition {\n  return {\n    title: name,\n    description: `${name} agent`,\n    tools: [\"Read\", \"Write\", \"Edit\", \"Grep\", \"Glob\", \"Bash\"],\n    model: \"opus\",\n    permissionMode: \"default\",\n    ...overrides,\n  };\n}\n\nexport function createMockAgentConfig(\n  name: string,\n  skills: Skill[] = [],\n  overrides?: Partial<AgentConfig>,\n): AgentConfig {\n  return {\n    name,\n    title: `${name} agent`,\n    description: `Test ${name}`,\n    tools: [\"Read\", \"Write\"],\n    skills,\n    path: name,\n    ...overrides,\n  };\n}\n\nexport function createMockSkillEntry(\n  id: SkillId,\n  preloaded = false,\n  overrides?: Partial<Skill>,\n): Skill {\n  return {\n    id,\n    path: `skills/${id}/`,\n    description: `${id} skill`,\n    usage: `when working with ${id}`,\n    preloaded,\n    ...overrides,\n  };\n}\n\nexport function createCompileContext(overrides?: Partial<CompileContext>): CompileContext {\n  return {\n    stackId: \"test-stack\",\n    verbose: false,\n    projectRoot: \"/project\",\n    outputDir: `/project/${CLAUDE_DIR}/${PLUGINS_SUBDIR}/${DEFAULT_PLUGIN_NAME}`,\n    ...overrides,\n  };\n}\n\nexport async function writeTestSkill(\n  skillsDir: string,\n  skillId: SkillId,\n  options?: {\n    /** Extra fields to merge into metadata.yaml (e.g., forkedFrom, displayName) */\n    extraMetadata?: Record<string, unknown>;\n    /** Skip metadata.yaml creation entirely */\n    skipMetadata?: boolean;\n    /** Custom SKILL.md content (overrides default generated content) */\n    skillContent?: string;\n  },\n): Promise<string> {\n  const skill = matrix.skills[skillId];\n\n  if (!options?.skipMetadata && !skill) {\n    throw new Error(\n      `writeTestSkill: \"${skillId}\" not found in matrix store — populate the store in beforeEach`,\n    );\n  }\n\n  const skillDir = path.join(skillsDir, skillId);\n  await mkdir(skillDir, { recursive: true });\n\n  await writeFile(\n    path.join(skillDir, STANDARD_FILES.SKILL_MD),\n    options?.skillContent ?? renderSkillMd(skillId, skill?.description),\n  );\n\n  if (!options?.skipMetadata && skill) {\n    const { slug, category, author } = skill;\n    const domain = category.split(\"-\")[0];\n\n    const contentHash = await computeSkillFolderHash(skillDir);\n    const baseMetadata = {\n      author,\n      category,\n      domain,\n      slug,\n      contentHash,\n    };\n    await writeFile(\n      path.join(skillDir, STANDARD_FILES.METADATA_YAML),\n      stringifyYaml({ ...baseMetadata, ...options?.extraMetadata }),\n    );\n  }\n\n  return skillDir;\n}\n\n/**\n * Creates a source-level skill directory with SKILL.md and rich metadata.yaml.\n * Use this when testing `extractAllSkills()` and `mergeMatrixWithSkills()`.\n *\n * Unlike `writeTestSkill()` which creates installed skills, this writes skills\n * in the source directory layout (under `src/skills/<domain>/<category>/<name>/`).\n */\nexport async function writeSourceSkill(\n  skillsDir: string,\n  directoryPath: string,\n  config: TestSkill,\n): Promise<string> {\n  const skillDir = path.join(skillsDir, directoryPath);\n  await mkdir(skillDir, { recursive: true });\n\n  await writeFile(\n    path.join(skillDir, STANDARD_FILES.SKILL_MD),\n    renderSkillMd(config.id, config.description),\n  );\n\n  const domain = config.domain;\n  const slug = config.slug;\n  const metadata: Record<string, unknown> = {\n    displayName: config.id,\n    slug,\n    category: config.category,\n    domain,\n    author: config.author ?? \"@test\",\n    ...(config.tags && { tags: config.tags }),\n  };\n\n  await writeFile(path.join(skillDir, STANDARD_FILES.METADATA_YAML), stringifyYaml(metadata));\n\n  return skillDir;\n}\n\nexport async function writeTestAgent(\n  agentsDir: string,\n  agentName: string,\n  options?: { description?: string },\n): Promise<string> {\n  const agentDir = path.join(agentsDir, agentName);\n  await mkdir(agentDir, { recursive: true });\n\n  await writeFile(\n    path.join(agentDir, STANDARD_FILES.AGENT_METADATA_YAML),\n    renderAgentYaml(agentName, options?.description),\n  );\n\n  return agentDir;\n}\n\nexport function createMockCategory(\n  id: string,\n  displayName: string,\n  overrides?: Partial<CategoryDefinition>,\n): CategoryDefinition {\n  // Boundary cast: test factory accepts arbitrary category IDs for test isolation\n  return {\n    id: id as Category,\n    displayName,\n    description: `${displayName} category`,\n    domain: \"web\",\n    exclusive: true,\n    required: false,\n    order: 0,\n    ...overrides,\n  };\n}\n\nexport function createMockResolvedStack(\n  id: string,\n  name: string,\n  overrides?: Partial<ResolvedStack>,\n): ResolvedStack {\n  return {\n    id,\n    name,\n    description: `${name} stack`,\n    skills: {},\n    allSkillIds: [],\n    philosophy: \"\",\n    ...overrides,\n  };\n}\n\n/**\n * Builds a comprehensive test matrix with 8 skills across 7 categories,\n * 2 suggested stacks, display name mappings, and relationship data\n * (conflicts, recommends). Includes anti-over-engineering methodology skill.\n * @returns A fully populated MergedSkillsMatrix with realistic test data\n */\nexport function createComprehensiveMatrix(\n  overrides?: Partial<MergedSkillsMatrix>,\n): MergedSkillsMatrix {\n  // Skill categories use domain-prefixed Category IDs (matching production\n  // metadata.yaml and the categories map keys, e.g., \"web-framework\", \"api-api\").\n  const skills = {\n    \"web-framework-react\": SKILLS.react,\n    \"web-framework-vue-composition-api\": {\n      ...SKILLS.vue,\n      conflictsWith: [{ skillId: \"web-framework-react\", reason: \"Choose one framework\" }],\n    } satisfies ResolvedSkill,\n    \"web-state-zustand\": SKILLS.zustand,\n    \"web-styling-scss-modules\": SKILLS.scss,\n    \"api-framework-hono\": SKILLS.hono,\n    \"api-database-drizzle\": SKILLS.drizzle,\n    \"web-testing-vitest\": SKILLS.vitest,\n    // Methodology skill\n    \"meta-methodology-anti-over-engineering\": SKILLS.antiOverEng,\n  };\n\n  const categories = {\n    \"web-framework\": {\n      ...TEST_CATEGORIES.framework,\n      domain: \"web\",\n      exclusive: true,\n      required: true,\n    },\n    \"web-client-state\": { ...TEST_CATEGORIES.clientState, domain: \"web\", order: 1 },\n    \"web-styling\": { ...TEST_CATEGORIES.styling, domain: \"web\", order: 2 },\n    \"api-api\": { ...TEST_CATEGORIES.api, domain: \"api\", exclusive: true, required: true },\n    \"api-database\": { ...TEST_CATEGORIES.database, domain: \"api\", order: 1 },\n    \"web-testing\": {\n      ...TEST_CATEGORIES.testing,\n      domain: \"shared\",\n      exclusive: false,\n      order: 10,\n    },\n    \"shared-methodology\": {\n      ...TEST_CATEGORIES.methodology,\n      domain: \"shared\",\n      exclusive: false,\n      required: false,\n      order: 11,\n    },\n  } as Record<Category, CategoryDefinition>;\n\n  const suggestedStacks: ResolvedStack[] = [\n    createMockResolvedStack(\"nextjs-fullstack\", \"Next.js Fullstack\", {\n      description: \"Complete Next.js stack with React and Hono\",\n      skills: {\n        \"web-developer\": {\n          \"web-framework\": [\"web-framework-react\"],\n          \"web-client-state\": [\"web-state-zustand\"],\n          \"web-styling\": [\"web-styling-scss-modules\"],\n        },\n        \"api-developer\": {\n          \"api-api\": [\"api-framework-hono\"],\n          \"api-database\": [\"api-database-drizzle\"],\n        },\n      } as ResolvedStack[\"skills\"],\n      allSkillIds: [\n        \"web-framework-react\",\n        \"web-state-zustand\",\n        \"web-styling-scss-modules\",\n        \"api-framework-hono\",\n        \"api-database-drizzle\",\n      ],\n      philosophy: \"Modern, type-safe fullstack development\",\n    }),\n    createMockResolvedStack(\"vue-stack\", \"Vue Stack\", {\n      description: \"Vue.js frontend stack\",\n      skills: {\n        \"web-developer\": {\n          \"web-framework\": [\"web-framework-vue-composition-api\"],\n        },\n      } as ResolvedStack[\"skills\"],\n      allSkillIds: [\"web-framework-vue-composition-api\"],\n      philosophy: \"Progressive framework approach\",\n    }),\n  ];\n\n  // Boundary cast: test matrix only contains a subset of all possible slugs\n  const slugToId = {\n    react: \"web-framework-react\",\n    \"vue-composition-api\": \"web-framework-vue-composition-api\",\n    zustand: \"web-state-zustand\",\n    \"scss-modules\": \"web-styling-scss-modules\",\n    hono: \"api-framework-hono\",\n    drizzle: \"api-database-drizzle\",\n    vitest: \"web-testing-vitest\",\n    \"anti-over-engineering\": \"meta-methodology-anti-over-engineering\",\n  } as unknown as Record<SkillSlug, SkillId>;\n\n  // Boundary cast: Object.fromEntries returns { [k: string]: string }\n  const idToSlug = Object.fromEntries(\n    typedEntries(slugToId).map(([slug, fullId]) => [fullId, slug]),\n  ) as SkillSlugMap[\"idToSlug\"];\n\n  return createMockMatrix(skills, {\n    categories,\n    suggestedStacks,\n    slugMap: { slugToId, idToSlug },\n    ...overrides,\n  });\n}\n\n/**\n * Builds a lightweight test matrix with 5 skills, 5 categories, and 2 stacks.\n * Use instead of createComprehensiveMatrix when relationship data is not needed.\n * @returns A minimal MergedSkillsMatrix for basic integration tests\n */\nexport function createBasicMatrix(overrides?: Partial<MergedSkillsMatrix>): MergedSkillsMatrix {\n  // Domain-prefixed Category IDs — see createComprehensiveMatrix comment\n  const skills = {\n    \"web-framework-react\": SKILLS.react,\n    \"web-state-zustand\": SKILLS.zustand,\n    \"api-framework-hono\": SKILLS.hono,\n    \"web-testing-vitest\": SKILLS.vitest,\n    // Methodology skill\n    \"meta-methodology-anti-over-engineering\": SKILLS.antiOverEng,\n  };\n\n  const suggestedStacks: ResolvedStack[] = [\n    createMockResolvedStack(\"react-fullstack\", \"React Fullstack\", {\n      allSkillIds: [\"web-framework-react\", \"web-state-zustand\", \"api-framework-hono\"],\n    }),\n    createMockResolvedStack(\"testing-stack\", \"Testing Stack\", {\n      allSkillIds: [\"web-testing-vitest\"],\n    }),\n  ];\n\n  return createMockMatrix(skills, {\n    suggestedStacks,\n    categories: {\n      \"web-framework\": {\n        ...TEST_CATEGORIES.framework,\n        domain: \"web\",\n        exclusive: true,\n        required: true,\n      },\n      \"web-client-state\": { ...TEST_CATEGORIES.clientState, domain: \"web\", order: 1 },\n      \"api-api\": {\n        ...TEST_CATEGORIES.api,\n        domain: \"api\",\n        exclusive: true,\n        required: true,\n      },\n      \"web-testing\": {\n        ...TEST_CATEGORIES.testing,\n        displayName: \"Testing Framework\",\n        domain: \"shared\",\n        exclusive: false,\n      },\n      \"shared-methodology\": {\n        ...TEST_CATEGORIES.methodology,\n        domain: \"shared\",\n        exclusive: false,\n        required: false,\n      },\n    } as Record<Category, CategoryDefinition>,\n    ...overrides,\n  });\n}\n\n/**\n * Replicates `handleComplete` from wizard.tsx for the \"customize\" path.\n *\n * Given the wizard store state (after simulated user selections), this\n * builds the same WizardResultV2 that the real wizard produces:\n * 1. Collects all selected technologies from domainSelections\n * 2. Resolves aliases to canonical skill IDs\n * 3. Runs validation\n */\nexport function buildWizardResultFromStore(\n  matrix: MergedSkillsMatrix,\n  overrides?: Partial<WizardResultV2>,\n): WizardResultV2 {\n  const store = useWizardStore.getState();\n\n  let allSkills: SkillId[];\n\n  if (store.selectedStackId && store.stackAction === \"defaults\") {\n    const stack = matrix.suggestedStacks.find((s) => s.id === store.selectedStackId);\n    allSkills = [...(stack?.allSkillIds || [])];\n  } else {\n    const techNames = store.getAllSelectedTechnologies();\n    allSkills = techNames.map((tech) => resolveAlias(tech));\n  }\n\n  const validation = validateSelection(allSkills);\n\n  return {\n    skills: store.skillConfigs.length > 0 ? store.skillConfigs : buildSkillConfigs(allSkills),\n    selectedAgents: store.selectedAgents,\n    agentConfigs: store.agentConfigs,\n    selectedStackId: store.selectedStackId,\n    domainSelections: store.domainSelections,\n    selectedDomains: store.selectedDomains,\n    cancelled: false,\n    validation,\n    ...overrides,\n  };\n}\n\n/**\n * Simulates a user selecting specific skills via the wizard store.\n *\n * Sets up domainSelections as if the user toggled each skill in the build step,\n * using the matrix to look up the correct domain and category per skill.\n */\nexport function simulateSkillSelections(\n  skillIds: SkillId[],\n  matrix: MergedSkillsMatrix,\n  selectedDomains: string[],\n): void {\n  const domainSelections = skillIds.reduce<DomainSelections>((acc, skillId) => {\n    const skill = matrix.skills[skillId];\n    if (!skill) return acc;\n    // Boundary cast: skill.category is a Category at runtime\n    const category = skill.category as Category;\n    const domain = matrix.categories[category]?.domain;\n    if (!domain) return acc;\n    const domainObj = acc[domain] ?? {};\n    const subcatList = domainObj[category] ?? [];\n    if (subcatList.includes(skillId)) return acc;\n    return {\n      ...acc,\n      [domain]: { ...domainObj, [category]: [...subcatList, skillId] },\n    };\n  }, {});\n\n  useWizardStore.setState({\n    domainSelections,\n    selectedDomains: selectedDomains as Domain[],\n    approach: \"scratch\",\n    step: \"confirm\",\n  });\n}\n\n/**\n * Extracts skill IDs from a stack assignment value, which may be:\n * - A bare string (e.g., \"web-framework-react\")\n * - An object with .id (e.g., { id: \"web-framework-react\", preloaded: true })\n * - An array of strings or objects\n */\nexport function extractSkillIdsFromAssignment(assignment: unknown): string[] {\n  if (typeof assignment === \"string\") {\n    return [assignment];\n  }\n  if (Array.isArray(assignment)) {\n    return assignment.flatMap((item) => extractSkillIdsFromAssignment(item));\n  }\n  if (typeof assignment === \"object\" && assignment !== null && \"id\" in assignment) {\n    return [String((assignment as { id: string }).id)];\n  }\n  return [];\n}\n\nexport function buildTestProjectConfig(\n  agents: string[],\n  skills: Array<string | { id: string }>,\n  overrides?: Partial<TestProjectConfig>,\n): TestProjectConfig {\n  return {\n    name: \"test-project\",\n    description: \"Test project\",\n    agents,\n    skills,\n    ...overrides,\n  };\n}\n\nexport function createMockSkillDefinition(\n  id: SkillId,\n  overrides?: Partial<SkillDefinition>,\n): SkillDefinition {\n  return {\n    id,\n    path: `skills/${id}/`,\n    description: `${id} skill`,\n    ...overrides,\n  };\n}\n\n/** Decomposed matrix config returned by createMockMatrixConfig (replaces SkillsMatrixConfig) */\nexport type MockMatrixConfig = {\n  categories: Record<string, CategoryDefinition>;\n  relationships: RelationshipDefinitions;\n};\n\nexport function createMockMatrixConfig(\n  categories: Record<string, CategoryDefinition>,\n  overrides?: {\n    relationships?: Partial<RelationshipDefinitions>;\n  },\n): MockMatrixConfig {\n  const defaultRelationships: RelationshipDefinitions = {\n    conflicts: [],\n    discourages: [],\n    recommends: [],\n    requires: [],\n    alternatives: [],\n  };\n  return {\n    categories,\n    relationships: overrides?.relationships\n      ? { ...defaultRelationships, ...overrides.relationships }\n      : defaultRelationships,\n  };\n}\n\nexport function createMockStack(\n  id: string,\n  config: {\n    name: string;\n    description?: string;\n    agents: Record<string, StackAgentConfig>;\n    philosophy?: string;\n  },\n): Stack {\n  return {\n    id,\n    name: config.name,\n    description: config.description ?? \"\",\n    // Boundary cast: test callers may pass arbitrary agent names (e.g., \"nonexistent-agent\")\n    agents: config.agents as Stack[\"agents\"],\n    philosophy: config.philosophy,\n  };\n}\n\nexport function createMockCompileConfig(\n  agents: Record<string, CompileAgentConfig>,\n  overrides?: Partial<CompileConfig>,\n): CompileConfig {\n  return {\n    name: \"Test Plugin\",\n    description: \"Test description\",\n    agents,\n    ...overrides,\n  };\n}\n\nexport function createMockCompiledStackPlugin(\n  overrides?: Partial<CompiledStackPlugin>,\n): CompiledStackPlugin {\n  return {\n    pluginPath: \"/tmp/cc-stack-123456/test-stack\",\n    manifest: { name: \"test-stack\", version: \"1.0.0\" },\n    stackName: \"Test Stack\",\n    agents: [\"web-developer\"],\n    skillPlugins: [\"web-framework-react\"],\n    hasHooks: false,\n    ...overrides,\n  };\n}\n\nexport function createMockSkillAssignment(id: SkillId, preloaded = false): SkillAssignment {\n  return { id, preloaded };\n}\n\nexport function createMockRawStacksConfig(): RawStacksConfig {\n  return {\n    stacks: [\n      {\n        id: \"nextjs-fullstack\",\n        name: \"Next.js Fullstack\",\n        description: \"Full-stack Next.js with Hono API\",\n        agents: {\n          \"web-developer\": {\n            \"web-framework\": \"web-framework-react\",\n            \"web-styling\": \"web-styling-scss-modules\",\n          },\n          \"api-developer\": {\n            \"api-api\": \"api-framework-hono\",\n            \"api-database\": \"api-database-drizzle\",\n          },\n        },\n      },\n      {\n        id: \"vue-spa\",\n        name: \"Vue SPA\",\n        description: \"Vue single-page application\",\n        agents: {\n          \"web-developer\": {\n            \"web-framework\": \"web-framework-vue-composition-api\",\n            \"web-styling\": \"web-styling-tailwind\",\n          },\n        },\n      },\n    ],\n  };\n}\n\nexport function createMockRawStacksConfigWithArrays(): RawStacksConfig {\n  return {\n    stacks: [\n      {\n        id: \"multi-select-stack\",\n        name: \"Multi-Select Stack\",\n        description: \"Stack with array-valued categories\",\n        agents: {\n          \"web-developer\": {\n            \"web-framework\": \"web-framework-react\",\n            \"shared-methodology\": [\n              \"meta-methodology-investigation-requirements\",\n              \"meta-methodology-anti-over-engineering\",\n              \"meta-methodology-success-criteria\",\n            ],\n          },\n          \"pattern-scout\": {\n            \"shared-methodology\": [\n              \"meta-methodology-investigation-requirements\",\n              \"meta-methodology-anti-over-engineering\",\n            ],\n            \"shared-research\": \"meta-research-research-methodology\",\n          },\n        },\n      },\n    ],\n  };\n}\n\nexport function createMockRawStacksConfigWithObjects(): RawStacksConfig {\n  return {\n    stacks: [\n      {\n        id: \"object-stack\",\n        name: \"Object Stack\",\n        description: \"Stack with object-form skill assignments\",\n        agents: {\n          \"web-developer\": {\n            \"web-framework\": [{ id: \"web-framework-react\", preloaded: true }],\n            \"web-styling\": \"web-styling-scss-modules\",\n            \"shared-methodology\": [\n              { id: \"meta-methodology-investigation-requirements\", preloaded: true },\n              \"meta-methodology-anti-over-engineering\",\n            ],\n          },\n        },\n      },\n    ],\n  };\n}\n\nexport function createMockMarketplace(plugins: MarketplacePlugin[] = []): Marketplace {\n  return {\n    name: \"test-marketplace\",\n    version: \"1.0.0\",\n    owner: { name: \"Test Owner\" },\n    plugins,\n  };\n}\n\nexport function createMockMarketplacePlugin(\n  name: string,\n  source: MarketplacePlugin[\"source\"] = \"local\",\n): MarketplacePlugin {\n  return {\n    name,\n    source,\n  };\n}\n\n/** Convert a TestSkill (disk-based) to a ResolvedSkill (in-memory) for matrix creation. */\nexport function testSkillToResolvedSkill(\n  skill: TestSkill,\n  overrides?: Partial<ResolvedSkill>,\n): ResolvedSkill {\n  // Boundary cast: TestSkill.id is string, but in practice always a valid SkillId\n  return createMockSkill(skill.id as SkillId, {\n    description: skill.description,\n    ...(skill.tags?.length ? { tags: skill.tags } : {}),\n    ...overrides,\n  });\n}\n\n/**\n * Creates a ResolvedSkill with availableSources annotation for multi-source testing.\n * Simulates what multi-source-loader.ts does after tagging.\n */\nexport function createMockMultiSourceSkill(\n  id: SkillId,\n  sources: SkillSource[],\n  overrides?: Partial<ResolvedSkill>,\n): ResolvedSkill {\n  const activeSource = sources.find((s) => s.installed) ?? sources[0];\n  return createMockSkill(id, {\n    availableSources: sources,\n    activeSource,\n    ...overrides,\n  });\n}\n\nexport function createMockCompiledAgentData(overrides?: Partial<AgentConfig>): CompiledAgentData {\n  const agent = createMockAgentConfig(\"test-agent\", [], {\n    title: \"Test Agent\",\n    description: \"A test agent\",\n    ...overrides,\n  });\n\n  return {\n    agent,\n    intro: \"Test intro\",\n    workflow: \"Test workflow\",\n    examples: \"Test examples\",\n    criticalRequirementsTop: \"\",\n    criticalReminders: \"\",\n    outputFormat: \"\",\n    skills: agent.skills,\n    preloadedSkills: [],\n    dynamicSkills: [],\n    preloadedSkillIds: [],\n  };\n}\n\nexport { SKILLS, TEST_CATEGORIES } from \"./test-fixtures\";\n","/**\n * Pure content renderers for test file generation.\n * Single source of truth for all test content templates.\n */\n\nexport function renderSkillMd(id: string, description?: string, body?: string): string {\n  const desc = description ?? `${id} skill`;\n  const content = body ?? `# ${id}\\n\\n${desc}`;\n  return `---\nname: ${id}\ndescription: ${desc}\n---\n\n${content}\n`;\n}\n\nexport function renderConfigTs(config: Record<string, unknown>): string {\n  return `export default ${JSON.stringify(config, null, 2)};\\n`;\n}\n\nexport function renderAgentYaml(\n  name: string,\n  description?: string,\n  options?: { title?: string; tools?: string[] },\n): string {\n  const desc = description ?? `Test ${name} agent`;\n  const title = options?.title ?? `${name} Agent`;\n  const tools = options?.tools ?? [\"Read\", \"Write\"];\n  return `id: ${name}\ntitle: ${title}\ndescription: ${desc}\ntools:\n${tools.map((t) => `  - ${t}`).join(\"\\n\")}`;\n}\n\nexport function renderCategoriesTs(categories: Record<string, unknown>): string {\n  return renderConfigTs(categories);\n}\n\nexport function renderRulesTs(rules: Record<string, unknown>): string {\n  return renderConfigTs(rules);\n}\n"],"mappings":"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","names":["__filename","__dirname"]}

package/dist/{chunk-ZEJIEC2A.js → chunk-WJL4KU5V.js}

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+import {
+  AGENT_NAMES,
+  CATEGORIES,
+  DOMAINS,
+  SKILL_SLUGS
+} from "./chunk-SRIH4U5Y.js";
 import {
   KEBAB_CASE_PATTERN
 } from "./chunk-EGMQ3SXN.js";
@@ -112,162 +118,9 @@ async function copy(src, dest) {
   await fs.copy(src, dest);
 }
 
-// src/cli/types/generated/source-types.ts
-init_esm_shims();
-var SKILL_SLUGS = [
-  "angular-standalone",
-  "anti-over-engineering",
-  "api-performance",
-  "auth-security",
-  "axiom-pino-sentry",
-  "better-auth-drizzle-hono",
-  "cli-commander",
-  "cli-reviewing",
-  "context-management",
-  "css-animations",
-  "cva",
-  "cypress-e2e",
-  "date-fns",
-  "drizzle",
-  "error-boundaries",
-  "expo",
-  "express",
-  "fastify",
-  "file-upload-patterns",
-  "framer-motion",
-  "github-actions",
-  "graphql-apollo",
-  "graphql-urql",
-  "hono",
-  "image-handling",
-  "improvement-protocol",
-  "investigation-requirements",
-  "jotai",
-  "mobx",
-  "msw",
-  "native-js",
-  "next-intl",
-  "nextjs-app-router",
-  "nextjs-server-actions",
-  "ngrx-signalstore",
-  "nuxt",
-  "oclif-ink",
-  "offline-first",
-  "pinia",
-  "playwright-e2e",
-  "posthog-analytics",
-  "posthog-flags",
-  "prisma",
-  "radix-ui",
-  "react",
-  "react-hook-form",
-  "react-intl",
-  "react-native",
-  "react-query",
-  "react-testing-library",
-  "redux-toolkit",
-  "remix",
-  "research-methodology",
-  "resend-react-email",
-  "result-types",
-  "reviewing",
-  "scss-modules",
-  "service-workers",
-  "setup-axiom-pino-sentry",
-  "setup-env",
-  "setup-posthog",
-  "setup-resend",
-  "setup-tooling",
-  "shadcn-ui",
-  "socket-io",
-  "solidjs",
-  "sse",
-  "storybook",
-  "success-criteria",
-  "swr",
-  "tailwind",
-  "tanstack-table",
-  "trpc",
-  "turborepo",
-  "vee-validate",
-  "view-transitions",
-  "vitest",
-  "vue-composition-api",
-  "vue-i18n",
-  "vue-test-utils",
-  "web-accessibility",
-  "web-performance",
-  "websockets",
-  "write-verification",
-  "zod-validation",
-  "zustand"
-];
-var CATEGORIES = [
-  "api-analytics",
-  "api-api",
-  "api-auth",
-  "api-database",
-  "api-email",
-  "api-observability",
-  "api-performance",
-  "cli-framework",
-  "mobile-framework",
-  "shared-ci-cd",
-  "shared-methodology",
-  "shared-monorepo",
-  "shared-research",
-  "shared-reviewing",
-  "shared-security",
-  "shared-tooling",
-  "web-accessibility",
-  "web-animation",
-  "web-client-state",
-  "web-error-handling",
-  "web-file-upload",
-  "web-files",
-  "web-forms",
-  "web-framework",
-  "web-i18n",
-  "web-mocking",
-  "web-performance",
-  "web-pwa",
-  "web-realtime",
-  "web-server-state",
-  "web-styling",
-  "web-testing",
-  "web-ui-components",
-  "web-utilities"
-];
-var DOMAINS = ["api", "cli", "mobile", "shared", "web"];
-var AGENT_NAMES = [
-  "agent-summoner",
-  "api-developer",
-  "api-researcher",
-  "api-reviewer",
-  "cli-developer",
-  "cli-reviewer",
-  "cli-tester",
-  "documentor",
-  "pattern-scout",
-  "skill-summoner",
-  "web-architecture",
-  "web-developer",
-  "web-pattern-critique",
-  "web-pm",
-  "web-researcher",
-  "web-reviewer",
-  "web-tester"
-];
-
 // src/cli/lib/schemas.ts
 init_esm_shims();
 import { z } from "zod";
-var customExtensions = {
-  categories: /* @__PURE__ */ new Set(),
-  domains: /* @__PURE__ */ new Set(),
-  agentNames: /* @__PURE__ */ new Set(),
-  skillIds: /* @__PURE__ */ new Set()
-};
 var domainSchema = z.enum(DOMAINS);
 var skillSourceTypeSchema = z.enum([
   "public",
@@ -282,7 +135,6 @@ var boundSkillSchema = z.object({
   description: z.string().optional()
 });
 var categorySchema = z.enum(CATEGORIES);
-var CATEGORY_VALUES_SET = /* @__PURE__ */ new Set([...CATEGORIES]);
 var agentNameSchema = z.enum(AGENT_NAMES);
 var modelNameSchema = z.enum([
   "sonnet",
@@ -300,29 +152,10 @@ var permissionModeSchema = z.enum([
 ]);
 var skillSlugSchema = z.enum(SKILL_SLUGS);
 var SKILL_ID_PATTERN = /^(web|api|cli|mobile|infra|meta|security)-.+-.+$/;
-function isValidSkillId(id) {
-  return SKILL_ID_PATTERN.test(id) || customExtensions.skillIds.has(id);
-}
 var skillIdSchema = z.string().regex(
   SKILL_ID_PATTERN,
   "Must be a valid skill ID (e.g., 'web-framework-react')"
 );
-var extensibleDomainSchema = z.string().refine(
-  (val) => domainSchema.safeParse(val).success || customExtensions.domains.has(val),
-  { message: "Must be a valid domain" }
-);
-var extensibleSkillIdSchema = z.string().refine(
-  (val) => skillIdSchema.safeParse(val).success || customExtensions.skillIds.has(val),
-  { message: "Must be a valid skill ID" }
-);
-var extensibleCategorySchema = z.string().refine(
-  (val) => categorySchema.safeParse(val).success || customExtensions.categories.has(val),
-  { message: "Must be a valid category" }
-);
-var extensibleAgentNameSchema = z.string().refine(
-  (val) => agentNameSchema.safeParse(val).success || customExtensions.agentNames.has(val),
-  { message: "Must be a valid agent name" }
-);
 function validateCategoryField(val, ctx) {
   if (!val.category) return;
   if (val.custom) {
@@ -342,25 +175,12 @@ function validateCategoryField(val, ctx) {
     }
   }
 }
-function validateExtensibleRecordKeys(builtinSet, extensionSet, label) {
-  return (val, ctx) => {
-    for (const key of Object.keys(val)) {
-      if (!builtinSet.has(key) && !extensionSet.has(key)) {
-        ctx.addIssue({
-          code: "custom",
-          path: [key],
-          message: `Invalid ${label} '${key}'.`
-        });
-      }
-    }
-  };
-}
 var categoryPathSchema = z.string().refine(
   (val) => {
     if (val === "local") return true;
     if (/^(web|api|cli|mobile|infra|meta|security|shared)-.+$/.test(val)) return true;
     if (categorySchema.safeParse(val).success) return true;
-    return customExtensions.categories.has(val);
+    return KEBAB_CASE_PATTERN.test(val);
   },
   {
     message: "Must be a valid category path (e.g., 'web-framework', 'shared-testing', or 'local')"
@@ -386,7 +206,7 @@ var strictHooksRecordSchema = z.record(
   z.array(strictAgentHookDefinitionSchema)
 );
 var skillAssignmentSchema = z.object({
-  id: extensibleSkillIdSchema,
+  id: z.string(),
   preloaded: z.boolean().optional(),
   local: z.boolean().optional(),
   path: z.string().optional()
@@ -401,7 +221,7 @@ var skillMetadataLoaderSchema = z.object({
   category: z.string().optional(),
   author: z.string().optional(),
   tags: z.array(z.string()).optional(),
-  domain: extensibleDomainSchema,
+  domain: z.string(),
   custom: z.boolean().optional()
 }).passthrough().superRefine(validateCategoryField);
 var pluginAuthorSchema = z.object({
@@ -431,7 +251,7 @@ var pluginManifestValidationSchema = z.object({
   hooks: z.union([z.string(), strictHooksRecordSchema]).optional()
 }).strict();
 var agentYamlConfigSchema = z.object({
-  id: extensibleAgentNameSchema,
+  id: z.string(),
   title: z.string(),
   description: z.string(),
   model: modelNameSchema.optional(),
@@ -440,15 +260,16 @@ var agentYamlConfigSchema = z.object({
   permissionMode: permissionModeSchema.optional(),
   hooks: hooksRecordSchema.optional(),
   outputFormat: z.string().optional(),
-  domain: extensibleDomainSchema.optional(),
+  domain: z.string().optional(),
   custom: z.boolean().optional()
 });
-var skillAssignmentElementSchema = z.union([extensibleSkillIdSchema, skillAssignmentSchema]);
+var skillAssignmentElementSchema = z.union([
+  z.string(),
+  skillAssignmentSchema
+]);
 var stackAgentConfigSchema = z.record(
   z.string(),
   z.union([skillAssignmentElementSchema, z.array(skillAssignmentElementSchema)])
-).superRefine(
-  validateExtensibleRecordKeys(CATEGORY_VALUES_SET, customExtensions.categories, "category")
 );
 var projectConfigLoaderSchema = z.object({
   version: z.literal("1").optional(),
@@ -465,7 +286,7 @@ var projectConfigLoaderSchema = z.object({
   /** Per-skill configuration with scope and source */
   skills: z.array(
     z.object({
-      id: extensibleSkillIdSchema,
+      id: z.string(),
       scope: z.enum(["project", "global"]),
       source: z.string()
     })
@@ -473,7 +294,7 @@ var projectConfigLoaderSchema = z.object({
   /** Author handle (e.g., "@vince") */
   author: z.string().optional(),
   /** Selected domains from the wizard (persisted for edit mode restoration) */
-  domains: z.array(extensibleDomainSchema).optional(),
+  domains: z.array(z.string()).optional(),
   /** Selected agents from the wizard (persisted for edit mode restoration) */
   selectedAgents: z.array(z.string()).optional(),
   /** Agent-to-category-to-skill mappings from selected stack (accepts same formats as stacks.ts) */
@@ -486,10 +307,10 @@ var projectConfigLoaderSchema = z.object({
   agentsSource: z.string().optional()
 }).passthrough();
 var categoryDefinitionSchema = z.object({
-  id: extensibleCategorySchema,
+  id: z.string(),
   displayName: z.string(),
   description: z.string(),
-  domain: extensibleDomainSchema.optional(),
+  domain: z.string().optional(),
   exclusive: z.boolean(),
   required: z.boolean(),
   order: z.number(),
@@ -512,11 +333,6 @@ var compatibilityGroupSchema = z.object({
   skills: z.array(skillRefInRules).min(2),
   reason: z.string()
 });
-var setupPairSchema = z.object({
-  setup: skillRefInRules,
-  configures: z.array(skillRefInRules).min(1),
-  reason: z.string()
-});
 var requireRuleSchema = z.object({
   skill: skillRefInRules,
   needs: z.array(skillRefInRules).min(1),
@@ -533,18 +349,11 @@ var relationshipDefinitionsSchema = z.object({
   recommends: z.array(recommendationSchema),
   requires: z.array(requireRuleSchema),
   alternatives: z.array(alternativeGroupSchema),
-  compatibleWith: z.array(compatibilityGroupSchema).optional().default([]),
-  setupPairs: z.array(setupPairSchema).optional().default([])
+  compatibleWith: z.array(compatibilityGroupSchema).optional().default([])
 });
 var skillCategoriesFileSchema = z.object({
   version: z.string(),
-  categories: z.record(z.string(), categoryDefinitionSchema).superRefine(
-    validateExtensibleRecordKeys(
-      CATEGORY_VALUES_SET,
-      customExtensions.categories,
-      "category key"
-    )
-  )
+  categories: z.record(z.string(), categoryDefinitionSchema)
 });
 var skillRulesFileSchema = z.object({
   version: z.string(),
@@ -564,7 +373,7 @@ var localRawMetadataSchema = z.object({
   usageGuidance: z.string().optional(),
   tags: z.array(z.string()).optional(),
   /** Domain this skill belongs to (e.g., "web", "api", "cli") */
-  domain: extensibleDomainSchema,
+  domain: z.string(),
   /** True if this skill was created outside the CLI's built-in vocabulary */
   custom: z.boolean().optional()
 }).passthrough().superRefine(validateCategoryField);
@@ -721,7 +530,7 @@ var agentYamlGenerationSchema = z.object({
   permissionMode: permissionModeSchema.optional(),
   hooks: strictHooksRecordSchema.optional(),
   outputFormat: z.string().optional(),
-  domain: extensibleDomainSchema.optional(),
+  domain: z.string().optional(),
   custom: z.boolean().optional()
 }).strict();
 var agentFrontmatterValidationSchema = z.object({
@@ -756,8 +565,45 @@ var skillFrontmatterValidationSchema = z.object({
   "argument-hint": z.string().optional()
 }).strict();
 var metadataValidationSchema = z.object({
-  /** Domain-prefixed category (e.g., "web-framework") */
-  category: extensibleCategorySchema,
+  /** Domain-prefixed category — must be a known built-in category */
+  category: z.enum(CATEGORIES),
+  /** Author handle — must start with @ (e.g., "@vince") */
+  author: z.string().regex(/^@[a-z][a-z0-9-]*$/),
+  /** Short display name for the wizard grid (max 30 chars) */
+  displayName: z.string().min(1).max(30),
+  /** One-line description for the wizard (max 60 chars) */
+  cliDescription: z.string().min(1).max(60),
+  /** When an AI agent should invoke this skill (min 10 chars to ensure usefulness) */
+  usageGuidance: z.string().min(10),
+  /** Kebab-case short key — must be a known built-in slug */
+  slug: z.enum(SKILL_SLUGS),
+  /** Searchable tags — kebab-case only */
+  tags: z.array(z.string().regex(/^[a-z][a-z0-9-]*$/)).optional(),
+  /** 7-char hex SHA of skill content (for change detection) */
+  contentHash: z.string().regex(/^[a-f0-9]{7}$/).optional(),
+  /** ISO date of last update */
+  updated: z.string().optional(),
+  /** Provenance tracking when skill was forked from another */
+  forkedFrom: z.object({
+    /** Original skill ID */
+    skillId: z.string(),
+    /** Version of the original at fork time */
+    version: z.number().int().min(1).optional(),
+    /** Content hash of the original at fork time */
+    contentHash: z.string(),
+    /** Source URL or identifier */
+    source: z.string().optional(),
+    /** ISO date of the fork */
+    date: z.string()
+  }).optional(),
+  /** Domain assignment from metadata */
+  domain: z.string().optional(),
+  /** True if this skill was created outside the CLI's built-in vocabulary */
+  custom: z.boolean().optional()
+}).strict();
+var customMetadataValidationSchema = z.object({
+  /** Any string category — custom skills may define their own categories */
+  category: z.string(),
   /** Author handle — must start with @ (e.g., "@vince") */
   author: z.string().regex(/^@[a-z][a-z0-9-]*$/),
   /** Short display name for the wizard grid (max 30 chars) */
@@ -788,10 +634,10 @@ var metadataValidationSchema = z.object({
     date: z.string()
   }).optional(),
   /** Domain assignment from metadata */
-  domain: extensibleDomainSchema.optional(),
+  domain: z.string().optional(),
   /** True if this skill was created outside the CLI's built-in vocabulary */
   custom: z.boolean().optional()
-}).strict();
+});
 var stackSkillAssignmentSchema = z.object({
   id: z.string().min(1),
   /** If true, skill content is embedded in the compiled agent prompt */
@@ -871,20 +717,6 @@ function warnUnknownFields(parsed, expectedKeys, context) {
     warn(`Unknown fields in ${context}: ${unknownKeys.join(", ")}`);
   }
 }
-function extendSchemasWithCustomValues(options) {
-  for (const category of options.categories ?? []) {
-    customExtensions.categories.add(category);
-  }
-  for (const domain of options.domains ?? []) {
-    customExtensions.domains.add(domain);
-  }
-  for (const agentName of options.agentNames ?? []) {
-    customExtensions.agentNames.add(agentName);
-  }
-  for (const skillId of options.skillIds ?? []) {
-    customExtensions.skillIds.add(skillId);
-  }
-}
 
 export {
   getErrorMessage,
@@ -907,12 +739,7 @@ export {
   ensureDir,
   remove,
   copy,
-  CATEGORIES,
-  DOMAINS,
-  agentNameSchema,
   SKILL_ID_PATTERN,
-  isValidSkillId,
-  extensibleDomainSchema,
   categoryPathSchema,
   hooksRecordSchema,
   skillFrontmatterLoaderSchema,
@@ -937,7 +764,6 @@ export {
   stackConfigValidationSchema,
   formatZodErrors,
   validateNestingDepth,
-  warnUnknownFields,
-  extendSchemasWithCustomValues
+  warnUnknownFields
 };
-//# sourceMappingURL=chunk-ZEJIEC2A.js.map
+//# sourceMappingURL=chunk-WJL4KU5V.js.map