@agents-inc/cli 0.45.0 → 0.47.0

package/CHANGELOG.md

@@ -9,6 +9,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.47.0] - 2026-02-25
+
+**Custom domain support, source validation, wizard improvements, dead code cleanup**
+
+- Domain field on skill metadata and agent YAML for custom marketplace support
+- `validate --source` command for source repository validation
+- Fix custom skill ID rejection in stacks validation
+- Remove redundant verifyHash and legacy slash-in-skill-ID code
+
+See [changelogs/0.47.0.md](./changelogs/0.47.0.md) for full details.
+
+---
+
+## [0.46.0] - 2026-02-24
+
+**Custom extensibility, new commands, agent-mapping removal, wizard improvements**
+
+- Custom extensibility foundation: runtime-extensible schemas for custom skills, agents, categories, and domains from private marketplaces
+- Remove agent-mappings.yaml and skill-to-agent routing — all skills assigned to all selected agents
+- Promote `eject templates` to first-class type, add `new marketplace` command, improve `new skill` and `new agent`
+- Dynamic wizard domains/agents from merged matrix, fix stack domain preselection
+- Fix plugin mode marketplace registration (strip `github:` prefix)
+
+See [changelogs/0.46.0.md](./changelogs/0.46.0.md) for full details.
+
+---
+
 ## [0.45.0] - 2026-02-22
 
 **Persist agent selection, skill relation validation, eject fix, test fixtures**

package/dist/{chunk-V43QDMYQ.js → chunk-2RQYJFKA.js}

@@ -2,7 +2,7 @@
 import {
   CLI_BIN_NAME,
   DEFAULT_BRANDING
-} from "./chunk-FVN5PFFY.js";
+} from "./chunk-FTD5Z6QD.js";
 import {
   init_esm_shims
 } from "./chunk-DHET7RCE.js";
@@ -67,4 +67,4 @@ export {
   INFO_MESSAGES,
   DRY_RUN_MESSAGES
 };
-//# sourceMappingURL=chunk-V43QDMYQ.js.map
+//# sourceMappingURL=chunk-2RQYJFKA.js.map

package/dist/{chunk-ABE55TEU.js → chunk-3APMMQUA.js}

@@ -5,7 +5,7 @@ import {
 import {
   CLI_COLORS,
   SCROLL_VIEWPORT
-} from "./chunk-FVN5PFFY.js";
+} from "./chunk-FTD5Z6QD.js";
 import {
   init_esm_shims
 } from "./chunk-DHET7RCE.js";
