leadcode 1.0.0 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # LeadCode
 
-**Your virtual Lead Tech for Claude Code.** An MCP server that analyzes your codebase, detects structural gaps, and generates a tailored `CLAUDE.md` — so Claude Code understands your project like a senior engineer would.
+**Your virtual Lead Tech for Claude Code.** An MCP server that analyzes your codebase, fetches up-to-date documentation for each detected technology via [Context7](https://context7.com), and generates a tailored `CLAUDE.md` — so Claude Code understands your project like a senior engineer would.
 
 [![npm version](https://img.shields.io/npm/v/leadcode.svg)](https://www.npmjs.com/package/leadcode)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
@@ -17,34 +17,42 @@ Claude Code is powerful, but its output quality depends on context. Without clea
 - Forget auth checks on new routes
 - Use inline styles when your project uses Tailwind
 
-**LeadCode fixes this.** It scans your project, detects what you're using, identifies what's missing, and generates a `CLAUDE.md` file that tells Claude Code exactly how to behave in your codebase.
+**LeadCode fixes this.** It scans your project, detects what you're using, fetches the latest documentation for each technology, cross-references them, and generates a `CLAUDE.md` file that tells Claude Code exactly how to behave in your codebase.
 
 ## How It Works
 
 ```
-Your Project ──→ LeadCode ──→ CLAUDE.md ──→ Claude Code knows your rules
+Your Project ──→ LeadCode (detect stack) ──→ Context7 (fetch docs) ──→ CLAUDE.md
 ```
 
 1. **Analyze** — Scans `package.json`, directory structure, and source code patterns
-2. **Detect** — Identifies your stack across 22 categories (framework, ORM, auth, CSS, testing, i18n, etc.)
-3. **Find Gaps** — Detects structural issues (missing error boundaries, no test setup, no validation, etc.)
-4. **Suggest** — Proposes options (simple / clean / scalable) for each gap, with pros, cons, and Claude impact
-5. **Generate** — Writes a structured `CLAUDE.md` with conventions, interdictions, and cross-stack rules
+2. **Detect** — Identifies your stack across 25+ categories (framework, ORM, auth, CSS, testing, i18n, etc.)
+3. **Fetch Docs** — Queries Context7 API for up-to-date documentation of each detected technology, including cross-technology best practices (e.g., "how to use Prisma with Next.js App Router")
+4. **Generate** — Writes a structured `CLAUDE.md` with real, version-specific conventions from official docs
 
 ## Installation
 
-LeadCode is an MCP server — it's used through Claude Code, not as a standalone CLI.
+LeadCode requires **two MCP servers**: LeadCode itself and Context7 (for documentation fetching).
 
-**One command:**
+**Two commands:**
 
 ```bash
 claude mcp add --scope project leadcode -- npx -y leadcode@latest
+claude mcp add --scope project context7 -- npx -y @upstash/context7-mcp@latest
 ```
 
-That's it. Restart Claude Code and LeadCode's tools are available.
+Restart Claude Code and you're ready.
 
 > Use `--scope user` instead of `--scope project` to install globally across all your projects.
 
+**Optional:** Set a Context7 API key for higher rate limits (free tier works without it):
+
+```bash
+export CONTEXT7_API_KEY=your_key_here
+```
+
+Get a key at [context7.com/dashboard](https://context7.com/dashboard).
+
 ## Usage
 
 ### Quick Start (Recommended)
@@ -55,7 +63,7 @@ Use the built-in prompt in Claude Code:
 Use the setup-project prompt with /path/to/your/project
 ```
 
-This walks through the full workflow: analyze → detect gaps → suggest fixes → ask your preferences → generate `CLAUDE.md`.
+This walks through the full workflow: analyze → fetch docs → generate `CLAUDE.md`.
 
 ### Manual Tool Usage
 
@@ -68,50 +76,47 @@ Scans a project and returns structured facts — framework, dependencies, direct
 Call analyze-repo with projectPath: /path/to/project
 ```
 
-#### `detect-gaps`
-Takes the analysis output and identifies structural gaps (missing error handling, no tests, no validation schemas, etc.).
-
-#### `suggest-conventions`
-Proposes options for each gap. Each suggestion includes:
-- **Simple** — Minimal setup, quick wins
-- **Clean** — Best practices, good DX
-- **Scalable** — Full setup for large projects
+#### `fetch-docs`
+Takes the analysis output and fetches up-to-date documentation from Context7 for each detected technology. Also fetches cross-technology docs (e.g., Next.js + Prisma best practices).
 
 #### `generate-claude-md`
-Generates and writes `CLAUDE.md` to the project root based on the analysis and your choices.
+Generates and writes `CLAUDE.md` to the project root based on the analysis and fetched documentation.
 
 #### `validate-claude-md`
 Checks if an existing `CLAUDE.md` is still in sync with the project. Detects drifts after adding dependencies or changing structure.
 
 #### `update-claude-md`
-Re-analyzes and regenerates `CLAUDE.md` while preserving your choices from the "Project Decisions" section.
+Re-analyzes the project, re-fetches documentation, and regenerates `CLAUDE.md` while preserving your choices from the "Project Decisions" section.
 
 ## What Gets Detected
 
 ### Frameworks
-Next.js (App/Pages Router), Nuxt, Remix, Astro, SvelteKit, SolidStart, Vite+React, Express, Fastify, Hono
+Next.js (App/Pages Router), Nuxt, Remix, Astro, SvelteKit, SolidStart, Vite+React, React, Express, Fastify, Hono
 
-### Stack (22 categories)
+### Stack (25+ categories)
 
 | Category | Examples |
 |----------|----------|
-| ORM | Prisma, Drizzle, TypeORM, Mongoose, Kysely |
-| Auth | NextAuth, Clerk, Lucia, Supabase Auth, Auth0, Kinde |
-| Validation | Zod, Yup, Joi, Valibot |
-| CSS | Tailwind, styled-components, Emotion, PandaCSS |
-| UI Components | shadcn (auto-detected), Radix, MUI, Chakra, Headless UI |
+| ORM | Prisma, Drizzle, TypeORM, MikroORM, Mongoose, Kysely, Sequelize |
+| Auth | NextAuth, Clerk, Lucia, Supabase Auth, Auth0, Kinde, Better Auth |
+| Validation | Zod, Yup, Joi, Valibot, ArkType |
+| CSS | Tailwind, Chakra, MUI, styled-components, Emotion, Panda, Mantine, Ant Design |
+| UI Components | shadcn (auto-detected), Radix, Headless UI, NextUI, Tremor |
 | Testing | Vitest, Jest, Playwright, Cypress |
-| State | Zustand, Redux, Jotai, Valtio, XState |
-| i18n | next-intl, i18next |
+| State | Zustand, Redux, Jotai, Valtio, XState, Recoil, MobX |
+| Data Fetching | TanStack Query, SWR |
+| Forms | React Hook Form, Formik, TanStack Form |
+| i18n | next-intl, i18next, Lingui, react-intl |
 | Payments | Stripe, LemonSqueezy |
-| CMS | Contentlayer, MDX, Sanity, Notion |
-| Email | Resend, Nodemailer, SendGrid |
+| CMS | Contentlayer, MDX, Sanity, Notion, Contentful, Strapi |
+| Email | Resend, Nodemailer, SendGrid, Postmark, React Email |
 | File Upload | UploadThing, Vercel Blob, Multer, S3 |
 | Realtime | Socket.io, Pusher, Ably |
 | Jobs | BullMQ, Inngest, Trigger.dev |
-| Database | PostgreSQL, MySQL, SQLite, MongoDB, Supabase |
+| Database | PostgreSQL, MySQL, SQLite, MongoDB, Supabase, PlanetScale, Redis |
+| API Style | tRPC, GraphQL |
 | Monorepo | Turborepo, Nx, Lerna |
-| Deployment | Vercel, Netlify, Docker, Fly.io, Railway |
+| Deployment | Vercel |
 | Runtime | Node, Bun, Deno |
 
 ### Code Patterns
@@ -124,29 +129,29 @@ Next.js (App/Pages Router), Nuxt, Remix, Astro, SvelteKit, SolidStart, Vite+Reac
 
 ## What Gets Generated
 
-The `CLAUDE.md` includes up to 11 sections, all tailored to your stack:
+The `CLAUDE.md` includes sections tailored to your stack:
 
 1. **Architecture Overview** — Framework, data layer, auth, project size
-2. **Stack** — All detected technologies
+2. **Stack** — All detected technologies with versions
 3. **Project Structure** — Directories, special files
 4. **Available Scripts** — `npm run` commands
-5. **File & Naming Conventions** — kebab-case, PascalCase rules
-6. **Import Ordering** — Node builtins → external → internal → relative → types
-7. **Conventions** — Stack-specific rules Claude must follow
-8. **Cross-Stack Rules** — Rules for technology combinations (e.g., Next.js + Prisma)
-9. **Interdictions** — Things Claude must never do
-10. **Existing Code Patterns** — Patterns detected in your code to respect
-11. **Claude Code Instructions** — Dynamic instructions based on your stack
+5. **Per-Technology Conventions** — Up-to-date best practices from official docs (via Context7)
+6. **Cross-Stack Rules** — Best practices for technology combinations (e.g., Next.js + Prisma, Zod + react-hook-form)
+7. **File & Naming Conventions** — kebab-case, PascalCase rules
+8. **Import Ordering** — Node builtins → external → internal → relative → types
+9. **Existing Code Patterns** — Patterns detected in your code to respect
+10. **Claude Code Instructions** — Dynamic instructions based on your stack
 
-### Cross-Stack Rules (18 combinations)
+### Cross-Technology Documentation
 
-LeadCode generates specific rules for technology pairs:
+LeadCode fetches specific documentation for technology pairs detected in your project:
 
-`next + prisma` · `next + drizzle` · `next + next-auth` · `next + clerk` · `next + supabase-auth` · `next + trpc` · `next + stripe` · `next + next-intl` · `next + react-query` · `next + zod` · `prisma + next-auth` · `prisma + zod` · `trpc + zod` · `express + prisma` · `fastify + prisma` · `tailwind + shadcn` · `tailwind + react`
+`next + prisma` · `next + drizzle` · `next + next-auth` · `next + clerk` · `next + supabase-auth` · `next + zod` · `next + stripe` · `next + react-query` · `next + next-intl` · `next + tailwind` · `next + shadcn` · `zod + react-hook-form` · `trpc + zod` — and more.
 
 ## Requirements
 
 - **Node.js** >= 18
+- **Context7 MCP server** installed alongside LeadCode
 - The target project must have a `package.json`
 - Currently optimized for JavaScript/TypeScript projects
 
@@ -156,7 +161,7 @@ LeadCode generates specific rules for technology pairs:
 - **Single package.json** — Monorepo support detects the tool but analyzes only the root
 - **No lint config reading** — Detects ESLint/Biome but doesn't parse their rules
 - **No CI/CD detection** — GitHub Actions, etc. are not analyzed
-- **No test quality analysis** — Detects the runner but doesn't evaluate test coverage
+- **Requires Context7** — Documentation quality depends on Context7's library coverage
 
 ## Contributing
 

package/dist/context7/fetch-all.d.ts

@@ -0,0 +1,13 @@
+import type { RepoAnalysis } from "../types.js";
+export interface FetchedDocs {
+    techDocs: Record<string, string>;
+    crossDocs: Record<string, string>;
+    metadata: {
+        techCount: number;
+        snippetCount: number;
+        failedTechs: string[];
+        warning?: string;
+    };
+}
+export declare function fetchAllDocs(analysis: RepoAnalysis): Promise<FetchedDocs>;
+//# sourceMappingURL=fetch-all.d.ts.map

package/dist/context7/fetch-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-all.d.ts","sourceRoot":"","sources":["../../src/context7/fetch-all.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAiDD,wBAAsB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA+E/E"}

package/dist/context7/fetch-all.js

@@ -0,0 +1,104 @@
+import { resolveAndFetch } from "./client.js";
+import { TECH_QUERIES } from "./queries.js";
+/** Collect all detected tech identifiers from analysis */
+function collectTechs(analysis) {
+    const techs = [];
+    if (analysis.framework) {
+        techs.push(analysis.framework.name);
+    }
+    const d = analysis.detected;
+    const fields = [
+        "orm", "auth", "validation", "css", "testing",
+        "stateManagement", "dataFetching", "formLibrary", "apiStyle",
+        "i18n", "payments", "realtime", "email", "cms", "jobs",
+        "uiComponents",
+    ];
+    for (const field of fields) {
+        const value = d[field];
+        if (typeof value === "string") {
+            techs.push(value);
+        }
+    }
+    return [...new Set(techs)];
+}
+/** Run promises with concurrency limit */
+async function pMap(items, fn, concurrency) {
+    const results = [];
+    let index = 0;
+    async function next() {
+        while (index < items.length) {
+            const i = index++;
+            results[i] = await fn(items[i]);
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, items.length) }, () => next());
+    await Promise.all(workers);
+    return results;
+}
+export async function fetchAllDocs(analysis) {
+    const techs = collectTechs(analysis);
+    const techDocs = {};
+    const crossDocs = {};
+    const failedTechs = [];
+    let snippetCount = 0;
+    // Fetch per-tech docs
+    const techTasks = techs
+        .filter((t) => t in TECH_QUERIES)
+        .map((tech) => ({
+        tech,
+        query: TECH_QUERIES[tech],
+    }));
+    await pMap(techTasks, async ({ tech, query }) => {
+        const allQueries = query.queries.join(". ");
+        const docs = await resolveAndFetch(query.libraryName, allQueries);
+        if (docs) {
+            techDocs[tech] = docs;
+            snippetCount++;
+        }
+        else {
+            failedTechs.push(tech);
+        }
+    }, 5);
+    // Fetch cross-tech docs
+    const crossTasks = [];
+    for (const tech of techs) {
+        const mapping = TECH_QUERIES[tech];
+        if (!mapping?.crossQueries)
+            continue;
+        for (const [otherTech, crossQuery] of Object.entries(mapping.crossQueries)) {
+            if (techs.includes(otherTech)) {
+                const key = `${tech}+${otherTech}`;
+                const reverseKey = `${otherTech}+${tech}`;
+                if (!(reverseKey in crossDocs) && !crossTasks.some((t) => t.key === reverseKey)) {
+                    crossTasks.push({ key, libraryName: mapping.libraryName, query: crossQuery });
+                }
+            }
+        }
+    }
+    await pMap(crossTasks, async ({ key, libraryName, query }) => {
+        const docs = await resolveAndFetch(libraryName, query);
+        if (docs) {
+            crossDocs[key] = docs;
+            snippetCount++;
+        }
+    }, 5);
+    // Track techs with no mapping at all
+    for (const tech of techs) {
+        if (!(tech in TECH_QUERIES) && !failedTechs.includes(tech)) {
+            failedTechs.push(tech);
+        }
+    }
+    return {
+        techDocs,
+        crossDocs,
+        metadata: {
+            techCount: Object.keys(techDocs).length,
+            snippetCount,
+            failedTechs,
+            ...(failedTechs.length > 0 && {
+                warning: `No documentation found for: ${failedTechs.join(", ")}`,
+            }),
+        },
+    };
+}
+//# sourceMappingURL=fetch-all.js.map

package/dist/context7/fetch-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-all.js","sourceRoot":"","sources":["../../src/context7/fetch-all.ts"],"names":[],"mappings":"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"}

package/dist/context7/index.d.ts

@@ -1,5 +1,7 @@
 export { searchLibrary, fetchDocs, resolveAndFetch } from "./client.js";
 export { TECH_QUERIES } from "./queries.js";
+export { fetchAllDocs } from "./fetch-all.js";
 export type { LibrarySearchResult, DocSnippet } from "./client.js";
 export type { TechQuery } from "./queries.js";
+export type { FetchedDocs } from "./fetch-all.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/context7/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context7/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/context7/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/context7/index.js

@@ -1,3 +1,4 @@
 export { searchLibrary, fetchDocs, resolveAndFetch } from "./client.js";
 export { TECH_QUERIES } from "./queries.js";
+export { fetchAllDocs } from "./fetch-all.js";
 //# sourceMappingURL=index.js.map

package/dist/context7/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context7/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/context7/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/data/tech-queries.d.ts

@@ -0,0 +1,11 @@
+export interface TechQuery {
+    libraryName: string;
+    queries: string[];
+    crossQueries?: Record<string, string>;
+}
+/**
+ * Maps detected tech identifiers to Context7 library names and relevant queries.
+ * This is NOT hardcoded rules — just "what to ask" for each technology.
+ */
+export declare const TECH_QUERIES: Record<string, TechQuery>;
+//# sourceMappingURL=tech-queries.d.ts.map

package/dist/data/tech-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-queries.d.ts","sourceRoot":"","sources":["../../src/data/tech-queries.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CA8OlD,CAAC"}

package/dist/data/tech-queries.js

@@ -0,0 +1,229 @@
+/**
+ * Maps detected tech identifiers to Context7 library names and relevant queries.
+ * This is NOT hardcoded rules — just "what to ask" for each technology.
+ */
+export const TECH_QUERIES = {
+    // Frameworks
+    next: {
+        libraryName: "next.js",
+        queries: [
+            "App Router conventions, Server Components vs Client Components, when to use 'use client'",
+            "Server Actions best practices, data fetching patterns, caching strategies",
+        ],
+        crossQueries: {
+            prisma: "Using Prisma with Next.js App Router, server-only imports, singleton pattern, data access layer",
+            drizzle: "Using Drizzle ORM with Next.js, server-only database queries",
+            "next-auth": "NextAuth.js v5 setup with Next.js App Router, middleware auth, session in Server Components",
+            clerk: "Clerk authentication with Next.js App Router, middleware, server-side auth",
+            "supabase-auth": "Supabase Auth with Next.js App Router, server client, middleware session refresh",
+            zod: "Zod validation in Next.js Server Actions and Route Handlers",
+            stripe: "Stripe payments and webhooks in Next.js, server-only SDK, webhook route handler",
+            "react-query": "React Query with Next.js App Router, HydrationBoundary, prefetching in Server Components",
+            "next-intl": "next-intl setup with App Router, middleware locale detection, Server Components i18n",
+            tailwind: "Tailwind CSS with Next.js, configuration, dark mode",
+            shadcn: "shadcn/ui with Next.js, component installation, theming",
+        },
+    },
+    nuxt: {
+        libraryName: "nuxt",
+        queries: ["Nuxt 3 conventions, composables, server routes, auto-imports"],
+    },
+    remix: {
+        libraryName: "remix",
+        queries: ["Remix loaders and actions, data loading patterns, form handling"],
+    },
+    astro: {
+        libraryName: "astro",
+        queries: ["Astro components, islands architecture, content collections"],
+    },
+    sveltekit: {
+        libraryName: "sveltekit",
+        queries: ["SvelteKit load functions, form actions, server-side rendering"],
+    },
+    "solid-start": {
+        libraryName: "solid-start",
+        queries: ["SolidStart routing, server functions, data loading"],
+    },
+    "vite-react": {
+        libraryName: "vite",
+        queries: ["Vite React project configuration, plugins, build optimization"],
+    },
+    react: {
+        libraryName: "react",
+        queries: ["React hooks best practices, component patterns, performance optimization"],
+    },
+    express: {
+        libraryName: "express",
+        queries: ["Express.js middleware patterns, error handling, route organization"],
+    },
+    fastify: {
+        libraryName: "fastify",
+        queries: ["Fastify plugins, schema validation, hooks lifecycle"],
+    },
+    hono: {
+        libraryName: "hono",
+        queries: ["Hono middleware, routing, request handling patterns"],
+    },
+    // ORM / Database
+    prisma: {
+        libraryName: "prisma",
+        queries: ["Prisma client singleton, connection pooling, best practices, select vs include"],
+    },
+    drizzle: {
+        libraryName: "drizzle-orm",
+        queries: ["Drizzle ORM schema definition, queries, migrations, best practices"],
+    },
+    typeorm: {
+        libraryName: "typeorm",
+        queries: ["TypeORM entity patterns, repository pattern, migrations"],
+    },
+    kysely: {
+        libraryName: "kysely",
+        queries: ["Kysely query builder patterns, type-safe queries"],
+    },
+    mongoose: {
+        libraryName: "mongoose",
+        queries: ["Mongoose schema design, middleware, connection management"],
+    },
+    // Auth
+    "next-auth": {
+        libraryName: "next-auth",
+        queries: ["NextAuth.js v5 configuration, providers, session management, middleware"],
+    },
+    clerk: {
+        libraryName: "clerk",
+        queries: ["Clerk authentication setup, middleware, server-side auth, user management"],
+    },
+    "better-auth": {
+        libraryName: "better-auth",
+        queries: ["Better Auth setup, session management, providers"],
+    },
+    auth0: {
+        libraryName: "auth0",
+        queries: ["Auth0 SDK setup, authentication flow, token management"],
+    },
+    // Validation
+    zod: {
+        libraryName: "zod",
+        queries: ["Zod schema patterns, parse vs safeParse, type inference, error handling"],
+        crossQueries: {
+            "react-hook-form": "Zod resolver with react-hook-form, shared schemas for forms and API validation",
+        },
+    },
+    valibot: {
+        libraryName: "valibot",
+        queries: ["Valibot schema validation, tree-shaking, type inference"],
+    },
+    // CSS / UI
+    tailwind: {
+        libraryName: "tailwindcss",
+        queries: ["Tailwind CSS utility classes, configuration, responsive design, dark mode"],
+    },
+    shadcn: {
+        libraryName: "shadcn/ui",
+        queries: ["shadcn/ui component usage, theming, customization, cn utility"],
+    },
+    chakra: {
+        libraryName: "chakra-ui",
+        queries: ["Chakra UI component patterns, theming, responsive styles"],
+    },
+    mui: {
+        libraryName: "material-ui",
+        queries: ["Material UI component usage, theming, sx prop patterns"],
+    },
+    mantine: {
+        libraryName: "mantine",
+        queries: ["Mantine components, hooks, theming, form handling"],
+    },
+    // Testing
+    vitest: {
+        libraryName: "vitest",
+        queries: ["Vitest testing patterns, mocking, setup, configuration"],
+    },
+    jest: {
+        libraryName: "jest",
+        queries: ["Jest testing patterns, mocking, configuration, best practices"],
+    },
+    playwright: {
+        libraryName: "playwright",
+        queries: ["Playwright E2E testing, page objects, assertions, configuration"],
+    },
+    cypress: {
+        libraryName: "cypress",
+        queries: ["Cypress E2E testing, commands, fixtures, best practices"],
+    },
+    // State
+    zustand: {
+        libraryName: "zustand",
+        queries: ["Zustand store patterns, middleware, persist, selectors"],
+    },
+    redux: {
+        libraryName: "redux-toolkit",
+        queries: ["Redux Toolkit slices, createAsyncThunk, RTK Query"],
+    },
+    jotai: {
+        libraryName: "jotai",
+        queries: ["Jotai atom patterns, derived atoms, async atoms"],
+    },
+    // Data fetching
+    "react-query": {
+        libraryName: "tanstack-query",
+        queries: ["TanStack Query patterns, mutations, invalidation, caching strategies"],
+    },
+    swr: {
+        libraryName: "swr",
+        queries: ["SWR data fetching, revalidation, mutation, error handling"],
+    },
+    // Forms
+    "react-hook-form": {
+        libraryName: "react-hook-form",
+        queries: ["React Hook Form usage, register, Controller, validation integration"],
+    },
+    // API
+    trpc: {
+        libraryName: "trpc",
+        queries: ["tRPC router setup, procedures, middleware, input validation with Zod"],
+        crossQueries: {
+            zod: "tRPC with Zod input validation, end-to-end type safety",
+        },
+    },
+    // Payments
+    stripe: {
+        libraryName: "stripe",
+        queries: ["Stripe API integration, webhooks, checkout, payment intents"],
+    },
+    // Email
+    resend: {
+        libraryName: "resend",
+        queries: ["Resend email API, sending emails, React Email templates"],
+    },
+    // i18n
+    "next-intl": {
+        libraryName: "next-intl",
+        queries: ["next-intl middleware, Server Components, message organization"],
+    },
+    i18next: {
+        libraryName: "i18next",
+        queries: ["i18next configuration, namespaces, interpolation, react-i18next"],
+    },
+    // CMS
+    sanity: {
+        libraryName: "sanity",
+        queries: ["Sanity CMS setup, GROQ queries, studio configuration"],
+    },
+    contentful: {
+        libraryName: "contentful",
+        queries: ["Contentful API, content delivery, content management"],
+    },
+    // Realtime
+    "socket.io": {
+        libraryName: "socket.io",
+        queries: ["Socket.IO setup, events, rooms, namespaces, error handling"],
+    },
+    // Jobs
+    inngest: {
+        libraryName: "inngest",
+        queries: ["Inngest function patterns, event-driven workflows, retries"],
+    },
+};
+//# sourceMappingURL=tech-queries.js.map

package/dist/data/tech-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tech-queries.js","sourceRoot":"","sources":["../../src/data/tech-queries.ts"],"names":[],"mappings":"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"}