agents-inc 0.163.0 → 0.165.0

package/CHANGELOG.md

@@ -7,6 +7,67 @@ 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.165.0] - 2026-10-01
+
+**A new installation's source folder is `.agents-inc/<provider>/`, a configuration can be installed onto OpenAI Codex, and `edit --from` applies a sub-agent's model and effort**
+
+**The source folder.** No command moves an installation that already exists.
+
+- **New installs write `.agents-inc/claude/`** instead of `.claude-src/`, at both scopes: `<project>/.agents-inc/claude/` and `~/.agents-inc/claude/`. The folder is named for the product and grouped by provider, so a Codex installation is `.agents-inc/codex/` with the same shape. One installation is exactly one provider and the folder is what says which; nothing inside `config.ts` records it.
+- **Nothing in the CLI moves an existing installation.** An installation on `.claude-src/` is read and written where it is, by every command, indefinitely. There is no dual-write, no copy on first run, and no deprecation warning that changes where bytes land. Every message naming the config file names the folder the scope is actually on.
+- **Moving a folder is a manual step, and there is no command for it.** The procedure is in `.ai-docs/reference/concepts/source-folder-layout.md`, along with its two gotchas: `config-types.ts`'s relative import gains a level, and a `.gitignore` with a bare `.agents-inc/` rule hides the moved config, so the next commit records only the deletion. Running `npx agents-inc compile` in the moved scope repairs the first.
+- **`doctor` gains a `Layout` row per scope.** It reports which folder the scope is on, whether both folders are on disk and which one is being read, and any compiled sub-agent whose prompt names the folder this installation does not use. At `$HOME` it also lists the registered projects still on the old name, labelled as the registry rather than an inventory of the machine.
+- **`init`, `edit`, `compile`, `update` and `eject` refuse outright while a scope holds both folders**, because the folder the resolver prefers can be the stale one. The refusal names the folder being read and asks you to merge by hand. `doctor` and `list` keep working in that state. A scope on the old name alone is a supported state, not a fault: no write command prints a line about it, and `doctor`'s `Layout` row reports it as a warning naming the move by hand.
+- **Installed output keeps every path it had.** Claude still installs into `.claude/`, skills into `.claude/skills/` and compiled sub-agents into `.claude/agents/`. A shared payload names no source folder, so the rename reaches no share id.
+- **A marketplace source repository gains no provider segment.** A repo declares itself in `.agents-inc/config.ts`, and one still declaring `.claude-src/config.ts` is read there with no sunset.
+- **`uninstall` removes the `.agents-inc/` parent** once the last provider folder under it is gone, and only when the parent is otherwise empty. If you keep your own files under it, the run says it kept the parent rather than leaving it behind silently.
+- **A compiled `agent-summoner` names the source folder its own installation uses**, substituted at compile time, rather than a literal that is wrong on half of all installs.
+
+**OpenAI Codex as a second provider.** You pick the provider in the web app, and the folder on disk is the only record of which one it is.
+
+- **The provider is chosen in the editor, not in the terminal.** A `provider` row in the roster footer picks it, and the command the Install dialog hands you becomes `npx agents-inc init --from <id> --provider codex`. The terminal wizard gains no step. `--provider` without `--from` exits `INVALID_ARGS`, naming `--from` and the editor.
+- **Where one scope holds an installation of each provider, `--provider` is the disambiguator.** `edit`, `uninstall`, `share`, `eject`, `compile` and `update` refuse rather than guess, naming both. `list --provider` picks one. `doctor` reports the state instead of refusing.
+- **Codex offers three of the four placements**: plugin + global, eject + global, and eject + project. Eject + project lands at `<repo>/.agents/skills/<id>/`, a committed directory that reaches the model with no plugin, no marketplace and no trust entry. `plugin + project` is refused by name before anything is written, never quietly ejected instead. The refusal also fires when a config is read, so a `.agents-inc/claude/` copied to `.agents-inc/codex/` is caught.
+- **Sixteen of the eighteen sub-agents compile, as Codex agent role definitions in TOML.** `agent-summoner` and `skill-summoner` are left out for v1, and every Codex install says so once. A role file carries no `model`, since every model a sub-agent can name is Claude's and Codex refuses to start a role naming one; each sub-agent runs on your Codex session's model. Six settings have no Codex expression, and each compile says so once.
+- **`doctor` gains a `Placements Offered` row.** It reports a placement no host can fill and a scope holding two installations, the states other commands stop on, and never refuses.
+- **`uninstall` counts the plugins it observed being removed**, on either host, rather than the plugins it asked about.
+- **What Codex cannot do**: install a plugin for one project; restrict a sub-agent's tools (`tools` is a configuration struct, not an allowlist, so the read-only sub-agents can still edit files); preload a named list of skills; or carry a sub-agent's `disallowedTools`, which is dropped without a mention (no shipped sub-agent declares one).
+- CLI-893: a Codex project's role files need that project trusted in your global Codex config, so the install writes that entry and prints exactly what it wrote. Any later `compile` does the same. A `trust_level` you already set, `"untrusted"` included, is left as you set it and reported. Each of the four ways that trust fails is silent: no entry, `untrusted`, a trailing slash on the path, or the entry written inside the project.
+- CLI-895: an ejected skill's copy is deleted from the folder Codex reads. Switching it to plugin or deselecting it in `edit` used to leave the copy, so Codex read the skill twice.
+- CLI-896: `uninstall` on Codex removes the role files it compiled (`.codex/agents/*.toml`) and leaves a role you wrote yourself, as it does `.claude/agents/*.md` on Claude. `compile` prunes a deselected Codex role the same way.
+
+**Fixes on either host.**
+
+- CLI-898: the editor's output preview lists each skill with the description the install writes, its `SKILL.md` description, rather than the wizard's short label. `build marketplace` puts it in `catalog.json` as `activationDescription`; a catalogue built before this release still previews the label.
+- CLI-899: the loading spinner's last frame no longer survives into the `init` and `edit` wizards. A frame held by Ink's render throttle was painted after the clear, so the full-height wizard lost its top line.
+- `compile` no longer refuses an installation with sub-agents and no skills, which the editor makes and `init --from` installs. A config that declares skills, none of which are on disk, is still refused.
+- `edit --from` applies a configuration whose only difference is a sub-agent's `model` or `effort`, and reports it as its own line. It used to print `No changes made.` and write nothing. Re-selecting a sub-agent in the wizard no longer reverts its model and effort.
+- A local marketplace directory whose path contains a space, such as `/Users/My Name/…`, now reaches `claude` and `codex` instead of being refused by a pattern written for `owner/repo` references.
+
+**On Claude Code, a project sub-agent's completion gate runs only in a folder you have trusted.**
+
+- Claude Code drops the gate otherwise, without a word anywhere you would look. So `init` and `compile` now say so in one line naming the folder. They print it when a compiled sub-agent in `<project>/.claude/agents/` has at least one hook under `Stop` or `SubagentStop`, and `~/.claude.json` has no record of you accepting that folder's trust dialog. A run from the home directory never prints it. The CLI never accepts the dialog for you.
+
+**Withdrawn before release.**
+
+- **`npx agents-inc migrate`.** An earlier draft of this release carried a command that performed the move, with `--adopt`, `--dry-run`, a forwarding stub at the old path, a registered-project rewrite and a git-visibility probe. It was never requested and is deleted whole; nothing in the CLI hands out the invocation.
+- A per-agent lint and check gate, including the `check:` map and a Codex gate plugin with its hook trust, was reverted before release on the owner's 2026-10-01 ruling, and 0.163.0's typecheck `Stop` hook is unchanged.
+
+See [changelogs/0.165.0.md](./changelogs/0.165.0.md) for full details.
+
+## [0.164.0] - 2026-09-06
+
+**Every shipped sub-agent moves to the 2026-09-03 doctrine, the web skills say when to reach for them, and the editor takes the 2026-09-05 design refresh**
+
+- All 18 shipped sub-agents now read in the doctrine's voice: 14,236 markdown lines down to 9,026 (−37%), 228 `**(You MUST …)**` down to 1 — the one that names the retired form in order to forbid it — and 26 `CRITICAL:` headings and 15 "Failure to follow…" closers to zero
+- A `web-*` skill's `usageGuidance` names the situation it is for rather than restating its title. A third pass over the marketplace closed two surfaces the first two never reached, found by byte-comparing every file against the baseline rather than trusting an estimate: 38 files and 10,190 lines had never been opened, against an estimate of ~4,000
+- The editor takes the third in-place design refresh — `selected` onto the skills hinge stating its own value, equal full-width domain cells at one type size, the first stack cell as the reset, a full-row assignment pulse, three action cells over Install, fullscreen and a splitter on the output preview, one icon set, receding disabled cells, a warmer column and an amber field on the active nav item (EDITOR-09)
+- EDITOR-75: `pb-30` under a `sticky bottom-0` dock was not clearance — a sticky box is confined to its containing block's content box, so the padding lay entirely below anywhere the dock could rest, parking it 132px above the viewport floor with 132px of grid off-screen
+- EDITOR-76: every bordered text field is now the whole of its own border. All five take the caret from every corner, and the caret lands where the pointer went rather than at the end — the half a `<label>` wrapper satisfies by accident
+- EDITOR-79: the domain strip navigates rather than filters. Clicking `API` no longer hides `web`, `?domain=` is an anchor rather than a filter, and a tab reports `aria-current` instead of a pressed state it could never turn off
+
+See [changelogs/0.164.0.md](./changelogs/0.164.0.md) for full details.
+
 ## [0.163.0] - 2026-09-04
 
 **Every compiled sub-agent gets a slimmer, cacheable prompt and a deterministic completion gate, and a skill's own trigger sentence finally reaches the agent that loads it**

