@omfalos/mokosh 0.4.0 → 0.4.2

package/dist/index.d.mts

@@ -230,6 +230,17 @@ declare function configToGraphOptions(config: MokoshConfig | undefined): {
     pathAliases: Record<string, string[]> | undefined;
 };
 
+/** Shared by the CLI's disk graph cache (`src/cli/graph-loader.ts`) and the MCP server's
+ *  disk-persisted duplication token cache (`src/graph/duplication/token-cache-store.ts`) so both
+ *  consumers agree on where "the cache dir" is — a CLI run and an MCP session against the same
+ *  root end up sharing the same on-disk files. */
+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 {
@@ -493,13 +504,6 @@ interface DuplicateGroup {
     family?: DuplicateFamily | undefined;
 }
 
-/** Configures whether/how tokenizing is offloaded to a `piscina` worker pool. `false` always
- *  tokenizes in-process. */
-type ParallelTokenizingOption = boolean | {
-    minFiles?: number;
-    maxThreads?: number;
-};
-
 /** One file's cached tokenize result, fingerprinted by `mtime`/`size`/`ignoreLiterals` — any
  *  mismatch against the current `FileNode` (or against the `ignoreLiterals` this scan is running
  *  with) means the entry is stale and must be recomputed, exactly like `GraphBuilder`'s
@@ -516,6 +520,33 @@ interface CachedFileTokens {
  *  benefit own the `Map` and pass it in; the CLI's one-shot process has nothing to gain and omits
  *  it. See docs/adr-014-duplicate-detection-scale.md. */
 type DuplicationTokenCache = Map<string, CachedFileTokens>;
+/**
+ * @description Reads a serialized `DuplicationTokenCache` from a JSON disk file written by
+ *   `saveTokenCacheToDisk`. Any problem reading or parsing the file — missing, corrupt JSON,
+ *   or a value that doesn't look like `[path, CachedFileTokens][]` — degrades to an empty `Map`
+ *   instead of throwing, since a token cache is pure acceleration, never a source of truth.
+ * @param cachePath - Path to the JSON file written by `saveTokenCacheToDisk`.
+ * @returns The reconstituted `DuplicationTokenCache`, empty if nothing usable was found.
+ */
+declare function loadTokenCacheFromDisk(cachePath: string): DuplicationTokenCache;
+/**
+ * @description Serializes a `DuplicationTokenCache` to JSON and writes it to disk, creating any
+ *   missing parent directories. Callers should save the same `Map` `findDuplicates` already
+ *   prunes to the current candidate file set after each scan (see `./index.ts`'s post-scan
+ *   pruning), so the file never grows to hold stale entries beyond what the in-memory cache
+ *   already holds — no separate pruning step is needed here.
+ * @param cache - The token cache to persist.
+ * @param cachePath - Destination path; parent directories are created automatically.
+ */
+declare function saveTokenCacheToDisk(cache: DuplicationTokenCache, cachePath: string): void;
+
+/** Configures whether/how tokenizing is offloaded to a `piscina` worker pool. `false` always
+ *  tokenizes in-process. */
+type ParallelTokenizingOption = boolean | {
+    minFiles?: number;
+    maxThreads?: number;
+};
+
 interface FindDuplicatesOptions {
     /** Minimum duplicated block size, in source lines, to report (default 6). */
     minLines?: number | undefined;
@@ -1442,4 +1473,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_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, 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, 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 };

package/dist/index.d.ts

@@ -230,6 +230,17 @@ declare function configToGraphOptions(config: MokoshConfig | undefined): {
     pathAliases: Record<string, string[]> | undefined;
 };
 
+/** Shared by the CLI's disk graph cache (`src/cli/graph-loader.ts`) and the MCP server's
+ *  disk-persisted duplication token cache (`src/graph/duplication/token-cache-store.ts`) so both
+ *  consumers agree on where "the cache dir" is — a CLI run and an MCP session against the same
+ *  root end up sharing the same on-disk files. */
+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 {
@@ -493,13 +504,6 @@ interface DuplicateGroup {
     family?: DuplicateFamily | undefined;
 }
 
-/** Configures whether/how tokenizing is offloaded to a `piscina` worker pool. `false` always
- *  tokenizes in-process. */
-type ParallelTokenizingOption = boolean | {
-    minFiles?: number;
-    maxThreads?: number;
-};
-
 /** One file's cached tokenize result, fingerprinted by `mtime`/`size`/`ignoreLiterals` — any
  *  mismatch against the current `FileNode` (or against the `ignoreLiterals` this scan is running
  *  with) means the entry is stale and must be recomputed, exactly like `GraphBuilder`'s
@@ -516,6 +520,33 @@ interface CachedFileTokens {
  *  benefit own the `Map` and pass it in; the CLI's one-shot process has nothing to gain and omits
  *  it. See docs/adr-014-duplicate-detection-scale.md. */
 type DuplicationTokenCache = Map<string, CachedFileTokens>;
+/**
+ * @description Reads a serialized `DuplicationTokenCache` from a JSON disk file written by
+ *   `saveTokenCacheToDisk`. Any problem reading or parsing the file — missing, corrupt JSON,
+ *   or a value that doesn't look like `[path, CachedFileTokens][]` — degrades to an empty `Map`
+ *   instead of throwing, since a token cache is pure acceleration, never a source of truth.
+ * @param cachePath - Path to the JSON file written by `saveTokenCacheToDisk`.
+ * @returns The reconstituted `DuplicationTokenCache`, empty if nothing usable was found.
+ */
+declare function loadTokenCacheFromDisk(cachePath: string): DuplicationTokenCache;
+/**
+ * @description Serializes a `DuplicationTokenCache` to JSON and writes it to disk, creating any
+ *   missing parent directories. Callers should save the same `Map` `findDuplicates` already
+ *   prunes to the current candidate file set after each scan (see `./index.ts`'s post-scan
+ *   pruning), so the file never grows to hold stale entries beyond what the in-memory cache
+ *   already holds — no separate pruning step is needed here.
+ * @param cache - The token cache to persist.
+ * @param cachePath - Destination path; parent directories are created automatically.
+ */
+declare function saveTokenCacheToDisk(cache: DuplicationTokenCache, cachePath: string): void;
+
+/** Configures whether/how tokenizing is offloaded to a `piscina` worker pool. `false` always
+ *  tokenizes in-process. */
+type ParallelTokenizingOption = boolean | {
+    minFiles?: number;
+    maxThreads?: number;
+};
+
 interface FindDuplicatesOptions {
     /** Minimum duplicated block size, in source lines, to report (default 6). */
     minLines?: number | undefined;
@@ -1442,4 +1473,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_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, 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, 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 };