@vadimcomanescu/nadicode-design-system 2.0.6 → 2.0.8

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

@@ -20,23 +20,32 @@ Consumer scaffold contract: brand customization stays palette-only unless the ta
 
 ## Component Discovery
 
-For exact component names, variant values, props, and tiers, read the machine-readable catalog:
+Start with the shipped machine-readable consumer contract:
+
+```
+cat node_modules/@vadimcomanescu/nadicode-design-system/contracts/consumer-contract.json
+```
+
+Then follow `entrypoints.machineReadable.catalog` to the generated catalog for exact component names, variant values, props, and tiers:
 
 ```
 cat node_modules/@vadimcomanescu/nadicode-design-system/dist/catalog.json
 ```
 
-The catalog is auto-generated from source and always accurate. Use exact variant names from the catalog. Do not guess.
+The consumer contract is the machine entrypoint. The catalog is the component metadata surface. Both are auto-generated from source. Do not guess.
+
+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. Consumer code must keep importing from `@vadimcomanescu/nadicode-design-system/*` subpaths.
 
 ## Read Order
 
 1. **This file** -- router, quick references, forbidden patterns
 2. **`contract.md`** -- binary rules, package integration contract
-3. **catalog.json** (in dist/) -- machine-readable component metadata (variants, props, tiers)
-4. **`intent-map.md`** -- intent decision tree + recipe index
-5. **`recipes/<page-type>.md`** -- matching recipe for your page
-6. **`references/`** -- deep dives as needed
-7. **`references/brand-override.md`** -- palette-only brand customization guide for seeded apps
+3. **consumer-contract.json** -- machine-readable package, ownership, and contract entrypoint map
+4. **catalog.json** (in dist/) -- machine-readable component metadata (variants, props, tiers)
+5. **`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
 
 ---
 
@@ -108,7 +117,7 @@ Full intent-to-recipe mapping with shell selection: see `intent-map.md`.
 
 **Borders:** `border-border`, `border-border-hover`, `border-border-subtle`, `border-destructive`
 
-**Interactive:** `bg-primary` (gray.12), `bg-secondary`, `bg-accent` (teal), `ring-accent` (focus)
+**Interactive:** `bg-primary`, `bg-secondary`, `bg-accent`, `ring-focus-ring` (default focus), `ring-accent` (selection/emphasis)
 
 **Charts:** `chart-1` (teal), `chart-2` (blue), `chart-3` (amber), `chart-4` (green), `chart-5` (violet), `chart-6` (red)
 

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

@@ -9,7 +9,8 @@ Binary rules for consumer apps using the Seed Design System. Every rule is non-n
 
 ## Component Catalog
 
-Read catalog.json (shipped in the package under dist/) for the authoritative list of components, variant names, props, and tiers. Verify component names and variant values against the catalog. Do not guess variant names or prop values.
+Start with `consumer-contract.json` (shipped in the package under `contracts/`) for the machine-readable entrypoint map and ownership rules. Then read catalog.json (shipped in the package under dist/) for the authoritative list of components, variant names, props, and tiers. Verify component names and variant values against the catalog. Do not guess variant names or prop values.
+Registry digest: `sha256:8d4c41b59ad4154a0e8af35ca1c79510dc42379c2fb5100b0fa7fcd22b12fea3`
 
 ## Import Rules
 
@@ -37,9 +38,9 @@ Read catalog.json (shipped in the package under dist/) for the authoritative lis
 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: `ConversationThread` or `AgentMessageBubble`
-    - Tooling: `ToolCallCard` or `ThinkingIndicator`
-    - Traceability: `SourceCitation`, `AgentTimeline`, `WorkflowGraph`, or `HandoffIndicator`
+    - 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

package/.agents/skills/seed/intent-map.md

@@ -160,10 +160,10 @@ For each intent: **Required** components must be present, **Allowed** may be use
 
 | Classification | Values |
 |----------------|--------|
-| Routes | `/agents`, `/voice-agents` |
+| Routes | `/agents`, `/voice-agents`, `/chat` |
 | Shell | app-shell |
-| Required | AgentTeamPanel, AgentStatus, AgentMessageBubble, ThinkingIndicator, ToolCallCard, ApprovalCard, CodeDiffViewer, ArtifactCard, AgentTerminal, ContextMeter, Tabs, Textarea, Button, ScrollArea, Sheet |
-| Allowed | ConversationThread, AgentTimeline, AgentMetricsCard, WorkflowGraph, HandoffIndicator, MemoryInspector, SourceCitation, StreamingText, Badge, Avatar, AgentAvatar, Resizable |
+| Required | Conversation, ChatMessage, ChatResponse, ChatPromptInput, ChatToolCall, ChatActions, ChatGreeting, ChatThinkingMessage, ChatShimmer, ChatReasoning, ChatConfirmation, ChatSuggestion, ChatSources, ChatBranch, ChatChainOfThought, ChatPlan, ChatQueue, ChatPromptInputAttachments, AgentTeamPanel, AgentStatus, AgentMessageBubble, ThinkingIndicator, ToolCallCard, ApprovalCard, CodeDiffViewer, ArtifactCard, AgentTerminal, ContextMeter, Tabs, Button, ScrollArea, Sheet |
+| Allowed | ConversationThread, AgentTimeline, AgentMetricsCard, WorkflowGraph, HandoffIndicator, MemoryInspector, SourceCitation, StreamingText, Badge, Avatar, AgentAvatar, Resizable, Textarea |
 | Forbidden | HeroBlock, PricingBlock, FormWizard, DataTable, AuroraEffect, MeteorShower |
 | Blocks | AgentConversationBlock, ChatLayout |
 | States | empty, loading, running, thinking, blocked-approval, failed, complete |

package/.agents/skills/seed/recipes/agents-chat.md

@@ -182,28 +182,52 @@ REDUCED MOTION: Items appear instantly, no slide/scale
 
 ## Required Components
 
+### Chat Primitives (preferred)
+
+| Component | Import Path | Purpose |
+|-----------|-------------|---------|
+| `Conversation` | `.../conversation` | Scroll-aware container with auto-scroll |
+| `ChatMessage` | `.../chat-message` | Core message with avatar, content, actions |
+| `ChatResponse` | `.../chat-response` | Streaming markdown response renderer |
+| `ChatPromptInput` | `.../chat-prompt-input` | Chat text input with keyboard handling |
+| `ChatToolCall` | `.../chat-tool-call` | Tool call lifecycle wrapper |
+| `ChatActions` | `.../chat-actions` | Copy, retry, edit action buttons |
+| `ChatGreeting` | `.../chat-greeting` | Welcome greeting for sessions |
+| `ChatThinkingMessage` | `.../chat-thinking-message` | Animated thinking state |
+| `ChatShimmer` | `.../chat-shimmer` | Loading shimmer placeholder |
+| `ChatReasoning` | `.../chat-reasoning` | AI reasoning with auto-close |
+| `ChatConfirmation` | `.../chat-confirmation` | Action confirmation dialog |
+| `ChatSuggestion` | `.../chat-suggestion` | Follow-up prompt chips |
+| `ChatSources` | `.../chat-sources` | Source citations panel |
+| `ChatBranch` | `.../chat-branch` | Conversation fork navigation |
+| `ChatChainOfThought` | `.../chat-chain-of-thought` | Step-by-step reasoning |
+| `ChatPlan` | `.../chat-plan` | Collapsible plan card |
+| `ChatQueue` | `.../chat-queue` | Task queue with sections |
+| `ChatPromptInputAttachments` | `.../chat-prompt-input-attachments` | File attachment support |
+
+### Agent-Level Components
+
 | Component | Import Path | Purpose |
 |-----------|-------------|---------|
-| `AgentTeamPanel` | `@vadimcomanescu/nadicode-design-system/agent-team-panel` | Team member list |
-| `AgentStatus` | `@vadimcomanescu/nadicode-design-system/agent-status` | Connection status |
-| `AgentTimeline` | `@vadimcomanescu/nadicode-design-system/agent-timeline` | Action timeline |
-| `AgentMetricsCard` | `@vadimcomanescu/nadicode-design-system/agent-metrics-card` | Run metrics |
-| `ConversationThread` | `@vadimcomanescu/nadicode-design-system/conversation-thread` | Message rendering |
-| `AgentMessageBubble` | `@vadimcomanescu/nadicode-design-system/agent-message-bubble` | Individual messages |
-| `ThinkingIndicator` | `@vadimcomanescu/nadicode-design-system/thinking-indicator` | Processing state |
-| `ToolCallCard` | `@vadimcomanescu/nadicode-design-system/tool-call-card` | Tool invocations |
-| `ApprovalCard` | `@vadimcomanescu/nadicode-design-system/approval-card` | Human approval flow |
-| `CodeDiffViewer` | `@vadimcomanescu/nadicode-design-system/code-diff-viewer` | Code changes |
-| `ArtifactCard` | `@vadimcomanescu/nadicode-design-system/artifact-card` | Generated outputs |
-| `AgentTerminal` | `@vadimcomanescu/nadicode-design-system/agent-terminal` | Command output |
-| `WorkflowGraph` | `@vadimcomanescu/nadicode-design-system/workflow-graph` | DAG execution flow |
-| `ContextMeter` | `@vadimcomanescu/nadicode-design-system/context-meter` | Context window usage |
-| `SourceCitation` | `@vadimcomanescu/nadicode-design-system/source-citation` | Referenced sources |
-| `Tabs` | `@vadimcomanescu/nadicode-design-system/tabs` | Work panel tabs |
-| `Textarea` | `@vadimcomanescu/nadicode-design-system/textarea` | Composer input |
-| `Button` | `@vadimcomanescu/nadicode-design-system/button` | Send, panel triggers |
-| `ScrollArea` | `@vadimcomanescu/nadicode-design-system/scroll-area` | Scrollable regions |
-| `Sheet` | `@vadimcomanescu/nadicode-design-system/sheet` | Mobile panel drawers |
+| `AgentTeamPanel` | `.../agent-team-panel` | Team member list |
+| `AgentStatus` | `.../agent-status` | Connection status |
+| `AgentTimeline` | `.../agent-timeline` | Action timeline |
+| `AgentMetricsCard` | `.../agent-metrics-card` | Run metrics |
+| `ConversationThread` | `.../conversation-thread` | Legacy message rendering |
+| `AgentMessageBubble` | `.../agent-message-bubble` | Individual messages |
+| `ThinkingIndicator` | `.../thinking-indicator` | Processing state |
+| `ToolCallCard` | `.../tool-call-card` | Tool invocations |
+| `ApprovalCard` | `.../approval-card` | Human approval flow |
+| `CodeDiffViewer` | `.../code-diff-viewer` | Code changes |
+| `ArtifactCard` | `.../artifact-card` | Generated outputs |
+| `AgentTerminal` | `.../agent-terminal` | Command output |
+| `WorkflowGraph` | `.../workflow-graph` | DAG execution flow |
+| `ContextMeter` | `.../context-meter` | Context window usage |
+| `SourceCitation` | `.../source-citation` | Referenced sources |
+| `Tabs` | `.../tabs` | Work panel tabs |
+| `Button` | `.../button` | Send, panel triggers |
+| `ScrollArea` | `.../scroll-area` | Scrollable regions |
+| `Sheet` | `.../sheet` | Mobile panel drawers |
 
 ### Allowed (optional)
 

package/.agents/skills/seed/recipes/marketing-shell.md

@@ -37,32 +37,26 @@ Shared marketing layout providing scroll-aware header, main content area, and fo
 ```tsx
 import { HeaderBlock } from '@vadimcomanescu/nadicode-design-system/header-block'
 import { FooterBlock } from '@vadimcomanescu/nadicode-design-system/footer-block'
