@agents-inc/cli 0.74.10 → 0.74.12

package/CHANGELOG.md

@@ -7,6 +7,31 @@ 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.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**
+
+- README rewritten with screenshots and visual wizard walkthrough
+- Standards consolidated: E2E testing bible, TypeScript types bible
+- .ai-docs validated against current source (12 files updated)
+- 39 redundant/completed docs removed
+
+See [changelogs/0.74.11.md](./changelogs/0.74.11.md) for full details.
+
+---
+
 ## [0.74.10] - 2026-03-14
 
 **E2E test file splits for parallel execution**

package/README.md

@@ -23,7 +23,10 @@ Compose specialized [Claude Code](https://docs.anthropic.com/en/docs/claude-code
 npx @agents-inc/cli init
 ```
 
-![Stack selection](screenshots/step-stack.png)
+<p align="center">
+  <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.
 
 | Stack              | Technologies                                                       |
@@ -35,13 +38,16 @@ Choose a pre-built stack or start from scratch. Stacks pre-select skills and age
 | `remix-stack`      | Remix + React + Hono + Drizzle                                     |
 | `solidjs-stack`    | SolidJS + Hono + Drizzle                                           |
 
-![Skill selection grid](screenshots/step-skills.png)
+<p align="center">
+  <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.
 
-![Source selection](screenshots/step-sources.png)
-Select where each skill comes from: the public marketplace, a custom marketplace, or a local directory.
+<p align="center">
+  <img src="screenshots/agent-selection.png" alt="Agent selection" width="500">
+</p>
 
-![Agent selection](screenshots/step-agents.png)
 Choose which subagents to compile. Each agent is composed from the skills you selected.
 
 After init, use `agentsinc edit` to change selections and `agentsinc compile` to rebuild.

package/dist/{chunk-FW5C245M.js → chunk-2DKJM7RO.js}

@@ -8,12 +8,11 @@ import {
 } from "./chunk-HGTC76BX.js";
 import {
   HelpModal
-} from "./chunk-NA6I5P5P.js";
+} from "./chunk-2PZ7LBFT.js";
 import {
   useWizardStore
-} from "./chunk-PUZLP4SL.js";
+} from "./chunk-EWGFIBBU.js";
 import {
-  HOTKEY_ACCEPT_DEFAULTS,
   HOTKEY_HELP,
   HOTKEY_SCOPE,
   HOTKEY_SETTINGS,
@@ -24,8 +23,7 @@ import {
   KEY_LABEL_SPACE
 } from "./chunk-CBYRFAUN.js";
 import {
-  CLI_COLORS,
-  DEFAULT_PLUGIN_NAME
+  CLI_COLORS
 } from "./chunk-EGMQ3SXN.js";
 import {
   init_esm_shims
@@ -101,8 +99,7 @@ var HOT_KEYS = [
   { label: "back", values: [KEY_LABEL_ESC] }
 ];
 var WizardFooter = () => {
-  const store = useWizardStore();
-  return /* @__PURE__ */ jsxs(
+  return /* @__PURE__ */ jsx(
     Box,
     {
       columnGap: 2,
@@ -114,23 +111,12 @@ var WizardFooter = () => {
       borderStyle: "single",
       paddingLeft: 1,
       paddingRight: 1,
-      children: [
-        /* @__PURE__ */ jsx(
-          DefinitionItem,
-          {
-            label: "Accept defaults",
-            values: [HOTKEY_ACCEPT_DEFAULTS.label],
-            isVisible: store.step === "build" && !!store.selectedStackId
-          }
-        ),
-        HOT_KEYS.map((hotkey) => /* @__PURE__ */ createElement(DefinitionItem, { ...hotkey, key: hotkey.label }))
-      ]
+      children: HOT_KEYS.map((hotkey) => /* @__PURE__ */ createElement(DefinitionItem, { ...hotkey, key: hotkey.label }))
     }
   );
 };
 var WizardLayout = ({
   version,
-  marketplaceLabel,
   logo,
   startupMessages,
   children
@@ -148,10 +134,6 @@ var WizardLayout = ({
     ) }, index) }),
     /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingX: 1, height: terminalHeight, children: [
       logo && store.step === "stack" && /* @__PURE__ */ jsx(Box, { flexDirection: "row", marginTop: 1, columnGap: 1, children: /* @__PURE__ */ jsx(Text, { children: logo }) }),
-      /* @__PURE__ */ jsxs(Box, { children: [
-        /* @__PURE__ */ jsx(Text, { dimColor: true, children: "Marketplace: " }),
-        /* @__PURE__ */ jsx(Text, { bold: true, children: marketplaceLabel || `${DEFAULT_PLUGIN_NAME} (public)` })
-      ] }),
       /* @__PURE__ */ jsx(
         WizardTabs,
         {
@@ -202,4 +184,4 @@ var WizardLayout = ({
 export {
   WizardLayout
 };
-//# sourceMappingURL=chunk-FW5C245M.js.map
+//# sourceMappingURL=chunk-2DKJM7RO.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/components/wizard/wizard-layout.tsx","../src/cli/components/hooks/use-terminal-dimensions.ts"],"sourcesContent":["import { Box, Static, Text } from \"ink\";\nimport React, { Fragment } from \"react\";\nimport { CLI_COLORS } from \"../../consts.js\";\nimport type { StartupMessage } from \"../../utils/logger.js\";\nimport { FEATURE_FLAGS } from \"../../lib/feature-flags.js\";\nimport { useWizardStore } from \"../../stores/wizard-store.js\";\nimport { useTerminalDimensions } from \"../hooks/use-terminal-dimensions.js\";\nimport { HelpModal } from \"./help-modal.js\";\nimport {\n  HOTKEY_HELP,\n  HOTKEY_SCOPE,\n  HOTKEY_SETTINGS,\n  HOTKEY_TOGGLE_LABELS,\n  KEY_LABEL_ARROWS_VERT,\n  KEY_LABEL_ENTER,\n  KEY_LABEL_ESC,\n  KEY_LABEL_SPACE,\n} from \"./hotkeys.js\";\nimport { WIZARD_STEPS, WizardTabs } from \"./wizard-tabs.js\";\n\ntype KeyHintProps = {\n  isVisible?: boolean;\n  isActive?: boolean;\n  label: string;\n  values: string[];\n};\n\nconst DefinitionItem: React.FC<KeyHintProps> = ({\n  isVisible = true,\n  isActive = false,\n  label,\n  values,\n}) => {\n  if (!isVisible) {\n    return null;\n  }\n\n  return (\n    <Text>\n      {values.map((value) => (\n        <Fragment key={value}>\n          <Text\n            backgroundColor=\"black\"\n            color={isActive ? CLI_COLORS.PRIMARY : CLI_COLORS.UNFOCUSED}\n          >\n            {\" \"}\n            {value}{\" \"}\n          </Text>{\" \"}\n        </Fragment>\n      ))}\n      <Text color={isActive ? CLI_COLORS.PRIMARY : undefined}>{label}</Text>\n    </Text>\n  );\n};\n\nconst HOT_KEYS: { label: string; values: string[] }[] = [\n  { label: \"navigate\", values: [KEY_LABEL_ARROWS_VERT] },\n  { label: \"select\", values: [KEY_LABEL_SPACE] },\n  { label: \"continue\", values: [KEY_LABEL_ENTER] },\n  { label: \"back\", values: [KEY_LABEL_ESC] },\n];\n\nconst WizardFooter = () => {\n  return (\n    <Box\n      columnGap={2}\n      borderTop\n      borderRight={false}\n      borderBottom\n      borderLeft={false}\n      borderColor=\"blackBright\"\n      borderStyle=\"single\"\n      paddingLeft={1}\n      paddingRight={1}\n    >\n      {HOT_KEYS.map((hotkey) => (\n        <DefinitionItem {...hotkey} key={hotkey.label} />\n      ))}\n    </Box>\n  );\n};\n\ntype WizardLayoutProps = {\n  version?: string;\n  logo?: string;\n  startupMessages?: StartupMessage[];\n  children: React.ReactNode;\n};\n\nexport const WizardLayout: React.FC<WizardLayoutProps> = ({\n  version,\n  logo,\n  startupMessages,\n  children,\n}) => {\n  const store = useWizardStore();\n  const { completedSteps, skippedSteps } = store.getStepProgress();\n  const { rows: terminalHeight } = useTerminalDimensions();\n\n  return (\n    <>\n      {startupMessages && startupMessages.length > 0 && (\n        <Static items={startupMessages}>\n          {(msg, index) => (\n            <Box key={index}>\n              <Text\n                color={msg.level === \"warn\" ? \"yellow\" : msg.level === \"error\" ? \"red\" : undefined}\n              >\n                {msg.level === \"warn\" ? `  Warning: ${msg.text}` : msg.text}\n              </Text>\n            </Box>\n          )}\n        </Static>\n      )}\n      <Box flexDirection=\"column\" paddingX={1} height={terminalHeight}>\n        {logo && store.step === \"stack\" && (\n          <Box flexDirection=\"row\" marginTop={1} columnGap={1}>\n            <Text>{logo}</Text>\n          </Box>\n        )}\n        <WizardTabs\n          steps={WIZARD_STEPS}\n          currentStep={store.step}\n          completedSteps={completedSteps}\n          skippedSteps={skippedSteps}\n          version={version}\n        />\n        {store.showHelp ? (\n          <HelpModal currentStep={store.step} />\n        ) : (\n          <>\n            <Box flexDirection=\"column\" flexGrow={1} flexBasis={0} marginTop={1}>\n              {children}\n            </Box>\n            <Box paddingX={1} columnGap={2} marginTop={2}>\n              <DefinitionItem\n                label=\"Labels\"\n                values={[HOTKEY_TOGGLE_LABELS.label]}\n                isVisible={store.step === \"build\"}\n                isActive={store.showLabels}\n              />\n              <DefinitionItem\n                label=\"Scope\"\n                values={[HOTKEY_SCOPE.label]}\n                isVisible={store.step === \"build\"}\n              />\n              <DefinitionItem\n                label=\"Settings\"\n                values={[HOTKEY_SETTINGS.label]}\n                isVisible={store.step === \"sources\" && FEATURE_FLAGS.SOURCE_SEARCH}\n                isActive={store.showSettings}\n              />\n              <DefinitionItem label=\"Help\" values={[HOTKEY_HELP.label]} />\n            </Box>\n            <WizardFooter />\n          </>\n        )}\n      </Box>\n    </>\n  );\n};\n","import { useState, useEffect } from \"react\";\nimport { useStdout } from \"ink\";\n\nconst DEFAULT_COLUMNS = 80;\nconst DEFAULT_ROWS = 24;\n\nexport type TerminalDimensions = {\n  /** Terminal width in columns */\n  columns: number;\n  /** Terminal height in rows */\n  rows: number;\n};\n\n/**\n * Tracks terminal dimensions reactively. Re-renders on resize.\n *\n * Falls back to DEFAULT_COLUMNS x DEFAULT_ROWS when stdout is not a TTY\n * (e.g., piped output, CI environments, tests).\n */\nexport function useTerminalDimensions(): TerminalDimensions {\n  const { stdout } = useStdout();\n\n  const [dimensions, setDimensions] = useState<TerminalDimensions>(() => ({\n    columns: stdout.columns || DEFAULT_COLUMNS,\n    rows: stdout.rows || DEFAULT_ROWS,\n  }));\n\n  useEffect(() => {\n    const handleResize = () => {\n      setDimensions({\n        columns: stdout.columns || DEFAULT_COLUMNS,\n        rows: stdout.rows || DEFAULT_ROWS,\n      });\n    };\n\n    stdout.on(\"resize\", handleResize);\n    return () => {\n      stdout.off(\"resize\", handleResize);\n    };\n  }, [stdout]);\n\n  return dimensions;\n}\n"],"mappings":"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","names":["Fragment"]}

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-OV5UJWS5.js → chunk-62FBXUNR.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-XMLCXRTS.js";
 import {
   ViewTitle
-} from "./chunk-AQYAVLZK.js";
+} from "./chunk-7M4INWUR.js";
 import {
   CLI_COLORS,
   UI_SYMBOLS
@@ -115,4 +115,4 @@ var CheckboxGrid = ({
 export {
   CheckboxGrid
 };
-//# sourceMappingURL=chunk-OV5UJWS5.js.map
+//# sourceMappingURL=chunk-62FBXUNR.js.map

package/dist/{chunk-VYHRCFMD.js → chunk-6RGNXTTG.js}

@@ -10,13 +10,13 @@ import {
 } from "./chunk-MWGDG4QN.js";
 import {
   SourceGrid
-} from "./chunk-TPXDHJDB.js";
+} from "./chunk-TDHEAHXD.js";
 import {
   ViewTitle
-} from "./chunk-AQYAVLZK.js";
+} from "./chunk-7M4INWUR.js";
 import {
   useWizardStore
-} from "./chunk-PUZLP4SL.js";
+} from "./chunk-EWGFIBBU.js";
 import {
   HOTKEY_SET_ALL_LOCAL,
   HOTKEY_SET_ALL_PLUGIN,
@@ -27,7 +27,7 @@ import {
 import {
   resolveAllSources,
   searchExtraSources
-} from "./chunk-2EXAK22V.js";
+} from "./chunk-6W4H2K3Z.js";
 import {
   CLI_COLORS,
   DEFAULT_BRANDING
@@ -181,4 +181,4 @@ var StepSources = ({ projectDir, onContinue, onBack }) => {
 export {
   StepSources
 };
-//# sourceMappingURL=chunk-VYHRCFMD.js.map
+//# sourceMappingURL=chunk-6RGNXTTG.js.map

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