@omfalos/mokosh 0.4.2 → 0.4.4

package/dist/index.d.mts

@@ -211,7 +211,12 @@ declare function loadMokoshConfig(rootDirOrPath: string, { allowJs, isExplicitPa
 }): MokoshConfig;
 /**
  * @description Applies a `MokoshConfig` to the global registries that control classification and scanning.
- *   Call this after `loadMokoshConfig` and before `createImportMap`.
+ *   Call this after `loadMokoshConfig` and before `createImportMap`. Resets those registries
+ *   first, so each call fully replaces the previously active config instead of accumulating on
+ *   top of it — otherwise a project's matchers/patterns/libraries would permanently leak into
+ *   every later `applyConfig` call in the same process (e.g. a different root analyzed in the
+ *   same long-running MCP server session), and a config narrowed or emptied on disk could never
+ *   actually shrink what was registered.
  * @param {MokoshConfig} config - The loaded config whose matchers, patterns, libraries, and thresholds are registered.
  */
 declare function applyConfig(config: MokoshConfig): void;
@@ -1181,6 +1186,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. */
 
@@ -1244,6 +1293,22 @@ declare function registerTestPattern(pattern: string): void;
  * @param lib - An import specifier substring, e.g. `"@my-org/test-utils"`.
  */
 declare function registerTestLibrary(lib: string): void;
+/**
+ * @description Clears every user-registered config matcher, test pattern, and test library,
+ *   and resets the barrel threshold to its default. These registries are process-global —
+ *   not scoped per project root — so without a reset between projects, one root's
+ *   `mokosh.config.json` settings would permanently leak into every other root analyzed
+ *   afterward in the same long-running process (e.g. an MCP server session), and a config
+ *   later narrowed or emptied could never actually shrink what's registered. `applyConfig`
+ *   calls this before registering the new config's values so each call fully replaces the
+ *   active registry state rather than accumulating on top of it, matching the documented
+ *   contract that unset `MokoshConfig` fields fall back to built-in defaults.
+ *
+ *   Not safe to call while another `applyConfig` + graph build for a different root is
+ *   still in flight — these registries have no per-root isolation, so overlapping builds
+ *   were already able to observe each other's state before this function existed.
+ */
+declare function resetClassifyRegistries(): void;
 
 /** Parser registry: maps FileType values to parser functions and provides lookup by file type. */
 
@@ -1473,4 +1538,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_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 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, resetClassifyRegistries, saveChangeImpactCache, saveTokenCacheToDisk, slimSerialize, summarizeWorkspacePackages, toMermaid };

package/dist/index.d.ts

@@ -211,7 +211,12 @@ declare function loadMokoshConfig(rootDirOrPath: string, { allowJs, isExplicitPa
 }): MokoshConfig;
 /**
  * @description Applies a `MokoshConfig` to the global registries that control classification and scanning.
- *   Call this after `loadMokoshConfig` and before `createImportMap`.
+ *   Call this after `loadMokoshConfig` and before `createImportMap`. Resets those registries
+ *   first, so each call fully replaces the previously active config instead of accumulating on
+ *   top of it — otherwise a project's matchers/patterns/libraries would permanently leak into
+ *   every later `applyConfig` call in the same process (e.g. a different root analyzed in the
+ *   same long-running MCP server session), and a config narrowed or emptied on disk could never
+ *   actually shrink what was registered.
  * @param {MokoshConfig} config - The loaded config whose matchers, patterns, libraries, and thresholds are registered.
  */
 declare function applyConfig(config: MokoshConfig): void;
@@ -1181,6 +1186,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. */
 
@@ -1244,6 +1293,22 @@ declare function registerTestPattern(pattern: string): void;
  * @param lib - An import specifier substring, e.g. `"@my-org/test-utils"`.
  */
 declare function registerTestLibrary(lib: string): void;
+/**
+ * @description Clears every user-registered config matcher, test pattern, and test library,
+ *   and resets the barrel threshold to its default. These registries are process-global —
+ *   not scoped per project root — so without a reset between projects, one root's
+ *   `mokosh.config.json` settings would permanently leak into every other root analyzed
+ *   afterward in the same long-running process (e.g. an MCP server session), and a config
+ *   later narrowed or emptied could never actually shrink what's registered. `applyConfig`
+ *   calls this before registering the new config's values so each call fully replaces the
+ *   active registry state rather than accumulating on top of it, matching the documented
+ *   contract that unset `MokoshConfig` fields fall back to built-in defaults.
+ *
+ *   Not safe to call while another `applyConfig` + graph build for a different root is
+ *   still in flight — these registries have no per-root isolation, so overlapping builds
+ *   were already able to observe each other's state before this function existed.
+ */
+declare function resetClassifyRegistries(): void;
 
 /** Parser registry: maps FileType values to parser functions and provides lookup by file type. */
 
@@ -1473,4 +1538,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_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 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, resetClassifyRegistries, saveChangeImpactCache, saveTokenCacheToDisk, slimSerialize, summarizeWorkspacePackages, toMermaid };