-import { Logo } from '@vadimcomanescu/nadicode-design-system/logo'
-import { Button } from '@vadimcomanescu/nadicode-design-system/button'
-import { ThemeToggle } from '@vadimcomanescu/nadicode-design-system/theme-toggle'
 
 const navLinks = [
-  { label: 'Services', href: '/services' },
-  { label: 'About', href: '/about' },
-  { label: 'Pricing', href: '/pricing' },
-  { label: 'Contact', href: '/contact' },
+  { name: 'Services', href: '/services' },
+  { name: 'About', href: '/about' },
+  { name: 'Pricing', href: '/pricing' },
+  { name: 'Contact', href: '/contact' },
 ]
 
 export default function MarketingLayout({ children }: { children: React.ReactNode }) {
   return (
     <div className="flex min-h-screen flex-col bg-background">
       <HeaderBlock
-        logo={<Logo />}
-        links={navLinks}
-        actions={
-          <div className="flex items-center gap-2">
-            <ThemeToggle />
-            <Button>Get Started</Button>
-          </div>
-        }
+        menuItems={navLinks}
+        loginLabel="Contact Sales"
+        signUpLabel="Get Started"
+        loginHref="/contact"
+        signUpHref="/signup"
       />
       <main className="flex-1">{children}</main>
-      <FooterBlock columns={footerColumns} social={socialLinks} legal={legalLinks} />
+      <FooterBlock />
     </div>
   )
 }
