opencode-swarm 7.154.3 → 7.155.0

package/dist/cli/index.js

@@ -11,53 +11,53 @@ import {
   readCachePackageVersion,
   resolveCommand,
   safeRealpathSync
-} from "./index-m0fy8jra.js";
-import"./index-qdnmnq65.js";
-import"./index-qxj63890.js";
-import"./index-wkagbmpt.js";
-import"./index-7fyv62b2.js";
-import"./index-env8fk17.js";
+} from "./index-2gfe61qp.js";
+import"./index-kyc2c7hq.js";
+import"./index-c590qxts.js";
+import"./index-mm7ase9k.js";
+import"./index-wwv3cbv1.js";
+import"./index-c9nabqzd.js";
 import"./index-134d35c1.js";
 import"./index-nj6rmyeh.js";
 import"./index-y8552snf.js";
-import"./index-a6xjn2zt.js";
-import"./index-v6xkgxts.js";
+import"./index-kgdbtwfm.js";
+import"./index-rb4t72we.js";
 import"./index-70ha9e09.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
-import"./index-94e20w95.js";
+import"./index-fjcm6wwf.js";
 import"./index-zsrtt42s.js";
-import"./index-ymgsmjba.js";
-import"./index-vntggpez.js";
-import"./index-2rgm3hgq.js";
-import"./index-6vcrkz80.js";
-import"./index-zak50rve.js";
+import"./index-egnpzfe3.js";
+import"./index-0q8kywcf.js";
+import"./index-xn23xnnk.js";
+import"./index-e90g4dsw.js";
+import"./index-aqg7c1z9.js";
 import"./index-rtry5xyf.js";
-import"./index-g1bh7980.js";
-import"./index-7qky94rr.js";
-import"./index-kck2gtxk.js";
+import"./index-26cvxrym.js";
+import"./index-spbxf9vn.js";
+import"./index-caqe8x14.js";
 import"./index-ddszzne4.js";
 import"./index-vnn7qq8c.js";
-import"./index-4n557t8w.js";
-import"./index-s5p8ryar.js";
+import"./index-t3xqpece.js";
+import"./index-zvp68qx6.js";
 import"./index-xdy28ngt.js";
 import"./index-556ja8an.js";
 import"./index-4fwbbad3.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-n7nnz0jp.js";
-import"./index-s23q9v6t.js";
-import"./index-gbkdj7ay.js";
+import"./index-ctsct3hy.js";
+import"./index-qj9jrjvr.js";
+import"./index-dw2q720x.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
-import"./index-q0prhdds.js";
+import"./index-79qymsxf.js";
 import {
   init_package,
   package_default
-} from "./index-y3kw1zpm.js";
+} from "./index-34wn2ztk.js";
 import {
   DEFAULT_AGENT_CONFIGS,
   init_constants
@@ -66,10 +66,10 @@ import"./index-zjygnfay.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-ae75rja9.js";
-import"./index-ed13peqr.js";
-import"./index-bhjkxasn.js";
+import"./index-85p1850w.js";
+import"./index-ew6fykvv.js";
 import"./index-bk5tah7q.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{knowledge-escalator-yew2fbxb.js → knowledge-escalator-z09aqvfe.js}

@@ -9,26 +9,26 @@ import {
   maybeEscalateOnViolation,
   maybeQuarantineOnContradiction,
   readRecentEscalations
-} from "./index-a6xjn2zt.js";
-import"./index-n7nnz0jp.js";
-import"./index-s23q9v6t.js";
-import"./index-gbkdj7ay.js";
+} from "./index-kgdbtwfm.js";
+import"./index-ctsct3hy.js";
+import"./index-qj9jrjvr.js";
+import"./index-dw2q720x.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
-import"./index-q0prhdds.js";
-import"./index-y3kw1zpm.js";
+import"./index-79qymsxf.js";
+import"./index-34wn2ztk.js";
 import"./index-myt57pht.js";
 import"./index-zjygnfay.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-ae75rja9.js";
-import"./index-ed13peqr.js";
-import"./index-bhjkxasn.js";
+import"./index-85p1850w.js";
+import"./index-ew6fykvv.js";
 import"./index-bk5tah7q.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{knowledge-events-zfg423hp.js → knowledge-events-03f1rwm8.js}

