@agents-inc/cli 0.68.0 → 0.72.0

package/CHANGELOG.md

@@ -7,6 +7,52 @@ 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.72.0] - 2026-03-12
+
+**Generated source types codegen**
+
+- Codegen script replaces manually-maintained type unions with generated source of truth
+- Strict slug validation at parse boundaries via Zod enum schemas
+- Orphan categories removed, default configuration cleaned up
+
+See [changelogs/0.72.0.md](./changelogs/0.72.0.md) for full details.
+
+---
+
+## [0.71.0] - 2026-03-11
+
+**Reusable SelectList component, Dashboard and GlobalConfigPrompt UX overhaul**
+
+- New `SelectList<T>` component for vertical single-select lists
+- Dashboard simplified to vertical menu (no stats display)
+- Screen clears between successive Ink renders
+
+See [changelogs/0.71.0.md](./changelogs/0.71.0.md) for full details.
+
+---
+
+## [0.70.0] - 2026-03-11
+
+**Centralize remaining test data (R-09b)**
+
+- Pre-built matrix constants and config factories replace inline test data construction
+- CLAUDE.md conventions updated for new test data patterns
+
+See [changelogs/0.70.0.md](./changelogs/0.70.0.md) for full details.
+
+---
+
+## [0.69.0] - 2026-03-11
+
+**loadStackById default stacks fallback (R-01)**
+
+- `loadStackById` now checks built-in default stacks internally
+- R-07 codegen plan for source-derived type unions
+
+See [changelogs/0.69.0.md](./changelogs/0.69.0.md) for full details.
+
+---
+
 ## [0.68.0] - 2026-03-11
 
 **Per-agent scope in edit mode (D-74)**

package/README.md

@@ -1,40 +1,189 @@
-# cli
+<p align="center">
+  <img alt="Agents Inc" src="./assets/logo.svg" width="300">
+</p>
 
-Private marketplace for custom skills and stacks.
+# Agents Inc
 
-## Directory Structure
+An agent composition framework that builds stacks and compiles specialized subagents for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Manage your subagents and skills with code via a unified CLI.
 
