@agents-inc/cli 0.42.0 → 0.45.0

package/config/stacks.yaml

@@ -1863,324 +1863,3 @@ stacks:
           - id: meta-methodology-context-management
             preloaded: true
     philosophy: Maximum performance with minimal overhead
-
-  - id: react-native-stack
-    name: React Native Stack
-    description: React Native + Expo mobile
-    agents:
-      web-developer:
-        web-framework:
-          - id: mobile-framework-react-native
-            preloaded: true
-        mobile-platform:
-          - id: mobile-framework-expo
-            preloaded: true
-        web-base-framework:
-          - id: web-framework-react
-            preloaded: true
-        web-client-state: web-state-zustand
-        web-server-state: web-server-state-react-query
-        web-testing: web-testing-vitest
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-      web-reviewer:
-        shared-reviewing:
-          - id: meta-reviewing-reviewing
-            preloaded: true
-        web-framework: mobile-framework-react-native
-        mobile-platform: mobile-framework-expo
-        web-base-framework: web-framework-react
-        web-client-state: web-state-zustand
-        web-server-state: web-server-state-react-query
-        web-testing: web-testing-vitest
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-      web-pm:
-        web-framework: mobile-framework-react-native
-        mobile-platform: mobile-framework-expo
-        web-base-framework: web-framework-react
-        web-client-state: web-state-zustand
-        web-server-state: web-server-state-react-query
-        web-testing: web-testing-vitest
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-      web-architecture:
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-      web-researcher:
-        web-framework: mobile-framework-react-native
-        mobile-platform: mobile-framework-expo
-        web-base-framework: web-framework-react
-        web-client-state: web-state-zustand
-        web-server-state: web-server-state-react-query
-        web-testing: web-testing-vitest
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-      pattern-scout:
-        web-framework: mobile-framework-react-native
-        mobile-platform: mobile-framework-expo
-        web-base-framework: web-framework-react
-        web-client-state: web-state-zustand
-        web-server-state: web-server-state-react-query
-        web-testing: web-testing-vitest
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-      web-pattern-critique:
-        web-framework: mobile-framework-react-native
-        mobile-platform: mobile-framework-expo
-        web-base-framework: web-framework-react
-        web-client-state: web-state-zustand
-        web-server-state: web-server-state-react-query
-        web-testing: web-testing-vitest
-        shared-reviewing:
-          - id: meta-reviewing-reviewing
-            preloaded: true
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-      agent-summoner:
-        web-framework: mobile-framework-react-native
-        mobile-platform: mobile-framework-expo
-        web-base-framework: web-framework-react
-        web-client-state: web-state-zustand
-        web-server-state: web-server-state-react-query
-        web-testing: web-testing-vitest
-        shared-reviewing: meta-reviewing-reviewing
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-      skill-summoner:
-        web-framework: mobile-framework-react-native
-        mobile-platform: mobile-framework-expo
-        web-base-framework: web-framework-react
-        web-client-state: web-state-zustand
-        web-server-state: web-server-state-react-query
-        web-testing: web-testing-vitest
-        shared-reviewing: meta-reviewing-reviewing
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-      documentor:
-        web-framework: mobile-framework-react-native
-        mobile-platform: mobile-framework-expo
-        web-base-framework: web-framework-react
-        web-client-state: web-state-zustand
-        web-server-state: web-server-state-react-query
-        web-testing: web-testing-vitest
-        shared-reviewing: meta-reviewing-reviewing
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-      web-tester:
-        web-testing: web-testing-vitest
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-    philosophy: One codebase, iOS and Android
-
-  - id: meta-stack
-    name: Meta Agent Stack
-    description: Meta-level agent tooling
-    agents:
-      skill-summoner:
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-        shared-research:
-          - id: meta-research-research-methodology
-            preloaded: true
-      agent-summoner:
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-        shared-research:
-          - id: meta-research-research-methodology
-            preloaded: true
-      documentor:
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-        shared-research:
-          - id: meta-research-research-methodology
-            preloaded: true
-      pattern-scout:
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-        shared-reviewing:
-          - id: meta-reviewing-reviewing
-            preloaded: true
-      web-pattern-critique:
-        shared-methodology:
-          - id: meta-methodology-investigation-requirements
-            preloaded: true
-          - id: meta-methodology-anti-over-engineering
-            preloaded: true
-          - id: meta-methodology-success-criteria
-            preloaded: true
-          - id: meta-methodology-write-verification
-            preloaded: true
-          - id: meta-methodology-improvement-protocol
-            preloaded: true
-          - id: meta-methodology-context-management
-            preloaded: true
-        shared-reviewing:
-          - id: meta-reviewing-reviewing
-            preloaded: true
-    philosophy: Build tools that build tools

