@agents-inc/cli 0.64.0 → 0.65.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ Each release has detailed notes in its own file under [`changelogs/`](./changelo
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.65.0] - 2026-03-11
+
+**Narrowed config types, edit command refactor, test consolidation (R-09)**
+
+- Generated config-types.ts unions now reflect only installed items, not the entire matrix
+- Edit command uses shared `writeScopedConfigs` instead of duplicated inline logic
+- ~90 test files migrated to canonical SKILLS registry and content generators (R-09)
+
+See [changelogs/0.65.0.md](./changelogs/0.65.0.md) for full details.
+
 ---
 
 ## [0.64.0] - 2026-03-10

package/dist/{chunk-MOMI77PL.js → chunk-N4D43IOO.js}

@@ -2,9 +2,6 @@
 import {
   typedEntries
 } from "./chunk-T4EXUIBY.js";
-import {
-  DEFAULT_BRANDING
-} from "./chunk-EGMQ3SXN.js";
 import {
   init_esm_shims
 } from "./chunk-DHET7RCE.js";
@@ -23,38 +20,6 @@ var __filename = fileURLToPath(import.meta.url);
 var __dirname = path.dirname(__filename);
 var CLI_ROOT = path.resolve(__dirname, "../../../..");
 var CONFIG_EXPORTS_PATH = path.resolve(__dirname, "../../config-exports.ts");