@@ -94,9 +88,6 @@ REDUCED MOTION: Header visible immediately, no blur transition
 |-----------|-------------|---------|
 | `HeaderBlock` | `@vadimcomanescu/nadicode-design-system/header-block` | Site navigation with glass blur |
 | `FooterBlock` | `@vadimcomanescu/nadicode-design-system/footer-block` | Site footer |
-| `Logo` | `@vadimcomanescu/nadicode-design-system/logo` | Brand logo |
-| `Button` | `@vadimcomanescu/nadicode-design-system/button` | Header CTA |
-| `ThemeToggle` | `@vadimcomanescu/nadicode-design-system/theme-toggle` | Light/dark mode switch |
 
 ### Allowed (optional)
 

package/.agents/skills/seed/recipes/navigation-shell.md

@@ -76,13 +76,13 @@ import {
   SidebarMenuSubButton,
 } from '@vadimcomanescu/nadicode-design-system/sidebar'
 import { NavUser } from '@vadimcomanescu/nadicode-design-system/nav-user'
-import { AppBreadcrumb } from '@vadimcomanescu/nadicode-design-system/app-breadcrumb'
-import { AppSearch } from '@vadimcomanescu/nadicode-design-system/app-search'
-import { WorkspaceSwitcher } from '@vadimcomanescu/nadicode-design-system/workspace-switcher'
+import { AppBreadcrumb } from '@/components/blocks/AppBreadcrumb'
+import { AppSearch } from '@/components/blocks/AppSearch'
+import { WorkspaceSwitcher } from '@/components/blocks/WorkspaceSwitcher'
 import { ThemeToggle } from '@vadimcomanescu/nadicode-design-system/theme-toggle'
 import { Button } from '@vadimcomanescu/nadicode-design-system/button'
 import { BellIcon } from '@vadimcomanescu/nadicode-design-system/icons/bell'
