kaddidlehopper 0.3.1 → 0.4.0

package/add-ons/ai/assets/AGENTS.md.append

@@ -0,0 +1,24 @@
+### AI Integration
+
+Multi-provider AI chat with fallback chain:
+
+1. Anthropic Claude (preferred)
+2. OpenAI GPT-4o
+3. Google Gemini
+4. Ollama (local)
+
+**Tools available to AI:**
+- `getWeather` - Get the current weather for a city. Returns temperature, condition, and humidity.
+
+## Environment Variables
+
+For AI functionality, set one or more:
+
+```
+ANTHROPIC_API_KEY=...
+OPENAI_API_KEY=...
+GOOGLE_GENERATIVE_AI_API_KEY=...
+OLLAMA_BASE_URL=...
+```
+
+The application uses the first available provider in the fallback chain.

package/add-ons/ai/info.json

@@ -6,22 +6,16 @@
   "modes": ["file-router"],
   "type": "add-on",
   "priority": 20,
-  "routes": [
-    {
-      "icon": "MessagesSquare",
-      "url": "/chat",
-      "name": "Chat",
-      "path": "src/routes/chat.tsx",
-      "jsName": "ChatPage"
-    }
-  ],
-  "integrations": [
-    {
-      "type": "header-user",
-      "path": "src/components/AIAssistant.tsx",
-      "jsName": "AIAssistant"
-    }
-  ],
+  "routes": [{"icon": "MessagesSquare", "url": "/chat", "name": "Chat", "path": "src/routes/chat.tsx", "jsName": "ChatPage"}],
+  "integrations": [{"type": "header-user", "path": "src/components/AIAssistant.tsx", "jsName": "AIAssistant"}],
   "dependsOn": [],
-  "variables": []
+  "variables": [],
+  "packageFileDescriptions": {
+    "src/lib/ai-hook.ts": "useAIChat hook: useChat with fetchServerSentEvents connection to /api/chat.",
+    "src/routes/chat.tsx": "Chat page route (/chat): Weather Chat UI with messages, input form, send/stop.",
+    "src/routes/api.chat.ts": "POST handler for /api/chat: multi-provider AI (Anthropic, OpenAI, Gemini, Ollama) with getWeather tool and SSE streaming.",
+    "src/lib/weather-tools.ts": "TanStack AI getWeather tool definition; server returns mock temperature, condition, humidity for a city.",
+    "src/routes/chat.css": "Chat page styles: prose/markdown, scrollbar, message animations.",
+    "src/components/AIAssistant.tsx": "Pop-up AI assistant component for header; toggleable chat panel with useAIChat."
+  }
 }

package/add-ons/db/assets/AGENTS.md.append

@@ -0,0 +1,22 @@
+### Netlify DB Integration
+
+Guestbook demo powered by Netlify DB (Neon Postgres) with Drizzle ORM.
+
+**Setup:**
+1. Link project: `netlify login` then `netlify init`
+2. Provision database: `netlify db init` (creates Neon Postgres, sets `DATABASE_URL`)
+3. Push schema: `npx drizzle-kit push` (creates `guestbook` table from `src/db/schema.ts`)
+4. Run locally: `netlify dev` (visit `/db-example`)
+
+**Key files:**
+- `src/db/schema.ts` - Guestbook table (id, name, message, createdAt)
+- `src/server/guestbook.functions.ts` - Server functions: `getEntries`, `addEntry`
+- `drizzle.config.ts` - Drizzle Kit config for migrations
+
+**Dependencies:** drizzle-orm, @neondatabase/serverless, drizzle-kit
+
+## Environment Variables
+
+```
+DATABASE_URL=...  # Auto-set by netlify db init; pull with netlify env:pull
+```

package/add-ons/db/info.json

@@ -6,16 +6,16 @@
   "modes": ["file-router"],
   "type": "add-on",
   "priority": 20,
-  "routes": [
-    {
-      "icon": "Database",
-      "url": "/db-example",
-      "name": "DB Example",
-      "path": "src/routes/db-example.tsx",
-      "jsName": "DBExample"
-    }
-  ],
+  "routes": [{"icon": "Database", "url": "/db-example", "name": "DB Example", "path": "src/routes/db-example.tsx", "jsName": "DBExample"}],
   "integrations": [],
   "dependsOn": [],