@@ -29,24 +29,24 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-s23q9v6t.js";
-import"./index-gbkdj7ay.js";
+} from "./index-qj9jrjvr.js";
+import"./index-dw2q720x.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
-import"./index-q0prhdds.js";
-import"./index-y3kw1zpm.js";
+import"./index-79qymsxf.js";
+import"./index-34wn2ztk.js";
 import"./index-myt57pht.js";
 import"./index-zjygnfay.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-ae75rja9.js";
-import"./index-ed13peqr.js";
-import"./index-bhjkxasn.js";
+import"./index-85p1850w.js";
+import"./index-ew6fykvv.js";
 import"./index-bk5tah7q.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{knowledge-link-ydv6shg2.js → knowledge-link-4frk38w8.js}

@@ -12,9 +12,9 @@ import {
   resolveLinkDir,
   sanitizeLinkId,
   writeLinkPointer
-} from "./index-ed13peqr.js";
-import"./index-bhjkxasn.js";
-import"./index-0f4b9ywa.js";
+} from "./index-85p1850w.js";
+import"./index-ew6fykvv.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{knowledge-store-zcv9stzz.js → knowledge-store-sn28k13f.js}

@@ -42,14 +42,14 @@ import {
   transactKnowledge,
   transactKnowledgeWithCas,
   wordBigrams
-} from "./index-n7nnz0jp.js";
+} from "./index-ctsct3hy.js";
 import {
   resolveHiveDataDir
 } from "./index-ae75rja9.js";
-import"./index-ed13peqr.js";
-import"./index-bhjkxasn.js";
+import"./index-85p1850w.js";
+import"./index-ew6fykvv.js";
 import"./index-bk5tah7q.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{knowledge-validator-q68wx2bf.js → knowledge-validator-rwrt3yja.js}

@@ -23,15 +23,15 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-6vcrkz80.js";
-import"./index-zak50rve.js";
+} from "./index-e90g4dsw.js";
+import"./index-aqg7c1z9.js";
 import"./index-rtry5xyf.js";
-import"./index-n7nnz0jp.js";
+import"./index-ctsct3hy.js";
 import"./index-ae75rja9.js";
-import"./index-ed13peqr.js";
-import"./index-bhjkxasn.js";
+import"./index-85p1850w.js";
+import"./index-ew6fykvv.js";
 import"./index-bk5tah7q.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{pending-delegations-yet1rza6.js → pending-delegations-qe16vfrj.js}

@@ -64,7 +64,7 @@ import {
   sweepStaleDelegations,
   updateCoderSettlement,
   writeDelegationFallback
-} from "./index-kck2gtxk.js";
+} from "./index-caqe8x14.js";
 import"./index-ddszzne4.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";

package/dist/cli/{pr-subscriptions-mp7fyh1r.js → pr-subscriptions-00evnffe.js}

@@ -14,12 +14,12 @@ import {
   sweepStale,
   unsubscribe,
   updateSnapshot
-} from "./index-94e20w95.js";
+} from "./index-fjcm6wwf.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
 import"./index-zjygnfay.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{runner-s89ja08q.js → runner-k1rkbjm8.js}

@@ -3,12 +3,12 @@ import {
   _internals,
   createModelEvaluationExecutor,
   runEvaluation
-} from "./index-qdnmnq65.js";
-import"./index-env8fk17.js";
+} from "./index-kyc2c7hq.js";
+import"./index-c9nabqzd.js";
 import"./index-y8552snf.js";
 import"./index-r3mvsbtq.js";
-import"./index-bhjkxasn.js";
-import"./index-0f4b9ywa.js";
+import"./index-ew6fykvv.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{scan-cursor-38bzfhwf.js → scan-cursor-h3mfzjc9.js}

@@ -4,15 +4,15 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-v6xkgxts.js";
-import"./index-n7nnz0jp.js";
+} from "./index-rb4t72we.js";
+import"./index-ctsct3hy.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-ae75rja9.js";
-import"./index-ed13peqr.js";
-import"./index-bhjkxasn.js";
+import"./index-85p1850w.js";
+import"./index-ew6fykvv.js";
 import"./index-bk5tah7q.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{schema-9hqyt4t6.js → schema-c37h5xw4.js}

