@vadimcomanescu/nadicode-design-system 4.0.1 → 4.0.3

package/.agents/skills/seed/SKILL.md

@@ -3,8 +3,8 @@ name: Seed Design System
 description: >
   Use when building UI with the Seed Design System or composing full pages from
   Seed components. Covers tokens, components, glass effects, animations,
-  dual-axis theming, page recipes, and Next.js App Router integration.
-tags: [seed, design-system, arctic-glow, react, tailwind, radix, glassmorphism, recipes]
+  dual-axis theming, page-kits, and Next.js App Router integration.
+tags: [seed, design-system, arctic-glow, react, tailwind, radix, glassmorphism, page-kits]
 ---
 
 # Seed Design System -- Agent Skill
@@ -44,55 +44,11 @@ const { LoginBlock, DashboardPageKit } = seedComponents
 
 **UI primitives** (Button, Heading, Input, etc.), icons, charts, and effects are imported via individual subpath exports. They are not registered in the catalog.
 
-See the full Import Rules in `contract.md`.
-
-The derived references under `references/components.md` and `references/blocks.md` are generated from the catalog. Any repo `Path` column there is a maintainer source path, not a consumer import path.
-
 ## Read Order
 
-1. **This file** -- router, quick references, forbidden patterns
-2. **`contract.md`** -- binary rules, package integration contract
-3. **catalog** (`@vadimcomanescu/nadicode-design-system/catalog`) -- machine-readable component metadata (variants, props, tiers)
-4. **`intent-map.md`** -- intent decision tree + recipe index
-6. **`recipes/<page-type>.md`** -- matching recipe for your page
-7. **`references/`** -- deep dives as needed
-8. **`references/brand-override.md`** -- palette-only brand customization guide for seeded apps
-
----
-
-## Intent Decision Tree
-
-What are you building? Follow the tree to find your recipe.
-
-```
-Does user have a session?
-  YES --> app-shell intents:
-         dashboard .......... recipes/dashboard.md
-         CRUD list/detail ... recipes/crud-list-detail.md
-         CRUD form .......... recipes/crud-form.md
-         settings ........... recipes/settings.md
-         analytics .......... recipes/analytics.md
-         agents/chat ........ recipes/agents-chat.md
-         navigation shell ... recipes/navigation-shell.md
-  NO  --> auth?
-            YES --> recipes/auth.md (auth-shell)
-          onboarding?
-            YES --> recipes/onboarding.md (onboarding-shell)
-          marketing intents (marketing-shell):
-            agency home ...... recipes/agency-home.md
-            landing .......... recipes/marketing-landing.md
-            digital workers .. recipes/digital-workers.md
-            service detail ... recipes/service-detail.md
-            pricing .......... recipes/pricing.md
-            blog/content ..... recipes/blog-content.md
-            about/team ....... recipes/company-about.md
-            contact .......... recipes/company-contact.md
-            checkout ......... recipes/checkout.md
-            marketing shell .. recipes/marketing-shell.md
-          error pages --> recipes/error-pages.md (fallback-shell)
-```
-
-Full intent-to-recipe mapping with shell selection: see `intent-map.md`.
+1. **This file** -- router, quick references, forbidden patterns, binary rules
+2. **catalog** (`@vadimcomanescu/nadicode-design-system/catalog`) -- machine-readable component metadata (variants, props, tiers)
+3. **`references/`** -- deep dives as needed
 
 ---
 
@@ -115,6 +71,28 @@ Full intent-to-recipe mapping with shell selection: see `intent-map.md`.
 | CSS hex in vars: `--color-bg: #0F1114` | `--color-background: 15 17 20` | CSS vars use space-separated RGB |
 | Block without `interface *Props` | `interface MyBlockProps { title?: string }` | Integrity test enforces |
 | Required content props | Optional with defaults in destructuring | Blocks render standalone |