package/dist/{chunk-J73KIP6Z.js → chunk-3JRWNWBF.js}

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
+import {
+  typedEntries
+} from "./chunk-T4EXUIBY.js";
 import {
   DEFAULT_BRANDING
-} from "./chunk-PP7NDFFE.js";
+} from "./chunk-FVN5PFFY.js";
 import {
   init_esm_shims
 } from "./chunk-DHET7RCE.js";
@@ -71,13 +74,21 @@ function createMockSkill(id, category, overrides) {
   };
 }
 function createMockMatrix(skills, overrides) {
+  const autoDisplayNames = {};
+  const autoDisplayNameToId = {};
+  for (const [id, skill] of typedEntries(skills)) {
+    if (skill.displayName) {
+      autoDisplayNames[id] = skill.displayName;
+      autoDisplayNameToId[skill.displayName] = id;
+    }
+  }
   return {
     version: "1.0.0",
     categories: {},
     skills,
     suggestedStacks: [],
-    displayNameToId: {},
-    displayNames: {},
+    displayNameToId: autoDisplayNameToId,
+    displayNames: autoDisplayNames,
     generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
     ...overrides
   };
@@ -87,6 +98,7 @@ function createMockCategory(id, displayName, overrides) {
     id,
     displayName,
     description: `${displayName} category`,
+    domain: "web",
     exclusive: true,
     required: false,
     order: 0,
@@ -175,12 +187,62 @@ function getTestSkill(name, overrides) {
   const { id, category, ...defaults } = config;
   return createMockSkill(id, category, { ...defaults, ...overrides });
 }
+var TEST_SKILLS = {
+  react: createMockSkill("web-framework-react", "web-framework"),
+  vue: createMockSkill("web-framework-vue", "web-framework"),
+  zustand: createMockSkill("web-state-zustand", "web-client-state", {
+    compatibleWith: ["web-framework-react"]
+  }),
+  pinia: createMockSkill("web-state-pinia", "web-client-state", {
+    compatibleWith: ["web-framework-vue"]
+  }),
+  hono: createMockSkill("api-framework-hono", "api-api"),
+  vitest: createMockSkill("web-testing-vitest", "web-testing"),
+  scssModules: createMockSkill("web-styling-scss-modules", "web-styling"),
+  drizzle: createMockSkill("api-database-drizzle", "api-database")
+};
+var TEST_CATEGORIES = {
+  framework: createMockCategory("web-framework", "Framework"),
+  clientState: createMockCategory("web-client-state", "Client State"),
+  testing: createMockCategory("web-testing", "Testing"),
+  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.scssModules
+  }),
+  reactScssAndHono: createMockMatrix({
+    "web-framework-react": TEST_SKILLS.react,
+    "web-styling-scss-modules": TEST_SKILLS.scssModules,
+    "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
+  })
+};
 
 export {
   getTestSkill,
+  TEST_SKILLS,
+  TEST_MATRICES,
   createMockSkill,
   createMockMatrix,
   createMockCategory,
   createMockResolvedStack
 };
-//# sourceMappingURL=chunk-J73KIP6Z.js.map
+//# sourceMappingURL=chunk-3JRWNWBF.js.map