-import { DashboardIcon } from '@vadimcomanescu/nadicode-design-system/icons/dashboard'
+import { LayoutDashboardIcon } from '@vadimcomanescu/nadicode-design-system/icons/layout-dashboard'
 import { ChartBarIcon } from '@vadimcomanescu/nadicode-design-system/icons/chart-bar'
 import { BotIcon } from '@vadimcomanescu/nadicode-design-system/icons/bot'
 import { UsersIcon } from '@vadimcomanescu/nadicode-design-system/icons/users'
@@ -92,7 +92,7 @@ const NAV_ITEMS = [
   {
     group: 'Main',
     items: [
-      { label: 'Dashboard', href: '/dashboard', icon: DashboardIcon },
+      { label: 'Dashboard', href: '/dashboard', icon: LayoutDashboardIcon },
       { label: 'Analytics', href: '/analytics', icon: ChartBarIcon },
       {
         label: 'Agents',

package/.agents/skills/seed/recipes/service-detail.md

@@ -231,7 +231,7 @@ REDUCED MOTION: All items visible immediately, opacity 0->1 in 10ms
 | `Badge` | `@vadimcomanescu/nadicode-design-system/badge` | Category tag |
 | `Typography` | `@vadimcomanescu/nadicode-design-system/typography` | Headings, body text |
 | `ScrollFadeIn` | `@vadimcomanescu/nadicode-design-system/scroll-fade-in` | Below-fold animations |
-| `SolutionShowcaseBlock` | `@vadimcomanescu/nadicode-design-system/solution-showcase-block` | Product/service showcase |
+| `FeatureGridBlock` | `@vadimcomanescu/nadicode-design-system/feature-grid-block` | Product/service showcase |
 
 ### Allowed (optional)
 

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

@@ -1,6 +1,9 @@
 # Blocks Catalog
 
-All blocks live in `src/components/blocks/`. Import via `@vadimcomanescu/nadicode-design-system/block-name`.
+Derived from `dist/catalog.json`.
+
+Consumer code must import from `@vadimcomanescu/nadicode-design-system/*` block subpaths. Repo source paths are maintainer references only.
+
 Blocks are pre-composed page sections built from Seed UI primitives.
 Run `npm run docs:inventory` for the current filesystem-backed list.
 
@@ -23,29 +26,29 @@ Run `npm run docs:inventory` for the current filesystem-backed list.
 | Block | Purpose | Key Props |
 | --- | --- | --- |
 | AgentProfileGridBlock | Agent/worker profile card grid ("Meet your AI team") | `title`, `description`, `agents`, `columns` |
-| CallToActionBlock | Call-to-action section | - |
+| CallToActionBlock | Call-to-action section | `title`, `description`, `primaryAction`, `secondaryAction` |
 | ComparisonBlock | Side-by-side feature comparison | `plans`, `title`, `description` |
 | FAQBlock | FAQ accordion | `items`, `title`, `description` |
-| FeatureBlock | Single feature showcase | - |
-| FeatureGridBlock | Multi-feature grid layout | - |
-| HeroBlock | Full hero with gradient text | - |
-| HeroSectionBlock | Alternate hero layout | - |
+| FeatureBlock | Single feature showcase | `variant`, `badge`, `title`, `description`, `features` |
+| FeatureGridBlock | Multi-feature grid layout | `title`, `description`, `features` |
+| HeroBlock | Full hero with gradient text | `variant`, `headline`, `subheadline`, `primaryAction`, `secondaryAction`, `announcement` |
+| HeroSectionBlock | Alternate hero layout | `headline`, `flipWords`, `primaryAction`, `secondaryAction`, `logos` |
 | LogoCloud | Partner/client logo grid | `title`, `logos` |
-| PricingBlock | Pricing cards comparison | - |
+| PricingBlock | Pricing cards comparison | `title`, `description`, `plans`, `showBillingToggle` |
 | ProcessFlowBlock | "How it works" numbered step sequence | `title`, `description`, `badge`, `steps` |
-| SocialProofBlock | Social proof metrics/logos | - |
+| SocialProofBlock | Social proof metrics/logos | `variant`, `logos`, `title`, `testimonials` |
 | SolutionShowcaseBlock | Problem -> Solution -> Output narrative with color-coded arc | `title`, `description`, `badge`, `sections` |
-| StatsMarketingBlock | Marketing statistics display | - |
-| TestimonialsBlock | Customer testimonial carousel/grid | - |
+| StatsMarketingBlock | Marketing statistics display | `title`, `description`, `stats` |
+| TestimonialsBlock | Customer testimonial carousel/grid | `title`, `description`, `testimonials` |
 
 ## Navigation
 
 | Block | Purpose | Key Props |
 | --- | --- | --- |
 | BannerBlock | Top-of-page promotional banner | `variant`, `dismissible`, `onDismiss` |
-| FooterBlock | Site footer with link columns | - |
-| HeaderBlock | Site header with nav links | - |
-| NavUser | Sidebar user menu with dropdown | `user`, `name`, `email`, `avatar`, `items`, `footer` |
+| FooterBlock | Site footer with link columns | `brandDescription`, `newsletterPlaceholder`, `productLinks`, `companyLinks`, `legalLinks`, `socialIcons` |
+| HeaderBlock | Site header with nav links | `menuItems`, `loginLabel`, `signUpLabel`, `loginHref`, `signUpHref` |
+| NavUser | Sidebar user menu with dropdown | `user`, `items`, `footer` |
 | NotFoundBlock | 404 page content | `title`, `description`, `backHref`, `backLabel` |
 
 ## Dashboard & Data
@@ -53,15 +56,15 @@ Run `npm run docs:inventory` for the current filesystem-backed list.
 | Block | Purpose | Key Props |
 | --- | --- | --- |
 | ActivityFeedBlock | Activity/event timeline | `activities`, `title` |
-| BarChartBlock | Pre-configured bar chart | - |
+| BarChartBlock | Pre-configured bar chart | `data`, `config`, `title`, `description` |
 | ChartBlock | Single chart container | `data`, `config`, `title`, `description` |
 | ChartCollectionBlock | Multiple chart grid | - |
-| CodeBlock | Syntax-highlighted code display | - |
+| CodeBlock | Syntax-highlighted code display | `code`, `language`, `filename` |
 | DataGridBlock | Data grid/table block | `data`, `columns`, `title`, `description` |
-| HeatmapChartBlock | Heatmap visualization | - |
-| InteractiveAreaChartBlock | Zoomable/interactive area chart | - |
-| StatsBlock | KPI statistics cards | - |
-| UsageDonutBlock | Usage/quota donut chart | - |
+| HeatmapChartBlock | Heatmap visualization | `data`, `config`, `title`, `description` |
+| InteractiveAreaChartBlock | Zoomable/interactive area chart | `data`, `config`, `title`, `description`, `timeRanges` |
+| StatsBlock | KPI statistics cards | `stats` |
+| UsageDonutBlock | Usage/quota donut chart | `data`, `config`, `title`, `description`, `centerLabel` |
 
 ## Application
 
@@ -72,7 +75,7 @@ Run `npm run docs:inventory` for the current filesystem-backed list.
 | ContactBlock | Contact form | `onSubmit`, `title`, `description`, `namePlaceholder`, `emailPlaceholder`, `messagePlaceholder`, `successTitle`, `submitLabel` |
 | CreateBlock | Entity creation form | `title`, `description`, `submitLabel`, `onSubmit` |
 | DirectoryBlock | User/item directory with search | `navItems`, `projects` |
-| IntegrationsBlock | Integration marketplace grid | - |
+| IntegrationsBlock | Integration marketplace grid | `title`, `description`, `integrations` |
 | KanbanDemoBlock | Kanban board demo with sample data | - |
 | OnboardingBlock | Multi-step onboarding wizard | `steps`, `title`, `onToggle` |
 | SettingsLayout | Settings page with nav sidebar | `links`, `title`, `subtitle`, `defaultActive`, `renderContent` |
@@ -82,7 +85,7 @@ Run `npm run docs:inventory` for the current filesystem-backed list.
 
 | Block | Purpose | Key Props |
 | --- | --- | --- |
-| AudioVisualizerBlock | Audio visualization display | - |
+| AudioVisualizerBlock | Audio visualization display | `bars`, `isPlaying` |
 | GalleryBlock | Image/media gallery grid | `images`, `columns`, `title` |
 | NewsletterBlock | Email newsletter signup | `onSubscribe`, `title`, `description` |
 
@@ -90,21 +93,22 @@ Run `npm run docs:inventory` for the current filesystem-backed list.
 
 | Block | Purpose | Key Props |
 | --- | --- | --- |
-| TeamBlock | Team members grid with roles/avatars | - |
+| InviteUserModal | Invite teammate modal with role selection | `onInvite`, `onInvited` |
+| TeamBlock | Team members grid with roles/avatars | `title`, `sections` |
 
 ## AI/Voice
 
 | Block | Purpose | Key Props |
 | --- | --- | --- |
-| VoiceAgentCard | AI voice agent interface card | `agent`, `state`, `selected`, `onSelect` |
+| VoiceAgentCard | AI voice agent interface card | `agent`, `state`, `selected`, `onSelect`, `ariaLabel` |
 
 ## Agentic
 
 | Block | Purpose | Key Props |
 | --- | --- | --- |
-| AgentConversationBlock | Agent conversation UI (messages, tool calls, thinking) | - |
-| AgentRunOverviewBlock | Agent run summary with status, duration, and output | - |
-| AgentWorkbenchBlock | Agent workbench layout with tool panels and conversation | - |
+| AgentConversationBlock | Agent conversation UI (messages, tool calls, thinking) | `messages` |
+| AgentRunOverviewBlock | Agent run summary with status, duration, and output | `title`, `description`, `teamTitle`, `metricsTitle`, `contextTitle`, `workflow`, `agents`, `metrics`, `context` |
+| AgentWorkbenchBlock | Agent workbench layout with tool panels and conversation | `title`, `description`, `threadTitle`, `workTitle`, `defaultWorkTab`, `messages`, `artifacts`, `diffs`, `logs`, `composer` |
 
 ## Usage Pattern
 

package/.agents/skills/seed/references/brand-override.md

@@ -72,7 +72,9 @@ Typical brand-facing variables include:
 | Border colors | `--color-border`, `--color-border-hover`, `--color-border-subtle` |
 | Action colors | `--color-primary`, `--color-primary-foreground`, `--color-secondary`, `--color-accent`, `--color-accent-foreground` |
 | Status colors | `--color-success`, `--color-warning`, `--color-info`, `--color-destructive` |
-| Optional data viz colors | `--chart-1` through `--chart-6`, sidebar color vars if the app uses them |
+| Optional data viz colors | `--chart-1` through `--chart-6` |
+
+Sidebar color tokens (`--sidebar-background`, `--sidebar-foreground`, etc.) derive automatically from semantic tokens via `var()` aliases. Override them in `seed-palette.css` only if the sidebar needs to differ from the main palette.
 
 If a token is not a color token, treat it as upstream-managed unless the DS explicitly broadens the contract.
 

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

@@ -1,6 +1,8 @@
 # Component Inventory
 
-All components live under `src/components/`. Import via `@/components/ui/...` or `@/components/blocks/...`.
+Derived from `dist/catalog.json`.
+
+Consumer code must import from `@vadimcomanescu/nadicode-design-system/*` subpaths. The `Path` column below is the repo source location for maintainers.
 
 Tiers: **1**=Core (3+ recipes), **2**=Domain (1-2 recipes), **3**=Decorative (marketing only), **4**=Deprecation candidate.
 
@@ -213,8 +215,26 @@ Components for AI agent interfaces, tool-use visualization, and multi-agent work
 | AgentTimeline | `ui/AgentTimeline` | 2 | Timeline of agent actions |
 | ApprovalCard | `ui/ApprovalCard` | 2 | Human-in-the-loop approval/reject |
 | ArtifactCard | `ui/ArtifactCard` | 2 | Generated artifacts display |
+| ChatActions | `ui/ChatActions` | 2 | Quick-action buttons for chat messages |
+| ChatBranch | `ui/ChatBranch` | 2 | Conversation branching and fork navigation |
+| ChatChainOfThought | `ui/ChatChainOfThought` | 2 | Step-by-step reasoning display |
+| ChatConfirmation | `ui/ChatConfirmation` | 2 | Action confirmation dialog in chat |
+| ChatGreeting | `ui/ChatGreeting` | 2 | Welcome greeting for chat sessions |
+| ChatMessage | `ui/ChatMessage` | 2 | Core chat message with avatar, content, actions |
+| ChatPlan | `ui/ChatPlan` | 2 | Collapsible plan card with streaming title |
+| ChatPromptInput | `ui/ChatPromptInput` | 2 | Chat text input with keyboard handling |
+| ChatPromptInputAttachments | `ui/ChatPromptInputAttachments` | 2 | File attachment support for chat input |
+| ChatQueue | `ui/ChatQueue` | 2 | Task queue with collapsible sections |
+| ChatReasoning | `ui/ChatReasoning` | 2 | AI reasoning display with auto-close |
+| ChatResponse | `ui/ChatResponse` | 2 | Streaming markdown response renderer |
+| ChatShimmer | `ui/ChatShimmer` | 2 | Loading shimmer placeholder for chat |
+| ChatSources | `ui/ChatSources` | 2 | Source citations panel with inline citation |
+| ChatSuggestion | `ui/ChatSuggestion` | 2 | Suggested follow-up prompt chips |
+| ChatThinkingMessage | `ui/ChatThinkingMessage` | 2 | Animated thinking state message |
+| ChatToolCall | `ui/ChatToolCall` | 2 | Tool call lifecycle wrapper with state management |
 | CodeDiffViewer | `ui/CodeDiffViewer` | 2 | Side-by-side or unified diff view |
 | ContextMeter | `ui/ContextMeter` | 2 | Context window usage visualization |
+| Conversation | `ui/Conversation` | 2 | Scroll-aware conversation container with auto-scroll |
 | DiffStat | `ui/DiffStat` | 2 | Diff statistics display (additions/deletions) |
 | HandoffIndicator | `ui/HandoffIndicator` | 2 | Agent-to-agent task handoff |
 | MemoryInspector | `ui/MemoryInspector` | 2 | Agent memory/state inspector |
@@ -260,7 +280,7 @@ All in `src/components/ui/stepper/`. Distinct from FormWizard.
 | Tier | Count | Usage |
 |------|-------|-------|
 | 1 (Core) | ~76 | 3+ recipes, always available |
-| 2 (Domain) | ~43 | Agentic, charts, AI/voice, checkout |
+| 2 (Domain) | ~61 | Agentic, charts, AI/voice, checkout |
 | 3 (Decorative) | ~24 | Marketing/showcase only |
 | 4 (Deprecation) | ~14 | Evaluate for removal/consolidation |
 

package/.agents/skills/seed/references/dashboard-patterns.md

@@ -61,18 +61,18 @@ Key properties:
 
 ## Color Expansion
 
-The base chart palette provides 6 tokens. Seed extends to 8 for dashboards that need more series.
-
-| Token | Role | Hex (arctic dark) | Typical Use |
-|-------|------|-------------------|-------------|
-| `chart-1` | Primary | `#E8B931` (gold) | Revenue, throughput, primary metric |
-| `chart-2` | Secondary | `#3B82F6` (blue) | Users, latency, secondary metric |
-| `chart-3` | Tertiary | `#22C55E` (green) | Growth, conversions, positive |
-| `chart-4` | Quaternary | `#14B8A6` (teal) | Enterprise, high-value segments |
-| `chart-5` | Quinary | `#EF4444` (red) | Churn, errors, negative |
-| `chart-6` | Senary | `#A855F7` (violet) | Auxiliary series |
-| `chart-7` | Septenary | `#A78BFA` (lavender) | Secondary auxiliary, comparison overlays |
-| `chart-8` | Octonary | `#FB923C` (peach) | Warm accent, seasonal data, promotions |
+The chart palette provides 8 semantic tokens. The exact RGB values come from the current token build, not from this doc.
+
+| Token | Role | Typical Use |
+|-------|------|-------------|
+| `chart-1` | Primary | Revenue, throughput, primary metric |
+| `chart-2` | Secondary | Users, latency, secondary metric |
+| `chart-3` | Tertiary | Growth, conversions, positive |
+| `chart-4` | Quaternary | High-value segments, supporting series |
+| `chart-5` | Quinary | Churn, errors, negative |
+| `chart-6` | Senary | Auxiliary series |
+| `chart-7` | Septenary | Secondary auxiliary, comparison overlays |
+| `chart-8` | Octonary | Warm accent, seasonal data, promotions |
 
 ### Color assignment rules
 

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

@@ -1,81 +1,31 @@
 # Next.js Integration Guide
 
-Seed is integrated into Next.js apps through installable package artifacts, not live repo-path links.
+Seed integrates into Next.js apps through installable package artifacts, not live repo-path links.
 
-## Supported Target Matrix
+## Canonical Contract
 
-Seed package integration is designed around:
+Use these in order:
 
-- Next.js App Router
-- React 19
-- Tailwind CSS 4
+1. `contract.md`, binary consumer rules
+2. this guide, integration checklist
+3. `consumer-contract.json` in the installed package, machine-readable ownership and contract entrypoint map
+4. `catalog.json` in the installed package, exact component metadata
 
-## Package Contract
+## Integration Checklist
 
-Consumer apps should satisfy this contract:
+- install an exact released package version of `@vadimcomanescu/nadicode-design-system`, or a committed relative tarball fallback such as `file:.nadicode/packages/vadimcomanescu-nadicode-design-system-<version>.tgz`
+- never point `package.json` at a live repo directory such as `file:/absolute/path/to/nadicode-design-system`
+- import `@vadimcomanescu/nadicode-design-system/tokens.css` before `seed-palette.css`
+- use `@vadimcomanescu/nadicode-design-system/tailwind` in `tailwind.config.*`
+- use `@vadimcomanescu/nadicode-design-system/eslint-config` and `@vadimcomanescu/nadicode-design-system/eslint-plugin` in `eslint.config.*`
+- mount `ThemeProvider` from `@vadimcomanescu/nadicode-design-system/theme-provider`
+- keep `scripts/ds-check.mjs` and `scripts/ds-update.mjs` as thin package delegates
 
-- `package.json` depends on `@vadimcomanescu/nadicode-design-system` through an exact released version such as `2.0.0`
-- `package.json` must not point `@vadimcomanescu/nadicode-design-system` at a live repo directory such as `file:/absolute/path/to/nadicode-design-system`
-- `globals.css` imports `@vadimcomanescu/nadicode-design-system/tokens.css`
-- `globals.css` imports `seed-palette.css` after package tokens
-- `tailwind.config.*` uses `@vadimcomanescu/nadicode-design-system/tailwind`
-- `eslint.config.*` uses `@vadimcomanescu/nadicode-design-system/eslint-config` and `@vadimcomanescu/nadicode-design-system/eslint-plugin`
-- `providers.tsx` imports `ThemeProvider` from `@vadimcomanescu/nadicode-design-system/theme-provider`
-- `scripts/ds-check.mjs` delegates to `@vadimcomanescu/nadicode-design-system/ds-check`
+## i18n
 
-## Distribution Rule
+The app owns `src/i18n/request.ts`, locale routing, `NextIntlClientProvider`, and app catalogs. Seed owns DS catalogs and merge helpers.
 
-The canonical source for scaffold consumers is an exact released package version. A packed .tgz artifact committed into the consumer app, for example `file:.nadicode/packages/vadimcomanescu-nadicode-design-system-<version>.tgz`, is the unpublished local fallback.
-
-For released installs:
-
-```bash
-npm install @vadimcomanescu/nadicode-design-system@2.0.0
-```
-
-For unpublished local work:
-
-```bash
-DS_REPO="/absolute/path/to/nadicode-design-system"
-mkdir -p .nadicode/packages
-npm --prefix "$DS_REPO" run pack:artifact -- "$PWD/.nadicode/packages"
-NADICODE_TARBALL="$(ls .nadicode/packages/vadimcomanescu-nadicode-design-system-*.tgz | head -n1)"
-npm install "@vadimcomanescu/nadicode-design-system@file:${NADICODE_TARBALL}"
-```
-
-## CSS Contract
-
-Seed splits CSS into two layers:
-
-- `@vadimcomanescu/nadicode-design-system/tokens.css`, package-owned baseline tokens/effects/utilities
-- `seed-palette.css`, consumer-owned color overrides
-
-Consumers who want brand customization should edit only `seed-palette.css`.
-
-Canonical selectors:
-
-```css
-:root {}
-:root.dark {}
-:root.bloom {}
-```
-
-Do not use `[data-theme=...]` selectors.
-
-## Root Wiring
-
-The target app should have a client providers wrapper:
-
-```tsx
-// src/app/providers.tsx
-"use client"
-
-import { ThemeProvider } from "@vadimcomanescu/nadicode-design-system/theme-provider"
-
-export function Providers({ children }: { children: React.ReactNode }) {
-  return <ThemeProvider>{children}</ThemeProvider>
-}
-```
+Import DS catalogs from `@vadimcomanescu/nadicode-design-system/messages/<locale>`, keep app catalogs in `messages/<locale>.json`, merge both with `mergeSeedMessages()`, and do not copy DS catalog files into the app.
 
 ## Update Path
 
@@ -87,9 +37,9 @@ npm run ds:update
 
 `ds:update` must reinstall the exact `@vadimcomanescu/nadicode-design-system` dependency already declared in `package.json`.
 
-## Verification
+That tarball path is the unpublished local fallback. Do not point the app at a live repo directory.
 
-Treat this as the canonical consumer gate:
+## Verification
 
 ```bash
 npm run ds:check
@@ -97,13 +47,3 @@ npm run lint
 npx tsc --noEmit
 npm run build
 ```
-
-Optional package-contract checks:
-
-```bash
-test -f src/seed-palette.css
-rg -n "@vadimcomanescu/nadicode-design-system/tokens.css" src/app/globals.css app/globals.css
-rg -n "@vadimcomanescu/nadicode-design-system/tailwind" tailwind.config.js tailwind.config.mjs tailwind.config.ts
-rg -n "@vadimcomanescu/nadicode-design-system/eslint-config|@vadimcomanescu/nadicode-design-system/eslint-plugin" eslint.config.mjs eslint.config.js
-rg -n "@vadimcomanescu/nadicode-design-system/theme-provider" src/app/providers.tsx app/providers.tsx
-```