@@ -99,7 +99,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-y3kw1zpm.js";
+} from "./index-34wn2ztk.js";
 import"./index-myt57pht.js";
 import"./index-zjygnfay.js";
 import"./index-bk5tah7q.js";

package/dist/cli/{scope-persistence-dd9s9q2b.js → scope-persistence-35z42pj5.js}

@@ -23,18 +23,18 @@ import {
   tombstoneScopeBinding,
   writeScopeBindingToDisk,
   writeScopeToDisk
-} from "./index-4n557t8w.js";
-import"./index-s5p8ryar.js";
+} from "./index-t3xqpece.js";
+import"./index-zvp68qx6.js";
 import"./index-xdy28ngt.js";
 import"./index-556ja8an.js";
-import"./index-q0prhdds.js";
-import"./index-y3kw1zpm.js";
+import"./index-79qymsxf.js";
+import"./index-34wn2ztk.js";
 import"./index-myt57pht.js";
 import"./index-zjygnfay.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-bk5tah7q.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{skill-generator-b28ezazm.js → skill-generator-60px2mvb.js}

@@ -33,30 +33,30 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-2rgm3hgq.js";
-import"./index-6vcrkz80.js";
-import"./index-zak50rve.js";
+} from "./index-xn23xnnk.js";
+import"./index-e90g4dsw.js";
+import"./index-aqg7c1z9.js";
 import"./index-rtry5xyf.js";
 import"./index-q7sjgr1y.js";
-import"./index-n7nnz0jp.js";
-import"./index-s23q9v6t.js";
-import"./index-gbkdj7ay.js";
+import"./index-ctsct3hy.js";
+import"./index-qj9jrjvr.js";
+import"./index-dw2q720x.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
-import"./index-q0prhdds.js";
-import"./index-y3kw1zpm.js";
+import"./index-79qymsxf.js";
+import"./index-34wn2ztk.js";
 import"./index-myt57pht.js";
 import"./index-zjygnfay.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-ae75rja9.js";
-import"./index-ed13peqr.js";
-import"./index-bhjkxasn.js";
+import"./index-85p1850w.js";
+import"./index-ew6fykvv.js";
 import"./index-bk5tah7q.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{worktree-collision-ownership-zw65t2p9.js → worktree-collision-ownership-2pc20ypq.js}

@@ -6,11 +6,11 @@ import {
   WORKTREE_PROVISIONING_OWNER_LEASE_MS,
   removeWorktreeProvisioningOwner,
   scanWorktreeProvisioningOwnersForRecovery
-} from "./index-vntggpez.js";
+} from "./index-0q8kywcf.js";
 import {
   scanDelegationFallbacksForRecovery,
   scanDelegationsForRecovery
-} from "./index-kck2gtxk.js";
+} from "./index-caqe8x14.js";
 import"./index-ddszzne4.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";
@@ -23,7 +23,7 @@ import {
   resolveGitExecutable
 } from "./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/cli/{worktree-isolation-0ag393t0.js → worktree-isolation-w4yamc3b.js}

@@ -21,61 +21,61 @@ import {
   sanitizeWorktreeTaskId,
   standardWorktreeByCallID,
   standardWorktreeSerializationSessions
-} from "./index-m0fy8jra.js";
-import"./index-qdnmnq65.js";
-import"./index-qxj63890.js";
-import"./index-wkagbmpt.js";
-import"./index-7fyv62b2.js";
-import"./index-env8fk17.js";
+} from "./index-2gfe61qp.js";
+import"./index-kyc2c7hq.js";
+import"./index-c590qxts.js";
+import"./index-mm7ase9k.js";
+import"./index-wwv3cbv1.js";
+import"./index-c9nabqzd.js";
 import"./index-134d35c1.js";
 import"./index-nj6rmyeh.js";
 import"./index-y8552snf.js";
-import"./index-a6xjn2zt.js";
-import"./index-v6xkgxts.js";
+import"./index-kgdbtwfm.js";
+import"./index-rb4t72we.js";
 import"./index-70ha9e09.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
