opencode-telos 1.0.0

package/dist/sdd/cache/manager.d.ts

@@ -0,0 +1,237 @@
+import type { AnyNode, NodeType, Relationship } from "../domain/types.js";
+import type { KnowledgeGraph } from "../domain/types.js";
+interface ToolCacheEntry {
+    response: string;
+    timestamp: number;
+    lastAccess: number;
+    toolName: string;
+    argsHash: string;
+    graphVersion: string;
+}
+interface AnalysisCacheEntry {
+    result: unknown;
+    timestamp: number;
+    lastAccess: number;
+    graphVersion: number;
+    nodeCount: number;
+    type: string;
+}
+interface PersistentCacheData {
+    version: number;
+    toolResponses: Record<string, ToolCacheEntry>;
+    analysisResults: Record<string, AnalysisCacheEntry>;
+    graphSnapshot: {
+        nodeCount: number;
+        relationshipCount: number;
+        version: string;
+        lastModified: number;
+    } | null;
+    graphHash: string;
+}
+export declare class CacheManager {
+    private projectDir;
+    private toolResponses;
+    private analysisResults;
+    private invalidation;
+    private invalidationVersionOnWrite;
+    private graphCache;
+    private graphHash;
+    private stats;
+    constructor(projectDir: string);
+    /**
+     * Get cached tool response if valid.
+     * Checks: TTL (using lastAccess for freshness), graph version, invalidation status.
+     * F: Uses lazy revalidation — checks version before clearing.
+     */
+    getToolResponse(toolName: string, args: Record<string, unknown>, graphVersion: string): string | null;
+    /**
+     * Cache a tool response.
+     */
+    setToolResponse(toolName: string, args: Record<string, unknown>, response: string, graphVersion: string): void;
+    /**
+     * Get cached analysis result (validate, drift, quality, etc.).
+     * Revalidates based on graph state.
+     * F: Uses lazy revalidation.
+     */
+    getAnalysisResult(type: string, graphVersion: number, nodeCount: number): unknown | null;
+    /**
+     * Cache an analysis result.
+     */
+    setAnalysisResult(type: string, result: unknown, graphVersion: number, nodeCount: number): void;
+    /**
+     * Mark specific node IDs as dirty.
+     */
+    invalidateNodeIds(ids: string[]): void;
+    /**
+     * Mark specific relationship types as dirty.
+     */
+    invalidateRelTypes(types: string[]): void;
+    /**
+     * Full invalidation: clear everything.
+     * Now reserved only for explicit reset (H) or major structural changes.
+     */
+    invalidateAll(): void;
+    /**
+     * Partial invalidation: clear only affected caches.
+     * A: Much faster than full invalidation for targeted changes.
+     * Called by repositories after saveGraph() with the dirty types.
+     */
+    invalidatePartial(changedNodeTypes: string[], changedRelTypes?: string[]): void;
+    /**
+     * Invalidate specific node IDs (e.g., when a node is updated).
+     */
+    invalidateNodeId(nodeId: string, nodeType: string): void;
+    /**
+     * Load persistent cache from disk.
+     */
+    loadPersistentCache(): PersistentCacheData | null;
+    /**
+     * Save persistent cache to disk.
+     */
+    savePersistentCache(data: PersistentCacheData): void;
+    /**
+     * Restore tool responses from persistent cache.
+     * B: Uses lastAccess for TTL check so recently-accessed entries survive restore.
+     */
+    restoreFromPersistentCache(): number;
+    /**
+     * Persist current cache to disk.
+     */
+    persistToDisk(): void;
+    /**
+     * Save graph snapshot to disk (G).
+     * Called after graph mutations and on dispose.
+     */
+    saveGraphSnapshot(graph: KnowledgeGraph): void;
+    /**
+     * Load graph snapshot from disk (G).
+     * Returns null if no valid snapshot exists.
+     */
+    loadGraphSnapshot(): {
+        graph: KnowledgeGraph;
+        graphHash: string;
+    } | null;
+    /**
+     * Invalidate graph snapshot on disk.
+     */
+    invalidateGraphSnapshot(): void;
+    /**
+     * D: Check if another process has modified the graph since our last read.
+     * Uses file-based locking + PID liveness check for robust cross-process coordination.
+     */
+    checkCrossProcessInvalidation(graphPath: string): boolean;
+    /**
+     * Acquire cross-process lock before writing.
+     */
+    acquireWriteLock(): boolean;
+    /**
+     * Release cross-process lock.
+     */
+    releaseWriteLock(): void;
+    /**
+     * H: Full cache reset — clears everything in memory and on disk.
+     * Used by /sdd cache reset command.
+     */
+    fullReset(): {
+        cleared: {
+            memory: boolean;
+            disk: boolean;
+            snapshot: boolean;
+            lock: boolean;
+        };
+    };
+    /**
+     * Get current invalidation version (for external checks).
+     */
+    getInvalidationVersion(): number;
+    /**
+     * Sync invalidation version after external write.
+     */
+    syncInvalidationVersion(): void;
+    /**
+     * Get cached nodes for a specific type.
+     * Only returns if the cache version matches.
+     */
+    getCachedNodesByType(type: NodeType, graphVersion: number): AnyNode[] | null;
+    /**
+     * Cache nodes for a specific type.
+     */
+    setCachedNodesByType(type: NodeType, nodes: AnyNode[], graphVersion: number): void;
+    /**
+     * Invalidate cache for a specific node type only.
+     * Other types remain cached.
+     */
+    invalidateNodeType(type: NodeType): void;
+    /**
+     * Invalidate cache for multiple node types.
+     */
+    invalidateNodeTypes(types: string[]): void;
+    /**
+     * Get cached relationships.
+     */
+    getCachedRelationships(graphVersion: number): Relationship[] | null;
+    /**
+     * Cache relationships.
+     */
+    setCachedRelationships(rels: Relationship[], graphVersion: number): void;
+    /**
+     * Initialize the incremental hash from graph state.
+     */
+    initGraphHash(nodeCount: number, relCount: number): void;
+    /**
+     * Record a node mutation for incremental hash.
+     */
+    recordNodeMutation(delta?: number): void;
+    /**
+     * Record a relationship mutation for incremental hash.
+     */
+    recordRelMutation(delta?: number): void;
+    /**
+     * Get current graph hash.
+     */
+    getGraphHash(): string;
+    /**
+     * Check if graph hash matches.
+     */
+    isGraphHashValid(expectedHash: string): boolean;
+    /**
+     * Get current node count from incremental hash.
+     */
+    getNodeCountFromHash(): number;
+    getStats(): {
+        toolCacheSize: number;
+        analysisCacheSize: number;
+        invalidationVersion: number;
+        hitRate: string;
+        analysisHitRate: string;
+        toolHits: number;
+        toolMisses: number;
+        analysisHits: number;
+        analysisMisses: number;
+        invalidations: number;
+    };
+    private toolCacheKey;
+    private isToolAffectedByInvalidation;
+    private isAnalysisAffectedByInvalidation;
+    /**
+     * Clear dirty types that are relevant to a specific analysis type.
+     * Called after the analysis cache entry has been invalidated due to dirty types.
+     * This allows the cache to work again after the analysis is recomputed.
+     */
+    private clearDirtyTypesForAnalysis;
+    /**
+     * Clear dirty types that are relevant to a specific tool.
+     */
+    private clearDirtyTypesForTool;
+    private getToolDependentTypes;
+    private getAnalysisDependentTypes;
+    private getAnalysisTypesForNodeType;
+    private doesToolDependOnTypes;
+    private doesAnalysisDependOnTypes;
+    private evictOldestToolEntries;
+    private loadInvalidationTracker;
+    private saveInvalidationTracker;
+}
+export declare function getCacheManager(projectDir: string): CacheManager;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/sdd/cache/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/sdd/cache/manager.ts"],"names":[],"mappings":"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"}