agents-inc 0.152.0 → 0.153.0

package/CHANGELOG.md

@@ -7,6 +7,50 @@ 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.153.0] - 2026-08-09
+
+**One marketplace at a time**
+
+- Sources revalidate by ETag — one conditional request per source per process, stale-if-error offline, ~1.15s when current (CLI-465)
+- Skill relationship rules cover the full catalog, replayed by one contract-scenario table in every consumer (CLI-389)
+- Preload defaults derive from the catalog at load time; the generated stack-preloads artifact is gone (CLI-390)
+- 28 user journeys documented with four assertion surfaces, and the e2e suite audited to drive them from scratch (CLI-444)
+- `update` wraps `claude plugin update` — plugin skills update in place, sub-agents keep their pointers, ejected skills untouched (CLI-428)
+- Stacks scope to the source that declares them; a stackless custom source gets no stack step (CLI-451)
+- `--source` narrows to `init`; every other command reads the configured source (CLI-466)
+- One PM serves every domain, parameterized by skills (CLI-398)
+- One reviewer serves every domain, same shape (CLI-399)
+- The agent roster sheds retired agents and dangling cross-references (CLI-400)
+- `pretest` builds, so a green `npm test` describes the current source (CLI-457)
+- turbo already hashes the matrix dependency into the build key — measured, disproven as a bug, recorded in turbo.json (CLI-458)
+- A direct `vitest run` refuses a stale dist outright via globalSetup (CLI-460)
+- A project compile stays inside the project — no more writes to the global install or other registered projects (CLI-438)
+- A fresh pick during a project edit defaults global and stays overridable (CLI-442)
+- Removing the project half of a dual-scope pair removes exactly that half (CLI-443)
+- A stack's declared sub-agent roster is what installs (CLI-441)
+- Plugin banners render identically on init and edit (CLI-439)
+- The propagated-recompile summary reports what actually recompiled (CLI-440)
+- Unparseable local skill metadata is a hard error with the file named (CLI-445)
+- Schema-invalid metadata dies just as loudly; edit refuses it, doctor validates content (CLI-446)
+- Built-in relationship rules narrow to the marketplace being loaded — 2384 spurious warnings on custom sources go to zero (CLI-471)
+- Source switching is removed; the CLI models one marketplace at a time (CLI-450)
+- `import`, `new` and `validate` retire with the feature flags that hid them (CLI-452)
+- Dead operational helpers deleted (CLI-459)
+- The dead stack installer deleted with its suites (CLI-461)
+
+See [changelogs/0.153.0.md](./changelogs/0.153.0.md) for full details.
+
+## [0.152.1] - 2026-08-06
+
+**The README's documentation links work again**
+
+- The user guides and command reference existed twice — in the repository and on the documentation site — with nothing keeping them in step. The site is now the single source, the duplicates are deleted, and the README's twelve links point at files that exist rather than 404ing
+- The README's counts were long stale: "150+ skills across 8 domains" against a real catalogue of 222 skills across 9 domains, and a sub-agent table listing 18 of the 23 that ship
+
+Nothing else about the CLI changes.
+
+See [changelogs/0.152.1.md](./changelogs/0.152.1.md) for full details.
+
 ## [0.152.0] - 2026-08-06
 
 **Feature flags obey the environment, and the package sheds its dead weight**

package/README.md