+| Inline/floating labels | `Label` above control (stacked) | Form convention |
+| `text-[10px]`, `text-[11px]` | `text-xs`, `text-sm`, `Heading`, `Typography` | No arbitrary text sizes |
+| Ad-hoc `chat-*` classes | Compose Seed primitives + motion tokens | No custom chat classes |
+| `import { BarChart } from "recharts"` | `import { BarChart } from "@vadimcomanescu/nadicode-design-system/charts"` | No direct recharts |
+| Ad-hoc Card + value for KPIs | `MetricCard` | Use the DS component |
+| Hex/rgb in chart config | `var(--color-chart-N)` tokens | Chart colors are tokenized |
+| Generic English defaults | Override ALL default copy per brand | No shipping placeholder text |
+| Hardcoded hex in components | Map to semantic tokens | Brand colors via tokens only |
+
+---
+
+## Brand Customization
+
+Override all default copy. Map brand colors to semantic tokens. Verify contrast (WCAG AA: 4.5:1 body, 3:1 large). See `references/brand-override.md` for glass intensity presets.
+
+## Dashboard Rules
+
+KPI cards: `MetricCard`. Charts: empty-data guard required (`data.length > 0`). Chart colors: `var(--color-chart-N)` tokens. Import from `./charts`, never `recharts` directly. Sidebar navigation must include IA grouping with `SidebarGroupLabel`.
+
+## Admin Chat
+
+Chat features must include all three agentic layers: Conversation, Tooling, Traceability. See catalog for available components in each layer. Analytics must use Seed chart primitives.
 
 ---
 
@@ -134,7 +112,7 @@ Full intent-to-recipe mapping with shell selection: see `intent-map.md`.
 
 **Sidebar:** `sidebar`, `sidebar-foreground`, `sidebar-primary`, `sidebar-accent`, `sidebar-border`, `sidebar-ring`
 
-Full token tables with CSS variables and Radix scales: `references/tokens.md`
+Token source of truth: `src/lib/tokens.config.js` (authored), `src/index.css` (generated).
 
 ---
 
@@ -225,13 +203,7 @@ import { motionSpring, fadeInUp, blockStagger } from "@/lib/motion"
 
 ### Spring Presets
 
-| Name | Stiffness | Damping | Mass | Use For |
-|------|-----------|---------|------|---------|
-| `snappy` | 400 | 28 | 0.8 | Micro-interactions, tooltips |
-| `gentle` | 200 | 20 | 1.0 | Page transitions, drawers |
-| `bouncy` | 300 | 14 | 0.8 | Celebration, completion |
-| `dramatic` | 500 | 24 | 1.2 | Hero entrances |
-| `wobbly` | bloom only | | | Extra bounce |
+`snappy` (micro-interactions), `gentle` (page transitions), `bouncy` (celebration), `dramatic` (hero entrances), `wobbly` (bloom only). Full values: `references/animation.md`.
 
 ### Duration Tokens
 
@@ -269,19 +241,7 @@ import { SettingsIcon, BellIcon } from "@vadimcomanescu/nadicode-design-system/i
 
 **Total: 399 icons.** Before adding a new icon, check whether it already exports from `@vadimcomanescu/nadicode-design-system/icons` or a matching `@vadimcomanescu/nadicode-design-system/icons/<name>` subpath.
 
-### Adding a New Icon
-
-1. **Check if it exists** (399 total -- likely yes).
-2. **If missing:** add it to `lucide-wrapped.tsx` using `createAnimatedIcon`:
-   ```tsx
-   import { Home } from "lucide-react"
-   export const HomeIcon = createAnimatedIcon(Home, "HomeIcon")
-   ```
-3. **If the needed icon is missing**, stop and request an upstream DS export. Do not hand-craft a local scaffold copy just to bypass the package contract.
-
-`createAnimatedIcon` is also exported for consumers to wrap any Lucide icon ad-hoc without adding it to the catalog.
-
-Full catalog: `references/icons.md`
+If an icon is missing, add it to `lucide-wrapped.tsx` via `createAnimatedIcon`. Do not hand-craft local copies to bypass the package contract.
 
 ---
 
@@ -330,6 +290,8 @@ Every page = **Shell > Sections > Components**.
 - 2-8 sections (vertical bands, no nesting)
 - 1-6 components per section via CSS grid/flex
 
+Page-kits in the catalog ARE the ready-made compositions. Use `seedComponents.<Name>PageKit` from `@vadimcomanescu/nadicode-design-system/catalog/components` rather than assembling pages by hand.
+
 ### Shell Selection
 
 | Intent | Shell | Components |
