@omfalos/mokosh 0.1.9 → 0.1.11

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { F as FileNode, C as CallEdge, I as ImportEdge, a as FileType, P as ParseResult, S as StructuredTag } from './types-C9fLCS45.mjs';
-export { E as ExportedSymbol, b as ImportType, N as NodeCategory, T as TagKind } from './types-C9fLCS45.mjs';
+import { F as FileNode, C as CallEdge, I as ImportEdge, a as FileType, N as NodeCategory, P as ParseResult, S as StructuredTag } from './types-C9fLCS45.mjs';
+export { E as ExportedSymbol, b as ImportType, T as TagKind } from './types-C9fLCS45.mjs';
 
 interface SerializedGraph {
     nodes: FileNode[];
@@ -851,12 +851,50 @@ declare const MermaidExporter: GraphExporter;
  */
 declare function toMermaid(graph: Graph): string;
 
+/** Single source of truth for which languages' parsers track which precision-relevant data. */
+
+/** File types whose parser ever populates `FileNode.exports`. */
+declare const EXPORT_TRACKING_TYPES: ReadonlySet<FileType>;
+/** File types whose parser records which named symbols each import edge pulls in (`ImportEdge.symbols`). */
+declare const IMPORT_SYMBOL_TYPES: ReadonlySet<FileType>;
+/** File types whose parser records function-level call edges (`FileNode.callEdges`). */
+declare const CALL_EDGE_TYPES: ReadonlySet<FileType>;
+interface LanguageCoverage {
+    type: FileType;
+    fileCount: number;
+    exportsTracked: boolean;
+    importSymbolsTracked: boolean;
+    callEdgesTracked: boolean;
+}
+/**
+ * @description Reports which precision-relevant data mokosh actually tracks for each language
+ *   present in `graph` — so a caller can tell upfront whether tools like `find_symbol` or
+ *   `get_call_graph` will give call-level precision, degrade to import-level, or find nothing
+ *   at all for a given file, before running a query and being surprised by the result.
+ * @param graph - The graph to summarize.
+ * @returns One entry per `FileType` actually present in `graph`, sorted by file count
+ *   descending. Languages with zero files in this graph are omitted.
+ */
+declare function getLanguageCoverage(graph: Graph): LanguageCoverage[];
+
 /** 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[];
 }
+interface NodeMeta {
+    category: FileNode["category"];
+    exports: string[];
+}
+/**
+ * @description Looks up a node's category and export names, for augmenting traversal
+ *   results with `withMeta` so the AI doesn't need a follow-up `query` call.
+ * @param graph - The graph to look up in.
+ * @param path - Project-relative path of the node.
+ * @returns `{ category, exports }` for the node, or undefined if `path` isn't in the graph.
+ */
+declare function getNodeMeta(graph: Graph, path: string): NodeMeta | undefined;
 /**
  * @description Outgoing traversal from `file` — all files it imports, up to `depth` hops.
  * @param graph - The graph to traverse.
@@ -972,6 +1010,38 @@ declare function summarizeWorkspacePackages(wg: WorkspaceGraph): WorkspacePackag
  */
 declare function hasCoverageData(graph: Graph): boolean;
 
+/** Symbol-name lookup across the whole graph — generalizes queryCallGraph beyond TS/JS functions. */
+
+type SymbolPrecision = "call" | "import-symbol" | "file-level";
+interface SymbolCaller {
+    file: string;
+    callerFunction: string;
+}
+interface SymbolImporter {
+    file: string;
+    symbols?: string[];
+}
+interface SymbolMatch {
+    path: string;
+    category: NodeCategory;
+    precision: SymbolPrecision;
+    callers?: SymbolCaller[];
+    importers?: SymbolImporter[];
+}
+/**
+ * @description Finds every file that exports a symbol by name, with the best available
+ *   usage info per match. Precision depends on what the defining file's language parser
+ *   tracks: TS/JS gets function-level callers via call edges, Python gets named-import
+ *   tracking, everything else falls back to whole-file dependents (import-level, not
+ *   symbol-level — the file might not even use this specific export).
+ * @param graph - The graph to search.
+ * @param name - Exact export name to look up.
+ * @returns One entry per file that exports `name`; empty if no file does (including
+ *   languages — CoffeeScript, LiveScript, Lua, Gherkin, Markdown, CSS/SCSS/Stylus — whose
+ *   parsers never populate `exports` at all).
+ */
+declare function findSymbol(graph: Graph, name: string): SymbolMatch[];
+
 /** A config matcher: substring, regex, or predicate tested against the lowercase basename. */
 type ConfigMatcher = string | RegExp | ((baseName: string) => boolean);
 /**
@@ -1229,4 +1299,4 @@ declare function createWorkspaceGraph(rootDir: string, options?: {
  */
 declare function getAllProjectFiles(rootDir: string, options?: ScanOptions): string[];
 
-export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, ImportEdge, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, type NodeQuery, type ParallelParsingOption, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, StructuredTag, 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, 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 };
+export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CALL_EDGE_TYPES, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, EXPORT_TRACKING_TYPES, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, 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, findSymbol, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, getLanguageCoverage, getNodeMeta, 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