-```
-config/stacks.ts         # Stack definitions (agent groupings with skill mappings)
-src/skills/                # Custom skill definitions
-```
+[![npm version](https://img.shields.io/npm/v/@agents-inc/cli)](https://www.npmjs.com/package/@agents-inc/cli)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+[![Node: 18+](https://img.shields.io/badge/Node-18%2B-green.svg)](https://nodejs.org/)
+
+<!-- TODO: Add animated GIF of the full init wizard flow (stack selection -> skill grid -> agent config -> done).
+This is the hero image. It should show the complete happy path in ~15-20 seconds.
+<p align="center">
+  <img src="./assets/init-wizard.gif" alt="Agents Inc init wizard" width="700">
+</p>
+-->
+
+## Overview
+
+Agents Inc comprises two parts:
+
+- **[Marketplace](https://github.com/agents-inc/skills):** 87+ atomic, best-practice skills spanning web, API, CLI, infra, and meta domains
+- **CLI:** installs, ejects, creates, compiles, and updates skills and subagents
 
-## Creating Skills
+Skills are composed into 18+ domain-specific subagents through templates and modular agent partials, all validated against strict Zod schemas. Everything is ejectable so there's endless customisation with no lock-in.
+
+## How It Works
+
+Each subagent is composed from modular partials (role, workflow, output format) plus a set of atomic skills. The CLI manages the full lifecycle:
+
+- **Install:** pull skills from the public marketplace, your own, or a local directory either as plugins or directly as source files
+- **Compose:** map skills to subagents, configure preloaded vs dynamic loading
+- **Compile:** resolve skill mappings, Liquid templates, and agent partials into `.claude/agents/`
+- **Eject:** take progressive ownership of any layer (partials, templates, skills, subagents)
+- **Update:** pull upstream skill changes without losing local customizations
+
+## Getting Started
 
 ```bash
-agentsinc new skill <name> --category <category-name>
+npx @agents-inc/cli init
 ```
 
-Each skill lives in `src/skills/<skill-name>/` with:
+Requires Node 18+ and [Claude Code](https://docs.anthropic.com/en/docs/claude-code).
+
+The wizard has three steps:
+
+**1. Pick a stack or start from scratch** (or create your own in your custom marketplace):
+
+| Stack              | Technologies                                                       |
+| ------------------ | ------------------------------------------------------------------ |
+| `nextjs-fullstack` | Next.js + React + Hono + Drizzle + PostHog + Zustand + React Query |
+| `angular-stack`    | Angular 19 + Signals + NgRx SignalStore + Hono + Drizzle           |
+| `vue-stack`        | Vue 3 Composition API + Pinia + Hono + Drizzle                     |
+| `nuxt-stack`       | Nuxt + Vue 3 full-stack + Pinia + Hono + Drizzle                   |
+| `remix-stack`      | Remix + React + Hono + Drizzle                                     |
+| `solidjs-stack`    | SolidJS + Hono + Drizzle                                           |
+
+**2. Customize skills.** Add or remove from the interactive grid.
+
+**3. Select subagents.** Choose which role-based subagents to include.
+
+**4. Compile.** After init, use `agentsinc edit` to change selections and `agentsinc compile` to rebuild.
+
+## Skills
+
+87+ skills organized by category:
+
+**Web:** `React` `Vue` `Angular` `SolidJS` `Next.js` `Remix` `Nuxt` `SCSS Modules` `CVA` `Zustand` `Pinia` `NgRx SignalStore` `Jotai` `React Query` `SWR` `tRPC` `GraphQL` `React Hook Form` `Zod` `shadcn/ui` `Radix UI` `TanStack Table` `Vitest` `Playwright` `Cypress` `MSW` `Framer Motion` `Storybook` `Accessibility`
+
+**API:** `Hono` `Express` `Fastify` `Drizzle` `Prisma` `Better Auth` `PostHog` `Resend` `Axiom + Pino + Sentry` `GitHub Actions`
+
+**Mobile:** `React Native` `Expo`
+
+**CLI:** `Commander` `oclif + Ink`
 
-- `SKILL.md` -- Skill content (what the skill teaches)
-- `metadata.yaml` -- Skill metadata (category, author, description, custom: true)
+**Infra:** `Turborepo` `Tooling` `Env config`
 
-## Using This Marketplace
+**Meta:** `Code reviewing` `Research methodology` `Investigation requirements` `Anti-over-engineering` `Context management`
 
-Point the CLI at this marketplace as a source:
+## Subagents
+
+17 roles across 7 categories:
+
+| Category         | Subagents                                                          |
+| ---------------- | ------------------------------------------------------------------ |
+| Developers       | `web-developer` `api-developer` `cli-developer` `web-architecture` |
+| Reviewers        | `web-reviewer` `api-reviewer` `cli-reviewer`                       |
+| Testers          | `web-tester` `cli-tester`                                          |
+| Researchers      | `web-researcher` `api-researcher`                                  |
+| Planning         | `web-pm`                                                           |
+| Pattern Analysis | `pattern-scout` `web-pattern-critique`                             |
+| Documentation    | `documentor`                                                       |
+| Meta             | `skill-summoner` `agent-summoner`                                  |
+
+## Commands
+
+### Primary
+
+| Command   | Description                                                                 |
+| --------- | --------------------------------------------------------------------------- |
+| `init`    | Interactive setup wizard: pick a stack, customize skills, compile subagents |
+| `edit`    | Modify skill selection in the interactive wizard                            |
+| `compile` | Recompile subagents after changes                                           |
+| `update`  | Pull latest skills from source                                              |
+
+### Customization
+
+| Command        | Description                                                                                                       |
+| -------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `eject <type>` | Export for customization (`agent-partials`, `templates`, `skills`, `all`)                                         |
+| `new skill`    | Scaffold a custom skill ![Coming soon](https://img.shields.io/badge/coming%20soon-grey)                           |
+| `new agent`    | Scaffold a custom agent ![Coming soon](https://img.shields.io/badge/coming%20soon-grey)                           |
+| `import skill` | Import a skill from an external GitHub repository ![Coming soon](https://img.shields.io/badge/coming%20soon-grey) |
+| `search`       | Search skills across sources ![Coming soon](https://img.shields.io/badge/coming%20soon-grey)                      |
+
+### Diagnostics
+
+| Command     | Description                                                                                                  |
+| ----------- | ------------------------------------------------------------------------------------------------------------ |
+| `doctor`    | Diagnose setup issues                                                                                        |
+| `diff`      | Show changes between local and source skills ![Coming soon](https://img.shields.io/badge/coming%20soon-grey) |
+| `outdated`  | Check for skill updates                                                                                      |
+| `validate`  | Validate config and skill structure                                                                          |
+| `info`      | Show project configuration details                                                                           |
+| `uninstall` | Remove Agents Inc from your project                                                                          |
+
+Run `agentsinc --help` for full usage.
+
+## Customization
+
+Progressive layers from config to full extension:
+
+| Layer           | How                                                                                            |
+| --------------- | ---------------------------------------------------------------------------------------------- |
+| Edit config     | `.claude-src/config.yaml`; skill-to-subagent mappings, preloaded/dynamic                       |
+| Wizard          | `agentsinc edit`; add/remove skills interactively                                              |
+| Eject partials  | `agentsinc eject agent-partials`; customize agent partials such as intro, workflow, and output |
+| Eject templates | `agentsinc eject templates`; modify Liquid templates                                           |
+| Eject skills    | `agentsinc eject skills`; fork skills for local editing                                        |
+| Custom skills   | `agentsinc new skill`; scaffold with proper metadata                                           |
+| Custom agents   | `agentsinc new agent`; scaffold agent files                                                    |
+| Custom sources  | Point to a private repo or local directory as a skill source                                   |
+| Plugins         | Package skills/subagents as Claude Code plugins for distribution                               |
+
+Templates apply globally across all subagents; partials apply to specific roles. Put shared conventions in a template for consistency, and role-specific behaviour in partials.
+
+Import skills from any GitHub repository:
 
 ```bash
-# Local development
-agentsinc init --source /path/to/cli
+agentsinc import skill github:your-org/skills --list
+agentsinc import skill github:your-org/skills --skill react-best-practices
+agentsinc import skill github:your-org/skills --all
+```
+
+## Tech Stack
+
+| Component    | Technology                            |
+| ------------ | ------------------------------------- |
+| Commands     | oclif                                 |
+| Terminal UI  | Ink + React                           |
+| Wizard state | Zustand                               |
+| Validation   | Zod (30+ schemas at parse boundaries) |
+| Compilation  | LiquidJS                              |
+| Testing      | Vitest                                |
 
-# From a git repository
-agentsinc init --source github:your-org/cli
+```
+src/cli/
+  commands/       # oclif command definitions
+  components/     # Ink/React terminal UI components
+  lib/            # Core logic (compiler, loader, resolver, schemas)
+  stores/         # Zustand state management
+  utils/          # Shared utilities
+src/agents/       # Subagent definitions (18 roles)
+config/           # Skills matrix, stacks, default mappings
 ```
 
-## How It Works
+See [docs/reference/architecture.md](./docs/reference/architecture.md) for the full reference.
+
+## Links
+
+- [Plugin Marketplace](https://github.com/agents-inc/skills): browse and discover skills
+- [Architecture Reference](./docs/reference/architecture.md): full system documentation
+
+## License
 
-The CLI auto-discovers skills from the `src/skills/` directory
-and stacks from `config/stacks.ts`.
-Custom categories are discovered from skill `metadata.yaml` files with `custom: true`.
-Custom skills appear alongside built-in ones in the wizard. No manual registration needed.
+MIT

package/dist/chunk-2MHSOPIU.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import {
+  SelectList
+} from "./chunk-WF5PMBIR.js";
+import {
+  KEY_LABEL_ARROWS_VERT,
+  KEY_LABEL_ENTER,
+  KEY_LABEL_ESC
+} from "./chunk-6VIOO74O.js";
+import {
+  CLI_COLORS
+} from "./chunk-EGMQ3SXN.js";
+import {
+  init_esm_shims
+} from "./chunk-DHET7RCE.js";
+
+// src/cli/components/wizard/search-modal.tsx
+init_esm_shims();
+import { Box, Text } from "ink";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function candidateToItem(candidate) {
+  return {
+    label: `${candidate.sourceName}/${candidate.id}`,
+    value: candidate
+  };
+}
+var SearchModal = ({
+  results,
+  alias,
+  onBind,
+  onClose,
+  active
+}) => {
+  const items = results.map(candidateToItem);
+  return /* @__PURE__ */ jsxs(
+    Box,
+    {
+      flexDirection: "column",
+      borderStyle: "single",
+      borderColor: CLI_COLORS.NEUTRAL,
+      paddingX: 1,
+      paddingY: 0,
+      marginTop: 1,
+      children: [
+        /* @__PURE__ */ jsxs(Text, { bold: true, children: [
+          'Search results for "',
+          alias,
+          '"'
+        ] }),
+        /* @__PURE__ */ jsx(Text, { children: " " }),
+        results.length === 0 ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: "No results found" }) : /* @__PURE__ */ jsx(
+          SelectList,
+          {
+            items,
+            onSelect: onBind,
+            onCancel: onClose,
+            active,
+            renderItem: (item, isFocused) => /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(Text, { bold: isFocused, color: isFocused ? CLI_COLORS.PRIMARY : void 0, children: item.label }),
+              item.value.description && /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+                "   ",
+                item.value.description
+              ] })
+            ] })
+          }
+        ),
+        /* @__PURE__ */ jsx(Text, { children: " " }),
+        /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
+          KEY_LABEL_ARROWS_VERT,
+          " navigate ",
+          KEY_LABEL_ENTER,
+          " bind ",
+          KEY_LABEL_ESC,
+          " close"
+        ] })
+      ]
+    }
+  );
+};
+
+export {
+  SearchModal
+};
+//# sourceMappingURL=chunk-2MHSOPIU.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/components/wizard/search-modal.tsx"],"sourcesContent":["import React from \"react\";\nimport { Box, Text } from \"ink\";\nimport type { BoundSkillCandidate } from \"../../types/index.js\";\nimport { CLI_COLORS } from \"../../consts.js\";\nimport { SelectList, type SelectListItem } from \"../common/select-list.js\";\nimport { KEY_LABEL_ARROWS_VERT, KEY_LABEL_ENTER, KEY_LABEL_ESC } from \"./hotkeys.js\";\n\nexport type SearchModalProps = {\n  results: BoundSkillCandidate[];\n  alias: string;\n  onBind: (candidate: BoundSkillCandidate) => void;\n  onClose: () => void;\n  active?: boolean;\n};\n\nfunction candidateToItem(candidate: BoundSkillCandidate): SelectListItem<BoundSkillCandidate> {\n  return {\n    label: `${candidate.sourceName}/${candidate.id}`,\n    value: candidate,\n  };\n}\n\nexport const SearchModal: React.FC<SearchModalProps> = ({\n  results,\n  alias,\n  onBind,\n  onClose,\n  active,\n}) => {\n  const items = results.map(candidateToItem);\n\n  return (\n    <Box\n      flexDirection=\"column\"\n      borderStyle=\"single\"\n      borderColor={CLI_COLORS.NEUTRAL}\n      paddingX={1}\n      paddingY={0}\n      marginTop={1}\n    >\n      <Text bold>Search results for &quot;{alias}&quot;</Text>\n      <Text> </Text>\n\n      {results.length === 0 ? (\n        <Text dimColor>No results found</Text>\n      ) : (\n        <SelectList\n          items={items}\n          onSelect={onBind}\n          onCancel={onClose}\n          active={active}\n          renderItem={(item, isFocused) => (\n            <>\n              <Text bold={isFocused} color={isFocused ? CLI_COLORS.PRIMARY : undefined}>\n                {item.label}\n              </Text>\n              {item.value.description && (\n                <Text dimColor>\n                  {\"   \"}\n                  {item.value.description}\n                </Text>\n              )}\n            </>\n          )}\n        />\n      )}\n\n      <Text> </Text>\n      <Text dimColor>\n        {KEY_LABEL_ARROWS_VERT} navigate {KEY_LABEL_ENTER} bind {KEY_LABEL_ESC} close\n      </Text>\n    </Box>\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AACA,SAAS,KAAK,YAAY;AAuCpB,SAYM,UAXN,KADA;AAzBN,SAAS,gBAAgB,WAAqE;AAC5F,SAAO;AAAA,IACL,OAAO,GAAG,UAAU,UAAU,IAAI,UAAU,EAAE;AAAA,IAC9C,OAAO;AAAA,EACT;AACF;AAEO,IAAM,cAA0C,CAAC;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,QAAQ,QAAQ,IAAI,eAAe;AAEzC,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,6BAAC,QAAK,MAAI,MAAC;AAAA;AAAA,UAA0B;AAAA,UAAM;AAAA,WAAM;AAAA,QACjD,oBAAC,QAAK,eAAC;AAAA,QAEN,QAAQ,WAAW,IAClB,oBAAC,QAAK,UAAQ,MAAC,8BAAgB,IAE/B;AAAA,UAAC;AAAA;AAAA,YACC;AAAA,YACA,UAAU;AAAA,YACV,UAAU;AAAA,YACV;AAAA,YACA,YAAY,CAAC,MAAM,cACjB,iCACE;AAAA,kCAAC,QAAK,MAAM,WAAW,OAAO,YAAY,WAAW,UAAU,QAC5D,eAAK,OACR;AAAA,cACC,KAAK,MAAM,eACV,qBAAC,QAAK,UAAQ,MACX;AAAA;AAAA,gBACA,KAAK,MAAM;AAAA,iBACd;AAAA,eAEJ;AAAA;AAAA,QAEJ;AAAA,QAGF,oBAAC,QAAK,eAAC;AAAA,QACP,qBAAC,QAAK,UAAQ,MACX;AAAA;AAAA,UAAsB;AAAA,UAAW;AAAA,UAAgB;AAAA,UAAO;AAAA,UAAc;AAAA,WACzE;AAAA;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/{chunk-VTRVAXUM.js → chunk-3SLO2QPW.js}

