@git-stunts/git-warp 10.1.2 → 10.4.2

package/index.d.ts

@@ -475,6 +475,30 @@ export class GlobalClockAdapter extends ClockPort {
   timestamp(): string;
 }
 
+/**
+ * Port interface for seek materialization cache operations.
+ *
+ * Implementations store serialized WarpStateV5 snapshots keyed by
+ * (ceiling, frontier) tuples for near-instant restoration of
+ * previously-visited ticks during seek exploration.
+ *
+ * @abstract
+ */
+export abstract class SeekCachePort {
+  /** Retrieves a cached state buffer by key, or null on miss. */
+  abstract get(key: string): Promise<Buffer | null>;
+  /** Stores a state buffer under the given key. */
+  abstract set(key: string, buffer: Buffer): Promise<void>;
+  /** Checks whether a key exists in the cache index. */
+  abstract has(key: string): Promise<boolean>;
+  /** Lists all keys currently in the cache index. */
+  abstract keys(): Promise<string[]>;
+  /** Removes a single entry from the cache. */
+  abstract delete(key: string): Promise<boolean>;
+  /** Removes all entries from the cache. */
+  abstract clear(): Promise<void>;
+}
+
 /**
  * Port interface for structured logging operations.
  * @abstract
@@ -1450,6 +1474,7 @@ export default class WarpGraph {
     clock?: ClockPort;
     crypto?: CryptoPort;
     codec?: unknown;
+    seekCache?: SeekCachePort;
   }): Promise<WarpGraph>;
 
   /**
@@ -1462,6 +1487,12 @@ export default class WarpGraph {
    */
   readonly writerId: string;
 
+  /** Returns the attached seek cache, or null if none is set. */
+  readonly seekCache: SeekCachePort | null;
+
+  /** Attaches (or detaches, with null) a persistent seek cache. */
+  setSeekCache(cache: SeekCachePort | null): void;
+
   /**
    * Creates a new patch for adding operations.
    */

package/index.js

@@ -32,6 +32,7 @@ import GraphPersistencePort from './src/ports/GraphPersistencePort.js';
 import IndexStoragePort from './src/ports/IndexStoragePort.js';
 import LoggerPort from './src/ports/LoggerPort.js';
 import ClockPort from './src/ports/ClockPort.js';
+import SeekCachePort from './src/ports/SeekCachePort.js';
 import NoOpLogger from './src/infrastructure/adapters/NoOpLogger.js';
 import ConsoleLogger, { LogLevel } from './src/infrastructure/adapters/ConsoleLogger.js';
 import ClockAdapter from './src/infrastructure/adapters/ClockAdapter.js';
@@ -125,6 +126,9 @@ export {
 
   // Clock infrastructure
   ClockPort,
+
+  // Seek cache (RECALL)
+  SeekCachePort,
   ClockAdapter,
   PerformanceClockAdapter,
   GlobalClockAdapter,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/git-warp",
-  "version": "10.1.2",
+  "version": "10.4.2",
   "description": "Deterministic WARP graph over Git: graph-native storage, traversal, and tooling.",
   "type": "module",
   "license": "Apache-2.0",
@@ -14,7 +14,7 @@
     "url": "https://github.com/git-stunts/git-warp/issues"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "sideEffects": false,
   "main": "./index.js",
@@ -79,10 +79,20 @@
     "prepare": "patch-package && node scripts/setup-hooks.js",
     "prepack": "npm run lint && npm run test:local",
     "install:git-warp": "bash scripts/install-git-warp.sh",
-    "uninstall:git-warp": "bash scripts/uninstall-git-warp.sh"
+    "uninstall:git-warp": "bash scripts/uninstall-git-warp.sh",
+    "test:node20": "docker compose -f docker-compose.test.yml --profile node20 run --build --rm test-node20",
+    "test:node22": "docker compose -f docker-compose.test.yml --profile node22 run --build --rm test-node22",
+    "test:bun": "docker compose -f docker-compose.test.yml --profile bun run --build --rm test-bun",
+    "test:deno": "docker compose -f docker-compose.test.yml --profile deno run --build --rm test-deno",
+    "test:matrix": "docker compose -f docker-compose.test.yml --profile full up --build --abort-on-container-exit",
+    "typecheck": "tsc --noEmit",
+    "typecheck:src": "tsc --noEmit -p tsconfig.src.json",
+    "typecheck:test": "tsc --noEmit -p tsconfig.test.json",
+    "typecheck:policy": "node scripts/ts-policy-check.js"
   },
   "dependencies": {
     "@git-stunts/alfred": "^0.4.0",
+    "@git-stunts/git-cas": "^3.0.0",
     "@git-stunts/plumbing": "^2.8.0",
     "@git-stunts/trailer-codec": "^2.1.1",
     "boxen": "^7.1.1",