-import"./index-94e20w95.js";
+import"./index-fjcm6wwf.js";
 import"./index-zsrtt42s.js";
-import"./index-ymgsmjba.js";
-import"./index-vntggpez.js";
-import"./index-2rgm3hgq.js";
-import"./index-6vcrkz80.js";
-import"./index-zak50rve.js";
+import"./index-egnpzfe3.js";
+import"./index-0q8kywcf.js";
+import"./index-xn23xnnk.js";
+import"./index-e90g4dsw.js";
+import"./index-aqg7c1z9.js";
 import"./index-rtry5xyf.js";
-import"./index-g1bh7980.js";
-import"./index-7qky94rr.js";
-import"./index-kck2gtxk.js";
+import"./index-26cvxrym.js";
+import"./index-spbxf9vn.js";
+import"./index-caqe8x14.js";
 import"./index-ddszzne4.js";
 import"./index-vnn7qq8c.js";
-import"./index-4n557t8w.js";
-import"./index-s5p8ryar.js";
+import"./index-t3xqpece.js";
+import"./index-zvp68qx6.js";
 import"./index-xdy28ngt.js";
 import"./index-556ja8an.js";
 import"./index-4fwbbad3.js";
 import"./index-b43rt5ph.js";
 import"./index-q7sjgr1y.js";
-import"./index-n7nnz0jp.js";
-import"./index-s23q9v6t.js";
+import"./index-ctsct3hy.js";
+import"./index-qj9jrjvr.js";
 import {
   resolveWorktreeIsolationConfig
-} from "./index-gbkdj7ay.js";
+} from "./index-dw2q720x.js";
 import"./index-gprxjmm7.js";
 import"./index-n832052r.js";
 import"./index-dtn0pne5.js";
 import"./index-z6xqpmqg.js";
 import"./index-r3mvsbtq.js";
-import"./index-q0prhdds.js";
-import"./index-y3kw1zpm.js";
+import"./index-79qymsxf.js";
+import"./index-34wn2ztk.js";
 import"./index-myt57pht.js";
 import"./index-zjygnfay.js";
 import"./index-9e6fdz2h.js";
 import"./index-4rhhvd1a.js";
 import"./index-ae75rja9.js";
-import"./index-ed13peqr.js";
-import"./index-bhjkxasn.js";
+import"./index-85p1850w.js";
+import"./index-ew6fykvv.js";
 import"./index-bk5tah7q.js";
-import"./index-0f4b9ywa.js";
+import"./index-6bqqzfbe.js";
 import"./index-xagq35tf.js";
 import"./index-ed5ykebp.js";
 import"./index-h1g8w4v0.js";

package/dist/commands/close.d.ts

@@ -8,6 +8,7 @@ import { runCuratorPostMortem } from '../hooks/curator-postmortem';
 import { checkHivePromotions } from '../hooks/hive-promoter';
 import { curateAndStoreSwarm } from '../hooks/knowledge-curator';
 import { reconcilePhaseClose } from '../hooks/knowledge-receipt-ledger.js';