@@ -2,19 +2,19 @@
 import {
   useMeasuredHeight
 } from "./chunk-K77I4XGL.js";
-import {
-  CategoryGrid
-} from "./chunk-CKPJTMNC.js";
 import {
   getDomainDisplayName,
   orderDomains
 } from "./chunk-ZYUASJUN.js";
+import {
+  CategoryGrid
+} from "./chunk-CKPJTMNC.js";
 import {
   ViewTitle
 } from "./chunk-AQYAVLZK.js";
 import {
   useWizardStore
-} from "./chunk-EULHBV5V.js";
+} from "./chunk-URAXGHF2.js";
 import {
   KEY_LABEL_ENTER,
   KEY_LABEL_ESC
@@ -22,7 +22,7 @@ import {
 import {
   getAvailableSkills,
   resolveAlias
-} from "./chunk-45R64U2S.js";
+} from "./chunk-HMJGSAKV.js";
 import {
   findSkill,
   getMatrix
@@ -245,4 +245,4 @@ export {
   validateBuildStep,
   StepBuild
 };
-//# sourceMappingURL=chunk-VTRVAXUM.js.map
+//# sourceMappingURL=chunk-3SLO2QPW.js.map

package/dist/{chunk-KFDTVSIC.js → chunk-6YMW4HMX.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-7SOPVGDV.js";
 import {
   SearchModal
-} from "./chunk-6IK2TCK7.js";
+} from "./chunk-2MHSOPIU.js";
 import {
   useFocusedListItem
 } from "./chunk-GG4BSB6S.js";
@@ -259,4 +259,4 @@ var SourceGrid = ({
 export {
   SourceGrid
 };
-//# sourceMappingURL=chunk-KFDTVSIC.js.map
+//# sourceMappingURL=chunk-6YMW4HMX.js.map