package/dist/chunk-3JRWNWBF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/lib/__tests__/test-fixtures.ts","../src/cli/lib/__tests__/helpers.ts"],"sourcesContent":["import type {\n  CategoryPath,\n  MergedSkillsMatrix,\n  ResolvedSkill,\n  SkillDisplayName,\n  SkillId,\n} from \"../../types\";\nimport { createMockSkill, createMockCategory, createMockMatrix } from \"./helpers\";\n\ninterface SkillFixtureConfig {\n  id: SkillId;\n  category: CategoryPath;\n  displayName?: SkillDisplayName;\n  description: string;\n  tags: string[];\n}\n\nconst SKILL_FIXTURES: Record<string, SkillFixtureConfig> = {\n  react: {\n    id: \"web-framework-react\",\n    category: \"web-framework\",\n    displayName: \"react\",\n    description: \"React framework for building user interfaces\",\n    tags: [\"react\", \"web\", \"ui\", \"component\"],\n  },\n  zustand: {\n    id: \"web-state-zustand\",\n    category: \"web-client-state\",\n    displayName: \"zustand\",\n    description: \"Bear necessities state management\",\n    tags: [\"state\", \"react\", \"zustand\"],\n  },\n  hono: {\n    id: \"api-framework-hono\",\n    category: \"api-api\",\n    displayName: \"hono\",\n    description: \"Lightweight web framework for the edge\",\n    tags: [\"api\", \"api\", \"edge\", \"serverless\"],\n  },\n  vitest: {\n    id: \"web-testing-vitest\",\n    category: \"web-testing\",\n    displayName: \"vitest\",\n    description: \"Next generation testing framework\",\n    tags: [\"testing\", \"vitest\", \"unit\"],\n  },\n  vue: {\n    id: \"web-framework-vue\",\n    category: \"web-framework\",\n    displayName: \"vue\",\n    description: \"Progressive JavaScript framework\",\n    tags: [\"vue\", \"web\", \"reactive\"],\n  },\n  \"auth-patterns\": {\n    id: \"api-security-auth-patterns\",\n    category: \"api-security\",\n    description: \"Authentication and authorization patterns\",\n    tags: [\"auth\", \"security\", \"jwt\", \"oauth\"],\n  },\n  drizzle: {\n    id: \"api-database-drizzle\",\n    category: \"api-database\",\n    displayName: \"drizzle\",\n    description: \"TypeScript ORM for SQL databases\",\n    tags: [\"database\", \"orm\", \"sql\"],\n  },\n  methodology: {\n    id: \"meta-methodology-anti-over-engineering\",\n    category: \"shared-methodology\",\n    description: \"Surgical implementation, not architectural innovation\",\n    tags: [\"methodology\", \"foundational\"],\n  },\n  \"scss-modules\": {\n    id: \"web-styling-scss-modules\",\n    category: \"web-styling\",\n    displayName: \"scss-modules\",\n    description: \"CSS Modules with SCSS\",\n    tags: [\"css\", \"scss\", \"modules\"],\n  },\n} as const;\n\nexport type TestSkillName = keyof typeof SKILL_FIXTURES;\n\nexport function getTestSkill(\n  name: TestSkillName,\n  overrides?: Partial<ResolvedSkill>,\n): ResolvedSkill {\n  const config = SKILL_FIXTURES[name];\n  const { id, category, ...defaults } = config;\n  return createMockSkill(id, category, { ...defaults, ...overrides });\n}\n\n// ---------------------------------------------------------------------------\n// Shared base skill fixtures — canonical defaults with no overrides.\n// Use spread for per-test customization: `{ ...TEST_SKILLS.react, displayName: \"react\" }`\n// ---------------------------------------------------------------------------\n\nexport const TEST_SKILLS = {\n  react: createMockSkill(\"web-framework-react\", \"web-framework\"),\n  vue: createMockSkill(\"web-framework-vue\", \"web-framework\"),\n  zustand: createMockSkill(\"web-state-zustand\", \"web-client-state\", {\n    compatibleWith: [\"web-framework-react\"],\n  }),\n  pinia: createMockSkill(\"web-state-pinia\", \"web-client-state\", {\n    compatibleWith: [\"web-framework-vue\"],\n  }),\n  hono: createMockSkill(\"api-framework-hono\", \"api-api\"),\n  vitest: createMockSkill(\"web-testing-vitest\", \"web-testing\"),\n  scssModules: createMockSkill(\"web-styling-scss-modules\", \"web-styling\"),\n  drizzle: createMockSkill(\"api-database-drizzle\", \"api-database\"),\n};\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  framework: createMockCategory(\"web-framework\", \"Framework\"),\n  clientState: createMockCategory(\"web-client-state\", \"Client State\"),\n  testing: createMockCategory(\"web-testing\", \"Testing\"),\n  tooling: createMockCategory(\"shared-tooling\", \"Tooling\"),\n};\n\n// ---------------------------------------------------------------------------\n// Shared matrix fixtures — common skill combinations used across test files.\n// Use createMockMatrix overrides for per-test customization:\n//   `createMockMatrix(TEST_MATRICES.react.skills, { suggestedStacks: [...] })`\n// ---------------------------------------------------------------------------\n\nexport const TEST_MATRICES: Record<string, MergedSkillsMatrix> = {\n  empty: createMockMatrix({}),\n  react: createMockMatrix({\n    \"web-framework-react\": TEST_SKILLS.react,\n  }),\n  reactAndZustand: createMockMatrix({\n    \"web-framework-react\": TEST_SKILLS.react,\n    \"web-state-zustand\": TEST_SKILLS.zustand,\n  }),\n  reactAndHono: createMockMatrix({\n    \"web-framework-react\": TEST_SKILLS.react,\n    \"api-framework-hono\": TEST_SKILLS.hono,\n  }),\n  reactAndScss: createMockMatrix({\n    \"web-framework-react\": TEST_SKILLS.react,\n    \"web-styling-scss-modules\": TEST_SKILLS.scssModules,\n  }),\n  reactScssAndHono: createMockMatrix({\n    \"web-framework-react\": TEST_SKILLS.react,\n    \"web-styling-scss-modules\": TEST_SKILLS.scssModules,\n    \"api-framework-hono\": TEST_SKILLS.hono,\n  }),\n  reactZustandAndHono: createMockMatrix({\n    \"web-framework-react\": TEST_SKILLS.react,\n    \"web-state-zustand\": TEST_SKILLS.zustand,\n    \"api-framework-hono\": TEST_SKILLS.hono,\n  }),\n};\n","import path from \"path\";\nimport os from \"os\";\nimport { fileURLToPath } from \"url\";\nimport { mkdtemp, rm, mkdir, writeFile, readFile, stat } from \"fs/promises\";\nimport { parse as parseYaml, stringify as stringifyYaml } from \"yaml\";\nimport { run, Errors } from \"@oclif/core\";\nimport ansis from \"ansis\";\nimport { DEFAULT_BRANDING, DEFAULT_PLUGIN_NAME, STANDARD_FILES } from \"../../consts\";\nimport { typedEntries } from \"../../utils/typed-object\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\nexport const CLI_ROOT = path.resolve(__dirname, \"../../../..\");\n\nexport const OUTPUT_STRINGS = {\n  CONFIG_HEADER: `${DEFAULT_BRANDING.NAME} Configuration`,\n  CONFIG_PATHS_HEADER: \"Configuration File Paths\",\n  CONFIG_LAYERS_HEADER: \"Configuration Layers:\",\n  CONFIG_PRECEDENCE: \"Precedence: flag > env > project > global > default\",\n  SOURCE_LABEL: \"Source:\",\n  MARKETPLACE_LABEL: \"Marketplace:\",\n  AGENTS_SOURCE_LABEL: \"Agents Source:\",\n  GLOBAL_LABEL: \"Global:\",\n  PROJECT_LABEL: \"Project:\",\n\n  // Setup/Init outputs\n  INIT_HEADER: `${DEFAULT_BRANDING.NAME} Setup`,\n  INIT_SUCCESS: `${DEFAULT_BRANDING.NAME} initialized successfully!`,\n  LOADING_MATRIX: \"Loading skills matrix...\",\n  LOADING_SKILLS: \"Loading skills...\",\n  LOADING_AGENTS: \"Loading agent partials...\",\n\n  // Plugin/installation outputs\n  NO_PLUGIN_FOUND: \"No plugin found\",\n  NO_INSTALLATION_FOUND: \"No installation found\",\n  NO_PLUGIN_INSTALLATION: \"No plugin installation found\",\n  NOT_INSTALLED: `${DEFAULT_BRANDING.NAME} is not installed`,\n  UNINSTALL_HEADER: `${DEFAULT_BRANDING.NAME} Uninstall`,\n  UNINSTALL_COMPLETE: `${DEFAULT_BRANDING.NAME} has been uninstalled`,\n  EJECT_HEADER: `${DEFAULT_BRANDING.NAME} Eject`,\n\n  // Doctor command outputs\n  DOCTOR_HEADER: `${DEFAULT_BRANDING.NAME} Doctor`,\n\n  // Error message patterns (lowercase for case-insensitive matching)\n  ERROR_MISSING_ARG: \"missing required arg\",\n  ERROR_UNEXPECTED_ARG: \"unexpected argument\",\n  ERROR_UNKNOWN_FLAG: \"unknown flag\",\n  ERROR_PARSE: \"parse\",\n} as const;\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  CategoryDefinition,\n  CategoryPath,\n  CompileContext,\n  Domain,\n  DomainSelections,\n  ExtractedSkillMetadata,\n  MergedSkillsMatrix,\n  ResolvedSkill,\n  ResolvedStack,\n  Skill,\n  SkillDefinition,\n  SkillDisplayName,\n  SkillId,\n  Stack,\n  StackAgentConfig,\n  Subcategory,\n} from \"../../types\";\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 } from \"./fixtures/create-test-source\";\nimport { getTestSkill } from \"./test-fixtures\";\n\nexport async function fileExists(filePath: string): Promise<boolean> {\n  try {\n    const s = await stat(filePath);\n    return s.isFile();\n  } catch {\n    return false;\n  }\n}\n\nexport async function directoryExists(dirPath: string): Promise<boolean> {\n  try {\n    const s = await stat(dirPath);\n    return s.isDirectory();\n  } catch {\n    return false;\n  }\n}\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\nexport function buildWizardResult(\n  selectedSkills: SkillId[],\n  overrides?: Partial<WizardResultV2>,\n): WizardResultV2 {\n  return {\n    selectedSkills,\n    selectedAgents: [],\n    selectedStackId: null,\n    domainSelections: {} as DomainSelections,\n    selectedDomains: [],\n    sourceSelections: {},\n    expertMode: false,\n    installMode: \"local\",\n    cancelled: false,\n    validation: { valid: true, errors: [], warnings: [] },\n    ...overrides,\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\nexport async function createTempDir(prefix = \"cc-test-\"): Promise<string> {\n  return mkdtemp(path.join(os.tmpdir(), prefix));\n}\n\nconst CLEANUP_MAX_RETRIES = 3;\nconst CLEANUP_RETRY_DELAY_MS = 100;\n\nexport async function cleanupTempDir(dirPath: string): Promise<void> {\n  for (let attempt = 0; attempt < CLEANUP_MAX_RETRIES; attempt++) {\n    try {\n      await rm(dirPath, { recursive: true, force: true });\n      return;\n    } catch (error: unknown) {\n      const isRetryable =\n        error instanceof Error &&\n        \"code\" in error &&\n        (error as NodeJS.ErrnoException).code === \"ENOTEMPTY\";\n      if (!isRetryable || attempt === CLEANUP_MAX_RETRIES - 1) {\n        throw error;\n      }\n      // Transient ENOTEMPTY on macOS: kernel hasn't released directory entries yet\n      await new Promise((resolve) => setTimeout(resolve, CLEANUP_RETRY_DELAY_MS));\n    }\n  }\n}\n\nexport interface TestDirs {\n  tempDir: string;\n  projectDir: string;\n  pluginDir: string;\n  skillsDir: string;\n  agentsDir: string;\n}\n\nexport async function createTestDirs(prefix = \"cc-test-\"): Promise<TestDirs> {\n  const tempDir = await createTempDir(prefix);\n  const projectDir = path.join(tempDir, \"project\");\n  const pluginDir = path.join(projectDir, \".claude\", \"plugins\", DEFAULT_PLUGIN_NAME);\n  const skillsDir = path.join(pluginDir, \"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: TestDirs): Promise<void> {\n  await cleanupTempDir(dirs.tempDir);\n}\n\nexport function createMockSkill(\n  id: SkillId,\n  category: CategoryPath,\n  overrides?: Partial<ResolvedSkill>,\n): ResolvedSkill {\n  return {\n    id,\n    description: `${id} skill`,\n    category,\n    categoryExclusive: false,\n    tags: [],\n    author: \"@test\",\n    conflictsWith: [],\n    recommends: [],\n    requires: [],\n    alternatives: [],\n    discourages: [],\n    compatibleWith: [],\n    requiresSetup: [],\n    providesSetupFor: [],\n    path: `skills/${category}/${id}/`,\n    ...overrides,\n  };\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-subcategory-name\"\n  const segments = id.split(\"-\");\n  const domain = segments[0] ?? \"web\";\n  const subcategory = segments[1] ?? \"framework\";\n  const name = segments.slice(2).join(\"-\") || \"skill\";\n  const directoryPath = `${domain}/${subcategory}/${name}`;\n\n  return {\n    id,\n    directoryPath,\n    description: `${id} skill`,\n    category: `${domain}-${subcategory}` as CategoryPath,\n    categoryExclusive: true,\n    author: \"@test\",\n    tags: [],\n    compatibleWith: [],\n    conflictsWith: [],\n    requires: [],\n    requiresSetup: [],\n    providesSetupFor: [],\n    path: `skills/${directoryPath}/`,\n    ...overrides,\n  };\n}\n\nexport function createMockMatrix(\n  skills: Record<string, ResolvedSkill>,\n  overrides?: Partial<MergedSkillsMatrix>,\n): MergedSkillsMatrix {\n  // Auto-generate displayNames and displayNameToId from skills\n  const autoDisplayNames = {} as Record<SkillId, SkillDisplayName>;\n  const autoDisplayNameToId = {} as Record<SkillDisplayName, SkillId>;\n  for (const [id, skill] of typedEntries(skills)) {\n    if (skill.displayName) {\n      autoDisplayNames[id as SkillId] = skill.displayName;\n      autoDisplayNameToId[skill.displayName] = id as SkillId;\n    }\n  }\n\n  return {\n    version: \"1.0.0\",\n    categories: {} as Record<Subcategory, import(\"../../types\").CategoryDefinition>,\n    skills,\n    suggestedStacks: [],\n    displayNameToId: autoDisplayNameToId,\n    displayNames: autoDisplayNames,\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/plugins/${DEFAULT_PLUGIN_NAME}`,\n    ...overrides,\n  };\n}\n\nexport function createSkillContent(name: string, description = \"A test skill\"): string {\n  return `---\nname: ${name}\ndescription: ${description}\ncategory: test\n---\n\n# ${name}\n\nThis is a test skill.\n`;\n}\n\nfunction createMetadataContent(author = \"@test\"): string {\n  return `author: ${author}\n`;\n}\n\nexport function createAgentYamlContent(name: string, description = `Test ${name} agent`): string {\n  return `id: ${name}\ntitle: ${name} Agent\ndescription: ${description}\ntools:\n  - Read\n  - Write`;\n}\n\nexport async function writeTestSkill(\n  skillsDir: string,\n  skillName: string,\n  options?: {\n    author?: string;\n    description?: string;\n    /** Extra fields to merge into metadata.yaml (e.g., forkedFrom, cliName) */\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 skillDir = path.join(skillsDir, skillName);\n  await mkdir(skillDir, { recursive: true });\n\n  await writeFile(\n    path.join(skillDir, STANDARD_FILES.SKILL_MD),\n    options?.skillContent ?? createSkillContent(skillName, options?.description),\n  );\n\n  if (!options?.skipMetadata) {\n    if (options?.extraMetadata) {\n      const metadata = {\n        author: options?.author ?? \"@test\",\n        ...options.extraMetadata,\n      };\n      await writeFile(path.join(skillDir, STANDARD_FILES.METADATA_YAML), stringifyYaml(metadata));\n    } else {\n      await writeFile(\n        path.join(skillDir, STANDARD_FILES.METADATA_YAML),\n        createMetadataContent(options?.author),\n      );\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>/<subcategory>/<name>/`).\n */\nexport async function writeSourceSkill(\n  skillsDir: string,\n  directoryPath: string,\n  config: {\n    id: string;\n    description: string;\n    category: string;\n    author?: string;\n    tags?: string[];\n    categoryExclusive?: boolean;\n    content?: string;\n  },\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    createSkillContent(config.id, config.description),\n  );\n\n  const metadata: Record<string, unknown> = {\n    cliName: config.id,\n    category: config.category,\n    author: config.author ?? \"@test\",\n  };\n  if (config.tags) {\n    metadata.tags = config.tags;\n  }\n  if (config.categoryExclusive !== undefined) {\n    metadata.categoryExclusive = config.categoryExclusive;\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_YAML),\n    createAgentYamlContent(agentName, options?.description),\n  );\n\n  return agentDir;\n}\n\nexport function createMockCategory(\n  id: Subcategory,\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    audience: [],\n    skills: {},\n    allSkillIds: [],\n    philosophy: \"\",\n    ...overrides,\n  };\n}\n\n/**\n * Builds a comprehensive test matrix with 13 skills across 7 categories,\n * 2 suggested stacks, display name mappings, and relationship data\n * (conflicts, recommends). Includes all 6 DEFAULT_PRESELECTED_SKILLS\n * (methodology) so wizard handleComplete can resolve them.\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 Subcategory IDs (matching production\n  // metadata.yaml and the categories map keys, e.g., \"web-framework\", \"api-api\").\n  const skills = {\n    \"web-framework-react\": getTestSkill(\"react\", { category: \"web-framework\" }),\n    \"web-framework-vue\": getTestSkill(\"vue\", {\n      category: \"web-framework\",\n      conflictsWith: [{ skillId: \"web-framework-react\", reason: \"Choose one framework\" }],\n    }),\n    \"web-state-zustand\": getTestSkill(\"zustand\", {\n      category: \"web-client-state\",\n      recommends: [{ skillId: \"web-framework-react\", reason: \"Works great with React\" }],\n    }),\n    \"web-styling-scss-modules\": getTestSkill(\"scss-modules\", { category: \"web-styling\" }),\n    \"api-framework-hono\": getTestSkill(\"hono\", { category: \"api-api\" }),\n    \"api-database-drizzle\": getTestSkill(\"drizzle\", { category: \"api-database\" }),\n    \"web-testing-vitest\": getTestSkill(\"vitest\", { category: \"web-testing\" }),\n    // Methodology skills (DEFAULT_PRESELECTED_SKILLS) — auto-injected by wizard\n    \"meta-methodology-investigation-requirements\": createMockSkill(\n      \"meta-methodology-investigation-requirements\",\n      \"shared-methodology\",\n      { description: \"Never speculate - read actual code first\", categoryExclusive: false },\n    ),\n    \"meta-methodology-anti-over-engineering\": createMockSkill(\n      \"meta-methodology-anti-over-engineering\",\n      \"shared-methodology\",\n      {\n        description: \"Surgical implementation, not architectural innovation\",\n        categoryExclusive: false,\n      },\n    ),\n    \"meta-methodology-success-criteria\": createMockSkill(\n      \"meta-methodology-success-criteria\",\n      \"shared-methodology\",\n      { description: \"Explicit, measurable criteria defining done\", categoryExclusive: false },\n    ),\n    \"meta-methodology-write-verification\": createMockSkill(\n      \"meta-methodology-write-verification\",\n      \"shared-methodology\",\n      { description: \"Verify work was actually saved\", categoryExclusive: false },\n    ),\n    \"meta-methodology-improvement-protocol\": createMockSkill(\n      \"meta-methodology-improvement-protocol\",\n      \"shared-methodology\",\n      { description: \"Evidence-based self-improvement\", categoryExclusive: false },\n    ),\n    \"meta-methodology-context-management\": createMockSkill(\n      \"meta-methodology-context-management\",\n      \"shared-methodology\",\n      { description: \"Maintain project continuity across sessions\", categoryExclusive: false },\n    ),\n  };\n\n  const categories = {\n    \"web-framework\": createMockCategory(\"web-framework\" as Subcategory, \"Framework\", {\n      domain: \"web\" as Domain,\n      exclusive: true,\n      required: true,\n    }),\n    \"web-client-state\": createMockCategory(\"web-client-state\" as Subcategory, \"State\", {\n      domain: \"web\" as Domain,\n      order: 1,\n    }),\n    \"web-styling\": createMockCategory(\"web-styling\" as Subcategory, \"Styling\", {\n      domain: \"web\" as Domain,\n      order: 2,\n    }),\n    \"api-api\": createMockCategory(\"api-api\" as Subcategory, \"Backend Framework\", {\n      domain: \"api\" as Domain,\n      exclusive: true,\n      required: true,\n    }),\n    \"api-database\": createMockCategory(\"api-database\" as Subcategory, \"Database\", {\n      domain: \"api\" as Domain,\n      order: 1,\n    }),\n    \"web-testing\": createMockCategory(\"web-testing\" as Subcategory, \"Testing\", {\n      domain: \"shared\" as Domain,\n      exclusive: false,\n      order: 10,\n    }),\n    \"shared-methodology\": createMockCategory(\"shared-methodology\" as Subcategory, \"Methodology\", {\n      domain: \"shared\" as Domain,\n      exclusive: false,\n      required: false,\n      order: 11,\n    }),\n  } as Record<Subcategory, CategoryDefinition>;\n\n  const suggestedStacks: ResolvedStack[] = [\n    createMockResolvedStack(\"nextjs-fullstack\", \"Next.js Fullstack\", {\n      description: \"Complete Next.js stack with React and Hono\",\n      audience: [\"startups\", \"enterprise\"],\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      audience: [\"startups\"],\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  const displayNameToId = {\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    \"investigation-requirements\": \"meta-methodology-investigation-requirements\",\n    \"anti-over-engineering\": \"meta-methodology-anti-over-engineering\",\n    \"success-criteria\": \"meta-methodology-success-criteria\",\n    \"write-verification\": \"meta-methodology-write-verification\",\n    \"improvement-protocol\": \"meta-methodology-improvement-protocol\",\n    \"context-management\": \"meta-methodology-context-management\",\n    // Double cast needed: object literal's string keys are not assignable to branded\n    // SkillDisplayName/SkillId types without going through `unknown` first (boundary cast)\n  } as unknown as Record<SkillDisplayName, SkillId>;\n\n  const displayNames = {} as Record<SkillId, SkillDisplayName>;\n  for (const [displayName, fullId] of typedEntries(displayNameToId)) {\n    (displayNames as Record<string, string>)[fullId] = displayName;\n  }\n\n  return createMockMatrix(skills, {\n    categories,\n    suggestedStacks,\n    displayNameToId,\n    displayNames,\n    ...overrides,\n  });\n}\n\n/**\n * Builds a lightweight test matrix with 4 skills, 4 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 Subcategory IDs — see createComprehensiveMatrix comment\n  const skills = {\n    \"web-framework-react\": getTestSkill(\"react\", { category: \"web-framework\" }),\n    \"web-state-zustand\": getTestSkill(\"zustand\", { category: \"web-client-state\" }),\n    \"api-framework-hono\": getTestSkill(\"hono\", { category: \"api-api\" }),\n    \"web-testing-vitest\": getTestSkill(\"vitest\", { category: \"web-testing\" }),\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\": createMockCategory(\"web-framework\" as Subcategory, \"Framework\", {\n        domain: \"web\" as Domain,\n        exclusive: true,\n        required: true,\n      }),\n      \"web-client-state\": createMockCategory(\"web-client-state\" as Subcategory, \"State\", {\n        domain: \"web\" as Domain,\n        order: 1,\n      }),\n      \"api-api\": createMockCategory(\"api-api\" as Subcategory, \"Backend Framework\", {\n        domain: \"api\" as Domain,\n        exclusive: true,\n        required: true,\n      }),\n      \"web-testing\": createMockCategory(\"web-testing\" as Subcategory, \"Testing Framework\", {\n        domain: \"shared\" as Domain,\n        exclusive: false,\n      }),\n    } as Record<Subcategory, 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. Adds methodology skills (DEFAULT_PRESELECTED_SKILLS)\n * 4. 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, matrix));\n  }\n\n  const methodologySkills = store.getDefaultMethodologySkills();\n  for (const skill of methodologySkills) {\n    if (!allSkills.includes(skill)) {\n      allSkills.push(skill);\n    }\n  }\n\n  const validation = validateSelection(allSkills, matrix);\n\n  return {\n    selectedSkills: allSkills,\n    selectedAgents: store.selectedAgents,\n    selectedStackId: store.selectedStackId,\n    domainSelections: store.domainSelections,\n    selectedDomains: store.selectedDomains,\n    sourceSelections: store.sourceSelections,\n    expertMode: store.expertMode,\n    installMode: store.installMode,\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 subcategory per skill.\n */\nexport function simulateSkillSelections(\n  skillIds: SkillId[],\n  matrix: MergedSkillsMatrix,\n  selectedDomains: string[],\n): void {\n  const domainSelections: DomainSelections = {};\n\n  for (const skillId of skillIds) {\n    const skill = matrix.skills[skillId];\n    if (!skill) continue;\n\n    // Boundary cast: skill.category is a Subcategory at runtime\n    const subcategory = skill.category as Subcategory;\n    const categoryDef = matrix.categories[subcategory];\n    const domain = categoryDef?.domain;\n    if (!domain) continue;\n\n    if (!domainSelections[domain]) {\n      domainSelections[domain] = {};\n    }\n    if (!domainSelections[domain][subcategory]) {\n      domainSelections[domain][subcategory] = [];\n    }\n    if (!domainSelections[domain][subcategory].includes(skillId)) {\n      domainSelections[domain][subcategory].push(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\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 { getTestSkill, TEST_SKILLS, TEST_CATEGORIES, TEST_MATRICES } from \"./test-fixtures\";\nexport type { TestSkillName } from \"./test-fixtures\";\n"],"mappings":"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","names":[]}

