@agents-inc/cli 0.74.11 → 0.74.13

package/CHANGELOG.md

@@ -7,6 +7,30 @@ Each release has detailed notes in its own file under [`changelogs/`](./changelo
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.74.13] - 2026-03-15
+
+**Wizard UI polish, source choice flag, e2e test updates**
+
+- Styled view titles, skill scope badges, category headers, and agent step
+- Source choice screen gated behind `SOURCE_CHOICE` flag (off by default)
+- Footer: remove navigate hint, add source hotkeys and agent scope toggle
+
+See [changelogs/0.74.13.md](./changelogs/0.74.13.md) for full details.
+
+---
+
+## [0.74.12] - 2026-03-15
+
+**Matrix refactor, wizard polish, symlink fix**
+
+- Matrix resolver: split `isDiscouraged` into `isDiscouraged`, `isIncompatible`, `hasUnmetRequirements`
+- Wizard: per-skill labels, remove marketplace display, simplify build step
+- Fix macOS `/var` symlink bug in local-installer with `fs.realpathSync`
+
+See [changelogs/0.74.12.md](./changelogs/0.74.12.md) for full details.
+
+---
+
 ## [0.74.11] - 2026-03-14
 
 **Documentation overhaul — README, standards, .ai-docs**

package/README.md

@@ -24,7 +24,7 @@ npx @agents-inc/cli init
 ```
 
 <p align="center">
-  <img src="screenshots/stack-selection.png" alt="Stack selection" width="700">
+  <img src="screenshots/stack-selection.png" alt="Stack selection" width="500">
 </p>
 
 Choose a pre-built stack or start from scratch. Stacks pre-select skills and agents for common tech combinations.
@@ -39,13 +39,13 @@ Choose a pre-built stack or start from scratch. Stacks pre-select skills and age
 | `solidjs-stack`    | SolidJS + Hono + Drizzle                                           |
 
 <p align="center">
-  <img src="screenshots/skill-selection.png" alt="Skill selection" width="700">
+  <img src="screenshots/skill-selection.png" alt="Skill selection" width="500">
 </p>
 
 Add or remove skills from the interactive grid. Skills are organized by domain with framework-aware filtering.
 
 <p align="center">
-  <img src="screenshots/agent-selection.png" alt="Agent selection" width="700">
+  <img src="screenshots/agent-selection.png" alt="Agent selection" width="500">
 </p>
 
 Choose which subagents to compile. Each agent is composed from the skills you selected.

package/dist/{chunk-NA6I5P5P.js → chunk-2PZ7LBFT.js}

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 import {
-  HOTKEY_ACCEPT_DEFAULTS,
   HOTKEY_HELP,
   HOTKEY_SCOPE,
   HOTKEY_SETTINGS,
@@ -41,7 +40,6 @@ var BUILD_KEYS = {
   keys: [
     { key: HOTKEY_TOGGLE_LABELS.label, description: "Toggle compatibility labels" },
     { key: HOTKEY_SCOPE.label, description: "Toggle skill scope (project/global)" },
-    { key: HOTKEY_ACCEPT_DEFAULTS.label, description: "Accept stack defaults (stack path only)" },
     { key: KEY_LABEL_VIM, description: "Vim-style navigation" }
   ]
 };
@@ -102,4 +100,4 @@ var HelpModal = ({ currentStep }) => {
 export {
   HelpModal
 };
-//# sourceMappingURL=chunk-NA6I5P5P.js.map
+//# sourceMappingURL=chunk-2PZ7LBFT.js.map

package/dist/chunk-2PZ7LBFT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/components/wizard/help-modal.tsx"],"sourcesContent":["import { Box, Text } from \"ink\";\nimport React from \"react\";\nimport { CLI_COLORS } from \"../../consts.js\";\nimport type { WizardStep } from \"../../stores/wizard-store.js\";\nimport {\n  HOTKEY_HELP,\n  HOTKEY_SCOPE,\n  HOTKEY_SETTINGS,\n  HOTKEY_TOGGLE_LABELS,\n  KEY_LABEL_ENTER,\n  KEY_LABEL_ESC,\n  KEY_LABEL_SPACE,\n  KEY_LABEL_TAB,\n  KEY_LABEL_VIM,\n} from \"./hotkeys.js\";\n\ntype HelpSection = {\n  title: string;\n  keys: { key: string; description: string }[];\n};\n\nconst GLOBAL_KEYS: HelpSection = {\n  title: \"Navigation\",\n  keys: [\n    { key: \"Arrow keys\", description: \"Move focus\" },\n    { key: KEY_LABEL_SPACE, description: \"Toggle selection\" },\n    { key: KEY_LABEL_ENTER, description: \"Confirm / continue\" },\n    { key: KEY_LABEL_ESC, description: \"Go back\" },\n    { key: KEY_LABEL_TAB, description: \"Jump to next section\" },\n  ],\n};\n\nconst GLOBAL_TOGGLES: HelpSection = {\n  title: \"Toggles\",\n  keys: [{ key: HOTKEY_HELP.label, description: \"Toggle this help\" }],\n};\n\nconst BUILD_KEYS: HelpSection = {\n  title: \"Skills Step\",\n  keys: [\n    { key: HOTKEY_TOGGLE_LABELS.label, description: \"Toggle compatibility labels\" },\n    { key: HOTKEY_SCOPE.label, description: \"Toggle skill scope (project/global)\" },\n    { key: KEY_LABEL_VIM, description: \"Vim-style navigation\" },\n  ],\n};\n\nconst SOURCES_KEYS: HelpSection = {\n  title: \"Sources Step\",\n  keys: [{ key: HOTKEY_SETTINGS.label, description: \"Toggle source settings\" }],\n};\n\nconst AGENTS_KEYS: HelpSection = {\n  title: \"Agents Step\",\n  keys: [{ key: HOTKEY_SCOPE.label, description: \"Toggle agent scope (project/global)\" }],\n};\n\nconst STEP_SECTIONS: Partial<Record<WizardStep, HelpSection>> = {\n  build: BUILD_KEYS,\n  sources: SOURCES_KEYS,\n  agents: AGENTS_KEYS,\n};\n\nconst KEY_COLUMN_WIDTH = 14;\n\ntype HelpSectionViewProps = {\n  section: HelpSection;\n};\n\nconst HelpSectionView: React.FC<HelpSectionViewProps> = ({ section }) => (\n  <Box flexDirection=\"column\" marginTop={1} marginBottom={1}>\n    <Text bold>{section.title}</Text>\n    {section.keys.map(({ key, description }) => (\n      <Box key={key} marginTop={1}>\n        <Box width={KEY_COLUMN_WIDTH}>\n          <Text backgroundColor=\"black\" color={CLI_COLORS.UNFOCUSED}>\n            {\" \"}\n            {key}{\" \"}\n          </Text>\n        </Box>\n        <Text>{description}</Text>\n      </Box>\n    ))}\n  </Box>\n);\n\nexport type HelpModalProps = {\n  currentStep: WizardStep;\n};\n\nexport const HelpModal: React.FC<HelpModalProps> = ({ currentStep }) => {\n  const stepSection = STEP_SECTIONS[currentStep];\n\n  return (\n    <Box\n      flexDirection=\"column\"\n      borderStyle=\"single\"\n      borderColor={CLI_COLORS.PRIMARY}\n      paddingX={2}\n      paddingY={1}\n      marginTop={1}\n    >\n      <Text bold color={CLI_COLORS.PRIMARY}>\n        Keyboard Shortcuts\n      </Text>\n      <Text> </Text>\n\n      <HelpSectionView section={GLOBAL_KEYS} />\n      <HelpSectionView section={GLOBAL_TOGGLES} />\n      {stepSection && <HelpSectionView section={stepSection} />}\n\n      <Text dimColor>\n        Press {KEY_LABEL_ESC} or {HOTKEY_HELP.label} to close\n      </Text>\n    </Box>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA,SAAS,KAAK,YAAY;AAsEtB,cAIM,YAJN;AAjDJ,IAAM,cAA2B;AAAA,EAC/B,OAAO;AAAA,EACP,MAAM;AAAA,IACJ,EAAE,KAAK,cAAc,aAAa,aAAa;AAAA,IAC/C,EAAE,KAAK,iBAAiB,aAAa,mBAAmB;AAAA,IACxD,EAAE,KAAK,iBAAiB,aAAa,qBAAqB;AAAA,IAC1D,EAAE,KAAK,eAAe,aAAa,UAAU;AAAA,IAC7C,EAAE,KAAK,eAAe,aAAa,uBAAuB;AAAA,EAC5D;AACF;AAEA,IAAM,iBAA8B;AAAA,EAClC,OAAO;AAAA,EACP,MAAM,CAAC,EAAE,KAAK,YAAY,OAAO,aAAa,mBAAmB,CAAC;AACpE;AAEA,IAAM,aAA0B;AAAA,EAC9B,OAAO;AAAA,EACP,MAAM;AAAA,IACJ,EAAE,KAAK,qBAAqB,OAAO,aAAa,8BAA8B;AAAA,IAC9E,EAAE,KAAK,aAAa,OAAO,aAAa,sCAAsC;AAAA,IAC9E,EAAE,KAAK,eAAe,aAAa,uBAAuB;AAAA,EAC5D;AACF;AAEA,IAAM,eAA4B;AAAA,EAChC,OAAO;AAAA,EACP,MAAM,CAAC,EAAE,KAAK,gBAAgB,OAAO,aAAa,yBAAyB,CAAC;AAC9E;AAEA,IAAM,cAA2B;AAAA,EAC/B,OAAO;AAAA,EACP,MAAM,CAAC,EAAE,KAAK,aAAa,OAAO,aAAa,sCAAsC,CAAC;AACxF;AAEA,IAAM,gBAA0D;AAAA,EAC9D,OAAO;AAAA,EACP,SAAS;AAAA,EACT,QAAQ;AACV;AAEA,IAAM,mBAAmB;AAMzB,IAAM,kBAAkD,CAAC,EAAE,QAAQ,MACjE,qBAAC,OAAI,eAAc,UAAS,WAAW,GAAG,cAAc,GACtD;AAAA,sBAAC,QAAK,MAAI,MAAE,kBAAQ,OAAM;AAAA,EACzB,QAAQ,KAAK,IAAI,CAAC,EAAE,KAAK,YAAY,MACpC,qBAAC,OAAc,WAAW,GACxB;AAAA,wBAAC,OAAI,OAAO,kBACV,+BAAC,QAAK,iBAAgB,SAAQ,OAAO,WAAW,WAC7C;AAAA;AAAA,MACA;AAAA,MAAK;AAAA,OACR,GACF;AAAA,IACA,oBAAC,QAAM,uBAAY;AAAA,OAPX,GAQV,CACD;AAAA,GACH;AAOK,IAAM,YAAsC,CAAC,EAAE,YAAY,MAAM;AACtE,QAAM,cAAc,cAAc,WAAW;AAE7C,SACE;AAAA,IAAC;AAAA;AAAA,MACC,eAAc;AAAA,MACd,aAAY;AAAA,MACZ,aAAa,WAAW;AAAA,MACxB,UAAU;AAAA,MACV,UAAU;AAAA,MACV,WAAW;AAAA,MAEX;AAAA,4BAAC,QAAK,MAAI,MAAC,OAAO,WAAW,SAAS,gCAEtC;AAAA,QACA,oBAAC,QAAK,eAAC;AAAA,QAEP,oBAAC,mBAAgB,SAAS,aAAa;AAAA,QACvC,oBAAC,mBAAgB,SAAS,gBAAgB;AAAA,QACzC,eAAe,oBAAC,mBAAgB,SAAS,aAAa;AAAA,QAEvD,qBAAC,QAAK,UAAQ,MAAC;AAAA;AAAA,UACN;AAAA,UAAc;AAAA,UAAK,YAAY;AAAA,UAAM;AAAA,WAC9C;AAAA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/{chunk-VILTRTBT.js → chunk-2YFC7IJ6.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-AUNBGZS4.js";
 import {
   useWizardStore
-} from "./chunk-PUZLP4SL.js";
+} from "./chunk-EWGFIBBU.js";
 import {
   matrix
 } from "./chunk-NG2GGK6P.js";
@@ -68,11 +68,11 @@ var StackSelection = ({
       return;
     }
     if (key.upArrow || input === "k") {
-      setFocusedIndex((prev) => Math.max(0, prev - 1));
+      setFocusedIndex((prev) => prev <= 0 ? totalItems - 1 : prev - 1);
       return;
     }
     if (key.downArrow || input === "j") {
-      setFocusedIndex((prev) => Math.min(totalItems - 1, prev + 1));
+      setFocusedIndex((prev) => prev >= totalItems - 1 ? 0 : prev + 1);
     }
   });
   const noShrink = scrollEnabled ? { flexShrink: 0 } : {};
@@ -110,4 +110,4 @@ var StackSelection = ({
 export {
   StackSelection
 };
-//# sourceMappingURL=chunk-VILTRTBT.js.map
+//# sourceMappingURL=chunk-2YFC7IJ6.js.map

package/dist/chunk-2YFC7IJ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/components/wizard/stack-selection.tsx"],"sourcesContent":["import { Box, useInput } from \"ink\";\nimport React, { useState } from \"react\";\nimport { DEFAULT_SCRATCH_DOMAINS } from \"../../consts.js\";\nimport { useWizardStore } from \"../../stores/wizard-store.js\";\nimport { matrix } from \"../../lib/matrix/matrix-provider.js\";\nimport { useSectionScroll } from \"../hooks/use-section-scroll.js\";\nimport { SelectionCard } from \"./selection-card.js\";\n\nconst INITIAL_FOCUSED_INDEX = 0;\nconst SCRATCH_LABEL = \"Start from scratch\";\nconst SCRATCH_DESCRIPTION = \"Select domains and skills manually\";\n\n/** Number of extra items after the stack list (scratch option) */\nconst EXTRA_ITEMS_COUNT = 1;\n\nexport type StackSelectionProps = {\n  /** Available height in terminal lines for the scrollable viewport. 0 = no constraint. */\n  availableHeight?: number;\n  onCancel?: () => void;\n};\n\nexport const StackSelection: React.FC<StackSelectionProps> = ({\n  availableHeight = 0,\n  onCancel,\n}) => {\n  const { selectStack, setApproach, setStackAction, populateFromSkillIds, toggleDomain } =\n    useWizardStore();\n\n  const [focusedIndex, setFocusedIndex] = useState(INITIAL_FOCUSED_INDEX);\n\n  const stacks = matrix.suggestedStacks;\n  const stackCount = stacks.length;\n  const scratchIndex = stackCount;\n  const totalItems = stackCount + EXTRA_ITEMS_COUNT;\n\n  const { setSectionRef, scrollEnabled, scrollTopPx } = useSectionScroll({\n    sectionCount: totalItems,\n    focusedIndex,\n    availableHeight,\n  });\n\n  useInput((input, key) => {\n    if (key.escape) {\n      if (onCancel) {\n        onCancel();\n      }\n      return;\n    }\n\n    if (key.return) {\n      if (focusedIndex === scratchIndex) {\n        selectStack(null);\n        setApproach(\"scratch\");\n\n        for (const domain of DEFAULT_SCRATCH_DOMAINS) {\n          toggleDomain(domain);\n        }\n        return;\n      }\n\n      const focusedStack = stacks[focusedIndex];\n      if (focusedStack) {\n        selectStack(focusedStack.id);\n        setStackAction(\"customize\");\n        populateFromSkillIds(focusedStack.allSkillIds);\n        setApproach(\"stack\");\n      }\n      return;\n    }\n\n    if (key.upArrow || input === \"k\") {\n      setFocusedIndex((prev) => (prev <= 0 ? totalItems - 1 : prev - 1));\n      return;\n    }\n    if (key.downArrow || input === \"j\") {\n      setFocusedIndex((prev) => (prev >= totalItems - 1 ? 0 : prev + 1));\n    }\n  });\n\n  const noShrink = scrollEnabled ? { flexShrink: 0 } : {};\n\n  const sectionElements = stacks.map((stack, index) => (\n    <Box key={stack.id} ref={(el) => setSectionRef(index, el)} width=\"100%\" {...noShrink}>\n      <SelectionCard\n        label={stack.name}\n        description={stack.description}\n        isFocused={index === focusedIndex}\n        marginBottom={1}\n      />\n    </Box>\n  ));\n\n  const scratchElement = (\n    <Box ref={(el) => setSectionRef(scratchIndex, el)} width=\"100%\" {...noShrink}>\n      <SelectionCard\n        label={SCRATCH_LABEL}\n        description={SCRATCH_DESCRIPTION}\n        isFocused={focusedIndex === scratchIndex}\n      />\n    </Box>\n  );\n\n  return (\n    <Box\n      flexDirection=\"column\"\n      width=\"100%\"\n      {...(scrollEnabled\n        ? { height: availableHeight, overflow: \"hidden\" as const }\n        : { flexGrow: 1 })}\n    >\n      <Box flexDirection=\"column\" marginTop={scrollTopPx > 0 ? -scrollTopPx : 0} {...noShrink}>\n        {sectionElements}\n        {scratchElement}\n      </Box>\n    </Box>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA,SAAS,KAAK,gBAAgB;AAC9B,SAAgB,gBAAgB;AAkF1B,cA2BA,YA3BA;AA3EN,IAAM,wBAAwB;AAC9B,IAAM,gBAAgB;AACtB,IAAM,sBAAsB;AAG5B,IAAM,oBAAoB;AAQnB,IAAM,iBAAgD,CAAC;AAAA,EAC5D,kBAAkB;AAAA,EAClB;AACF,MAAM;AACJ,QAAM,EAAE,aAAa,aAAa,gBAAgB,sBAAsB,aAAa,IACnF,eAAe;AAEjB,QAAM,CAAC,cAAc,eAAe,IAAI,SAAS,qBAAqB;AAEtE,QAAM,SAAS,OAAO;AACtB,QAAM,aAAa,OAAO;AAC1B,QAAM,eAAe;AACrB,QAAM,aAAa,aAAa;AAEhC,QAAM,EAAE,eAAe,eAAe,YAAY,IAAI,iBAAiB;AAAA,IACrE,cAAc;AAAA,IACd;AAAA,IACA;AAAA,EACF,CAAC;AAED,WAAS,CAAC,OAAO,QAAQ;AACvB,QAAI,IAAI,QAAQ;AACd,UAAI,UAAU;AACZ,iBAAS;AAAA,MACX;AACA;AAAA,IACF;AAEA,QAAI,IAAI,QAAQ;AACd,UAAI,iBAAiB,cAAc;AACjC,oBAAY,IAAI;AAChB,oBAAY,SAAS;AAErB,mBAAW,UAAU,yBAAyB;AAC5C,uBAAa,MAAM;AAAA,QACrB;AACA;AAAA,MACF;AAEA,YAAM,eAAe,OAAO,YAAY;AACxC,UAAI,cAAc;AAChB,oBAAY,aAAa,EAAE;AAC3B,uBAAe,WAAW;AAC1B,6BAAqB,aAAa,WAAW;AAC7C,oBAAY,OAAO;AAAA,MACrB;AACA;AAAA,IACF;AAEA,QAAI,IAAI,WAAW,UAAU,KAAK;AAChC,sBAAgB,CAAC,SAAU,QAAQ,IAAI,aAAa,IAAI,OAAO,CAAE;AACjE;AAAA,IACF;AACA,QAAI,IAAI,aAAa,UAAU,KAAK;AAClC,sBAAgB,CAAC,SAAU,QAAQ,aAAa,IAAI,IAAI,OAAO,CAAE;AAAA,IACnE;AAAA,EACF,CAAC;AAED,QAAM,WAAW,gBAAgB,EAAE,YAAY,EAAE,IAAI,CAAC;AAEtD,QAAM,kBAAkB,OAAO,IAAI,CAAC,OAAO,UACzC,oBAAC,OAAmB,KAAK,CAAC,OAAO,cAAc,OAAO,EAAE,GAAG,OAAM,QAAQ,GAAG,UAC1E;AAAA,IAAC;AAAA;AAAA,MACC,OAAO,MAAM;AAAA,MACb,aAAa,MAAM;AAAA,MACnB,WAAW,UAAU;AAAA,MACrB,cAAc;AAAA;AAAA,EAChB,KANQ,MAAM,EAOhB,CACD;AAED,QAAM,iBACJ,oBAAC,OAAI,KAAK,CAAC,OAAO,cAAc,cAAc,EAAE,GAAG,OAAM,QAAQ,GAAG,UAClE;AAAA,IAAC;AAAA;AAAA,MACC,OAAO;AAAA,MACP,aAAa;AAAA,MACb,WAAW,iBAAiB;AAAA;AAAA,EAC9B,GACF;AAGF,SACE;AAAA,IAAC;AAAA;AAAA,MACC,eAAc;AAAA,MACd,OAAM;AAAA,MACL,GAAI,gBACD,EAAE,QAAQ,iBAAiB,UAAU,SAAkB,IACvD,EAAE,UAAU,EAAE;AAAA,MAElB,+BAAC,OAAI,eAAc,UAAS,WAAW,cAAc,IAAI,CAAC,cAAc,GAAI,GAAG,UAC5E;AAAA;AAAA,QACA;AAAA,SACH;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/{chunk-C6YLN4AW.js → chunk-4EPFKZB5.js}

@@ -4,25 +4,21 @@ import {
 } from "./chunk-K77I4XGL.js";
 import {
   CategoryGrid
-} from "./chunk-X6LXHVA6.js";
+} from "./chunk-GHBZ7NUI.js";
 import {
   getDomainDisplayName,
   orderDomains
 } from "./chunk-LVNNP7T4.js";
 import {
   ViewTitle
-} from "./chunk-AQYAVLZK.js";
+} from "./chunk-JNQKCZA3.js";
 import {
   useWizardStore
-} from "./chunk-PUZLP4SL.js";
-import {
-  KEY_LABEL_ENTER,
-  KEY_LABEL_ESC
-} from "./chunk-CBYRFAUN.js";
+} from "./chunk-EWGFIBBU.js";
 import {
   getAvailableSkills,
   resolveAlias
-} from "./chunk-2EXAK22V.js";
+} from "./chunk-6W4H2K3Z.js";
 import {
   getSkillById,
   matrix
@@ -37,7 +33,11 @@ import {
 // src/cli/components/wizard/step-build.tsx
 init_esm_shims();
 import { Box, Text, useInput } from "ink";
-import { useCallback, useMemo as useMemo2, useState } from "react";
+import { useCallback, useMemo as useMemo2 } from "react";
+
+// src/cli/components/hooks/use-framework-filtering.ts
+init_esm_shims();
+import { useMemo } from "react";
 
 // src/cli/lib/wizard/index.ts
 init_esm_shims();
@@ -53,32 +53,14 @@ function validateBuildStep(categories, selections) {
       const categorySelections = selections[category.id] || [];
       if (categorySelections.length === 0) {
         return {
-          valid: false,
-          message: `Select at least one skill from the ${category.displayName} category. Use arrow keys to navigate, then SPACE to select.`
+          valid: true,
+          message: `No skills selected in ${category.displayName} (required category)`
         };
       }
     }
   }
   return { valid: true };
 }
-function computeOptionState(skill) {
-  if (skill.discouraged) {
-    return "discouraged";
-  }
-  if (skill.recommended) {
-    return "recommended";
-  }
-  return "normal";
-}
-function getStateReason(skill) {
-  if (skill.discouraged && skill.discouragedReason) {
-    return skill.discouragedReason;
-  }
-  if (skill.recommended && skill.recommendedReason) {
-    return skill.recommendedReason;
-  }
-  return void 0;
-}
 function isFrameworkSelected(selections) {
   const frameworkSelections = selections[FRAMEWORK_CATEGORY_ID] ?? [];
   return frameworkSelections.length > 0;
@@ -112,12 +94,13 @@ function buildCategoriesForDomain(domain, allSelections, selections, installedSk
     ) : skillOptions;
     const options = filteredSkillOptions.map((skill) => ({
       id: skill.id,
-      state: computeOptionState(skill),
-      stateReason: getStateReason(skill),
+      state: skill.advisoryState,
       selected: skill.selected,
       local: getSkillById(skill.id).local,
       installed: installedSkillIds?.includes(skill.id) || false,
-      scope: skillConfigs?.find((sc) => sc.id === skill.id)?.scope
+      scope: skillConfigs?.find((sc) => sc.id === skill.id)?.scope,
+      hasUnmetRequirements: skill.hasUnmetRequirements,
+      unmetRequirementsReason: skill.unmetRequirementsReason
     }));
     return {
       id: cat.id,
@@ -131,8 +114,6 @@ function buildCategoriesForDomain(domain, allSelections, selections, installedSk
 }
 
 // src/cli/components/hooks/use-framework-filtering.ts
-init_esm_shims();
-import { useMemo } from "react";
 function useFrameworkFiltering({
   domain,
   allSelections,
@@ -148,18 +129,6 @@ function useFrameworkFiltering({
 
 // src/cli/components/wizard/step-build.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
-var Footer = ({ validationError }) => {
-  return /* @__PURE__ */ jsx(Box, { flexDirection: "column", marginTop: 1, children: validationError && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [
-    /* @__PURE__ */ jsx(Text, { color: CLI_COLORS.WARNING, children: validationError }),
-    /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
-      "Press ",
-      KEY_LABEL_ESC,
-      " to go back, or select a skill and press ",
-      KEY_LABEL_ENTER,
-      " to continue."
-    ] })
-  ] }) });
-};
 var StepBuild = ({
   domain: activeDomain,
   selectedDomains,
@@ -172,7 +141,6 @@ var StepBuild = ({
   onContinue,
   onBack
 }) => {
-  const [validationError, setValidationError] = useState(void 0);
   const { ref: gridRef, measuredHeight: gridHeight } = useMeasuredHeight();
   const skillConfigs = useWizardStore((s) => s.skillConfigs);
   const handleFocusedSkillChange = useCallback(
@@ -189,15 +157,8 @@ var StepBuild = ({
   });
   useInput((_input, key) => {
     if (key.return) {
-      const validation = validateBuildStep(categories, selections);
-      if (validation.valid) {
-        setValidationError(void 0);
-        onContinue();
-      } else {
-        setValidationError(validation.message);
-      }
+      onContinue();
     } else if (key.escape) {
-      setValidationError(void 0);
       onBack();
     }
   });
@@ -234,8 +195,7 @@ var StepBuild = ({
         onFocusedSkillChange: handleFocusedSkillChange
       },
       activeDomain
-    ) }),
-    /* @__PURE__ */ jsx(Footer, { validationError })
+    ) })
   ] });
 };
 
@@ -243,4 +203,4 @@ export {
   validateBuildStep,
   StepBuild
 };
-//# sourceMappingURL=chunk-C6YLN4AW.js.map
+//# sourceMappingURL=chunk-4EPFKZB5.js.map

package/dist/chunk-4EPFKZB5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/components/wizard/step-build.tsx","../src/cli/components/hooks/use-framework-filtering.ts","../src/cli/lib/wizard/index.ts","../src/cli/lib/wizard/build-step-logic.ts"],"sourcesContent":["import { Box, Text, useInput } from \"ink\";\nimport React, { useCallback, useMemo } from \"react\";\nimport { CLI_COLORS } from \"../../consts.js\";\nimport type { Domain, SkillId, Category, CategorySelections } from \"../../types/index.js\";\nimport { useFrameworkFiltering } from \"../hooks/use-framework-filtering.js\";\nimport { useMeasuredHeight } from \"../hooks/use-measured-height.js\";\nimport { useWizardStore } from \"../../stores/wizard-store.js\";\nimport { CategoryGrid } from \"./category-grid.js\";\nimport { getDomainDisplayName, orderDomains } from \"./utils.js\";\nimport { ViewTitle } from \"./view-title.js\";\n\nexport type StepBuildProps = {\n  domain: Domain;\n  selectedDomains: Domain[];\n  selections: CategorySelections;\n  allSelections: SkillId[];\n  showLabels: boolean;\n  /** Skill IDs already installed on disk, shown with a dimmed checkmark */\n  installedSkillIds?: SkillId[];\n  onToggle: (categoryId: Category, technologyId: SkillId) => void;\n  onToggleLabels: () => void;\n  onContinue: () => void;\n  onBack: () => void;\n};\n\nexport const StepBuild: React.FC<StepBuildProps> = ({\n  domain: activeDomain,\n  selectedDomains,\n  selections,\n  allSelections,\n  showLabels,\n  installedSkillIds,\n  onToggle,\n  onToggleLabels,\n  onContinue,\n  onBack,\n}) => {\n  const { ref: gridRef, measuredHeight: gridHeight } = useMeasuredHeight();\n  const skillConfigs = useWizardStore((s) => s.skillConfigs);\n\n  const handleFocusedSkillChange = useCallback(\n    (id: SkillId | null) => useWizardStore.getState().setFocusedSkillId(id),\n    [],\n  );\n\n  const orderedDomains = useMemo(() => orderDomains(selectedDomains), [selectedDomains]);\n\n  const categories = useFrameworkFiltering({\n    domain: activeDomain,\n    allSelections,\n    selections,\n    installedSkillIds,\n    skillConfigs,\n  });\n\n  useInput((_input, key) => {\n    if (key.return) {\n      onContinue();\n    } else if (key.escape) {\n      onBack();\n    }\n  });\n\n  return (\n    <Box flexDirection=\"column\" width=\"100%\" flexGrow={1} flexBasis={0}>\n      <Box\n        columnGap={2}\n        flexDirection=\"row\"\n        justifyContent=\"space-between\"\n        marginBottom={1}\n        paddingRight={1}\n        marginTop={-1}\n        borderTop={false}\n        borderRight={false}\n        borderLeft={false}\n        borderColor={CLI_COLORS.NEUTRAL}\n        borderStyle=\"single\"\n      >\n        <Box columnGap={2} flexDirection=\"row\">\n          {orderedDomains.map((domain) => {\n            const isActive = domain === activeDomain;\n            return (\n              <Text key={domain} color={isActive ? CLI_COLORS.WARNING : undefined} bold={isActive}>\n                {getDomainDisplayName(domain)}\n              </Text>\n            );\n          })}\n        </Box>\n      </Box>\n      <ViewTitle>{`Customize your ${getDomainDisplayName(activeDomain)} stack`}</ViewTitle>\n\n      <Box ref={gridRef} flexGrow={1} flexBasis={0}>\n        <CategoryGrid\n          key={activeDomain}\n          categories={categories}\n          availableHeight={gridHeight}\n          showLabels={showLabels}\n          onToggle={onToggle}\n          onToggleLabels={onToggleLabels}\n          onFocusedSkillChange={handleFocusedSkillChange}\n        />\n      </Box>\n    </Box>\n  );\n};\n","import { useMemo } from \"react\";\nimport type { Domain, SkillId, CategorySelections } from \"../../types/index.js\";\nimport type { SkillConfig } from \"../../types/config.js\";\nimport { buildCategoriesForDomain } from \"../../lib/wizard/index.js\";\nimport type { CategoryRow } from \"../wizard/category-grid.js\";\n\ntype UseFrameworkFilteringOptions = {\n  domain: Domain;\n  allSelections: SkillId[];\n  selections: CategorySelections;\n  installedSkillIds?: SkillId[];\n  skillConfigs?: SkillConfig[];\n};\n\nexport function useFrameworkFiltering({\n  domain,\n  allSelections,\n  selections,\n  installedSkillIds,\n  skillConfigs,\n}: UseFrameworkFilteringOptions): CategoryRow[] {\n  return useMemo(\n    () =>\n      buildCategoriesForDomain(domain, allSelections, selections, installedSkillIds, skillConfigs),\n    [domain, allSelections, selections, installedSkillIds, skillConfigs],\n  );\n}\n","export {\n  type BuildStepValidation,\n  validateBuildStep,\n  buildCategoriesForDomain,\n} from \"./build-step-logic\";\n","import { sortBy } from \"remeda\";\nimport type { CategoryDefinition, Domain, SkillId, CategorySelections } from \"../../types/index.js\";\nimport type { SkillConfig } from \"../../types/config.js\";\nimport { getAvailableSkills, resolveAlias } from \"../matrix/index.js\";\nimport { matrix, getSkillById } from \"../matrix/matrix-provider.js\";\nimport type { CategoryRow, CategoryOption } from \"../../components/wizard/category-grid.js\";\n\nconst FRAMEWORK_CATEGORY_ID = \"web-framework\";\nconst WEB_DOMAIN_ID = \"web\";\n\nexport type BuildStepValidation = {\n  valid: boolean;\n  message?: string;\n};\n\nexport function validateBuildStep(\n  categories: CategoryRow[],\n  selections: CategorySelections,\n): BuildStepValidation {\n  for (const category of categories) {\n    if (category.required) {\n      const categorySelections = selections[category.id] || [];\n      if (categorySelections.length === 0) {\n        return {\n          valid: true,\n          message: `No skills selected in ${category.displayName} (required category)`,\n        };\n      }\n    }\n  }\n  return { valid: true };\n}\n\nfunction isFrameworkSelected(selections: CategorySelections): boolean {\n  const frameworkSelections = selections[FRAMEWORK_CATEGORY_ID] ?? [];\n  return frameworkSelections.length > 0;\n}\n\nfunction getSelectedFrameworks(selections: CategorySelections): SkillId[] {\n  const frameworkSelections = selections[FRAMEWORK_CATEGORY_ID] ?? [];\n  return frameworkSelections.map((alias) => resolveAlias(alias));\n}\n\nfunction isCompatibleWithSelectedFrameworks(\n  skillId: SkillId,\n  selectedFrameworkIds: SkillId[],\n): boolean {\n  const skill = getSkillById(skillId);\n\n  // No compatibleWith = compatible with all (allows legacy skills to appear)\n  if (skill.compatibleWith.length === 0) {\n    return true;\n  }\n\n  return selectedFrameworkIds.some((frameworkId) => skill.compatibleWith.includes(frameworkId));\n}\n\n// Build CategoryRow[] from matrix for a domain, with framework-first filtering for web\nexport function buildCategoriesForDomain(\n  domain: Domain,\n  allSelections: SkillId[],\n  selections: CategorySelections,\n  installedSkillIds?: SkillId[],\n  skillConfigs?: SkillConfig[],\n): CategoryRow[] {\n  const frameworkSource = selections;\n  const frameworkSelected = isFrameworkSelected(frameworkSource);\n  const selectedFrameworkIds = frameworkSelected ? getSelectedFrameworks(frameworkSource) : [];\n\n  // Object.values() on a Partial record only yields values that exist — all are CategoryDefinition\n  const categories = sortBy(\n    (Object.values(matrix.categories) as CategoryDefinition[]).filter(\n      (cat) => cat.domain === domain,\n    ),\n    (cat) => cat.order ?? 0,\n  );\n\n  const categoryRows: CategoryRow[] = categories.map((cat) => {\n    const skillOptions = getAvailableSkills(cat.id, allSelections);\n\n    const useFrameworkFilter =\n      domain === WEB_DOMAIN_ID && cat.id !== FRAMEWORK_CATEGORY_ID && frameworkSelected;\n    const filteredSkillOptions = useFrameworkFilter\n      ? skillOptions.filter((skill) =>\n          isCompatibleWithSelectedFrameworks(skill.id, selectedFrameworkIds),\n        )\n      : skillOptions;\n\n    const options: CategoryOption[] = filteredSkillOptions.map((skill) => ({\n      id: skill.id,\n      state: skill.advisoryState,\n      selected: skill.selected,\n      local: getSkillById(skill.id).local,\n      installed: installedSkillIds?.includes(skill.id) || false,\n      scope: skillConfigs?.find((sc) => sc.id === skill.id)?.scope,\n      hasUnmetRequirements: skill.hasUnmetRequirements,\n      unmetRequirementsReason: skill.unmetRequirementsReason,\n    }));\n\n    return {\n      id: cat.id,\n      displayName: cat.displayName,\n      required: cat.required ?? false,\n      exclusive: cat.exclusive ?? true,\n      options,\n    };\n  });\n\n  return categoryRows.filter((row) => row.options.length > 0);\n}\n"],"mappings":"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","names":["useMemo","useMemo"]}

package/dist/{chunk-2EXAK22V.js → chunk-6W4H2K3Z.js}

@@ -984,7 +984,7 @@ function loadConfigTypesDataInBackground(sourceFlag, projectDir) {
     if (!await directoryExists(claudeSrcDir)) {
       throw new Error(`${CLAUDE_SRC_DIR}/ not found \u2014 run '${CLI_BIN_NAME} init' first`);
     }
-    const { loadSkillsMatrixFromSource: loadSkillsMatrixFromSource2 } = await import("./source-loader-WBDPZJEW.js");
+    const { loadSkillsMatrixFromSource: loadSkillsMatrixFromSource2 } = await import("./source-loader-42GVUFZA.js");
     const { loadAllAgents: loadAllAgents2 } = await import("./loader-NHUCFMFQ.js");
     const sourceResult = await loadSkillsMatrixFromSource2({
       sourceFlag,
@@ -1930,6 +1930,16 @@ import { groupBy } from "remeda";
 function getLabel(skill) {
   return skill.displayName;
 }
+function joinWithOr(items) {
+  if (items.length <= 1) return items[0] ?? "";
+  if (items.length === 2) return `${items[0]} or ${items[1]}`;
+  return `${items.slice(0, -1).join(", ")} or ${items[items.length - 1]}`;
+}
+function joinWithAnd(items) {
+  if (items.length <= 1) return items[0] ?? "";
+  if (items.length === 2) return `${items[0]} and ${items[1]}`;
+  return `${items.slice(0, -1).join(", ")} and ${items[items.length - 1]}`;
+}
 function resolveAlias(skillId) {
   if (matrix.skills[skillId]) return skillId;
   throw new Error(`Unknown skill ID: '${skillId}' \u2014 not found in the matrix`);
@@ -1943,7 +1953,7 @@ function isDiscouraged(skillId, currentSelections) {
   const fullId = resolveAlias(skillId);
   const skill = matrix.skills[fullId];
   if (!skill) return false;
-  const { resolvedSelections, selectedSet } = initializeSelectionContext(currentSelections);
+  const { resolvedSelections } = initializeSelectionContext(currentSelections);
   for (const selectedId of resolvedSelections) {
     const selectedSkill = matrix.skills[selectedId];
     if (selectedSkill?.discourages.some((d) => d.skillId === fullId)) {
@@ -1953,26 +1963,30 @@ function isDiscouraged(skillId, currentSelections) {
       return true;
     }
   }
+  return false;
+}
+function isIncompatible(skillId, currentSelections) {
+  const fullId = resolveAlias(skillId);
+  const skill = matrix.skills[fullId];
+  if (!skill) return false;
+  const { resolvedSelections } = initializeSelectionContext(currentSelections);
   for (const selectedId of resolvedSelections) {
-    if (skill.conflictsWith.some((c) => c.skillId === selectedId)) {
-      return true;
-    }
+    if (skill.conflictsWith.some((c) => c.skillId === selectedId)) return true;
     const selectedSkill = matrix.skills[selectedId];
-    if (selectedSkill?.conflictsWith.some((c) => c.skillId === fullId)) {
-      return true;
-    }
+    if (selectedSkill?.conflictsWith.some((c) => c.skillId === fullId)) return true;
   }
+  return false;
+}
+function hasUnmetRequirements(skillId, currentSelections) {
+  const fullId = resolveAlias(skillId);
+  const skill = matrix.skills[fullId];
+  if (!skill) return false;
+  const { selectedSet } = initializeSelectionContext(currentSelections);
   for (const requirement of skill.requires) {
     if (requirement.needsAny) {
-      const hasAny = requirement.skillIds.some((reqId) => selectedSet.has(reqId));
-      if (!hasAny) {
-        return true;
-      }
+      if (!requirement.skillIds.some((reqId) => selectedSet.has(reqId))) return true;
     } else {
-      const hasAll = requirement.skillIds.every((reqId) => selectedSet.has(reqId));
-      if (!hasAll) {
-        return true;
-      }
+      if (!requirement.skillIds.every((reqId) => selectedSet.has(reqId))) return true;
     }
   }
   return false;
@@ -1981,7 +1995,7 @@ function getDiscourageReason(skillId, currentSelections) {
   const fullId = resolveAlias(skillId);
   const skill = matrix.skills[fullId];
   if (!skill) return void 0;
-  const { resolvedSelections, selectedSet } = initializeSelectionContext(currentSelections);
+  const { resolvedSelections } = initializeSelectionContext(currentSelections);
   for (const selectedId of resolvedSelections) {
     const selectedSkill = matrix.skills[selectedId];
     if (selectedSkill) {
@@ -1995,19 +2009,33 @@ function getDiscourageReason(skillId, currentSelections) {
       return reverseDiscourage.reason;
     }
   }
+  return void 0;
+}
+function getIncompatibleReason(skillId, currentSelections) {
+  const fullId = resolveAlias(skillId);
+  const skill = matrix.skills[fullId];
+  if (!skill) return void 0;
+  const { resolvedSelections } = initializeSelectionContext(currentSelections);
   for (const selectedId of resolvedSelections) {
     const conflict = skill.conflictsWith.find((c) => c.skillId === selectedId);
     if (conflict) {
-      return `${conflict.reason} (conflicts with ${getLabel(getSkillById(selectedId))})`;
+      return `conflicts with ${getLabel(getSkillById(selectedId))}`;
     }
     const selectedSkill = matrix.skills[selectedId];
     if (selectedSkill) {
       const reverseConflict = selectedSkill.conflictsWith.find((c) => c.skillId === fullId);
       if (reverseConflict) {
-        return `${reverseConflict.reason} (conflicts with ${getLabel(selectedSkill)})`;
+        return `conflicts with ${getLabel(selectedSkill)}`;
       }
     }
   }
+  return void 0;
+}
+function getUnmetRequirementsReason(skillId, currentSelections) {
+  const fullId = resolveAlias(skillId);
+  const skill = matrix.skills[fullId];
+  if (!skill) return void 0;
+  const { selectedSet } = initializeSelectionContext(currentSelections);
   for (const requirement of skill.requires) {
     if (requirement.needsAny) {
       const hasAny = requirement.skillIds.some((reqId) => selectedSet.has(reqId));
@@ -2015,8 +2043,8 @@ function getDiscourageReason(skillId, currentSelections) {
         const requiredNames = requirement.skillIds.map((id) => {
           const s = matrix.skills[id];
           return s ? getLabel(s) : id;
-        }).join(" or ");
-        return `${requirement.reason} (requires ${requiredNames})`;
+        });
+        return `requires ${joinWithOr(requiredNames)}`;
       }
     } else {
       const missingIds = requirement.skillIds.filter((reqId) => !selectedSet.has(reqId));
@@ -2024,8 +2052,8 @@ function getDiscourageReason(skillId, currentSelections) {
         const missingNames = missingIds.map((id) => {
           const s = matrix.skills[id];
           return s ? getLabel(s) : id;
-        }).join(", ");
-        return `${requirement.reason} (requires ${missingNames})`;
+        });
+        return `requires ${joinWithAnd(missingNames)}`;
       }
     }
   }
@@ -2159,28 +2187,45 @@ function validateSelection(selections) {
     validateRecommendations(resolvedSelections, selectedSet)
   ]);
   return {
-    valid: errors.length === 0,
+    valid: true,
     errors,
     warnings
   };
 }
+function computeAdvisoryState(skillId, currentSelections) {
+  if (isIncompatible(skillId, currentSelections)) {
+    return {
+      status: "incompatible",
+      reason: getIncompatibleReason(skillId, currentSelections) ?? "Incompatible"
+    };
+  }
+  if (isDiscouraged(skillId, currentSelections)) {
+    return {
+      status: "discouraged",
+      reason: getDiscourageReason(skillId, currentSelections) ?? "Not recommended"
+    };
+  }
+  if (isRecommended(skillId, currentSelections)) {
+    return {
+      status: "recommended",
+      reason: getRecommendReason(skillId, currentSelections) ?? "Recommended"
+    };
+  }
+  return { status: "normal" };
+}
 function getAvailableSkills(categoryId, currentSelections) {
   const skillOptions = [];
   const { selectedSet } = initializeSelectionContext(currentSelections);
   for (const skill of Object.values(matrix.skills)) {
     if (!skill) continue;
-    if (skill.category !== categoryId) {
-      continue;
-    }
-    const discouraged = isDiscouraged(skill.id, currentSelections);
-    const recommended = !discouraged && isRecommended(skill.id, currentSelections);
+    if (skill.category !== categoryId) continue;
+    const isSelected = selectedSet.has(skill.id);
     skillOptions.push({
       id: skill.id,
-      discouraged,
-      discouragedReason: discouraged ? getDiscourageReason(skill.id, currentSelections) : void 0,
-      recommended,
-      recommendedReason: recommended ? getRecommendReason(skill.id, currentSelections) : void 0,
-      selected: selectedSet.has(skill.id),
+      advisoryState: computeAdvisoryState(skill.id, currentSelections),
+      selected: isSelected,
+      hasUnmetRequirements: isSelected && hasUnmetRequirements(skill.id, currentSelections),
+      unmetRequirementsReason: isSelected ? getUnmetRequirementsReason(skill.id, currentSelections) : void 0,
       alternatives: skill.alternatives.map((a) => a.skillId)
     });
   }
@@ -2434,6 +2479,7 @@ async function detectInstallation(projectDir = process.cwd()) {
 
 // src/cli/lib/installation/local-installer.ts
 init_esm_shims();
+import fs from "fs";
 import os8 from "os";
 import path20 from "path";
 
@@ -3779,7 +3825,7 @@ async function writeProjectConfigTypes(projectConfigPath, projectDir, projectCon
 }
 async function writeScopedConfigs(finalConfig, matrix2, agents, projectDir, projectConfigPath, projectInstallationExists) {
   const homeDir = os8.homedir();
-  const isProjectContext = path20.resolve(projectDir) !== path20.resolve(homeDir);
+  const isProjectContext = fs.realpathSync(projectDir) !== fs.realpathSync(homeDir);
   if (!isProjectContext) {
     await writeConfigFile(finalConfig, projectConfigPath);
     await writeStandaloneConfigTypes(projectConfigPath, matrix2, agents, finalConfig);
@@ -3833,7 +3879,7 @@ async function compileAndWriteAgents(compileConfig, agents, localSkills, sourceR
 async function installPluginConfig(options) {
   const { wizardResult, sourceResult, projectDir, sourceFlag } = options;
   const projectPaths = resolveInstallPaths(projectDir, "project");
-  const isProjectInstall = path20.resolve(projectDir) !== path20.resolve(os8.homedir());
+  const isProjectInstall = fs.realpathSync(projectDir) !== fs.realpathSync(os8.homedir());
   if (isProjectInstall) {
     await ensureDir(projectPaths.agentsDir);
   }
@@ -3841,7 +3887,7 @@ async function installPluginConfig(options) {
   const agents = await loadMergedAgents(sourceResult.sourcePath);
   const mergeResult = await buildAndMergeConfig(wizardResult, sourceResult, projectDir, sourceFlag);
   const finalConfig = mergeResult.config;
-  const projectInstallationExists = path20.resolve(projectDir) !== path20.resolve(os8.homedir());
+  const projectInstallationExists = fs.realpathSync(projectDir) !== fs.realpathSync(os8.homedir());
   await writeScopedConfigs(
     finalConfig,
     sourceResult.matrix,
@@ -3887,7 +3933,7 @@ async function installLocal(options) {
   const projectSkills = wizardResult.skills.filter((s) => s.scope !== "global");
   const globalSkills = wizardResult.skills.filter((s) => s.scope === "global");
   const homeDir = os8.homedir();
-  const isProjectInstall = path20.resolve(projectDir) !== path20.resolve(homeDir);
+  const isProjectInstall = fs.realpathSync(projectDir) !== fs.realpathSync(homeDir);
   if (isProjectInstall) {
     await prepareDirectories(projectPaths);
   } else {
@@ -3901,7 +3947,7 @@ async function installLocal(options) {
   const agents = await loadMergedAgents(sourceResult.sourcePath);
   const mergeResult = await buildAndMergeConfig(wizardResult, sourceResult, projectDir, sourceFlag);
   const finalConfig = mergeResult.config;
-  const isProjectContext = path20.resolve(projectDir) !== path20.resolve(os8.homedir());
+  const isProjectContext = fs.realpathSync(projectDir) !== fs.realpathSync(os8.homedir());
   await writeScopedConfigs(
     finalConfig,
     sourceResult.matrix,
@@ -5347,20 +5393,6 @@ function extractSourceName(source) {
   const firstSegment = withoutUrl.split("/")[0];
   return firstSegment || source;
 }
-function getMarketplaceLabel(sourceResult) {
-  if (sourceResult.isLocal) return void 0;
-  const { marketplace } = sourceResult;
-  if (!marketplace) {
-    const name = extractSourceName(sourceResult.sourceConfig.source);
-    return `${name} (public)`;
-  }
-  const PUBLIC_MARKETPLACE_COUNT = 1;
-  const isDefaultSource = sourceResult.sourceConfig.source === DEFAULT_SOURCE;
-  if (!isDefaultSource) {
-    return `${marketplace} + ${PUBLIC_MARKETPLACE_COUNT} public`;
-  }
-  return marketplace;
-}
 function mergeLocalSkillsIntoMatrix(matrix2, localResult) {
   for (const metadata of localResult.skills) {
     const existingSkill = matrix2.skills[metadata.id];
@@ -5466,7 +5498,6 @@ export {
   loadSkillsMatrixFromSource,
   convertStackToResolvedStack,
   extractSourceName,
-  getMarketplaceLabel,
   mergeLocalSkillsIntoMatrix,
   loadConfigTypesDataInBackground,
   regenerateConfigTypes,
@@ -5496,4 +5527,4 @@ export {
   validateAllPlugins,
   printPluginValidationResult
 };
-//# sourceMappingURL=chunk-2EXAK22V.js.map
+//# sourceMappingURL=chunk-6W4H2K3Z.js.map