dsh-codebase-chat 0.22.0 → 0.24.0

package/lib/index.js

@@ -16,9 +16,12 @@ import {
 
 let analyzeProject;
 let formatHealthReport;
+let getChangedFiles;
+let analyzeImpact;
+let formatImpactReport;
 try {
-  ({ analyzeProject, formatHealthReport } = await import("../dist/index.js"));
-} catch { analyzeProject = undefined; formatHealthReport = undefined; }
+  ({ analyzeProject, formatHealthReport, getChangedFiles, analyzeImpact, formatImpactReport } = await import("../dist/index.js"));
+} catch { analyzeProject = undefined; formatHealthReport = undefined; getChangedFiles = undefined; analyzeImpact = undefined; formatImpactReport = undefined; }
 
 let defineTool;
 let createUserMessage;
@@ -32,14 +35,12 @@ try {
 const name = "codebase-chat";
 const inject = ["tools", "commands", "agents", "systemPrompt"];
 
-const VERSION = "0.19.0";
+const VERSION = "0.23.0";
 const execAsync = promisify(exec);
 
-const PROTECTED_PATHS = [
-  ...(process.env.DSH_PROTECTED_PATHS ? process.env.DSH_PROTECTED_PATHS.split(/[;|]/).map((p) => p.trim()).filter(Boolean) : []),
-  "C:\\Users\\shinzarou-eng\\Downloads\\marketing-session-app",
-  "marketing-session-app"
-];
+const PROTECTED_PATHS = process.env.DSH_PROTECTED_PATHS
+  ? process.env.DSH_PROTECTED_PATHS.split(/[;|]/).map((p) => p.trim()).filter(Boolean)
+  : [];
 
 // Per-project config: .codebase-chat.json at the project root.
 const projectConfigCache = new Map();
@@ -646,7 +647,7 @@ function buildFilePart(rel, text) {
 }
 
 async function collectCodebaseContext(projectPath, options = {}) {
-  const { focus = "", filePath = "", searchQuery = "", lang = "fr" } = options;
+  const { focus = "", filePath = "", searchQuery = "", lang = "fr", diff = "" } = options;
   const isEn = lang === "en";
   const t = isEn ? {
     project: "Project",
@@ -673,6 +674,14 @@ async function collectCodebaseContext(projectPath, options = {}) {
   const absProject = await resolveProjectPath(projectPath);
   const startDir = await findProjectRoot(absProject);
 
+  // --diff <ref> — scope the gathered context to files changed vs a git ref.
+  let diffSet = null;
+  if (diff && !filePath && getChangedFiles) {
+    const scope = await getChangedFiles(startDir, diff).catch(() => null);
+    if (scope?.ok) diffSet = scope.files;
+  }
+  const inScope = (rel) => !diffSet || diffSet.has(rel);
+
   reportProgress("Construction de l'arborescence...");
   const tree = await buildTree(startDir);
   reportProgress("Lecture des fichiers racine...");
@@ -681,12 +690,15 @@ async function collectCodebaseContext(projectPath, options = {}) {
   const fileParts = [];
 
   const focusHint = focus ? `\n${t.focus} : ${focus}` : "";
+  const scopeHint = diffSet
+    ? `\n${isEn ? "Scope" : "Périmètre"} : ${diffSet.size} ${isEn ? "file(s) changed vs" : "fichier(s) modifié(s) vs"} ${diff}`
+    : "";
   const productConstraints = await extractProductConstraints(absProject);
   const constraintsText = productConstraints.length
     ? `\n== ${t.constraints} ==\n${productConstraints.map((c) => `- ${c}`).join("\n")}\n`
     : `\n== ${t.constraints} ==\n${t.noConstraints}\n`;
 
-  const head = `${t.project} : ${absProject}${focusHint}\n${constraintsText}\n${t.tree} :\n${tree}\n\n${rootResult.prelude}\n`;
+  const head = `${t.project} : ${absProject}${focusHint}${scopeHint}\n${constraintsText}\n${t.tree} :\n${tree}\n\n${rootResult.prelude}\n`;
   const headTokens = estimateTokens(head);
   const maxFileTokens = Math.max(0, MAX_CONTEXT_TOKENS - headTokens - 200);
   let usedFileTokens = 0;
@@ -703,7 +715,8 @@ async function collectCodebaseContext(projectPath, options = {}) {
       // Not a file: treat it as a symbol/term and search for it instead of failing.
       reportProgress(isEn ? `File not found, searching symbol: ${filePath}` : `Fichier introuvable, recherche du symbole : ${filePath}`);
       const matches = await searchFiles(absProject, filePath, 20);
-      for (const m of matches) {
+      const scoped = matches.filter(m => inScope(m.rel));
+      for (const m of scoped) {
         if (remainingBytes <= 0) break;
         const entry = `--- ${m.rel} ---\n${m.snippet}\n`;
         if (entry.length > remainingBytes) break;
@@ -716,7 +729,7 @@ async function collectCodebaseContext(projectPath, options = {}) {
 
   if (searchQuery && !filePath) {
     const matches = await searchFiles(absProject, searchQuery);
-    for (const m of matches) {
+    for (const m of matches.filter(m => inScope(m.rel))) {
       if (remainingBytes <= 0) break;
       const entry = `--- ${m.rel} ---\n${m.snippet}\n`;
       if (entry.length > remainingBytes) break;
@@ -734,6 +747,7 @@ async function collectCodebaseContext(projectPath, options = {}) {
       const ext = extname(fullPath).toLowerCase();
       if (!SOURCE_EXTS.has(ext)) continue;
       const rel = relative(startDir, fullPath).split(sep).join("/");
+      if (!inScope(rel)) continue;
 
       const fstats = await fileStats(fullPath);
       if (!fstats) continue;
@@ -2138,11 +2152,12 @@ function apply(ctx) {
       filePath: { type: "string", description: "Optional specific file or symbol to focus on." },
       crea: { type: "boolean", description: "If true, append a creative 'Fait avec passion par shinzarou-eng <project>' footer." },
       creaTheme: { type: "string", description: "Optional creative theme for the footer." },
-      lang: { type: "string", description: "Response language: 'fr' (default) or 'en'." }
+      lang: { type: "string", description: "Response language: 'fr' (default) or 'en'." },
+      diff: { type: "string", description: "Git ref (e.g. 'main', 'HEAD~5'). Scopes the context to files changed vs that ref." }
     },
     (value) => buildChatPrompt(value.query, value.context, value.projectName, value.crea, value.creaTheme, value.lang),
     async (args, exec) => {
-      const { absProject, context } = await collectCodebaseContext(args.projectPath, { focus: args.question, filePath: args.filePath, lang: args.lang });
+      const { absProject, context } = await collectCodebaseContext(args.projectPath, { focus: args.question, filePath: args.filePath, lang: args.lang, diff: args.diff });
       const projectName = await getProjectName(absProject);
       return { query: args.question, projectName, crea: args.crea || false, creaTheme: args.creaTheme || "", lang: args.lang || "fr", context };
     }
@@ -2157,11 +2172,12 @@ function apply(ctx) {
       query: { type: "string", description: "Term, symbol, or pattern to search." },
       crea: { type: "boolean", description: "If true, append a creative 'Fait avec passion par shinzarou-eng <project>' footer." },
       creaTheme: { type: "string", description: "Optional creative theme for the footer." },
-      lang: { type: "string", description: "Response language: 'fr' (default) or 'en'." }
+      lang: { type: "string", description: "Response language: 'fr' (default) or 'en'." },
+      diff: { type: "string", description: "Git ref (e.g. 'main', 'HEAD~5'). Scopes the search to files changed vs that ref." }
     },
     (value) => buildSearchPrompt(value.query, value.context, value.projectName, value.crea, value.creaTheme, value.lang),
     async (args, exec) => {
-      const { absProject, context } = await collectCodebaseContext(args.projectPath, { focus: args.query, searchQuery: args.query, lang: args.lang });
+      const { absProject, context } = await collectCodebaseContext(args.projectPath, { focus: args.query, searchQuery: args.query, lang: args.lang, diff: args.diff });
       const projectName = await getProjectName(absProject);
       return { query: args.query, projectName, crea: args.crea || false, creaTheme: args.creaTheme || "", lang: args.lang || "fr", context };
     }
@@ -2229,14 +2245,52 @@ function apply(ctx) {
     "Run a deterministic static analysis of the codebase — circular dependencies, unused files and exports, duplicated code blocks, complexity hotspots, and a health score. Returns concrete findings directly, no LLM needed. Use for 'health', 'dead code', 'circular deps', 'duplication' or 'complexity' requests.",
     {
       projectPath: { type: "string", description: "Absolute local path to the project folder. If omitted, the project root is auto-detected from the current working directory." },
-      lang: { type: "string", description: "Report language: 'fr' (default) or 'en'." }
+      lang: { type: "string", description: "Report language: 'fr' (default) or 'en'." },
+      diff: { type: "string", description: "Git ref (e.g. 'main', 'HEAD~5'). Scopes the analysis to files changed vs that ref." }
     },
     (value) => value.markdown || "No report generated.",
     async (args, exec) => {
       if (!analyzeProject) throw new Error("Static analysis module not available.");
       const projectPath = await resolveProjectPath(args.projectPath);
-      const report = await analyzeProject(projectPath);
-      return { projectName: basename(report.projectPath), lang: args.lang || "fr", markdown: formatHealthReport(report, args.lang === "en" ? "en" : "fr") };
+      let scope;
+      let scopeLine = "";
+      if (args.diff && getChangedFiles) {
+        const s = await getChangedFiles(await findProjectRoot(projectPath), String(args.diff)).catch(() => null);
+        if (s?.ok) {
+          scope = { files: s.files };
+          scopeLine = (args.lang === "en"
+            ? `Scope: ${s.files.size} file(s) changed vs ${args.diff}\n\n`
+            : `Périmètre : ${s.files.size} fichier(s) modifié(s) vs ${args.diff}\n\n`);
+        }
+      }
+      const report = await analyzeProject(projectPath, scope);
+      return { projectName: basename(report.projectPath), lang: args.lang || "fr", markdown: scopeLine + formatHealthReport(report, args.lang === "en" ? "en" : "fr") };
+    }
+  );
+
+  registerTool(
+    tools,
+    "codebase_impact",
+    "Blast-radius analysis: which files transitively depend on a target file — what breaks if it changes. Deterministic, returns findings directly, no LLM needed. Use for 'impact', 'what breaks', 'dependents', 'who imports X' requests.",
+    {
+      projectPath: { type: "string", description: "Absolute local path to the project folder. If omitted, the project root is auto-detected from the current working directory." },
+      file: { type: "string", description: "File to analyze — relative path or name (e.g. 'src/store.ts'). Required." },
+      lang: { type: "string", description: "Report language: 'fr' (default) or 'en'." }
+    },
+    (value) => value.markdown || "No report generated.",
+    async (args, exec) => {
+      if (!analyzeImpact) throw new Error("Static analysis module not available.");
+      const projectPath = await resolveProjectPath(args.projectPath);
+      const file = String(args.file || "").trim();
+      if (!file) throw new Error("Missing `file` argument (e.g. 'src/store.ts').");
+      const r = await analyzeImpact(projectPath, file);
+      if (!r.ok) {
+        const msg = r.candidates.length
+          ? `Cible ambiguë "${file}" — candidats : ${r.candidates.join(', ')}`
+          : `Aucun fichier de code ne correspond à "${file}".`;
+        return { projectName: basename(projectPath), lang: args.lang || "fr", markdown: msg };
+      }
+      return { projectName: basename(r.report.projectPath), lang: args.lang || "fr", markdown: formatImpactReport(r.report, args.lang === "en" ? "en" : "fr") };
     }
   );
 
@@ -2513,6 +2567,28 @@ function apply(ctx) {
     }
   });
 
+  commands.register({
+    name: "codebase-impact",
+    description: "Analyse d'impact : quels fichiers dépendent de X (rayon d'impact). /codebase-impact <fichier> --project <chemin> [--lang en|fr]",
+    input: { hint: "<fichier>, --project <chemin>, --lang <en|fr>" },
+    async handler(invocation) {
+      if (!analyzeImpact) return { kind: "error", text: "Module d'analyse statique indisponible (build dist manquant)." };
+      const { rawInput } = invocation;
+      const { projectPath, query, filePath, lang } = parseCodebaseInput(rawInput.trim());
+      const file = (filePath || query || "").trim();
+      if (!file) return { kind: "error", text: "Précise un fichier : /codebase-impact src/store.ts" };
+      const absProject = await resolveProjectPath(projectPath);
+      const r = await analyzeImpact(absProject, file);
+      if (!r.ok) {
+        const msg = r.candidates.length
+          ? `Cible ambiguë "${file}" — candidats :\n  ${r.candidates.join("\n  ")}`
+          : `Aucun fichier de code ne correspond à "${file}".`;
+        return { kind: "error", text: msg };
+      }
+      return { kind: "success", text: formatImpactReport(r.report, lang === "en" ? "en" : "fr") };
+    }
+  });
+
   commands.register({
     name: "codebase-intel",
     description: "Brief d'Intelligence Pro : architecture, graphe de modules, data flow, risques, opportunités et créa. /codebase-intel --project <chemin> [focus] [--style <ouf|punchy|dense|pedagogique|minimal>]",
@@ -2697,7 +2773,7 @@ function apply(ctx) {
   systemPrompt?.section?.({
     name: "codebase-chat",
     order: 130,
-    text: `You have access to a powerful codebase plugin (dsh-codebase-chat v${VERSION}). When the user asks about code, files, project structure, architecture, how something works, where something is, or wants to search/explain/refactor/audit/report on code, use the appropriate tool: codebase_chat, codebase_search, codebase_explain, codebase_refactor, codebase_crea, codebase_intelligence, codebase_audit, codebase_report, codebase_ceo, codebase_tasks, codebase_build, codebase_git, codebase_apply, codebase_health, or codebase_player. codebase_health runs a deterministic static analysis (circular deps, dead code, duplication, complexity, health score) and returns findings directly — prefer it when the user asks for measurable code quality. codebase_intelligence is the premium auto-mode: it builds a structured context and asks for a professional, stylish intelligence brief. codebase_ceo is the one-page executive brief: metrics, score cards, top risks, top opportunities, SWOT, killer move, perfect for a board or investor. codebase_audit is the dedicated non-conformity and tech-debt auditor. codebase_report is the executive strategic report: a beautiful, visual, deep assessment (SWOT, score cards, 90-day roadmap, marketing) perfect for boards or clients. codebase_player is the UX / playthrough / player perspective brief: user journey, onboarding, friction, wow moments, gamification, and score cards from a user's point of view.\n\nIf the user asks for raw tasks, a TASKS.md with Avant/Après code blocks, or uses --raw, call codebase_tasks with raw=true. It writes TASKS.md directly in the project and returns the path/content. If the user asks to apply the plan, run the fixes, or says 'apply tasks', call codebase_apply_tasks. Use dryRun=true only if the user asks for a simulation or dry-run. If the user confirms or says 'apply', 'execute', 'yes', or 'oui', call with dryRun=false and apply the patches.\n\nIf no project path is given, first attempt to auto-detect the project root from the current working directory (cwd). Auto-detection walks up the tree looking for package.json, .git or tsconfig.json. Do NOT fall back to any known project (including the 'Dako' alias) unless the user explicitly mentions it. The only recognized alias is 'Dako' for the path 'D:\\Nouveau dossier'; use it only when the user explicitly says 'Dako' or uses --project Dako. If auto-detection fails and no explicit path is provided, ask the user for the path. Always answer in the same language as the user's message. If the user wants a creative idea at the end, set crea=true or use codebase_crea. Users may also use slash commands /codebase, /codebase-search, /codebase-explain, /codebase-refactor, /codebase-crea, /codebase-intel, /codebase-audit, /codebase-report, /codebase-ceo, /codebase-tasks, /codebase-tasks-raw, /codebase-apply-tasks, /codebase-build, /codebase-git, /codebase-apply, /codebase-player.`
+    text: `You have access to a powerful codebase plugin (dsh-codebase-chat v${VERSION}). When the user asks about code, files, project structure, architecture, how something works, where something is, or wants to search/explain/refactor/audit/report on code, use the appropriate tool: codebase_chat, codebase_search, codebase_explain, codebase_refactor, codebase_crea, codebase_intelligence, codebase_audit, codebase_report, codebase_ceo, codebase_tasks, codebase_build, codebase_git, codebase_apply, codebase_health, codebase_impact, or codebase_player. codebase_health runs a deterministic static analysis (circular deps, dead code, duplication, complexity, health score) and returns findings directly. codebase_impact computes the blast radius of a file — which files transitively depend on it — deterministic, no LLM — prefer it when the user asks for measurable code quality. codebase_intelligence is the premium auto-mode: it builds a structured context and asks for a professional, stylish intelligence brief. codebase_ceo is the one-page executive brief: metrics, score cards, top risks, top opportunities, SWOT, killer move, perfect for a board or investor. codebase_audit is the dedicated non-conformity and tech-debt auditor. codebase_report is the executive strategic report: a beautiful, visual, deep assessment (SWOT, score cards, 90-day roadmap, marketing) perfect for boards or clients. codebase_player is the UX / playthrough / player perspective brief: user journey, onboarding, friction, wow moments, gamification, and score cards from a user's point of view.\n\nIf the user asks for raw tasks, a TASKS.md with Avant/Après code blocks, or uses --raw, call codebase_tasks with raw=true. It writes TASKS.md directly in the project and returns the path/content. If the user asks to apply the plan, run the fixes, or says 'apply tasks', call codebase_apply_tasks. Use dryRun=true only if the user asks for a simulation or dry-run. If the user confirms or says 'apply', 'execute', 'yes', or 'oui', call with dryRun=false and apply the patches.\n\nIf no project path is given, first attempt to auto-detect the project root from the current working directory (cwd). Auto-detection walks up the tree looking for package.json, .git or tsconfig.json. Do NOT fall back to any known project (including the 'Dako' alias) unless the user explicitly mentions it. The only recognized alias is 'Dako' for the path 'D:\\Nouveau dossier'; use it only when the user explicitly says 'Dako' or uses --project Dako. If auto-detection fails and no explicit path is provided, ask the user for the path. Always answer in the same language as the user's message. If the user wants a creative idea at the end, set crea=true or use codebase_crea. Users may also use slash commands /codebase, /codebase-search, /codebase-explain, /codebase-refactor, /codebase-crea, /codebase-intel, /codebase-audit, /codebase-report, /codebase-ceo, /codebase-tasks, /codebase-tasks-raw, /codebase-apply-tasks, /codebase-build, /codebase-git, /codebase-apply, /codebase-impact, /codebase-player.`
   });
 
   function sameOrigin(req) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-codebase-chat",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "Multi-language codebase intelligence for DeepSeek Harness and MCP-compatible IDEs: chat, search, audit, refactor, and board-ready reports from local code.",
   "homepage": "https://shinzarou-eng.github.io/dsh-codebase-chat",
   "repository": {
@@ -11,6 +11,9 @@
     "url": "https://github.com/shinzarou-eng/dsh-codebase-chat/issues"
   },
   "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
@@ -35,14 +38,6 @@
     "LICENSE",
     "package.json"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "pnpm build && pnpm test"
-  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -91,5 +86,12 @@
     "tsup": "^8.5.1",
     "typescript": "5.7.3",
     "vitest": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}