@claude-collective/cli 0.13.3 → 0.21.0

package/CHANGELOG.md

@@ -5,6 +5,186 @@ All notable changes to this project will be documented in this file.
 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.21.0] - 2026-02-09
+
+### Changed
+
+- **Removed refine wizard step** - The 5-step wizard flow (approach → stack → build → refine → confirm) is now 4 steps (approach → stack → build → confirm). The refine step for skill source selection has been removed; `refineAction` state and `setRefineAction` action removed from wizard store.
+- **Build step layout** - Domain tabs header shows all selected domains with active domain highlighted; legend row simplified from positioned overlay to inline flex layout.
+
+### Added
+
+- **`web-extras` domain** - 8 categories (error-handling, file-upload, files, utilities, realtime, animation, pwa, accessibility) split from `web` into a new `web-extras` domain to reduce vertical height in the build view.
+- **`parent_domain` field** on `CategoryDefinition` - Sub-domains inherit framework-first filtering from their parent domain (e.g., `web-extras` respects `web`'s framework selection).
+- **`parentDomainSelections` prop** on `StepBuild` - Passes parent domain selections for framework compatibility filtering in sub-domains.
+
+## [0.20.0] - 2026-02-07
+
+### Changed
+
+- **Removed `StackConfig` type** - All consumers (compile, agent-recompiler, resolver, stack-plugin-compiler, loader) now operate directly on `ProjectConfig`. The `StackConfig` interface, `loadStack()`, `loadStackSkills()`, `projectConfigToStackLike()`, `resolveAgentSkills()`, and related conversion helpers have been removed.
+- **Removed global config layer** - The `~/.claude-collective/config.yaml` global config is no longer supported. Config resolution simplifies from `flag > env > project > global > default` to `flag > env > project > default`. The `config:set` and `config:unset` commands (which wrote to global config) have been deleted.
+- **Removed legacy StackConfig detection** - `isLegacyStackConfig()`, `normalizeStackConfig()`, and the legacy format migration branch in `loadProjectConfig()` have been removed. `ProjectConfig` is the only supported format.
+- **Removed StackConfig-based generator functions** - `generateConfigFromSkills`, `generateConfigFromStack`, `mergeStackWithSkills`, and `generateProjectConfigFromStack` removed from config-generator.
+- **Removed `suggested_stacks` from skills matrix** - The field on `SkillsMatrixConfig` and the alias-resolution logic in `resolveSuggestedStacks()` have been removed; stacks are defined in `stacks.yaml`.
+- **Removed deprecated frontmatter field warnings** - `category`, `author`, and `version` warnings in skill frontmatter validation removed (metadata comes from `metadata.yaml`).
+- **Removed deprecated skill extraction functions** - `extractSkillName`, `extractCategory`, `extractAuthor` stubs removed from skill-plugin-compiler.
+- **Removed deprecated `skills` field from `AgentDefinition`** - Skills come from stacks, not agent definitions.
+
+### Removed
+
+- **`config:set` command** - Wrote to removed global config.
+- **`config:unset` command** - Wrote to removed global config.
+- **`test-imports` command** - Hidden debug command no longer needed.
+- **`GlobalConfig` type and helpers** - `loadGlobalConfig`, `saveGlobalConfig`, `getGlobalConfigPath`, `getGlobalConfigDir`.
+- **`"global"` source origin** - Removed from `sourceOrigin` and `AgentsSourceOrigin` union types.
+
+## [0.19.0] - 2026-02-07
+
+### Changed
+
+- **Removed top-level categories from skills matrix** - Top-level categories (`frontend`, `backend`, `setup`, `cli`, `mobile`, `reviewing`, `methodology`, `research`, `shared`, `local`) and the `parent` field on subcategories have been removed. The wizard already operated entirely on the `domain` field; the top-level layer added no value.
+- **Aligned agent mapping patterns with domains** - Category path patterns in skill-agent-mappings renamed: `frontend/*` → `web/*`, `backend/*` → `api/*`, `setup/*` → `infra/*`. YAML defaults and marketplace generator updated to match.
+- **Renamed `frontend/realtime` to `realtime`** - Composite subcategory ID simplified to match the `^[a-z][a-z0-9-]*$` schema pattern.
+- **Stacks alias renamed** - `backend-testing` → `api-testing` in stacks.yaml.
+
+### Added
+
+- **New web categories** - `animation`, `pwa`, `accessibility`, `web-performance` for skills previously bucketed under the removed `frontend` top-level.
+- **New shared categories** - `methodology`, `research`, `reviewing`, `ci-cd` for meta and infrastructure skills.
+
+### Removed
+
+- **`parent` field** from `CategoryDefinition` type and JSON schema.
+- **`getSubcategories()` and `getTopLevelCategories()`** from matrix-resolver (unused in production code).
+
+## [0.18.0] - 2026-02-07
+
+### Added
+
+- **Matrix health check** - New `matrix-health-check` module validates referential integrity of the merged skills matrix at load time, surfacing ghost skill IDs, missing domains, unknown categories, and dangling stack references
+- **Diagnostic logging for alias resolution** - `resolveToCanonicalId` in matrix-loader now accepts a context parameter for verbose-level messages when an ID can't be resolved
+- **Logger `warn()` function** - Always-visible warnings (not gated by verbose mode) for issues like unresolved aliases and missing skill categories
+- **Expanded matrix categories** - Top-level categories (methodology, research, shared, local) and new subcategories: error-handling, i18n, file-upload, files, utilities, frontend/realtime, performance, security
+- **New skill aliases** - `tailwind` → `web-styling-tailwind`, `mobx` → `web-state-mobx`, updated `oclif` → `cli-framework-oclif-ink`
+
+### Changed
+
+- **Dead types removed** - Removed unused types from `types.ts` (`SkillsConfig`, `RegistryConfig`, `AgentsConfig`, `AgentSkillEntry`, `SkillYamlConfig`, `Config`, `PluginCompileOptions`) and `types-matrix.ts` (`WizardState`)
+- **Type disambiguations** - `ProjectConfig` → `ProjectSourceConfig` in config.ts, `SkillPluginOptions`/`StackPluginOptions` → `SkillManifestOptions`/`StackManifestOptions` in plugin-manifest.ts, `ForkedFromMetadata` → `ImportedForkedFromMetadata` in import command, `ValidationResult` → `BuildStepValidation` in step-build
+- **Shared `extractFrontmatter` utility** - Deduplicated three identical copies (output-validator, plugin-validator, schema-validator) into `src/cli/utils/frontmatter.ts`
+- **Shared wizard utilities** - Extracted `getDomainDisplayName` and `getStackName` from wizard.tsx and step-build.tsx into `wizard/utils.ts`
+- **Consolidated `injectForkedFromMetadata`** - Moved from skill-copier.ts and update.tsx into skill-metadata.ts as single source of truth
+- **`parseFrontmatter` import** - skill-plugin-compiler.ts now imports from loader.ts instead of defining its own copy
+- **`LocalResolvedSkill` type** - Extracted named type in local-installer.ts replacing repeated inline object types
+- **Deprecated `WizardResult` removed** - Wizard `onComplete` callback now accepts only `WizardResultV2`
+- **`OutputValidationResult` replaced** - Uses `ValidationResult` from types.ts instead of local duplicate
+- **Matrix alias cleanup** - Removed references to skills not yet created (yargs, clack, inquirer, ink, svelte) from conflicts, alternatives, recommends, and requires
+
+## [0.17.0] - 2026-02-07
+
+### Added
+
+- **Local skill badge in wizard** - Skill tags in the CategoryGrid now show a gray `[L]` badge when the skill has a local override in `.claude/skills/`
+
+### Changed
+
+- **Extract config-merger module** - Config merging logic (identity fields, skills/agents union, stack deep-merge) extracted from `init.tsx` into dedicated `lib/config-merger.ts` with comprehensive tests
+- **Extract local-installer module** - Local installation orchestration (skill copying, config generation, agent compilation) extracted from `init.tsx` into `lib/local-installer.ts`, reducing the command to a thin orchestrator
+- **Deduplicate getCurrentDate** - Removed duplicate `getCurrentDate()` definitions from `import/skill.ts`, `update.tsx`, and `skill-copier.ts` in favor of the canonical export from `lib/versioning.ts`
+- **Graceful missing skill resolution** - `resolveSkillReference` now returns `null` and logs a verbose message instead of throwing when a skill is not found; callers skip missing skills gracefully
+- **Remove synthetic local categories** - Stop injecting fake `local` and `local/custom` category definitions into the skills matrix; local skills use their declared or inherited category
+
+### Fixed
+
+- **Wizard skill count mismatch** - Confirm step now uses `getAllSelectedTechnologies()` instead of `getSelectedSkills()` so the count matches the actual technologies shown
+- **Wizard option tracking** - Build step uses `skill.id` instead of alias for `CategoryOption.id` so selection tracking stays consistent
+- **Multi-skill category pre-population** - Stack pre-population now uses per-skill pseudo-agents so categories with multiple skills (e.g. testing: vitest + playwright-e2e) are all preserved instead of the second overwriting the first
+
+## [0.16.0] - 2026-02-07
+
+### Changed
+
+- **Wizard flow simplified** - Removed the intermediate "stack-options" step; selecting a stack now goes directly to the build step with pre-populated technology selections. Flow is now: approach -> stack -> build -> refine -> confirm
+- **ViewTitle component** - Simplified API from `title` string prop to `children` for flexible composition
+- **Build step header** - Replaced domain tab header with ViewTitle showing "Customise your {Domain} stack"
+- **Build step legend** - Simplified color legend from background-colored badges to plain colored text
+- **CategoryGrid styling** - Skill tags now use border-based styling instead of background colors; removed section header underlines
+
+### Added
+
+- **Accept defaults shortcut** - Press `A` during build step (stack path only) to skip customization and continue with stack defaults
+- **All-domain cycling** - Stack selection now includes all five domains (web, api, cli, mobile, shared) in the build step, even if the stack only covers some
+
+### Fixed
+
+- **Local skill category preservation** - When a local skill overwrites a remote skill, the remote skill's domain-based category is now preserved instead of falling back to "local/custom"
+
+### Removed
+
+- **StepStackOptions component** - Eliminated intermediate step between stack selection and technology customization
+
+## [0.15.0] - 2026-02-07
+
+### Added
+
+- **MenuItem component** - Reusable chevron + label menu item with focused/active states for wizard navigation
+- **ViewTitle component** - Yellow-background title banner for consistent wizard step headings
+- **Global keyboard shortcuts** - `E` toggles expert mode, `P` toggles plugin/local install mode, `D` toggles descriptions (on build step) - available from any wizard step
+
+### Changed
+
+- **Step Approach** - Replaced Select dropdown with custom card-based navigation using arrow keys and Enter
+- **Step Stack** - Replaced Select dropdown with card-based stack selection; Escape for back navigation; focus starts at first stack
+- **Mode toggles** - Expert mode and install mode moved from per-step menu options to persistent global shortcuts shown in layout footer
+- **Build step legend** - Repositioned color legend (active/recommended/discouraged/disabled) above category grid
+
+### Removed
+
+- **Inline keyboard hints** - Removed per-step keyboard hint text (global footer already provides this)
+- **CategoryGrid header/legend** - Moved toggle indicators and legend out of CategoryGrid to parent components
+
+## [0.14.1] - 2026-02-07
+
+### Changed
+
+- **Extract skill-metadata library** - Deduplicated `readForkedFromMetadata`, `getLocalSkillsWithMetadata`, `computeSourceHash`, and `compareSkills` into shared `lib/skill-metadata.ts`, removing ~254 lines from `update.tsx`, `outdated.ts`, and `diff.ts`
+- **Extract config-saver library** - Deduplicated `saveSourceToProjectConfig` into shared `lib/config-saver.ts`, removing duplication from `init.tsx` and `eject.ts`
+- **Extract plugin-manifest-finder library** - Deduplicated `findPluginManifest` into shared `lib/plugin-manifest-finder.ts`, removing duplication from 4 `version/*` command files
+
+### Removed
+
+- **Unused step-build props** - Removed `currentDomainIndex` prop, dead code from SectionProgress removal (unused imports, constants, functions)
+
+## [0.14.0] - 2026-02-07
+
+### Changed
+
+- **WizardLayout component** - Extracted layout wrapper that renders WizardTabs (header), children, and WizardFooter consistently across all wizard steps
+- **Wizard tabs** - Simplified to text-only styling (cyan current, dimmed skipped) with horizontal border lines; renamed "Approach" step to "Intro"; version displayed in tab bar
+- **Build step header** - Redesigned with domain tab navigation and inline toggle indicators for descriptions and expert mode
+- **Wizard footer** - Unified keyboard shortcut hints (navigate, select, continue, back, export) displayed on all steps, replacing per-step footer strings
+
+### Added
+
+- **ASCII art banner** - Init command displays stylized banner on startup
+- **Prettier config** - Added `prettier.config.mjs` for consistent code formatting (printWidth 100)
+
+### Removed
+
+- **Old WizardFooter component** (`wizard-footer.tsx`) - Replaced by centralized footer in WizardLayout
+- **SectionProgress in build step** - Domain progress replaced by domain tab navigation in header
+
+### Fixed
+
+- **Version display** - Fixed broken `import { config } from "process"` (Node's build config, not CLI version); version now prop-drilled from oclif `this.config.version`
+
+## [0.13.4] - 2026-02-06
+
+### Fixed
+
+- **local skills lose category metadata** - Local skills from `.claude/skills/` were hardcoded to `category: "local/custom"`, destroying their original category (e.g., `"framework"`, `"styling"`). This broke framework pre-selection in the wizard's Build step and domain filtering. Now preserves the original category from `metadata.yaml` when it matches a matrix category, and carries forward aliases and relationships from source skills.
+
 ## [0.13.3] - 2026-02-06
 
 ### Fixed
@@ -49,6 +229,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Old `search.ts` command - Replaced with dual-mode `search.tsx` (static + interactive)
 
+[0.21.0]: https://github.com/claude-collective/cli/releases/tag/v0.21.0
+[0.20.0]: https://github.com/claude-collective/cli/releases/tag/v0.20.0
+[0.19.0]: https://github.com/claude-collective/cli/releases/tag/v0.19.0
+[0.18.0]: https://github.com/claude-collective/cli/releases/tag/v0.18.0
+[0.17.0]: https://github.com/claude-collective/cli/releases/tag/v0.17.0
+[0.16.0]: https://github.com/claude-collective/cli/releases/tag/v0.16.0
+[0.15.0]: https://github.com/claude-collective/cli/releases/tag/v0.15.0
+[0.14.1]: https://github.com/claude-collective/cli/releases/tag/v0.14.1
+[0.14.0]: https://github.com/claude-collective/cli/releases/tag/v0.14.0
+[0.13.4]: https://github.com/claude-collective/cli/releases/tag/v0.13.4
 [0.13.3]: https://github.com/claude-collective/cli/releases/tag/v0.13.3
 [0.13.2]: https://github.com/claude-collective/cli/releases/tag/v0.13.2
 [0.13.1]: https://github.com/claude-collective/cli/releases/tag/v0.13.1