@@ -342,68 +304,9 @@ Every page = **Shell > Sections > Components**.
 
 Content widths, vertical rhythm, responsive contracts: `references/composition.md`
 
-### Kanban Board (Drag & Drop)
-
-Compound component for multi-column sortable boards (project boards, runs views, pipelines).
-
-```tsx
-import { seedComponents } from "@vadimcomanescu/nadicode-design-system/catalog/components"
-const { KanbanBoard: kanban } = seedComponents
-const { KanbanBoard, KanbanColumn, KanbanColumnHeader, KanbanItem, KanbanHandle } = kanban
-import type { KanbanColumnState, KanbanMoveMeta } from '@vadimcomanescu/nadicode-design-system/kanban-board'
-```
-
-**Architecture:** `@dnd-kit/core` + `@dnd-kit/sortable` internally. Consumer API is Seed-owned (no dnd-kit types leak).
+### Kanban Board
 
-**Usage:**
-
-```tsx
-type Task = { id: string; title: string }
-
-const [columns, setColumns] = useState<KanbanColumnState<Task>[]>([
-  { id: 'todo', items: [{ id: '1', title: 'Task A' }] },
-  { id: 'done', items: [] },
-])
-
-<KanbanBoard
-  value={columns}
-  onValueChange={(next, meta) => {
-    setColumns([...next])
-    // meta: { item, itemId, fromColumnId, toColumnId, fromIndex, toIndex }
-  }}
-  getItemId={(task) => task.id}
-  getItemLabel={(task) => task.title}
-  canMove={({ fromColumnId, toColumnId }) => isAllowed(fromColumnId, toColumnId)}
-  renderOverlay={(task) => <MyCard task={task} />}
->
-  {columns.map((col) => (
-    <KanbanColumn key={col.id} id={col.id} items={col.items} aria-label={col.name}>
-      <KanbanColumnHeader>{col.name} <Badge variant="outline">{col.items.length}</Badge></KanbanColumnHeader>
-      {col.items.map((task) => (
-        <KanbanItem key={task.id} value={task}>
-          <KanbanHandle aria-label={`Move ${task.title}`} />
-          <MyCard task={task} />
-        </KanbanItem>
-      ))}
-    </KanbanColumn>
-  ))}
-</KanbanBoard>
-```
-
-**Key props:**
-
-| Prop | Required | Purpose |
-|------|----------|---------|
-| `value` | Yes | `KanbanColumnState<T>[]` -- controlled column state |
-| `onValueChange` | Yes | `(next, meta) => void` -- fires with new state + move metadata |
-| `getItemId` | Yes | Extract stable ID from item |
-| `getItemLabel` | No | Human label for screen reader announcements |
-| `canMove` | No | Constraint callback to reject moves |
-| `renderOverlay` | No | Custom drag ghost (renders inside `glass-floating`) |
-| `activationDistance` | No | Px before drag starts (default: 5) |
-| `items` on Column | Yes | Pass the column's items array for SortableContext |
-
-**Card content is consumer-owned.** The DS provides the board structure, drag mechanics, glass styling, and accessibility. Compose card interiors from existing DS primitives: `Badge`, `StatusDot`, `Typography`, `Button`, `Avatar`.
+Compound component via `seedComponents`. Uses `@dnd-kit` internally (no dnd-kit types leak). Card content is consumer-owned. See catalog entry for full props and sub-components. Types: `@vadimcomanescu/nadicode-design-system/kanban-board`.
 
 ---
 
@@ -416,46 +319,14 @@ Patterns: `references/state-machines.md`
 
 ---
 