-  "variables": []
+  "variables": [],
+  "packageFileDescriptions": {
+    "DB-SETUP.md": "Setup guide: link to Netlify, run netlify db init, configure DATABASE_URL.",
+    "src/routes/db-example.tsx": "Guestbook route (/db-example): form to add entries, list from getEntries/addEntry.",
+    "src/server/guestbook.functions.ts": "Server functions: getEntries (list), addEntry (create) for guestbook via Drizzle.",
+    "src/db/index.ts": "Drizzle + Neon client; exports db and schema.",
+    "src/db/schema.ts": "Guestbook table schema: id, name, message, createdAt.",
+    "drizzle.config.ts": "Drizzle Kit config for migrations; postgres, schema path, DATABASE_URL."
+  }
 }

package/add-ons/forms/assets/AGENTS.md.append

@@ -0,0 +1,13 @@
+### Netlify Forms Integration
+
+Signup form powered by Netlify Forms with honeypot spam protection. No server-side code required.
+
+**How it works:**
+- Form submissions are handled by Netlify at build/deploy
+- Add `data-netlify="true"` to the form
+- Spam protection: `netlify-honeypot="bot-field"` + hidden input with `name="bot-field"`
+- `public/form-example.html` declares the form (hidden) so Netlify detects it during build
+
+**Route:** `/form-example` - Signup form (name, email)
+
+No environment variables required. Works after deploy to Netlify.

package/add-ons/forms/info.json

@@ -6,16 +6,12 @@
   "modes": ["file-router"],
   "type": "add-on",
   "priority": 20,
-  "routes": [
-    {
-      "icon": "FormInput",
-      "url": "/form-example",
-      "name": "Form Example",
-      "path": "src/routes/form-example.tsx",
-      "jsName": "FormExample"
-    }
-  ],
+  "routes": [{"icon": "FormInput", "url": "/form-example", "name": "Form Example", "path": "src/routes/form-example.tsx", "jsName": "FormExample"}],
   "integrations": [],
   "dependsOn": [],
-  "variables": []
+  "variables": [],
+  "packageFileDescriptions": {
+    "src/routes/form-example.tsx": "Form example route (/form-example): Netlify Forms signup with honeypot spam protection.",
+    "public/form-example.html": "Static HTML form declaration for Netlify Forms; name, email, bot-field."
+  }
 }

package/dist/agents-md.js

@@ -0,0 +1,103 @@
+import { dirname, join, relative } from 'node:path';
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+const PLACEHOLDER = '[[[DIRECTORY STRUCTURE]]]';
+const IGNORED_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'dist-ssr',
+    '.netlify',
+    '.tanstack',
+    '.DS_Store',
+]);
+function buildDescriptionLookup(descriptions) {
+    const lookup = new Map();
+    for (const [key, desc] of Object.entries(descriptions)) {
+        const normalizedKey = key.replace(/\\/g, '/');
+        lookup.set(normalizedKey, desc);
+        if (normalizedKey.endsWith('.ejs')) {
+            lookup.set(normalizedKey.slice(0, -4), desc);
+        }
+        if (normalizedKey.startsWith('_dot_')) {
+            lookup.set('.' + normalizedKey.slice(5), desc);
+        }
+    }
+    return lookup;
+}
+async function loadFileDescriptions(addOnDescriptions) {
+    const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+    const infoPath = join(packageRoot, 'project', 'info.json');
+    const lookup = new Map();
+    try {
+        const info = await readFile(infoPath, 'utf-8');
+        const { packageFileDescriptions } = JSON.parse(info);
+        if (packageFileDescriptions) {
+            for (const [key, desc] of buildDescriptionLookup(packageFileDescriptions)) {
+                lookup.set(key, desc);
+            }
+        }
+    }
+    catch {
+        // No info.json or invalid, continue
+    }
+    if (addOnDescriptions) {
+        for (const addOn of addOnDescriptions) {
+            if (addOn.packageFileDescriptions) {
+                for (const [key, desc] of buildDescriptionLookup(addOn.packageFileDescriptions)) {
+                    lookup.set(key, desc);
+                }
+            }
+        }
+    }
+    return lookup;
+}
+async function buildFileTree(dirPath, rootPath, descriptions, prefix = '') {
+    const entries = await readdir(dirPath, { withFileTypes: true });
+    const filtered = entries
+        .filter((e) => !e.name.startsWith('.') || e.name === '.gitignore')
+        .filter((e) => !IGNORED_DIRS.has(e.name))
+        .sort((a, b) => {
+        // Directories first, then files; alphabetically within each
+        if (a.isDirectory() !== b.isDirectory()) {
+            return a.isDirectory() ? -1 : 1;
+        }
+        return a.name.localeCompare(b.name, undefined, { sensitivity: 'base' });
+    });
+    const lines = [];
+    for (let i = 0; i < filtered.length; i++) {
+        const entry = filtered[i];
+        const isLastEntry = i === filtered.length - 1;
+        const connector = isLastEntry ? '└── ' : '├── ';
+        const fullPath = join(dirPath, entry.name);
+        const relPath = relative(rootPath, fullPath).replace(/\\/g, '/');
+        const description = descriptions.get(relPath);
+        const suffix = description ? `  # ${description}` : '';
+        lines.push(`${prefix}${connector}${entry.name}${suffix}`);
+        if (entry.isDirectory()) {
+            const childPrefix = prefix + (isLastEntry ? '    ' : '│   ');
+            const childLines = await buildFileTree(join(dirPath, entry.name), rootPath, descriptions, childPrefix);
+            lines.push(...childLines);
+        }
+    }
+    return lines;
+}
+export async function generateAgentsMd(targetDir, _projectName, chosenAddOns) {
+    const agentsMdPath = join(targetDir, 'AGENTS.md');
+    let content;
+    try {
+        content = await readFile(agentsMdPath, 'utf-8');
+    }
+    catch {
+        // No AGENTS.md template, skip
+        return;
+    }
+    if (!content.includes(PLACEHOLDER)) {
+        return;
+    }
+    const descriptions = await loadFileDescriptions(chosenAddOns);
+    const treeLines = await buildFileTree(targetDir, targetDir, descriptions);
+    const tree = treeLines.length > 0 ? treeLines.join('\n') : '(empty)';
+    const updatedContent = content.replace(PLACEHOLDER, tree);
+    await writeFile(agentsMdPath, updatedContent, 'utf-8');
+}

