feat: add cookbook feature module structure (#1433)

* feat: add cookbook feature module structure

Create frontend/src/features/cookbook/ with:
- TypeScript types for registry data (CookbookItem, PatternMeta, etc.)
- useCookbook hook stub returning empty data
- Page stubs for catalogue grid and pattern detail views
- Barrel exports in index.ts
- Routes in App.tsx (/cookbook, /cookbook/:name)
- Sidebar nav entry in Configuration group

* fix: export CookbookFile type from cookbook barrel

---------

Co-authored-by: Ben Coombs <bjcoombs@users.noreply.github.com>

Author: bjcoombs

frontend/src/App.tsx

@@ -30,6 +30,7 @@ import { DashboardPage } from '@/features/dashboard'
 import { ManifestsPage } from '@/features/manifests'
 import { McpConfigPage } from '@/features/mcp-config'
 import { TransactionsPage } from '@/features/transactions'
+import { CookbookPage, CookbookDetailPage } from '@/features/cookbook'
 import { ThemePreviewPanel } from '@/components/dev/theme-preview-panel'
 
 // Placeholder page components - replaced as each page task is implemented
@@ -256,6 +257,8 @@ function AppShellLayout() {
         <Route path="/gateway-mappings/:mappingId" element={<FeatureGuard feature="mappings">{guarded(<MappingDetailPage />)}</FeatureGuard>} />
         <Route path="/manifests" element={<FeatureGuard feature="manifests">{guarded(<ManifestsPage />)}</FeatureGuard>} />
         <Route path="/mcp-config" element={<FeatureGuard feature="mcp-config">{guarded(<McpConfigPage />)}</FeatureGuard>} />
+        <Route path="/cookbook" element={guarded(<CookbookPage />)} />
+        <Route path="/cookbook/:name" element={guarded(<CookbookDetailPage />)} />
         <Route path="/audit-log" element={<FeatureGuard feature="audit">{guarded(<AuditLogPage />)}</FeatureGuard>} />
 
         {/* Platform-only routes */}

frontend/src/components/layout/sidebar.tsx

@@ -19,6 +19,7 @@ import {
   CheckSquare,
   FileJson,
   Bot,
+  Library,
 } from 'lucide-react'
 import { cn } from '@/lib/utils'
 import { useTenantFeatures } from '@/hooks/use-tenant-features'
@@ -61,6 +62,7 @@ const TENANT_NAV_GROUPS: NavGroup[] = [
       { label: 'Gateway Mappings', href: '/gateway-mappings', icon: Map, feature: 'mappings' },
       { label: 'Manifests', href: '/manifests', icon: FileJson, feature: 'manifests' },
       { label: 'MCP Config', href: '/mcp-config', icon: Bot, feature: 'mcp-config' },
+      { label: 'Cookbook', href: '/cookbook', icon: Library },
     ],
   },
   {

frontend/src/features/cookbook/components/.gitkeep

@@ -0,0 +1,52 @@
+export interface CookbookItem {
+  name: string
+  type: 'registry:pattern' | 'registry:ui'
+  title: string
+  description?: string
+  categories?: string[]
+  meta?: PatternMeta | ComponentMeta
+  files?: CookbookFile[]
+}
+
+export interface PatternMeta {
+  complexity?: number
+  design_pattern?: string
+  industries?: string[]
+  provides?: {
+    instruments?: string[]
+    account_types?: string[]
+    sagas?: string[]
+    valuation_rules?: string[]
+    triggers?: string[]
+  }
+  requires?: {
+    instruments?: string[]
+    market_data?: string[]
+  }
+  composes_with?: string[]
+  conflicts_with?: string[]
+  extends?: string[]
+}
+
+export interface ComponentMeta {
+  feature_module?: string
+  used_by?: string[]
+  configurable?: boolean
+}
+
+export interface CookbookFile {
+  path: string
+  type?: string
+  content?: string
+}
+
+export interface CookbookRegistry {
+  name: string
+  items: CookbookItem[]
+}
+
+// Hook stub - returns empty data initially. Task 2 (Vite plugin) will provide real data.
+export function useCookbook(): { items: CookbookItem[]; isLoading: boolean } {
+  // TODO: Replace with Vite plugin bundled data (Task 2)
+  return { items: [], isLoading: false }
+}

frontend/src/features/cookbook/hooks/use-cookbook.ts

@@ -0,0 +1,4 @@
+export { CookbookPage } from './pages/index'
+export { CookbookDetailPage } from './pages/detail'
+export type { CookbookItem, CookbookFile, CookbookRegistry, PatternMeta, ComponentMeta } from './hooks/use-cookbook'
+export { useCookbook } from './hooks/use-cookbook'

frontend/src/features/cookbook/index.ts

@@ -0,0 +1,11 @@
+import { useParams } from 'react-router-dom'
+
+export function CookbookDetailPage() {
+  const { name } = useParams<{ name: string }>()
+  return (
+    <div className="space-y-6">
+      <h1 className="text-2xl font-semibold">{name}</h1>
+      <p className="text-muted-foreground">Pattern detail placeholder</p>
+    </div>
+  )
+}

frontend/src/features/cookbook/lib/.gitkeep

@@ -0,0 +1,11 @@
+export function CookbookPage() {
+  return (
+    <div className="space-y-6">
+      <div>
+        <h1 className="text-2xl font-semibold">Cookbook</h1>
+        <p className="text-muted-foreground">Browse economy patterns and UI components</p>
+      </div>
+      {/* Catalogue grid placeholder - Task 3 */}
+    </div>
+  )
+}