@git-stunts/git-warp 11.2.1 → 11.5.0

package/index.d.ts

@@ -566,6 +566,15 @@ export interface GitPlumbing {
  */
 export class InMemoryGraphAdapter extends GraphPersistencePort {
   constructor();
+
+  get emptyTree(): string;
+  commitNode(options: CreateNodeOptions): Promise<string>;
+  showNode(sha: string): Promise<string>;
+  getNodeInfo(sha: string): Promise<NodeInfo>;
+  logNodesStream(options: ListNodesOptions & { format: string }): Promise<AsyncIterable<Uint8Array | string>>;
+  logNodes(options: ListNodesOptions & { format: string }): Promise<string>;
+  ping(): Promise<PingResult>;
+  countNodes(ref: string): Promise<number>;
 }
 
 /**
@@ -1032,7 +1041,7 @@ export class SyncError extends Error {
  * Base error class for bitmap index operations.
  */
 export class IndexError extends Error {
-  readonly name: 'IndexError';
+  readonly name: string;
   readonly code: string;
   readonly context: Record<string, unknown>;
 
@@ -1138,6 +1147,12 @@ export function decodeEdgePropKey(encoded: string): { from: string; to: string;
  */
 export function isEdgePropKey(key: string): boolean;
 
+/**
+ * Well-known property key for content attachment.
+ * Stores a content-addressed blob OID as the property value.
+ */
+export const CONTENT_PROPERTY_KEY: '_content';
+
 /**
  * Configuration for an observer view.
  */
@@ -1293,12 +1308,69 @@ export interface TemporalQuery {
   ): Promise<boolean>;
 }
 
+// ============================================================================
+// PatchV2 & PatchBuilderV2
+// ============================================================================
+
+/**
+ * WARP V5 patch object (schema 2 or 3).
+ */
+export interface PatchV2 {
+  /** Schema version (2 for node/edge ops, 3 if edge properties present) */
+  schema: 2 | 3;
+  /** Writer ID */
+  writer: string;
+  /** Lamport timestamp for ordering */
+  lamport: number;
+  /** Writer's observed frontier (version vector) */
+  context: Record<string, number>;
+  /** Ordered array of operations */
+  ops: unknown[];
+  /** Node/edge IDs read by this patch (provenance tracking) */
+  reads?: string[];
+  /** Node/edge IDs written by this patch (provenance tracking) */
+  writes?: string[];
+}
+
+/**
+ * Fluent builder for creating WARP v5 patches with OR-Set semantics.
+ *
+ * Returned by WarpGraph.createPatch(). Chain mutation methods then call
+ * commit() to persist the patch atomically.
+ */
+export class PatchBuilderV2 {
+  /** Adds a node to the graph. */
+  addNode(nodeId: string): PatchBuilderV2;
+  /** Removes a node from the graph. */
+  removeNode(nodeId: string): PatchBuilderV2;
+  /** Adds an edge between two nodes. */
+  addEdge(from: string, to: string, label: string): PatchBuilderV2;
+  /** Removes an edge between two nodes. */
+  removeEdge(from: string, to: string, label: string): PatchBuilderV2;
+  /** Sets a property on a node. */
+  setProperty(nodeId: string, key: string, value: unknown): PatchBuilderV2;
+  /** Sets a property on an edge. */
+  setEdgeProperty(from: string, to: string, label: string, key: string, value: unknown): PatchBuilderV2;
+  /** Attaches content to a node (writes blob + sets _content property). */
+  attachContent(nodeId: string, content: Buffer | string): Promise<PatchBuilderV2>;
+  /** Attaches content to an edge (writes blob + sets _content edge property). */
+  attachEdgeContent(from: string, to: string, label: string, content: Buffer | string): Promise<PatchBuilderV2>;
+  /** Builds the PatchV2 object without committing. */
+  build(): PatchV2;
+  /** Commits the patch to the graph and returns the commit SHA. */
+  commit(): Promise<string>;
+  /** Number of operations in this patch. */
+  readonly opCount: number;
+}
+
 // ============================================================================
 // Writer & PatchSession
 // ============================================================================
 
 /**
  * Fluent patch session for building and committing graph mutations.
+ *
+ * Created by Writer.beginPatch(). Wraps a PatchBuilderV2 with CAS protection.
  */
 export class PatchSession {
   /** Adds a node to the graph. */
@@ -1313,8 +1385,12 @@ export class PatchSession {
   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;
+  /** Attaches content to a node (writes blob + sets _content property). */
+  attachContent(nodeId: string, content: Buffer | string): Promise<this>;
+  /** Attaches content to an edge (writes blob + sets _content edge property). */
+  attachEdgeContent(from: string, to: string, label: string, content: Buffer | string): Promise<this>;
+  /** Builds the PatchV2 object without committing. */
+  build(): PatchV2;
   /** Commits the patch with CAS protection. */
   commit(): Promise<string>;
   /** Number of operations in this patch. */
@@ -1527,21 +1603,21 @@ export default class WarpGraph {
   setSeekCache(cache: SeekCachePort | null): void;
 
   /**
-   * Creates a new patch for adding operations.
+   * Creates a new PatchBuilderV2 for adding operations.
    */
-  createPatch(): Promise<PatchSession>;
+  createPatch(): Promise<PatchBuilderV2>;
 
   /**
    * Convenience wrapper: creates a patch, runs the callback, and commits.
    *
-   * The callback receives a patch builder and may be synchronous or
+   * The callback receives a PatchBuilderV2 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>;
+  patch(build: (patch: PatchBuilderV2) => void | Promise<void>): Promise<string>;
 
   /**
    * Returns patches from a writer's ref chain.
@@ -1549,7 +1625,7 @@ export default class WarpGraph {
   getWriterPatches(
     writerId: string,
     stopAtSha?: string | null
-  ): Promise<Array<{ patch: unknown; sha: string }>>;
+  ): Promise<Array<{ patch: PatchV2; sha: string }>>;
 
   /**
    * Gets all visible nodes in the materialized state.
@@ -1583,6 +1659,28 @@ export default class WarpGraph {
    */
   getEdgeProps(from: string, to: string, label: string): Promise<Record<string, unknown> | null>;
 
+  /**
+   * Gets the content blob OID for a node, or null if none is attached.
+   */
+  getContentOid(nodeId: string): Promise<string | null>;
+
+  /**
+   * Gets the content blob for a node, or null if none is attached.
+   * Returns raw Buffer; call `.toString('utf8')` for text.
+   */
+  getContent(nodeId: string): Promise<Buffer | null>;
+
+  /**
+   * Gets the content blob OID for an edge, or null if none is attached.
+   */
+  getEdgeContentOid(from: string, to: string, label: string): Promise<string | null>;
+
+  /**
+   * Gets the content blob for an edge, or null if none is attached.
+   * Returns raw Buffer; call `.toString('utf8')` for text.
+   */
+  getEdgeContent(from: string, to: string, label: string): Promise<Buffer | null>;
+
   /**
    * Checks if a node exists in the materialized state.
    */
@@ -1621,7 +1719,7 @@ export default class WarpGraph {
   /**
    * Materializes graph state from a checkpoint, applying incremental patches.
    */
-  materializeAt(checkpointSha: string): Promise<unknown>;
+  materializeAt(checkpointSha: string): Promise<WarpStateV5>;
 
   /**
    * Logical graph traversal helpers.
@@ -1654,8 +1752,12 @@ export default class WarpGraph {
 
   /**
    * Materializes the current graph state from all patches.
+   *
+   * When `options.receipts` is true, returns `{ state, receipts }`.
+   * Otherwise returns the WarpStateV5 directly.
    */
-  materialize(): Promise<unknown>;
+  materialize(options: { receipts: true; ceiling?: number | null }): Promise<{ state: WarpStateV5; receipts: TickReceipt[] }>;
+  materialize(options?: { receipts?: false; ceiling?: number | null }): Promise<WarpStateV5>;
 
   /**
    * Starts a built-in sync server for this graph.
@@ -1672,6 +1774,8 @@ export default class WarpGraph {
 
   /**
    * Syncs with a remote peer (HTTP URL or another WarpGraph instance).
+   *
+   * When `options.materialize` is true, the returned object also contains a `state` property.
    */
   syncWith(remote: string | WarpGraph, options?: {
     path?: string;
@@ -1688,7 +1792,9 @@ export default class WarpGraph {
       error?: Error;
     }) => void;
     auth?: SyncAuthClientOptions;
-  }): Promise<{ applied: number; attempts: number }>;
+    /** Auto-materialize after sync; when true, result includes `state` */
+    materialize?: boolean;
+  }): Promise<{ applied: number; attempts: number; state?: WarpStateV5 }>;
 
   /**
    * Creates a fork of this graph at a specific point in a writer's history.
@@ -2113,17 +2219,7 @@ export function migrateV4toV5(v4State: {
  */
 export interface PatchEntry {
   /** The decoded patch object */
-  patch: {
-    schema: 2 | 3;
-    writer: string;
-    lamport: number;
-    context: Record<string, number> | Map<string, number>;
-    ops: unknown[];
-    /** Node/edge IDs read by this patch (V2 provenance) */
-    reads?: string[];
-    /** Node/edge IDs written by this patch (V2 provenance) */
-    writes?: string[];
-  };
+  patch: PatchV2;
   /** The Git SHA of the patch commit */
   sha: string;
 }

package/index.js

@@ -75,6 +75,7 @@ import {
   encodeEdgePropKey,
   decodeEdgePropKey,
   isEdgePropKey,
+  CONTENT_PROPERTY_KEY,
 } from './src/domain/services/KeyCodec.js';
 import {
   createTickReceipt,
@@ -173,6 +174,7 @@ export {
   encodeEdgePropKey,
   decodeEdgePropKey,
   isEdgePropKey,
+  CONTENT_PROPERTY_KEY,
 
   // WARP migration
   migrateV4toV5,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@git-stunts/git-warp",
-  "version": "11.2.1",
+  "version": "11.5.0",
   "description": "Deterministic WARP graph over Git: graph-native storage, traversal, and tooling.",
   "type": "module",
   "license": "Apache-2.0",
@@ -78,7 +78,7 @@
     "demo:down": "cd examples && docker compose down -v",
     "setup:hooks": "node scripts/setup-hooks.js",
     "prepare": "patch-package && node scripts/setup-hooks.js",
-    "prepack": "npm run lint && npm run test:local",
+    "prepack": "npm run lint && npm run test:local && npm run typecheck:consumer",
     "install:git-warp": "bash scripts/install-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",
@@ -89,7 +89,9 @@
     "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"
+    "typecheck:consumer": "tsc --noEmit -p test/type-check/tsconfig.json",
+    "typecheck:policy": "node scripts/ts-policy-check.js",
+    "typecheck:surface": "node scripts/check-dts-surface.js"
   },
   "dependencies": {
     "@git-stunts/alfred": "^0.4.0",

package/src/domain/WarpGraph.js

@@ -95,6 +95,9 @@ export default class WarpGraph {
     /** @type {number} */
     this._patchesSinceCheckpoint = 0;
 
+    /** @type {number} */
+    this._maxObservedLamport = 0;
+
     /** @type {{every: number}|null} */
     this._checkpointPolicy = checkpointPolicy || null;
 
@@ -285,7 +288,7 @@ export default class WarpGraph {
     // Initialize audit service if enabled
     if (graph._audit) {
       graph._auditService = new AuditReceiptService({
-        persistence: /** @type {any} */ (persistence), // TODO(ts-cleanup): persistence implements full port union
+        persistence: /** @type {import('./types/WarpPersistence.js').CorePersistence} */ (persistence),
         graphName,
         writerId,
         codec: graph._codec,

package/src/domain/crdt/ORSet.js

@@ -91,7 +91,7 @@ import { vvContains } from './VersionVector.js';
  * An element is present if it has at least one non-tombstoned dot.
  *
  * @typedef {Object} ORSet
- * @property {Map<*, Set<string>>} entries - element -> dots that added it
+ * @property {Map<string, Set<string>>} entries - element -> dots that added it
  * @property {Set<string>} tombstones - global tombstones
  */
 
@@ -112,7 +112,7 @@ export function createORSet() {
  * Mutates the set.
  *
  * @param {ORSet} set - The ORSet to mutate
- * @param {*} element - The element to add
+ * @param {string} element - The element to add
  * @param {import('./Dot.js').Dot} dot - The dot representing this add operation
  */
 export function orsetAdd(set, element, dot) {
@@ -145,7 +145,7 @@ export function orsetRemove(set, observedDots) {
  * An element is present if it has at least one non-tombstoned dot.
  *
  * @param {ORSet} set - The ORSet to check
- * @param {*} element - The element to check
+ * @param {string} element - The element to check
  * @returns {boolean}
  */
 export function orsetContains(set, element) {
@@ -168,7 +168,7 @@ export function orsetContains(set, element) {
  * Only returns elements that have at least one non-tombstoned dot.
  *
  * @param {ORSet} set - The ORSet
- * @returns {Array<*>} Array of present elements
+ * @returns {string[]} Array of present elements
  */
 export function orsetElements(set) {
   const result = [];
@@ -186,7 +186,7 @@ export function orsetElements(set) {
  * Returns the non-tombstoned dots for an element.
  *
  * @param {ORSet} set - The ORSet
- * @param {*} element - The element
+ * @param {string} element - The element
  * @returns {Set<string>} Set of encoded dots that are not tombstoned
  */
 export function orsetGetDots(set, element) {
@@ -311,11 +311,11 @@ export function orsetCompact(set, includedVV) {
  * Tombstones are sorted.
  *
  * @param {ORSet} set
- * @returns {{entries: Array<[*, string[]]>, tombstones: string[]}}
+ * @returns {{entries: Array<[string, string[]]>, tombstones: string[]}}
  */
 export function orsetSerialize(set) {
   // Serialize entries: convert Map to array of [element, sortedDots]
-  /** @type {Array<[any, string[]]>} */
+  /** @type {Array<[string, string[]]>} */
   const entriesArray = [];
   for (const [element, dots] of set.entries) {
     const sortedDots = [...dots].sort((a, b) => {
@@ -349,7 +349,7 @@ export function orsetSerialize(set) {
 /**
  * Deserializes a plain object back to an ORSet.
  *
- * @param {{entries?: Array<[*, string[]]>, tombstones?: string[]}} obj
+ * @param {{entries?: Array<[string, string[]]>, tombstones?: string[]}} obj
  * @returns {ORSet}
  */
 export function orsetDeserialize(obj) {

package/src/domain/errors/EmptyMessageError.js

@@ -12,7 +12,7 @@ import IndexError from './IndexError.js';
  * @property {string} name - The error name ('EmptyMessageError')
  * @property {string} code - Error code ('EMPTY_MESSAGE')
  * @property {string} operation - The operation that failed due to empty message
- * @property {Record<string, *>} context - Serializable context object for debugging
+ * @property {Record<string, unknown>} context - Serializable context object for debugging
  *
  * @example
  * if (!message || message.trim() === '') {
@@ -27,7 +27,7 @@ export default class EmptyMessageError extends IndexError {
    * Creates a new EmptyMessageError.
    *
    * @param {string} message - Human-readable error message
-   * @param {{ operation?: string, context?: Record<string, *> }} [options={}] - Error options
+   * @param {{ operation?: string, context?: Record<string, unknown> }} [options={}] - Error options
    */
   constructor(message, options = {}) {
     const context = {

package/src/domain/errors/ForkError.js

@@ -26,7 +26,7 @@ import WarpError from './WarpError.js';
 export default class ForkError extends WarpError {
   /**
    * @param {string} message
-   * @param {{ code?: string, context?: Object }} [options={}]
+   * @param {{ code?: string, context?: Record<string, unknown> }} [options={}]
    */
   constructor(message, options = {}) {
     super(message, 'FORK_ERROR', options);

package/src/domain/errors/IndexError.js

@@ -19,7 +19,7 @@ import WarpError from './WarpError.js';
 export default class IndexError extends WarpError {
   /**
    * @param {string} message
-   * @param {{ code?: string, context?: Object }} [options={}]
+   * @param {{ code?: string, context?: Record<string, unknown> }} [options={}]
    */
   constructor(message, options = {}) {
     super(message, 'INDEX_ERROR', options);

package/src/domain/errors/OperationAbortedError.js

@@ -15,7 +15,7 @@ import WarpError from './WarpError.js';
 export default class OperationAbortedError extends WarpError {
   /**
    * @param {string} operation
-   * @param {{ code?: string, context?: Object, reason?: string }} [options={}]
+   * @param {{ code?: string, context?: Record<string, unknown>, reason?: string }} [options={}]
    */
   constructor(operation, options = {}) {
     const reason = options.reason || 'Operation was aborted';

package/src/domain/errors/QueryError.js

@@ -35,7 +35,7 @@ import WarpError from './WarpError.js';
 export default class QueryError extends WarpError {
   /**
    * @param {string} message
-   * @param {{ code?: string, context?: Object }} [options={}]
+   * @param {{ code?: string, context?: Record<string, unknown> }} [options={}]
    */
   constructor(message, options = {}) {
     super(message, 'QUERY_ERROR', options);

package/src/domain/errors/SchemaUnsupportedError.js

@@ -13,7 +13,7 @@ import WarpError from './WarpError.js';
 export default class SchemaUnsupportedError extends WarpError {
   /**
    * @param {string} message
-   * @param {{ code?: string, context?: Object }} [options={}]
+   * @param {{ code?: string, context?: Record<string, unknown> }} [options={}]
    */
   constructor(message, options = {}) {
     super(message, 'E_SCHEMA_UNSUPPORTED', options);

package/src/domain/errors/ShardCorruptionError.js

@@ -14,7 +14,7 @@ import IndexError from './IndexError.js';
  * @property {string} shardPath - Path to the corrupted shard file
  * @property {string} oid - Object ID associated with the shard
  * @property {string} reason - Reason for corruption (e.g., 'invalid_checksum', 'invalid_version', 'parse_error')
- * @property {Record<string, *>} context - Serializable context object for debugging
+ * @property {Record<string, unknown>} context - Serializable context object for debugging
  *
  * @example
  * if (!validateChecksum(data)) {
@@ -30,7 +30,7 @@ export default class ShardCorruptionError extends IndexError {
    * Creates a new ShardCorruptionError.
    *
    * @param {string} message - Human-readable error message
-   * @param {{ shardPath?: string, oid?: string, reason?: string, context?: Record<string, *> }} [options={}] - Error options
+   * @param {{ shardPath?: string, oid?: string, reason?: string, context?: Record<string, unknown> }} [options={}] - Error options
    */
   constructor(message, options = {}) {
     const context = {

package/src/domain/errors/ShardLoadError.js

@@ -14,7 +14,7 @@ import IndexError from './IndexError.js';
  * @property {string} shardPath - Path to the shard file that failed to load
  * @property {string} oid - Object ID associated with the shard
  * @property {Error} cause - The original error that caused the load failure
- * @property {Record<string, *>} context - Serializable context object for debugging
+ * @property {Record<string, unknown>} context - Serializable context object for debugging
  *
  * @example
  * try {
@@ -32,7 +32,7 @@ export default class ShardLoadError extends IndexError {
    * Creates a new ShardLoadError.
    *
    * @param {string} message - Human-readable error message
-   * @param {{ shardPath?: string, oid?: string, cause?: Error, context?: Record<string, *> }} [options={}] - Error options
+   * @param {{ shardPath?: string, oid?: string, cause?: Error, context?: Record<string, unknown> }} [options={}] - Error options
    */
   constructor(message, options = {}) {
     const context = {

package/src/domain/errors/ShardValidationError.js

@@ -12,10 +12,10 @@ import IndexError from './IndexError.js';
  * @property {string} name - The error name ('ShardValidationError')
  * @property {string} code - Error code ('SHARD_VALIDATION_ERROR')
  * @property {string} shardPath - Path to the shard file that failed validation
- * @property {*} expected - The expected value for the field
- * @property {*} actual - The actual value found in the shard
+ * @property {unknown} expected - The expected value for the field
+ * @property {unknown} actual - The actual value found in the shard
  * @property {string} field - The field that failed validation (e.g., 'checksum', 'version')
- * @property {Record<string, *>} context - Serializable context object for debugging
+ * @property {Record<string, unknown>} context - Serializable context object for debugging
  *
  * @example
  * if (shard.version !== EXPECTED_VERSION) {
@@ -32,7 +32,7 @@ export default class ShardValidationError extends IndexError {
    * Creates a new ShardValidationError.
    *
    * @param {string} message - Human-readable error message
-   * @param {{ shardPath?: string, expected?: *, actual?: *, field?: string, context?: Record<string, *> }} [options={}] - Error options
+   * @param {{ shardPath?: string, expected?: unknown, actual?: unknown, field?: string, context?: Record<string, unknown> }} [options={}] - Error options
    */
   constructor(message, options = {}) {
     const context = {

package/src/domain/errors/StorageError.js

@@ -14,7 +14,7 @@ import IndexError from './IndexError.js';
  * @property {string} operation - The operation that failed ('read' or 'write')
  * @property {string} oid - Object ID associated with the operation
  * @property {Error} cause - The original error that caused the failure
- * @property {Record<string, *>} context - Serializable context object for debugging
+ * @property {Record<string, unknown>} context - Serializable context object for debugging
  *
  * @example
  * try {
@@ -32,7 +32,7 @@ export default class StorageError extends IndexError {
    * Creates a new StorageError.
    *
    * @param {string} message - Human-readable error message
-   * @param {{ operation?: string, oid?: string, cause?: Error, context?: Record<string, *> }} [options={}] - Error options
+   * @param {{ operation?: string, oid?: string, cause?: Error, context?: Record<string, unknown> }} [options={}] - Error options
    */
   constructor(message, options = {}) {
     const context = {

package/src/domain/errors/SyncError.js

@@ -26,7 +26,7 @@ import WarpError from './WarpError.js';
 export default class SyncError extends WarpError {
   /**
    * @param {string} message
-   * @param {{ code?: string, context?: Object }} [options={}]
+   * @param {{ code?: string, context?: Record<string, unknown> }} [options={}]
    */
   constructor(message, options = {}) {
     super(message, 'SYNC_ERROR', options);

package/src/domain/errors/TraversalError.js

@@ -19,7 +19,7 @@ import WarpError from './WarpError.js';
 export default class TraversalError extends WarpError {
   /**
    * @param {string} message
-   * @param {{ code?: string, context?: Object }} [options={}]
+   * @param {{ code?: string, context?: Record<string, unknown> }} [options={}]
    */
   constructor(message, options = {}) {
     super(message, 'TRAVERSAL_ERROR', options);

package/src/domain/errors/TrustError.js

@@ -21,7 +21,7 @@ import WarpError from './WarpError.js';
 export default class TrustError extends WarpError {
   /**
    * @param {string} message
-   * @param {{ code?: string, context?: Object }} [options={}]
+   * @param {{ code?: string, context?: Record<string, unknown> }} [options={}]
    */
   constructor(message, options = {}) {
     super(message, 'TRUST_ERROR', options);

package/src/domain/errors/WarpError.js

@@ -10,13 +10,13 @@
  *
  * @property {string} name - Error name (set from constructor.name)
  * @property {string} code - Machine-readable error code
- * @property {Record<string, *>} context - Serializable context for debugging
+ * @property {Record<string, unknown>} context - Serializable context for debugging
  */
 export default class WarpError extends Error {
   /**
    * @param {string} message - Human-readable error message
    * @param {string} defaultCode - Default error code if not overridden by options
-   * @param {{ code?: string, context?: Record<string, *> }} [options={}] - Error options
+   * @param {{ code?: string, context?: Record<string, unknown> }} [options={}] - Error options
    */
   constructor(message, defaultCode, options = {}) {
     super(message);

package/src/domain/errors/WormholeError.js

@@ -24,7 +24,7 @@ import WarpError from './WarpError.js';
 export default class WormholeError extends WarpError {
   /**
    * @param {string} message
-   * @param {{ code?: string, context?: Object }} [options={}]
+   * @param {{ code?: string, context?: Record<string, unknown> }} [options={}]
    */
   constructor(message, options = {}) {
     super(message, 'WORMHOLE_ERROR', options);

package/src/domain/services/AuditReceiptService.js

@@ -290,12 +290,12 @@ export class AuditReceiptService {
 
     try {
       return await this._commitInner(tickReceipt);
-    } catch (/** @type {*} */ err) { // TODO(ts-cleanup): narrow catch type
+    } catch (err) {
       this._failed++;
       this._logger?.warn('[warp:audit]', {
         code: 'AUDIT_COMMIT_FAILED',
         writerId: this._writerId,
-        error: err?.message,
+        error: err instanceof Error ? err.message : String(err),
       });
       return null;
     }
@@ -366,11 +366,11 @@ export class AuditReceiptService {
     let blobOid;
     try {
       blobOid = await this._persistence.writeBlob(Buffer.from(cborBytes));
-    } catch (/** @type {*} */ err) { // TODO(ts-cleanup): narrow catch type
+    } catch (err) {
       this._logger?.warn('[warp:audit]', {
         code: 'AUDIT_WRITE_BLOB_FAILED',
         writerId: this._writerId,
-        error: err?.message,
+        error: err instanceof Error ? err.message : String(err),
       });
       throw err;
     }
@@ -381,11 +381,11 @@ export class AuditReceiptService {
       treeOid = await this._persistence.writeTree([
         `100644 blob ${blobOid}\treceipt.cbor`,
       ]);
-    } catch (/** @type {*} */ err) { // TODO(ts-cleanup): narrow catch type
+    } catch (err) {
       this._logger?.warn('[warp:audit]', {
         code: 'AUDIT_WRITE_TREE_FAILED',
         writerId: this._writerId,
-        error: err?.message,
+        error: err instanceof Error ? err.message : String(err),
       });
       throw err;
     }