-var OUTPUT_STRINGS = {
-  CONFIG_HEADER: `${DEFAULT_BRANDING.NAME} Configuration`,
-  CONFIG_PATHS_HEADER: "Configuration File Paths",
-  CONFIG_LAYERS_HEADER: "Configuration Layers:",
-  CONFIG_PRECEDENCE: "Precedence: flag > env > project > global > default",
-  SOURCE_LABEL: "Source:",
-  MARKETPLACE_LABEL: "Marketplace:",
-  AGENTS_SOURCE_LABEL: "Agents Source:",
-  GLOBAL_LABEL: "Global:",
-  PROJECT_LABEL: "Project:",
-  // Setup/Init outputs
-  INIT_HEADER: `${DEFAULT_BRANDING.NAME} Setup`,
-  INIT_SUCCESS: `${DEFAULT_BRANDING.NAME} initialized successfully!`,
-  LOADING_MATRIX: "Loading skills matrix...",
-  LOADING_SKILLS: "Loading skills...",
-  LOADING_AGENTS: "Loading agent partials...",
-  // Plugin/installation outputs
-  NO_PLUGIN_FOUND: "No plugin found",
-  NO_INSTALLATION_FOUND: "No installation found",
-  NO_PLUGIN_INSTALLATION: "No plugin installation found",
-  NOT_INSTALLED: `${DEFAULT_BRANDING.NAME} is not installed`,
-  UNINSTALL_HEADER: `${DEFAULT_BRANDING.NAME} Uninstall`,
-  UNINSTALL_COMPLETE: `${DEFAULT_BRANDING.NAME} has been uninstalled`,
-  EJECT_HEADER: `${DEFAULT_BRANDING.NAME} Eject`,
-  // Doctor command outputs
-  DOCTOR_HEADER: `${DEFAULT_BRANDING.NAME} Doctor`,
-  // Error message patterns (lowercase for case-insensitive matching)
-  ERROR_MISSING_ARG: "missing required arg",
-  ERROR_UNEXPECTED_ARG: "unexpected argument",
-  ERROR_UNKNOWN_FLAG: "unknown flag",
-  ERROR_PARSE: "parse"
-};
 function buildSkillConfigs(skillIds, overrides) {
   return skillIds.map((id) => ({
     id,
@@ -101,11 +66,13 @@ function getCanonicalSkillCategories() {
       "api-framework-hono": "api-api",
       "api-framework-express": "api-api",
       "api-database-drizzle": "api-database",
-      "api-database-postgres": "api-database",
       "api-security-auth-patterns": "api-security",
-      "cli-cli-framework-commander": "cli-framework",
+      "cli-framework-commander": "cli-framework",
       "infra-setup-env": "shared-tooling",
       "infra-tooling-linter": "unmapped-category",
+      "web-accessibility-a11y": "web-accessibility",
+      "web-animation-framer": "web-animation",
+      "meta-methodology-investigation": "shared-methodology",
       "meta-methodology-success-criteria": "shared-methodology",
       "meta-methodology-investigation-requirements": "shared-methodology",
       "meta-methodology-anti-over-engineering": "shared-methodology",
@@ -147,19 +114,44 @@ function createMockSkill(id, overrides) {
     ...overrides
   };
 }
-function createMockMatrix(skills, overrides) {
+function createMockMatrix(skillsOrFirstSkill, ...rest) {
+  let skillsRecord;
+  let overrides;
+  if (skillsOrFirstSkill === void 0) {
+    skillsRecord = {};
+  } else if ("id" in skillsOrFirstSkill && typeof skillsOrFirstSkill.id === "string" && "slug" in skillsOrFirstSkill) {
+    const allArgs = [skillsOrFirstSkill, ...rest];
+    const lastArg = allArgs[allArgs.length - 1];
+    if (lastArg && !("id" in lastArg && "slug" in lastArg)) {
+      overrides = lastArg;
+      const skills = allArgs.slice(0, -1);
+      skillsRecord = {};
+      for (const skill of skills) {
+        skillsRecord[skill.id] = skill;
+      }
+    } else {
+      const skills = allArgs;
+      skillsRecord = {};
+      for (const skill of skills) {
+        skillsRecord[skill.id] = skill;
+      }
+    }
+  } else {
+    skillsRecord = skillsOrFirstSkill;
+    overrides = rest[0];
+  }
   const autoSlugToId = {};
   const autoIdToSlug = {};
-  for (const [id, skill] of typedEntries(skills)) {
+  for (const [, skill] of typedEntries(skillsRecord)) {
     if (skill.slug) {
-      autoSlugToId[skill.slug] = id;
-      autoIdToSlug[id] = skill.slug;
+      autoSlugToId[skill.slug] = skill.id;
+      autoIdToSlug[skill.id] = skill.slug;
     }
   }
   return {
     version: "1.0.0",
     categories: {},
-    skills,
+    skills: skillsRecord,
     suggestedStacks: [],
     slugMap: { slugToId: autoSlugToId, idToSlug: autoIdToSlug },
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -191,48 +183,8 @@ function createMockResolvedStack(id, name, overrides) {
 }
 
 // src/cli/lib/__tests__/test-fixtures.ts
-var SKILL_FIXTURES = {
-  react: createMockSkill("web-framework-react", {
-    description: "React framework for building user interfaces",
-    tags: ["react", "web", "ui", "component"]
-  }),
-  zustand: createMockSkill("web-state-zustand", {
-    description: "Bear necessities state management",
-    tags: ["state", "react", "zustand"]
-  }),
-  hono: createMockSkill("api-framework-hono", {
-    description: "Lightweight web framework for the edge",
-    tags: ["api", "api", "edge", "serverless"]
-  }),
-  vitest: createMockSkill("web-testing-vitest", {
-    description: "Next generation testing framework",
-    tags: ["testing", "vitest", "unit"]
-  }),
-  vue: createMockSkill("web-framework-vue", {
-    description: "Progressive JavaScript framework",
-    tags: ["vue", "web", "reactive"]
-  }),
-  "auth-patterns": createMockSkill("api-security-auth-patterns", {
-    description: "Authentication and authorization patterns",
-    tags: ["auth", "security", "jwt", "oauth"]
-  }),
-  drizzle: createMockSkill("api-database-drizzle", {
-    description: "TypeScript ORM for SQL databases",
-    tags: ["database", "orm", "sql"]
-  }),
-  "anti-over-engineering": createMockSkill("meta-methodology-anti-over-engineering", {
-    description: "Surgical implementation, not architectural innovation",
-    tags: ["methodology", "foundational"]
-  }),
-  "scss-modules": createMockSkill("web-styling-scss-modules", {
-    description: "CSS Modules with SCSS",
-    tags: ["css", "scss", "modules"]
-  })
-};
-function getTestSkill(name, overrides) {
-  return { ...SKILL_FIXTURES[name], ...overrides };
-}
-var TEST_SKILLS = {
+var SKILLS = {
+  // Web domain
   react: createMockSkill("web-framework-react"),
   vue: createMockSkill("web-framework-vue"),
   zustand: createMockSkill("web-state-zustand", {
@@ -241,78 +193,46 @@ var TEST_SKILLS = {
   pinia: createMockSkill("web-state-pinia", {
     compatibleWith: ["web-framework-vue"]
   }),
-  hono: createMockSkill("api-framework-hono"),
+  scss: createMockSkill("web-styling-scss-modules"),
+  tailwind: createMockSkill("web-styling-tailwind"),
   vitest: createMockSkill("web-testing-vitest"),
-  "scss-modules": createMockSkill("web-styling-scss-modules"),
+  // API domain
+  hono: createMockSkill("api-framework-hono"),
   drizzle: createMockSkill("api-database-drizzle"),
-  // Methodology skills (DEFAULT_PRESELECTED_SKILLS) — used by createComprehensiveMatrix
-  "investigation-requirements": createMockSkill("meta-methodology-investigation-requirements", {
-    description: "Never speculate - read actual code first"
-  }),
-  "anti-over-engineering": createMockSkill("meta-methodology-anti-over-engineering", {
+  // Methodology
+  antiOverEng: createMockSkill("meta-methodology-anti-over-engineering", {
     description: "Surgical implementation, not architectural innovation"
-  }),
-  "success-criteria": createMockSkill("meta-methodology-success-criteria", {
-    description: "Explicit, measurable criteria defining done"
-  }),
-  "write-verification": createMockSkill("meta-methodology-write-verification", {
-    description: "Verify work was actually saved"
-  }),
-  "improvement-protocol": createMockSkill("meta-methodology-improvement-protocol", {
-    description: "Evidence-based self-improvement"
-  }),
-  "context-management": createMockSkill("meta-methodology-context-management", {
-    description: "Maintain project continuity across sessions"
   })
 };
 var TEST_CATEGORIES = {
+  // Web domain
   framework: createMockCategory("web-framework", "Framework"),
   clientState: createMockCategory("web-client-state", "Client State"),
   styling: createMockCategory("web-styling", "Styling"),
   testing: createMockCategory("web-testing", "Testing"),
+  serverState: createMockCategory("web-server-state", "Server State"),
+  animation: createMockCategory("web-animation", "Animation"),
+  accessibility: createMockCategory("web-accessibility", "Accessibility"),
+  // API domain
   api: createMockCategory("api-api", "Backend Framework"),
   database: createMockCategory("api-database", "Database"),
+  observability: createMockCategory("api-observability", "Observability"),
+  // Shared domain
   methodology: createMockCategory("shared-methodology", "Methodology"),
-  tooling: createMockCategory("shared-tooling", "Tooling")
-};
-var TEST_MATRICES = {
-  empty: createMockMatrix({}),
-  react: createMockMatrix({
-    "web-framework-react": TEST_SKILLS.react
-  }),
-  reactAndZustand: createMockMatrix({
-    "web-framework-react": TEST_SKILLS.react,
-    "web-state-zustand": TEST_SKILLS.zustand
-  }),
-  reactAndHono: createMockMatrix({
-    "web-framework-react": TEST_SKILLS.react,
-    "api-framework-hono": TEST_SKILLS.hono
-  }),
-  reactAndScss: createMockMatrix({
-    "web-framework-react": TEST_SKILLS.react,
-    "web-styling-scss-modules": TEST_SKILLS["scss-modules"]
-  }),
-  reactScssAndHono: createMockMatrix({
-    "web-framework-react": TEST_SKILLS.react,
-    "web-styling-scss-modules": TEST_SKILLS["scss-modules"],
-    "api-framework-hono": TEST_SKILLS.hono
-  }),
-  reactZustandAndHono: createMockMatrix({
-    "web-framework-react": TEST_SKILLS.react,
-    "web-state-zustand": TEST_SKILLS.zustand,
-    "api-framework-hono": TEST_SKILLS.hono
-  })
+  tooling: createMockCategory("shared-tooling", "Tooling"),
+  security: createMockCategory("shared-security", "Security"),
+  // CLI domain
+  cliFramework: createMockCategory("cli-framework", "CLI Framework"),
+  // Mobile domain
+  mobileFramework: createMockCategory("mobile-framework", "Mobile Framework")
 };
 
 export {
-  getTestSkill,
-  TEST_SKILLS,
+  SKILLS,
   TEST_CATEGORIES,
-  TEST_MATRICES,
   buildSkillConfigs,
   createMockSkill,
   createMockMatrix,
-  createMockCategory,
   createMockResolvedStack
 };
-//# sourceMappingURL=chunk-MOMI77PL.js.map
+//# sourceMappingURL=chunk-N4D43IOO.js.map

package/dist/chunk-N4D43IOO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/lib/__tests__/test-fixtures.ts","../src/cli/lib/__tests__/helpers.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\"),\n  zustand: createMockSkill(\"web-state-zustand\", {\n    compatibleWith: [\"web-framework-react\"],\n  }),\n  pinia: createMockSkill(\"web-state-pinia\", {\n    compatibleWith: [\"web-framework-vue\"],\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 { findSkill } from \"../../stores/matrix-store\";\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 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: AgentName[],\n  overrides?: Partial<Omit<AgentScopeConfig, \"name\">>,\n): AgentScopeConfig[] {\n  return agentNames.map((name) => ({\n    name,\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)\nvar _canonicalSkillCategories: Partial<Record<SkillId, CategoryPath>> | undefined;\nfunction getCanonicalSkillCategories(): Partial<Record<SkillId, CategoryPath>> {\n  if (!_canonicalSkillCategories) {\n    _canonicalSkillCategories = {\n      \"web-framework-react\": \"web-framework\",\n      \"web-framework-vue\": \"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-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-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      \"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      \"cli-framework-commander\": \"cli-framework\",\n      \"infra-setup-env\": \"shared-tooling\",\n      \"infra-tooling-linter\": \"unmapped-category\" as CategoryPath,\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    };\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  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  const category = overrides?.category ?? getCanonicalSkillCategories()[id];\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    requiresSetup: [],\n    providesSetupFor: [],\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 = findSkill(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: Category,\n  displayName: string,\n  overrides?: Partial<CategoryDefinition>,\n): CategoryDefinition {\n  return {\n    id,\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\": {\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\"],\n        },\n      } as ResolvedStack[\"skills\"],\n      allSkillIds: [\"web-framework-vue\"],\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: \"web-framework-vue\",\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\",\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  return createMockSkill(skill.id, {\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"],"mappings":"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","names":[]}

package/dist/components/wizard/category-grid.test.js

@@ -15,7 +15,7 @@ import {
 import {
   createMockMatrix,
   createMockSkill
-} from "../../chunk-MOMI77PL.js";
+} from "../../chunk-N4D43IOO.js";
 import {
   afterEach,
   beforeEach,
@@ -93,11 +93,11 @@ var TEST_GRID_SKILLS = [
   { id: "web-i18n-vue-i18n", displayName: "Vue I18n", category: "web-i18n" }
 ];
 function buildTestMatrix() {
-  const skills = {};
-  for (const { id, displayName, category } of TEST_GRID_SKILLS) {
-    skills[id] = createMockSkill(id, { displayName, category });
-  }
-  return createMockMatrix(skills);
+  return createMockMatrix(
+    ...TEST_GRID_SKILLS.map(
+      ({ id, displayName, category }) => createMockSkill(id, { displayName, category })
+    )
+  );
 }
 var createOption = (id, overrides = {}) => ({
   id,