package/dist/cli.js

@@ -4,6 +4,7 @@ import { Command, InvalidArgumentError } from 'commander';
 import chalk from 'chalk';
 import validatePackageName from 'validate-npm-package-name';
 import { SUPPORTED_PACKAGE_MANAGERS, createApp, createDefaultEnvironment, finalizeAddOns, getAllAddOns, getFrameworkByName, getPackageManager, DEFAULT_PACKAGE_MANAGER, populateAddOnOptionsDefaults, } from '@tanstack/cta-engine';
+import { generateAgentsMd } from './agents-md.js';
 // Utility functions
 function sanitizePackageName(name) {
     return name
@@ -248,6 +249,8 @@ export function cli({ name, appName, defaultFramework, forcedMode, forcedAddOns
                 }
             }
         }
+        // Generate an AGENTS.md file in the root of the project
+        await generateAgentsMd(targetDir, resolvedProjectName, chosenAddOns);
     });
     program.parse();
 }

package/dist/types/agents-md.d.ts

@@ -0,0 +1,5 @@
+type FileDescriptions = Record<string, string>;
+export declare function generateAgentsMd(targetDir: string, _projectName: string, chosenAddOns?: Array<{
+    packageFileDescriptions?: FileDescriptions;
+}>): Promise<void>;
+export {};

package/examples/ai-chat/assets/AGENTS.md.append

@@ -0,0 +1,24 @@
+### AI Integration
+
+Multi-provider AI chat with fallback chain:
+
+1. Anthropic Claude (preferred)
+2. OpenAI GPT-4o
+3. Google Gemini
+4. Ollama (local)
+
+**Tools available to AI:**
+- `getWeather` - Get the current weather for a city. Returns temperature, condition, and humidity.
+
+## Environment Variables
+
+For AI functionality, set one or more:
+
+```
+ANTHROPIC_API_KEY=...
+OPENAI_API_KEY=...
+GOOGLE_GENERATIVE_AI_API_KEY=...
+OLLAMA_BASE_URL=...
+```
+
+The application uses the first available provider in the fallback chain.

package/examples/ai-chat/info.json

@@ -7,18 +7,18 @@
   "priority": 10,
   "link": "",
   "routes": [
-    {
-      "url": "/",
-      "path": "src/routes/index.tsx",
-      "jsName": "Home"
-    },
-    {
-      "url": "/api/chat",
-      "path": "src/routes/api.chat.ts",
-      "jsName": "ChatAPI"
-    }
+    {"url": "/", "path": "src/routes/index.tsx", "jsName": "Home"},
+    {"url": "/api/chat", "path": "src/routes/api.chat.ts", "jsName": "ChatAPI"}
   ],
   "integrations": [],
   "dependsOn": [],
