@git-stunts/git-warp 10.3.2 → 10.7.0

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
@@ -1389,6 +1413,22 @@ export interface ApplySyncResult {
   applied: number;
 }
 
+/**
+ * Server-side auth configuration for serve().
+ */
+export interface SyncAuthServerOptions {
+  keys: Record<string, string>;
+  mode?: 'enforce' | 'log-only';
+}
+
+/**
+ * Client-side auth credentials for syncWith().
+ */
+export interface SyncAuthClientOptions {
+  secret: string;
+  keyId?: string;
+}
+
 // ============================================================================
 // Status snapshot
 // ============================================================================
@@ -1450,6 +1490,7 @@ export default class WarpGraph {
     clock?: ClockPort;
     crypto?: CryptoPort;
     codec?: unknown;
+    seekCache?: SeekCachePort;
   }): Promise<WarpGraph>;
 
   /**
@@ -1462,6 +1503,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.
    */
@@ -1495,6 +1542,12 @@ export default class WarpGraph {
    */
   getPropertyCount(): Promise<number>;
 
+  /**
+   * Returns a defensive copy of the current materialized state,
+   * or null if no state has been materialized yet.
+   */
+  getStateSnapshot(): Promise<WarpStateV5 | null>;
+
   /**
    * Gets all properties for an edge from the materialized state.
    * Returns null if the edge does not exist or is tombstoned.
@@ -1584,6 +1637,7 @@ export default class WarpGraph {
     path?: string;
     maxRequestBytes?: number;
     httpPort: HttpServerPort;
+    auth?: SyncAuthServerOptions;
   }): Promise<{ close(): Promise<void>; url: string }>;
 
   /**
@@ -1603,6 +1657,7 @@ export default class WarpGraph {
       status?: number;
       error?: Error;
     }) => void;
+    auth?: SyncAuthClientOptions;
   }): Promise<{ applied: number; attempts: number }>;
 
   /**

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.3.2",
+  "version": "10.7.0",
   "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",
@@ -74,7 +74,6 @@
     "demo:bench-streaming": "cd examples && docker compose up -d && docker compose exec demo node /app/examples/streaming-benchmark.js",
     "demo:bench-traversal": "cd examples && docker compose up -d && docker compose exec demo node /app/examples/traversal-benchmark.js",
     "demo:down": "cd examples && docker compose down -v",
-    "roadmap": "node scripts/roadmap.js",
     "setup:hooks": "node scripts/setup-hooks.js",
     "prepare": "patch-package && node scripts/setup-hooks.js",
     "prepack": "npm run lint && npm run test:local",
@@ -84,10 +83,15 @@
     "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"
+    "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",