package/README.md

@@ -61,7 +61,6 @@ npx agents-inc init
 | [Editing your config](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/guides/editing-config.md)                        | Skill mappings, preloaded vs dynamic loading, and config structure   |
 | [Customizing subagents](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/guides/customizing-subagents.md)               | Eject and modify partials, templates, and skills                     |
 | [Writing custom skills and subagents](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/guides/writing-custom-skills.md) | Author skills and subagents from scratch or iterate on existing ones |
-| [Importing third-party skills](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/guides/importing-skills.md)             | Install skills from external repositories                            |
 | [Creating a marketplace](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/guides/creating-a-marketplace.md)             | Build a personal or org-level marketplace with curated skills        |
 | [Documenting your codebase](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/guides/documenting-your-codebase.md)       | Generate and maintain AI-focused reference documentation             |
 
@@ -73,13 +72,13 @@ Over 200 skills across 9 domains:
 | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Web     | React, Vue, Angular, Svelte, SolidJS, Next.js, Remix, Nuxt, SvelteKit, Astro, Qwik, Tailwind, SCSS Modules, Zustand, Redux, Pinia, Vitest, Playwright, Storybook, and more |
 | API     | Hono, Express, Fastify, NestJS, Elysia, Drizzle, Prisma, PostgreSQL, MongoDB, Redis, Stripe, and more                                                                      |
-| AI      | Anthropic SDK, OpenAI SDK, Vercel AI SDK, LangChain, LlamaIndex, Pinecone, ChromaDB, and more                                                                              |
-| Mobile  | React Native, Expo                                                                                                                                                         |
-| Desktop | Tauri, Electron, Electron Forge, electron-updater                                                                                                                          |
+| AI      | Anthropic SDK, OpenAI SDK, Vercel AI SDK, LangChain, LlamaIndex, and more                                                                                                  |
+| Mobile  | React Native, Expo, and more                                                                                                                                               |
+| Desktop | Tauri, Electron, Electron Forge, electron-updater, and more                                                                                                                |
 | CLI     | oclif + Ink, Commander, Clack                                                                                                                                              |