@@ -11,9 +11,9 @@ An agent composition framework for [Claude Code](https://docs.anthropic.com/en/d
 
 1. Select a pre-built stack to customise or start from scratch
 2. Select your skills from an interactive grid, organized by domain with compatibility filtering and global/local customising
-3. Choose to eject these skills or install them as plugins ([install modes guide](https://github.com/agents-inc/agents-inc/blob/main/docs/cli/guides/install-modes.md))
+3. Choose to eject these skills or install them as plugins ([install modes guide](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/concepts/install-modes.md))
 4. Select your subagents to compile with these skills
-5. Further customise skills and subagents in the generated `config.ts` ([editing config guide](https://github.com/agents-inc/agents-inc/blob/main/docs/cli/guides/editing-config.md))
+5. Further customise skills and subagents in the generated `config.ts` ([editing config guide](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/guides/editing-config.md))
 6. Compile subagents with `npx agents-inc compile` after changes
 
 See the [Guides](#guides) section below for more.
@@ -54,45 +54,46 @@ npx agents-inc init
 
 ## Guides
 
-| Guide                                                                                                                              | Description                                                          |
-| ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| [Global-first setup](https://github.com/agents-inc/agents-inc/blob/main/docs/cli/guides/global-first-setup.md)                     | Why global scope is the right default and when to use project scope  |
-| [Install modes](https://github.com/agents-inc/agents-inc/blob/main/docs/cli/guides/install-modes.md)                               | Plugin vs local install, global vs project scope                     |
-| [Editing your config](https://github.com/agents-inc/agents-inc/blob/main/docs/cli/guides/editing-config.md)                        | Skill mappings, preloaded vs dynamic loading, and config structure   |
-| [Customizing subagents](https://github.com/agents-inc/agents-inc/blob/main/docs/cli/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/docs/cli/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/docs/cli/guides/importing-skills.md)             | Install skills from external repositories                            |
-| [Creating a marketplace](https://github.com/agents-inc/agents-inc/blob/main/docs/cli/guides/creating-a-marketplace.md)             | Build a personal or org-level marketplace with curated skills        |
-| [Using the codex-keeper subagent](https://github.com/agents-inc/agents-inc/blob/main/docs/cli/guides/using-codex-keeper.md)        | Generate and maintain AI-focused reference documentation             |
+| Guide                                                                                                                                                    | Description                                                          |
+| -------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| [Global-first setup](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/guides/global-first-setup.md)                     | Why global scope is the right default and when to use project scope  |
+| [Install modes](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/concepts/install-modes.md)                             | Plugin vs local install, global vs project scope                     |
+| [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        |
+| [Using the codex-keeper subagent](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/guides/using-codex-keeper.md)        | Generate and maintain AI-focused reference documentation             |
 
 ## Skills
 
-150+ skills across 8 domains:
+Over 200 skills across 9 domains:
 
-| Domain | Skills                                                                                                                                                                     |
-| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| 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                                                                                                                                                         |
-| Infra  | Docker, GitHub Actions, Cloudflare Workers                                                                                                                                 |
-| Shared | Turborepo, ESLint + Prettier, Code Reviewing, Auth Security                                                                                                                |
-| Meta   | Research Methodology, CLI Reviewing                                                                                                                                        |
+| Domain  | Skills                                                                                                                                                                     |
+| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 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                                                                                                                          |
+| CLI     | oclif + Ink, Commander, Clack                                                                                                                                              |
+| Infra   | Docker, GitHub Actions, Cloudflare Workers                                                                                                                                 |
+| Shared  | Turborepo, ESLint + Prettier, Code Reviewing, Auth Security                                                                                                                |
+| Meta    | Research Methodology, CLI Reviewing                                                                                                                                        |
 
 Browse the full catalog on the [Plugin Marketplace](https://github.com/agents-inc/skills).
 
 ## Subagents
 
-| 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    | `codex-keeper`                                                     |
-| Meta             | `skill-summoner` `agent-summoner` `convention-keeper`              |
+| Category      | Subagents                                                                               |
+| ------------- | --------------------------------------------------------------------------------------- |
+| Developers    | `web-developer` `api-developer` `cli-developer` `ai-developer`                          |
+| Reviewer      | `reviewer` — one cross-domain reviewer; domain checklists via `meta-reviewing-*` skills |
+| Testers       | `web-tester` `api-tester` `cli-tester` `ai-tester`                                      |
+| Researchers   | `web-researcher` `api-researcher` `cli-researcher` `ai-researcher`                      |
+| Planning      | `pm` — one cross-domain planner; domain frameworks via `meta-planning-*` skills         |
+| Documentation | `codex-keeper`                                                                          |
+| Meta          | `skill-summoner` `agent-summoner` `convention-keeper`                                   |
 
 Each subagent is composed from modular partials (role, workflow, output format) plus its assigned skills. Everything is ejectable.
 
@@ -105,18 +106,14 @@ Each subagent is composed from modular partials (role, workflow, output format)
 | `init`    | Interactive setup wizard: pick a stack, customize skills, compile subagents |
 | `edit`    | Modify skill selection via the interactive wizard                           |
 | `compile` | Recompile subagents after changes                                           |
-| `update`  | Pull latest skills from source                                              |
+| `update`  | Refresh the marketplaces this installation uses (ejected skills are yours)  |
 | `search`  | Search skills across all sources                                            |
 
 ### Customization
 
-| Command           | Description                                                               |
-| ----------------- | ------------------------------------------------------------------------- |
-| `eject <type>`    | Export for customization (`agent-partials`, `templates`, `skills`, `all`) |
-| `import skill`    | Import a skill from an external GitHub repository                         |
-| `new skill`       | (IN PROGRESS) Scaffold a new local skill                                  |
-| `new agent`       | (IN PROGRESS) Scaffold a new custom subagent                              |
-| `new marketplace` | (IN PROGRESS) Scaffold a new marketplace project                          |
+| Command        | Description                                                               |
+| -------------- | ------------------------------------------------------------------------- |
+| `eject <type>` | Export for customization (`agent-partials`, `templates`, `skills`, `all`) |
 
 ### Build
 
@@ -127,19 +124,18 @@ Each subagent is composed from modular partials (role, workflow, output format)
 
 ### Diagnostics
 
-| Command     | Description                         |
-| ----------- | ----------------------------------- |
-| `doctor`    | Diagnose setup issues               |
-| `list`      | Show installed skills and agents    |
-| `validate`  | Validate config and skill structure |
-| `uninstall` | Remove Agents Inc from your project |
+| Command     | Description                                                   |
+| ----------- | ------------------------------------------------------------- |
+| `doctor`    | Validate installed content, then diagnose the install's state |
+| `list`      | Show installed skills and agents                              |
+| `uninstall` | Remove Agents Inc from your project                           |
 
-Run `agents-inc --help` for full usage, or see the [full commands reference](https://github.com/agents-inc/agents-inc/blob/main/docs/cli/reference/commands.md).
+Run `agents-inc --help` for full usage, or see the [full commands reference](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/reference/commands.md).
 
 ## Links
 
 - [Plugin Marketplace](https://github.com/agents-inc/skills): browse and discover skills
-- [Architecture Reference](https://github.com/agents-inc/agents-inc/blob/main/docs/cli/reference/architecture.md): full system documentation
+- [Architecture Reference](https://github.com/agents-inc/agents-inc/blob/main/apps/www/src/content/docs/docs/reference/architecture.md): full system documentation
 
 ## License
 

package/dist/{chunk-LDP5ASDM.js → chunk-2HC2SNRP.js}

@@ -1,48 +1,35 @@
 #!/usr/bin/env node
-import {
-  FEATURE_FLAGS
-} from "./chunk-WBCPLH66.js";
 
 // src/cli/components/wizard/hotkeys.ts
 var HOTKEY_INFO = { key: "i", label: "I" };
 var HOTKEY_ACCEPT_DEFAULTS = { key: "a", label: "A" };
 var HOTKEY_SCOPE = { key: "s", label: "S" };
-var HOTKEY_SETTINGS = { key: "s", label: "S" };
 var HOTKEY_TOGGLE_LABELS = { key: "d", label: "D" };
-var HOTKEY_FILTER_INCOMPATIBLE = { key: "f", label: "F" };
 var HOTKEY_SET_ALL_LOCAL = { key: "l", label: "L" };
 var HOTKEY_SET_ALL_PLUGIN = { key: "p", label: "P" };
-var HOTKEY_ADD_SOURCE = { key: "a", label: "A" };
 var KEY_SPACE = " ";
 var KEY_LABEL_ENTER = "ENTER";
 var KEY_LABEL_ESC = "ESC";
 var KEY_LABEL_SPACE = "SPACE";
-var KEY_LABEL_DEL = "DEL";
-var KEY_LABEL_ARROWS_VERT = "\u2191/\u2193";
 function isHotkey(input, hotkey) {
   return input.toLowerCase() === hotkey.key.toLowerCase();
 }
 function isInfoPanelAvailable(step) {
-  return FEATURE_FLAGS.INFO_PANEL && step !== "confirm";
+  return step !== "confirm";
 }
 
 export {
   HOTKEY_INFO,
   HOTKEY_ACCEPT_DEFAULTS,
   HOTKEY_SCOPE,
-  HOTKEY_SETTINGS,
   HOTKEY_TOGGLE_LABELS,
-  HOTKEY_FILTER_INCOMPATIBLE,
   HOTKEY_SET_ALL_LOCAL,
   HOTKEY_SET_ALL_PLUGIN,
-  HOTKEY_ADD_SOURCE,
   KEY_SPACE,
   KEY_LABEL_ENTER,
   KEY_LABEL_ESC,
   KEY_LABEL_SPACE,
-  KEY_LABEL_DEL,
-  KEY_LABEL_ARROWS_VERT,
   isHotkey,
   isInfoPanelAvailable
 };
-//# sourceMappingURL=chunk-LDP5ASDM.js.map
+//# sourceMappingURL=chunk-2HC2SNRP.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/components/wizard/hotkeys.ts"],"sourcesContent":["/**\n * Centralized hotkey registry for wizard components.\n *\n * Every character-based hotkey and its display label lives here so that\n * changing a binding updates the key check, the footer hint, and the\n * info panel in one place.\n */\n\nimport type { WizardStep } from \"../../stores/wizard-store.js\";\n\n// ---------------------------------------------------------------------------\n// Global hotkeys (active across multiple wizard steps)\n// ---------------------------------------------------------------------------\n\nexport const HOTKEY_INFO = { key: \"i\", label: \"I\" } as const;\nexport const HOTKEY_ACCEPT_DEFAULTS = { key: \"a\", label: \"A\" } as const;\nexport const HOTKEY_SCOPE = { key: \"s\", label: \"S\" } as const;\n\n// ---------------------------------------------------------------------------\n// Build step hotkeys\n// ---------------------------------------------------------------------------\n\nexport const HOTKEY_TOGGLE_LABELS = { key: \"d\", label: \"D\" } as const;\n\n// ---------------------------------------------------------------------------\n// Sources step hotkeys\n// ---------------------------------------------------------------------------\n\nexport const HOTKEY_SET_ALL_LOCAL = { key: \"l\", label: \"L\" } as const;\nexport const HOTKEY_SET_ALL_PLUGIN = { key: \"p\", label: \"P\" } as const;\n\n// ---------------------------------------------------------------------------\n// Common key labels (for structural keys handled via Ink key objects)\n// ---------------------------------------------------------------------------\n\n/** The spacebar input character (Ink delivers a literal space for the space key). */\nexport const KEY_SPACE = \" \";\n\nexport const KEY_LABEL_ENTER = \"ENTER\" as const;\nexport const KEY_LABEL_ESC = \"ESC\" as const;\nexport const KEY_LABEL_SPACE = \"SPACE\" as const;\nexport const KEY_LABEL_DEL = \"DEL\" as const;\nexport const KEY_LABEL_ARROWS_VERT = \"\\u2191/\\u2193\" as const;\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\n/** Case-insensitive check for a character hotkey. */\nexport function isHotkey(input: string, hotkey: { key: string }): boolean {\n  return input.toLowerCase() === hotkey.key.toLowerCase();\n}\n\n/**\n * Whether `HOTKEY_INFO` does anything on `step` — the single answer both the\n * key handler in `wizard.tsx` and the footer hint in `wizard-layout.tsx` read,\n * so the wizard never advertises a key it ignores.\n *\n * The confirm step is excluded because it already renders the panel the\n * overlay would show, and the overlay REPLACES the step rather than sitting\n * over it: opening it there would unmount the confirm step's `Enter` handler\n * and strand the user on a screen nothing can complete.\n */\nexport function isInfoPanelAvailable(step: WizardStep): boolean {\n  return step !== \"confirm\";\n}\n"],"mappings":";;;AAcO,IAAM,cAAc,EAAE,KAAK,KAAK,OAAO,IAAI;AAC3C,IAAM,yBAAyB,EAAE,KAAK,KAAK,OAAO,IAAI;AACtD,IAAM,eAAe,EAAE,KAAK,KAAK,OAAO,IAAI;AAM5C,IAAM,uBAAuB,EAAE,KAAK,KAAK,OAAO,IAAI;AAMpD,IAAM,uBAAuB,EAAE,KAAK,KAAK,OAAO,IAAI;AACpD,IAAM,wBAAwB,EAAE,KAAK,KAAK,OAAO,IAAI;AAOrD,IAAM,YAAY;AAElB,IAAM,kBAAkB;AACxB,IAAM,gBAAgB;AACtB,IAAM,kBAAkB;AASxB,SAAS,SAAS,OAAe,QAAkC;AACxE,SAAO,MAAM,YAAY,MAAM,OAAO,IAAI,YAAY;AACxD;AAYO,SAAS,qBAAqB,MAA2B;AAC9D,SAAO,SAAS;AAClB;","names":[]}