leadcode 1.0.0 → 1.2.0

package/dist/index.js

@@ -2,44 +2,177 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import * as z from "zod";
 import { registerAnalyzeRepo } from "./tools/analyze-repo.js";
-import { registerFetchDocs } from "./tools/fetch-docs.js";
 import { registerGenerateClaudeMd } from "./tools/generate-claude-md.js";
 import { registerValidateClaudeMd } from "./tools/validate-claude-md.js";
-import { registerUpdateClaudeMd } from "./tools/update-claude-md.js";
+import { registerTechQueriesResource } from "./resources/tech-queries.js";
 const server = new McpServer({
     name: "leadcode",
-    version: "1.0.0",
+    version: "1.1.0",
 });
 // Register tools
 registerAnalyzeRepo(server);
-registerFetchDocs(server);
 registerGenerateClaudeMd(server);
 registerValidateClaudeMd(server);
-registerUpdateClaudeMd(server);
+// Register resources
+registerTechQueriesResource(server);
 // Register prompts
-server.prompt("setup-project", "Full LeadCode workflow: analyze repo → fetch documentation → generate CLAUDE.md with up-to-date conventions.", {
-    projectPath: z.string().describe("Absolute path to the project root"),
+server.prompt("setup-project", "Generate a CLAUDE.md for a project. Use when the user wants to setup, init, configure, or generate rules/CLAUDE.md for any project.", {
+    projectPath: z.string().describe("Absolute path to the project root. Use the current working directory if not specified."),
     language: z.string().optional().describe("Output language: 'fr' for French, 'en' for English (default: en)"),
 }, ({ projectPath, language }) => {
     const isFr = language === "fr";
     const steps = isFr
         ? [
-            `Configure LeadCode pour le projet à ${projectPath}. Suis ces étapes :`,
+            `Tu configures LeadCode pour le projet à ${projectPath}. Suis ces étapes dans l'ordre :`,
             "",
-            `1. Lance analyze-repo avec projectPath="${projectPath}" pour scanner le projet et détecter le stack.`,
-            "2. Lance fetch-docs avec l'analyse pour récupérer la documentation à jour de chaque technologie détectée via Context7.",
-            "3. Présente un résumé clair : stack détecté, documentation récupérée, techs sans documentation.",
-            "4. Lance generate-claude-md avec l'analyse et la documentation pour créer le CLAUDE.md.",
+            "## Étape 1 : Analyser le projet",
             "",
-            "Explique chaque étape simplement. Réponds en français.",
+            `Appelle l'outil analyze-repo avec projectPath="${projectPath}".`,
+            "Présente un résumé clair du stack détecté (framework, ORM, auth, CSS, testing, etc.).",
+            "",
+            "## Étape 2 : Lire le mapping tech-queries",
+            "",
+            'Lis la ressource LeadCode "leadcode://tech-queries".',
+            "Elle contient pour chaque technologie détectée :",
+            "- libraryName : le nom de la librairie sur Context7",
+            "- queries : les questions à poser",
+            "- crossQueries : les questions pour les combinaisons de techs",
+            "",
+            "## Étape 3 : Récupérer et synthétiser la documentation",
+            "",
+            "Pour chaque technologie détectée qui a un mapping dans tech-queries :",
+            "",
+            "a) Appelle l'outil Context7 resolve-library-id avec le libraryName et la query",
+            "b) Appelle l'outil Context7 query-docs avec l'ID résolu et les queries",
+            "c) SYNTHÉTISE les docs brutes en 3-5 règles concises et actionnables :",
+            "   - Conventions (organisation des fichiers, nommage, quand utiliser quoi)",
+            "   - Patterns importants (singleton, data access layer, etc.)",
+            "   - Pièges à éviter (restrictions d'import, limites runtime)",
+            "   - PAS de blocs de code complets — juste des exemples inline courts si nécessaire",
+            "",
+            "Pour les combinaisons cross-tech (ex: Next.js + Prisma) :",
+            "d) Si les deux techs sont détectées et qu'il y a une crossQuery, appelle Context7",
+            "e) Synthétise en 3-5 règles spécifiques à cette combinaison",
+            "",
+            "## Étape 4 : Construire le JSON docs",
+            "",
+            "Construis un objet JSON avec cette structure :",
+            '{ "techDocs": { "next": "- règle 1\\n- règle 2...", ... }, "crossDocs": { "next+prisma": "- règle 1...", ... } }',
+            "",
+            "## Étape 5 : Générer le CLAUDE.md",
+            "",
+            "Appelle generate-claude-md avec :",
+            "- analysis : le JSON de l'analyse (étape 1)",
+            "- docs : le JSON des docs synthétisées (étape 4)",
+            "",
+            "## Si Context7 n'est pas disponible",
+            "",
+            "Si les outils Context7 (resolve-library-id) ne sont pas disponibles,",
+            "passe directement à l'étape 5 sans docs. Informe l'utilisateur que la documentation",
+            "n'a pas pu être récupérée et que le CLAUDE.md ne contiendra que l'analyse du projet.",
+            "",
+            "Réponds en français.",
         ]
         : [
-            `Please set up LeadCode for the project at ${projectPath}. Follow these steps:`,
+            `You are setting up LeadCode for the project at ${projectPath}. Follow these steps in order:`,
+            "",
+            "## Step 1: Analyze the project",
+            "",
+            `Call the analyze-repo tool with projectPath="${projectPath}".`,
+            "Present a clear summary of the detected stack (framework, ORM, auth, CSS, testing, etc.).",
+            "",
+            "## Step 2: Read the tech-queries mapping",
+            "",
+            'Read the LeadCode resource "leadcode://tech-queries".',
+            "It contains for each detected technology:",
+            "- libraryName: the Context7 library identifier",
+            "- queries: questions to ask Context7",
+            "- crossQueries: questions for technology combinations",
+            "",
+            "## Step 3: Fetch and synthesize documentation",
+            "",
+            "For each detected technology that has a mapping in tech-queries:",
+            "",
+            "a) Call Context7 resolve-library-id with the libraryName and the query",
+            "b) Call Context7 query-docs with the resolved libraryId and the queries",
+            "c) SYNTHESIZE the raw docs into 3-5 concise, actionable rules:",
+            "   - Conventions (file organization, naming, when to use what)",
+            "   - Important patterns (singleton, data access layer, etc.)",
+            "   - Gotchas to avoid (import restrictions, runtime boundaries)",
+            "   - NO full code blocks — only short inline examples if needed",
+            "",
+            "For cross-technology combinations (e.g. Next.js + Prisma):",
+            "d) If both techs are detected and there is a crossQuery, call Context7",
+            "e) Synthesize into 3-5 rules specific to that combination",
+            "",
+            "## Step 4: Build the docs JSON",
+            "",
+            "Build a JSON object with this structure:",
+            '{ "techDocs": { "next": "- rule 1\\n- rule 2...", ... }, "crossDocs": { "next+prisma": "- rule 1...", ... } }',
+            "",
+            "## Step 5: Generate CLAUDE.md",
+            "",
+            "Call generate-claude-md with:",
+            "- analysis: the JSON from step 1",
+            "- docs: the JSON of synthesized docs from step 4",
+            "",
+            "## If Context7 is not available",
+            "",
+            "If Context7 tools (resolve-library-id) are not available,",
+            "skip to step 5 without docs. Inform the user that documentation",
+            "could not be fetched and the CLAUDE.md will only contain project analysis.",
+            "",
+            "Be thorough and explain the results clearly.",
+        ];
+    return {
+        messages: [
+            {
+                role: "user",
+                content: {
+                    type: "text",
+                    text: steps.join("\n"),
+                },
+            },
+        ],
+    };
+});
+server.prompt("update-project", "Update or refresh an existing CLAUDE.md. Re-analyzes the project, fetches fresh documentation, and regenerates while preserving user decisions.", {
+    projectPath: z.string().describe("Absolute path to the project root. Use the current working directory if not specified."),
+    language: z.string().optional().describe("Output language: 'fr' for French, 'en' for English (default: en)"),
+}, ({ projectPath, language }) => {
+    const isFr = language === "fr";
+    const steps = isFr
+        ? [
+            `Tu mets à jour le CLAUDE.md du projet à ${projectPath}.`,
+            "",
+            "## Étape préalable : Extraire les décisions existantes",
+            "",
+            `Lis le fichier ${projectPath}/CLAUDE.md s'il existe.`,
+            'Cherche la section "## Project Decisions".',
+            'Extrais toutes les entrées au format "- **Sujet**: Choix".',
+            "Garde-les pour l'étape finale.",
+            "",
+            "## Ensuite : même flow que setup-project",
+            "",
+            "Suis les mêmes étapes que setup-project (analyze → tech-queries → Context7 → synthèse → generate),",
+            "mais passe les décisions extraites en paramètre choices à generate-claude-md.",
+            "",
+            "Réponds en français.",
+        ]
+        : [
+            `You are updating the CLAUDE.md for the project at ${projectPath}.`,
+            "",
+            "## Preliminary step: Extract existing decisions",
+            "",
+            `Read the file ${projectPath}/CLAUDE.md if it exists.`,
+            'Look for the "## Project Decisions" section.',
+            'Extract all entries in the format "- **Topic**: Choice".',
+            "Keep them for the final step.",
+            "",
+            "## Then: same flow as setup-project",
             "",
-            `1. Call analyze-repo with projectPath="${projectPath}" to scan the project and detect the stack.`,
-            "2. Call fetch-docs with the analysis to fetch up-to-date documentation for each detected technology via Context7.",
-            "3. Present a summary: detected stack, fetched documentation, any techs without docs.",
-            "4. Call generate-claude-md with the analysis and docs to create the CLAUDE.md file.",
+            "Follow the same steps as setup-project (analyze → tech-queries → Context7 → synthesize → generate),",
+            "but pass the extracted decisions as the choices parameter to generate-claude-md.",
             "",
             "Be thorough and explain the results clearly.",
         ];
@@ -55,8 +188,8 @@ server.prompt("setup-project", "Full LeadCode workflow: analyze repo → fetch d
         ],
     };
 });
-server.prompt("validate-project", "Check if an existing CLAUDE.md is still in sync with the project", {
-    projectPath: z.string().describe("Absolute path to the project root"),
+server.prompt("validate-project", "Check if a CLAUDE.md is still up to date. Use when the user wants to validate, check, verify, or audit their CLAUDE.md.", {
+    projectPath: z.string().describe("Absolute path to the project root. Use the current working directory if not specified."),
     language: z.string().optional().describe("Output language: 'fr' for French, 'en' for English (default: en)"),
 }, ({ projectPath, language }) => {
     const isFr = language === "fr";
@@ -66,7 +199,7 @@ server.prompt("validate-project", "Check if an existing CLAUDE.md is still in sy
             "",
             `1. Lance validate-claude-md avec projectPath="${projectPath}".`,
             "2. Présente les décalages trouvés avec des explications claires.",
-            "3. Si des décalages existent, suggère s'il faut régénérer ou corriger manuellement.",
+            "3. Si des décalages existent, suggère de lancer update-project pour régénérer.",
             "",
             "Réponds en français.",
         ]
@@ -75,7 +208,7 @@ server.prompt("validate-project", "Check if an existing CLAUDE.md is still in sy
             "",
             `1. Call validate-claude-md with projectPath="${projectPath}".`,
             "2. Present any drifts found with clear explanations.",
-            "3. If drifts are found, suggest whether to regenerate or manually fix the CLAUDE.md.",
+            "3. If drifts are found, suggest running the update-project prompt to regenerate.",
         ];
     return {
         messages: [

package/dist/index.js.map

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

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

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerTechQueriesResource(server: McpServer): void;
+//# sourceMappingURL=tech-queries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tech-queries.d.ts","sourceRoot":"","sources":["../../src/resources/tech-queries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmBnE"}

package/dist/resources/tech-queries.js

@@ -0,0 +1,16 @@
+import { TECH_QUERIES } from "../data/tech-queries.js";
+export function registerTechQueriesResource(server) {
+    server.resource("tech-queries", "leadcode://tech-queries", {
+        description: "Maps detected technology identifiers to Context7 library names and recommended queries. Read this after analyze-repo to know what to ask Context7 for each detected tech.",
+        mimeType: "application/json",
+    }, async () => ({
+        contents: [
+            {
+                uri: "leadcode://tech-queries",
+                mimeType: "application/json",
+                text: JSON.stringify(TECH_QUERIES, null, 2),
+            },
+        ],
+    }));
+}
+//# sourceMappingURL=tech-queries.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tech-queries.js","sourceRoot":"","sources":["../../src/resources/tech-queries.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,UAAU,2BAA2B,CAAC,MAAiB;IAC3D,MAAM,CAAC,QAAQ,CACb,cAAc,EACd,yBAAyB,EACzB;QACE,WAAW,EACT,2KAA2K;QAC7K,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,IAAI,EAAE,CAAC,CAAC;QACX,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,yBAAyB;gBAC9B,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;aAC5C;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/templates/claude-md.d.ts

@@ -1,6 +1,6 @@
 import type { RepoAnalysis } from "../types.js";
 import type { CodePatterns } from "../analyzers/patterns.js";
-import type { FetchedDocs } from "../tools/fetch-docs.js";
+import type { FetchedDocs } from "../types.js";
 import type { Locale } from "../i18n/types.js";
 export declare function generateClaudeMd(analysis: RepoAnalysis, docs: FetchedDocs, choices: Record<string, string>, patterns?: CodePatterns, locale?: Locale): string;
 //# sourceMappingURL=claude-md.d.ts.map

package/dist/templates/claude-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-md.d.ts","sourceRoot":"","sources":["../../src/templates/claude-md.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAmI/C,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,QAAQ,CAAC,EAAE,YAAY,EACvB,MAAM,GAAE,MAAa,GACpB,MAAM,CAoLR"}
+{"version":3,"file":"claude-md.d.ts","sourceRoot":"","sources":["../../src/templates/claude-md.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAmI/C,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,QAAQ,CAAC,EAAE,YAAY,EACvB,MAAM,GAAE,MAAa,GACpB,MAAM,CAoLR"}

package/dist/tools/analyze-repo.js

@@ -7,7 +7,7 @@ import { detectFramework, detectStack } from "../analyzers/detection.js";
 export function registerAnalyzeRepo(server) {
     server.registerTool("analyze-repo", {
         title: "Analyze Repository",
-        description: "Scans a project directory and returns structured technical facts: framework, dependencies, directory structure, detected stack (ORM, auth, validation, CSS, testing, etc.). No opinions, only facts.",
+        description: "Scan and analyze a project to detect its full tech stack: framework, ORM, auth, CSS, testing, state management, API style, and more. Use this when the user wants to know what technologies a project uses, or as the first step before generating a CLAUDE.md.",
         inputSchema: {
             projectPath: z
                 .string()

package/dist/tools/analyze-repo.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-repo.js","sourceRoot":"","sources":["../../src/tools/analyze-repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGzE,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,sMAAsM;QACxM,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,6CAA6C,CAAC;SAC3D;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,qBAAqB;YACrB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wBAAwB,WAAW,EAAE,EAAE,CAAC;iBAClF,CAAC;YACJ,CAAC;YAED,6BAA6B;YAC7B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,4BAA4B,WAAW,wCAAwC,EAAE,CAAC;iBAC5H,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;YACnD,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACtD,MAAM,SAAS,GAAG,eAAe,CAC/B,GAAG,CAAC,YAAY,EAChB,GAAG,CAAC,eAAe,EACnB,SAAS,CACV,CAAC;YACF,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;YACpE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,eAAe,CAAC;YAE7C,MAAM,QAAQ,GAAiB;gBAC7B,WAAW;gBACX,WAAW,EAAE,GAAG,CAAC,IAAI;gBACrB,SAAS;gBACT,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,eAAe,EAAE,GAAG,CAAC,eAAe;gBACpC,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,SAAS;gBACT,QAAQ;aACT,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;iBACnE;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wBAAwB,OAAO,EAAE,EAAE,CAAC;aAC9E,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"analyze-repo.js","sourceRoot":"","sources":["../../src/tools/analyze-repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGzE,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,iQAAiQ;QACnQ,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CAAC,6CAA6C,CAAC;SAC3D;KACF,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,qBAAqB;YACrB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wBAAwB,WAAW,EAAE,EAAE,CAAC;iBAClF,CAAC;YACJ,CAAC;YAED,6BAA6B;YAC7B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,4BAA4B,WAAW,wCAAwC,EAAE,CAAC;iBAC5H,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,mBAAmB,CAAC,WAAW,CAAC,CAAC;YACnD,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACtD,MAAM,SAAS,GAAG,eAAe,CAC/B,GAAG,CAAC,YAAY,EAChB,GAAG,CAAC,eAAe,EACnB,SAAS,CACV,CAAC;YACF,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;YACpE,QAAQ,CAAC,OAAO,GAAG,SAAS,CAAC,eAAe,CAAC;YAE7C,MAAM,QAAQ,GAAiB;gBAC7B,WAAW;gBACX,WAAW,EAAE,GAAG,CAAC,IAAI;gBACrB,SAAS;gBACT,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,eAAe,EAAE,GAAG,CAAC,eAAe;gBACpC,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,SAAS;gBACT,QAAQ;aACT,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;iBACnE;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wBAAwB,OAAO,EAAE,EAAE,CAAC;aAC9E,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/fetch-docs.d.ts

@@ -1,13 +1,3 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-export interface FetchedDocs {
-    techDocs: Record<string, string>;
-    crossDocs: Record<string, string>;
-    metadata: {
-        techCount: number;
-        snippetCount: number;
-        failedTechs: string[];
-        warning?: string;
-    };
-}
 export declare function registerFetchDocs(server: McpServer): void;
 //# sourceMappingURL=fetch-docs.d.ts.map

package/dist/tools/fetch-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-docs.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,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;AAmID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwCzD"}
+{"version":3,"file":"fetch-docs.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwCzD"}

package/dist/tools/fetch-docs.js

@@ -1,111 +1,9 @@
 import * as z from "zod";
-import { resolveAndFetch, TECH_QUERIES } from "../context7/index.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;
-}
-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}`;
-                // Avoid duplicates (a+b and b+a)
-                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(", ")}`,
-            }),
-        },
-    };
-}
+import { fetchAllDocs } from "../context7/index.js";
 export function registerFetchDocs(server) {
     server.registerTool("fetch-docs", {
         title: "Fetch Documentation",
-        description: "Fetches up-to-date documentation from Context7 for each technology detected in the project. Returns doc snippets organized by technology and cross-technology combinations.",
+        description: "Fetch up-to-date documentation from Context7 for each technology in a project. Returns documentation organized by technology and cross-technology combinations. Useful for inspecting what docs Context7 provides before generating a CLAUDE.md.",
         inputSchema: {
             analysis: z
                 .string()

package/dist/tools/fetch-docs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-docs.js","sourceRoot":"","sources":["../../src/tools/fetch-docs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fetch-docs.js","sourceRoot":"","sources":["../../src/tools/fetch-docs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,kPAAkP;QACpP,WAAW,EAAE;YACX,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CAAC,sDAAsD,CAAC;SACpE;KACF,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE;QAClC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAiB,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACvD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAC;YAE1C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;qBACpC;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,sBAAsB,OAAO,EAAE;qBACtC;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/generate-claude-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-claude-md.d.ts","sourceRoot":"","sources":["../../src/tools/generate-claude-md.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkFhE"}
+{"version":3,"file":"generate-claude-md.d.ts","sourceRoot":"","sources":["../../src/tools/generate-claude-md.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAiGhE"}

package/dist/tools/generate-claude-md.js

@@ -6,14 +6,15 @@ import { analyzePatterns } from "../analyzers/patterns.js";
 export function registerGenerateClaudeMd(server) {
     server.registerTool("generate-claude-md", {
         title: "Generate CLAUDE.md",
-        description: "Generates a structured CLAUDE.md file from the repo analysis and fetched documentation. Writes it directly to the project root. This file becomes the source of truth for Claude Code.",
+        description: "Generate a CLAUDE.md file for a project. Takes the analysis from analyze-repo and synthesized documentation rules (from Context7 via Claude). Use this when the user wants to create, setup, init, or generate project rules, a CLAUDE.md, or configure Claude Code for a project.",
         inputSchema: {
             analysis: z
                 .string()
                 .describe("JSON string of RepoAnalysis (output of analyze-repo)"),
             docs: z
                 .string()
-                .describe("JSON string of FetchedDocs (output of fetch-docs)"),
+                .optional()
+                .describe('JSON string of synthesized documentation: { "techDocs": Record<string, string>, "crossDocs": Record<string, string> }. Each value should be concise, actionable rules (not raw code snippets). If omitted, CLAUDE.md is generated without technology documentation.'),
             choices: z
                 .string()
                 .optional()
@@ -22,10 +23,20 @@ export function registerGenerateClaudeMd(server) {
     }, async ({ analysis: analysisStr, docs: docsStr, choices: choicesStr }) => {
         try {
             const analysis = JSON.parse(analysisStr);
-            const docs = JSON.parse(docsStr);
             const choices = choicesStr
                 ? JSON.parse(choicesStr)
                 : {};
+            const docs = docsStr
+                ? JSON.parse(docsStr)
+                : { techDocs: {}, crossDocs: {}, metadata: { techCount: 0, snippetCount: 0, failedTechs: [] } };
+            // Ensure metadata exists
+            if (!docs.metadata) {
+                docs.metadata = {
+                    techCount: Object.keys(docs.techDocs ?? {}).length,
+                    snippetCount: Object.keys(docs.techDocs ?? {}).length + Object.keys(docs.crossDocs ?? {}).length,
+                    failedTechs: [],
+                };
+            }
             // Verify project path still exists
             try {
                 await stat(analysis.projectPath);

package/dist/tools/generate-claude-md.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-claude-md.js","sourceRoot":"","sources":["../../src/tools/generate-claude-md.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"generate-claude-md.js","sourceRoot":"","sources":["../../src/tools/generate-claude-md.ts"],"names":[],"mappings":"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"}

package/dist/tools/update-claude-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-claude-md.d.ts","sourceRoot":"","sources":["../../src/tools/update-claude-md.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA2EzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgG9D"}
+{"version":3,"file":"update-claude-md.d.ts","sourceRoot":"","sources":["../../src/tools/update-claude-md.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA+BzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgG9D"}

package/dist/tools/update-claude-md.js

@@ -5,7 +5,7 @@ import { analyzeDependencies } from "../analyzers/dependencies.js";
 import { analyzeStructure } from "../analyzers/structure.js";
 import { detectFramework, detectStack } from "../analyzers/detection.js";
 import { analyzePatterns } from "../analyzers/patterns.js";
-import { resolveAndFetch, TECH_QUERIES } from "../context7/index.js";
+import { fetchAllDocs } from "../context7/index.js";
 import { generateClaudeMd } from "../templates/claude-md.js";
 /**
  * Extract user-added sections from an existing CLAUDE.md.
@@ -25,64 +25,10 @@ function extractUserChoices(existingContent) {
     }
     return choices;
 }
-/** Collect techs and fetch docs (same logic as fetch-docs tool but inline) */
-async function fetchDocsForAnalysis(analysis) {
-    const techs = [];
-    if (analysis.framework)
-        techs.push(analysis.framework.name);
-    const d = analysis.detected;
-    for (const value of Object.values(d)) {
-        if (typeof value === "string")
-            techs.push(value);
-    }
-    const uniqueTechs = [...new Set(techs)];
-    const techDocs = {};
-    const crossDocs = {};
-    const failedTechs = [];
-    let snippetCount = 0;
-    for (const tech of uniqueTechs) {
-        const mapping = TECH_QUERIES[tech];
-        if (!mapping) {
-            failedTechs.push(tech);
-            continue;
-        }
-        const docs = await resolveAndFetch(mapping.libraryName, mapping.queries.join(". "));
-        if (docs) {
-            techDocs[tech] = docs;
-            snippetCount++;
-        }
-        else {
-            failedTechs.push(tech);
-        }
-    }
-    for (const tech of uniqueTechs) {
-        const mapping = TECH_QUERIES[tech];
-        if (!mapping?.crossQueries)
-            continue;
-        for (const [other, query] of Object.entries(mapping.crossQueries)) {
-            if (!uniqueTechs.includes(other))
-                continue;
-            const key = `${tech}+${other}`;
-            const rev = `${other}+${tech}`;
-            if (key in crossDocs || rev in crossDocs)
-                continue;
-            const docs = await resolveAndFetch(mapping.libraryName, query);
-            if (docs) {
-                crossDocs[key] = docs;
-                snippetCount++;
-            }
-        }
-    }
-    return {
-        techDocs,
-        crossDocs,
-        metadata: { techCount: Object.keys(techDocs).length, snippetCount, failedTechs },
-    };
-}
 export function registerUpdateClaudeMd(server) {
     server.registerTool("update-claude-md", {
         title: "Update CLAUDE.md",
-        description: "Re-analyzes the project, fetches fresh documentation from Context7, and regenerates CLAUDE.md while preserving user choices from the Project Decisions section.",
+        description: "Update or refresh an existing CLAUDE.md. Re-analyzes the project, fetches fresh documentation from Context7, and regenerates the file while preserving user choices. Use this when the user wants to update, refresh, regenerate, or re-sync their CLAUDE.md after changing dependencies.",
         inputSchema: {
             projectPath: z
                 .string()
@@ -127,7 +73,7 @@ export function registerUpdateClaudeMd(server) {
                 detected,
             };
             // Fetch fresh docs
-            const docs = await fetchDocsForAnalysis(analysis);
+            const docs = await fetchAllDocs(analysis);
             const content = generateClaudeMd(analysis, docs, previousChoices, patterns);
             await writeFile(claudeMdPath, content, "utf-8");
             return {