-| Infra   | Docker, GitHub Actions, Cloudflare Workers                                                                                                                                 |
-| Shared  | Turborepo, ESLint + Prettier, Code Reviewing, Auth Security                                                                                                                |
-| Meta    | Research Methodology, CLI Reviewing                                                                                                                                        |
+| Infra   | Docker, GitHub Actions, Cloudflare Workers, and more                                                                                                                       |
+| Shared  | Turborepo, ESLint + Prettier, Auth Security, and more                                                                                                                      |
+| Meta    | Code Reviewing, CLI Reviewing, Research Methodology, and more                                                                                                              |
 
 Browse the full catalog on the [Plugin Marketplace](https://github.com/agents-inc/skills).
 
@@ -107,7 +106,7 @@ Each subagent is composed from modular partials (role, workflow, output format)
 | `edit`    | Modify skill selection via the interactive wizard                           |
 | `compile` | Recompile subagents after changes                                           |
 | `update`  | Refresh the marketplaces this installation uses (ejected skills are yours)  |
-| `search`  | Search skills across all sources                                            |
+| `search`  | Search this installation's marketplace and your local skills                |
 
 ### Customization
 
@@ -119,7 +118,7 @@ Each subagent is composed from modular partials (role, workflow, output format)
 
 | Command             | Description                                    |
 | ------------------- | ---------------------------------------------- |
-| `build marketplace` | Generate `marketplace.json` from source skills |
+| `build marketplace` | Generate `marketplace.json` from built plugins |
 | `build plugins`     | Build skill and agent plugins for distribution |
 
 ### Diagnostics

package/dist/{chunk-SMSB6YZW.js → chunk-42TNV2TK.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   getAgentDefinitions
-} from "./chunk-O664ITBD.js";
+} from "./chunk-UR3RRTPO.js";
 import {
   loadMergedAgents
-} from "./chunk-XPDVAJDH.js";
+} from "./chunk-IM45LLQX.js";
 
 // src/cli/lib/operations/project/load-agent-defs.ts
 async function loadAgentDefs() {
@@ -20,4 +20,4 @@ async function loadAgentDefs() {
 export {
   loadAgentDefs
 };
-//# sourceMappingURL=chunk-SMSB6YZW.js.map
+//# sourceMappingURL=chunk-42TNV2TK.js.map

package/dist/chunk-4AAOOAIN.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import {
+  render
+} from "./chunk-JFLVEFFP.js";
+
+// src/cli/components/common/prompt-confirm.tsx
+import "react";
+async function promptValue(build, options) {
+  const answer = { settle: () => {
+  } };
+  const chosen = new Promise((resolve) => {
+    answer.settle = resolve;
+  });
+  const releaseInput = holdInputRaw(process.stdin);
+  try {
+    const instance = render(build((value2) => answer.settle(value2)));
+    instance.waitUntilExit().then(
+      () => answer.settle(options.onExit),
+      () => answer.settle(options.onExit)
+    );
+    const value = await chosen;
+    if (options.clearOnResolve) instance.clear();
+    instance.unmount();
+    return value;
+  } finally {
+    releaseInput();
+  }
+}
+function holdInputRaw(input) {
+  if (!input.isTTY) return () => {
+  };
+  const wasRaw = input.isRaw;
+  input.setRawMode(true);
+  return () => {
+    input.setRawMode(wasRaw);
+  };
+}
+async function promptConfirm(build) {
+  return promptValue(
+    (resolve) => build({ onConfirm: () => resolve("confirmed"), onCancel: () => resolve("cancelled") }),
+    { onExit: "cancelled" }
+  );
+}
+
+export {
+  promptValue,
+  promptConfirm
+};
+//# sourceMappingURL=chunk-4AAOOAIN.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/components/common/prompt-confirm.tsx"],"sourcesContent":["import React from \"react\";\nimport { render } from \"../render.js\";\n\nexport type ConfirmHandlers = {\n  onConfirm: () => void;\n  onCancel: () => void;\n};\n\nexport type PromptValueOptions<T> = {\n  /** Value resolved when the Ink app exits before any callback fires (Ctrl+C / render failure). */\n  onExit: T;\n  /** Call instance.clear() before unmount — repaints a clean terminal (used by the dashboard). */\n  clearOnResolve?: boolean;\n};\n\n/**\n * Renders an Ink prompt and resolves with the value produced by its callbacks.\n * First-wins: the first resolve (a callback or the app-exit fallback) settles the\n * promise; later resolves are ignored. The element is unmounted at the resolution\n * site (optionally cleared first). Callers own exit policy (exit codes, logging).\n *\n * A prompt may resolve before `render()` has handed its instance back: Ink flushes\n * mount effects synchronously, so a component that settles on mount reaches the\n * callback first. The teardown is then run the moment the instance exists — one\n * statement later, on the same tick — so callers that resolve from a keypress see\n * exactly the order they always did.\n *\n * The terminal is raw before the first frame is painted, through {@link holdInputRaw}.\n */\nexport async function promptValue<T>(\n  build: (resolve: (value: T) => void) => React.ReactElement,\n  options: PromptValueOptions<T>,\n): Promise<T> {\n  // The promise's own `resolve`, lifted out so the render can be a plain `const` below\n  // rather than a binding the element's callbacks would reach while `render()` is still\n  // producing it. The seed is never called: a Promise executor runs synchronously, so the\n  // next statement has already replaced it by the time anything can answer.\n  const answer: { settle: (value: T) => void } = { settle: () => {} };\n  const chosen = new Promise<T>((resolve) => {\n    answer.settle = resolve;\n  });\n\n  const releaseInput = holdInputRaw(process.stdin);\n  try {\n    const instance = render(build((value) => answer.settle(value)));\n\n    // App exit without a callback (e.g. Ctrl+C) or a render failure counts as the\n    // fallback; the promise is first-wins, so a prior callback value is unaffected.\n    instance.waitUntilExit().then(\n      () => answer.settle(options.onExit),\n      () => answer.settle(options.onExit),\n    );\n\n    const value = await chosen;\n\n    // Taken down here rather than at each resolve site: it then happens exactly once,\n    // whichever of the three endings settled the promise, and always with an instance in\n    // hand — including the ending that arrives before `render()` has returned one.\n    if (options.clearOnResolve) instance.clear();\n    instance.unmount();\n\n    return value;\n  } finally {\n    releaseInput();\n  }\n}\n\n/**\n * Puts a terminal's input into raw mode for as long as a prompt is up, and returns what puts it\n * back the way it was. Input that is not a terminal has no mode to set, and is left alone.\n *\n * Ink takes raw mode only from `useInput`'s effect, which runs after the frame it belongs to has\n * been written. A key pressed between the two reaches a terminal still in cooked mode: the kernel\n * echoes an Enter as a line break, which scrolls a full-height frame up by a line that is never\n * repainted, and turns it into `\\n`, which Ink reads as `enter` — and every prompt here waits for\n * `return`. Taken here, before the render, the key is held as typed until Ink starts reading.\n *\n * Ink's own handling is unchanged: `useInput` still sets raw mode and Ink still turns it off at\n * unmount. This closes the gap before the effect, and restores the mode for a prompt that never\n * took input or failed to render, where Ink has nothing to turn off.\n *\n * Prompts only, never every render: raw mode turns Ctrl+C into a byte for whoever reads input,\n * and the spinner reads none, so a load under it could no longer be interrupted.\n */\nfunction holdInputRaw(input: NodeJS.ReadStream): () => void {\n  if (!input.isTTY) return () => {};\n  const wasRaw = input.isRaw;\n  input.setRawMode(true);\n  return () => {\n    input.setRawMode(wasRaw);\n  };\n}\n\n/**\n * Renders a confirm UI and resolves with the user's choice. The element is\n * unmounted as soon as either handler fires; a clean exit or render failure\n * without a choice resolves as \"cancelled\". Callers own exit policy.\n */\nexport async function promptConfirm(\n  build: (handlers: ConfirmHandlers) => React.ReactElement,\n): Promise<\"confirmed\" | \"cancelled\"> {\n  return promptValue<\"confirmed\" | \"cancelled\">(\n    (resolve) =>\n      build({ onConfirm: () => resolve(\"confirmed\"), onCancel: () => resolve(\"cancelled\") }),\n    { onExit: \"cancelled\" },\n  );\n}\n"],"mappings":";;;;;;AAAA,OAAkB;AA6BlB,eAAsB,YACpB,OACA,SACY;AAKZ,QAAM,SAAyC,EAAE,QAAQ,MAAM;AAAA,EAAC,EAAE;AAClE,QAAM,SAAS,IAAI,QAAW,CAAC,YAAY;AACzC,WAAO,SAAS;AAAA,EAClB,CAAC;AAED,QAAM,eAAe,aAAa,QAAQ,KAAK;AAC/C,MAAI;AACF,UAAM,WAAW,OAAO,MAAM,CAACA,WAAU,OAAO,OAAOA,MAAK,CAAC,CAAC;AAI9D,aAAS,cAAc,EAAE;AAAA,MACvB,MAAM,OAAO,OAAO,QAAQ,MAAM;AAAA,MAClC,MAAM,OAAO,OAAO,QAAQ,MAAM;AAAA,IACpC;AAEA,UAAM,QAAQ,MAAM;AAKpB,QAAI,QAAQ,eAAgB,UAAS,MAAM;AAC3C,aAAS,QAAQ;AAEjB,WAAO;AAAA,EACT,UAAE;AACA,iBAAa;AAAA,EACf;AACF;AAmBA,SAAS,aAAa,OAAsC;AAC1D,MAAI,CAAC,MAAM,MAAO,QAAO,MAAM;AAAA,EAAC;AAChC,QAAM,SAAS,MAAM;AACrB,QAAM,WAAW,IAAI;AACrB,SAAO,MAAM;AACX,UAAM,WAAW,MAAM;AAAA,EACzB;AACF;AAOA,eAAsB,cACpB,OACoC;AACpC,SAAO;AAAA,IACL,CAAC,YACC,MAAM,EAAE,WAAW,MAAM,QAAQ,WAAW,GAAG,UAAU,MAAM,QAAQ,WAAW,EAAE,CAAC;AAAA,IACvF,EAAE,QAAQ,YAAY;AAAA,EACxB;AACF;","names":["value"]}

package/dist/{chunk-NQXO4LR3.js → chunk-4C7GL4F7.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   useFocusedListItem
-} from "./chunk-J27W6TXS.js";
+} from "./chunk-XQHZPINL.js";
 import {
   HOTKEY_TOGGLE_LABELS,
   KEY_SPACE,
@@ -9,13 +9,13 @@ import {
 } from "./chunk-WTJ3AY33.js";
 import {
   useSectionScroll
-} from "./chunk-ABAZMMG4.js";
+} from "./chunk-CK5RM3DJ.js";
 import {
   getSkillById
-} from "./chunk-AVK2HEKB.js";
+} from "./chunk-GKPW33FP.js";
 import {
   CLI_COLORS
-} from "./chunk-UITEKY2R.js";
+} from "./chunk-AQXKAPCD.js";
 
 // src/cli/components/wizard/category-grid.tsx
 import { useCallback as useCallback2, useEffect as useEffect2 } from "react";
