@git-stunts/git-warp 10.8.0 → 11.2.1

package/index.d.ts

@@ -558,6 +558,16 @@ export interface GitPlumbing {
   executeStream(options: { args: string[] }): Promise<AsyncIterable<Uint8Array> & { collect(opts?: { asString?: boolean }): Promise<Buffer | string> }>;
 }
 
+/**
+ * In-memory persistence adapter for fast unit/integration tests.
+ *
+ * Implements the same GraphPersistencePort contract as GitGraphAdapter
+ * but stores all data in Maps — no real Git I/O required.
+ */
+export class InMemoryGraphAdapter extends GraphPersistencePort {
+  constructor();
+}
+
 /**
  * Implementation of GraphPersistencePort and IndexStoragePort using GitPlumbing.
  */
@@ -1301,6 +1311,8 @@ export class PatchSession {
   removeEdge(from: string, to: string, label: string): this;
   /** Sets a property on a node. */
   setProperty(nodeId: string, key: string, value: unknown): this;
+  /** Sets a property on an edge. */
+  setEdgeProperty(from: string, to: string, label: string, key: string, value: unknown): this;
   /** Builds the patch object without committing. */
   build(): unknown;
   /** Commits the patch with CAS protection. */
@@ -1321,7 +1333,10 @@ export class Writer {
   head(): Promise<string | null>;
   /** Begins a new patch session. */
   beginPatch(): Promise<PatchSession>;
-  /** Builds and commits a patch in one call. */
+  /**
+   * Builds and commits a patch in one call.
+   * @throws {WriterError} COMMIT_IN_PROGRESS if called while another commitPatch() is in progress (not reentrant)
+   */
   commitPatch(build: (p: PatchSession) => void | Promise<void>): Promise<string>;
 }
 
@@ -1419,6 +1434,7 @@ export interface ApplySyncResult {
 export interface SyncAuthServerOptions {
   keys: Record<string, string>;
   mode?: 'enforce' | 'log-only';
+  allowedWriters?: string[];
 }
 
 /**
@@ -1485,6 +1501,7 @@ export default class WarpGraph {
       compactOnCheckpoint?: boolean;
     };
     checkpointPolicy?: { every: number };
+    /** If true (default), query methods auto-materialize when no cached state exists. */
     autoMaterialize?: boolean;
     onDeleteWithData?: 'reject' | 'cascade' | 'warn';
     clock?: ClockPort;
@@ -1512,7 +1529,19 @@ export default class WarpGraph {
   /**
    * Creates a new patch for adding operations.
    */
-  createPatch(): Promise<unknown>;
+  createPatch(): Promise<PatchSession>;
+
+  /**
+   * Convenience wrapper: creates a patch, runs the callback, and commits.
+   *
+   * The callback receives a patch builder and may be synchronous or
+   * asynchronous. The commit happens only after the callback resolves.
+   * If the callback throws or rejects, no commit is attempted.
+   *
+   * Not reentrant: calling `graph.patch()` inside a callback throws.
+   * Use `createPatch()` directly for nested or concurrent patches.
+   */
+  patch(build: (patch: PatchSession) => void | Promise<void>): Promise<string>;
 
   /**
    * Returns patches from a writer's ref chain.
@@ -1638,6 +1667,7 @@ export default class WarpGraph {
     maxRequestBytes?: number;
     httpPort: HttpServerPort;
     auth?: SyncAuthServerOptions;
+    allowedWriters?: string[];
   }): Promise<{ close(): Promise<void>; url: string }>;
 
   /**

package/index.js

@@ -33,6 +33,7 @@ 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 InMemoryGraphAdapter from './src/infrastructure/adapters/InMemoryGraphAdapter.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';
@@ -107,6 +108,7 @@ const TraversalService = CommitDagTraversalService;
 
 export {
   GitGraphAdapter,
+  InMemoryGraphAdapter,
   GraphNode,
   BitmapIndexBuilder,
   BitmapIndexReader,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/git-warp",
-  "version": "10.8.0",
+  "version": "11.2.1",
   "description": "Deterministic WARP graph over Git: graph-native storage, traversal, and tooling.",
   "type": "module",
   "license": "Apache-2.0",
@@ -43,6 +43,7 @@
   "files": [
     "bin/warp-graph.js",
     "bin/presenters",
+    "bin/cli",
     "bin/git-warp",
     "src",
     "index.js",
@@ -68,12 +69,12 @@
     "benchmark": "sh -c 'if [ \"$GIT_STUNTS_DOCKER\" = \"1\" ]; then vitest bench --run test/benchmark \"$@\"; else docker compose run --build --rm test npm run benchmark:local -- \"$@\"; fi' --",
     "benchmark:local": "vitest bench --run test/benchmark",
     "demo": "cd examples && docker compose up -d && docker compose exec demo bash",
-    "demo:setup": "cd examples && docker compose up -d && docker compose exec demo sh -c 'cd /app && npm install --silent && cd /demo && node /app/examples/setup.js'",
-    "demo:explore": "cd examples && docker compose exec demo node /app/examples/explore.js",
-    "demo:inspect": "cd examples && docker compose exec demo node /app/examples/inspect-index.js",
-    "demo:lagrangian": "cd examples && docker compose exec demo node /app/examples/lagrangian-path.js",
-    "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:setup": "cd examples && docker compose up -d && docker compose exec demo sh -c 'cd /app && npm install --silent && cd /demo && node /app/examples/scripts/setup.js'",
+    "demo:explore": "cd examples && docker compose exec demo node /app/examples/scripts/explore.js",
+    "demo:inspect": "cd examples && docker compose exec demo node /app/examples/scripts/inspect-index.js",
+    "demo:lagrangian": "cd examples && docker compose exec demo node /app/examples/scripts/lagrangian-path.js",
+    "demo:bench-streaming": "cd examples && docker compose up -d && docker compose exec demo node /app/examples/scripts/streaming-benchmark.js",
+    "demo:bench-traversal": "cd examples && docker compose up -d && docker compose exec demo node /app/examples/scripts/traversal-benchmark.js",
     "demo:down": "cd examples && docker compose down -v",
     "setup:hooks": "node scripts/setup-hooks.js",
     "prepare": "patch-package && node scripts/setup-hooks.js",