-  "variables": []
+  "variables": [],
+  "packageFileDescriptions": {
+    "src/styles.css": "Global styles: Tailwind, highlight.js theme, custom scrollbar, prose/markdown styles for chat UI.",
+    "src/lib/weather-tools.ts": "TanStack AI tool definition for getWeather; server implementation returns mock temperature, condition, humidity for a city.",
+    "src/lib/ai-hook.ts": "useAIChat hook: useChat with fetchServerSentEvents connection to /api/chat.",
+    "src/routes/api.chat.ts": "POST handler for /api/chat: multi-provider AI (Anthropic, OpenAI, Gemini, Ollama) with getWeather tool and SSE streaming.",
+    "src/routes/index.tsx": "Home route: Weather Chat UI with messages list, input form, send/stop, Streamdown markdown rendering.",
+    "src/routes/__root.tsx": "Root layout: HTML shell, Weather Chat header, styles, TanStack Devtools."
+  }
 }

package/examples/blog/assets/AGENTS.md.append

@@ -0,0 +1,18 @@
+### Content Collections
+
+Markdown files in `content/posts/` are type-safe blog posts:
+
+- Frontmatter validated against Zod schemas in `content-collections.ts`
+- Imported as typed array: `import { allPosts } from 'content-collections'`
+- Each post has: `title`, `summary`, `categories[]`, `slug`, `image`, `date`, `content`
+
+### VacayAssistant AI Integration
+
+**Tools available to AI:**
+- `getCurrentBlogPost` - Get full content and metadata of the current blog post by slug
+- `getAllBlogPosts` - List all posts with titles, summaries, categories
+- `searchBlogPosts` - Search posts by title, summary, or categories
+
+## Environment Variables
+
+For AI: ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, or OLLAMA_BASE_URL (same as ai add-on).

package/examples/blog/info.json

@@ -7,37 +7,33 @@
   "priority": 10,
   "link": "",
   "routes": [
-    {
-      "url": "/",
-      "path": "src/routes/index.tsx",
-      "jsName": "BlogHome"
-    },
-    {
-      "url": "/posts/$slug",
-      "path": "src/routes/posts.$slug.tsx",
-      "jsName": "BlogPost"
-    },
-    {
-      "url": "/category/$category",
-      "path": "src/routes/category.$category.tsx",
-      "jsName": "BlogCategory"
-    }
-  ],
-  "integrations": [
-    {
-      "type": "vite-plugin",
-      "import": "import contentCollections from '@content-collections/vite'",
-      "code": "contentCollections()"
-    }
+    {"url": "/", "path": "src/routes/index.tsx", "jsName": "BlogHome"},
+    {"url": "/posts/$slug", "path": "src/routes/posts.$slug.tsx", "jsName": "BlogPost"},
+    {"url": "/category/$category", "path": "src/routes/category.$category.tsx", "jsName": "BlogCategory"}
   ],
+  "integrations": [{"type": "vite-plugin", "import": "import contentCollections from '@content-collections/vite'", "code": "contentCollections()"}],
   "dependsOn": [],
   "variables": [],
-  "bareBones": {
-    "deleteFiles": [
-      "public/jungle.jpg",
-      "public/mountains.jpg",
-      "public/snorkeling.jpg",
-      "public/waterfall.jpg"
-    ]
+  "bareBones": {"deleteFiles": ["public/jungle.jpg", "public/mountains.jpg", "public/snorkeling.jpg", "public/waterfall.jpg"]},
+  "packageFileDescriptions": {
+    "content-collections.ts": "Content Collections config: posts schema (title, summary, categories, slug, image, date).",
+    "content/posts/beach.md": "Blog post: beach adventure.",
+    "content/posts/jungle.md.ejs": "Blog post template: jungle adventure.",
+    "content/posts/mountains.md.ejs": "Blog post template: mountains adventure.",
+    "content/posts/snorkeling.md.ejs": "Blog post template: snorkeling adventure.",
+    "content/posts/waterfall.md.ejs": "Blog post template: waterfall adventure.",
+    "src/styles.css": "Global styles: Tailwind, prose, highlight.js.",
+    "src/routes/index.tsx": "Blog home: post list, VacayAssistant.",
+    "src/routes/posts.$slug.tsx": "Post detail route: single post by slug.",
+    "src/routes/category.$category.tsx": "Category route: posts filtered by category.",
+    "src/routes/api.blog-chat.ts": "POST handler for blog AI chat with getPostBySlug, getAllBlogPosts tools.",
+    "src/routes/__root.tsx": "Root layout: Header, styles, TanStack Devtools.",
+    "src/lib/utils.ts": "cn() helper for conditional Tailwind class merging.",
+    "src/lib/blog-tools.ts": "AI tools: getPostBySlug, getAllBlogPosts, getPostsByCategory for VacayAssistant.",
+    "src/lib/blog-ai-hook.ts": "useBlogChat hook for /api/blog-chat.",
+    "src/components/ui/card.tsx": "Card UI component.",
+    "src/components/blog-posts.tsx": "Blog post list/card display component.",
+    "src/components/VacayAssistant.tsx": "AI assistant for blog Q&A.",
+    "src/components/Header.tsx": "Site header with nav."
   }
 }