package/dist/{chunk-MHET2RG2.js → chunk-3S4GIO4B.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CLI_COLORS
-} from "./chunk-PP7NDFFE.js";
+} from "./chunk-FVN5PFFY.js";
 import {
   init_esm_shims
 } from "./chunk-DHET7RCE.js";
@@ -81,4 +81,4 @@ export {
   formatStepLabel,
   WizardTabs
 };
-//# sourceMappingURL=chunk-MHET2RG2.js.map
+//# sourceMappingURL=chunk-3S4GIO4B.js.map

package/dist/{chunk-UXNHU7Y7.js → chunk-473YHDYQ.js}

@@ -312,7 +312,6 @@ var skillMetadataLoaderSchema = z.object({
   category: categoryPathSchema.optional(),
   categoryExclusive: z.boolean().optional(),
   author: z.string().optional(),
-  version: z.union([z.string(), z.number()]).transform(String).optional(),
   tags: z.array(z.string()).optional(),
   requires: z.array(skillIdSchema).optional(),
   compatibleWith: z.array(skillIdSchema).optional(),
@@ -388,6 +387,8 @@ var projectConfigLoaderSchema = z.object({
   expertMode: z.boolean().optional(),
   /** Selected domains from the wizard (persisted for edit mode restoration) */
   domains: z.array(domainSchema).optional(),
+  /** Selected agents from the wizard (persisted for edit mode restoration) */
+  selectedAgents: z.array(z.string()).optional(),
   /** Agent-to-subcategory-to-skill mappings from selected stack (accepts same formats as stacks.yaml) */
   stack: z.record(z.string(), stackAgentConfigSchema).optional(),
   /** Skills source path or URL (e.g., "github:my-org/skills") */
@@ -551,14 +552,6 @@ var marketplaceSchema = z.object({
   metadata: marketplaceMetadataSchema.optional(),
   plugins: z.array(marketplacePluginSchema).min(1)
 });
-var versionedMetadataSchema = z.object({
-  /** Content version integer (incremented on each publish) */
-  version: z.number(),
-  /** Short SHA hash of skill content for change detection */
-  contentHash: z.string().optional(),
-  /** ISO date of last update */
-  updated: z.string().optional()
-}).passthrough();
 var defaultMappingsSchema = z.object({
   /** Maps skill path patterns to the agent IDs that should receive them */
   skillToAgents: z.record(z.string(), z.array(z.string())),
@@ -696,8 +689,6 @@ var metadataValidationSchema = z.object({
   categoryExclusive: z.boolean().optional(),
   /** Author handle — must start with @ (e.g., "@vince") */
   author: z.string().regex(/^@[a-z][a-z0-9-]*$/),
-  /** Content version integer, incremented on each publish */
-  version: z.number().int().min(1).optional(),
   /** Short display name for the wizard grid (max 30 chars) */
   cliName: z.string().min(1).max(30),
   /** One-line description for the wizard (max 60 chars) */
@@ -855,4 +846,4 @@ export {
   validateNestingDepth,
   warnUnknownFields
 };
-//# sourceMappingURL=chunk-UXNHU7Y7.js.map
+//# sourceMappingURL=chunk-473YHDYQ.js.map