@@ -209,14 +209,21 @@ var CategorySection = ({
   isLocked,
   isFocused,
   focusedOptionIndex,
-  showLabels
+  showLabels,
+  expertMode
 }) => {
+  const selectedCount = options.filter((o) => o.selected).length;
+  const selectionCounter = expertMode ? null : category.exclusive ? `(${selectedCount} of 1)` : `(${selectedCount} selected)`;
   return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: isFirst ? 0 : 1, children: [
     /* @__PURE__ */ jsxs(Box, { flexDirection: "row", children: [
       /* @__PURE__ */ jsx(Text, { dimColor: isLocked, color: isFocused ? "#fff" : "gray", children: category.displayName }),
       category.required && /* @__PURE__ */ jsxs(Text, { color: isLocked ? CLI_COLORS.NEUTRAL : CLI_COLORS.ERROR, dimColor: isLocked, children: [
         " ",
         SYMBOL_REQUIRED
+      ] }),
+      selectionCounter && /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+        " ",
+        selectionCounter
       ] })
     ] }),
     /* @__PURE__ */ jsx(Box, { flexDirection: "row", flexWrap: "wrap", marginTop: 0, children: options.map((option, index) => /* @__PURE__ */ jsx(
@@ -360,6 +367,7 @@ var CategoryGrid = ({
         isFocused: index === focusedRow,
         focusedOptionIndex: focusedCol,
         showLabels,
+        expertMode,
         isFirst: index === 0
       }
     ) }, category.id);
@@ -373,4 +381,4 @@ var CategoryGrid = ({
 export {
   CategoryGrid
 };
-//# sourceMappingURL=chunk-ABE55TEU.js.map
+//# sourceMappingURL=chunk-3APMMQUA.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/components/wizard/category-grid.tsx","../src/cli/components/hooks/use-category-grid-input.ts"],"sourcesContent":["import React, { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\n\nimport { Box, type DOMElement, Text, measureElement } from \"ink\";\n\nimport { CLI_COLORS, SCROLL_VIEWPORT } from \"../../consts.js\";\nimport type { SkillId, Subcategory } from \"../../types/index.js\";\nimport { isSectionLocked, useCategoryGridInput } from \"../hooks/use-category-grid-input.js\";\nimport { useFocusedListItem } from \"../hooks/use-focused-list-item.js\";\n\nexport type OptionState = \"normal\" | \"recommended\" | \"discouraged\" | \"disabled\";\n\nexport type CategoryOption = {\n  id: SkillId;\n  label: string;\n  state: OptionState;\n  stateReason?: string;\n  selected: boolean;\n  local?: boolean;\n  installed?: boolean;\n};\n\nexport type CategoryRow = {\n  id: Subcategory;\n  displayName: string;\n  required: boolean;\n  exclusive: boolean;\n  options: CategoryOption[];\n};\n\nexport type CategoryGridProps = {\n  categories: CategoryRow[];\n  /** Available height in terminal lines for the scrollable viewport. 0 = no constraint. */\n  availableHeight?: number;\n  showLabels: boolean;\n  expertMode: boolean;\n  onToggle: (categoryId: Subcategory, technologyId: SkillId) => void;\n  onToggleLabels: () => void;\n  /** Optional initial focus row (default: 0). Use with React `key` to reset. */\n  defaultFocusedRow?: number;\n  /** Optional initial focus col (default: 0). Use with React `key` to reset. */\n  defaultFocusedCol?: number;\n  /** Optional callback fired whenever the focused position changes */\n  onFocusChange?: (row: number, col: number) => void;\n};\n\nconst SYMBOL_REQUIRED = \"*\";\n\n/**\n * Priority order for skill states in the initial sort.\n * Lower numbers appear first. Selected skills are sorted above all states.\n */\nconst STATE_PRIORITY: Record<OptionState, number> = {\n  recommended: 0,\n  normal: 1,\n  discouraged: 2,\n  disabled: 3,\n};\n\n/**\n * Sort options by: selected first, then by state priority.\n * Within each group, original matrix order is preserved (stable sort).\n */\nconst stableSortByState = (options: CategoryOption[]): CategoryOption[] => {\n  return [...options].sort((a, b) => {\n    if (a.selected !== b.selected) return a.selected ? -1 : 1;\n    return STATE_PRIORITY[a.state] - STATE_PRIORITY[b.state];\n  });\n};\n\nconst findNextValidOption = (\n  options: CategoryOption[],\n  currentIndex: number,\n  direction: 1 | -1,\n  wrap = true,\n): number => {\n  const length = options.length;\n  if (length === 0) return currentIndex;\n\n  let index = currentIndex + direction;\n\n  if (wrap) {\n    if (index < 0) index = length - 1;\n    if (index >= length) index = 0;\n  } else {\n    if (index < 0) index = 0;\n    if (index >= length) index = length - 1;\n  }\n\n  return index;\n};\n\ntype SkillTagProps = {\n  option: CategoryOption;\n  isFocused: boolean;\n  isLocked: boolean;\n  showLabels: boolean;\n};\n\nconst getCompatibilityLabel = (option: CategoryOption, isLocked: boolean): string | null => {\n  if (option.selected) return \"(selected)\";\n  if (isLocked || option.state === \"disabled\") return \"(disabled)\";\n  if (option.state === \"recommended\") return \"(recommended)\";\n  if (option.state === \"discouraged\") return \"(discouraged)\";\n  return null;\n};\n\nconst SkillTag: React.FC<SkillTagProps> = ({ option, isFocused, isLocked, showLabels }) => {\n  const getTextColor = (): string => {\n    if (option.state === \"disabled\" && option.selected) return CLI_COLORS.PRIMARY;\n    if (isLocked || option.state === \"disabled\") return CLI_COLORS.NEUTRAL;\n    if (option.selected) return CLI_COLORS.PRIMARY;\n    if (option.state === \"recommended\") return CLI_COLORS.UNFOCUSED;\n    if (option.state === \"discouraged\") return CLI_COLORS.WARNING;\n\n    return CLI_COLORS.NEUTRAL;\n  };\n\n  const getStateBorderColor = (): string => {\n    if (option.state === \"disabled\" && option.selected) return CLI_COLORS.PRIMARY;\n    if (isLocked || option.state === \"disabled\") return CLI_COLORS.NEUTRAL;\n    if (option.selected) return CLI_COLORS.PRIMARY;\n    if (option.state === \"recommended\") return CLI_COLORS.UNFOCUSED;\n    if (option.state === \"discouraged\") return CLI_COLORS.WARNING;\n    return CLI_COLORS.UNFOCUSED;\n  };\n\n  const textColor = getTextColor();\n  const compatibilityLabel = showLabels ? getCompatibilityLabel(option, isLocked) : null;\n\n  return (\n    <Box\n      marginRight={1}\n      borderColor={isFocused ? getStateBorderColor() : CLI_COLORS.NEUTRAL}\n      borderStyle=\"single\"\n      flexShrink={0}\n    >\n      <>\n        <Text color={textColor} bold dimColor={option.state === \"disabled\" && option.selected}>\n          {\" \"}\n          {option.label}{\" \"}\n        </Text>\n        {compatibilityLabel && <Text dimColor>{compatibilityLabel} </Text>}\n      </>\n    </Box>\n  );\n};\n\ntype CategorySectionProps = {\n  isFirst: boolean;\n  category: CategoryRow;\n  options: CategoryOption[];\n  isLocked: boolean;\n  isFocused: boolean;\n  focusedOptionIndex: number;\n  showLabels: boolean;\n  expertMode: boolean;\n};\n\nconst CategorySection: React.FC<CategorySectionProps> = ({\n  isFirst,\n  category,\n  options,\n  isLocked,\n  isFocused,\n  focusedOptionIndex,\n  showLabels,\n  expertMode,\n}) => {\n  const selectedCount = options.filter((o) => o.selected).length;\n\n  const selectionCounter = expertMode\n    ? null\n    : category.exclusive\n      ? `(${selectedCount} of 1)`\n      : `(${selectedCount} selected)`;\n\n  return (\n    <Box flexDirection=\"column\" marginTop={isFirst ? 0 : 1}>\n      <Box flexDirection=\"row\">\n        <Text dimColor={isLocked} color={isFocused ? \"#fff\" : \"gray\"}>\n          {category.displayName}\n        </Text>\n        {category.required && (\n          <Text color={isLocked ? CLI_COLORS.NEUTRAL : CLI_COLORS.ERROR} dimColor={isLocked}>\n            {\" \"}\n            {SYMBOL_REQUIRED}\n          </Text>\n        )}\n        {selectionCounter && <Text dimColor> {selectionCounter}</Text>}\n      </Box>\n\n      <Box flexDirection=\"row\" flexWrap=\"wrap\" marginTop={0}>\n        {options.map((option, index) => (\n          <SkillTag\n            key={option.id}\n            option={option}\n            isFocused={isFocused && index === focusedOptionIndex && !isLocked}\n            isLocked={isLocked}\n            showLabels={showLabels}\n          />\n        ))}\n      </Box>\n    </Box>\n  );\n};\n\ntype ProcessedCategory = CategoryRow & { sortedOptions: CategoryOption[] };\n\nexport const CategoryGrid: React.FC<CategoryGridProps> = ({\n  categories,\n  availableHeight = 0,\n  showLabels,\n  expertMode,\n  onToggle,\n  onToggleLabels,\n  defaultFocusedRow = 0,\n  defaultFocusedCol = 0,\n  onFocusChange,\n}) => {\n  // Cache the initial sort order per category so toggling selections does not reorder skills.\n  // The ref resets when the component remounts (e.g., domain change via key={activeDomain}).\n  const initialOrderRef = useRef<Map<string, SkillId[]>>(new Map());\n\n  const processedCategories = useMemo(\n    () =>\n      categories.map((category) => {\n        const cached = initialOrderRef.current.get(category.id);\n        if (cached) {\n          const orderMap = new Map(cached.map((id, idx) => [id, idx]));\n          const sorted = [...category.options].sort((a, b) => {\n            const aIdx = orderMap.get(a.id) ?? Infinity;\n            const bIdx = orderMap.get(b.id) ?? Infinity;\n            return aIdx - bIdx;\n          });\n          return { ...category, sortedOptions: sorted };\n        }\n        const sorted = stableSortByState(category.options);\n        initialOrderRef.current.set(\n          category.id,\n          sorted.map((o) => o.id),\n        );\n        return { ...category, sortedOptions: sorted };\n      }),\n    [categories],\n  );\n\n  const getColCount = useCallback(\n    (row: number): number => processedCategories[row]?.sortedOptions.length ?? 0,\n    [processedCategories],\n  );\n\n  const isRowLocked = useCallback(\n    (row: number): boolean => {\n      const cat = processedCategories[row];\n      return cat ? isSectionLocked(cat.id, categories) : false;\n    },\n    [processedCategories, categories],\n  );\n\n  const findValidCol = useCallback(\n    (row: number, currentCol: number, direction: 1 | -1): number => {\n      const options = processedCategories[row]?.sortedOptions || [];\n      const catId = processedCategories[row]?.id;\n      if (catId && isSectionLocked(catId, categories)) return currentCol;\n      return findNextValidOption(options, currentCol, direction, true);\n    },\n    [processedCategories, categories],\n  );\n\n  const { focusedRow, focusedCol, setFocused, moveFocus } = useFocusedListItem(\n    processedCategories.length,\n    getColCount,\n    {\n      wrap: true,\n      isRowLocked,\n      findValidCol,\n      onChange: onFocusChange,\n      initialRow: defaultFocusedRow,\n      initialCol: defaultFocusedCol,\n    },\n  );\n\n  useCategoryGridInput({\n    processedCategories,\n    categories,\n    focusedRow,\n    focusedCol,\n    setFocused,\n    moveFocus,\n    onToggle,\n    onToggleLabels,\n  });\n\n  const sectionRefs = useRef<(DOMElement | null)[]>([]);\n  const [sectionHeights, setSectionHeights] = useState<number[]>([]);\n  const [scrollTopPx, setScrollTopPx] = useState(0);\n\n  const setSectionRef = useCallback((index: number, el: DOMElement | null) => {\n    sectionRefs.current[index] = el;\n  }, []);\n\n  useEffect(() => {\n    const heights = sectionRefs.current.map((el) => {\n      if (el) {\n        const { height } = measureElement(el);\n        return height;\n      }\n      return 0;\n    });\n    setSectionHeights((prev) => {\n      if (prev.length === heights.length && prev.every((h, i) => h === heights[i])) {\n        return prev;\n      }\n      return heights;\n    });\n  });\n\n  const scrollEnabled = availableHeight > 0 && availableHeight >= SCROLL_VIEWPORT.MIN_VIEWPORT_ROWS;\n\n  useEffect(() => {\n    if (!scrollEnabled || sectionHeights.length === 0) return;\n\n    let topOfFocused = 0;\n    for (let i = 0; i < focusedRow; i++) {\n      topOfFocused += sectionHeights[i] ?? 0;\n    }\n    const focusedHeight = sectionHeights[focusedRow] ?? 0;\n    const bottomOfFocused = topOfFocused + focusedHeight;\n\n    setScrollTopPx((prev) => {\n      if (topOfFocused < prev) {\n        return topOfFocused;\n      }\n      if (bottomOfFocused > prev + availableHeight) {\n        return bottomOfFocused - availableHeight;\n      }\n      return prev;\n    });\n  }, [focusedRow, sectionHeights, scrollEnabled, availableHeight]);\n\n  if (categories.length === 0) {\n    return (\n      <Box flexDirection=\"column\">\n        <Text dimColor>No categories to display.</Text>\n      </Box>\n    );\n  }\n\n  const sectionElements = processedCategories.map((category, index) => {\n    const isLocked = isSectionLocked(category.id, categories);\n\n    return (\n      <Box key={category.id} ref={(el) => setSectionRef(index, el)} flexShrink={0}>\n        <CategorySection\n          category={category}\n          options={category.sortedOptions}\n          isLocked={isLocked}\n          isFocused={index === focusedRow}\n          focusedOptionIndex={focusedCol}\n          showLabels={showLabels}\n          expertMode={expertMode}\n          isFirst={index === 0}\n        />\n      </Box>\n    );\n  });\n\n  // When no height constraint, render flat (tests, or before first measurement)\n  if (!scrollEnabled) {\n    return (\n      <Box flexDirection=\"column\" flexGrow={1} overflow=\"hidden\">\n        {sectionElements}\n      </Box>\n    );\n  }\n\n  return (\n    <Box flexDirection=\"column\" height={availableHeight} overflow=\"hidden\">\n      <Box flexDirection=\"column\" marginTop={scrollTopPx > 0 ? -scrollTopPx : 0} flexShrink={0}>\n        {sectionElements}\n      </Box>\n    </Box>\n  );\n};\n","import { useCallback, useEffect, useRef } from \"react\";\nimport { useInput } from \"ink\";\n\nimport type { Subcategory, SkillId } from \"../../types/index.js\";\nimport type { CategoryOption, CategoryRow } from \"../wizard/category-grid.js\";\n\nconst FRAMEWORK_CATEGORY_ID = \"web-framework\";\n\n// Locked = non-framework section when no framework is selected\nexport const isSectionLocked = (categoryId: Subcategory, categories: CategoryRow[]): boolean => {\n  if (categoryId === FRAMEWORK_CATEGORY_ID) {\n    return false;\n  }\n\n  const frameworkCategory = categories.find((cat) => cat.id === FRAMEWORK_CATEGORY_ID);\n  if (!frameworkCategory) return false;\n\n  return !frameworkCategory.options.some((opt) => opt.selected);\n};\n\nexport const findValidStartColumn = (_options: CategoryOption[]): number => {\n  return 0;\n};\n\n/** Find next unlocked section index (wrapping, direction: forward) */\nexport const findNextUnlockedIndex = (\n  processed: { id: Subcategory; sortedOptions: CategoryOption[] }[],\n  currentIndex: number,\n  allCategories: CategoryRow[],\n): number => {\n  const length = processed.length;\n  if (length === 0) return currentIndex;\n\n  let index = currentIndex;\n  let attempts = 0;\n\n  while (attempts < length) {\n    index += 1;\n    if (index >= length) index = 0;\n\n    const category = processed[index];\n    if (category && !isSectionLocked(category.id, allCategories)) {\n      return index;\n    }\n\n    attempts++;\n  }\n\n  return currentIndex;\n};\n\ntype ProcessedCategory = CategoryRow & { sortedOptions: CategoryOption[] };\n\ntype UseCategoryGridInputOptions = {\n  processedCategories: ProcessedCategory[];\n  categories: CategoryRow[];\n  focusedRow: number;\n  focusedCol: number;\n  setFocused: (row: number, col: number) => void;\n  moveFocus: (direction: \"up\" | \"down\" | \"left\" | \"right\") => void;\n  onToggle: (categoryId: Subcategory, technologyId: SkillId) => void;\n  onToggleLabels: () => void;\n};\n\nexport function useCategoryGridInput({\n  processedCategories,\n  categories,\n  focusedRow,\n  focusedCol,\n  setFocused,\n  moveFocus,\n  onToggle,\n  onToggleLabels,\n}: UseCategoryGridInputOptions): void {\n  const currentRow = processedCategories[focusedRow];\n  const currentOptions = currentRow?.sortedOptions || [];\n  const currentLocked = currentRow ? isSectionLocked(currentRow.id, categories) : false;\n\n  // Adjust column when current row's options change externally (e.g. option becomes disabled)\n  useEffect(() => {\n    if (!currentRow) return;\n\n    const maxCol = currentOptions.length - 1;\n    if (focusedCol > maxCol) {\n      const newCol = Math.max(0, maxCol);\n      setFocused(focusedRow, newCol);\n    }\n  }, [focusedRow, currentOptions, focusedCol, setFocused, currentRow]);\n\n  // Bounce off locked sections when a section becomes locked (e.g. framework deselected)\n  useEffect(() => {\n    if (currentRow && currentLocked) {\n      const nextUnlocked = findNextUnlockedIndex(processedCategories, focusedRow, categories);\n      if (nextUnlocked !== focusedRow) {\n        const newRowOptions = processedCategories[nextUnlocked]?.sortedOptions || [];\n        const newCol = findValidStartColumn(newRowOptions);\n        setFocused(nextUnlocked, newCol);\n      }\n    }\n  }, [currentRow, currentLocked, focusedRow, processedCategories, categories, setFocused]);\n\n  // Store the latest handler in a ref so that the useInput effect never needs to\n  // re-register on the event emitter. This avoids a stale-closure race condition\n  // where, after a domain switch (CategoryGrid remount via key={activeDomain}),\n  // the useInput effect may not yet have re-registered the updated handler when\n  // the first keypress arrives — causing the first space press to be silently lost.\n  type InputKey = {\n    leftArrow: boolean;\n    rightArrow: boolean;\n    upArrow: boolean;\n    downArrow: boolean;\n    tab: boolean;\n    shift: boolean;\n  };\n\n  const handlerRef = useRef<((input: string, key: InputKey) => void) | null>(null);\n  handlerRef.current = (input: string, key: InputKey) => {\n    if (key.tab && key.shift) {\n      onToggleLabels();\n      return;\n    }\n\n    if (key.tab && !key.shift) {\n      const nextSection = findNextUnlockedIndex(processedCategories, focusedRow, categories);\n      if (nextSection !== focusedRow) {\n        const newRowOptions = processedCategories[nextSection]?.sortedOptions || [];\n        const newCol = findValidStartColumn(newRowOptions);\n        setFocused(nextSection, newCol);\n      }\n      return;\n    }\n\n    if (input === \"d\" || input === \"D\") {\n      onToggleLabels();\n      return;\n    }\n\n    if (input === \" \") {\n      if (currentLocked) return;\n      const currentOption = currentOptions[focusedCol];\n      if (currentOption && currentOption.state !== \"disabled\") {\n        onToggle(currentRow.id, currentOption.id);\n      }\n      return;\n    }\n\n    const isLeft = key.leftArrow || input === \"h\";\n    const isRight = key.rightArrow || input === \"l\";\n    const isUp = key.upArrow || input === \"k\";\n    const isDown = key.downArrow || input === \"j\";\n\n    if (isLeft) {\n      if (currentLocked) return;\n      moveFocus(\"left\");\n    } else if (isRight) {\n      if (currentLocked) return;\n      moveFocus(\"right\");\n    } else if (isUp) {\n      moveFocus(\"up\");\n    } else if (isDown) {\n      moveFocus(\"down\");\n    }\n  };\n\n  // Stable handler reference — never changes, so useInput's effect registers once\n  const stableHandler = useCallback((input: string, key: InputKey) => {\n    handlerRef.current?.(input, key);\n  }, []);\n\n  useInput(stableHandler);\n}\n"],"mappings":"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","names":["useCallback","useEffect","useRef","useRef","sorted","useCallback","useEffect"]}

package/dist/{chunk-KWWLPPHF.js → chunk-B4QYXVPZ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CLI_COLORS
-} from "./chunk-FVN5PFFY.js";
+} from "./chunk-FTD5Z6QD.js";
 import {
   init_esm_shims
 } from "./chunk-DHET7RCE.js";
@@ -17,4 +17,4 @@ var ViewTitle = ({ children }) => {
 export {
   ViewTitle
 };
-//# sourceMappingURL=chunk-KWWLPPHF.js.map
+//# sourceMappingURL=chunk-B4QYXVPZ.js.map

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

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  KEBAB_CASE_PATTERN
+} from "./chunk-FTD5Z6QD.js";
 import {
   init_esm_shims
 } from "./chunk-DHET7RCE.js";
@@ -90,7 +93,14 @@ async function copy(src, dest) {
 // src/cli/lib/schemas.ts
 init_esm_shims();
 import { z } from "zod";
-var domainSchema = z.enum(["web", "api", "cli", "mobile", "shared"]);
+var customExtensions = {
+  categories: /* @__PURE__ */ new Set(),
+  domains: /* @__PURE__ */ new Set(),
+  agentNames: /* @__PURE__ */ new Set(),
+  skillIds: /* @__PURE__ */ new Set()
+};
+var DOMAIN_VALUES = ["web", "api", "cli", "mobile", "shared"];
+var domainSchema = z.enum(DOMAIN_VALUES);
 var skillSourceTypeSchema = z.enum([
   "public",
   "private",
@@ -144,7 +154,6 @@ var SUBCATEGORY_VALUES = [
   "cli-testing"
 ];
 var subcategorySchema = z.enum(SUBCATEGORY_VALUES);
-var stackSubcategorySchema = z.enum(SUBCATEGORY_VALUES);
 var agentNameSchema = z.enum([
   "web-developer",
   "api-developer",
@@ -264,15 +273,67 @@ var skillDisplayNameSchema = z.enum([
   "context-management"
 ]);
 var SKILL_ID_PATTERN = /^(web|api|cli|mobile|infra|meta|security)-.+-.+$/;
+function isValidSkillId(id) {
+  return SKILL_ID_PATTERN.test(id) || customExtensions.skillIds.has(id);
+}
 var skillIdSchema = z.string().regex(
   SKILL_ID_PATTERN,
   "Must be a valid skill ID (e.g., 'web-framework-react')"
 );
+var extensibleDomainSchema = z.string().refine(
+  (val) => domainSchema.safeParse(val).success || customExtensions.domains.has(val),
+  { message: "Must be a valid domain" }
+);
+var extensibleSkillIdSchema = z.string().refine(
+  (val) => skillIdSchema.safeParse(val).success || customExtensions.skillIds.has(val),
+  { message: "Must be a valid skill ID" }
+);
+var extensibleSubcategorySchema = z.string().refine(
+  (val) => subcategorySchema.safeParse(val).success || customExtensions.categories.has(val),
+  { message: "Must be a valid subcategory" }
+);
+var extensibleAgentNameSchema = z.string().refine(
+  (val) => agentNameSchema.safeParse(val).success || customExtensions.agentNames.has(val),
+  { message: "Must be a valid agent name" }
+);
+function validateCategoryField(val, ctx) {
+  if (!val.category) return;
+  if (val.custom) {
+    if (!KEBAB_CASE_PATTERN.test(val.category)) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["category"],
+        message: "Custom category must be kebab-case"
+      });
+    }
+    return;
+  }
+  const result = categoryPathSchema.safeParse(val.category);
+  if (!result.success) {
+    for (const issue of result.error.issues) {
+      ctx.addIssue({ ...issue, path: ["category"] });
+    }
+  }
+}
+function validateExtensibleRecordKeys(builtinSet, extensionSet, label) {
+  return (val, ctx) => {
+    for (const key of Object.keys(val)) {
+      if (!builtinSet.has(key) && !extensionSet.has(key)) {
+        ctx.addIssue({
+          code: "custom",
+          path: [key],
+          message: `Invalid ${label} '${key}'.`
+        });
+      }
+    }
+  };
+}
 var categoryPathSchema = z.string().refine(
   (val) => {
     if (val === "local") return true;
     if (/^(web|api|cli|mobile|infra|meta|security|shared)-.+$/.test(val)) return true;
-    return subcategorySchema.safeParse(val).success;
+    if (subcategorySchema.safeParse(val).success) return true;
+    return customExtensions.categories.has(val);
   },
   {
     message: "Must be a valid category path (e.g., 'web-framework', 'shared-testing', or 'local')"
@@ -298,7 +359,7 @@ var strictHooksRecordSchema = z.record(
   z.array(strictAgentHookDefinitionSchema)
 );
 var skillAssignmentSchema = z.object({
-  id: skillIdSchema,
+  id: extensibleSkillIdSchema,
   preloaded: z.boolean().optional(),
   local: z.boolean().optional(),
   path: z.string().optional()
@@ -309,14 +370,17 @@ var skillFrontmatterLoaderSchema = z.object({
   model: modelNameSchema.optional()
 });
 var skillMetadataLoaderSchema = z.object({
-  category: categoryPathSchema.optional(),
+  // Field accepts any string; cross-field validation in superRefine enforces strict/custom rules
+  category: z.string().optional(),
   categoryExclusive: z.boolean().optional(),
   author: z.string().optional(),
   tags: z.array(z.string()).optional(),
-  requires: z.array(skillIdSchema).optional(),
-  compatibleWith: z.array(skillIdSchema).optional(),
-  conflictsWith: z.array(skillIdSchema).optional()
-}).passthrough();
+  requires: z.array(extensibleSkillIdSchema).optional(),
+  compatibleWith: z.array(extensibleSkillIdSchema).optional(),
+  conflictsWith: z.array(extensibleSkillIdSchema).optional(),
+  domain: extensibleDomainSchema.optional(),
+  custom: z.boolean().optional()
+}).passthrough().superRefine(validateCategoryField);
 var pluginAuthorSchema = z.object({
   name: z.string().min(1),
   email: z.string().optional()
@@ -344,7 +408,7 @@ var pluginManifestValidationSchema = z.object({
   hooks: z.union([z.string(), strictHooksRecordSchema]).optional()
 }).strict();
 var agentYamlConfigSchema = z.object({
-  id: agentNameSchema,
+  id: extensibleAgentNameSchema,
   title: z.string(),
   description: z.string(),
   model: modelNameSchema.optional(),
@@ -352,24 +416,22 @@ var agentYamlConfigSchema = z.object({
   disallowedTools: z.array(z.string()).optional(),
   permissionMode: permissionModeSchema.optional(),
   hooks: hooksRecordSchema.optional(),
-  outputFormat: z.string().optional()
+  outputFormat: z.string().optional(),
+  domain: extensibleDomainSchema.optional(),
+  custom: z.boolean().optional()
 });
-var skillAssignmentElementSchema = z.union([skillIdSchema, skillAssignmentSchema]);
-var stackSubcategoryValues = new Set(stackSubcategorySchema.options);
+var skillAssignmentElementSchema = z.union([extensibleSkillIdSchema, skillAssignmentSchema]);
+var stackSubcategoryValues = new Set(SUBCATEGORY_VALUES);
 var stackAgentConfigSchema = z.record(
   z.string(),
   z.union([skillAssignmentElementSchema, z.array(skillAssignmentElementSchema)])
-).superRefine((val, ctx) => {
-  for (const key of Object.keys(val)) {
-    if (!stackSubcategoryValues.has(key)) {
-      ctx.addIssue({
-        code: "custom",
-        path: [key],
-        message: `Invalid subcategory '${key}'. Must be one of: ${[...stackSubcategoryValues].join(", ")}`
-      });
-    }
-  }
-});
+).superRefine(
+  validateExtensibleRecordKeys(
+    stackSubcategoryValues,
+    customExtensions.categories,
+    "subcategory"
+  )
+);
 var projectConfigLoaderSchema = z.object({
   version: z.literal("1").optional(),
   /** Project/plugin name in kebab-case */
@@ -378,7 +440,7 @@ var projectConfigLoaderSchema = z.object({
   /** Agent IDs to compile (e.g., ["web-developer", "api-developer"]) */
   agents: z.array(z.string()).optional(),
   /** Flat list of all skill IDs used by this project */
-  skills: z.array(skillIdSchema).optional(),
+  skills: z.array(extensibleSkillIdSchema).optional(),
   /** Author handle (e.g., "@vince") */
   author: z.string().optional(),
   /** "local" = .claude/agents, "plugin" = .claude/plugins/ (DEFAULT_PLUGIN_NAME) */
@@ -386,7 +448,7 @@ var projectConfigLoaderSchema = z.object({
   /** Whether expert mode (advanced/niche skills) was enabled in the wizard */
   expertMode: z.boolean().optional(),
   /** Selected domains from the wizard (persisted for edit mode restoration) */
-  domains: z.array(domainSchema).optional(),
+  domains: z.array(extensibleDomainSchema).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) */
@@ -415,6 +477,8 @@ var projectConfigValidationSchema = 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 */
   stack: z.record(z.string(), stackAgentConfigSchema),
   /** Skills source path or URL (e.g., "github:my-org/skills") */
@@ -425,14 +489,15 @@ var projectConfigValidationSchema = z.object({
   agentsSource: z.string().optional()
 });
 var categoryDefinitionSchema = z.object({
-  id: subcategorySchema,
+  id: extensibleSubcategorySchema,
   displayName: z.string(),
   description: z.string(),
-  domain: domainSchema.optional(),
+  domain: extensibleDomainSchema.optional(),
   exclusive: z.boolean(),
   required: z.boolean(),
   order: z.number(),
-  icon: z.string().optional()
+  icon: z.string().optional(),
+  custom: z.boolean().optional()
 });
 var skillRefInYaml = z.string();
 var conflictRuleSchema = z.object({
@@ -465,11 +530,18 @@ var relationshipDefinitionsSchema = z.object({
   requires: z.array(requireRuleSchema),
   alternatives: z.array(alternativeGroupSchema)
 });
+var builtinSubcategoryValues = new Set(SUBCATEGORY_VALUES);
 var skillsMatrixConfigSchema = z.object({
   version: z.string(),
-  categories: z.record(subcategorySchema, categoryDefinitionSchema),
-  relationships: relationshipDefinitionsSchema,
-  skillAliases: z.record(skillDisplayNameSchema, skillIdSchema)
+  categories: z.record(z.string(), categoryDefinitionSchema).superRefine(
+    validateExtensibleRecordKeys(
+      builtinSubcategoryValues,
+      customExtensions.categories,
+      "category key"
+    )
+  ),
+  relationships: relationshipDefinitionsSchema.optional(),
+  skillAliases: z.record(z.string(), extensibleSkillIdSchema).optional()
 });
 var localRawMetadataSchema = z.object({
   /** Short name shown in the wizard grid (e.g., "my-custom-react") */
@@ -477,23 +549,28 @@ var localRawMetadataSchema = z.object({
   /** One-line description for the wizard */
   cliDescription: z.string().optional(),
   /** Subcategory to place this skill in (e.g., "web-framework") */
-  category: categoryPathSchema.optional(),
+  // Field accepts any string; cross-field validation in superRefine enforces strict/custom rules
+  category: z.string().optional(),
   /** If true, only one skill from this category can be selected */
   categoryExclusive: z.boolean().optional(),
   /** When an AI agent should invoke this skill */
   usageGuidance: z.string().optional(),
   tags: z.array(z.string()).optional(),
   /** Framework skills this is compatible with (for Build step filtering) */
-  compatibleWith: z.array(skillIdSchema).optional(),
+  compatibleWith: z.array(extensibleSkillIdSchema).optional(),
   /** Skills that cannot coexist with this one */
-  conflictsWith: z.array(skillIdSchema).optional(),
+  conflictsWith: z.array(extensibleSkillIdSchema).optional(),
   /** Skills that must be selected before this one */
-  requires: z.array(skillIdSchema).optional(),
+  requires: z.array(extensibleSkillIdSchema).optional(),
   /** Setup skills that must be installed first (e.g., env setup) */
-  requiresSetup: z.array(skillIdSchema).optional(),
+  requiresSetup: z.array(extensibleSkillIdSchema).optional(),
   /** Usage skills this setup skill configures (inverse relationship) */
-  providesSetupFor: z.array(skillIdSchema).optional()
-}).passthrough();
+  providesSetupFor: z.array(extensibleSkillIdSchema).optional(),
+  /** Explicit domain assignment (overrides inference from category prefix) */
+  domain: extensibleDomainSchema.optional(),
+  /** True if this skill was created outside the CLI's built-in vocabulary */
+  custom: z.boolean().optional()
+}).passthrough().superRefine(validateCategoryField);
 var localSkillMetadataSchema = z.object({
   forkedFrom: z.object({
     /** Original skill ID before forking (e.g., "web-framework-react") */
@@ -552,12 +629,6 @@ var marketplaceSchema = z.object({
   metadata: marketplaceMetadataSchema.optional(),
   plugins: z.array(marketplacePluginSchema).min(1)
 });
-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())),
-  /** Maps agent IDs to skill ID prefixes they should receive by default */
-  agentSkillPrefixes: z.record(z.string(), z.array(z.string())).optional()
-});
 var permissionConfigSchema = z.object({
   /** Tool names or patterns to explicitly allow */
   allow: z.array(z.string()).optional(),
@@ -639,7 +710,6 @@ var projectSourceConfigValidationSchema = z.object({
   stacksFile: z.string().optional(),
   matrixFile: z.string().optional()
 });
-var KEBAB_CASE_PATTERN = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 var agentYamlGenerationSchema = z.object({
   $schema: z.string().optional(),
   id: z.string().min(1),
@@ -650,7 +720,9 @@ var agentYamlGenerationSchema = z.object({
   disallowedTools: z.array(z.string()).optional(),
   permissionMode: permissionModeSchema.optional(),
   hooks: strictHooksRecordSchema.optional(),
-  outputFormat: z.string().optional()
+  outputFormat: z.string().optional(),
+  domain: extensibleDomainSchema.optional(),
+  custom: z.boolean().optional()
 }).strict();
 var agentFrontmatterValidationSchema = z.object({
   /** Agent name in kebab-case (becomes the Task tool identifier) */
@@ -685,7 +757,7 @@ var skillFrontmatterValidationSchema = z.object({
 }).strict();
 var metadataValidationSchema = z.object({
   /** Domain-prefixed subcategory (e.g., "web-framework") */
-  category: subcategorySchema,
+  category: extensibleSubcategorySchema,
   categoryExclusive: z.boolean().optional(),
   /** Author handle — must start with @ (e.g., "@vince") */
   author: z.string().regex(/^@[a-z][a-z0-9-]*$/),
@@ -718,7 +790,11 @@ var metadataValidationSchema = z.object({
     source: z.string().optional(),
     /** ISO date of the fork */
     date: z.string()
-  }).optional()
+  }).optional(),
+  /** Explicit domain assignment (overrides inference from category prefix) */
+  domain: extensibleDomainSchema.optional(),
+  /** True if this skill was created outside the CLI's built-in vocabulary */
+  custom: z.boolean().optional()
 }).strict();
 var stackSkillAssignmentSchema = z.object({
   id: z.string().min(1),
@@ -799,6 +875,20 @@ function warnUnknownFields(parsed, expectedKeys, context) {
     warn(`Unknown fields in ${context}: ${unknownKeys.join(", ")}`);
   }
 }
+function extendSchemasWithCustomValues(options) {
+  for (const category of options.categories ?? []) {
+    customExtensions.categories.add(category);
+  }
+  for (const domain of options.domains ?? []) {
+    customExtensions.domains.add(domain);
+  }
+  for (const agentName of options.agentNames ?? []) {
+    customExtensions.agentNames.add(agentName);
+  }
+  for (const skillId of options.skillIds ?? []) {
+    customExtensions.skillIds.add(skillId);
+  }
+}
 
 export {
   getErrorMessage,
@@ -817,9 +907,14 @@ export {
   ensureDir,
   remove,
   copy,
+  DOMAIN_VALUES,
+  SUBCATEGORY_VALUES,
+  agentNameSchema,
   skillDisplayNameSchema,
   SKILL_ID_PATTERN,
+  isValidSkillId,
   skillIdSchema,
+  extensibleDomainSchema,
   categoryPathSchema,
   hooksRecordSchema,
   skillFrontmatterLoaderSchema,
@@ -833,7 +928,6 @@ export {
   localSkillMetadataSchema,
   stacksConfigSchema,
   marketplaceSchema,
-  defaultMappingsSchema,
   settingsFileSchema,
   importedSkillMetadataSchema,
   projectSourceConfigSchema,
@@ -844,6 +938,7 @@ export {
   stackConfigValidationSchema,
   formatZodErrors,
   validateNestingDepth,
-  warnUnknownFields
+  warnUnknownFields,
+  extendSchemasWithCustomValues
 };
-//# sourceMappingURL=chunk-473YHDYQ.js.map
+//# sourceMappingURL=chunk-C4QI54PN.js.map