@omfalos/mokosh 0.4.1 → 0.4.3

package/dist/index.d.mts

@@ -237,6 +237,10 @@ declare function configToGraphOptions(config: MokoshConfig | undefined): {
 declare const DEFAULT_CACHE_DIR = "mokosh-cache";
 /** Filename for the disk-persisted `find_duplicates` token cache within `DEFAULT_CACHE_DIR`. */
 declare const DEFAULT_DUPLICATION_TOKEN_CACHE_FILE = "duplication-tokens.json";
+/** Filename for the disk-persisted graph cache within `DEFAULT_CACHE_DIR`. Written by the CLI
+ *  (`src/cli/graph-loader.ts`) after every build; read by the MCP server (`src/mcp/cache.ts`) to
+ *  seed a session's first `analyze` call so it reuses unchanged nodes instead of parsing cold. */
+declare const DEFAULT_GRAPH_CACHE_FILE = "graph.json";
 declare const DEFAULT_IGNORE_DIRS: readonly string[];
 declare const DEFAULT_EXTENSIONS: readonly string[];
 interface ScanOptions {
@@ -1177,6 +1181,50 @@ declare function summarizeWorkspacePackages(wg: WorkspaceGraph): WorkspacePackag
  * @returns Whether any node has a defined `coveragePct`.
  */
 declare function hasCoverageData(graph: Graph): boolean;
+/**
+ * @description Returns `true` if at least one node in the graph has git churn data loaded.
+ * @param graph - The graph to check.
+ * @returns Whether any node has a defined `commitCount90d`.
+ */
+declare function hasChurnData(graph: Graph): boolean;
+interface RiskHotspotEntry {
+    file: string;
+    name: string;
+    line: number;
+    complexity: number;
+    cognitiveComplexity: number;
+    coveragePct: number;
+    commitCount90d?: number;
+}
+interface FindRiskHotspotsOptions {
+    metric?: "cognitiveComplexity" | "complexity" | undefined;
+    minComplexity?: number | undefined;
+    maxCoveragePct?: number | undefined;
+    minChurn?: number | undefined;
+    limit?: number | undefined;
+}
+interface RiskHotspotsResult {
+    hotspots: RiskHotspotEntry[];
+    count: number;
+    churnDataAvailable: boolean;
+}
+/**
+ * @description Finds functions that are complex, in a poorly-covered file, and — when git churn
+ *   data is loaded — in a frequently-changed file. Coverage and churn are file-level (the
+ *   containing file's `coveragePct`/`commitCount90d`), joined against each per-function
+ *   complexity entry, since neither is tracked per-function. Callers should check
+ *   `hasCoverageData` first and surface an explicit error if it's false, the same way
+ *   `find_uncovered` does — this function doesn't self-guard.
+ * @param graph - The graph to scan. Coverage data should already be loaded for useful results.
+ * @param options - `metric` picks which per-function score to filter/sort on (default
+ *   `cognitiveComplexity`); `minComplexity` is the minimum score to include (default 10);
+ *   `maxCoveragePct` is the maximum containing-file coverage to include (default 50);
+ *   `minChurn` is the minimum containing-file 90-day commit count to include (default 0),
+ *   ignored entirely when no node has churn data loaded; `limit` caps the results (default 20).
+ * @returns Matching functions sorted worst-first by `metric`, plus whether churn data was
+ *   available (and therefore whether `minChurn` was actually applied).
+ */
+declare function findRiskHotspots(graph: Graph, options?: FindRiskHotspotsOptions): RiskHotspotsResult;
 
 /** Symbol-name lookup across the whole graph — generalizes queryCallGraph beyond TS/JS functions. */
 
@@ -1469,4 +1517,4 @@ declare function createWorkspaceGraph(rootDir: string, options?: {
  */
 declare function getAllProjectFiles(rootDir: string, options?: ScanOptions): string[];
 
-export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CALL_EDGE_TYPES, type CachedFileTokens, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_CACHE_DIR, DEFAULT_DUPLICATION_TOKEN_CACHE_FILE, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type DuplicateFamily, type DuplicateGroup, type DuplicateOccurrence, type DuplicationTokenCache, EXPORT_TRACKING_TYPES, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, type FindDuplicatesOptions, type FindDuplicatesResult, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, IMPORT_SYMBOL_TYPES, ImportEdge, type LanguageCoverage, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, NodeCategory, type NodeMeta, type NodeQuery, type ParallelParsingOption, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, StructuredTag, type SymbolCaller, type SymbolImporter, type SymbolMatch, type SymbolPrecision, SymbolTraversalContext, type TestNodeIdentifier, type TraversalOptions, type TraversalVisitor, type TypeEdge, type TypeGraph, type TypeKind, type TypeNode, type TypeQueryResult, WorkspaceGraph, type WorkspacePackage, type WorkspacePackageSummary, type WorkspacePackagesSummary, applyConfig, applyTags, buildApiSurface, buildChangeImpactCache, buildFeatureGraph, buildResponsibilityGraph, buildTypeGraph, computeGraphHash, configToGraphOptions, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, findComplexFunctions, findDuplicates, findSymbol, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, getLanguageCoverage, getNodeMeta, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, loadTokenCacheFromDisk, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, saveTokenCacheToDisk, slimSerialize, summarizeWorkspacePackages, toMermaid };
+export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CALL_EDGE_TYPES, type CachedFileTokens, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_CACHE_DIR, DEFAULT_DUPLICATION_TOKEN_CACHE_FILE, DEFAULT_EXTENSIONS, DEFAULT_GRAPH_CACHE_FILE, DEFAULT_IGNORE_DIRS, type DependencyGraph, type DuplicateFamily, type DuplicateGroup, type DuplicateOccurrence, type DuplicationTokenCache, EXPORT_TRACKING_TYPES, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, type FindDuplicatesOptions, type FindDuplicatesResult, type FindRiskHotspotsOptions, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, IMPORT_SYMBOL_TYPES, ImportEdge, type LanguageCoverage, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, NodeCategory, type NodeMeta, type NodeQuery, type ParallelParsingOption, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type RiskHotspotEntry, type RiskHotspotsResult, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, StructuredTag, type SymbolCaller, type SymbolImporter, type SymbolMatch, type SymbolPrecision, SymbolTraversalContext, type TestNodeIdentifier, type TraversalOptions, type TraversalVisitor, type TypeEdge, type TypeGraph, type TypeKind, type TypeNode, type TypeQueryResult, WorkspaceGraph, type WorkspacePackage, type WorkspacePackageSummary, type WorkspacePackagesSummary, applyConfig, applyTags, buildApiSurface, buildChangeImpactCache, buildFeatureGraph, buildResponsibilityGraph, buildTypeGraph, computeGraphHash, configToGraphOptions, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, findComplexFunctions, findDuplicates, findRiskHotspots, findSymbol, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, getLanguageCoverage, getNodeMeta, hasChurnData, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, loadTokenCacheFromDisk, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, saveTokenCacheToDisk, slimSerialize, summarizeWorkspacePackages, toMermaid };

package/dist/index.d.ts

@@ -237,6 +237,10 @@ declare function configToGraphOptions(config: MokoshConfig | undefined): {
 declare const DEFAULT_CACHE_DIR = "mokosh-cache";
 /** Filename for the disk-persisted `find_duplicates` token cache within `DEFAULT_CACHE_DIR`. */
 declare const DEFAULT_DUPLICATION_TOKEN_CACHE_FILE = "duplication-tokens.json";
+/** Filename for the disk-persisted graph cache within `DEFAULT_CACHE_DIR`. Written by the CLI
+ *  (`src/cli/graph-loader.ts`) after every build; read by the MCP server (`src/mcp/cache.ts`) to
+ *  seed a session's first `analyze` call so it reuses unchanged nodes instead of parsing cold. */
+declare const DEFAULT_GRAPH_CACHE_FILE = "graph.json";
 declare const DEFAULT_IGNORE_DIRS: readonly string[];
 declare const DEFAULT_EXTENSIONS: readonly string[];
 interface ScanOptions {
@@ -1177,6 +1181,50 @@ declare function summarizeWorkspacePackages(wg: WorkspaceGraph): WorkspacePackag
  * @returns Whether any node has a defined `coveragePct`.
  */
 declare function hasCoverageData(graph: Graph): boolean;
+/**
+ * @description Returns `true` if at least one node in the graph has git churn data loaded.
+ * @param graph - The graph to check.
+ * @returns Whether any node has a defined `commitCount90d`.
+ */
+declare function hasChurnData(graph: Graph): boolean;
+interface RiskHotspotEntry {
+    file: string;
+    name: string;
+    line: number;
+    complexity: number;
+    cognitiveComplexity: number;
+    coveragePct: number;
+    commitCount90d?: number;
+}
+interface FindRiskHotspotsOptions {
+    metric?: "cognitiveComplexity" | "complexity" | undefined;
+    minComplexity?: number | undefined;
+    maxCoveragePct?: number | undefined;
+    minChurn?: number | undefined;
+    limit?: number | undefined;
+}
+interface RiskHotspotsResult {
+    hotspots: RiskHotspotEntry[];
+    count: number;
+    churnDataAvailable: boolean;
+}
+/**
+ * @description Finds functions that are complex, in a poorly-covered file, and — when git churn
+ *   data is loaded — in a frequently-changed file. Coverage and churn are file-level (the
+ *   containing file's `coveragePct`/`commitCount90d`), joined against each per-function
+ *   complexity entry, since neither is tracked per-function. Callers should check
+ *   `hasCoverageData` first and surface an explicit error if it's false, the same way
+ *   `find_uncovered` does — this function doesn't self-guard.
+ * @param graph - The graph to scan. Coverage data should already be loaded for useful results.
+ * @param options - `metric` picks which per-function score to filter/sort on (default
+ *   `cognitiveComplexity`); `minComplexity` is the minimum score to include (default 10);
+ *   `maxCoveragePct` is the maximum containing-file coverage to include (default 50);
+ *   `minChurn` is the minimum containing-file 90-day commit count to include (default 0),
+ *   ignored entirely when no node has churn data loaded; `limit` caps the results (default 20).
+ * @returns Matching functions sorted worst-first by `metric`, plus whether churn data was
+ *   available (and therefore whether `minChurn` was actually applied).
+ */
+declare function findRiskHotspots(graph: Graph, options?: FindRiskHotspotsOptions): RiskHotspotsResult;
 
 /** Symbol-name lookup across the whole graph — generalizes queryCallGraph beyond TS/JS functions. */
 
@@ -1469,4 +1517,4 @@ declare function createWorkspaceGraph(rootDir: string, options?: {
  */
 declare function getAllProjectFiles(rootDir: string, options?: ScanOptions): string[];
 
-export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CALL_EDGE_TYPES, type CachedFileTokens, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_CACHE_DIR, DEFAULT_DUPLICATION_TOKEN_CACHE_FILE, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type DuplicateFamily, type DuplicateGroup, type DuplicateOccurrence, type DuplicationTokenCache, EXPORT_TRACKING_TYPES, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, type FindDuplicatesOptions, type FindDuplicatesResult, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, IMPORT_SYMBOL_TYPES, ImportEdge, type LanguageCoverage, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, NodeCategory, type NodeMeta, type NodeQuery, type ParallelParsingOption, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, StructuredTag, type SymbolCaller, type SymbolImporter, type SymbolMatch, type SymbolPrecision, SymbolTraversalContext, type TestNodeIdentifier, type TraversalOptions, type TraversalVisitor, type TypeEdge, type TypeGraph, type TypeKind, type TypeNode, type TypeQueryResult, WorkspaceGraph, type WorkspacePackage, type WorkspacePackageSummary, type WorkspacePackagesSummary, applyConfig, applyTags, buildApiSurface, buildChangeImpactCache, buildFeatureGraph, buildResponsibilityGraph, buildTypeGraph, computeGraphHash, configToGraphOptions, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, findComplexFunctions, findDuplicates, findSymbol, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, getLanguageCoverage, getNodeMeta, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, loadTokenCacheFromDisk, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, saveTokenCacheToDisk, slimSerialize, summarizeWorkspacePackages, toMermaid };
+export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CALL_EDGE_TYPES, type CachedFileTokens, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_CACHE_DIR, DEFAULT_DUPLICATION_TOKEN_CACHE_FILE, DEFAULT_EXTENSIONS, DEFAULT_GRAPH_CACHE_FILE, DEFAULT_IGNORE_DIRS, type DependencyGraph, type DuplicateFamily, type DuplicateGroup, type DuplicateOccurrence, type DuplicationTokenCache, EXPORT_TRACKING_TYPES, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, type FindDuplicatesOptions, type FindDuplicatesResult, type FindRiskHotspotsOptions, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, IMPORT_SYMBOL_TYPES, ImportEdge, type LanguageCoverage, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, NodeCategory, type NodeMeta, type NodeQuery, type ParallelParsingOption, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type RiskHotspotEntry, type RiskHotspotsResult, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, StructuredTag, type SymbolCaller, type SymbolImporter, type SymbolMatch, type SymbolPrecision, SymbolTraversalContext, type TestNodeIdentifier, type TraversalOptions, type TraversalVisitor, type TypeEdge, type TypeGraph, type TypeKind, type TypeNode, type TypeQueryResult, WorkspaceGraph, type WorkspacePackage, type WorkspacePackageSummary, type WorkspacePackagesSummary, applyConfig, applyTags, buildApiSurface, buildChangeImpactCache, buildFeatureGraph, buildResponsibilityGraph, buildTypeGraph, computeGraphHash, configToGraphOptions, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, findComplexFunctions, findDuplicates, findRiskHotspots, findSymbol, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, getLanguageCoverage, getNodeMeta, hasChurnData, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, loadTokenCacheFromDisk, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, saveTokenCacheToDisk, slimSerialize, summarizeWorkspacePackages, toMermaid };