dsh-codebase-chat 0.23.0 → 0.25.0

package/dist/index.d.ts

@@ -79,6 +79,7 @@ declare function getIndex(projectPath: string, progress?: (message: string) => v
 
 declare function resolveProjectPath(projectPath?: string): string;
 declare function findProjectRoot(absProject: string): Promise<string>;
+declare function getCacheDir(): string;
 
 /**
  * Count the exact number of tokens for a given text using the CL100K base
@@ -171,13 +172,52 @@ interface HealthReport {
     grade: 'A' | 'B' | 'C' | 'D' | 'E';
 }
 interface AnalyzeOptions {
-    /** Restrict analysis to these project-relative paths (e.g. a diff scope). */
+    /** Restrict *reported findings* to these project-relative paths (e.g. a diff
+     * scope). The import graph and usage checks still run on the whole project
+     * so cycles/uses crossing the scope boundary are detected. */
     files?: Set<string>;
 }
 declare function analyzeProject(projectPath: string, opts?: AnalyzeOptions): Promise<HealthReport>;
 declare function formatHealthReport(r: HealthReport, lang?: 'fr' | 'en'): string;
 declare function formatHealthReportMd(r: HealthReport, lang?: 'fr' | 'en'): string;
 
+interface ImpactDependent {
+    file: string;
+    depth: number;
+}
+interface ImpactReport {
+    projectPath: string;
+    query: string;
+    target: string;
+    exportedSymbols: {
+        name: string;
+        line: number;
+    }[];
+    dependents: ImpactDependent[];
+    directCount: number;
+    totalFiles: number;
+    /** Share of the project's code files that transitively depend on the target. */
+    percent: number;
+    inCycle: boolean;
+    isEntry: boolean;
+    risk: 'low' | 'medium' | 'high';
+}
+type ImpactResult = {
+    ok: true;
+    report: ImpactReport;
+} | {
+    ok: false;
+    query: string;
+    candidates: string[];
+};
+/**
+ * Blast-radius analysis: which files break if `query` changes. Reverse BFS on
+ * the local import graph — deterministic, no LLM.
+ */
+declare function analyzeImpact(projectPath: string, query: string): Promise<ImpactResult>;
+declare function formatImpactReport(r: ImpactReport, lang?: 'fr' | 'en'): string;
+declare function formatImpactReportMd(r: ImpactReport, lang?: 'fr' | 'en'): string;
+
 type ConfigLang = 'fr' | 'en';
 /**
  * Per-project settings read from `.codebase-chat.json` at the project root.
@@ -204,7 +244,7 @@ declare function loadProjectConfig(absProject: string): Promise<ProjectConfig>;
 declare function clearConfigCache(absProject?: string): void;
 /** Minimal glob → RegExp: `**` spans directories, `*` one segment, `?` one char. */
 declare function globToRegExp(glob: string): RegExp;