+import { closeRepoMemory } from '../tools/repo-graph/indexed-storage';
 /** Narrow seam for receipt/plan ordering tests. */
 export declare const closeReceiptLifecycleInternals: {
     recordPhaseCloseIntent: (directory: string, phase: string, sessionId?: string, taskId?: string) => Promise<import("../hooks/knowledge-receipt-ledger.js").ReceiptLedgerResult<{
@@ -274,6 +275,7 @@ declare function acquireFinalizeLock(directory: string): Promise<{
  */
 declare function detectFullAuto(directory: string, sessionID: string): boolean;
 export declare const _internals: {
+    closeRepoMemory: typeof closeRepoMemory;
     ACTIVE_STATE_DIRS_TO_CLEAN: string[];
     countSessionKnowledgeEntries: typeof countSessionKnowledgeEntries;
     CLOSE_SKILL_REVIEW_TIMEOUT_MS: number;

package/dist/config/schema.d.ts

@@ -630,6 +630,10 @@ export declare const RepoGraphConfigSchema: z.ZodObject<{
     walk_budget_ms: z.ZodDefault<z.ZodNumber>;
     max_files: z.ZodDefault<z.ZodNumber>;
     exclude_dirs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    storage: z.ZodDefault<z.ZodEnum<{
+        json: "json";
+        indexed: "indexed";
+    }>>;
 }, z.core.$strip>;
 export type RepoGraphConfig = z.infer<typeof RepoGraphConfigSchema>;
 export declare const CheckpointConfigSchema: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
@@ -2089,6 +2093,10 @@ export declare const PluginConfigSchema: z.ZodObject<{
         walk_budget_ms: z.ZodDefault<z.ZodNumber>;
         max_files: z.ZodDefault<z.ZodNumber>;
         exclude_dirs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        storage: z.ZodDefault<z.ZodEnum<{
+            json: "json";
+            indexed: "indexed";
+        }>>;
     }, z.core.$strip>>;
     evidence: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;

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

@@ -16,25 +16,65 @@
  * 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.
+ *
+ * Storage modes (issue #1534): when `options.storage === 'indexed'`, the two
+ * FILE-SCOPED block builders may, on a full-graph LRU miss, serve a bounded
+ * subgraph read from `.swarm/repo-memory.sqlite` instead of parsing the whole
+ * JSON document. The kill switch, the stat gate and the freshness probe all
+ * run first and are unchanged, and the LRU hit — the common case — never
+ * touches SQLite. Whole-graph consumers (`buildLaneOrientationBlock`,
+ * `semantic-diff-injection`) always get the full JSON graph.
  */
 import { loadPluginConfigWithMetaAsync } from '../config/loader';
 import { type FreshnessOptions, probeFreshness, type RepoGraph } from '../tools/repo-graph';
+import { loadSubgraphForFiles } from '../tools/repo-graph/indexed-storage';
 export interface RepoGraphInjectionOptions extends FreshnessOptions {
     enabled?: boolean;
     refreshCap?: number;
+    /**
+     * Resolved `repo_graph.storage` mode (issue #1534). Passed in by the caller
+     * — this module deliberately never reads config synchronously (see the
+     * `loadPluginConfigWithMetaAsync` note on `_internals`), so the mode rides
+     * in beside `enabled` / `refreshCap`. Anything other than `'indexed'`
+     * (including `undefined`) keeps every path on the JSON document.
+     */
+    storage?: 'json' | 'indexed';
 }
 export declare const _internals: {
     probeFreshness: typeof probeFreshness;
     cacheSize: () => number;
+    subgraphCacheSize: () => number;
     renderLaneOrientationBlock: typeof renderLaneOrientationBlock;
     orientationFreshnessLine: typeof orientationFreshnessLine;
     loadPluginConfigWithMetaAsync: typeof loadPluginConfigWithMetaAsync;
+    loadSubgraphForFiles: typeof loadSubgraphForFiles;
+    subgraphCacheKey: typeof subgraphCacheKey;
 };
+/**
+ * Cache key for a subgraph request. The graph artifact's `{mtimeMs, size, ino}`
+ * is part of the key, so a graph change invalidates every cached subgraph for
+ * that directory without an explicit sweep — the identical invalidation
+ * contract the full-graph LRU uses. Files are sorted because the closure is a
+ * set union and is order-independent; the caller's own array order (which does
+ * drive `BlastRadiusResult.target` and the rendered target list) is never read
+ * from this key. NUL is the separator because it is the one character that
+ * cannot appear in a path component, so no two distinct requests can collide
+ * by concatenation.
+ */
+declare function subgraphCacheKey(directoryKey: string, stat: {
+    mtimeMs: number;
+    size: number;
+    ino: number;
+}, files: readonly string[], depth: number): string;
 /**
  * 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.
  *
+ * Always returns the WHOLE graph — `semantic-diff-injection` and
+ * `buildLaneOrientationBlock` are whole-graph consumers and must never receive
+ * a bounded subgraph.
+ *
  * Exported only for tests; production callers use the buildXxxBlock helpers below.
  */
 export declare function getCachedGraph(directory: string, options?: RepoGraphInjectionOptions): Promise<RepoGraph | null>;