package/examples/calculator/assets/AGENTS.md.append

@@ -0,0 +1,9 @@
+### Calculator Component
+
+iOS-style calculator built with React `useReducer` for state management.
+
+**State pattern:** `display`, `previousValue`, `operation`, `overwrite`
+
+**Actions:** ADD_DIGIT, CHOOSE_OPERATION, EVALUATE, CLEAR, DELETE_DIGIT, PERCENT, TOGGLE_SIGN
+
+No special dependencies beyond base TanStack Start. Pure React + Tailwind CSS.

package/examples/calculator/info.json

@@ -6,14 +6,14 @@
   "type": "example",
   "priority": 10,
   "link": "",
-  "routes": [
-    {
-      "url": "/",
-      "path": "src/routes/index.tsx",
-      "jsName": "Home"
-    }
-  ],
+  "routes": [{"url": "/", "path": "src/routes/index.tsx", "jsName": "Home"}],
   "integrations": [],
   "dependsOn": [],
-  "variables": []
+  "variables": [],
+  "packageFileDescriptions": {
+    "src/routes/index.tsx": "Home route: renders Calculator component.",
+    "src/routes/__root.tsx": "Root layout: HTML shell, styles.",
+    "src/components/Calculator.tsx": "iOS-style calculator: digits, operations, evaluate, clear, percent.",
+    "src/components/Header.tsx": "Header component."
+  }
 }

package/examples/dashboard/assets/AGENTS.md.append

@@ -0,0 +1,12 @@
+### Chart.js Dashboard
+
+Analytics dashboard with Chart.js and react-chartjs-2.
+
+**Dependencies:** chart.js, react-chartjs-2
+
+**Chart types:**
+- Bar - Revenue by month
+- Line - User growth
+- Doughnut - Sales by category
+
+**Setup:** Register Chart.js components before use (CategoryScale, LinearScale, BarElement, LineElement, PointElement, ArcElement, Title, Tooltip, Legend, Filler).

package/examples/dashboard/info.json

@@ -6,14 +6,13 @@
   "type": "example",
   "priority": 10,
   "link": "",
-  "routes": [
-    {
-      "url": "/",
-      "path": "src/routes/index.tsx",
-      "jsName": "Home"
-    }
-  ],
+  "routes": [{"url": "/", "path": "src/routes/index.tsx", "jsName": "Home"}],
   "integrations": [],
   "dependsOn": [],
-  "variables": []
+  "variables": [],
+  "packageFileDescriptions": {
+    "src/routes/index.tsx": "Dashboard home: Bar, Line, Doughnut charts (revenue, users, sales).",
+    "src/routes/__root.tsx": "Root layout: Header, styles.",
+    "src/components/Header.tsx": "Header component."
+  }
 }

package/examples/ecommerce/assets/AGENTS.md.append

@@ -0,0 +1,22 @@
+### Ecommerce Integration
+
+Motorcycle ecommerce site with Stripe checkout and AI shopping assistant.
+
+**Stripe checkout:**
+- `createCheckoutSession` server function in `src/lib/stripe.server.ts`
+- BuyButton component redirects to Stripe Checkout
+- Routes: `/checkout/success`, `/checkout/cancel`
+
+**AI tools available:**
+- `getMotorcycles` - Get all motorcycles from catalog
+- `recommendMotorcycle` - Display motorcycle recommendation card (MUST use for recommendations; do not write recommendations manually)
+
+**Dependencies:** stripe, @tanstack/ai, streamdown
+
+## Environment Variables
+
+```
+STRIPE_SECRET_KEY=...  # Required for checkout
+```
+
+For AI assistant: ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, or OLLAMA_BASE_URL (same as ai add-on).