-## Recipe Index
-
-| Intent | Recipe | Shell |
-|--------|--------|-------|
-| Dashboard | `recipes/dashboard.md` | app-shell |
-| Marketing Landing | `recipes/marketing-landing.md` | marketing-shell |
-| Agency Home | `recipes/agency-home.md` | marketing-shell |
-| Digital Workers | `recipes/digital-workers.md` | marketing-shell |
-| Service Detail | `recipes/service-detail.md` | marketing-shell |
-| CRUD List + Detail | `recipes/crud-list-detail.md` | app-shell |
-| CRUD Form | `recipes/crud-form.md` | app-shell |
-| Settings | `recipes/settings.md` | app-shell |
-| Auth | `recipes/auth.md` | auth-shell |
-| Onboarding | `recipes/onboarding.md` | onboarding-shell |
-| Pricing | `recipes/pricing.md` | marketing-shell |
-| Analytics | `recipes/analytics.md` | app-shell |
-| Agent Chat | `recipes/agents-chat.md` | app-shell |
-| Error Pages | `recipes/error-pages.md` | fallback-shell |
-| Navigation Shell | `recipes/navigation-shell.md` | app-shell |
-| Blog / Content | `recipes/blog-content.md` | marketing-shell |
-| Company About | `recipes/company-about.md` | marketing-shell |
-| Company Contact | `recipes/company-contact.md` | marketing-shell |
-| Marketing Shell | `recipes/marketing-shell.md` | marketing-shell |
-| Checkout | `recipes/checkout.md` | marketing-shell |
-
----
-
 ## Reference Index
 
 | File | Contents |
 |------|----------|
-| `references/tokens.md` | Radix scales, semantic token map, CSS variables, bloom palette |
-| `references/components.md` | All UI components with tiers inline, Radix primitives, agentic UI |
 | `references/patterns.md` | Golden pattern + 4 code examples: Button, Input, Dialog, LoginBlock |
 | `references/animation.md` | Springs, easings, durations, stagger, choreography, reduced motion |
 | `references/glass-and-effects.md` | Glass tier CSS, decorative components, text effects, shaders |
-| `references/blocks.md` | Blocks by domain with import paths |
-| `references/icons.md` | Animated icon usage patterns |
 | `references/opinions.md` | Decision tables from Opinions Bible |
-| `references/nextjs.md` | App Router setup, providers, SSR boundaries, showcase |
 | `references/composition.md` | Layout algebra, spacing, grid patterns, content widths |
 | `references/responsive.md` | Breakpoint contracts, mobile-first, touch targets |
 | `references/state-machines.md` | State machines, loading tiers, streaming, error handling |

package/.agents/skills/seed/references/animation.md

@@ -90,7 +90,7 @@ What is the element?
 
 ## Storyboard Format
 
-Every recipe includes an animation storyboard:
+Animation storyboard format (use when documenting page-kit entrance sequences):
 
 ```
 ANIMATION STORYBOARD
@@ -254,7 +254,7 @@ When `prefers-reduced-motion` is active:
 - ScrollFadeIn elements visible immediately
 - Continuous animations (aurora, shimmer, meteor) paused via CSS
 
-Every recipe storyboard includes a `REDUCED` line specifying fallback behavior.
+Every storyboard includes a `REDUCED` line specifying fallback behavior when `prefers-reduced-motion` is active.
 
 ---
 

package/.agents/skills/seed/references/responsive.md

@@ -17,7 +17,7 @@ Breakpoint contracts, mobile-first patterns, touch targets, and responsive rules
 
 **Design priority**: Mobile-first. Default styles target mobile, add complexity at breakpoints.
 
-**Primary breakpoints** (used in recipes): default, `sm:`, `lg:`, `xl:`. Use `md:` and `2xl:` sparingly.
+**Primary breakpoints**: default, `sm:`, `lg:`, `xl:`. Use `md:` and `2xl:` sparingly.
 
 ---
 

package/README.md

@@ -15,12 +15,13 @@ The dev server runs on `http://localhost:5001` and serves the showcase routes un
 
 Consumer apps install Seed through an exact released package version. For unpublished local work, stage a tarball under `.nadicode/packages/` and install that committed relative artifact instead. Do not point apps at a live DS repo directory.
 
+Component discovery and consumption go through the catalog. Blocks and page-kits have no individual subpath exports.
+
 Canonical consumer docs:
 
 - [docs/nadicode/SCAFFOLDING_PROCESS.md](docs/nadicode/SCAFFOLDING_PROCESS.md), normative runtime and ownership contract
 - [docs/nadicode/ADOPTION_PLAYBOOK.md](docs/nadicode/ADOPTION_PLAYBOOK.md), step-by-step install and wiring flow
 - [.agents/skills/seed/SKILL.md](.agents/skills/seed/SKILL.md), synced agent-facing usage guide
