opencode-telos 1.0.0 → 1.0.2

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

@@ -0,0 +1,3 @@
+/** Write a cache artifact so readers see either the old complete file or the new complete file. */
+export declare function atomicWriteFile(filePath: string, content: string): void;
+//# sourceMappingURL=atomic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.d.ts","sourceRoot":"","sources":["../../../src/sdd/cache/atomic.ts"],"names":[],"mappings":"AAGA,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAyBvE"}

package/dist/sdd/cache/atomic.js

@@ -0,0 +1,35 @@
+import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, renameSync, writeFileSync } from "fs";
+import { dirname } from "path";
+/** Write a cache artifact so readers see either the old complete file or the new complete file. */
+export function atomicWriteFile(filePath, content) {
+    const directory = dirname(filePath);
+    if (!existsSync(directory))
+        mkdirSync(directory, { recursive: true });
+    const temporaryPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    let descriptor;
+    try {
+        descriptor = openSync(temporaryPath, "w", 0o600);
+        writeFileSync(descriptor, content, "utf-8");
+        fsyncSync(descriptor);
+        closeSync(descriptor);
+        descriptor = undefined;
+        renameSync(temporaryPath, filePath);
+    }
+    finally {
+        if (descriptor !== undefined) {
+            try {
+                closeSync(descriptor);
+            }
+            catch { }
+        }
+        try {
+            // A failed rename must not leave a misleading cache artifact behind.
+            if (existsSync(temporaryPath)) {
+                const { unlinkSync } = require("fs");
+                unlinkSync(temporaryPath);
+            }
+        }
+        catch { }
+    }
+}
+//# sourceMappingURL=atomic.js.map

package/dist/sdd/cache/atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.js","sourceRoot":"","sources":["../../../src/sdd/cache/atomic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AACrG,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE9B,mGAAmG;AACnG,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IACnC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAErE,MAAM,aAAa,GAAG,GAAG,QAAQ,QAAQ,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;IACpE,IAAI,UAA8B,CAAA;IAClC,IAAI,CAAC;QACH,UAAU,GAAG,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;QAChD,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QAC3C,SAAS,CAAC,UAAU,CAAC,CAAA;QACrB,SAAS,CAAC,UAAU,CAAC,CAAA;QACrB,UAAU,GAAG,SAAS,CAAA;QACtB,UAAU,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;IACrC,CAAC;YAAS,CAAC;QACT,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC;gBAAC,SAAS,CAAC,UAAU,CAAC,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACxC,CAAC;QACD,IAAI,CAAC;YACH,qEAAqE;YACrE,IAAI,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;gBAC9B,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;gBACpC,UAAU,CAAC,aAAa,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { KnowledgeGraph } from "../domain/types.js";
+export declare function stableSerialize(value: unknown): string;
+export declare function sha256(value: string | Uint8Array): string;
+/** Deterministic content fingerprint for the complete graph, independent of YAML/SQLite formatting. */
+export declare function graphFingerprint(graph: KnowledgeGraph): string;
+export declare function fileContentFingerprint(filePath: string): string;
+/** Fast identity for external-file detection; includes all files when several files are supplied. */
+export declare function fileSignature(filePaths: string[]): string;
+export declare function configFingerprint(projectDir: string): string;
+/** Content fingerprint for code-dependent analyses. The caller can cache this by fileSignature. */
+export declare function sourceFingerprint(projectDir: string, previous?: {
+    fingerprint: string;
+    signature: string;
+} | null): {
+    fingerprint: string;
+    signature: string;
+};
+//# sourceMappingURL=fingerprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../src/sdd/cache/fingerprint.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAaxD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAEzD;AAED,uGAAuG;AACvG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAQ9D;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAUzD;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG5D;AAsBD,mGAAmG;AACnG,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAC3D;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAM5C"}

package/dist/sdd/cache/fingerprint.js

