dsh-codebase-chat 0.22.0 → 0.24.0

package/dist/index.d.ts

@@ -57,12 +57,16 @@ interface ContextOptions {
     instruction?: string;
     /** Enable local semantic embeddings for retrieval */
     embed?: boolean;
+    /** Git ref (branch/tag/SHA) — scope retrieval to files changed vs this ref */
+    diff?: string;
 }
 interface ContextResult {
     absProject: string;
     context: string;
     chunks: CodeChunk[];
     tokenCount: number;
+    /** Project-relative files in scope when `diff` was requested */
+    diffFiles?: string[];
 }
 
 declare function buildContext(options: ContextOptions): Promise<ContextResult>;
@@ -75,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
@@ -166,10 +171,53 @@ interface HealthReport {
     score: number;
     grade: 'A' | 'B' | 'C' | 'D' | 'E';
 }
-declare function analyzeProject(projectPath: string): Promise<HealthReport>;
+interface AnalyzeOptions {
+    /** 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.
@@ -199,4 +247,18 @@ declare function globToRegExp(glob: string): RegExp;
 /** Match a project-relative path (posix separators) against a list of globs. */
 declare function matchesAnyGlob(relPath: string, globs: string[] | undefined): boolean;
 
-export { CONFIG_FILE, type CloneGroup, type CodeChunk, type CodeIndex, type ConfigLang, type ContextOptions, type ContextResult, type Cycle, 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, getEmbedding, getEmbeddings, getExtractor, getIndex, globToRegExp, initTreeSitter, loadIndex, loadProjectConfig, matchesAnyGlob, resolveProjectPath, saveIndex, scoreChunks, selectChunks, treeSitterReady, truncateToTokens };
+interface DiffScope {
+    /** Project-relative paths (forward slashes) changed vs the base ref. */
+    files: Set<string>;
+    /** False when the project is not a git repo or git is unavailable. */
+    ok: boolean;
+    /** Why the scope could not be computed (when ok === false). */
+    error?: string;
+}
+/**
+ * Files changed vs a git ref — committed diffs, staged/unstaged edits and
+ * untracked files. Used to scope retrieval and audits to "what changed".
+ */
+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 ImpactDependent, type ImpactReport, type ImpactResult, type IndexedFile, type InvertedIndex, type ProjectConfig, type UnusedExport, analyzeImpact, analyzeProject, buildContext, buildIndex, chunkByTokens, clearConfigCache, cosineSimilarity, countTokens, disposeTreeSitter, embedIndex, ensureTreeSitterForExt, extractChunks, findProjectRoot, formatHealthReport, formatHealthReportMd, formatImpactReport, formatImpactReportMd, getCacheDir, getChangedFiles, getEmbedding, getEmbeddings, getExtractor, getIndex, globToRegExp, initTreeSitter, loadIndex, loadProjectConfig, matchesAnyGlob, resolveProjectPath, saveIndex, scoreChunks, selectChunks, treeSitterReady, truncateToTokens };