-- [.agents/skills/seed/contract.md](.agents/skills/seed/contract.md), synced binary consumer rules
 
 ## Canonical Sources
 
@@ -31,7 +32,6 @@ The repo treats structured truth and prose differently.
 - Public package surface lives in `package.json` exports, `src/catalog/catalog.ts`, and `bin/shipped-files.json`.
 - Consumer ownership and package-backed runtime rules live in [docs/nadicode/SCAFFOLDING_PROCESS.md](docs/nadicode/SCAFFOLDING_PROCESS.md).
 - Release steps live in [docs/releasing-package.md](docs/releasing-package.md).
-- Component metadata lives in `dist/catalog/catalog.js`, generated from `src/catalog/catalog.ts`.
 
 Use prose docs for guidance and rationale. Use scripts, manifests, and generated artifacts for anything that must stay machine-accurate.
 

package/eslint-rules/nadicode/config.js

@@ -15,7 +15,6 @@ export const nadicodeRules = {
   "nadicode/no-admin-manual-chart-bars": "error",
   "nadicode/no-app-primitive-composition": "error",
   "nadicode/no-barrel-imports": "error",
-  "nadicode/no-deprecated-ds-import": "warn",
   "nadicode/no-derived-state-via-useeffect": "error",
   "nadicode/no-direct-lucide-import": "error",
   "nadicode/no-external-ui-library": "error",

package/eslint-rules/nadicode/index.js

@@ -3,7 +3,6 @@ import noAdminManualChartBars from "./rules/no-admin-manual-chart-bars.js";
 import noAppPrimitiveComposition from "./rules/no-app-primitive-composition.js";
 import noArbitraryChartColor from "./rules/no-arbitrary-chart-color.js";
 import noBarrelImports from "./rules/no-barrel-imports.js";
-import noDeprecatedDsImport from "./rules/no-deprecated-ds-import.js";
 import noDeprecatedSegmentConfig from "./rules/no-deprecated-segment-config.js";
 import noDerivedStateViaUseeffect from "./rules/no-derived-state-via-useeffect.js";
 import noDirectLucideImport from "./rules/no-direct-lucide-import.js";
@@ -81,7 +80,6 @@ export const nadicodePlugin = {
     "no-app-primitive-composition": noAppPrimitiveComposition,
     "no-arbitrary-chart-color": noArbitraryChartColor,
     "no-barrel-imports": noBarrelImports,
-    "no-deprecated-ds-import": noDeprecatedDsImport,
     "no-deprecated-segment-config": noDeprecatedSegmentConfig,
     "no-derived-state-via-useeffect": noDerivedStateViaUseeffect,
     "no-direct-lucide-import": noDirectLucideImport,

package/eslint-rules/nadicode/rules/no-has-svg-selector.js

@@ -19,7 +19,7 @@ function reportMatches(context, node, tokens) {
       context.report({
         node,
         message:
-          "Selector '{{sel}}' breaks with animated icon wrappers. Use a data-slot sub-component instead (see golden-pattern.md).",
+          "Selector '{{sel}}' breaks with animated icon wrappers. Use a data-slot sub-component instead (see references/patterns.md).",
         data: { sel: hit },
       });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vadimcomanescu/nadicode-design-system",
-  "version": "4.0.1",
+  "version": "4.0.3",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
@@ -49,7 +49,6 @@
     "release-governance:baseline": "node scripts/generate-release-governance-baseline.mjs",
     "release-governance:validate": "node scripts/validate-release-governance.mjs",
     "ds:task-pack": "node scripts/ds-generate-task-pack.mjs",
-    "docs:api": "node scripts/docs-generate-api.mjs",
     "docs:check": "node scripts/docs-check.mjs",
     "docs:inventory": "node scripts/docs-inventory.mjs",
     "release:check": "npm run contracts:check && npm run docs:check && npm run test:all",

package/scripts/ds-check.mjs

@@ -625,16 +625,6 @@ function checkSeedSkillContract() {
     "seed-skill-missing",
     ".agents/skills/seed/SKILL.md must exist so agents know how to use the design system.",
   );
-  expectFile(
-    [join(root, ".agents", "skills", "seed", "contract.md")],
-    "seed-skill-contract-missing",
-    ".agents/skills/seed/contract.md must exist so agents know the DS rules.",
-  );
-  expectFile(
-    [join(root, ".agents", "skills", "seed", "intent-map.md")],
-    "seed-skill-intent-map-missing",
-    ".agents/skills/seed/intent-map.md must exist so agents can map intents to recipes.",
-  );
 }
 
 function checkForbiddenDuplicatedDocs() {

package/scripts/ds-update.mjs

@@ -10,6 +10,10 @@ function run(command) {
   execSync(command, { cwd: process.cwd(), stdio: "inherit" });
 }
 
+function runCapture(command) {
+  return execSync(command, { cwd: process.cwd(), encoding: "utf8" }).trim();
+}
+
 function readPackageJson() {
   const packageJsonPath = join(process.cwd(), "package.json");
   if (!existsSync(packageJsonPath)) {
@@ -23,28 +27,62 @@ function readSeedDependency() {
   const packageJson = readPackageJson();
   const dependency = packageJson.dependencies?.[PACKAGE_NAME];
   if (dependency) {
-    return { spec: dependency, isDevDependency: false };
+    return { currentSpec: dependency, isDevDependency: false };
   }
 
   const devDependency = packageJson.devDependencies?.[PACKAGE_NAME];
   if (devDependency) {
-    return { spec: devDependency, isDevDependency: true };
+    return { currentSpec: devDependency, isDevDependency: true };
   }
 
   throw new Error("package.json must declare @vadimcomanescu/nadicode-design-system before ds:update can run.");
 }
 
-const { spec, isDevDependency } = readSeedDependency();
-const installTarget = `${PACKAGE_NAME}@${spec}`;
-const packageManagerCommand = existsSync(join(process.cwd(), "pnpm-lock.yaml"))
-  ? `pnpm add ${isDevDependency ? "-D " : ""}${JSON.stringify(installTarget)}`
-  : existsSync(join(process.cwd(), "yarn.lock"))
-    ? `yarn add ${isDevDependency ? "--dev " : ""}${JSON.stringify(installTarget)}`
-    : existsSync(join(process.cwd(), "bun.lock"))
-      ? `bun add ${isDevDependency ? "-d " : ""}${JSON.stringify(installTarget)}`
-      : `npm install ${isDevDependency ? "-D " : ""}${JSON.stringify(installTarget)}`;
+function fetchLatestVersion() {
+  try {
+    return runCapture(`npm view ${PACKAGE_NAME} version`);
+  } catch {
+    throw new Error(`Failed to fetch latest version of ${PACKAGE_NAME} from the registry.`);
+  }
+}
+
+function detectPackageManager() {
+  if (existsSync(join(process.cwd(), "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(join(process.cwd(), "yarn.lock"))) return "yarn";
+  if (existsSync(join(process.cwd(), "bun.lock"))) return "bun";
+  return "npm";
+}
+
+function buildInstallCommand(pm, target, isDevDependency) {
+  const devFlag = {
+    pnpm: isDevDependency ? "-D " : "",
+    yarn: isDevDependency ? "--dev " : "",
+    bun: isDevDependency ? "-d " : "",
+    npm: isDevDependency ? "-D " : "",
+  };
+
+  const command = {
+    pnpm: "pnpm add --save-exact",
+    yarn: "yarn add --exact",
+    bun: "bun add --exact",
+    npm: "npm install --save-exact",
+  };
+
+  return `${command[pm]} ${devFlag[pm]}${JSON.stringify(target)}`;
+}
+
+const { currentSpec, isDevDependency } = readSeedDependency();
+const latestVersion = fetchLatestVersion();
+const installTarget = `${PACKAGE_NAME}@${latestVersion}`;
+const pm = detectPackageManager();
+
+if (currentSpec === latestVersion) {
+  console.log(`Already on latest version (${latestVersion}). Syncing skill docs.`);
+} else {
+  console.log(`Updating ${PACKAGE_NAME}: ${currentSpec} -> ${latestVersion}`);
+  run(buildInstallCommand(pm, installTarget, isDevDependency));
+}
 
-run(packageManagerCommand);
-run(`node ${JSON.stringify(join(process.cwd(), "node_modules", "@vadimcomanescu/nadicode-design-system", "scripts", "sync-seed-skill.mjs"))} ${JSON.stringify(process.cwd())}`);
+run(`node ${JSON.stringify(join(process.cwd(), "node_modules", PACKAGE_NAME, "scripts", "sync-seed-skill.mjs"))} ${JSON.stringify(process.cwd())}`);
 
-console.log("Done. Run npm run ds:check to verify.");
+console.log(`Done (${latestVersion}). Run npm run ds:check to verify.`);

package/scripts/sync-seed-skill.mjs

@@ -16,9 +16,6 @@ const targetRoot = resolve(targetArg);
 const targetDir = join(targetRoot, ".agents", "skills", "seed");
 const syncedPaths = [
   "SKILL.md",
-  "contract.md",
-  "intent-map.md",
-  "recipes",
   "references",
 ];
 

package/.agents/skills/seed/contract.md

@@ -1,110 +0,0 @@
-# Seed Contract
-
-Binary rules for consumer apps using the Seed Design System. Every rule is non-negotiable.
-
-## Scope
-
-- Apply only to the explicit migration scope you were given.
-- Do not edit files outside scope unless the build is blocked by a required wiring step.
-
-## Component Catalog
-
-The catalog is the single starting point for component discovery. Read it via the `./catalog` subpath export for the authoritative list of components, variant names, props, and tiers. Get actual React components from `./catalog/components`. Verify component names and variant values against the catalog. Do not guess variant names or prop values.
-
-```ts
-// Discovery (server-safe)
-import { seedComponentDefinitions } from "@vadimcomanescu/nadicode-design-system/catalog"
-
-// Components (client)
-import { seedComponents } from "@vadimcomanescu/nadicode-design-system/catalog/components"
-```
-
-## Import Rules
-
-1. **Blocks and page-kits**: import from `seedComponents` via `@vadimcomanescu/nadicode-design-system/catalog/components`. No individual subpath imports for blocks or page-kits.
-   ```ts
-   import { seedComponents } from "@vadimcomanescu/nadicode-design-system/catalog/components"
-   const { LoginBlock, DashboardPageKit } = seedComponents
-   ```
-2. **UI primitives, charts, effects, text-effects**: import via individual subpath exports (e.g., `@vadimcomanescu/nadicode-design-system/button`, `@vadimcomanescu/nadicode-design-system/charts`). These are not in the catalog.
-3. **Icons**: import from `@vadimcomanescu/nadicode-design-system/icons` or the matching `@vadimcomanescu/nadicode-design-system/icons/<name>` subpath. Never import from `lucide-react` directly.
-4. **Infrastructure** (tokens.css, tailwind preset, eslint-plugin, theme-provider, messages, test, lib/*): import via subpath exports. These are configuration wiring, not component consumption.
-5. Do not vendor or recreate DS runtime files inside the scaffold. If a needed primitive is missing, stop and report it. Do not invent ad-hoc replacements.
-
-## Token Rules
-
-4. Semantic tokens only (`bg-background`, `bg-surface`, `text-text-primary`, `border-border`, etc.).
-5. Never use raw Tailwind palette classes (`bg-zinc-900`, `text-gray-500`).
-6. Never use `text-foreground`, `text-muted-foreground`, or `border-error`.
-7. Never use `bg-black/80` for overlays. Use `bg-overlay/80`.
-
-## Container Rules
-
-8. Use glass tiers for containers: `.glass-panel`, `.glass-floating`, or `.glass-overlay`.
-
-## Form Rules
-
-9. Stacked labels only (`Label` above control). Never inline or floating labels.
-
-## Admin UI Rules
-
-10. No arbitrary text sizes (`text-[10px]`, `text-[11px]`). Use `Heading`, `Typography`, or the standard Tailwind scale (`text-xs`, `text-sm`).
-11. No ad-hoc `chat-*` classes. Conversation UIs must compose existing Seed primitives and motion tokens.
-12. Admin chat features must include all three agentic layers:
-    - Conversation: `Conversation`, `ChatMessage`, `ChatResponse`, `ChatGreeting`, `ChatThinkingMessage`, `ChatShimmer`, `ConversationThread`, or `AgentMessageBubble`
-    - Tooling: `ChatToolCall`, `ChatPromptInput`, `ChatActions`, `ChatSuggestion`, `ToolCallCard`, or `ThinkingIndicator`
-    - Traceability: `ChatReasoning`, `ChatChainOfThought`, `ChatSources`, `ChatPlan`, `ChatQueue`, `ChatConfirmation`, `ChatBranch`, `SourceCitation`, `AgentTimeline`, `WorkflowGraph`, or `HandoffIndicator`
-13. Admin sidebar navigation must include IA grouping with `SidebarGroupLabel`. No flat unlabeled menus.
-14. Admin analytics must use Seed chart primitives (`AreaChart`, `BarChart`, `LineChart`, `PieChart`, `ChartContainer`). No pseudo-charts from raw `<div>` bars.
-## Page Composition
-
-16. Page architecture MUST match a `page_intent` from `intent-map.md`.
-17. If an intent is missing from the catalog, stop and report it. Do not improvise.
-18. Routes without a mapped intent + recipe are invalid.
-
-## Brand Customization Rules
-
-19. Always override ALL default copy. Never ship generic English defaults from block components.
-20. Always map brand colors to semantic tokens. Never hardcode hex values in components.
-21. Always verify contrast ratios after color override (WCAG AA: 4.5:1 body, 3:1 large text).
-22. Glass intensity must match brand personality. See `references/brand-override.md` for presets.
-23. Always update `src/site.config.ts` (name, description, tagline, nav) before building pages.
-
-## Dashboard Rules
-
-24. Dashboard KPI cards must use `MetricCard`, not ad-hoc Card + value compositions.
-25. Chart components must not be rendered without an empty-data guard (`data.length > 0` or `ChartCard`).
-26. Chart color configs must use `var(--color-chart-N)` tokens, never hex/rgb/hsl literals.
-27. Import chart primitives from `@vadimcomanescu/nadicode-design-system/charts` or the matching `@vadimcomanescu/nadicode-design-system/charts/<chart-name>` subpath (charts are UI primitives, not catalog items). Do not import `recharts` directly into scaffold app code.
-
-## ESLint Rule Reference
-
-These rules are enforced at lint time (Layer 1):
-
-| Rule | Severity | What it catches |
-|------|----------|-----------------|
-| `nadicode/no-raw-recharts-import` | error | Direct `recharts` imports outside chart wrappers |
-| `nadicode/require-chart-empty-handler` | error | Chart rendered without data-length guard |
-| `nadicode/no-arbitrary-chart-color` | error | Hex/rgb/hsl in chart config instead of tokens |
-| `nadicode/require-dashboard-loading-skeleton` | warn | Dashboard routes missing Skeleton import |
-| `nadicode/require-stagger-on-metric-grid` | warn | 3+ MetricCard grid without StaggerChildren |
-
-## i18n Test Mocking
-
-The consumer app owns `next-intl` setup, including `src/i18n/request.ts`, locale routing, `NextIntlClientProvider`, `timeZone`, and `now`. Seed only supplies DS message catalogs plus merge helpers.
-
-Consumer tests that render Seed components using `useTranslations` must provide merged messages. Use `mergeSeedMessages()` from `@vadimcomanescu/nadicode-design-system/lib/merge-messages` in `src/i18n/request.ts` to combine package-backed DS catalogs such as `@vadimcomanescu/nadicode-design-system/messages/<locale>` with `messages/<locale>.json` (consumer keys) and pass the result to your test's `NextIntlClientProvider`.
-When a test only needs the Seed theme/provider wrapper, import `SeedTestProvider` from `@vadimcomanescu/nadicode-design-system/test`. The showcase app may keep using `@/test/SeedTestProvider` for in-repo tests.
-Do not copy DS catalog files into the app.
-
-## Done Criteria
-
-All of these must pass before a task is complete:
-
-```bash
-npx tsc --noEmit
-npm run build
-npm run lint
-npm run test
-npm run ds:check
-```