@@ -0,0 +1,99 @@
+import { createHash } from "crypto";
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { join, relative } from "path";
+const SOURCE_EXTENSIONS = new Set([
+    ".c", ".cc", ".cpp", ".cs", ".go", ".h", ".hpp", ".java", ".js", ".jsx",
+    ".json", ".kt", ".mjs", ".mts", ".py", ".rb", ".rs", ".svelte", ".swift",
+    ".ts", ".tsx", ".vue", ".yaml", ".yml",
+]);
+const IGNORED_DIRECTORIES = new Set([
+    ".git", ".sdd", ".opencode", "node_modules", "dist", "build", "coverage",
+    ".cache", ".next", ".turbo", "target", "vendor",
+]);
+export function stableSerialize(value) {
+    if (value === null)
+        return "null";
+    if (value === undefined)
+        return "undefined";
+    if (typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableSerialize).join(",")}]`;
+    const record = value;
+    return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableSerialize(record[key])}`).join(",")}}`;
+}
+export function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+/** Deterministic content fingerprint for the complete graph, independent of YAML/SQLite formatting. */
+export function graphFingerprint(graph) {
+    return sha256(stableSerialize({
+        version: graph.version,
+        project_id: graph.project_id,
+        metadata: graph.metadata,
+        nodes: [...graph.nodes].sort((a, b) => a.id.localeCompare(b.id)),
+        relationships: [...graph.relationships].sort((a, b) => a.id.localeCompare(b.id)),
+    }));
+}
+export function fileContentFingerprint(filePath) {
+    try {
+        return sha256(readFileSync(filePath));
+    }
+    catch {
+        return sha256(`missing:${filePath}`);
+    }
+}
+/** Fast identity for external-file detection; includes all files when several files are supplied. */
+export function fileSignature(filePaths) {
+    const parts = filePaths.map((filePath) => {
+        try {
+            const stat = statSync(filePath);
+            return `${filePath}:${stat.dev}:${stat.ino}:${stat.size}:${stat.mtimeMs}:${stat.ctimeMs}`;
+        }
+        catch {
+            return `${filePath}:missing`;
+        }
+    });
+    return sha256(parts.sort().join("\n"));
+}
+export function configFingerprint(projectDir) {
+    const path = join(projectDir, ".sdd", "config.json");
+    return existsSync(path) ? fileContentFingerprint(path) : sha256("missing-config");
+}
+function sourceFiles(projectDir) {
+    const files = [];
+    const visit = (directory) => {
+        let entries;
+        try {
+            entries = readdirSync(directory, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.isSymbolicLink())
+                continue;
+            const path = join(directory, entry.name);
+            if (entry.isDirectory()) {
+                if (!IGNORED_DIRECTORIES.has(entry.name))
+                    visit(path);
+                continue;
+            }
+            const extension = entry.name.slice(entry.name.lastIndexOf(".")).toLowerCase();
+            if (SOURCE_EXTENSIONS.has(extension))
+                files.push(path);
+        }
+    };
+    visit(projectDir);
+    return files.sort();
+}
+/** Content fingerprint for code-dependent analyses. The caller can cache this by fileSignature. */
+export function sourceFingerprint(projectDir, previous) {
+    const files = sourceFiles(projectDir);
+    const signature = fileSignature(files);
+    if (previous?.signature === signature)
+        return previous;
+    const content = files.map((path) => `${relative(projectDir, path)}:${fileContentFingerprint(path)}`).join("\n");
+    return { fingerprint: sha256(content), signature };
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/sdd/cache/fingerprint.js.map

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

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

@@ -6,27 +6,31 @@ interface ToolCacheEntry {
     lastAccess: number;
     toolName: string;
     argsHash: string;
-    graphVersion: string;
+    graphFingerprint: string;
+    configFingerprint: string;
+    sourceFingerprint?: string;
 }
 interface AnalysisCacheEntry {
     result: unknown;
     timestamp: number;
     lastAccess: number;
-    graphVersion: number;
-    nodeCount: number;
+    graphFingerprint: string;
+    configFingerprint: string;
+    sourceFingerprint?: string;
     type: string;
 }
 interface PersistentCacheData {
     version: number;
     toolResponses: Record<string, ToolCacheEntry>;
     analysisResults: Record<string, AnalysisCacheEntry>;
-    graphSnapshot: {
+    graphSnapshot?: {
         nodeCount: number;
         relationshipCount: number;
         version: string;
         lastModified: number;
     } | null;
-    graphHash: string;
+    graphHash?: string;
+    configFingerprint?: string;
 }
 export declare class CacheManager {
     private projectDir;
@@ -36,6 +40,9 @@ export declare class CacheManager {
     private invalidationVersionOnWrite;
     private graphCache;
     private graphHash;
+    private sourceFingerprintCache;
+    private invalidationJournalOffset;
+    private invalidationEventCounter;
     private stats;
     constructor(projectDir: string);
     /**
@@ -43,21 +50,21 @@ export declare class CacheManager {
      * 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;
+    getToolResponse(toolName: string, args: Record<string, unknown>, currentGraphFingerprint: string): string | null;
     /**
      * Cache a tool response.
      */
-    setToolResponse(toolName: string, args: Record<string, unknown>, response: string, graphVersion: string): void;
+    setToolResponse(toolName: string, args: Record<string, unknown>, response: string, currentGraphFingerprint: 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;
+    getAnalysisResult(type: string, currentGraphFingerprint: string): unknown | null;
     /**
      * Cache an analysis result.
      */
-    setAnalysisResult(type: string, result: unknown, graphVersion: number, nodeCount: number): void;
+    setAnalysisResult(type: string, result: unknown, currentGraphFingerprint: string): void;
     /**
      * Mark specific node IDs as dirty.
      */
@@ -102,7 +109,7 @@ export declare class CacheManager {
      * Save graph snapshot to disk (G).
      * Called after graph mutations and on dispose.
      */
-    saveGraphSnapshot(graph: KnowledgeGraph): void;
+    saveGraphSnapshot(graph: KnowledgeGraph, sourceSignature?: string): void;
     /**
      * Load graph snapshot from disk (G).
      * Returns null if no valid snapshot exists.
@@ -110,6 +117,7 @@ export declare class CacheManager {
     loadGraphSnapshot(): {
         graph: KnowledgeGraph;
         graphHash: string;
+        sourceSignature: string;
     } | null;
     /**
      * Invalidate graph snapshot on disk.
@@ -148,6 +156,8 @@ export declare class CacheManager {
      * Sync invalidation version after external write.
      */
     syncInvalidationVersion(): void;
+    /** Refresh cache state from durable invalidation events written by another process. */
+    refreshExternalInvalidation(): boolean;
     /**
      * Get cached nodes for a specific type.
      * Only returns if the cache version matches.
@@ -231,6 +241,10 @@ export declare class CacheManager {
     private evictOldestToolEntries;
     private loadInvalidationTracker;
     private saveInvalidationTracker;
+    private appendInvalidationEvent;
+    private toolNeedsSource;
+    private analysisNeedsSource;
+    private getSourceFingerprint;
 }
 export declare function getCacheManager(projectDir: string): CacheManager;
 export {};

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

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