@@ -33,6 +33,7 @@ function useCategoryGridInput({
   categories,
   focusedRow,
   focusedCol,
+  currentFocus,
   setFocused,
   moveFocus,
   onToggle,
@@ -55,8 +56,9 @@ function useCategoryGridInput({
       return;
     }
     if (key.tab && !key.shift) {
-      const nextSection = findNextIndex(categories, focusedRow);
-      if (nextSection !== focusedRow) {
+      const { row } = currentFocus();
+      const nextSection = findNextIndex(categories, row);
+      if (nextSection !== row) {
         setFocused(nextSection, 0);
       }
       return;
@@ -66,9 +68,11 @@ function useCategoryGridInput({
       return;
     }
     if (input === KEY_SPACE) {
-      const currentOption = currentOptions[focusedCol];
-      if (currentRow && currentOption) {
-        onToggle(currentRow.id, currentOption.id);
+      const { row, col } = currentFocus();
+      const category = categories[row];
+      const option = category?.options[col];
+      if (category && option) {
+        onToggle(category.id, option.id);
       }
       return;
     }
@@ -204,7 +208,7 @@ var CategoryGrid = ({
     },
     [showLabels, onToggleLabels, onFocusChange]
   );
-  const { focusedRow, focusedCol, setFocused, moveFocus } = useFocusedListItem(
+  const { focusedRow, focusedCol, currentFocus, setFocused, moveFocus } = useFocusedListItem(
     categories.length,
     getColCount,
     {
@@ -219,6 +223,7 @@ var CategoryGrid = ({
     categories,
     focusedRow,
     focusedCol,
+    currentFocus,
     setFocused,
     moveFocus,
     onToggle,
@@ -260,4 +265,4 @@ var CategoryGrid = ({
 export {
   CategoryGrid
 };
-//# sourceMappingURL=chunk-NQXO4LR3.js.map
+//# sourceMappingURL=chunk-4C7GL4F7.js.map

package/dist/chunk-4C7GL4F7.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 } from \"react\";\n\nimport { Box, Text } from \"ink\";\n\nimport { CLI_COLORS } from \"../../consts.js\";\nimport { getSkillById } from \"../../lib/matrix/matrix-provider.js\";\nimport type { Category, OptionState, SkillId, SkillScope } from \"../../types/index.js\";\nimport { useCategoryGridInput } from \"../hooks/use-category-grid-input.js\";\nimport { useFocusedListItem } from \"../hooks/use-focused-list-item.js\";\nimport { useSectionScroll } from \"../hooks/use-section-scroll.js\";\n\nexport type CategoryOption = {\n  id: SkillId;\n  state: OptionState;\n  selected: boolean;\n  local?: boolean;\n  installed?: boolean;\n  scope?: SkillScope;\n  /** Secondary scope badge shown alongside primary (e.g. after G->P toggle, excluded tombstone) */\n  secondaryScope?: SkillScope;\n  source?: string;\n  /** True when selected but has unmet dependency requirements (shown dimmed) */\n  hasUnmetRequirements?: boolean;\n  /** Explains unmet requirements (shown in label when D pressed) */\n  unmetRequirementsReason?: string;\n  /** Display name of the skill that requires this one (e.g. \"Next.js\") */\n  requiredBy?: string;\n};\n\nexport type CategoryRow = {\n  id: Category;\n  displayName: string;\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  onToggle: (categoryId: Category, 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  /** Optional callback fired with the resolved SkillId of the focused cell */\n  onFocusedSkillChange?: (skillId: SkillId | null) => void;\n};\n\n/** Next option index stepping cyclically from `currentIndex`; empty rows stay put. */\nconst wrapOptionIndex = (length: number, currentIndex: number, direction: 1 | -1): number => {\n  if (length === 0) return currentIndex;\n  return (currentIndex + direction + length) % length;\n};\n\ntype SkillTagProps = {\n  option: CategoryOption;\n  isFocused: boolean;\n  showLabels: boolean;\n};\n\n/**\n * The verdict word and the reason behind it — `(incompatible: conflicts with Vue\n * Composition Api)`. Every advisory state but `normal` carries a reason, so the\n * status discriminant narrows to the two that have one to state.\n *\n * The word leads rather than the reason: it is the only carrier of the verdict\n * once colour is off, a `discourages` rule's reason is free-form author prose\n * that need not identify itself as a discouragement, and `CELL_ANNOTATION` in\n * `e2e/pages/steps/build-step.ts` anchors cell-label parsing on that keyword.\n *\n * Nothing is elided. A long reason grows the tag and wraps inside its border,\n * which is what `unmetRequirementsReason` above already does.\n */\nconst advisoryAnnotation = (state: OptionState): string | null =>\n  state.status === \"normal\" ? null : `(${state.status}: ${state.reason})`;\n\nconst getCompatibilityLabel = (option: CategoryOption): string | null => {\n  if (option.selected && option.hasUnmetRequirements && option.unmetRequirementsReason) {\n    return `(${option.unmetRequirementsReason})`;\n  }\n  if (option.selected) return null;\n  if (option.requiredBy) return `(required by ${option.requiredBy})`;\n  return advisoryAnnotation(option.state);\n};\n\nconst STATUS_COLORS: Partial<Record<OptionState[\"status\"], string>> = {\n  incompatible: CLI_COLORS.ERROR,\n  discouraged: CLI_COLORS.WARNING,\n};\n\n/** Selected wins, then advisory status; `fallback` covers the plain \"normal\" state. */\nfunction resolveTagColor(option: CategoryOption, fallback: string): string {\n  if (option.selected) return CLI_COLORS.PRIMARY;\n  return STATUS_COLORS[option.state.status] ?? fallback;\n}\n\nconst SkillTag: React.FC<SkillTagProps> = ({ option, isFocused, showLabels }) => {\n  const textColor = resolveTagColor(option, CLI_COLORS.DIM);\n  const hasRequiredBy = option.selected && !!option.requiredBy;\n  const hasUnmetDeps = option.selected && !!option.hasUnmetRequirements;\n  const isDimmed = hasUnmetDeps || hasRequiredBy;\n  const showCompatibility = hasRequiredBy || hasUnmetDeps || (showLabels && isFocused);\n  const compatibilityLabel = showCompatibility ? getCompatibilityLabel(option) : null;\n\n  return (\n    <Box\n      marginRight={1}\n      borderColor={isFocused ? resolveTagColor(option, CLI_COLORS.UNFOCUSED) : textColor}\n      borderDimColor={!isFocused}\n      borderStyle=\"single\"\n      flexShrink={0}\n      paddingLeft={1}\n      flexDirection=\"row\"\n    >\n      <>\n        {option.scope && (\n          <>\n            {[option.scope, option.secondaryScope].filter(Boolean).map((badgeScope, i) => (\n              <Text key={i} color={CLI_COLORS.WARNING} backgroundColor={CLI_COLORS.LABEL_BG}>\n                {badgeScope === \"global\" ? \" G \" : \" P \"}\n              </Text>\n            ))}\n            <Text> </Text>\n          </>\n        )}\n        <Text color={textColor} bold dimColor={isDimmed}>\n          {getSkillById(option.id).displayName}{\" \"}\n        </Text>\n        {compatibilityLabel && (\n          <Text color={textColor} dimColor>\n            {compatibilityLabel}{\" \"}\n          </Text>\n        )}\n      </>\n    </Box>\n  );\n};\n\ntype CategorySectionProps = {\n  isFirst: boolean;\n  category: CategoryRow;\n  isFocused: boolean;\n  focusedOptionIndex: number;\n  showLabels: boolean;\n};\n\nconst CategorySection: React.FC<CategorySectionProps> = ({\n  isFirst,\n  category,\n  isFocused,\n  focusedOptionIndex,\n  showLabels,\n}) => {\n  const { options } = category;\n  const selectedCount = options.filter((o) => o.selected).length;\n\n  const selectionCounter = category.exclusive ? `(${selectedCount} of 1)` : null;\n\n  return (\n    <Box flexDirection=\"column\" marginTop={isFirst ? 0 : 1}>\n      <Box flexDirection=\"row\">\n        {isFocused ? (\n          <Text color={CLI_COLORS.WHITE} backgroundColor={CLI_COLORS.LABEL_BG}>\n            {` ${category.displayName}${selectionCounter ? ` ${selectionCounter}` : \"\"} `}\n          </Text>\n        ) : (\n          <>\n            <Text color={CLI_COLORS.NEUTRAL}>{category.displayName}</Text>\n            {selectionCounter && <Text dimColor> {selectionCounter}</Text>}\n          </>\n        )}\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}\n            showLabels={showLabels}\n          />\n        ))}\n      </Box>\n    </Box>\n  );\n};\n\nexport const CategoryGrid: React.FC<CategoryGridProps> = ({\n  categories,\n  availableHeight = 0,\n  showLabels,\n  onToggle,\n  onToggleLabels,\n  defaultFocusedRow = 0,\n  defaultFocusedCol = 0,\n  onFocusChange,\n  onFocusedSkillChange,\n}) => {\n  const getColCount = useCallback(\n    (row: number): number => categories[row]?.options.length ?? 0,\n    [categories],\n  );\n\n  const findValidCol = useCallback(\n    (row: number, currentCol: number, direction: 1 | -1): number =>\n      wrapOptionIndex(categories[row]?.options.length ?? 0, currentCol, direction),\n    [categories],\n  );\n\n  const handleFocusChange = useCallback(\n    (row: number, col: number) => {\n      if (showLabels) onToggleLabels();\n      onFocusChange?.(row, col);\n    },\n    [showLabels, onToggleLabels, onFocusChange],\n  );\n\n  const { focusedRow, focusedCol, currentFocus, setFocused, moveFocus } = useFocusedListItem(\n    categories.length,\n    getColCount,\n    {\n      wrap: true,\n      findValidCol,\n      onChange: handleFocusChange,\n      initialRow: defaultFocusedRow,\n      initialCol: defaultFocusedCol,\n    },\n  );\n\n  useCategoryGridInput({\n    categories,\n    focusedRow,\n    focusedCol,\n    currentFocus,\n    setFocused,\n    moveFocus,\n    onToggle,\n    onToggleLabels,\n  });\n\n  // Report the focused cell's skill on mount and whenever it changes — including\n  // category reshapes that shift the cell without a navigation event. useFocusedListItem\n  // only fires onChange during navigation, so the initially highlighted cell would\n  // otherwise never reach the store, leaving focusedSkillId out of sync with the visual\n  // focus and making the `s` scope hotkey no-op until the first arrow key.\n  const focusedSkillId = categories[focusedRow]?.options[focusedCol]?.id ?? null;\n  useEffect(() => {\n    onFocusedSkillChange?.(focusedSkillId);\n  }, [focusedSkillId, onFocusedSkillChange]);\n\n  // `hiddenAbove` / `hiddenBelow` are discarded ON PURPOSE — the build grid has\n  // no `ScrollAffordance` and is not getting one (owner decision). On a grid\n  // this dense a half-cut card already says \"there is more\"; a counted hint\n  // would be noise, and it would cost the viewport a row to say what the\n  // clipped card says for free. Do not add one on the strength of the counts\n  // merely being available here.\n  const { setSectionRef, scrollEnabled, scrollTopPx } = useSectionScroll({\n    sectionCount: categories.length,\n    focusedIndex: focusedRow,\n    availableHeight,\n  });\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 noShrink = scrollEnabled ? { flexShrink: 0 } : {};\n\n  const sectionElements = categories.map((category, index) => (\n    <Box key={category.id} ref={(el) => setSectionRef(index, el)} {...noShrink}>\n      <CategorySection\n        category={category}\n        isFocused={index === focusedRow}\n        focusedOptionIndex={focusedCol}\n        showLabels={showLabels}\n        isFirst={index === 0}\n      />\n    </Box>\n  ));\n\n  return (\n    <Box\n      flexDirection=\"column\"\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      </Box>\n    </Box>\n  );\n};\n","import { useCallback, useEffect, useMemo, useRef } from \"react\";\nimport { useInput, type Key } from \"ink\";\n\nimport type { Category, SkillId } from \"../../types/index.js\";\nimport type { CategoryRow } from \"../wizard/category-grid.js\";\nimport type { Direction, FocusedPosition } from \"./use-focused-list-item.js\";\nimport { HOTKEY_TOGGLE_LABELS, KEY_SPACE, isHotkey } from \"../wizard/hotkeys.js\";\n\n/** Find next section index (wrapping forward) */\nconst findNextIndex = (items: { length: number }, currentIndex: number): number => {\n  const length = items.length;\n  if (length === 0) return currentIndex;\n  return (currentIndex + 1) % length;\n};\n\ntype UseCategoryGridInputOptions = {\n  categories: CategoryRow[];\n  focusedRow: number;\n  focusedCol: number;\n  currentFocus: () => FocusedPosition;\n  setFocused: (row: number, col: number) => void;\n  moveFocus: (direction: Direction) => void;\n  onToggle: (categoryId: Category, technologyId: SkillId) => void;\n  onToggleLabels: () => void;\n};\n\nexport function useCategoryGridInput({\n  categories,\n  focusedRow,\n  focusedCol,\n  currentFocus,\n  setFocused,\n  moveFocus,\n  onToggle,\n  onToggleLabels,\n}: UseCategoryGridInputOptions): void {\n  const currentRow = categories[focusedRow];\n  // Memoised so the effect below keys on the row actually changing — the `[]`\n  // fallback used to be a fresh array every render, re-running the effect for\n  // nothing whenever no row was focused.\n  const currentOptions = useMemo(() => currentRow?.options ?? [], [currentRow]);\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  // 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  const handlerRef = useRef<((input: string, key: Key) => void) | null>(null);\n  handlerRef.current = (input: string, key: Key) => {\n    if (key.tab && key.shift) {\n      onToggleLabels();\n      return;\n    }\n\n    // Tab and Space read the focus as it stands now rather than as the last render painted it:\n    // a key that follows a move in the same chunk is handled before that move renders.\n    if (key.tab && !key.shift) {\n      const { row } = currentFocus();\n      const nextSection = findNextIndex(categories, row);\n      if (nextSection !== row) {\n        setFocused(nextSection, 0);\n      }\n      return;\n    }\n\n    if (isHotkey(input, HOTKEY_TOGGLE_LABELS)) {\n      onToggleLabels();\n      return;\n    }\n\n    if (input === KEY_SPACE) {\n      const { row, col } = currentFocus();\n      const category = categories[row];\n      const option = category?.options[col];\n      if (category && option) {\n        onToggle(category.id, option.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      moveFocus(\"left\");\n    } else if (isRight) {\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: Key) => {\n    handlerRef.current?.(input, key);\n  }, []);\n\n  useInput(stableHandler);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,SAAgB,eAAAA,cAAa,aAAAC,kBAAiB;AAE9C,SAAS,KAAK,YAAY;;;ACF1B,SAAS,aAAa,WAAW,SAAS,cAAc;AACxD,SAAS,gBAA0B;AAQnC,IAAM,gBAAgB,CAAC,OAA2B,iBAAiC;AACjF,QAAM,SAAS,MAAM;AACrB,MAAI,WAAW,EAAG,QAAO;AACzB,UAAQ,eAAe,KAAK;AAC9B;AAaO,SAAS,qBAAqB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAsC;AACpC,QAAM,aAAa,WAAW,UAAU;AAIxC,QAAM,iBAAiB,QAAQ,MAAM,YAAY,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC;AAG5E,YAAU,MAAM;AACd,QAAI,CAAC,WAAY;AAEjB,UAAM,SAAS,eAAe,SAAS;AACvC,QAAI,aAAa,QAAQ;AACvB,YAAM,SAAS,KAAK,IAAI,GAAG,MAAM;AACjC,iBAAW,YAAY,MAAM;AAAA,IAC/B;AAAA,EACF,GAAG,CAAC,YAAY,gBAAgB,YAAY,YAAY,UAAU,CAAC;AAOnE,QAAM,aAAa,OAAmD,IAAI;AAC1E,aAAW,UAAU,CAAC,OAAe,QAAa;AAChD,QAAI,IAAI,OAAO,IAAI,OAAO;AACxB,qBAAe;AACf;AAAA,IACF;AAIA,QAAI,IAAI,OAAO,CAAC,IAAI,OAAO;AACzB,YAAM,EAAE,IAAI,IAAI,aAAa;AAC7B,YAAM,cAAc,cAAc,YAAY,GAAG;AACjD,UAAI,gBAAgB,KAAK;AACvB,mBAAW,aAAa,CAAC;AAAA,MAC3B;AACA;AAAA,IACF;AAEA,QAAI,SAAS,OAAO,oBAAoB,GAAG;AACzC,qBAAe;AACf;AAAA,IACF;AAEA,QAAI,UAAU,WAAW;AACvB,YAAM,EAAE,KAAK,IAAI,IAAI,aAAa;AAClC,YAAM,WAAW,WAAW,GAAG;AAC/B,YAAM,SAAS,UAAU,QAAQ,GAAG;AACpC,UAAI,YAAY,QAAQ;AACtB,iBAAS,SAAS,IAAI,OAAO,EAAE;AAAA,MACjC;AACA;AAAA,IACF;AAEA,UAAM,SAAS,IAAI,aAAa,UAAU;AAC1C,UAAM,UAAU,IAAI,cAAc,UAAU;AAC5C,UAAM,OAAO,IAAI,WAAW,UAAU;AACtC,UAAM,SAAS,IAAI,aAAa,UAAU;AAE1C,QAAI,QAAQ;AACV,gBAAU,MAAM;AAAA,IAClB,WAAW,SAAS;AAClB,gBAAU,OAAO;AAAA,IACnB,WAAW,MAAM;AACf,gBAAU,IAAI;AAAA,IAChB,WAAW,QAAQ;AACjB,gBAAU,MAAM;AAAA,IAClB;AAAA,EACF;AAGA,QAAM,gBAAgB,YAAY,CAAC,OAAe,QAAa;AAC7D,eAAW,UAAU,OAAO,GAAG;AAAA,EACjC,GAAG,CAAC,CAAC;AAEL,WAAS,aAAa;AACxB;;;ADQU,mBAEI,KAFJ;AAnEV,IAAM,kBAAkB,CAAC,QAAgB,cAAsB,cAA8B;AAC3F,MAAI,WAAW,EAAG,QAAO;AACzB,UAAQ,eAAe,YAAY,UAAU;AAC/C;AAqBA,IAAM,qBAAqB,CAAC,UAC1B,MAAM,WAAW,WAAW,OAAO,IAAI,MAAM,MAAM,KAAK,MAAM,MAAM;AAEtE,IAAM,wBAAwB,CAAC,WAA0C;AACvE,MAAI,OAAO,YAAY,OAAO,wBAAwB,OAAO,yBAAyB;AACpF,WAAO,IAAI,OAAO,uBAAuB;AAAA,EAC3C;AACA,MAAI,OAAO,SAAU,QAAO;AAC5B,MAAI,OAAO,WAAY,QAAO,gBAAgB,OAAO,UAAU;AAC/D,SAAO,mBAAmB,OAAO,KAAK;AACxC;AAEA,IAAM,gBAAgE;AAAA,EACpE,cAAc,WAAW;AAAA,EACzB,aAAa,WAAW;AAC1B;AAGA,SAAS,gBAAgB,QAAwB,UAA0B;AACzE,MAAI,OAAO,SAAU,QAAO,WAAW;AACvC,SAAO,cAAc,OAAO,MAAM,MAAM,KAAK;AAC/C;AAEA,IAAM,WAAoC,CAAC,EAAE,QAAQ,WAAW,WAAW,MAAM;AAC/E,QAAM,YAAY,gBAAgB,QAAQ,WAAW,GAAG;AACxD,QAAM,gBAAgB,OAAO,YAAY,CAAC,CAAC,OAAO;AAClD,QAAM,eAAe,OAAO,YAAY,CAAC,CAAC,OAAO;AACjD,QAAM,WAAW,gBAAgB;AACjC,QAAM,oBAAoB,iBAAiB,gBAAiB,cAAc;AAC1E,QAAM,qBAAqB,oBAAoB,sBAAsB,MAAM,IAAI;AAE/E,SACE;AAAA,IAAC;AAAA;AAAA,MACC,aAAa;AAAA,MACb,aAAa,YAAY,gBAAgB,QAAQ,WAAW,SAAS,IAAI;AAAA,MACzE,gBAAgB,CAAC;AAAA,MACjB,aAAY;AAAA,MACZ,YAAY;AAAA,MACZ,aAAa;AAAA,MACb,eAAc;AAAA,MAEd,2CACG;AAAA,eAAO,SACN,iCACG;AAAA,WAAC,OAAO,OAAO,OAAO,cAAc,EAAE,OAAO,OAAO,EAAE,IAAI,CAAC,YAAY,MACtE,oBAAC,QAAa,OAAO,WAAW,SAAS,iBAAiB,WAAW,UAClE,yBAAe,WAAW,QAAQ,SAD1B,CAEX,CACD;AAAA,UACD,oBAAC,QAAK,eAAC;AAAA,WACT;AAAA,QAEF,qBAAC,QAAK,OAAO,WAAW,MAAI,MAAC,UAAU,UACpC;AAAA,uBAAa,OAAO,EAAE,EAAE;AAAA,UAAa;AAAA,WACxC;AAAA,QACC,sBACC,qBAAC,QAAK,OAAO,WAAW,UAAQ,MAC7B;AAAA;AAAA,UAAoB;AAAA,WACvB;AAAA,SAEJ;AAAA;AAAA,EACF;AAEJ;AAUA,IAAM,kBAAkD,CAAC;AAAA,EACvD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,EAAE,QAAQ,IAAI;AACpB,QAAM,gBAAgB,QAAQ,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE;AAExD,QAAM,mBAAmB,SAAS,YAAY,IAAI,aAAa,WAAW;AAE1E,SACE,qBAAC,OAAI,eAAc,UAAS,WAAW,UAAU,IAAI,GACnD;AAAA,wBAAC,OAAI,eAAc,OAChB,sBACC,oBAAC,QAAK,OAAO,WAAW,OAAO,iBAAiB,WAAW,UACxD,cAAI,SAAS,WAAW,GAAG,mBAAmB,IAAI,gBAAgB,KAAK,EAAE,KAC5E,IAEA,iCACE;AAAA,0BAAC,QAAK,OAAO,WAAW,SAAU,mBAAS,aAAY;AAAA,MACtD,oBAAoB,qBAAC,QAAK,UAAQ,MAAC;AAAA;AAAA,QAAE;AAAA,SAAiB;AAAA,OACzD,GAEJ;AAAA,IAEA,oBAAC,OAAI,eAAc,OAAM,UAAS,QAAO,WAAW,GACjD,kBAAQ,IAAI,CAAC,QAAQ,UACpB;AAAA,MAAC;AAAA;AAAA,QAEC;AAAA,QACA,WAAW,aAAa,UAAU;AAAA,QAClC;AAAA;AAAA,MAHK,OAAO;AAAA,IAId,CACD,GACH;AAAA,KACF;AAEJ;AAEO,IAAM,eAA4C,CAAC;AAAA,EACxD;AAAA,EACA,kBAAkB;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA,oBAAoB;AAAA,EACpB,oBAAoB;AAAA,EACpB;AAAA,EACA;AACF,MAAM;AACJ,QAAM,cAAcC;AAAA,IAClB,CAAC,QAAwB,WAAW,GAAG,GAAG,QAAQ,UAAU;AAAA,IAC5D,CAAC,UAAU;AAAA,EACb;AAEA,QAAM,eAAeA;AAAA,IACnB,CAAC,KAAa,YAAoB,cAChC,gBAAgB,WAAW,GAAG,GAAG,QAAQ,UAAU,GAAG,YAAY,SAAS;AAAA,IAC7E,CAAC,UAAU;AAAA,EACb;AAEA,QAAM,oBAAoBA;AAAA,IACxB,CAAC,KAAa,QAAgB;AAC5B,UAAI,WAAY,gBAAe;AAC/B,sBAAgB,KAAK,GAAG;AAAA,IAC1B;AAAA,IACA,CAAC,YAAY,gBAAgB,aAAa;AAAA,EAC5C;AAEA,QAAM,EAAE,YAAY,YAAY,cAAc,YAAY,UAAU,IAAI;AAAA,IACtE,WAAW;AAAA,IACX;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN;AAAA,MACA,UAAU;AAAA,MACV,YAAY;AAAA,MACZ,YAAY;AAAA,IACd;AAAA,EACF;AAEA,uBAAqB;AAAA,IACnB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AAOD,QAAM,iBAAiB,WAAW,UAAU,GAAG,QAAQ,UAAU,GAAG,MAAM;AAC1E,EAAAC,WAAU,MAAM;AACd,2BAAuB,cAAc;AAAA,EACvC,GAAG,CAAC,gBAAgB,oBAAoB,CAAC;AAQzC,QAAM,EAAE,eAAe,eAAe,YAAY,IAAI,iBAAiB;AAAA,IACrE,cAAc,WAAW;AAAA,IACzB,cAAc;AAAA,IACd;AAAA,EACF,CAAC;AAED,MAAI,WAAW,WAAW,GAAG;AAC3B,WACE,oBAAC,OAAI,eAAc,UACjB,8BAAC,QAAK,UAAQ,MAAC,uCAAyB,GAC1C;AAAA,EAEJ;AAEA,QAAM,WAAW,gBAAgB,EAAE,YAAY,EAAE,IAAI,CAAC;AAEtD,QAAM,kBAAkB,WAAW,IAAI,CAAC,UAAU,UAChD,oBAAC,OAAsB,KAAK,CAAC,OAAO,cAAc,OAAO,EAAE,GAAI,GAAG,UAChE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA,WAAW,UAAU;AAAA,MACrB,oBAAoB;AAAA,MACpB;AAAA,MACA,SAAS,UAAU;AAAA;AAAA,EACrB,KAPQ,SAAS,EAQnB,CACD;AAED,SACE;AAAA,IAAC;AAAA;AAAA,MACC,eAAc;AAAA,MACb,GAAI,gBACD,EAAE,QAAQ,iBAAiB,UAAU,SAAkB,IACvD,EAAE,UAAU,EAAE;AAAA,MAElB,8BAAC,OAAI,eAAc,UAAS,WAAW,cAAc,IAAI,CAAC,cAAc,GAAI,GAAG,UAC5E,2BACH;AAAA;AAAA,EACF;AAEJ;","names":["useCallback","useEffect","useCallback","useEffect"]}

package/dist/{chunk-Q4IRRVXK.js → chunk-57KU6SPH.js}

@@ -4,11 +4,11 @@ import {
 } from "./chunk-TSIU7DME.js";
 import {
   CategoryGrid
-} from "./chunk-NQXO4LR3.js";
+} from "./chunk-4C7GL4F7.js";
 import {
   buildCategoriesForDomain,
   useWizardStore
-} from "./chunk-K5ITEA3I.js";
+} from "./chunk-UBSSIIWD.js";
 
 // src/cli/components/wizard/step-build.tsx
 import { Box, useInput } from "ink";
@@ -89,4 +89,4 @@ var StepBuild = ({
 export {
   StepBuild
 };
-//# sourceMappingURL=chunk-Q4IRRVXK.js.map
+//# sourceMappingURL=chunk-57KU6SPH.js.map

package/dist/{chunk-S63LXWMC.js → chunk-5M3PQNXI.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CLI_COLORS
-} from "./chunk-UITEKY2R.js";
+} from "./chunk-AQXKAPCD.js";
 
 // src/cli/components/wizard/wizard-tabs.tsx
 import { Box, Text } from "ink";
@@ -165,4 +165,4 @@ export {
   wizardTabsFor,
   WizardTabs
 };
-//# sourceMappingURL=chunk-S63LXWMC.js.map
+//# sourceMappingURL=chunk-5M3PQNXI.js.map

package/dist/{chunk-3WVH2CTK.js → chunk-5P26XBZO.js}

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
 import {
   useRowScroll
-} from "./chunk-YRS3QZP2.js";
+} from "./chunk-CEBDGZID.js";
 import {
   KEY_SPACE
 } from "./chunk-WTJ3AY33.js";
 import {
   CLI_COLORS,
   UI_SYMBOLS
-} from "./chunk-UITEKY2R.js";
+} from "./chunk-AQXKAPCD.js";
 
 // src/cli/components/wizard/checkbox-grid.tsx
 import { Box, Text, useInput } from "ink";
-import { useState } from "react";
+import { useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 var CheckboxGrid = ({
   subtitle,
@@ -25,18 +25,25 @@ var CheckboxGrid = ({
   emptyMessage = "Please select at least one item"
 }) => {
   const totalItems = items.length + 1;
-  const [focusedIndex, setFocusedIndex] = useState(0);
+  const [focusedIndex, setRenderedIndex] = useState(0);
+  const focusedIndexRef = useRef(focusedIndex);
+  const focus = (index) => {
+    focusedIndexRef.current = index;
+    setRenderedIndex(index);
+  };
   useInput((input, key) => {
     if (key.escape) {
       onBack();
       return;
     }
     if (key.upArrow || input === "k") {
-      setFocusedIndex((prev) => prev <= 0 ? totalItems - 1 : prev - 1);
+      const prev = focusedIndexRef.current;
+      focus(prev <= 0 ? totalItems - 1 : prev - 1);
       return;
     }
     if (key.downArrow || input === "j") {
-      setFocusedIndex((prev) => prev >= totalItems - 1 ? 0 : prev + 1);
+      const prev = focusedIndexRef.current;
+      focus(prev >= totalItems - 1 ? 0 : prev + 1);
       return;
     }
     if (key.return) {
@@ -44,7 +51,7 @@ var CheckboxGrid = ({
       return;
     }
     if (input === KEY_SPACE) {
-      const item = items[focusedIndex];
+      const item = items[focusedIndexRef.current];
       if (item) {
         onToggle(item.id);
       }
@@ -108,4 +115,4 @@ var CheckboxGrid = ({
 export {
   CheckboxGrid
 };
-//# sourceMappingURL=chunk-3WVH2CTK.js.map
+//# sourceMappingURL=chunk-5P26XBZO.js.map

package/dist/chunk-5P26XBZO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/components/wizard/checkbox-grid.tsx"],"sourcesContent":["import { Box, Text, useInput } from \"ink\";\nimport React, { useRef, useState } from \"react\";\nimport { CLI_COLORS, UI_SYMBOLS } from \"../../consts.js\";\nimport { useRowScroll } from \"../hooks/use-row-scroll.js\";\nimport { KEY_SPACE } from \"./hotkeys.js\";\n\nexport type CheckboxItem<T extends string = string> = {\n  id: T;\n  label: string;\n  description: string;\n};\n\nexport type CheckboxGridProps<T extends string = string> = {\n  subtitle?: string;\n  items: CheckboxItem<T>[];\n  selectedIds: T[];\n  /** Available height in terminal lines for the scrollable viewport. 0 = no constraint. */\n  availableHeight?: number;\n  onToggle: (id: T) => void;\n  onContinue: () => void;\n  onBack: () => void;\n  /** Message shown when nothing is selected */\n  emptyMessage?: string;\n};\n\nexport const CheckboxGrid = <T extends string = string>({\n  subtitle,\n  items,\n  selectedIds,\n  availableHeight = 0,\n  onToggle,\n  onContinue,\n  onBack,\n  emptyMessage = \"Please select at least one item\",\n}: CheckboxGridProps<T>): React.ReactElement => {\n  // Items + continue option at the end\n  const totalItems = items.length + 1;\n  const [focusedIndex, setRenderedIndex] = useState(0);\n  // The focus Space reads, written the moment it moves rather than once the move renders: a Space\n  // that follows a move in the same chunk is handled before that move renders.\n  const focusedIndexRef = useRef(focusedIndex);\n\n  const focus = (index: number): void => {\n    focusedIndexRef.current = index;\n    setRenderedIndex(index);\n  };\n\n  useInput((input, key) => {\n    if (key.escape) {\n      onBack();\n      return;\n    }\n\n    if (key.upArrow || input === \"k\") {\n      const prev = focusedIndexRef.current;\n      focus(prev <= 0 ? totalItems - 1 : prev - 1);\n      return;\n    }\n\n    if (key.downArrow || input === \"j\") {\n      const prev = focusedIndexRef.current;\n      focus(prev >= totalItems - 1 ? 0 : prev + 1);\n      return;\n    }\n\n    if (key.return) {\n      onContinue();\n      return;\n    }\n\n    if (input === KEY_SPACE) {\n      const item = items[focusedIndexRef.current];\n      if (item) {\n        onToggle(item.id);\n      }\n    }\n  });\n\n  // The Domains grid clips silently: `useRowScroll` exposes no hidden-line\n  // counts and this view renders no `ScrollAffordance`, by owner decision — see\n  // the hook's doc comment.\n  // When focus is on continue (past items), scroll to show last items\n  const effectiveRow = focusedIndex >= items.length ? items.length - 1 : focusedIndex;\n  const { scrollEnabled, scrollTop } = useRowScroll({\n    focusedIndex: effectiveRow,\n    itemCount: items.length,\n    availableHeight,\n  });\n\n  const itemElements = items.map((item, index) => {\n    const isFocused = index === focusedIndex;\n    const isSelected = selectedIds.includes(item.id);\n    const checkbox = isSelected ? \"[\\u2713]\" : \"[ ]\";\n    const pointer = isFocused ? UI_SYMBOLS.CHEVRON : UI_SYMBOLS.CHEVRON_SPACER;\n\n    return (\n      <Text key={item.id}>\n        <Text {...(isFocused && { color: CLI_COLORS.PRIMARY })}>{pointer}</Text>\n        <Text {...((isSelected || isFocused) && { color: CLI_COLORS.PRIMARY })} bold={isFocused}>\n          {\" \"}\n          {checkbox} {item.label}\n        </Text>\n        {item.description && (\n          <Text dimColor>\n            {\"  \"}\n            {item.description}\n          </Text>\n        )}\n      </Text>\n    );\n  });\n\n  const footerElement =\n    selectedIds.length > 0 ? (\n      <Text>\n        {\"\\n\"}Selected: <Text color={CLI_COLORS.WARNING}>{selectedIds.join(\", \")}</Text>\n      </Text>\n    ) : emptyMessage ? (\n      <Text dimColor>\n        {\"\\n\"}\n        {emptyMessage}\n      </Text>\n    ) : null;\n\n  return (\n    <Box flexDirection=\"column\">\n      {subtitle && <Text dimColor>{subtitle}</Text>}\n      <Box\n        flexDirection=\"column\"\n        {...(scrollEnabled && { height: availableHeight, overflow: \"hidden\" as const })}\n      >\n        <Box\n          flexDirection=\"column\"\n          marginTop={scrollTop > 0 ? -scrollTop : 0}\n          {...(scrollEnabled && { flexShrink: 0 })}\n        >\n          {itemElements}\n        </Box>\n      </Box>\n      {footerElement}\n    </Box>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;AAAA,SAAS,KAAK,MAAM,gBAAgB;AACpC,SAAgB,QAAQ,gBAAgB;AAgGhC,cACA,YADA;AAxED,IAAM,eAAe,CAA4B;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB;AAAA,EAClB;AAAA,EACA;AAAA,EACA;AAAA,EACA,eAAe;AACjB,MAAgD;AAE9C,QAAM,aAAa,MAAM,SAAS;AAClC,QAAM,CAAC,cAAc,gBAAgB,IAAI,SAAS,CAAC;AAGnD,QAAM,kBAAkB,OAAO,YAAY;AAE3C,QAAM,QAAQ,CAAC,UAAwB;AACrC,oBAAgB,UAAU;AAC1B,qBAAiB,KAAK;AAAA,EACxB;AAEA,WAAS,CAAC,OAAO,QAAQ;AACvB,QAAI,IAAI,QAAQ;AACd,aAAO;AACP;AAAA,IACF;AAEA,QAAI,IAAI,WAAW,UAAU,KAAK;AAChC,YAAM,OAAO,gBAAgB;AAC7B,YAAM,QAAQ,IAAI,aAAa,IAAI,OAAO,CAAC;AAC3C;AAAA,IACF;AAEA,QAAI,IAAI,aAAa,UAAU,KAAK;AAClC,YAAM,OAAO,gBAAgB;AAC7B,YAAM,QAAQ,aAAa,IAAI,IAAI,OAAO,CAAC;AAC3C;AAAA,IACF;AAEA,QAAI,IAAI,QAAQ;AACd,iBAAW;AACX;AAAA,IACF;AAEA,QAAI,UAAU,WAAW;AACvB,YAAM,OAAO,MAAM,gBAAgB,OAAO;AAC1C,UAAI,MAAM;AACR,iBAAS,KAAK,EAAE;AAAA,MAClB;AAAA,IACF;AAAA,EACF,CAAC;AAMD,QAAM,eAAe,gBAAgB,MAAM,SAAS,MAAM,SAAS,IAAI;AACvE,QAAM,EAAE,eAAe,UAAU,IAAI,aAAa;AAAA,IAChD,cAAc;AAAA,IACd,WAAW,MAAM;AAAA,IACjB;AAAA,EACF,CAAC;AAED,QAAM,eAAe,MAAM,IAAI,CAAC,MAAM,UAAU;AAC9C,UAAM,YAAY,UAAU;AAC5B,UAAM,aAAa,YAAY,SAAS,KAAK,EAAE;AAC/C,UAAM,WAAW,aAAa,aAAa;AAC3C,UAAM,UAAU,YAAY,WAAW,UAAU,WAAW;AAE5D,WACE,qBAAC,QACC;AAAA,0BAAC,QAAM,GAAI,aAAa,EAAE,OAAO,WAAW,QAAQ,GAAK,mBAAQ;AAAA,MACjE,qBAAC,QAAM,IAAK,cAAc,cAAc,EAAE,OAAO,WAAW,QAAQ,GAAI,MAAM,WAC3E;AAAA;AAAA,QACA;AAAA,QAAS;AAAA,QAAE,KAAK;AAAA,SACnB;AAAA,MACC,KAAK,eACJ,qBAAC,QAAK,UAAQ,MACX;AAAA;AAAA,QACA,KAAK;AAAA,SACR;AAAA,SAVO,KAAK,EAYhB;AAAA,EAEJ,CAAC;AAED,QAAM,gBACJ,YAAY,SAAS,IACnB,qBAAC,QACE;AAAA;AAAA,IAAK;AAAA,IAAU,oBAAC,QAAK,OAAO,WAAW,SAAU,sBAAY,KAAK,IAAI,GAAE;AAAA,KAC3E,IACE,eACF,qBAAC,QAAK,UAAQ,MACX;AAAA;AAAA,IACA;AAAA,KACH,IACE;AAEN,SACE,qBAAC,OAAI,eAAc,UAChB;AAAA,gBAAY,oBAAC,QAAK,UAAQ,MAAE,oBAAS;AAAA,IACtC;AAAA,MAAC;AAAA;AAAA,QACC,eAAc;AAAA,QACb,GAAI,iBAAiB,EAAE,QAAQ,iBAAiB,UAAU,SAAkB;AAAA,QAE7E;AAAA,UAAC;AAAA;AAAA,YACC,eAAc;AAAA,YACd,WAAW,YAAY,IAAI,CAAC,YAAY;AAAA,YACvC,GAAI,iBAAiB,EAAE,YAAY,EAAE;AAAA,YAErC;AAAA;AAAA,QACH;AAAA;AAAA,IACF;AAAA,IACC;AAAA,KACH;AAEJ;","names":[]}