@git-stunts/git-warp 10.3.2 → 10.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/README.md +6 -3
  2. package/bin/warp-graph.js +371 -141
  3. package/index.d.ts +31 -0
  4. package/index.js +4 -0
  5. package/package.json +8 -3
  6. package/src/domain/WarpGraph.js +263 -147
  7. package/src/domain/crdt/LWW.js +1 -1
  8. package/src/domain/crdt/ORSet.js +10 -6
  9. package/src/domain/crdt/VersionVector.js +5 -1
  10. package/src/domain/errors/EmptyMessageError.js +2 -4
  11. package/src/domain/errors/ForkError.js +4 -0
  12. package/src/domain/errors/IndexError.js +4 -0
  13. package/src/domain/errors/OperationAbortedError.js +4 -0
  14. package/src/domain/errors/QueryError.js +4 -0
  15. package/src/domain/errors/SchemaUnsupportedError.js +4 -0
  16. package/src/domain/errors/ShardCorruptionError.js +2 -6
  17. package/src/domain/errors/ShardLoadError.js +2 -6
  18. package/src/domain/errors/ShardValidationError.js +2 -7
  19. package/src/domain/errors/StorageError.js +2 -6
  20. package/src/domain/errors/SyncError.js +4 -0
  21. package/src/domain/errors/TraversalError.js +4 -0
  22. package/src/domain/errors/WarpError.js +2 -4
  23. package/src/domain/errors/WormholeError.js +4 -0
  24. package/src/domain/services/AnchorMessageCodec.js +1 -4
  25. package/src/domain/services/BitmapIndexBuilder.js +10 -6
  26. package/src/domain/services/BitmapIndexReader.js +27 -21
  27. package/src/domain/services/BoundaryTransitionRecord.js +22 -15
  28. package/src/domain/services/CheckpointMessageCodec.js +1 -7
  29. package/src/domain/services/CheckpointSerializerV5.js +20 -19
  30. package/src/domain/services/CheckpointService.js +18 -18
  31. package/src/domain/services/CommitDagTraversalService.js +13 -1
  32. package/src/domain/services/DagPathFinding.js +40 -18
  33. package/src/domain/services/DagTopology.js +7 -6
  34. package/src/domain/services/DagTraversal.js +5 -3
  35. package/src/domain/services/Frontier.js +7 -6
  36. package/src/domain/services/HealthCheckService.js +15 -14
  37. package/src/domain/services/HookInstaller.js +64 -13
  38. package/src/domain/services/HttpSyncServer.js +15 -14
  39. package/src/domain/services/IndexRebuildService.js +12 -12
  40. package/src/domain/services/IndexStalenessChecker.js +13 -6
  41. package/src/domain/services/JoinReducer.js +28 -27
  42. package/src/domain/services/LogicalTraversal.js +7 -6
  43. package/src/domain/services/MessageCodecInternal.js +2 -0
  44. package/src/domain/services/ObserverView.js +6 -6
  45. package/src/domain/services/PatchBuilderV2.js +9 -9
  46. package/src/domain/services/PatchMessageCodec.js +1 -7
  47. package/src/domain/services/ProvenanceIndex.js +6 -8
  48. package/src/domain/services/ProvenancePayload.js +1 -2
  49. package/src/domain/services/QueryBuilder.js +29 -23
  50. package/src/domain/services/StateDiff.js +7 -7
  51. package/src/domain/services/StateSerializerV5.js +8 -6
  52. package/src/domain/services/StreamingBitmapIndexBuilder.js +29 -23
  53. package/src/domain/services/SyncProtocol.js +23 -26
  54. package/src/domain/services/TemporalQuery.js +4 -3
  55. package/src/domain/services/TranslationCost.js +4 -4
  56. package/src/domain/services/WormholeService.js +19 -15
  57. package/src/domain/types/TickReceipt.js +10 -6
  58. package/src/domain/types/WarpTypesV2.js +2 -3
  59. package/src/domain/utils/CachedValue.js +1 -1
  60. package/src/domain/utils/LRUCache.js +3 -3
  61. package/src/domain/utils/MinHeap.js +2 -2
  62. package/src/domain/utils/RefLayout.js +19 -0
  63. package/src/domain/utils/WriterId.js +2 -2
  64. package/src/domain/utils/defaultCodec.js +9 -2
  65. package/src/domain/utils/defaultCrypto.js +36 -0
  66. package/src/domain/utils/roaring.js +5 -5
  67. package/src/domain/utils/seekCacheKey.js +32 -0
  68. package/src/domain/warp/PatchSession.js +3 -3
  69. package/src/domain/warp/Writer.js +2 -2
  70. package/src/infrastructure/adapters/BunHttpAdapter.js +21 -8
  71. package/src/infrastructure/adapters/CasSeekCacheAdapter.js +311 -0
  72. package/src/infrastructure/adapters/ClockAdapter.js +2 -2
  73. package/src/infrastructure/adapters/DenoHttpAdapter.js +22 -9
  74. package/src/infrastructure/adapters/GitGraphAdapter.js +16 -27
  75. package/src/infrastructure/adapters/NodeCryptoAdapter.js +16 -3
  76. package/src/infrastructure/adapters/NodeHttpAdapter.js +33 -11
  77. package/src/infrastructure/adapters/WebCryptoAdapter.js +21 -11
  78. package/src/infrastructure/codecs/CborCodec.js +16 -8
  79. package/src/ports/BlobPort.js +2 -2
  80. package/src/ports/CodecPort.js +2 -2
  81. package/src/ports/CommitPort.js +8 -21
  82. package/src/ports/ConfigPort.js +3 -3
  83. package/src/ports/CryptoPort.js +7 -7
  84. package/src/ports/GraphPersistencePort.js +12 -14
  85. package/src/ports/HttpServerPort.js +1 -5
  86. package/src/ports/IndexStoragePort.js +1 -0
  87. package/src/ports/LoggerPort.js +9 -9
  88. package/src/ports/RefPort.js +5 -5
  89. package/src/ports/SeekCachePort.js +73 -0
  90. package/src/ports/TreePort.js +3 -3
  91. package/src/visualization/layouts/converters.js +14 -7
  92. package/src/visualization/layouts/elkAdapter.js +17 -4
  93. package/src/visualization/layouts/elkLayout.js +23 -7
  94. package/src/visualization/layouts/index.js +3 -3
  95. package/src/visualization/renderers/ascii/check.js +30 -17
  96. package/src/visualization/renderers/ascii/graph.js +92 -1
  97. package/src/visualization/renderers/ascii/history.js +28 -26
  98. package/src/visualization/renderers/ascii/info.js +9 -7
  99. package/src/visualization/renderers/ascii/materialize.js +20 -16
  100. package/src/visualization/renderers/ascii/opSummary.js +15 -7
  101. package/src/visualization/renderers/ascii/path.js +1 -1
  102. package/src/visualization/renderers/ascii/seek.js +19 -5
  103. package/src/visualization/renderers/ascii/table.js +1 -1
  104. package/src/visualization/renderers/svg/index.js +5 -1
