opencode-swarm 7.135.5 → 7.136.1

package/dist/hooks/repo-graph-builder.d.ts

@@ -15,7 +15,8 @@
  * exposes the init promise so `toolAfter` can serialize incremental
  * updates after the initial scan completes.
  */
-import { type RepoGraph } from '../tools/repo-graph';
+import { type BuildWorkspaceGraphOptions, type RepoGraph } from '../tools/repo-graph';
+import { type FreshnessOptions, type FreshnessProbe } from '../tools/repo-graph/freshness';
 import { safeRealpathSync } from '../tools/repo-graph/safe-realpath';
 export interface RepoGraphBuilderHook {
     init(): Promise<void>;
@@ -29,21 +30,28 @@ export interface RepoGraphBuilderHook {
     }): Promise<void>;
 }
 export interface RepoGraphDeps {
-    buildWorkspaceGraph: (workspace: string, options?: {
-        maxFileSizeBytes?: number;
-        maxFiles?: number;
-        walkBudgetMs?: number;
-        followSymlinks?: boolean;
-        excludeDirs?: readonly string[];
-    }) => Promise<RepoGraph>;
+    buildWorkspaceGraph: (workspace: string, options?: BuildWorkspaceGraphOptions) => Promise<RepoGraph>;
     saveGraph: (workspace: string, graph: RepoGraph, options?: {
         createAtomic?: boolean;
     }) => Promise<void>;
     updateGraphForFiles: (workspace: string, files: string[], options?: {
         forceRebuild?: boolean;
+        buildOptions?: BuildWorkspaceGraphOptions;
     }) => Promise<RepoGraph>;
+    loadGraph: (workspace: string) => Promise<RepoGraph | null>;
+    probeFreshness: (workspace: string, options?: FreshnessOptions) => Promise<FreshnessProbe>;
+    writeFingerprint: (workspace: string, graph: RepoGraph, options?: FreshnessOptions) => Promise<boolean>;
+    isGraphWideInputPath: (filePath: string) => boolean;
     safeRealpathSync?: typeof safeRealpathSync;
 }
+export interface RepoGraphBuilderOptions {
+    enabled?: boolean;
+    initRefresh?: boolean;
+    refreshCap?: number;
+    maxFiles?: number;
+    walkBudgetMs?: number;
+    excludeDirs?: readonly string[];
+}
 /**
  * Rebase a realpath'd file onto the lexical workspace root so the incremental
  * update keys the same node the walk produced (issue #1985, defect A5). Exported
@@ -62,6 +70,4 @@ export interface RepoGraphDeps {
  * the realpath is preserved.
  */
 export declare function rebaseOntoWorkspace(realFilePath: string, realWorkspace: string, workspaceRoot: string): string;
-export declare function createRepoGraphBuilderHook(workspaceRoot: string, deps?: Partial<RepoGraphDeps>, options?: {
-    excludeDirs?: readonly string[];
-}): RepoGraphBuilderHook;
+export declare function createRepoGraphBuilderHook(workspaceRoot: string, deps?: Partial<RepoGraphDeps>, options?: RepoGraphBuilderOptions): RepoGraphBuilderHook;

package/dist/hooks/repo-graph-injection.d.ts

@@ -11,18 +11,29 @@
  * the agent simply doesn't get the extra context. The graph is built
  * on-demand by the agent calling `repo_map` with action="build".
  *
- * Caching: the loaded graph is cached per-directory in module scope to
- * avoid re-reading the JSON on every system prompt construction. The
- * cache is bypassed if the file's mtime advances.
+ * Caching: the loaded graph is cached in a bounded per-directory LRU and
+ * invalidated when the graph artifact changes. Before returning it, the shared
+ * bounded workspace probe gates use of the graph. Uncertified graphs and
+ * complete drift above the configured refresh cap are suppressed;
+ * inconclusive probes remain usable as freshness-unknown, without mutation.
  */
-import { type RepoGraph } from '../tools/repo-graph';
+import { type FreshnessOptions, probeFreshness, type RepoGraph } from '../tools/repo-graph';
+export interface RepoGraphInjectionOptions extends FreshnessOptions {
+    enabled?: boolean;
+    refreshCap?: number;
+}
+export declare const _internals: {
+    probeFreshness: typeof probeFreshness;
+    cacheSize: () => number;
+};
 /**
- * Load the repo graph for `directory`, using a per-directory cache that
- * invalidates on file mtime change. Returns null if no graph exists.
+ * Load the repo graph for `directory`, using a bounded per-directory cache that
+ * invalidates on file mtime/size change and a shared content-freshness gate.
+ * Returns null if no graph exists or its workspace alignment is unsafe.
  *
  * Exported only for tests; production callers use the buildXxxBlock helpers below.
  */
-export declare function getCachedGraph(directory: string): RepoGraph | null;
+export declare function getCachedGraph(directory: string, options?: RepoGraphInjectionOptions): Promise<RepoGraph | null>;
 /** Test-only: clear the per-directory cache. */
 export declare function resetGraphInjectionCache(): void;
 /**
@@ -33,7 +44,7 @@ export declare function resetGraphInjectionCache(): void;
  *   - No graph exists.
  *   - The target isn't tracked in the graph (file too new, language unsupported).
  */
-export declare function buildCoderLocalizationBlock(directory: string, targetFile: string): string | null;
+export declare function buildCoderLocalizationBlock(directory: string, targetFile: string, options?: RepoGraphInjectionOptions): Promise<string | null>;
 /**
  * Build a blast-radius block for a list of changed files. Used by the
  * reviewer agent to spot-check whether unseen consumers might break.
@@ -42,4 +53,4 @@ export declare function buildCoderLocalizationBlock(directory: string, targetFil
  * graph. The result is bounded to the top 8 dependents to stay within
  * the per-block context budget.
  */
-export declare function buildReviewerBlastRadiusBlock(directory: string, changedFiles: string[]): string | null;
+export declare function buildReviewerBlastRadiusBlock(directory: string, changedFiles: string[], options?: RepoGraphInjectionOptions): Promise<string | null>;

package/dist/hooks/semantic-diff-injection.d.ts

@@ -13,7 +13,7 @@ import { computeASTDiff } from '../diff/ast-diff.js';
 import { classifyChanges } from '../diff/semantic-classifier.js';
 import { generateSummary, generateSummaryMarkdown } from '../diff/summary-generator.js';
 import { getImporters, normalizeGraphPath } from '../tools/repo-graph.js';
-import { getCachedGraph } from './repo-graph-injection.js';
+import { getCachedGraph, type RepoGraphInjectionOptions } from './repo-graph-injection.js';
 export declare const _internals: {
     execFile: typeof child_process.execFile;
     realpathSync: typeof fs.realpathSync;
@@ -40,4 +40,4 @@ export declare const _internals: {
  *
  * Returns null if no changes are detected or on failure.
  */
-export declare function buildSemanticDiffBlock(directory: string, changedFiles: string[], maxFiles?: number): Promise<string | null>;
+export declare function buildSemanticDiffBlock(directory: string, changedFiles: string[], maxFiles?: number, repoGraphOptions?: RepoGraphInjectionOptions): Promise<string | null>;