package/examples/ecommerce/info.json

@@ -7,34 +7,31 @@
   "priority": 10,
   "link": "",
   "routes": [
-    {
-      "url": "/",
-      "name": "Home",
-      "path": "src/routes/index.tsx",
-      "jsName": "MotorcyclesIndex"
-    },
-    {
-      "url": "/motorcycles/$motorcycleId",
-      "path": "src/routes/motorcycles/$motorcycleId.tsx",
-      "jsName": "MotorcycleDetail"
-    },
-    {
-      "url": "/checkout/success",
-      "path": "src/routes/checkout/success.tsx",
-      "jsName": "CheckoutSuccess"
-    },
-    {
-      "url": "/checkout/cancel",
-      "path": "src/routes/checkout/cancel.tsx",
-      "jsName": "CheckoutCancel"
-    },
-    {
-      "url": "/api/motorcycle-chat",
-      "path": "src/routes/api.motorcycle-chat.ts",
-      "jsName": "MotorcycleChatAPI"
-    }
+    {"url": "/", "name": "Home", "path": "src/routes/index.tsx", "jsName": "MotorcyclesIndex"},
+    {"url": "/motorcycles/$motorcycleId", "path": "src/routes/motorcycles/$motorcycleId.tsx", "jsName": "MotorcycleDetail"},
+    {"url": "/checkout/success", "path": "src/routes/checkout/success.tsx", "jsName": "CheckoutSuccess"},
+    {"url": "/checkout/cancel", "path": "src/routes/checkout/cancel.tsx", "jsName": "CheckoutCancel"},
+    {"url": "/api/motorcycle-chat", "path": "src/routes/api.motorcycle-chat.ts", "jsName": "MotorcycleChatAPI"}
   ],
   "integrations": [],
   "dependsOn": [],
-  "variables": []
+  "variables": [],
+  "packageFileDescriptions": {
+    "src/routes/index.tsx": "Motorcycle catalog home with MotorcycleAIAssistant.",
+    "src/routes/motorcycles/$motorcycleId.tsx": "Motorcycle detail page with BuyButton, recommendation.",
+    "src/routes/checkout/success.tsx": "Stripe checkout success page.",
+    "src/routes/checkout/cancel.tsx": "Stripe checkout cancel page.",
+    "src/routes/api.motorcycle-chat.ts": "POST handler for motorcycle AI chat with getMotorcycles, recommendMotorcycle tools.",
+    "src/routes/__root.tsx": "Root layout: Header, styles.",
+    "src/styles.css": "Global styles: Tailwind, prose.",
+    "src/data/motorcycles.ts": "Motorcycle catalog data.",
+    "src/lib/motorcycle-tools.ts": "AI tools: getMotorcycles, recommendMotorcycle.",
+    "src/lib/motorcycle-ai-hook.ts": "useMotorcycleChat hook for /api/motorcycle-chat.",
+    "src/lib/stripe.server.ts": "Stripe server utilities for checkout.",
+    "src/store/motorcycle-assistant.ts": "Zustand store for assistant open state.",
+    "src/components/Header.tsx": "Header with nav.",
+    "src/components/MotorcycleAIAssistant.tsx": "AI shopping assistant component.",
+    "src/components/MotorcycleRecommendation.tsx": "Motorcycle recommendation card display.",
+    "src/components/BuyButton.tsx": "Stripe checkout button component."
+  }
 }

package/examples/events/assets/AGENTS.md.append

@@ -0,0 +1,21 @@
+### Conference Site Integration
+
+Pastry conference website with Content Collections (speakers, talks) and Remy AI assistant.
+
+**Content Collections:**
+- `speakers` - name, title, specialty, restaurant, headshot, awards
+- `talks` - title, speaker, duration, topics, image
+- Schemas in `content-collections.ts`
+
+**AI tools available (RemyAssistant):**
+- `getSpeakerBySlug` - Get speaker profile by slug
+- `getTalkBySlug` - Get talk details by slug
+- `getAllSpeakers` - List all speakers
+- `getAllTalks` - List all talks
+- `getSchedule` - Get full schedule
+
+**Components:** HeroCarousel (background images), RemyAssistant (conference Q&A)
+
+## Environment Variables
+
+For AI: ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, or OLLAMA_BASE_URL (same as ai add-on).