@omfalos/mokosh 0.1.3 → 0.1.5

package/dist/index.d.mts

@@ -348,7 +348,7 @@ declare function buildApiSurface(graph: Graph, entryPoints: string[]): ApiSurfac
 
 /** Public types for the call-graph subsystem. */
 /** A file and function name that calls the target function. */
-interface CallerEntry {
+interface CallerEntry$1 {
     /** Project-relative path of the file containing the caller. */
     file: string;
     /** Name of the function that makes the call. */
@@ -375,7 +375,7 @@ interface FunctionCallInfo {
      */
     definedIn: string | null;
     /** Files and functions that call this function. */
-    callers: CallerEntry[];
+    callers: CallerEntry$1[];
     /** Files and functions that this function calls. */
     callees: CalleeEntry[];
 }
@@ -883,6 +883,127 @@ declare const MermaidExporter: GraphExporter;
  */
 declare function toMermaid(graph: Graph): string;
 
+/** Pure graph query/shaping functions shared by the MCP handlers and the CLI, so both surfaces return identical JSON shapes. */
+
+interface PathWithSymbols {
+    path: string;
+    symbols?: string[];
+}
+/**
+ * @description Outgoing traversal from `file` — all files it imports, up to `depth` hops.
+ * @param graph - The graph to traverse.
+ * @param file - Project-relative path of the starting node.
+ * @param depth - Max traversal depth (default 1 = immediate imports only).
+ * @returns Reachable imported paths, each with the symbols imported from it when known.
+ */
+declare function getDependencies(graph: Graph, file: string, depth?: number): PathWithSymbols[];
+/**
+ * @description Incoming one-hop traversal — files that directly import `file`.
+ * @param graph - The graph to traverse.
+ * @param file - Project-relative path of the target node.
+ * @returns Direct importers, each with the symbols they import from `file` when known.
+ */
+declare function getDependents(graph: Graph, file: string): PathWithSymbols[];
+interface GetAffectedOptions {
+    testsOnly?: boolean | undefined;
+    changedSymbols?: string[] | undefined;
+}
+/**
+ * @description Full incoming traversal from `file` upward — every file transitively affected if `file` changes.
+ * @param graph - The graph to traverse.
+ * @param file - Project-relative path of the changed node.
+ * @param options - `testsOnly` restricts results to test/spec files; `changedSymbols` restricts propagation to files that actually import those symbols.
+ * @returns Project-relative paths of all transitively impacted files.
+ */
+declare function getAffected(graph: Graph, file: string, options?: GetAffectedOptions): string[];
+interface CallerEntry {
+    file: string;
+    edges?: Array<{
+        from: string;
+        to: string;
+    }>;
+}
+interface GetCallersOptions {
+    depth?: number | undefined;
+    withEdgeDetail?: boolean | undefined;
+}
+/**
+ * @description Incoming call-edge traversal — files whose exported functions call into `file`.
+ *   More precise than `getAffected` because it follows runtime call edges rather than all import edges.
+ * @param graph - The graph to traverse.
+ * @param file - Project-relative path of the target node.
+ * @param options - `depth` caps traversal hops (default 1); `withEdgeDetail` adds from/to function names per edge.
+ * @returns Callers, each optionally including edge detail.
+ */
+declare function getCallers(graph: Graph, file: string, options?: GetCallersOptions): CallerEntry[];
+interface ComplexFunctionEntry {
+    file: string;
+    name: string;
+    line: number;
+    complexity: number;
+    cognitiveComplexity: number;
+}
+interface FindComplexFunctionsOptions {
+    metric?: "cognitiveComplexity" | "complexity" | undefined;
+    threshold?: number | undefined;
+    limit?: number | undefined;
+}
+/**
+ * @description Scans every file's per-function complexity breakdown and returns functions/methods
+ *   at or above the given threshold, sorted worst-first. TypeScript/JavaScript only.
+ * @param graph - The graph to scan.
+ * @param options - `metric` picks which score to threshold/sort on (default `cognitiveComplexity`); `threshold` is the minimum score to include (default 10); `limit` caps the results (default 20).
+ * @returns Matching functions, sorted worst-first.
+ */
+declare function findComplexFunctions(graph: Graph, options?: FindComplexFunctionsOptions): ComplexFunctionEntry[];
+interface SlimNode {
+    path: string;
+    type: FileNode["type"];
+    category: FileNode["category"];
+    exports: string[];
+    tags: string[];
+    importsFiles: string[];
+    description?: string;
+    testedBy?: string[];
+    coveragePct?: number;
+    avgExportUsage?: number;
+    maxExportUsage?: number;
+}
+interface SlimSerializedGraph {
+    nodes: SlimNode[];
+    cycles: string[][] | undefined;
+}
+/**
+ * @description Strips a serialized graph down to a compact response: export names, meaningful tags,
+ *   and a flat importsFiles path list — no edge objects, no mtime/size.
+ * @param filtered - A `SerializedGraph` (typically the output of `filterGraph`) to compact.
+ * @returns The slim node list plus cycle info.
+ */
+declare function slimSerialize(filtered: SerializedGraph): SlimSerializedGraph;
+interface WorkspacePackageSummary {
+    name: string;
+    relativeRoot: string;
+    nodeCount: number;
+    dependsOn: string[];
+}
+interface WorkspacePackagesSummary {
+    monorepoType: string;
+    packageCount: number;
+    packages: WorkspacePackageSummary[];
+}
+/**
+ * @description Summarizes every package in a workspace graph: node counts and cross-package dependencies.
+ * @param wg - The workspace graph to summarize.
+ * @returns Monorepo type, package count, and per-package details.
+ */
+declare function summarizeWorkspacePackages(wg: WorkspaceGraph): WorkspacePackagesSummary;
+/**
+ * @description Returns `true` if at least one node in the graph has coverage data loaded.
+ * @param graph - The graph to check.
+ * @returns Whether any node has a defined `coveragePct`.
+ */
+declare function hasCoverageData(graph: Graph): boolean;
+
 /** A config matcher: substring, regex, or predicate tested against the lowercase basename. */
 type ConfigMatcher = string | RegExp | ((baseName: string) => boolean);
 /**
@@ -1132,4 +1253,4 @@ declare function createWorkspaceGraph(rootDir: string, options?: {
  */
 declare function getAllProjectFiles(rootDir: string, options?: ScanOptions): string[];
 
-export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, type CallEdge, type CalleeEntry, type CallerEntry, type ChangeImpactCache, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type ExportKind, type ExportedSymbol, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, type FileNode, type FileType, type FunctionCallInfo, Graph, type GraphExporter, type ImportEdge, type ImportType, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, type NodeCategory, type NodeQuery, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type StructuredTag, SymbolTraversalContext, type TagKind, type TestNodeIdentifier, type TraversalOptions, type TraversalVisitor, type TypeEdge, type TypeGraph, type TypeKind, type TypeNode, type TypeQueryResult, WorkspaceGraph, type WorkspacePackage, applyConfig, applyTags, buildApiSurface, buildChangeImpactCache, buildFeatureGraph, buildResponsibilityGraph, buildTypeGraph, computeGraphHash, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, getAllProjectFiles, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, toMermaid };
+export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, type CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type ExportKind, type ExportedSymbol, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, type FileNode, type FileType, type FindComplexFunctionsOptions, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, type ImportEdge, type ImportType, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, type NodeCategory, type NodeQuery, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, type StructuredTag, SymbolTraversalContext, type TagKind, 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, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, findComplexFunctions, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, slimSerialize, summarizeWorkspacePackages, toMermaid };