@@ -1,5 +1,5 @@
-import { F as FileNode, C as CallEdge, I as ImportEdge, a as FileType, P as ParseResult, S as StructuredTag } from './types-C9fLCS45.js';
-export { E as ExportedSymbol, b as ImportType, N as NodeCategory, T as TagKind } from './types-C9fLCS45.js';
+import { F as FileNode, C as CallEdge, I as ImportEdge, a as FileType, N as NodeCategory, P as ParseResult, S as StructuredTag } from './types-C9fLCS45.js';
+export { E as ExportedSymbol, b as ImportType, T as TagKind } from './types-C9fLCS45.js';
 
 interface SerializedGraph {
     nodes: FileNode[];
@@ -851,12 +851,50 @@ declare const MermaidExporter: GraphExporter;
  */
 declare function toMermaid(graph: Graph): string;
 
+/** Single source of truth for which languages' parsers track which precision-relevant data. */
+
+/** File types whose parser ever populates `FileNode.exports`. */
+declare const EXPORT_TRACKING_TYPES: ReadonlySet<FileType>;
+/** File types whose parser records which named symbols each import edge pulls in (`ImportEdge.symbols`). */
+declare const IMPORT_SYMBOL_TYPES: ReadonlySet<FileType>;
+/** File types whose parser records function-level call edges (`FileNode.callEdges`). */
+declare const CALL_EDGE_TYPES: ReadonlySet<FileType>;
+interface LanguageCoverage {
+    type: FileType;
+    fileCount: number;
+    exportsTracked: boolean;
+    importSymbolsTracked: boolean;
+    callEdgesTracked: boolean;
+}
+/**
+ * @description Reports which precision-relevant data mokosh actually tracks for each language
+ *   present in `graph` — so a caller can tell upfront whether tools like `find_symbol` or
+ *   `get_call_graph` will give call-level precision, degrade to import-level, or find nothing
+ *   at all for a given file, before running a query and being surprised by the result.
+ * @param graph - The graph to summarize.
+ * @returns One entry per `FileType` actually present in `graph`, sorted by file count
+ *   descending. Languages with zero files in this graph are omitted.
+ */
+declare function getLanguageCoverage(graph: Graph): LanguageCoverage[];
+
 /** 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[];
 }
+interface NodeMeta {
+    category: FileNode["category"];
+    exports: string[];
+}
+/**
+ * @description Looks up a node's category and export names, for augmenting traversal
+ *   results with `withMeta` so the AI doesn't need a follow-up `query` call.
+ * @param graph - The graph to look up in.
+ * @param path - Project-relative path of the node.
+ * @returns `{ category, exports }` for the node, or undefined if `path` isn't in the graph.
+ */
+declare function getNodeMeta(graph: Graph, path: string): NodeMeta | undefined;
 /**
  * @description Outgoing traversal from `file` — all files it imports, up to `depth` hops.
  * @param graph - The graph to traverse.
@@ -972,6 +1010,38 @@ declare function summarizeWorkspacePackages(wg: WorkspaceGraph): WorkspacePackag
  */
 declare function hasCoverageData(graph: Graph): boolean;
 
+/** Symbol-name lookup across the whole graph — generalizes queryCallGraph beyond TS/JS functions. */
+
+type SymbolPrecision = "call" | "import-symbol" | "file-level";
+interface SymbolCaller {
+    file: string;
+    callerFunction: string;
+}
+interface SymbolImporter {
+    file: string;
+    symbols?: string[];
+}
+interface SymbolMatch {
+    path: string;
+    category: NodeCategory;
+    precision: SymbolPrecision;
+    callers?: SymbolCaller[];
+    importers?: SymbolImporter[];
+}
+/**
+ * @description Finds every file that exports a symbol by name, with the best available
+ *   usage info per match. Precision depends on what the defining file's language parser
+ *   tracks: TS/JS gets function-level callers via call edges, Python gets named-import
+ *   tracking, everything else falls back to whole-file dependents (import-level, not
+ *   symbol-level — the file might not even use this specific export).
+ * @param graph - The graph to search.
+ * @param name - Exact export name to look up.
+ * @returns One entry per file that exports `name`; empty if no file does (including
+ *   languages — CoffeeScript, LiveScript, Lua, Gherkin, Markdown, CSS/SCSS/Stylus — whose
+ *   parsers never populate `exports` at all).
+ */
+declare function findSymbol(graph: Graph, name: string): SymbolMatch[];
+
 /** A config matcher: substring, regex, or predicate tested against the lowercase basename. */
 type ConfigMatcher = string | RegExp | ((baseName: string) => boolean);
 /**
@@ -1229,4 +1299,4 @@ declare function createWorkspaceGraph(rootDir: string, options?: {
  */
 declare function getAllProjectFiles(rootDir: string, options?: ScanOptions): string[];
 
-export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, type FunctionCallInfo, type GetAffectedOptions, type GetCallersOptions, Graph, type CallerEntry as GraphCallerEntry, type GraphExporter, ImportEdge, MermaidExporter, type ModuleResponsibility, type ModuleRole, type MokoshConfig, type MonorepoDetector, type MonorepoLayout, type NodeQuery, type ParallelParsingOption, type PathWithSymbols, type ProposeTagsOptions, type PublicExport, type ResponsibilityGraph, type ScanOptions, type SerializedGraph, type SerializedWorkspaceGraph, type SlimNode, type SlimSerializedGraph, StructuredTag, 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, 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 };
+export { type ApiSurface, type ApplyTagsFileResult, type ApplyTagsResult, CALL_EDGE_TYPES, CallEdge, type CalleeEntry, type CallerEntry$1 as CallerEntry, type ChangeImpactCache, type ComplexFunctionEntry, DEFAULT_EXTENSIONS, DEFAULT_IGNORE_DIRS, type DependencyGraph, EXPORT_TRACKING_TYPES, type ExportKind, type FeatureDetectionOptions, type FeatureDomain, type FeatureGraph, type FeatureGraphOptions, type FeatureInfo, FileNode, FileType, type FindComplexFunctionsOptions, 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, findSymbol, getAffected, getAllProjectFiles, getCallers, getDependencies, getDependents, getLanguageCoverage, getNodeMeta, hasCoverageData, isChangeImpactCacheValid, loadChangeImpactCache, loadCoverageMap, loadMokoshConfig, parseQuery, proposeAffectedTests, proposeTags, queryCallGraph, queryChangeImpact, queryTypeGraph, registerConfigMatcher, registerMonorepoDetector, registerParser, registerTestLibrary, registerTestPattern, saveChangeImpactCache, slimSerialize, summarizeWorkspacePackages, toMermaid };