@agents-inc/cli 0.32.1

package/CHANGELOG.md

@@ -0,0 +1,462 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+Each release has detailed notes in its own file under [`changelogs/`](./changelogs/). This file serves as a summary index.
+
+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.32.1] - 2026-02-16
+
+**Code formatting cleanup (Prettier consistency)**
+
+See [changelogs/0.32.1.md](./changelogs/0.32.1.md) for full details.
+
+## [0.32.0] - 2026-02-16
+
+**Wizard simplification, branding, scroll viewport, and code quality**
+
+See [changelogs/0.32.0.md](./changelogs/0.32.0.md) for full details.
+
+## [0.31.1] - 2026-02-16
+
+**Commit protocol and changelog architecture**
+
+Established commit protocol for AI agents with split-file changelog pattern.
+
+[-> Full release notes](./changelogs/0.31.1.md)
+
+## [0.31.0] - 2026-02-16
+
+**CLAUDE.md project instructions and test infrastructure**
+
+Comprehensive AI agent instructions, test fixture structure, feature proposals, and documentation cleanup.
+
+[-> Full release notes](./changelogs/0.31.0.md)
+
+## [0.30.0] - 2026-02-16
+
+**Settings.json-based plugin discovery**
+
+Migrated plugin discovery from project-local directory scanning to settings.json-based resolution via global plugin registry.
+
+[-> Full release notes](./changelogs/0.30.0.md)
+
+## [0.29.5] - 2026-02-15
+
+**Fix local YAML schema paths**
+
+Replaced relative local schema paths with raw.githubusercontent.com URLs for consumer project compatibility.
+
+[-> Full release notes](./changelogs/0.29.5.md)
+
+## [0.29.4] - 2026-02-15
+
+**Strict JSON schema validation**
+
+All 12 generated JSON schemas now enforce meaningful constraints for IDE autocomplete and validation.
+
+[-> Full release notes](./changelogs/0.29.4.md)
+
+## [0.29.3] - 2026-02-15
+
+**Fix wrong YAML schema on generated config**
+
+Fixed `cc init` embedding wrong schema reference in generated config.yaml.
+
+[-> Full release notes](./changelogs/0.29.3.md)
+
+## [0.29.2] - 2026-02-15
+
+**Multi-skill stack assignments in project config**
+
+Stack config now stores multiple skills per subcategory with preloaded flags preserved through the full pipeline.
+
+[-> Full release notes](./changelogs/0.29.2.md)
+
+## [0.29.1] - 2026-02-15
+
+**Lint fixes and code cleanup**
+
+Regex unicode flags, switch default cases, template literals, control flow simplification, and type cleanup.
+
+[-> Full release notes](./changelogs/0.29.1.md)
+
+## [0.29.0] - 2026-02-15
+
+**Shared utilities, security hardening, and integration tests**
+
+Extracted utility modules, expanded Zod schemas, added integration test suites, and hardened path traversal and input validation.
+
+[-> Full release notes](./changelogs/0.29.0.md)
+
+## [0.28.0] - 2026-02-13
+
+**Explicit preloaded booleans and published JSON schemas**
+
+Stack skills use explicit preloaded flags, published JSON schemas for IDE validation, and extended `cc validate` targets.
+
+[-> Full release notes](./changelogs/0.28.0.md)
+
+## [0.27.0] - 2026-02-13
+
+**Stacks use skill IDs and config-driven source loading**
+
+Stacks reference skills by ID instead of display name alias. Marketplace repos can declare custom resource paths.
+
+[-> Full release notes](./changelogs/0.27.0.md)
+
+## [0.26.1] - 2026-02-13
+
+**Fix metadata version coercion and stack lookup**
+
+Fixed version coercion warnings, stack lookup from source in plugin mode, and skills matrix fallback.
+
+[-> Full release notes](./changelogs/0.26.1.md)
+
+## [0.26.0] - 2026-02-13
+
+**Plugin-aware compilation and marketplace guides**
+
+Plugin-aware agent compilation, stacks from source, individual skill plugin installation, and marketplace documentation.
+
+[-> Full release notes](./changelogs/0.26.0.md)
+
+## [0.25.1] - 2026-02-13
+
+**Code formatting**
+
+Prettier applied across 21 files.
+
+[-> Full release notes](./changelogs/0.25.1.md)
+
+## [0.25.0] - 2026-02-12
+
+**Multi-source skill selection (UX 2.0)**
+
+Full multi-source skill selection with source grid, source switching, bound skill search, and settings management.
+
+[-> Full release notes](./changelogs/0.25.0.md)
+
+## [0.24.7] - 2026-02-12
+
+**Sources step and edit command improvements**
+
+New Sources wizard step, edit command starts at Build step, parse boundary hardening.
+
+[-> Full release notes](./changelogs/0.24.7.md)
+
+## [0.24.6] - 2026-02-12
+
+**Codebase-wide comment cleanup**
+
+Removed ~5,600 lines of AI-generated banner comments, standardized JSDoc on type definitions.
+
+[-> Full release notes](./changelogs/0.24.6.md)
+
+## [0.24.5] - 2026-02-11
+
+**Command tests and Vitest auto-mocks**
+
+158 new command tests, Vitest auto-mocks for fs/logger, config split into 3 test projects.
+
+[-> Full release notes](./changelogs/0.24.5.md)
+
+## [0.24.4] - 2026-02-11
+
+**Library restructured into domain subdirectories**
+
+62 files moved from flat `lib/` into 8 domain-organized subdirectories with barrel imports.
+
+[-> Full release notes](./changelogs/0.24.4.md)
+
+## [0.24.3] - 2026-02-11
+
+**AJV replaced with Zod, JSON schemas generated from Zod**
+
+Schema validation rewritten to Zod, JSON schemas generated natively, YAML references use local paths.
+
+[-> Full release notes](./changelogs/0.24.3.md)
+
+## [0.24.2] - 2026-02-11
+
+**Type definitions co-located**
+
+4 scattered type files consolidated into 6 domain-organized files under `src/cli/types/`.
+
+[-> Full release notes](./changelogs/0.24.2.md)
+
+## [0.24.1] - 2026-02-11
+
+**Stack config respects customizations, parse boundaries hardened**
+
+Stack config uses user selections, parse boundaries warn on failure, 17 new unit test files.
+
+[-> Full release notes](./changelogs/0.24.1.md)
+
+## [0.24.0] - 2026-02-11
+
+**Type system rewrite and dead code removal**
+
+All interfaces replaced with type aliases, stack as single source of truth, ~2,100 lines of dead code removed.
+
+[-> Full release notes](./changelogs/0.24.0.md)
+
+## [0.23.0] - 2026-02-10
+
+**Zod runtime validation, typed utilities, and Remeda**
+
+30+ Zod schemas at parse boundaries, typed object utilities, Remeda array operations, named type aliases.
+
+[-> Full release notes](./changelogs/0.23.0.md)
+
+## [0.22.0] - 2026-02-09
+
+**Union types for IDs, categories, agents, and domains**
+
+Strict union types replace `string` across the codebase. Normalized skill ID format enforced at compile time.
+
+[-> Full release notes](./changelogs/0.22.0.md)
+
+## [0.21.0] - 2026-02-09
+
+**Removed refine step, added web-extras domain**
+
+Wizard simplified to 4 steps. 8 categories split into `web-extras` domain with parent domain inheritance.
+
+[-> Full release notes](./changelogs/0.21.0.md)
+
+## [0.20.0] - 2026-02-07
+
+**Removed StackConfig type and global config layer**
+
+All consumers operate directly on ProjectConfig. Global config and related commands deleted.
+
+[-> Full release notes](./changelogs/0.20.0.md)
+
+## [0.19.0] - 2026-02-07
+
+**Removed top-level categories, aligned agent mappings with domains**
+
+Flattened skills matrix to domain-based organization. Agent mapping patterns renamed to match domains.
+
+[-> Full release notes](./changelogs/0.19.0.md)
+
+## [0.18.0] - 2026-02-07
+
+**Matrix health check and type consolidation**
+
+Referential integrity validation, dead type removal, shared utilities extraction, matrix alias cleanup.
+
+[-> Full release notes](./changelogs/0.18.0.md)
+
+## [0.17.0] - 2026-02-07
+
+**Local skill badge and module extraction**
+
+Local skill `[L]` badge in wizard, extracted config-merger, local-installer, and skill resolution improvements.
+
+[-> Full release notes](./changelogs/0.17.0.md)
+
+## [0.16.0] - 2026-02-07
+
+**Simplified wizard flow and styling updates**
+
+Removed stack-options step, simplified ViewTitle API, border-based skill tag styling.
+
+[-> Full release notes](./changelogs/0.16.0.md)
+
+## [0.15.0] - 2026-02-07
+
+**Custom navigation components and global shortcuts**
+
+MenuItem and ViewTitle components, global keyboard shortcuts for mode toggles.
+
+[-> Full release notes](./changelogs/0.15.0.md)
+
+## [0.14.1] - 2026-02-07
+
+**Library extraction: skill-metadata, config-saver, plugin-manifest-finder**
+
+Deduplicated shared logic into 3 new library modules.
+
+[-> Full release notes](./changelogs/0.14.1.md)
+
+## [0.14.0] - 2026-02-07
+
+**WizardLayout, redesigned tabs and footer, ASCII banner**
+
+Extracted WizardLayout component, unified footer, ASCII art banner, Prettier config.
+
+[-> Full release notes](./changelogs/0.14.0.md)
+
+## [0.13.4] - 2026-02-06
+
+**Fix local skills losing category metadata**
+
+Local skills now preserve original category from metadata.yaml instead of hardcoding "local/custom".
+
+[-> Full release notes](./changelogs/0.13.4.md)
+
+## [0.13.3] - 2026-02-06
+
+**Fix local config and agent_skills normalization**
+
+Fixed recompile config lookup fallback and agent_skills mixed format normalization.
+
+[-> Full release notes](./changelogs/0.13.3.md)
+
+## [0.13.2] - 2026-02-06
+
+**Fix npx eject missing agent partials**
+
+Added `src/agents/` to published npm package.
+
+[-> Full release notes](./changelogs/0.13.2.md)
+
+## [0.13.1] - 2026-02-06
+
+**Fix npx eject ENOENT and build config**
+
+Added `config/` to published package, fixed build to copy config to dist, test portability improvements.
+
+[-> Full release notes](./changelogs/0.13.1.md)
+
+## [0.13.0] - 2026-02-06
+
+**Import command, interactive search, framework-first build**
+
+Import skills from GitHub, interactive skill search with multi-select, framework-first wizard flow.
+
+[-> Full release notes](./changelogs/0.13.0.md)
+
+## [0.12.0] - 2026-02-04
+
+**Agent Compliance Bible and Claude Code research**
+
+30-test compliance suite, 176 Claude Code updates documented, agent partials conciseness pass.
+
+[-> Full release notes](./changelogs/0.12.0.md)
+
+## [0.11.0] - 2026-02-04
+
+**CLI source directory rename and Bible documentation**
+
+`src/cli-v2/` renamed to `src/cli/`, comprehensive documentation standards added.
+
+[-> Full release notes](./changelogs/0.11.0.md)
+
+## [0.10.0] - 2026-02-03
+
+**Directory structure: .claude-src/ and .claude/**
+
+Source files in `.claude-src/`, runtime output in `.claude/`. Breaking change to directory layout.
+
+[-> Full release notes](./changelogs/0.10.0.md)
+
+## [0.9.0] - 2026-02-03
+
+**Config location change and eject simplification**
+
+Config moved to `.claude/config.yaml`, eject types simplified, wizard pre-population.
+
+[-> Full release notes](./changelogs/0.9.0.md)
+
+## [0.8.0] - 2026-02-02
+
+**Skill IDs normalized to kebab-case**
+
+Breaking change from path-based IDs to simple kebab-case format. Meta-stack added.
+
+[-> Full release notes](./changelogs/0.8.0.md)
+
+## [0.7.0] - 2026-02-02
+
+**Wizard flow redesign with domain-based grid selection**
+
+New 5-step flow with CategoryGrid, WizardTabs, domain-based navigation. Complete wizard rewrite.
+
+[-> Full release notes](./changelogs/0.7.0.md)
+
+## [0.6.0] - 2026-02-01
+
+**Skills defined in stacks, not agents**
+
+Breaking change: stacks.yaml defines technology selections per agent. Skills resolved via matrix aliases.
+
+[-> Full release notes](./changelogs/0.6.0.md)
+
+## [0.5.1] - 2026-02-01
+
+**Auto-detection of installation mode**
+
+CLI auto-detects local vs plugin installation. `installMode` stored in config.
+
+[-> Full release notes](./changelogs/0.5.1.md)
+
+## [0.5.0] - 2026-02-01
+
+**Agent-centric configuration**
+
+Breaking change: skills defined in agent YAMLs, centralized stacks.yaml.
+
+[-> Full release notes](./changelogs/0.5.0.md)
+
+## [0.4.0] - 2026-01-31
+
+**Methodology skills preselected and comprehensive test suite**
+
+Foundational skills selected by default, 1000+ tests, test isolation support.
+
+[-> Full release notes](./changelogs/0.4.0.md)
+
+## [0.3.0] - 2026-01-31
+
+**CLI framework migration to oclif + Ink**
+
+Migrated from Commander.js + @clack/prompts to oclif + Ink + Zustand.
+
+[-> Full release notes](./changelogs/0.3.0.md)
+
+## [0.2.0] - 2026-01-30
+
+**Marketplace support**
+
+Install stack plugins from configured marketplaces, multi-source agent loading.
+
+[-> Full release notes](./changelogs/0.2.0.md)
+
+## [0.1.3] - 2026-01-30
+
+**Eject output option and remote schema fetching**
+
+Custom output directory for eject, remote schema validation from GitHub.
+
+[-> Full release notes](./changelogs/0.1.3.md)
+
+## [0.1.2] - 2026-01-30
+
+**Remove local dev files from repo**
+
+Cleaned up local development files (.claude, CLAUDE.md).
+
+[-> Full release notes](./changelogs/0.1.2.md)
+
+## [0.1.1] - 2026-01-30
+
+**Fix repo reference and README agent names**
+
+Corrected GITHUB_REPO const and README agent names.
+
+[-> Full release notes](./changelogs/0.1.1.md)
+
+## [0.1.0] - 2026-01-30
+
+**Initial release**
+
+Interactive wizard, stack installation, skill compilation, validation, configuration management, and plugin mode.
+
+[-> Full release notes](./changelogs/0.1.0.md)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vincent
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,179 @@
+# Agents Inc. CLI
+
+the CLI for working with Agents Inc. skills. it's the entry point for everything: installing skills, creating stacks, and creating custom skills and subagents
+
+```bash
+npx @agents-inc/cli init
+```
+
+## what this does
+
+Claude Code is okay out of the box, but it doesn't know your stack. the skills repository has 80+ in-depth modules covering react, hono, drizzle, posthog, and a lot more. each skill is atomic, comprehensive, and composable into agents and stacks
+
+the CLI is how you work with all of it:
+
+- **install skills** as plugins or locally into your project
+- **create stacks** by bundling skills with a modular agent approach
+- **scaffold new skills** when you need something custom
+- **set up your own marketplace** if you're building for a team or org
+
+## getting started
+
+```bash
+# run the wizard - picks skills, sets up agents
+npx @agents-inc/cli init
+
+# or install globally
+npm install -g @agents-inc/cli
+```
+
+requires node 18+ and [Claude Code](https://docs.anthropic.com/en/docs/claude-code).
+
+## commands
+
+| command             | what it does                                                  |
+| ------------------- | ------------------------------------------------------------- |
+| `init`              | interactive setup - pick skills, configure agents             |
+| `edit`              | modify your skill selection                                   |
+| `compile`           | recompile agents after changes                                |
+| `update`            | update local skills from source                               |
+| `list`              | show what's installed                                         |
+| `doctor`            | diagnose setup issues                                         |
+| `search`            | search skills (interactive multi-source or static query)      |
+| `info <skill>`      | show skill details                                            |
+| `diff`              | show skill differences vs source                              |
+| `outdated`          | check for outdated skills                                     |
+| `validate`          | check your setup is correct                                   |
+| `new skill`         | create a custom skill                                         |
+| `new agent`         | create a custom agent                                         |
+| `import skill`      | import a skill from an external GitHub repository             |
+| `eject`             | eject skills/agent partials for customization                 |
+| `uninstall`         | remove Agents Inc. from project                               |
+| `config`            | manage settings (show, get, set-project, unset-project, path) |
+| `version`           | show/manage plugin versions (show, set, bump)                 |
+| `build marketplace` | generate marketplace.json                                     |
+| `build plugins`     | build individual skill plugins                                |
+| `build stack`       | build a stack plugin                                          |
+
+every command supports `--dry-run` and `--source` flags. run `npx @agents-inc/cli <command> --help` for full options.
+
+## how skills work
+
+a skill is focused knowledge for one technology. not surface-level docs but actual patterns, edge cases, the things you'd normally have to explain repeatedly
+
+skills live in the [agents-inc/skills](https://github.com/agents-inc/skills) repository, organized by category:
+
+| category | what's there                                                                                                                                                                                                                                                                          |
+| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 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, yargs, clack, inquirer, ink                                                                                                                                                                                                                                         |
+| infra    | turborepo, tooling, env config                                                                                                                                                                                                                                                        |
+| meta     | code reviewing, research methodology, investigation requirements, anti-over-engineering, context management                                                                                                                                                                           |
+
+## stacks
+
+stacks bundle skills together with pre-configured agents. instead of picking 20 skills individually, grab a stack that matches your setup:
+
+- **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
+- **react-native-stack** - react native + expo + zustand + react-query
+- **meta-stack** - agents for creating agents, skills, docs, and extracting patterns
+
+each stack includes agents like `web-developer`, `api-developer`, `web-reviewer`, `web-tester`, `web-researcher`, `pattern-scout`, `documentor` - roles that use the right skills for the job.
+
+## installation modes
+
+the wizard starts by asking how you want to set up:
+
+**use a stack** (default):
+
+```bash
+npx @agents-inc/cli init
+# select "Use a stack" → pick a pre-built stack (e.g. nextjs-fullstack)
+# installs as a native Claude Code plugin to ./.claude/plugins/agents-inc/
+# you can customize skills after selecting a stack
+```
+
+**start from scratch** (pick individual skills):
+
+```bash
+npx @agents-inc/cli init
+# select "Start from scratch" → browse domains and pick skills one by one
+# installs locally to ./.claude/skills/ in your repo
+```
+
+both modes compile agents and generate a config at `.claude-src/config.yaml`. use `cc edit` to change skills after initial setup.
+
+## multi-source setup
+
+you can install skills from multiple sources. the wizard supports adding extra marketplaces alongside the default source:
+
+- press `G` in the wizard to open source settings
+- add marketplace URLs (e.g. `github:your-org/custom-marketplace`)
+- skills from all sources appear in the selection grid, tagged by origin
+
+you can also manage sources after setup with `cc edit` (same `G` hotkey).
+
+to search across all configured sources:
+
+```bash
+# interactive search across all sources
+cc search
+
+# static search with a query
+cc search react
+```
+
+## importing third-party skills
+
+import skills from any GitHub repository into your local setup:
+
+```bash
+# list available skills from a repository
+cc import skill github:vercel-labs/agent-skills --list
+
+# import a specific skill
+cc import skill github:vercel-labs/agent-skills --skill react-best-practices
+
+# import all skills from a repository
+cc import skill github:vercel-labs/agent-skills --all
+```
+
+imported skills are copied to `.claude/skills/` and tracked with metadata for future updates.
+
+## creating custom skills
+
+if the existing skills don't cover what you need:
+
+```bash
+npx @agents-inc/cli new skill my-custom-skill
+```
+
+this scaffolds the structure. a skill is just markdown with examples - no special tooling required.
+
+## architecture
+
+built with TypeScript (strict mode), oclif for commands, Ink (React) for terminal UI, Zod for runtime validation, and Zustand for wizard state. the core pipeline:
+
+```
+source resolution → skill loading → matrix merging → wizard selection → config generation → agent compilation → installation
+```
+
+the codebase is organized into domain-driven library modules (`agents/`, `configuration/`, `loading/`, `matrix/`, `plugins/`, `skills/`, `stacks/`, `installation/`) with barrel exports. agents are compiled from YAML definitions + markdown partials through Liquid templates.
+
+see [docs/reference/architecture.md](./docs/reference/architecture.md) for the full reference.
+
+## links
+
+- [skills repository](https://github.com/agents-inc/skills) - all the skills and stacks
+- [Claude Code docs](https://docs.anthropic.com/en/docs/claude-code) - the tool this extends
+
+## license
+
+MIT