package/dist/index.d.ts

@@ -348,7 +348,7 @@ declare function buildApiSurface(graph: Graph, entryPoints: string[]): ApiSurfac
 
 /** Public types for the call-graph subsystem. */
 /** A file and function name that calls the target function. */
-interface CallerEntry {
+interface CallerEntry$1 {
     /** Project-relative path of the file containing the caller. */
     file: string;
     /** Name of the function that makes the call. */
@@ -375,7 +375,7 @@ interface FunctionCallInfo {
      */
     definedIn: string | null;
     /** Files and functions that call this function. */
-    callers: CallerEntry[];
+    callers: CallerEntry$1[];
     /** Files and functions that this function calls. */
     callees: CalleeEntry[];
 }
@@ -883,6 +883,127 @@ declare const MermaidExporter: GraphExporter;
  */
 declare function toMermaid(graph: Graph): string;
 
+/** Pure graph query/shaping functions shared by the MCP handlers and the CLI, so both surfaces return identical JSON shapes. */
+
+interface PathWithSymbols {
+    path: string;
+    symbols?: string[];
+}
+/**
+ * @description Outgoing traversal from `file` — all files it imports, up to `depth` hops.
+ * @param graph - The graph to traverse.
+ * @param file - Project-relative path of the starting node.
+ * @param depth - Max traversal depth (default 1 = immediate imports only).
+ * @returns Reachable imported paths, each with the symbols imported from it when known.
+ */
+declare function getDependencies(graph: Graph, file: string, depth?: number): PathWithSymbols[];
+/**
+ * @description Incoming one-hop traversal — files that directly import `file`.
+ * @param graph - The graph to traverse.
+ * @param file - Project-relative path of the target node.
+ * @returns Direct importers, each with the symbols they import from `file` when known.
+ */
+declare function getDependents(graph: Graph, file: string): PathWithSymbols[];
+interface GetAffectedOptions {
+    testsOnly?: boolean | undefined;
+    changedSymbols?: string[] | undefined;
+}
+/**
+ * @description Full incoming traversal from `file` upward — every file transitively affected if `file` changes.
+ * @param graph - The graph to traverse.
+ * @param file - Project-relative path of the changed node.
+ * @param options - `testsOnly` restricts results to test/spec files; `changedSymbols` restricts propagation to files that actually import those symbols.
+ * @returns Project-relative paths of all transitively impacted files.
+ */
+declare function getAffected(graph: Graph, file: string, options?: GetAffectedOptions): string[];
+interface CallerEntry {
+    file: string;
+    edges?: Array<{
+        from: string;
+        to: string;
+    }>;
+}
+interface GetCallersOptions {
+    depth?: number | undefined;
+    withEdgeDetail?: boolean | undefined;
+}
+/**
+ * @description Incoming call-edge traversal — files whose exported functions call into `file`.
+ *   More precise than `getAffected` because it follows runtime call edges rather than all import edges.
+ * @param graph - The graph to traverse.
+ * @param file - Project-relative path of the target node.
+ * @param options - `depth` caps traversal hops (default 1); `withEdgeDetail` adds from/to function names per edge.
+ * @returns Callers, each optionally including edge detail.
+ */
+declare function getCallers(graph: Graph, file: string, options?: GetCallersOptions): CallerEntry[];
+interface ComplexFunctionEntry {
+    file: string;
+    name: string;
+    line: number;
+    complexity: number;
+    cognitiveComplexity: number;
+}
+interface FindComplexFunctionsOptions {
+    metric?: "cognitiveComplexity" | "complexity" | undefined;
+    threshold?: number | undefined;
+    limit?: number | undefined;
+}
+/**
+ * @description Scans every file's per-function complexity breakdown and returns functions/methods
+ *   at or above the given threshold, sorted worst-first. TypeScript/JavaScript only.
+ * @param graph - The graph to scan.
+ * @param options - `metric` picks which score to threshold/sort on (default `cognitiveComplexity`); `threshold` is the minimum score to include (default 10); `limit` caps the results (default 20).
+ * @returns Matching functions, sorted worst-first.
+ */
+declare function findComplexFunctions(graph: Graph, options?: FindComplexFunctionsOptions): ComplexFunctionEntry[];
+interface SlimNode {
+    path: string;
+    type: FileNode["type"];
+    category: FileNode["category"];
+    exports: string[];
+    tags: string[];
+    importsFiles: string[];
+    description?: string;
+    testedBy?: string[];
+    coveragePct?: number;
+    avgExportUsage?: number;
+    maxExportUsage?: number;
+}
+interface SlimSerializedGraph {
+    nodes: SlimNode[];
+    cycles: string[][] | undefined;
+}
+/**
+ * @description Strips a serialized graph down to a compact response: export names, meaningful tags,
+ *   and a flat importsFiles path list — no edge objects, no mtime/size.
+ * @param filtered - A `SerializedGraph` (typically the output of `filterGraph`) to compact.
+ * @returns The slim node list plus cycle info.
+ */
+declare function slimSerialize(filtered: SerializedGraph): SlimSerializedGraph;
+interface WorkspacePackageSummary {
+    name: string;
+    relativeRoot: string;
+    nodeCount: number;
+    dependsOn: string[];
+}
+interface WorkspacePackagesSummary {
+    monorepoType: string;
+    packageCount: number;
+    packages: WorkspacePackageSummary[];
+}
+/**
+ * @description Summarizes every package in a workspace graph: node counts and cross-package dependencies.
+ * @param wg - The workspace graph to summarize.
+ * @returns Monorepo type, package count, and per-package details.
+ */
+declare function summarizeWorkspacePackages(wg: WorkspaceGraph): WorkspacePackagesSummary;
+/**
+ * @description Returns `true` if at least one node in the graph has coverage data loaded.
+ * @param graph - The graph to check.
+ * @returns Whether any node has a defined `coveragePct`.
+ */
+declare function hasCoverageData(graph: Graph): boolean;
+
 /** A config matcher: substring, regex, or predicate tested against the lowercase basename. */
 type ConfigMatcher = string | RegExp | ((baseName: string) => boolean);
 /**
@@ -1132,4 +1253,4 @@ declare function createWorkspaceGraph(rootDir: string, options?: {
  */
 declare function getAllProjectFiles(rootDir: string, options?: ScanOptions): string[];
 
-export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, type CallEdge, type CalleeEntry, type CallerEntry, type ChangeImpactCache, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type ExportKind, type ExportedSymbol, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, type FileNode, type FileType, type FunctionCallInfo, Graph, type GraphExporter, type ImportEdge, type ImportType, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, type NodeCategory, type NodeQuery, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type StructuredTag, SymbolTraversalContext, type TagKind, type TestNodeIdentifier, type TraversalOptions, type TraversalVisitor, type TypeEdge, type TypeGraph, type TypeKind, type TypeNode, type TypeQueryResult, WorkspaceGraph, type WorkspacePackage, applyConfig, applyTags, buildApiSurface, buildChangeImpactCache, buildFeatureGraph, buildResponsibilityGraph, buildTypeGraph, computeGraphHash, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, getAllProjectFiles, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, toMermaid };
+export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, type CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type ExportKind, type ExportedSymbol, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, type FileNode, type FileType, type FindComplexFunctionsOptions, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, type ImportEdge, type ImportType, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, type NodeCategory, type NodeQuery, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, type StructuredTag, SymbolTraversalContext, type TagKind, 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, createImportMap, createWorkspaceGraph, detectAllEntryPoints, detectEntryPoint, detectFeatures, detectMonorepo, filterGraph, findComplexFunctions, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, slimSerialize, summarizeWorkspacePackages, toMermaid };