package/README.md CHANGED
@@ -414,6 +414,8 @@ git warp seek --tick=-1 # step backward one tick
414
414
  git warp seek --save before-refactor # bookmark current position
415
415
  git warp seek --load before-refactor # restore bookmark
416
416
  git warp seek --latest # return to present
417
+ git warp seek --clear-cache # purge persistent seek cache
418
+ git warp seek --no-persistent-cache --tick 5 # skip cache for one invocation
417
419
 
418
420
  # Visualize query results (ascii output by default)
419
421
  git warp query --match 'user:*' --outgoing manages --view
@@ -439,15 +441,17 @@ The codebase follows hexagonal architecture with ports and adapters:
439
441
  - `CryptoPort` -- hash/HMAC operations
440
442
  - `LoggerPort` -- structured logging
441
443
  - `ClockPort` -- time measurement
444
+ - `SeekCachePort` -- persistent seek materialization cache
442
445
 
443
446
  **Adapters** implement the ports:
444
447
  - `GitGraphAdapter` -- wraps `@git-stunts/plumbing` for Git operations
445
448
  - `ClockAdapter` -- unified clock (factory: `ClockAdapter.node()`, `ClockAdapter.global()`)
446
449
  - `NodeCryptoAdapter` -- cryptographic operations via `node:crypto`
447
- - `WebCryptoAdapter` -- cryptographic operations via Web Crypto API (browsers, Deno, Bun, Node 20+)
450
+ - `WebCryptoAdapter` -- cryptographic operations via Web Crypto API (browsers, Deno, Bun, Node 22+)
448
451
  - `NodeHttpAdapter` / `BunHttpAdapter` / `DenoHttpAdapter` -- HTTP server per runtime
449
452
  - `ConsoleLogger` / `NoOpLogger` -- logging implementations
450
453
  - `CborCodec` -- CBOR serialization for patches
454
+ - `CasSeekCacheAdapter` -- persistent seek cache via `@git-stunts/git-cas`
451
455
 
452
456
  **Domain** contains the core logic:
453
457
  - `WarpGraph` -- public API facade
@@ -483,10 +487,9 @@ npm run lint # eslint
483
487
 
484
488
  # Multi-runtime test matrix (Docker)
485
489
  npm run test:node22 # Node 22: unit + integration + BATS CLI
486
- npm run test:node20 # Node 20: unit + integration + BATS CLI
487
490
  npm run test:bun # Bun: API integration tests
488
491
  npm run test:deno # Deno: API integration tests
489
- npm run test:matrix # All four runtimes in parallel
492
+ npm run test:matrix # All runtimes in parallel
490
493
  ```
491
494
 
492
495
  ## AIΩN Foundations Series