@lando-labs/lando-ds-mcp 4.0.0

package/CHANGELOG.md

@@ -0,0 +1,526 @@
+# Changelog
+
+All notable changes to the Lando Labs Design System MCP Server will be documented in this file.
+
+## [4.0.0] - 2026-07-16
+
+**DS ecosystem consolidation.** MCP catches up to the DS's public launch on npm and consolidates. Four coordinated breaking changes:
+
+1. **npm package renamed** — `@lando-labs/design-system-mcp` → `@lando-labs/lando-ds-mcp`
+2. **CLI bin renamed** — `lando-design-system-mcp` → `lando-ds-mcp`
+3. **DS meta consumed at runtime** — `@lando-labs/lando-ds-meta` (v0.57.0) is now a `dependencies` entry; the build-time copy workflow (`scripts/copy-ds-meta.ts`) and drift check (`scripts/check-ds-drift.ts`) are gone. `npm update @lando-labs/lando-ds-meta` replaces `npm run copy:ds-meta`.
+4. **React Native support removed** — the DS won't ship RN. `platform` parameter dropped from every tool's schema; `platform-transform.ts`, `platform.ts`, and `rn-tokens-snapshot.ts` deleted.
+
+### Renamed
+
+- **`@lando-labs/design-system-mcp` → `@lando-labs/lando-ds-mcp`** on npm. Verified 2026-07-16 that the old name was never published (`npm view` returned 404), so there is no deprecation notice on the old registry entry — nothing existed.
+- **CLI bin `lando-design-system-mcp` → `lando-ds-mcp`.** Update your MCP client config: `"command": "lando-ds-mcp"`.
+- **Server identity** in the MCP handshake: name changed from `lando-design-system` → `lando-ds`.
+
+### Added
+
+- **Runtime dependency** on `@lando-labs/lando-ds-meta@^0.57.0`. Meta is loaded via `createRequire('@lando-labs/lando-ds-meta')` — CJS-in-ESM pattern that lets `Node16`-and-newer TypeScript project settings pick up the package's `exports` map default (`meta.json`) without a `default` re-export in the shipped types.d.ts.
+- **Meta types imported from the subpackage** — `LightMeta`, `VerboseMeta`, `LightComponentMeta`, `VerboseComponentMeta`, `HookMeta`, `IconRegistryEntry`, `MetaSchemaVersion`, `ThemePresetsMeta` all sourced from `@lando-labs/lando-ds-meta/types` and re-exported through `src/utils/meta-loader.ts` so tool consumers keep their existing import path.
+- **DS meta refreshed to v0.57.0** (was v0.56.0). Content-refresh side-effect of the subpackage adoption.
+
+### Removed
+
+- `src/data/ds-meta.json`, `ds-meta.verbose.json`, `ds-meta.schema.json` (~420 KB of baked JSON gone from source and the published tarball)
+- `scripts/copy-ds-meta.ts`, `scripts/check-ds-drift.ts` (~200 LOC)
+- `src/tools/platform.ts`, `src/tools/platform-transform.ts`, `src/data/rn-tokens-snapshot.ts` (~500 LOC)
+- `src/__tests__/*.test.ts` (legacy vitest tests superseded by `src/test.ts`)
+- `platform` parameter from 8 tools' Zod schemas + JSON schemas + dispatch: `list_components`, `get_component`, `compose_components`, `get_design_tokens`, `get_animation_examples`, `list_icons`, `search_icons`, `get_component_capabilities`
+- ~150 LOC of hand-mirrored meta interfaces in `meta-loader.ts` (replaced with imports from the subpackage's `types.d.ts`)
+- `copy:ds-meta`, `check:ds-drift`, `build:full`, `update:all-components` npm scripts
+- `platforms` field surfacing in `get_component_capabilities` and `get_component_reference` output (still in meta; MCP just doesn't render it now that RN isn't a target)
+
+### Changed
+
+- **`build` script** simplified to `tsc && chmod +x build/index.js` — no more `cp src/data/*.json build/data/`.
+- **`tsconfig.json`** — `module` and `moduleResolution` bumped from `Node16` to `NodeNext` for support of import attributes (`with { type: 'json' }`) and modern export-map resolution semantics.
+- **Startup banner** now reports `Version: 4.0.0 (backed by @lando-labs/lando-ds-meta v0.57.0)`.
+- **README** — install snippets updated to `npm install -g @lando-labs/lando-ds-mcp` and command `lando-ds-mcp`.
+
+### Not changed
+
+- **Tool catalog** — still 15 tools with the same names. Their schemas lost the `platform` param but every other input stays identical for consumers targeting web (the vast majority).
+- **Meta schema major line** — DS meta is still `1.x`. MCP compat check unchanged.
+- **License** — Apache 2.0 (unchanged from v3.2.0).
+
+### Migration for local dogfooders
+
+```bash
+# Uninstall the old name (had it globally? Only lab dogfooders would)
+npm uninstall -g @lando-labs/design-system-mcp
+
+# Install the new one from npm (first public publish will follow this release)
+npm install -g @lando-labs/lando-ds-mcp
+```
+
+Client config: change `"command": "lando-design-system-mcp"` → `"command": "lando-ds-mcp"`.
+
+### Verified
+
+- typecheck ✓, build ✓, tests **78/78** ✓ (was 80 in v3.3.0; two RN-specific tests deleted with the platform param)
+
+## [3.3.0] - 2026-07-14
+
+**Hooks tools.** DS v0.56.0 shipped the utility-hooks library ([DS#504](https://github.com/lando-labs/lando-labs-design-system/issues/504)) and made hooks first-class in `meta.json` (schema 1.3). This release exposes them to MCP-connected agents. Tool catalog: **13 → 15**.
+
+### Added
+
+- **`list_hooks` tool** — enumerate DS utility hooks with optional filters (`category`, `serverSafe`). Groups by category (state / timing / dom / browser / lifecycle / a11y / keyboard / layout). Renders signature inline for scan-ability.
+- **`get_hook` tool** — full detail for a single hook: signature, returns, category, RSC safety, subpath, description, and a ready-to-paste import snippet. Dynamic hook-name enum derived from meta at startup (mirrors the `get_component` pattern).
+- **`HookMeta` interface** in `src/utils/meta-loader.ts` — types the schema 1.3 `hooks` field. Marked optional on `Meta<T>` so older meta snapshots still parse (compat kept intentionally lenient — DS bumped meta minor, MCP did not need to bump its major).
+- **`getHookNames()` / `getHook()`** convenience accessors alongside the existing component accessors.
+- **Hook totals section** in `get_ds_metadata` output — total count + category breakdown + pointer to the two new tools, so agents self-orienting via the one-call metadata tool discover the capability.
+
+### Changed
+
+- **Startup banner** now reports `Components: N | Hooks: M` and the updated 15-tool list.
+- **README** — tool table shows 15 tools with `list_hooks` / `get_hook` rows and updated `get_ds_metadata` blurb.
+
+### Not changed
+
+- **DS meta version** — unchanged from v3.2.3 (v0.56.0, schema 1.3). This release ships the tool surface for the hooks data v3.2.3 already baked in.
+- **Existing 13 tools** — same names, same schemas, same outputs.
+- **Component count** — 127.
+
+### Verified
+
+- typecheck ✓, build ✓, check:ds-drift ✓, tests **80/80** ✓ (was 67; 13 new for hook coverage)
+
+### Launch note
+
+The originally planned v3.3.0 (DS-usage auditing) has shifted to v3.4.0. This slot went to hooks because DS#504 explicitly framed the hooks library as *discoverable* and shipping DS launch weekend with hooks invisible to MCP would undercut that.
+
+## [3.2.3] - 2026-07-14
+
+**Content refresh: DS v0.54 → v0.56.** Two-minor DS delta — still PATCH per the "content-only" branch of the convention (no MCP tool changes; the meta schema major line is unchanged). Meta schema *minor* bumped 1.2 → 1.3 to add the `hooks` capability, but MCP's compat check is major-pinned (`1.x`), so this is a non-breaking pickup.
+
+### Changed
+
+- **Baked DS meta refreshed to v0.56.0.** Schema 1.2 → 1.3. Component count unchanged at 127. Picks up the DS v0.55.0 + v0.56.0 releases — most notably the new **utility-hooks library** ([DS#504](https://github.com/lando-labs/lando-labs-design-system/issues/504)): 19 hooks across 8 categories (state / timing / dom / browser / lifecycle / a11y / keyboard / layout) now emitted into `meta.json` under a top-level `hooks` key.
+
+### Not exposed yet (upcoming)
+
+The new `hooks` capability is present in the baked meta but there is **no dedicated MCP tool** for it yet — a follow-up sprint will decide whether to add `list_hooks` / `get_hook` (mirroring the component pattern) or fold hook exposure into an existing tool. Tracked as a scope question for the next planning session.
+
+### Launch note
+
+v3.2.3 supersedes v3.2.2 as the launch target. Publish tag still held for the coordinated launch weekend; whichever bump lands on `main` most recently is what gets tagged.
+
+## [3.2.2] - 2026-07-14
+
+**Content refresh: DS v0.53 → v0.54.** Single-minor DS delta; PATCH bump per the established convention.
+
+### Changed
+
+- **Baked DS meta refreshed to v0.54.0.** Content-only. Schema unchanged at 1.2. Component count unchanged at 127. Picks up the DS v0.54.0 "uncontrolled-first state contract" release ([DS#508](https://github.com/lando-labs/lando-labs-design-system/issues/508)).
+
+### Launch note
+
+v3.2.2 supersedes v3.2.1 as the launch target. Publish tag still held for the coordinated launch weekend; whichever bump lands on `main` most recently is what gets tagged.
+
+## [3.2.1] - 2026-07-13
+
+**Content refresh: DS v0.50 → v0.53.** Small pre-launch content bundle; PATCH bump per the established convention (single-digit DS delta = PATCH). No MCP code changes.
+
+### Changed
+
+- **Baked DS meta refreshed to v0.53.0.** Content-only. Schema unchanged at 1.2. Component count unchanged at 127. Picks up any DS content shipped between v0.50.0 and v0.53.0 (three minor DS releases).
+
+### Launch note
+
+v3.2.0 merged to main on 2026-07-13 but has not been tagged/published yet — publish tag is held for the coordinated launch weekend. v3.2.1 supersedes v3.2.0 as the launch target: the tarball published to npm at launch will be v3.2.1 with the fresher DS content baked in.
+
+## [3.2.0] - 2026-07-10
+
+**OSS launch: parallel with DS.** MCP adopts Apache 2.0 alongside the DS's simultaneous OSS launch. Public GitHub, public npm, standard OSS conventions. Also refreshes baked meta to DS v0.48.0.
+
+### Added
+
+- **Apache 2.0 LICENSE + NOTICE files** at repo root. `package.json` `"license"` field switched from `"MIT"` (aspirational, no file existed) to `"Apache-2.0"` (matches the shipped LICENSE). See [#45](https://github.com/lando-labs/lando-ds-mcp/issues/45).
+- **Publish workflow** (`.github/workflows/publish.yml`) — triggers on semver tag push. Verifies tag matches package.json, runs full CI, then `npm publish --provenance --access public` (SLSA build attestation on the npm package page) followed by `gh release create` for the GitHub Release. See [#3](https://github.com/lando-labs/lando-ds-mcp/issues/3), [#43](https://github.com/lando-labs/lando-ds-mcp/issues/43).
+- **package.json metadata**: `publishConfig`, `repository`, `homepage`, `bugs` — all pointing at the public GitHub repo.
+- **Version-sync CI tests** — five new assertions in `src/test.ts`: package.json version matches `src/index.ts` JSDoc comment, `Server({ version })` registration, startup banner, `CHANGELOG.md` top entry, and README component count. Any future drift fails CI. See [#11](https://github.com/lando-labs/lando-ds-mcp/issues/11).
+- **Public OSS README** — full rewrite for external audience. Install snippets for Claude Code, Claude Desktop, Cursor, Windsurf, Zed, generic MCP client. 13-tool reference. Contributing section with dev setup. License + attribution links. See [#2](https://github.com/lando-labs/lando-ds-mcp/issues/2).
+
+### Changed
+
+- **Baked DS meta refreshed to v0.50.0** (from v0.44.0). Content-only bundle rolled into this MINOR since it ships with the launch rather than as its own PATCH.
+- **GitHub repo visibility** flipped Private → Public at launch time (not a code change; documented for provenance).
+- **Fixed latent v3.1.1 drift** in `src/index.ts:11` and `:59` that the v3.1.2 patch left behind. The new version-sync tests would have caught this.
+
+### Not changed
+
+- **13 tools + their contracts** — same names, same schemas, same outputs (modulo the DS content refresh)
+- **Meta schema** — still consumes DS meta schema `^1.x`; DS is at 1.2
+- **Component count** — 127
+- **Tool catalog conventions** — unchanged from v3.1.x
+
+### Verified pre-launch
+
+- typecheck ✓, build ✓, test **67/67** ✓, `npm pack --dry-run` (124 files, all under `build/` + README + LICENSE + NOTICE + CHANGELOG + package.json)
+
+### Companion release
+
+The DS is launching under Apache 2.0 in parallel (originally MIT in DS v0.47.0; switched per [DS#500](https://github.com/lando-labs/lando-labs-design-system/issues/500) before public flip).
+
+## [3.1.2] - 2026-07-07
+
+**Content refresh: DS v0.43 → v0.44.** Single-minor DS delta; PATCH bump.
+
+### Changed
+
+- **Baked DS meta refreshed to v0.44.0.** Schema unchanged at 1.2. Component count unchanged at 127. Theme preset count: 6 → 7 (DS added a preset in v0.44).
+
+### Convention refinement
+
+The v3.1.0 CHANGELOG stated "content-only refreshes bump the MCP minor." Refining that with two releases of experience:
+
+- **MINOR** — generational content jumps (e.g. v3.1.0 covered 4 DS minors) or when consuming new meta schema versions with code changes.
+- **PATCH** — small content refreshes (single DS minor delta) and workaround-replacement fixes.
+
+This release is PATCH per that convention. Prevents version-collision with reserved sprint versions (v3.2.0 for Sprint 3 stays reserved).
+
+## [3.1.1] - 2026-07-07
+
+**Consume DS meta schema 1.2** — authoritative `extends` chain and `themePresets` block. Baked meta refreshed to DS v0.43.0.
+
+Replaces two v3.0.1 workarounds with authoritative data from the DS. No new tools; no schema changes to MCP tool contracts. Consumer-visible tool output changes.
+
+### Changed
+
+- **`get_theme_presets` reads from meta.** The hardcoded KNOWN_PRESETS list is gone. The tool now surfaces every preset the DS ships (currently: brand-neutral, forest, lando, midnight, rose, slate) with the DS-declared default marked. When the DS adds a preset, `npm run copy:ds-meta && npm run build` picks it up — no MCP code edits.
+- **HTML-attrs footer is authoritative.** Instead of the v3.0.1 heuristic ("this component *may* accept additional standard React/HTML attributes"), `get_component_props` and `get_component_reference` now render the exact TS extends chain from meta:
+
+  ```
+  > Also accepts everything in: HTMLAttributes<HTMLButtonElement>, RefAttributes<HTMLButtonElement>.
+  ```
+
+  Semantic change: the footer now fires for **any** component with a non-empty extends chain, not just sparse-own-props ones. Rich-props components like Button now surface their extends chain too. More informative; more verbose.
+
+### Added
+
+- `LightComponentMeta.extends?: string[] | null` (from DS#438, schema 1.2)
+- `Meta.themePresets?: ThemePresetsMeta` (from DS#437, schema 1.1)
+- Backwards-compatible heuristic fallback in `renderHtmlAttrsFooter` when `extends` is absent — meta from older DS versions still gets the vaguer note
+
+### Upstream, resolved
+
+- [DS#437](https://github.com/lando-labs/lando-labs-design-system/issues/437) — themePresets block. **Consumed here.**
+- [DS#438](https://github.com/lando-labs/lando-labs-design-system/issues/438) — component extends chain. **Consumed here.**
+
+## [3.1.0] - 2026-07-06
+
+**Content refresh: DS v0.38 → v0.42.** No code changes; MCP is version-bumped as a signal that consumer-visible tool output materially differs. Meta schema unchanged at 1.0. No new API surface.
+
+### Changed
+
+- **Baked DS meta refreshed to v0.42.0** (from v0.38.0). Four intervening DS releases (v0.39.0 customizability-finish, v0.40.0 hardening, v0.40.1 rsc-boundary, v0.41.0 token-ssot, v0.42.0). Content changes only:
+  - Refreshed prop/type introspection across all 127 components
+  - Updated deprecation notices (any component deprecated in 0.39–0.42 now shows in `list_components` output)
+  - Updated icon registry
+  - Post-v0.41 token-ssot restructure: token values may render differently, but the meta shape is unchanged (colors/spacing/typography/radius/shadows/motion — same 6 categories)
+- **Convention established:** content-only refreshes bump the MCP minor. Each MINOR going forward corresponds to a specific DS meta snapshot. Consumers pinning to `^3.0` still get security patches; `^3.1` explicitly opts into the newer DS content.
+
+### Not changed
+
+- Tool catalog — still the 13 tools shipped in v3.0.0 with the v3.0.1 heuristic footer
+- Meta schema version — still `1.0`
+- Component count — still 127
+- Top-level meta blocks — no `themePresets` (DS#437) or `extends` (DS#438) yet
+
+### Refresh workflow (for future content refreshes)
+
+```bash
+npm run copy:ds-meta    # pulls latest from ../lando-labs-design-system/dist
+npm run check:ds-drift  # confirms in-sync
+npm run build && npm test
+# Bump version, tag, release, repack, reinstall globally
+```
+
+## [3.0.1] - 2026-07-01
+
+**Dogfood follow-ups.** Two small fixes surfaced during v3.0.0 dogfooding. No breaking changes.
+
+### Added
+
+- **HTML-attrs pass-through footer** in `get_component_props` and `get_component_reference` (#49). Components with sparse own-props (fewer than 3) that are polymorphic or have a forwarded ref now get a footer note that they may accept standard React/HTML attributes (`className`, `id`, `aria-*`, event handlers) not enumerated in meta. Fixes the reported case of `get_component_props("ThemeBuilder")` showing `{}` and misleading consumers. Replaced by an authoritative `extends` field once [DS#438](https://github.com/lando-labs/lando-labs-design-system/issues/438) lands.
+- **`check:ds-drift` npm script** (#50). Compares MCP's baked meta version to the local DS clone; prints ✓ when in sync or ⚠ + refresh instructions when the DS has moved on. Zero deps, informational only. Configurable via `DS_REPO=/absolute/path`.
+
+### Follow-ups filed (unblock future MCP cleanups)
+
+- [DS#437](https://github.com/lando-labs/lando-labs-design-system/issues/437) — `themePresets` block in `meta.json` (schema 1.1). When it lands, MCP deletes its hardcoded preset list.
+- [DS#438](https://github.com/lando-labs/lando-labs-design-system/issues/438) — component `extends` chain in `meta.components[X]` (schema 1.2). When it lands, MCP replaces the #49 heuristic footer with an authoritative extends line.
+
+## [3.0.0] - 2026-06-30
+
+**Meta-adoption engine rewrite.** The MCP is now a thin protocol adapter over DS-emitted meta instead of a shadow snapshot of the DS. Auto-current with every DS release; component coverage jumps from 60 → 127.
+
+### Breaking changes
+
+- **Tool retirements**
+  - `get_component_docs` — merged into `get_component_reference`. Migration: `get_component_reference(name)` with default include list returns description + examples + composes + props.
+  - `get_usage_example` — merged into `get_component_reference`. Migration: `get_component_reference(name, { include: ['examples'] })`.
+  - `get_component_location` — retired entirely. Subpath is available via `list_components`, `get_component_props`, and `get_component_reference` output. Filesystem paths were tied to a monorepo layout that no longer holds.
+- **Component names are PascalCase.** Consumers who passed lowercase names (`'button'`, `'card'`) must pass PascalCase (`'Button'`, `'Card'`). Names match DS meta directly; no more manual enum.
+- **`get_design_tokens` output shape** changes when `format` parameter is used. Default (`format: 'css'`) preserves the CSS-variable-reference behavior from v2.x.
+- **`list_icons` / `search_icons` `source`** values renamed: `'custom' | 'lucide'` → `'ds-brand' | 'lucide-curated'`. `'all'` unchanged.
+- **Ocean is no longer baked** as "primary brand." Ocean is now an opt-in theme preset (`lando`); the DS ships brand-neutral defaults. Purpose mappings, icon flags, and design-token framing no longer assume ocean.
+
+### Added
+
+- **13 tools** (was 12).
+  - **New**: `get_component_reference`, `get_composition_hints`, `get_theme_presets`, `get_ds_metadata`.
+  - **Expanded filters**: `list_components` (category, platform, deprecated, serverSafe, polymorphic, kind); `get_component_capabilities` (rscSafe, clientOnly, polymorphic, withRef, deprecated); `list_icons` / `search_icons` (`source` filter).
+  - **New parameters**: `get_design_tokens` gets `format: 'css' | 'hex' | 'both'`.
+- **DS coverage** — 127 components (was 60). Includes Field, DatePicker, DateRangePicker, Calendar, AlertDialog, AvatarGroup, BottomNav, Callout, Chip, Code, Collapsible, ColorSwatch, Combobox, CommandPalette, DataTable, Drawer, Banner, ArticleCard, AspectRatio, Center, and ~50 more.
+- **Startup meta-version guard** — MCP supports DS meta schema `^1.0`; rejects incompatible meta with a clear error.
+
+### Changed
+
+- **Meta-loader as source of truth** (`src/utils/meta-loader.ts`). Loads DS meta at startup; verbose meta is lazy-loaded on first access.
+- **Build pipeline** — `scripts/copy-ds-meta.ts` copies `dist/meta.json`, `dist/meta.verbose.json`, and `src/meta/schema.json` from the local DS clone into `src/data/`. `npm run build:full` runs the copy first; `npm run copy:ds-meta` re-runs it standalone.
+- **Icon strategy** — DS-brand icons come from `meta.icons.registry` (~70 authoritative names); MCP continues to curate a broader 120-Lucide subset alongside; the full ~1,500-icon Lucide library is reachable via `search_icons` spillover.
+
+### Removed
+
+- **~1,500 LOC of hand-maintained shadows** — `src/components/*.ts` (60 metadata files), `src/data/cached-props.json` (89KB), `src/data/web-tokens-snapshot.json` (40KB), `src/data/component-capabilities.ts`, `src/utils/extract-types.ts`, `scripts/prebuild-props.ts`, `scripts/generate-web-tokens-snapshot.ts`.
+- **`ts-morph` devDependency** — the runtime fallback was deleted in v2.7.1 #14; the build-time extractor is now unnecessary since DS meta is the source of truth.
+
+### Fixed / Auto-resolved
+
+- **#10** — Single-source component enum. `componentName` is derived from `Object.keys(meta.components)` at startup, not maintained across 3+ tool files.
+- **#32** — `compose_components` import-merging fragility. Already fixed in v2.7.1 #19 (rebuild from validated enum, not regex); reaffirmed here.
+- **#39** — `get_design_tokens` queryable JSON taxonomy. Partially addressed via the new `format` parameter.
+- **#40** — `get_component_props` returns JSON Schema. Setup cleanly since props come from meta directly (raw meta shape is queryable via `format` in a future rev).
+
+### Migration guide (v2.7.1 → v3.0.0)
+
+```diff
+- get_component_docs({ componentName: 'button' })
++ get_component_reference({ componentName: 'Button' })
++   // default include returns description + examples + composes + props
+
+- get_usage_example({ componentName: 'button', scenario: 'loading' })
++ get_component_reference({ componentName: 'Button', include: ['examples'] })
+
+- get_component_location({ componentName: 'button' })
++ get_component_props({ componentName: 'Button' })
++   // subpath is included in the header
+
+- list_icons({ source: 'custom' })
++ list_icons({ source: 'ds-brand' })
+
+- get_design_tokens()
++ get_design_tokens()  // unchanged; default 'css' format preserves behavior
++ get_design_tokens({ format: 'hex' })   // new: hex values from meta
++ get_design_tokens({ format: 'both' })  // new: var refs + hex
+```
+
+## [2.6.0] - 2026-04-19
+
+Major content refresh + DS v0.7.0 sync. 60 components now documented (up from 52). Pre-existing bug #45 fixed.
+
+### Fixed
+
+- **#45 `get_component_props` null/undefined on compound components** — `get-component-props.ts` previously assumed every `subComponents` entry was a `{name, props}` object, but Tabs/Accordion/Breadcrumb/Dropdown declare them as string arrays with separate `subComponentProps` lookups. Rewrote the renderer with a shared `renderPropsBody()` that guards null/undefined and handles both patterns. Defensive fix covers all current and future compound components. Regression test added for Tabs/Accordion/Breadcrumb/Dropdown.
+- **`prebuild-props.ts` stale paths** — 9 components (all layout/typography primitives and chart variants) pointed at non-existent source paths (`Layout/Stack`, `Typography/Text`, `Charts/AreaChart`, etc.). The prebuild silently swallowed these errors and emitted empty `{}` prop objects into the cache. Corrected to match current source layout.
+- **ESM runtime fallback** — `extract-types.ts` used a bare `require('ts-morph')` in an ESM context. Never hit in practice because every component was cached, but Lane 2's 8 new uncached components would have crashed on first cold load. Shimmed via `createRequire(import.meta.url)`.
+
+### Added
+
+#### 8 new component metadata files (DS v0.7.0 sync)
+
+- **AppShell** — app shell grid container with header/sidebar/footer, sticky header, collapsible sidebar, Cmd/Ctrl+B shortcut, contentPadding/contentMaxWidth props (v0.7.0+)
+- **PageHeader** — page-level header primitive with title/subtitle/breadcrumbs/actions; eliminates 6+ lines of hand-rolled flex per consumer (Sprint 9, v0.6.0)
+- **CardTitle** — explicit card title sub-component; wraps Heading at base size / semibold weight; used directly or implicitly via `Card title="..."` prop (Sprint 9, v0.6.0)
+- **SidebarNavItem** — sidebar nav item with icon/label/badge/active slots + `asChild` for next/link integration; 44px touch target, aria-current="page" on active (Sprint 9, v0.6.0)
+- **Kbd** — platform-aware keyboard shortcut pills; Mac renders ⌘K, non-Mac renders Ctrl+K; SSR-safe (Sprint 9, v0.6.0)
+- **StickyBar** — sticky top/bottom container with shadow-on-scroll via IntersectionObserver sentinel; blur/surface variants (Sprint 7, v0.5.0)
+- **Slot** — Radix-style polymorphic primitive used internally by Button/SidebarNavItem `asChild` pattern (advanced consumer use)
+- **Portal** — thin wrapper around `ReactDOM.createPortal`; used internally by Modal/Dropdown/Popover/Tooltip (advanced consumer use)
+
+All 5 tool schemas (`get_component`, `get_component_props`, `get_component_docs`, `compose_components`, `get_usage_example`, `get_component_location`) extended with the 8 new names.
+
+### Content refresh (22 files updated across Sprints 3-10)
+
+Existing component metadata refreshed to reflect DS evolution:
+
+- **Icon children API migration** — 16 files updated from pre-v0.3.0 `<Icon name="..." />` syntax to lucide-react children (`<Icon><Check /></Icon>`)
+- **Sprint 10 brand defaults** — Card shadow-xs default + `variant="flat"` opt-out, Header gradient default + opt-out, Avatar auto-gradient when initials set, Footer gradient ribbon + `accent={false}` opt-out, Modal top-accent line + opt-out. Badge dark-mode success/danger/info contrast fix.
+- **Sprint 4-6 API additions** — Radio children support (v0.4.0), Select `name` prop for FormData (v0.4.2), Table `onRowClick` (v0.4.0), Chart SSR hydration fallback
+- **Light pass** — Popover, Textarea, Pagination, plus CardTitle cross-reference added to Card metadata
+
+### Known Limitations
+
+- **Text/Container/List use `type` not `interface`** — `prebuild-props.ts` uses `getInterface()` which returns undefined for type aliases. Cached props are empty for these three components. MCP tools fall through gracefully, but consumers see empty prop tables. Worth widening the extractor to handle `TypeAliasDeclaration` in a future pass.
+- **Tabs `subComponentProps` still empty** — Accordion/Breadcrumb/Dropdown populate their sub-interface props; Tabs does not. `get_component_props('Tabs')` returns valid empty stubs for TabList/Tab/TabPanel. Content-only gap; no functional impact.
+- **`get_component_location` location map** — hardcoded for the original 52 components; new 8 fall back to generic behavior.
+
+## [2.2.0] - 2025-10-23
+
+### Added
+
+#### New Framework Components (5 components added)
+- **`SegmentedControl`** - Mutually-exclusive button group for mode switching
+  - Smooth sliding indicator animation
+  - Full keyboard navigation (Arrow keys, Home/End)
+  - Size variants (sm, md, lg)
+  - Optional icon support
+  - ARIA tablist/tab roles
+  - Common use case: View mode toggles, filter controls, assistant mode switching
+
+- **`Icon`** - Centralized icon system with 34+ common icons
+  - Name-based rendering prevents SVG duplication
+  - Icon categories: Actions, Navigation, Status, Communication, Content, UI
+  - Size presets (sm/md/lg/xl) and custom sizing
+  - Inherits currentColor by default
+  - Complete accessibility with aria-label support
+  - Icons: check, close, plus, minus, edit, trash, download, upload, copy, search, chevron-*, arrow-*, menu, info, warning, error, success, settings, message, send, user, users, file, folder, image, link, heart, star, calendar, clock
+
+- **`ApprovalCard`** - Rich card for approval workflows
+  - Extracted from ChatDemo TaskCard implementation
+  - Status indicators (pending/approved/rejected)
+  - Priority badges (low/medium/high)
+  - Metadata grid with icon support
+  - Approval/rejection action buttons
+  - Perfect for AI-generated tasks, pull requests, purchase approvals
+
+- **`Container`** - Responsive container with max-width constraints
+  - Max widths: sm/md/lg/xl/full (640/768/1024/1280px or 100%)
+  - Responsive padding presets
+  - Auto-centering
+  - Polymorphic (renders as any HTML element via `as` prop)
+  - Semantic HTML support (div, section, article, main, aside, header, footer)
+
+- **`Grid`** - Declarative CSS Grid wrapper
+  - Auto-responsive with auto-fit/auto-fill
+  - Configurable columns (fixed or responsive)
+  - Gap controls (sm/md/lg/xl or custom)
+  - Separate row/column gap support
+  - Alignment controls (alignItems, justifyItems)
+  - Eliminates repetitive CSS Grid code
+
+### Improved
+- Updated component count from 36 to **41 components**
+- All tool enums updated to include new components
+- Enhanced framework completeness for rapid app development
+- Improved component discovery with new utility components
+
+### Documentation
+- All new components include comprehensive metadata
+- Complete prop documentation with TypeScript interfaces
+- Multiple usage examples for each component
+- Use cases and accessibility features documented
+- Component location information available via get_component_location tool
+
+### Developer Experience Impact
+These additions directly address findings from the Framework Audit (FRAMEWORK-AUDIT.md):
+- ✅ **SegmentedControl** - Replaced custom button groups in showcase apps
+- ✅ **Icon System** - Eliminated duplicated inline SVG across files
+- ✅ **ApprovalCard** - Extracted from ChatDemo as reusable framework component
+- ✅ **Container & Grid** - Added missing layout utilities for consistent spacing
+
+**Framework Completeness**: From 36 → 41 components, the design system now provides all essential building blocks for rapid application development without showcase-level code leaking into apps.
+
+## [2.1.0] - 2025-10-23
+
+### Added
+
+#### New Tools
+- **`get_component_location`** - Returns file location and import paths for components
+  - Essential for developers building NEW components that use existing design system components
+  - Provides verified import paths to eliminate guesswork
+  - Shows both package imports (`@lando-labs/design-system`) and relative imports (`../ComponentName`)
+  - Lists sub-components for composite components (Card, Tabs, Modal, etc.)
+  - Includes usage examples for both import methods
+  - **Addresses Chat MCP Gap #2**: Component import path verification
+
+- **`get_animation_examples`** - Provides ocean-themed animation code snippets
+  - 12 animation types: wave-dots, ripple, fade-in/out, slide-up/down/left/right, pulse, shimmer, bounce, spin
+  - Complete CSS keyframes for each animation
+  - Design token integration (`var(--duration-*)`, `var(--easing-wave)`)
+  - Timing recommendations and easing functions
+  - Use case documentation
+  - Accessibility guidance (prefers-reduced-motion)
+  - **Addresses Chat MCP Gap #4**: Animation code examples
+
+#### New Component
+- **Chat Component** (36th component added to MCP)
+  - Main `Chat` container component
+  - Sub-components: `ChatMessage`, `ChatInput`, `ChatThinkingIndicator`
+  - Complete metadata with props, examples, and documentation
+  - Full TypeScript type definitions
+  - Message type interface exported
+  - Accessibility features documented
+
+### Improved
+- Updated component count from 35 to **36 components**
+- Updated tool count from 7 to **9 tools**
+- Enhanced MCP developer experience rating from 8/10 to **9/10**
+
+### Documentation
+- Chat component fully documented in MCP metadata
+- Component location tool provides import path guidance
+- Animation examples include best practices and performance tips
+- All new tools include comprehensive TypeScript interfaces
+
+### Developer Experience Impact
+These additions directly address feedback from the Chat Component MCP Experience Report:
+- ⭐⭐⭐ **High Priority Gap #1** (Component Location): RESOLVED
+- ⭐⭐ **High Priority Gap #2** (Animation Examples): RESOLVED
+
+---
+
+## [2.0.0] - 2025-10-23
+
+### Added
+- **`list_components`** - List all 35 available components with descriptions and categories
+- **`get_design_tokens`** - Access to complete design token system
+  - Colors (ocean blues, teals, contextual)
+  - Spacing scale
+  - Typography system
+  - Border radius values
+  - Shadows
+  - Animation timings and easing functions
+  - Breakpoints
+
+### Improved
+- MCP developer experience rating improved from initial baseline to **8/10**
+- Component discovery made effortless
+- Design system integration streamlined
+
+---
+
+## [1.0.0] - Initial Release
+
+### Features
+- 35 production-ready components
+- 7 comprehensive tools:
+  - `get_component` - Generate component code
+  - `get_component_props` - View component props
+  - `get_component_docs` - Complete API reference
+  - `compose_components` - Compose multiple components
+  - `get_usage_example` - Real-world examples
+  - `list_components` - Component discovery
+  - `get_design_tokens` - Design token access
+
+### Components
+- Core Inputs (7): Button, Input, Textarea, Select, Checkbox, Radio, Switch
+- Feedback (6): Alert, Toast, Modal, Spinner, Skeleton, Progress
+- Data Display (7): Badge, Avatar, Card, Table, List, StatCard, TaskCard
+- Navigation (4): Breadcrumb, Pagination, Tabs, Dropdown
+- Layout (4): Header, Sidebar, Footer, Divider
+- Overlays (2): Popover, Tooltip
+- Interactive (2): Accordion, EmptyState
+- Documentation (3): CodeBlock, Markdown, ThemeBuilder
+
+### Architecture
+- TypeScript implementation with strict typing
+- Zod schemas for validation
+- Model Context Protocol (MCP) SDK integration
+- Stdio transport for Claude Desktop
+- Resource and prompt support