-/** Match a project-relative path (posix separators) against a list of globs. */
+/** Match a project-relative path (posix separators) against a list of globs. Globs without `/` match the basename at any depth (gitignore-style). */
 declare function matchesAnyGlob(relPath: string, globs: string[] | undefined): boolean;
 
 interface DiffScope {
@@ -221,4 +261,43 @@ interface DiffScope {
  */
 declare function getChangedFiles(absProject: string, base: string): Promise<DiffScope>;
 
-export { CONFIG_FILE, type CloneGroup, type CodeChunk, type CodeIndex, type ConfigLang, type ContextOptions, type ContextResult, type Cycle, type DiffScope, type HealthReport, type Hotspot, type IndexedFile, type InvertedIndex, type ProjectConfig, type UnusedExport, analyzeProject, buildContext, buildIndex, chunkByTokens, clearConfigCache, cosineSimilarity, countTokens, disposeTreeSitter, embedIndex, ensureTreeSitterForExt, extractChunks, findProjectRoot, formatHealthReport, formatHealthReportMd, getChangedFiles, getEmbedding, getEmbeddings, getExtractor, getIndex, globToRegExp, initTreeSitter, loadIndex, loadProjectConfig, matchesAnyGlob, resolveProjectPath, saveIndex, scoreChunks, selectChunks, treeSitterReady, truncateToTokens };
+interface ToolPromptOptions {
+    context: string;
+    projectName: string;
+    lang?: string;
+    style?: string;
+    query?: string;
+    focus?: string;
+    filePath?: string;
+    description?: string;
+    crea?: boolean;
+    creaTheme?: string;
+}
+declare function langInstruction(lang?: string): string;
+declare function normalizeLabels(prompt: string, lang: string): string;
+declare function buildChatPrompt(question: string, context: string, projectName: string, crea?: boolean, creaTheme?: string, lang?: string): string;
+declare function buildSearchPrompt(query: string, context: string, projectName: string, crea?: boolean, creaTheme?: string, lang?: string): string;
+declare function buildExplainPrompt(target: string, context: string, projectName: string, crea?: boolean, creaTheme?: string, lang?: string): string;
+declare function buildRefactorPrompt(filePath: string, description: string, context: string, projectName: string, crea?: boolean, creaTheme?: string, lang?: string): string;
+declare function buildCreaPrompt(theme: string, context: string, projectName: string, lang?: string): string;
+declare function styleInstruction(style?: string, lang?: string): string;
+declare function buildIntelligencePrompt(context: string, projectName: string, focus?: string, style?: string, lang?: string): string;
+declare function buildAuditPrompt(context: string, projectName: string, focus?: string, lang?: string): string;
+declare function brandSignature(lang?: string): string;
+declare function buildAsciiBanner(projectName: string, modeLabel: string, tagline?: string): string;
+declare function buildReportPrompt(context: string, projectName: string, focus?: string, style?: string, lang?: string): string;
+declare function buildTasksPrompt(context: string, projectName: string, focus?: string, style?: string, lang?: string): string;
+declare function buildCeoPrompt(context: string, projectName: string, focus?: string, lang?: string): string;
+declare function buildBuildPrompt(context: string, projectName: string, focus?: string, lang?: string): string;
+declare function buildPlayerPrompt(context: string, projectName: string, focus?: string, lang?: string): string;
+declare function buildGitPrompt(context: string, projectName: string, focus?: string, lang?: string): string;
+declare function buildApplyPrompt(filePath: string, newContent: string, projectName: string, lang?: string): string;
+/**
+ * Assemble the full LLM prompt (context + persona + mandatory sections +
+ * ASCII banner + citation rules) for a codebase_* tool — the same text the
+ * DeepSeek Harness plugin sends, so MCP clients and the CLI get identical
+ * reports. Unknown tool names throw.
+ */
+declare function buildToolPrompt(tool: string, opts: ToolPromptOptions): string;
+
+export { CONFIG_FILE, type CloneGroup, type CodeChunk, type CodeIndex, type ConfigLang, type ContextOptions, type ContextResult, type Cycle, type DiffScope, type HealthReport, type Hotspot, type ImpactDependent, type ImpactReport, type ImpactResult, type IndexedFile, type InvertedIndex, type ProjectConfig, type ToolPromptOptions, type UnusedExport, analyzeImpact, analyzeProject, brandSignature, buildApplyPrompt, buildAsciiBanner, buildAuditPrompt, buildBuildPrompt, buildCeoPrompt, buildChatPrompt, buildContext, buildCreaPrompt, buildExplainPrompt, buildGitPrompt, buildIndex, buildIntelligencePrompt, buildPlayerPrompt, buildRefactorPrompt, buildReportPrompt, buildSearchPrompt, buildTasksPrompt, buildToolPrompt, chunkByTokens, clearConfigCache, cosineSimilarity, countTokens, disposeTreeSitter, embedIndex, ensureTreeSitterForExt, extractChunks, findProjectRoot, formatHealthReport, formatHealthReportMd, formatImpactReport, formatImpactReportMd, getCacheDir, getChangedFiles, getEmbedding, getEmbeddings, getExtractor, getIndex, globToRegExp, initTreeSitter, langInstruction, loadIndex, loadProjectConfig, matchesAnyGlob, normalizeLabels, resolveProjectPath, saveIndex, scoreChunks, selectChunks, styleInstruction, treeSitterReady, truncateToTokens };