dsh-codebase-chat 0.27.0 → 0.28.1

package/README.md

@@ -22,7 +22,13 @@
 
 <br>
 
-## Get started
+## Installation
+
+```bash
+dsh plugin --profile web add dsh-codebase-chat
+```
+
+or as a standalone MCP server / CLI:
 
 ```bash
 npx dsh-codebase-chat-mcp setup
@@ -39,7 +45,9 @@ Other paths — DeepSeek Harness plugin · CLI · from source · manual config:
   <em>Real MCP session on a real 422-file codebase — <code>codebase_health</code> finds 324 circular deps, <code>codebase_chat</code> answers with <code>[source: file:line]</code> receipts · <a href="docs/assets/demo-power.gif">PR review (--diff + --watch)</a> · <a href="docs/assets/demo.gif">CLI tour</a> · <a href="docs/assets/demo-mcp.gif">MCP stdio</a> · <a href="docs/assets/demo-fr.gif">French mode</a></em>
 </p>
 
-## What a real session looks like
+## Usage
+
+_What a real session looks like_ —
 
 Run on this repository — the exact text the tools return:
 

package/dist/cli.js

@@ -2984,7 +2984,7 @@ async function missingDeps(abs, fileTexts, pkg, indexPaths) {
   const missing = /* @__PURE__ */ new Set();
   for (const spec of importedPackages(fileTexts)) {
     const root = pkgRoot(spec);
-    if (!NODE_BUILTINS.has(root) && !declared.has(root)) missing.add(root);
+    if (!NODE_BUILTINS.has(root) && !declared.has(root) && !root.startsWith("@/") && !root.startsWith("~/")) missing.add(root);
   }
   return [...missing].sort();
 }
@@ -3430,7 +3430,8 @@ async function buildDeterministicReport(projectPath, lang = "fr") {
   out.push(`- ${docCov.documented}/${docCov.total} ${en ? "exports documented" : "exports document\xE9s"} (${docPct}% ${t2.docCov})`);
   if (git2) out.push(`- ${git2.commits} ${t2.gitCommits} \xB7 ${git2.authors.size} ${en ? "author(s)" : "auteur(s)"} \xB7 ${t2.gitLast} : ${git2.lastDate}`);
   out.push("");
-  out.push(`## 2. ${t2.stack}`);
+  let secN = 2;
+  out.push(`## ${secN++}. ${t2.stack}`);
   if (pkg.name) out.push(`- **${en ? "Package" : "Package"}** : \`${pkg.name}${pkg.version ? `@${pkg.version}` : ""}\``);
   if (langs.length) out.push(`- **${t2.lang}** : ${langs.map(([l, n]) => `${l} (${n})`).join(", ")}`);
   if (deps.length) out.push(`- **${t2.deps}** (${deps.length}) : ${deps.slice(0, 12).map((d) => `\`${d}\``).join(", ")}${deps.length > 12 ? " \u2026" : ""}`);
@@ -3455,7 +3456,7 @@ async function buildDeterministicReport(projectPath, lang = "fr") {
     out.push(`- **${t2.readmeTitle}** : ${t2.readmeInstall} ${ok(readme.install)} \xB7 ${t2.readmeUsage} ${ok(readme.usage)} \xB7 ${readme.codeBlocks} ${t2.readmeCode} \xB7 ${readme.badges} ${t2.readmeBadges}`);
   }
   out.push("");
-  out.push(`## 3. ${t2.arch}`);
+  out.push(`## ${secN++}. ${t2.arch}`);
   if (hubs.length) {
     out.push(`**${t2.hubs}** :`, "");
     for (const [f, n] of hubs) out.push(`- \`${f}\` \u2190 ${n} ${en ? "importers" : "importeurs"}`);
@@ -3492,7 +3493,7 @@ async function buildDeterministicReport(projectPath, lang = "fr") {
     out.push("");
   }
   if (git2) {
-    out.push(`## 4. ${t2.gitTitle}`, "");
+    out.push(`## ${secN++}. ${t2.gitTitle}`, "");
     const topAuthors = [...git2.authors.entries()].sort((a, b) => b[1] - a[1]).slice(0, 5).map(([a, n]) => `${a} (${n})`).join(", ");
     const soloCount = [...git2.fileAuthors.values()].filter((a) => a.size === 1).length;
     out.push(`- ${git2.commits} ${t2.gitCommits} \xB7 **${t2.gitAuthors}** : ${topAuthors}`);
@@ -3532,7 +3533,7 @@ async function buildDeterministicReport(projectPath, lang = "fr") {
       out.push(`**${t2.bigCommits}** : ${big.map((c) => `${c.lines} ${en ? "lines" : "lignes"} / ${c.files} ${en ? "files" : "fichiers"}`).join(" \xB7 ")}`, "");
     }
   }
-  out.push(`## 5. ${t2.debt}`);
+  out.push(`## ${secN++}. ${t2.debt}`);
   const smellKeys = Object.keys(smells);
   if (!smellKeys.length) out.push(en ? "_Nothing detected._" : "_Rien d\xE9tect\xE9._");
   for (const key of smellKeys) {
@@ -3546,7 +3547,7 @@ async function buildDeterministicReport(projectPath, lang = "fr") {
     for (const a of asyncNoAwait.slice(0, 5)) out.push(`  - \`${a.file}\` \u2192 \`${a.name}\``);
   }
   out.push("");
-  out.push(`## 6. ${t2.secu}`);
+  out.push(`## ${secN++}. ${t2.secu}`);
   if (sensitive.length) {
     out.push(`- **${t2.sensitive}** \u2014 ${sensitive.length}`);
     for (const f of sensitive.slice(0, 6)) out.push(`  - \`${f}\`${git2?.sensitiveTracked.includes(f) ? en ? " (tracked by git!)" : " (suivi par git !)" : ""}`);
@@ -3560,10 +3561,10 @@ async function buildDeterministicReport(projectPath, lang = "fr") {
     if (hits.length > 5) out.push(`  - _\u2026${hits.length - 5} ${en ? "more" : "autres"}_`);
   }
   out.push("");
-  out.push(`## 7. ${t2.constraints}`);
+  out.push(`## ${secN++}. ${t2.constraints}`);
   out.push(index.constraints.length ? index.constraints.map((c) => `- ${c}`).join("\n") : t2.none, "");
-  out.push(formatHealthReportMd(health, lang).replace(/^## /, "## 8. ").replace(/\n### /g, "\n#### "), "");
-  out.push(`## 9. ${t2.reco}`, "");
+  out.push(formatHealthReportMd(health, lang).replace(/^## /, `## ${secN++}. `).replace(/\n### /g, "\n#### "), "");
+  out.push(`## ${secN++}. ${t2.reco}`, "");
   out.push(`| ${t2.sev} | ${t2.action} |`, "|---|---|");
   const SEV_ICON = { Critique: "\u{1F534}", "\xC9lev\xE9e": "\u{1F7E0}", Moyenne: "\u{1F7E1}", Faible: "\u{1F535}" };
   for (const r of recommendations(health, hasTests, smells, sec, git2, infra, riskFiles, { sensitive, envUndoc: env.undocumented, deadDeps, tsStrict: cfg.tsStrict, untestedRisk: untestedRisk.map((r2) => r2.file), brokenEntries, deepRel: deepRel.length, deepNest: shape.deepNest.map((d) => d.file), commitConv: commitQ?.conventionalPct ?? null, missingDeps: missing, lockDrift }, lang)) out.push(`| ${SEV_ICON[r.severity]} ${r.severity} | ${r.text} |`);