@unbrained/pm-cli 2026.7.21 → 2026.7.22

package/dist/sdk/relationship-history.d.ts

@@ -83,6 +83,27 @@ export interface RelationshipEventStoreOptions extends RelationshipEventLogOptio
     /** Optional JSONL path relative to the tracker root. */
     relativePath?: string;
 }
+/** Collision policy applied while publishing a durable event batch. */
+export type RelationshipExistingEventPolicy = "error" | "skip_identical";
+/** Controls for one atomic durable relationship-event batch. */
+export interface RelationshipEventBatchOptions {
+    /**
+     * Existing event ids fail by default. Migration resume flows may skip an id
+     * only when every persisted semantic field is identical to the input.
+     */
+    existingEventPolicy?: RelationshipExistingEventPolicy;
+}
+/** Result of one validated, atomic durable relationship-event batch. */
+export interface RelationshipEventBatchResult {
+    /** Durable stream version observed while holding the writer lock. */
+    version_before: number;
+    /** Durable stream version after the atomic publication. */
+    version_after: number;
+    /** Immutable sequenced events newly published by this call. */
+    appended: readonly RelationshipEvent[];
+    /** Existing byte-equivalent event ids skipped by resume mode. */
+    skipped_event_ids: readonly string[];
+}
 /**
  * Append-only in-memory reference ledger. Durable adapters can persist the
  * returned immutable events while reusing the same replay and validation model.
@@ -133,6 +154,15 @@ export declare class RelationshipEventStore {
     currentVersion(): Promise<number>;
     /** Append one event after refreshing under the shared workspace lock. */
     append(input: RelationshipEventInput): Promise<RelationshipEvent>;
+    /**
+     * Validate and publish a relationship-event batch as one durable replacement.
+     * The shared writer lock covers refresh, collision checks, full in-memory
+     * validation, and atomic rename. A validation or filesystem failure therefore
+     * leaves the previous JSONL stream byte-for-byte unchanged. This path is
+     * intended for migrations and bulk imports; latency-sensitive single events
+     * should continue to use {@link append} and its O_APPEND write.
+     */
+    appendBatch(inputs: readonly RelationshipEventInput[], options?: RelationshipEventBatchOptions): Promise<RelationshipEventBatchResult>;
     /** Refresh from durable history and materialize an exact validated snapshot. */
     snapshot(options?: Parameters<RelationshipEventLog["snapshot"]>[0]): Promise<RelationshipSnapshot>;
     /** Refresh from durable history and page immutable events. */

package/dist/sdk/relationship-history.js

@@ -5,12 +5,14 @@
  * optimistic concurrency, deterministic replay, snapshots, and cursor pages.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b00bbd6d-eb0d-5fbf-8f87-456d479e7807")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c2ea8300-fc2a-5562-ba56-f5364990f479")}catch(e){}}();
 import { createQueryFingerprint, decodeQueryCursorState, paginateQueryRows, } from "./pagination.js";
 import { constants } from "node:fs";
 import { lstat, mkdir, open } from "node:fs/promises";
 import path from "node:path";
 import { acquireLock } from "../core/lock/lock.js";
+import { writeFileAtomic } from "../core/fs/fs-utils.js";
+import { stableStringify } from "../core/shared/serialization.js";
 import { RelationshipGraph, createRelationshipKindRegistry, } from "./relationships.js";
 function requiredText(value, field) {
     if (typeof value !== "string" || value.trim().length === 0)
@@ -320,7 +322,7 @@ async function loadRelationshipEventLog(target, nodes, registry) {
     }
     catch (error) {
         if (error.code === "ENOENT")
-            return log;
+            return { log, raw: "" };
         throw error;
     }
     finally {
@@ -351,7 +353,22 @@ async function loadRelationshipEventLog(target, nodes, registry) {
             expectedVersion: log.version,
         });
     }
-    return log;
+    return { log, raw };
+}
+/** Return whether an existing immutable event exactly represents one input. */
+function relationshipEventMatchesInput(event, input, nodes, registry) {
+    const timestamp = Date.parse(input.timestamp);
+    let edge;
+    if (input.action !== "remove" && input.edge !== undefined)
+        edge = new RelationshipGraph(nodes, [input.edge], registry).edges()[0];
+    return (event.eventId === input.eventId.trim() &&
+        event.relationshipId === input.relationshipId.trim() &&
+        event.action === input.action &&
+        event.author === input.author.trim() &&
+        Number.isFinite(timestamp) &&
+        event.timestamp === new Date(timestamp).toISOString() &&
+        event.reason === (input.reason?.trim() || undefined) &&
+        stableStringify(event.edge) === stableStringify(edge));
 }
 /**
  * Lock-serialized durable JSONL adapter for {@link RelationshipEventLog}.
@@ -378,7 +395,7 @@ export class RelationshipEventStore {
         const release = await acquireRelationshipStoreLock(options.pmRoot);
         try {
             await resolveRelationshipEventStorePath(options.pmRoot, target);
-            const log = await loadRelationshipEventLog(target, nodes, options.registry);
+            const { log } = await loadRelationshipEventLog(target, nodes, options.registry);
             return new RelationshipEventStore(options, nodes, target, log);
         }
         finally {
@@ -399,7 +416,7 @@ export class RelationshipEventStore {
         const release = await acquireRelationshipStoreLock(this.#pmRoot);
         try {
             const target = await resolveRelationshipEventStorePath(this.#pmRoot, this.#path);
-            const refreshed = await loadRelationshipEventLog(target, this.#nodes, this.#registry);
+            const { log: refreshed } = await loadRelationshipEventLog(target, this.#nodes, this.#registry);
             const event = refreshed.append(input);
             await mkdir(path.dirname(target), { recursive: true });
             await resolveRelationshipEventStorePath(this.#pmRoot, target);
@@ -420,6 +437,57 @@ export class RelationshipEventStore {
             await release();
         }
     }
+    /**
+     * Validate and publish a relationship-event batch as one durable replacement.
+     * The shared writer lock covers refresh, collision checks, full in-memory
+     * validation, and atomic rename. A validation or filesystem failure therefore
+     * leaves the previous JSONL stream byte-for-byte unchanged. This path is
+     * intended for migrations and bulk imports; latency-sensitive single events
+     * should continue to use {@link append} and its O_APPEND write.
+     */
+    async appendBatch(inputs, options = {}) {
+        const release = await acquireRelationshipStoreLock(this.#pmRoot);
+        try {
+            const target = await resolveRelationshipEventStorePath(this.#pmRoot, this.#path);
+            const { log: refreshed, raw } = await loadRelationshipEventLog(target, this.#nodes, this.#registry);
+            const versionBefore = refreshed.version;
+            const existing = new Map(refreshed.events().map((event) => [event.eventId, event]));
+            const appended = [];
+            const skippedEventIds = [];
+            for (const input of inputs) {
+                const eventId = input.eventId.trim();
+                const stored = existing.get(eventId);
+                if (stored !== undefined) {
+                    if (options.existingEventPolicy === "skip_identical" &&
+                        relationshipEventMatchesInput(stored, input, this.#nodes, this.#registry)) {
+                        skippedEventIds.push(stored.eventId);
+                        continue;
+                    }
+                    if (options.existingEventPolicy === "skip_identical")
+                        throw new TypeError(`Relationship event id collision with different content: ${eventId}`);
+                }
+                const event = refreshed.append(input);
+                existing.set(event.eventId, event);
+                appended.push(event);
+            }
+            if (appended.length > 0) {
+                const prefix = raw.length === 0 || raw.endsWith("\n") ? raw : `${raw}\n`;
+                await mkdir(path.dirname(target), { recursive: true });
+                await resolveRelationshipEventStorePath(this.#pmRoot, target);
+                await writeFileAtomic(target, `${prefix}${appended.map((event) => JSON.stringify(event)).join("\n")}\n`);
+            }
+            this.#log = refreshed;
+            return Object.freeze({
+                version_before: versionBefore,
+                version_after: refreshed.version,
+                appended: Object.freeze(appended),
+                skipped_event_ids: Object.freeze(skippedEventIds),
+            });
+        }
+        finally {
+            await release();
+        }
+    }
     /** Refresh from durable history and materialize an exact validated snapshot. */
     async snapshot(options = {}) {
         this.#log = await this.#refreshFromDurableHistory();
@@ -448,7 +516,7 @@ export class RelationshipEventStore {
         const release = await acquireRelationshipStoreLock(this.#pmRoot);
         try {
             const target = await resolveRelationshipEventStorePath(this.#pmRoot, this.#path);
-            return await loadRelationshipEventLog(target, this.#nodes, this.#registry);
+            return (await loadRelationshipEventLog(target, this.#nodes, this.#registry)).log;
         }
         finally {
             await release();
@@ -456,4 +524,4 @@ export class RelationshipEventStore {
     }
 }
 //# sourceMappingURL=relationship-history.js.map
-//# debugId=b00bbd6d-eb0d-5fbf-8f87-456d479e7807
+//# debugId=c2ea8300-fc2a-5562-ba56-f5364990f479

package/dist/sdk/relationship-history.js.map

@@ -1 +1 @@
-{"version":3,"file":"relationship-history.js","sources":["sdk/relationship-history.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/relationship-history\n *\n * Provides an append-only, storage-independent relationship event ledger with\n * optimistic concurrency, deterministic replay, snapshots, and cursor pages.\n */\nimport {\n  createQueryFingerprint,\n  decodeQueryCursorState,\n  paginateQueryRows,\n} from \"./pagination.js\";\nimport { constants } from \"node:fs\";\nimport { lstat, mkdir, open, type FileHandle } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { acquireLock } from \"../core/lock/lock.js\";\nimport {\n  RelationshipGraph,\n  RelationshipKindRegistry,\n  createRelationshipKindRegistry,\n  type RelationshipEdge,\n} from \"./relationships.js\";\n\n/** Mutation kinds retained in the immutable relationship event stream. */\nexport type RelationshipEventAction = \"add\" | \"remove\" | \"supersede\";\n\n/** Caller-authored relationship mutation before its sequence is assigned. */\nexport interface RelationshipEventInput {\n  /** Globally unique idempotency key for this event. */\n  eventId: string;\n  /** Stable logical relationship identifier across superseding events. */\n  relationshipId: string;\n  /** Append, remove, or replace the logical relationship. */\n  action: RelationshipEventAction;\n  /** Edge required for add and supersede actions. */\n  edge?: RelationshipEdge;\n  /** Attributable actor responsible for the mutation. */\n  author: string;\n  /** Valid event-time timestamp. */\n  timestamp: string;\n  /** Optional optimistic concurrency precondition. */\n  expectedVersion?: number;\n  /** Optional human-readable mutation rationale. */\n  reason?: string;\n}\n\n/** One immutable sequenced relationship mutation. */\nexport interface RelationshipEvent extends Omit<\n  RelationshipEventInput,\n  \"expectedVersion\"\n> {\n  /** One-based append sequence assigned by the ledger. */\n  sequence: number;\n}\n\n/** Point-in-time materialized relationship view. */\nexport interface RelationshipSnapshot {\n  /** Final event sequence included in this snapshot. */\n  version: number;\n  /** Timestamp of the final included event, when one exists. */\n  asOf?: string;\n  /** Deterministic active edge materialization. */\n  edges: readonly RelationshipEdge[];\n  /** Immutable graph query view over the active edges. */\n  graph: RelationshipGraph;\n}\n\n/** Stable cursor page over a fixed relationship event-log version. */\nexport interface RelationshipEventPage {\n  /** Log version against which this page was produced. */\n  version: number;\n  /** Events in append order. */\n  events: RelationshipEvent[];\n  /** Whether another event page exists. */\n  hasMore: boolean;\n  /** Opaque continuation cursor when another page exists. */\n  nextCursor?: string;\n}\n\n/** Bounded controls for deterministic relationship-event batch iteration. */\nexport interface RelationshipEventStreamOptions {\n  /** One-based first event version to include. */\n  fromVersion?: number;\n  /** One-based final event version to include. */\n  toVersion?: number;\n  /** Maximum number of events yielded in each immutable batch. */\n  batchSize?: number;\n}\n\n/** Result of folding an immutable relationship-event prefix into domain state. */\nexport interface RelationshipEventProjection<State> {\n  /** Final projected state returned by the caller-owned reducer. */\n  state: State;\n  /** Final event sequence included in the projection. */\n  version: number;\n  /** Number of events processed by this projection. */\n  processed: number;\n  /** Timestamp of the final included event, when one exists. */\n  asOf?: string;\n}\n\n/** Pure reducer used to derive application state from relationship events. */\nexport type RelationshipEventReducer<State> = (\n  state: State,\n  event: RelationshipEvent,\n) => State;\n\n/** Construction controls for the in-memory reference ledger. */\nexport interface RelationshipEventLogOptions {\n  /** Registry defining edge semantics and cardinality. */\n  registry?: RelationshipKindRegistry;\n}\n\n/** Filesystem controls for the durable relationship event store. */\nexport interface RelationshipEventStoreOptions extends RelationshipEventLogOptions {\n  /** Tracker root that owns the relationship history directory. */\n  pmRoot: string;\n  /** Fixed node universe validated by every replay and append. */\n  nodes: Iterable<string>;\n  /** Optional JSONL path relative to the tracker root. */\n  relativePath?: string;\n}\n\ninterface RelationshipCardinalityIndexes {\n  identities: Map<string, string>;\n  outgoingOne: Map<string, string>;\n  incomingOne: Map<string, string>;\n}\n\nfunction requiredText(value: unknown, field: string): string {\n  if (typeof value !== \"string\" || value.trim().length === 0)\n    throw new TypeError(`Relationship event ${field} must be non-empty`);\n  return value.trim();\n}\n\nfunction edgeIdentity(\n  edge: RelationshipEdge,\n  registry: RelationshipKindRegistry,\n): string {\n  const definition = registry.require(edge.kind);\n  const endpoints =\n    definition.direction === \"undirected\"\n      ? [edge.source, edge.target].sort().join(\"\\u0000\")\n      : `${edge.source}\\u0000${edge.target}`;\n  return `${definition.kind}\\u0000${endpoints}`;\n}\n\nfunction freezeEdge(edge: RelationshipEdge): RelationshipEdge {\n  return Object.freeze({\n    ...edge,\n    ...(edge.payload === undefined\n      ? {}\n      : { payload: Object.freeze(structuredClone(edge.payload)) }),\n  });\n}\n\nfunction assertCardinality(\n  candidate: RelationshipEdge,\n  excludeRelationshipId: string,\n  registry: RelationshipKindRegistry,\n  indexes: RelationshipCardinalityIndexes,\n): void {\n  const definition = registry.require(candidate.kind);\n  const outgoingOwner = indexes.outgoingOne.get(\n    `${definition.kind}\\u0000${candidate.source}`,\n  );\n  if (outgoingOwner !== undefined && outgoingOwner !== excludeRelationshipId)\n    throw new TypeError(\n      `Relationship outgoing cardinality exceeded for ${definition.kind}`,\n    );\n  const incomingOwner = indexes.incomingOne.get(\n    `${definition.kind}\\u0000${candidate.target}`,\n  );\n  if (incomingOwner !== undefined && incomingOwner !== excludeRelationshipId)\n    throw new TypeError(\n      `Relationship incoming cardinality exceeded for ${definition.kind}`,\n    );\n  const identity = edgeIdentity(candidate, registry);\n  const identityOwner = indexes.identities.get(identity);\n  if (identityOwner !== undefined && identityOwner !== excludeRelationshipId)\n    throw new TypeError(`Relationship edge already active: ${identity}`);\n}\n\nfunction replayEvents(\n  events: readonly RelationshipEvent[],\n): Map<string, RelationshipEdge> {\n  const active = new Map<string, RelationshipEdge>();\n  for (const event of events) {\n    if (event.action === \"remove\") active.delete(event.relationshipId);\n    else active.set(event.relationshipId, event.edge!);\n  }\n  return active;\n}\n\nfunction normalizeEventHeader(\n  input: RelationshipEventInput,\n  currentVersion: number,\n  eventIds: ReadonlySet<string>,\n): {\n  eventId: string;\n  relationshipId: string;\n  author: string;\n  timestamp: string;\n} {\n  if (\n    input.expectedVersion !== undefined &&\n    input.expectedVersion !== currentVersion\n  )\n    throw new TypeError(\n      `Relationship event version conflict: expected ${input.expectedVersion}, current ${currentVersion}`,\n    );\n  const eventId = requiredText(input.eventId, \"eventId\");\n  if (eventIds.has(eventId))\n    throw new TypeError(`Relationship event already exists: ${eventId}`);\n  if (\n    input.action !== \"add\" &&\n    input.action !== \"remove\" &&\n    input.action !== \"supersede\"\n  )\n    throw new TypeError(`Unknown relationship event action: ${input.action}`);\n  if (!Number.isFinite(Date.parse(input.timestamp)))\n    throw new TypeError(\"Relationship event timestamp must be valid\");\n  return {\n    eventId,\n    relationshipId: requiredText(input.relationshipId, \"relationshipId\"),\n    author: requiredText(input.author, \"author\"),\n    timestamp: new Date(input.timestamp).toISOString(),\n  };\n}\n\nfunction resolveMutationEdge(\n  input: RelationshipEventInput,\n  relationshipId: string,\n  active: ReadonlyMap<string, RelationshipEdge>,\n  nodes: ReadonlySet<string>,\n  registry: RelationshipKindRegistry,\n  indexes: RelationshipCardinalityIndexes,\n): RelationshipEdge | undefined {\n  const isActive = active.has(relationshipId);\n  if (input.action === \"add\" && isActive)\n    throw new TypeError(`Relationship is already active: ${relationshipId}`);\n  if (input.action !== \"add\" && !isActive)\n    throw new TypeError(`Relationship is not active: ${relationshipId}`);\n  if (input.action === \"remove\") return undefined;\n  if (!input.edge)\n    throw new TypeError(`Relationship ${input.action} event requires an edge`);\n  const source =\n    typeof input.edge.source === \"string\" ? input.edge.source.trim() : \"\";\n  const target =\n    typeof input.edge.target === \"string\" ? input.edge.target.trim() : \"\";\n  if (!nodes.has(source) || !nodes.has(target))\n    throw new TypeError(\n      `Relationship endpoint not found: ${source} -> ${target}`,\n    );\n  const canonical = new RelationshipGraph(\n    [source, target],\n    [input.edge],\n    registry,\n  ).edges()[0]!;\n  assertCardinality(canonical, relationshipId, registry, indexes);\n  return freezeEdge(canonical);\n}\n\n/**\n * Append-only in-memory reference ledger. Durable adapters can persist the\n * returned immutable events while reusing the same replay and validation model.\n */\nexport class RelationshipEventLog {\n  readonly #nodes: ReadonlySet<string>;\n  readonly #registry: RelationshipKindRegistry;\n  readonly #events: RelationshipEvent[] = [];\n  readonly #eventIds = new Set<string>();\n  readonly #active = new Map<string, RelationshipEdge>();\n  readonly #cardinalityIndexes: RelationshipCardinalityIndexes = {\n    identities: new Map(),\n    outgoingOne: new Map(),\n    incomingOne: new Map(),\n  };\n\n  /** Create an empty relationship ledger for a fixed node universe. */\n  public constructor(\n    nodes: Iterable<string>,\n    options: RelationshipEventLogOptions = {},\n  ) {\n    this.#nodes = new Set(\n      [...nodes]\n        .filter((node): node is string => typeof node === \"string\")\n        .map((node) => node.trim())\n        .filter(Boolean),\n    );\n    this.#registry = options.registry ?? createRelationshipKindRegistry();\n  }\n\n  /** Current append sequence. */\n  public get version(): number {\n    return this.#events.length;\n  }\n\n  /** Return an immutable copy of the full event stream. */\n  public events(): readonly RelationshipEvent[] {\n    return Object.freeze([...this.#events]);\n  }\n\n  /**\n   * Iterate a stable event prefix in immutable, bounded batches. Consumers can\n   * build streaming projections without copying or exposing the mutable ledger.\n   * `fromVersion === toVersion + 1` is the intentional empty checkpoint range;\n   * larger watermarks are rejected as invalid for the selected prefix.\n   */\n  public *stream(\n    options: RelationshipEventStreamOptions = {},\n  ): Generator<readonly RelationshipEvent[]> {\n    const fromVersion = options.fromVersion ?? 1;\n    const toVersion = options.toVersion ?? this.version;\n    const batchSize = options.batchSize ?? 100;\n    if (!Number.isInteger(fromVersion) || fromVersion < 1)\n      throw new TypeError(\n        \"Relationship event stream fromVersion must be positive\",\n      );\n    if (\n      !Number.isInteger(toVersion) ||\n      toVersion < 0 ||\n      toVersion > this.version\n    )\n      throw new TypeError(\n        `Relationship event stream toVersion out of range: ${toVersion}`,\n      );\n    if (!Number.isInteger(batchSize) || batchSize < 1)\n      throw new TypeError(\n        \"Relationship event stream batchSize must be positive\",\n      );\n    if (fromVersion > toVersion + 1)\n      throw new TypeError(\n        \"Relationship event stream fromVersion exceeds the selected prefix\",\n      );\n    for (let offset = fromVersion - 1; offset < toVersion; offset += batchSize) {\n      yield Object.freeze(\n        this.#events.slice(offset, Math.min(offset + batchSize, toVersion)),\n      );\n    }\n  }\n\n  /** Fold a selected immutable event prefix into caller-owned domain state. */\n  public project<State>(\n    initialState: State,\n    reducer: RelationshipEventReducer<State>,\n    options: Omit<RelationshipEventStreamOptions, \"batchSize\"> = {},\n  ): RelationshipEventProjection<State> {\n    if (typeof reducer !== \"function\")\n      throw new TypeError(\"Relationship event projection requires a reducer\");\n    let state = initialState;\n    let processed = 0;\n    let finalEvent: RelationshipEvent | undefined;\n    for (const batch of this.stream({ ...options, batchSize: 256 })) {\n      for (const event of batch) {\n        state = reducer(state, event);\n        processed += 1;\n        finalEvent = event;\n      }\n    }\n    return Object.freeze({\n      state,\n      version: finalEvent?.sequence ?? Math.max(0, (options.fromVersion ?? 1) - 1),\n      processed,\n      ...(finalEvent === undefined ? {} : { asOf: finalEvent.timestamp }),\n    });\n  }\n\n  /** Add one active relationship to constant-time validation indexes. */\n  #indexActive(relationshipId: string, edge: RelationshipEdge): void {\n    const definition = this.#registry.require(edge.kind);\n    this.#cardinalityIndexes.identities.set(\n      edgeIdentity(edge, this.#registry),\n      relationshipId,\n    );\n    if (definition.outgoing === \"one\")\n      this.#cardinalityIndexes.outgoingOne.set(\n        `${definition.kind}\\u0000${edge.source}`,\n        relationshipId,\n      );\n    if (definition.incoming === \"one\")\n      this.#cardinalityIndexes.incomingOne.set(\n        `${definition.kind}\\u0000${edge.target}`,\n        relationshipId,\n      );\n  }\n\n  /** Remove one superseded or deleted relationship from validation indexes. */\n  #unindexActive(edge: RelationshipEdge): void {\n    const definition = this.#registry.require(edge.kind);\n    this.#cardinalityIndexes.identities.delete(\n      edgeIdentity(edge, this.#registry),\n    );\n    if (definition.outgoing === \"one\")\n      this.#cardinalityIndexes.outgoingOne.delete(\n        `${definition.kind}\\u0000${edge.source}`,\n      );\n    if (definition.incoming === \"one\")\n      this.#cardinalityIndexes.incomingOne.delete(\n        `${definition.kind}\\u0000${edge.target}`,\n      );\n  }\n\n  /** Validate and append one attributable relationship mutation. */\n  public append(input: RelationshipEventInput): RelationshipEvent {\n    const header = normalizeEventHeader(input, this.version, this.#eventIds);\n    const previous = this.#active.get(header.relationshipId);\n    const edge = resolveMutationEdge(\n      input,\n      header.relationshipId,\n      this.#active,\n      this.#nodes,\n      this.#registry,\n      this.#cardinalityIndexes,\n    );\n\n    const event = Object.freeze({\n      eventId: header.eventId,\n      relationshipId: header.relationshipId,\n      action: input.action,\n      ...(edge === undefined ? {} : { edge }),\n      author: header.author,\n      timestamp: header.timestamp,\n      ...(input.reason?.trim() ? { reason: input.reason.trim() } : {}),\n      sequence: this.version + 1,\n    }) satisfies RelationshipEvent;\n    this.#events.push(event);\n    this.#eventIds.add(header.eventId);\n    if (previous) this.#unindexActive(previous);\n    if (input.action === \"remove\") this.#active.delete(header.relationshipId);\n    else {\n      this.#active.set(header.relationshipId, edge!);\n      this.#indexActive(header.relationshipId, edge!);\n    }\n    return event;\n  }\n\n  /** Materialize an exact point-in-time graph without mutating the ledger. */\n  public snapshot(\n    options: {\n      atVersion?: number;\n      atTimestamp?: string;\n    } = {},\n  ): RelationshipSnapshot {\n    if (options.atVersion !== undefined && options.atTimestamp !== undefined)\n      throw new TypeError(\"Relationship snapshot accepts one target\");\n    let included: RelationshipEvent[];\n    if (options.atTimestamp !== undefined) {\n      const timestamp = Date.parse(options.atTimestamp);\n      if (!Number.isFinite(timestamp))\n        throw new TypeError(\"Relationship snapshot timestamp must be valid\");\n      let lastIndex = -1;\n      for (let index = this.#events.length - 1; index >= 0; index -= 1) {\n        if (Date.parse(this.#events[index]!.timestamp) > timestamp) continue;\n        lastIndex = index;\n        break;\n      }\n      included = lastIndex === -1 ? [] : this.#events.slice(0, lastIndex + 1);\n    } else {\n      const version = options.atVersion ?? this.version;\n      if (!Number.isInteger(version) || version < 0 || version > this.version)\n        throw new TypeError(\n          `Relationship snapshot version out of range: ${version}`,\n        );\n      included = this.#events.slice(0, version);\n    }\n    const active = replayEvents(included);\n    const graph = new RelationshipGraph(\n      this.#nodes,\n      active.values(),\n      this.#registry,\n    );\n    return Object.freeze({\n      version: included.length,\n      ...(included.at(-1) ? { asOf: included.at(-1)!.timestamp } : {}),\n      edges: graph.edges(),\n      graph,\n    });\n  }\n\n  /** Page the immutable event stream with a cursor bound to this log version. */\n  public page(options: {\n    limit: number;\n    cursor?: string;\n  }): RelationshipEventPage {\n    if (!Number.isInteger(options.limit) || options.limit < 1)\n      throw new TypeError(\"Relationship event page limit must be positive\");\n    const fingerprint = createQueryFingerprint(\"relationship-events\", {\n      order: \"append-sequence\",\n    });\n    const snapshot =\n      options.cursor === undefined\n        ? this.version\n        : Number(decodeQueryCursorState(options.cursor, fingerprint).snapshot);\n    if (\n      !Number.isSafeInteger(snapshot) ||\n      snapshot < 0 ||\n      snapshot > this.version\n    )\n      throw new TypeError(\n        \"Relationship event cursor snapshot version is invalid\",\n      );\n    const page = paginateQueryRows(this.#events.slice(0, snapshot), {\n      cursor: options.cursor,\n      fingerprint,\n      limit: options.limit,\n      readId: (event) => event.eventId,\n      snapshot: String(snapshot),\n    });\n    return {\n      version: snapshot,\n      events: page.rows,\n      hasMore: page.has_more,\n      ...(page.next_cursor ? { nextCursor: page.next_cursor } : {}),\n    };\n  }\n}\n\nconst RELATIONSHIP_STORE_LOCK_ID = \"relationship-event-store\";\nconst RELATIONSHIP_NOFOLLOW_FLAG = constants.O_NOFOLLOW;\n\nfunction acquireRelationshipStoreLock(\n  pmRoot: string,\n): Promise<() => Promise<void>> {\n  return acquireLock(\n    pmRoot,\n    RELATIONSHIP_STORE_LOCK_ID,\n    30,\n    `relationship-store:${process.pid}`,\n    false,\n    false,\n    3_000,\n  );\n}\n\nasync function resolveRelationshipEventStorePath(\n  pmRoot: string,\n  relativePath = \"relationships/events.jsonl\",\n): Promise<string> {\n  const root = path.resolve(pmRoot);\n  const target = path.resolve(root, relativePath);\n  const relative = path.relative(root, target);\n  if (relative.length === 0)\n    throw new TypeError(\n      \"Relationship event path must name a file within the tracker root\",\n    );\n  if (\n    relative === \"..\" ||\n    relative.startsWith(`..${path.sep}`) ||\n    path.isAbsolute(relative)\n  )\n    throw new TypeError(\n      \"Relationship event path must stay within the tracker root\",\n    );\n  await mkdir(root, { recursive: true });\n  const rootStats = await lstat(root);\n  if (rootStats.isSymbolicLink())\n    throw new TypeError(\n      \"Relationship event tracker root must not be a symbolic link\",\n    );\n  let current = root;\n  for (const segment of relative.split(path.sep)) {\n    current = path.join(current, segment);\n    try {\n      if ((await lstat(current)).isSymbolicLink())\n        throw new TypeError(\n          \"Relationship event path must not contain symbolic links\",\n        );\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === \"ENOENT\") break;\n      throw error;\n    }\n  }\n  return target;\n}\n\nasync function loadRelationshipEventLog(\n  target: string,\n  nodes: readonly string[],\n  registry: RelationshipKindRegistry | undefined,\n): Promise<RelationshipEventLog> {\n  const log = new RelationshipEventLog(nodes, { registry });\n  let raw: string;\n  let handle: FileHandle | undefined;\n  try {\n    handle = await open(\n      target,\n      constants.O_RDONLY | RELATIONSHIP_NOFOLLOW_FLAG,\n    );\n    raw = await handle.readFile(\"utf8\");\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return log;\n    throw error;\n  } finally {\n    await handle?.close();\n  }\n  const lines = raw.split(\"\\n\");\n  for (let index = 0; index < lines.length; index += 1) {\n    const line = lines[index]!.trim();\n    if (!line) continue;\n    let stored: RelationshipEvent;\n    try {\n      stored = JSON.parse(line) as RelationshipEvent;\n    } catch {\n      throw new TypeError(\n        `Invalid relationship event JSONL at line ${index + 1}`,\n      );\n    }\n    if (stored.sequence !== log.version + 1)\n      throw new TypeError(\n        `Invalid relationship event sequence at line ${index + 1}`,\n      );\n    log.append({\n      eventId: stored.eventId,\n      relationshipId: stored.relationshipId,\n      action: stored.action,\n      ...(stored.edge === undefined ? {} : { edge: stored.edge }),\n      author: stored.author,\n      timestamp: stored.timestamp,\n      ...(stored.reason === undefined ? {} : { reason: stored.reason }),\n      expectedVersion: log.version,\n    });\n  }\n  return log;\n}\n\n/**\n * Lock-serialized durable JSONL adapter for {@link RelationshipEventLog}.\n * Every append replays the current stream while holding the workspace lock, so\n * independent processes share optimistic versions without lost updates.\n */\nexport class RelationshipEventStore {\n  readonly #pmRoot: string;\n  readonly #nodes: readonly string[];\n  readonly #registry: RelationshipKindRegistry | undefined;\n  readonly #path: string;\n  #log: RelationshipEventLog;\n\n  private constructor(\n    options: RelationshipEventStoreOptions,\n    nodes: readonly string[],\n    target: string,\n    log: RelationshipEventLog,\n  ) {\n    this.#pmRoot = options.pmRoot;\n    this.#nodes = nodes;\n    this.#registry = options.registry;\n    this.#path = target;\n    this.#log = log;\n  }\n\n  /** Open and validate an existing stream or create an empty store view. */\n  public static async open(\n    options: RelationshipEventStoreOptions,\n  ): Promise<RelationshipEventStore> {\n    const nodes = Object.freeze([...options.nodes]);\n    const target = await resolveRelationshipEventStorePath(\n      options.pmRoot,\n      options.relativePath,\n    );\n    const release = await acquireRelationshipStoreLock(options.pmRoot);\n    try {\n      await resolveRelationshipEventStorePath(options.pmRoot, target);\n      const log = await loadRelationshipEventLog(\n        target,\n        nodes,\n        options.registry,\n      );\n      return new RelationshipEventStore(options, nodes, target, log);\n    } finally {\n      await release();\n    }\n  }\n\n  /** Absolute JSONL path, exposed for diagnostics and backup tooling. */\n  public get path(): string {\n    return this.#path;\n  }\n\n  /** Refresh from durable history and return the current validated append sequence. */\n  public async currentVersion(): Promise<number> {\n    this.#log = await this.#refreshFromDurableHistory();\n    return this.#log.version;\n  }\n\n  /** Append one event after refreshing under the shared workspace lock. */\n  public async append(\n    input: RelationshipEventInput,\n  ): Promise<RelationshipEvent> {\n    const release = await acquireRelationshipStoreLock(this.#pmRoot);\n    try {\n      const target = await resolveRelationshipEventStorePath(\n        this.#pmRoot,\n        this.#path,\n      );\n      const refreshed = await loadRelationshipEventLog(\n        target,\n        this.#nodes,\n        this.#registry,\n      );\n      const event = refreshed.append(input);\n      await mkdir(path.dirname(target), { recursive: true });\n      await resolveRelationshipEventStorePath(this.#pmRoot, target);\n      const handle = await open(\n        target,\n        constants.O_APPEND |\n          constants.O_CREAT |\n          constants.O_WRONLY |\n          RELATIONSHIP_NOFOLLOW_FLAG,\n      );\n      try {\n        await handle.appendFile(`${JSON.stringify(event)}\\n`, \"utf8\");\n      } finally {\n        await handle.close();\n      }\n      this.#log = refreshed;\n      return event;\n    } finally {\n      await release();\n    }\n  }\n\n  /** Refresh from durable history and materialize an exact validated snapshot. */\n  public async snapshot(\n    options: Parameters<RelationshipEventLog[\"snapshot\"]>[0] = {},\n  ): Promise<RelationshipSnapshot> {\n    this.#log = await this.#refreshFromDurableHistory();\n    return this.#log.snapshot(options);\n  }\n\n  /** Refresh from durable history and page immutable events. */\n  public async page(\n    options: Parameters<RelationshipEventLog[\"page\"]>[0],\n  ): Promise<RelationshipEventPage> {\n    this.#log = await this.#refreshFromDurableHistory();\n    return this.#log.page(options);\n  }\n\n  /**\n   * Refresh once under the shared store lock, then stream a coherent immutable\n   * prefix without holding the writer lock while the consumer processes batches.\n   */\n  public async *stream(\n    options: RelationshipEventStreamOptions = {},\n  ): AsyncGenerator<readonly RelationshipEvent[]> {\n    this.#log = await this.#refreshFromDurableHistory();\n    yield* this.#log.stream(options);\n  }\n\n  /** Refresh once and fold a coherent durable prefix into application state. */\n  public async project<State>(\n    initialState: State,\n    reducer: RelationshipEventReducer<State>,\n    options: Omit<RelationshipEventStreamOptions, \"batchSize\"> = {},\n  ): Promise<RelationshipEventProjection<State>> {\n    this.#log = await this.#refreshFromDurableHistory();\n    return this.#log.project(initialState, reducer, options);\n  }\n\n  /** Serialize a durable refresh with writers so readers never observe a torn JSONL tail. */\n  async #refreshFromDurableHistory(): Promise<RelationshipEventLog> {\n    const release = await acquireRelationshipStoreLock(this.#pmRoot);\n    try {\n      const target = await resolveRelationshipEventStorePath(\n        this.#pmRoot,\n        this.#path,\n      );\n      return await loadRelationshipEventLog(\n        target,\n        this.#nodes,\n        this.#registry,\n      );\n    } finally {\n      await release();\n    }\n  }\n}\n"],"names":[],"mappings":"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","debugId":"b00bbd6d-eb0d-5fbf-8f87-456d479e7807"}
+{"version":3,"file":"relationship-history.js","sources":["sdk/relationship-history.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/relationship-history\n *\n * Provides an append-only, storage-independent relationship event ledger with\n * optimistic concurrency, deterministic replay, snapshots, and cursor pages.\n */\nimport {\n  createQueryFingerprint,\n  decodeQueryCursorState,\n  paginateQueryRows,\n} from \"./pagination.js\";\nimport { constants } from \"node:fs\";\nimport { lstat, mkdir, open, type FileHandle } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { acquireLock } from \"../core/lock/lock.js\";\nimport { writeFileAtomic } from \"../core/fs/fs-utils.js\";\nimport { stableStringify } from \"../core/shared/serialization.js\";\nimport {\n  RelationshipGraph,\n  RelationshipKindRegistry,\n  createRelationshipKindRegistry,\n  type RelationshipEdge,\n} from \"./relationships.js\";\n\n/** Mutation kinds retained in the immutable relationship event stream. */\nexport type RelationshipEventAction = \"add\" | \"remove\" | \"supersede\";\n\n/** Caller-authored relationship mutation before its sequence is assigned. */\nexport interface RelationshipEventInput {\n  /** Globally unique idempotency key for this event. */\n  eventId: string;\n  /** Stable logical relationship identifier across superseding events. */\n  relationshipId: string;\n  /** Append, remove, or replace the logical relationship. */\n  action: RelationshipEventAction;\n  /** Edge required for add and supersede actions. */\n  edge?: RelationshipEdge;\n  /** Attributable actor responsible for the mutation. */\n  author: string;\n  /** Valid event-time timestamp. */\n  timestamp: string;\n  /** Optional optimistic concurrency precondition. */\n  expectedVersion?: number;\n  /** Optional human-readable mutation rationale. */\n  reason?: string;\n}\n\n/** One immutable sequenced relationship mutation. */\nexport interface RelationshipEvent extends Omit<\n  RelationshipEventInput,\n  \"expectedVersion\"\n> {\n  /** One-based append sequence assigned by the ledger. */\n  sequence: number;\n}\n\n/** Point-in-time materialized relationship view. */\nexport interface RelationshipSnapshot {\n  /** Final event sequence included in this snapshot. */\n  version: number;\n  /** Timestamp of the final included event, when one exists. */\n  asOf?: string;\n  /** Deterministic active edge materialization. */\n  edges: readonly RelationshipEdge[];\n  /** Immutable graph query view over the active edges. */\n  graph: RelationshipGraph;\n}\n\n/** Stable cursor page over a fixed relationship event-log version. */\nexport interface RelationshipEventPage {\n  /** Log version against which this page was produced. */\n  version: number;\n  /** Events in append order. */\n  events: RelationshipEvent[];\n  /** Whether another event page exists. */\n  hasMore: boolean;\n  /** Opaque continuation cursor when another page exists. */\n  nextCursor?: string;\n}\n\n/** Bounded controls for deterministic relationship-event batch iteration. */\nexport interface RelationshipEventStreamOptions {\n  /** One-based first event version to include. */\n  fromVersion?: number;\n  /** One-based final event version to include. */\n  toVersion?: number;\n  /** Maximum number of events yielded in each immutable batch. */\n  batchSize?: number;\n}\n\n/** Result of folding an immutable relationship-event prefix into domain state. */\nexport interface RelationshipEventProjection<State> {\n  /** Final projected state returned by the caller-owned reducer. */\n  state: State;\n  /** Final event sequence included in the projection. */\n  version: number;\n  /** Number of events processed by this projection. */\n  processed: number;\n  /** Timestamp of the final included event, when one exists. */\n  asOf?: string;\n}\n\n/** Pure reducer used to derive application state from relationship events. */\nexport type RelationshipEventReducer<State> = (\n  state: State,\n  event: RelationshipEvent,\n) => State;\n\n/** Construction controls for the in-memory reference ledger. */\nexport interface RelationshipEventLogOptions {\n  /** Registry defining edge semantics and cardinality. */\n  registry?: RelationshipKindRegistry;\n}\n\n/** Filesystem controls for the durable relationship event store. */\nexport interface RelationshipEventStoreOptions extends RelationshipEventLogOptions {\n  /** Tracker root that owns the relationship history directory. */\n  pmRoot: string;\n  /** Fixed node universe validated by every replay and append. */\n  nodes: Iterable<string>;\n  /** Optional JSONL path relative to the tracker root. */\n  relativePath?: string;\n}\n\n/** Collision policy applied while publishing a durable event batch. */\nexport type RelationshipExistingEventPolicy = \"error\" | \"skip_identical\";\n\n/** Controls for one atomic durable relationship-event batch. */\nexport interface RelationshipEventBatchOptions {\n  /**\n   * Existing event ids fail by default. Migration resume flows may skip an id\n   * only when every persisted semantic field is identical to the input.\n   */\n  existingEventPolicy?: RelationshipExistingEventPolicy;\n}\n\n/** Result of one validated, atomic durable relationship-event batch. */\nexport interface RelationshipEventBatchResult {\n  /** Durable stream version observed while holding the writer lock. */\n  version_before: number;\n  /** Durable stream version after the atomic publication. */\n  version_after: number;\n  /** Immutable sequenced events newly published by this call. */\n  appended: readonly RelationshipEvent[];\n  /** Existing byte-equivalent event ids skipped by resume mode. */\n  skipped_event_ids: readonly string[];\n}\n\ninterface RelationshipCardinalityIndexes {\n  identities: Map<string, string>;\n  outgoingOne: Map<string, string>;\n  incomingOne: Map<string, string>;\n}\n\nfunction requiredText(value: unknown, field: string): string {\n  if (typeof value !== \"string\" || value.trim().length === 0)\n    throw new TypeError(`Relationship event ${field} must be non-empty`);\n  return value.trim();\n}\n\nfunction edgeIdentity(\n  edge: RelationshipEdge,\n  registry: RelationshipKindRegistry,\n): string {\n  const definition = registry.require(edge.kind);\n  const endpoints =\n    definition.direction === \"undirected\"\n      ? [edge.source, edge.target].sort().join(\"\\u0000\")\n      : `${edge.source}\\u0000${edge.target}`;\n  return `${definition.kind}\\u0000${endpoints}`;\n}\n\nfunction freezeEdge(edge: RelationshipEdge): RelationshipEdge {\n  return Object.freeze({\n    ...edge,\n    ...(edge.payload === undefined\n      ? {}\n      : { payload: Object.freeze(structuredClone(edge.payload)) }),\n  });\n}\n\nfunction assertCardinality(\n  candidate: RelationshipEdge,\n  excludeRelationshipId: string,\n  registry: RelationshipKindRegistry,\n  indexes: RelationshipCardinalityIndexes,\n): void {\n  const definition = registry.require(candidate.kind);\n  const outgoingOwner = indexes.outgoingOne.get(\n    `${definition.kind}\\u0000${candidate.source}`,\n  );\n  if (outgoingOwner !== undefined && outgoingOwner !== excludeRelationshipId)\n    throw new TypeError(\n      `Relationship outgoing cardinality exceeded for ${definition.kind}`,\n    );\n  const incomingOwner = indexes.incomingOne.get(\n    `${definition.kind}\\u0000${candidate.target}`,\n  );\n  if (incomingOwner !== undefined && incomingOwner !== excludeRelationshipId)\n    throw new TypeError(\n      `Relationship incoming cardinality exceeded for ${definition.kind}`,\n    );\n  const identity = edgeIdentity(candidate, registry);\n  const identityOwner = indexes.identities.get(identity);\n  if (identityOwner !== undefined && identityOwner !== excludeRelationshipId)\n    throw new TypeError(`Relationship edge already active: ${identity}`);\n}\n\nfunction replayEvents(\n  events: readonly RelationshipEvent[],\n): Map<string, RelationshipEdge> {\n  const active = new Map<string, RelationshipEdge>();\n  for (const event of events) {\n    if (event.action === \"remove\") active.delete(event.relationshipId);\n    else active.set(event.relationshipId, event.edge!);\n  }\n  return active;\n}\n\nfunction normalizeEventHeader(\n  input: RelationshipEventInput,\n  currentVersion: number,\n  eventIds: ReadonlySet<string>,\n): {\n  eventId: string;\n  relationshipId: string;\n  author: string;\n  timestamp: string;\n} {\n  if (\n    input.expectedVersion !== undefined &&\n    input.expectedVersion !== currentVersion\n  )\n    throw new TypeError(\n      `Relationship event version conflict: expected ${input.expectedVersion}, current ${currentVersion}`,\n    );\n  const eventId = requiredText(input.eventId, \"eventId\");\n  if (eventIds.has(eventId))\n    throw new TypeError(`Relationship event already exists: ${eventId}`);\n  if (\n    input.action !== \"add\" &&\n    input.action !== \"remove\" &&\n    input.action !== \"supersede\"\n  )\n    throw new TypeError(`Unknown relationship event action: ${input.action}`);\n  if (!Number.isFinite(Date.parse(input.timestamp)))\n    throw new TypeError(\"Relationship event timestamp must be valid\");\n  return {\n    eventId,\n    relationshipId: requiredText(input.relationshipId, \"relationshipId\"),\n    author: requiredText(input.author, \"author\"),\n    timestamp: new Date(input.timestamp).toISOString(),\n  };\n}\n\nfunction resolveMutationEdge(\n  input: RelationshipEventInput,\n  relationshipId: string,\n  active: ReadonlyMap<string, RelationshipEdge>,\n  nodes: ReadonlySet<string>,\n  registry: RelationshipKindRegistry,\n  indexes: RelationshipCardinalityIndexes,\n): RelationshipEdge | undefined {\n  const isActive = active.has(relationshipId);\n  if (input.action === \"add\" && isActive)\n    throw new TypeError(`Relationship is already active: ${relationshipId}`);\n  if (input.action !== \"add\" && !isActive)\n    throw new TypeError(`Relationship is not active: ${relationshipId}`);\n  if (input.action === \"remove\") return undefined;\n  if (!input.edge)\n    throw new TypeError(`Relationship ${input.action} event requires an edge`);\n  const source =\n    typeof input.edge.source === \"string\" ? input.edge.source.trim() : \"\";\n  const target =\n    typeof input.edge.target === \"string\" ? input.edge.target.trim() : \"\";\n  if (!nodes.has(source) || !nodes.has(target))\n    throw new TypeError(\n      `Relationship endpoint not found: ${source} -> ${target}`,\n    );\n  const canonical = new RelationshipGraph(\n    [source, target],\n    [input.edge],\n    registry,\n  ).edges()[0]!;\n  assertCardinality(canonical, relationshipId, registry, indexes);\n  return freezeEdge(canonical);\n}\n\n/**\n * Append-only in-memory reference ledger. Durable adapters can persist the\n * returned immutable events while reusing the same replay and validation model.\n */\nexport class RelationshipEventLog {\n  readonly #nodes: ReadonlySet<string>;\n  readonly #registry: RelationshipKindRegistry;\n  readonly #events: RelationshipEvent[] = [];\n  readonly #eventIds = new Set<string>();\n  readonly #active = new Map<string, RelationshipEdge>();\n  readonly #cardinalityIndexes: RelationshipCardinalityIndexes = {\n    identities: new Map(),\n    outgoingOne: new Map(),\n    incomingOne: new Map(),\n  };\n\n  /** Create an empty relationship ledger for a fixed node universe. */\n  public constructor(\n    nodes: Iterable<string>,\n    options: RelationshipEventLogOptions = {},\n  ) {\n    this.#nodes = new Set(\n      [...nodes]\n        .filter((node): node is string => typeof node === \"string\")\n        .map((node) => node.trim())\n        .filter(Boolean),\n    );\n    this.#registry = options.registry ?? createRelationshipKindRegistry();\n  }\n\n  /** Current append sequence. */\n  public get version(): number {\n    return this.#events.length;\n  }\n\n  /** Return an immutable copy of the full event stream. */\n  public events(): readonly RelationshipEvent[] {\n    return Object.freeze([...this.#events]);\n  }\n\n  /**\n   * Iterate a stable event prefix in immutable, bounded batches. Consumers can\n   * build streaming projections without copying or exposing the mutable ledger.\n   * `fromVersion === toVersion + 1` is the intentional empty checkpoint range;\n   * larger watermarks are rejected as invalid for the selected prefix.\n   */\n  public *stream(\n    options: RelationshipEventStreamOptions = {},\n  ): Generator<readonly RelationshipEvent[]> {\n    const fromVersion = options.fromVersion ?? 1;\n    const toVersion = options.toVersion ?? this.version;\n    const batchSize = options.batchSize ?? 100;\n    if (!Number.isInteger(fromVersion) || fromVersion < 1)\n      throw new TypeError(\n        \"Relationship event stream fromVersion must be positive\",\n      );\n    if (\n      !Number.isInteger(toVersion) ||\n      toVersion < 0 ||\n      toVersion > this.version\n    )\n      throw new TypeError(\n        `Relationship event stream toVersion out of range: ${toVersion}`,\n      );\n    if (!Number.isInteger(batchSize) || batchSize < 1)\n      throw new TypeError(\n        \"Relationship event stream batchSize must be positive\",\n      );\n    if (fromVersion > toVersion + 1)\n      throw new TypeError(\n        \"Relationship event stream fromVersion exceeds the selected prefix\",\n      );\n    for (let offset = fromVersion - 1; offset < toVersion; offset += batchSize) {\n      yield Object.freeze(\n        this.#events.slice(offset, Math.min(offset + batchSize, toVersion)),\n      );\n    }\n  }\n\n  /** Fold a selected immutable event prefix into caller-owned domain state. */\n  public project<State>(\n    initialState: State,\n    reducer: RelationshipEventReducer<State>,\n    options: Omit<RelationshipEventStreamOptions, \"batchSize\"> = {},\n  ): RelationshipEventProjection<State> {\n    if (typeof reducer !== \"function\")\n      throw new TypeError(\"Relationship event projection requires a reducer\");\n    let state = initialState;\n    let processed = 0;\n    let finalEvent: RelationshipEvent | undefined;\n    for (const batch of this.stream({ ...options, batchSize: 256 })) {\n      for (const event of batch) {\n        state = reducer(state, event);\n        processed += 1;\n        finalEvent = event;\n      }\n    }\n    return Object.freeze({\n      state,\n      version: finalEvent?.sequence ?? Math.max(0, (options.fromVersion ?? 1) - 1),\n      processed,\n      ...(finalEvent === undefined ? {} : { asOf: finalEvent.timestamp }),\n    });\n  }\n\n  /** Add one active relationship to constant-time validation indexes. */\n  #indexActive(relationshipId: string, edge: RelationshipEdge): void {\n    const definition = this.#registry.require(edge.kind);\n    this.#cardinalityIndexes.identities.set(\n      edgeIdentity(edge, this.#registry),\n      relationshipId,\n    );\n    if (definition.outgoing === \"one\")\n      this.#cardinalityIndexes.outgoingOne.set(\n        `${definition.kind}\\u0000${edge.source}`,\n        relationshipId,\n      );\n    if (definition.incoming === \"one\")\n      this.#cardinalityIndexes.incomingOne.set(\n        `${definition.kind}\\u0000${edge.target}`,\n        relationshipId,\n      );\n  }\n\n  /** Remove one superseded or deleted relationship from validation indexes. */\n  #unindexActive(edge: RelationshipEdge): void {\n    const definition = this.#registry.require(edge.kind);\n    this.#cardinalityIndexes.identities.delete(\n      edgeIdentity(edge, this.#registry),\n    );\n    if (definition.outgoing === \"one\")\n      this.#cardinalityIndexes.outgoingOne.delete(\n        `${definition.kind}\\u0000${edge.source}`,\n      );\n    if (definition.incoming === \"one\")\n      this.#cardinalityIndexes.incomingOne.delete(\n        `${definition.kind}\\u0000${edge.target}`,\n      );\n  }\n\n  /** Validate and append one attributable relationship mutation. */\n  public append(input: RelationshipEventInput): RelationshipEvent {\n    const header = normalizeEventHeader(input, this.version, this.#eventIds);\n    const previous = this.#active.get(header.relationshipId);\n    const edge = resolveMutationEdge(\n      input,\n      header.relationshipId,\n      this.#active,\n      this.#nodes,\n      this.#registry,\n      this.#cardinalityIndexes,\n    );\n\n    const event = Object.freeze({\n      eventId: header.eventId,\n      relationshipId: header.relationshipId,\n      action: input.action,\n      ...(edge === undefined ? {} : { edge }),\n      author: header.author,\n      timestamp: header.timestamp,\n      ...(input.reason?.trim() ? { reason: input.reason.trim() } : {}),\n      sequence: this.version + 1,\n    }) satisfies RelationshipEvent;\n    this.#events.push(event);\n    this.#eventIds.add(header.eventId);\n    if (previous) this.#unindexActive(previous);\n    if (input.action === \"remove\") this.#active.delete(header.relationshipId);\n    else {\n      this.#active.set(header.relationshipId, edge!);\n      this.#indexActive(header.relationshipId, edge!);\n    }\n    return event;\n  }\n\n  /** Materialize an exact point-in-time graph without mutating the ledger. */\n  public snapshot(\n    options: {\n      atVersion?: number;\n      atTimestamp?: string;\n    } = {},\n  ): RelationshipSnapshot {\n    if (options.atVersion !== undefined && options.atTimestamp !== undefined)\n      throw new TypeError(\"Relationship snapshot accepts one target\");\n    let included: RelationshipEvent[];\n    if (options.atTimestamp !== undefined) {\n      const timestamp = Date.parse(options.atTimestamp);\n      if (!Number.isFinite(timestamp))\n        throw new TypeError(\"Relationship snapshot timestamp must be valid\");\n      let lastIndex = -1;\n      for (let index = this.#events.length - 1; index >= 0; index -= 1) {\n        if (Date.parse(this.#events[index]!.timestamp) > timestamp) continue;\n        lastIndex = index;\n        break;\n      }\n      included = lastIndex === -1 ? [] : this.#events.slice(0, lastIndex + 1);\n    } else {\n      const version = options.atVersion ?? this.version;\n      if (!Number.isInteger(version) || version < 0 || version > this.version)\n        throw new TypeError(\n          `Relationship snapshot version out of range: ${version}`,\n        );\n      included = this.#events.slice(0, version);\n    }\n    const active = replayEvents(included);\n    const graph = new RelationshipGraph(\n      this.#nodes,\n      active.values(),\n      this.#registry,\n    );\n    return Object.freeze({\n      version: included.length,\n      ...(included.at(-1) ? { asOf: included.at(-1)!.timestamp } : {}),\n      edges: graph.edges(),\n      graph,\n    });\n  }\n\n  /** Page the immutable event stream with a cursor bound to this log version. */\n  public page(options: {\n    limit: number;\n    cursor?: string;\n  }): RelationshipEventPage {\n    if (!Number.isInteger(options.limit) || options.limit < 1)\n      throw new TypeError(\"Relationship event page limit must be positive\");\n    const fingerprint = createQueryFingerprint(\"relationship-events\", {\n      order: \"append-sequence\",\n    });\n    const snapshot =\n      options.cursor === undefined\n        ? this.version\n        : Number(decodeQueryCursorState(options.cursor, fingerprint).snapshot);\n    if (\n      !Number.isSafeInteger(snapshot) ||\n      snapshot < 0 ||\n      snapshot > this.version\n    )\n      throw new TypeError(\n        \"Relationship event cursor snapshot version is invalid\",\n      );\n    const page = paginateQueryRows(this.#events.slice(0, snapshot), {\n      cursor: options.cursor,\n      fingerprint,\n      limit: options.limit,\n      readId: (event) => event.eventId,\n      snapshot: String(snapshot),\n    });\n    return {\n      version: snapshot,\n      events: page.rows,\n      hasMore: page.has_more,\n      ...(page.next_cursor ? { nextCursor: page.next_cursor } : {}),\n    };\n  }\n}\n\nconst RELATIONSHIP_STORE_LOCK_ID = \"relationship-event-store\";\nconst RELATIONSHIP_NOFOLLOW_FLAG = constants.O_NOFOLLOW;\n\nfunction acquireRelationshipStoreLock(\n  pmRoot: string,\n): Promise<() => Promise<void>> {\n  return acquireLock(\n    pmRoot,\n    RELATIONSHIP_STORE_LOCK_ID,\n    30,\n    `relationship-store:${process.pid}`,\n    false,\n    false,\n    3_000,\n  );\n}\n\nasync function resolveRelationshipEventStorePath(\n  pmRoot: string,\n  relativePath = \"relationships/events.jsonl\",\n): Promise<string> {\n  const root = path.resolve(pmRoot);\n  const target = path.resolve(root, relativePath);\n  const relative = path.relative(root, target);\n  if (relative.length === 0)\n    throw new TypeError(\n      \"Relationship event path must name a file within the tracker root\",\n    );\n  if (\n    relative === \"..\" ||\n    relative.startsWith(`..${path.sep}`) ||\n    path.isAbsolute(relative)\n  )\n    throw new TypeError(\n      \"Relationship event path must stay within the tracker root\",\n    );\n  await mkdir(root, { recursive: true });\n  const rootStats = await lstat(root);\n  if (rootStats.isSymbolicLink())\n    throw new TypeError(\n      \"Relationship event tracker root must not be a symbolic link\",\n    );\n  let current = root;\n  for (const segment of relative.split(path.sep)) {\n    current = path.join(current, segment);\n    try {\n      if ((await lstat(current)).isSymbolicLink())\n        throw new TypeError(\n          \"Relationship event path must not contain symbolic links\",\n        );\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === \"ENOENT\") break;\n      throw error;\n    }\n  }\n  return target;\n}\n\nasync function loadRelationshipEventLog(\n  target: string,\n  nodes: readonly string[],\n  registry: RelationshipKindRegistry | undefined,\n): Promise<{ log: RelationshipEventLog; raw: string }> {\n  const log = new RelationshipEventLog(nodes, { registry });\n  let raw: string;\n  let handle: FileHandle | undefined;\n  try {\n    handle = await open(\n      target,\n      constants.O_RDONLY | RELATIONSHIP_NOFOLLOW_FLAG,\n    );\n    raw = await handle.readFile(\"utf8\");\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\")\n      return { log, raw: \"\" };\n    throw error;\n  } finally {\n    await handle?.close();\n  }\n  const lines = raw.split(\"\\n\");\n  for (let index = 0; index < lines.length; index += 1) {\n    const line = lines[index]!.trim();\n    if (!line) continue;\n    let stored: RelationshipEvent;\n    try {\n      stored = JSON.parse(line) as RelationshipEvent;\n    } catch {\n      throw new TypeError(\n        `Invalid relationship event JSONL at line ${index + 1}`,\n      );\n    }\n    if (stored.sequence !== log.version + 1)\n      throw new TypeError(\n        `Invalid relationship event sequence at line ${index + 1}`,\n      );\n    log.append({\n      eventId: stored.eventId,\n      relationshipId: stored.relationshipId,\n      action: stored.action,\n      ...(stored.edge === undefined ? {} : { edge: stored.edge }),\n      author: stored.author,\n      timestamp: stored.timestamp,\n      ...(stored.reason === undefined ? {} : { reason: stored.reason }),\n      expectedVersion: log.version,\n    });\n  }\n  return { log, raw };\n}\n\n/** Return whether an existing immutable event exactly represents one input. */\nfunction relationshipEventMatchesInput(\n  event: RelationshipEvent,\n  input: RelationshipEventInput,\n  nodes: readonly string[],\n  registry: RelationshipKindRegistry | undefined,\n): boolean {\n  const timestamp = Date.parse(input.timestamp);\n  let edge: RelationshipEdge | undefined;\n  if (input.action !== \"remove\" && input.edge !== undefined)\n    edge = new RelationshipGraph(nodes, [input.edge], registry).edges()[0];\n  return (\n    event.eventId === input.eventId.trim() &&\n    event.relationshipId === input.relationshipId.trim() &&\n    event.action === input.action &&\n    event.author === input.author.trim() &&\n    Number.isFinite(timestamp) &&\n    event.timestamp === new Date(timestamp).toISOString() &&\n    event.reason === (input.reason?.trim() || undefined) &&\n    stableStringify(event.edge) === stableStringify(edge)\n  );\n}\n\n/**\n * Lock-serialized durable JSONL adapter for {@link RelationshipEventLog}.\n * Every append replays the current stream while holding the workspace lock, so\n * independent processes share optimistic versions without lost updates.\n */\nexport class RelationshipEventStore {\n  readonly #pmRoot: string;\n  readonly #nodes: readonly string[];\n  readonly #registry: RelationshipKindRegistry | undefined;\n  readonly #path: string;\n  #log: RelationshipEventLog;\n\n  private constructor(\n    options: RelationshipEventStoreOptions,\n    nodes: readonly string[],\n    target: string,\n    log: RelationshipEventLog,\n  ) {\n    this.#pmRoot = options.pmRoot;\n    this.#nodes = nodes;\n    this.#registry = options.registry;\n    this.#path = target;\n    this.#log = log;\n  }\n\n  /** Open and validate an existing stream or create an empty store view. */\n  public static async open(\n    options: RelationshipEventStoreOptions,\n  ): Promise<RelationshipEventStore> {\n    const nodes = Object.freeze([...options.nodes]);\n    const target = await resolveRelationshipEventStorePath(\n      options.pmRoot,\n      options.relativePath,\n    );\n    const release = await acquireRelationshipStoreLock(options.pmRoot);\n    try {\n      await resolveRelationshipEventStorePath(options.pmRoot, target);\n      const { log } = await loadRelationshipEventLog(\n        target,\n        nodes,\n        options.registry,\n      );\n      return new RelationshipEventStore(options, nodes, target, log);\n    } finally {\n      await release();\n    }\n  }\n\n  /** Absolute JSONL path, exposed for diagnostics and backup tooling. */\n  public get path(): string {\n    return this.#path;\n  }\n\n  /** Refresh from durable history and return the current validated append sequence. */\n  public async currentVersion(): Promise<number> {\n    this.#log = await this.#refreshFromDurableHistory();\n    return this.#log.version;\n  }\n\n  /** Append one event after refreshing under the shared workspace lock. */\n  public async append(\n    input: RelationshipEventInput,\n  ): Promise<RelationshipEvent> {\n    const release = await acquireRelationshipStoreLock(this.#pmRoot);\n    try {\n      const target = await resolveRelationshipEventStorePath(\n        this.#pmRoot,\n        this.#path,\n      );\n      const { log: refreshed } = await loadRelationshipEventLog(\n        target,\n        this.#nodes,\n        this.#registry,\n      );\n      const event = refreshed.append(input);\n      await mkdir(path.dirname(target), { recursive: true });\n      await resolveRelationshipEventStorePath(this.#pmRoot, target);\n      const handle = await open(\n        target,\n        constants.O_APPEND |\n          constants.O_CREAT |\n          constants.O_WRONLY |\n          RELATIONSHIP_NOFOLLOW_FLAG,\n      );\n      try {\n        await handle.appendFile(`${JSON.stringify(event)}\\n`, \"utf8\");\n      } finally {\n        await handle.close();\n      }\n      this.#log = refreshed;\n      return event;\n    } finally {\n      await release();\n    }\n  }\n\n  /**\n   * Validate and publish a relationship-event batch as one durable replacement.\n   * The shared writer lock covers refresh, collision checks, full in-memory\n   * validation, and atomic rename. A validation or filesystem failure therefore\n   * leaves the previous JSONL stream byte-for-byte unchanged. This path is\n   * intended for migrations and bulk imports; latency-sensitive single events\n   * should continue to use {@link append} and its O_APPEND write.\n   */\n  public async appendBatch(\n    inputs: readonly RelationshipEventInput[],\n    options: RelationshipEventBatchOptions = {},\n  ): Promise<RelationshipEventBatchResult> {\n    const release = await acquireRelationshipStoreLock(this.#pmRoot);\n    try {\n      const target = await resolveRelationshipEventStorePath(\n        this.#pmRoot,\n        this.#path,\n      );\n      const { log: refreshed, raw } = await loadRelationshipEventLog(\n        target,\n        this.#nodes,\n        this.#registry,\n      );\n      const versionBefore = refreshed.version;\n      const existing = new Map(\n        refreshed.events().map((event) => [event.eventId, event]),\n      );\n      const appended: RelationshipEvent[] = [];\n      const skippedEventIds: string[] = [];\n      for (const input of inputs) {\n        const eventId = input.eventId.trim();\n        const stored = existing.get(eventId);\n        if (stored !== undefined) {\n          if (\n            options.existingEventPolicy === \"skip_identical\" &&\n            relationshipEventMatchesInput(\n              stored,\n              input,\n              this.#nodes,\n              this.#registry,\n            )\n          ) {\n            skippedEventIds.push(stored.eventId);\n            continue;\n          }\n          if (options.existingEventPolicy === \"skip_identical\")\n            throw new TypeError(\n              `Relationship event id collision with different content: ${eventId}`,\n            );\n        }\n        const event = refreshed.append(input);\n        existing.set(event.eventId, event);\n        appended.push(event);\n      }\n      if (appended.length > 0) {\n        const prefix = raw.length === 0 || raw.endsWith(\"\\n\") ? raw : `${raw}\\n`;\n        await mkdir(path.dirname(target), { recursive: true });\n        await resolveRelationshipEventStorePath(this.#pmRoot, target);\n        await writeFileAtomic(\n          target,\n          `${prefix}${appended.map((event) => JSON.stringify(event)).join(\"\\n\")}\\n`,\n        );\n      }\n      this.#log = refreshed;\n      return Object.freeze({\n        version_before: versionBefore,\n        version_after: refreshed.version,\n        appended: Object.freeze(appended),\n        skipped_event_ids: Object.freeze(skippedEventIds),\n      });\n    } finally {\n      await release();\n    }\n  }\n\n  /** Refresh from durable history and materialize an exact validated snapshot. */\n  public async snapshot(\n    options: Parameters<RelationshipEventLog[\"snapshot\"]>[0] = {},\n  ): Promise<RelationshipSnapshot> {\n    this.#log = await this.#refreshFromDurableHistory();\n    return this.#log.snapshot(options);\n  }\n\n  /** Refresh from durable history and page immutable events. */\n  public async page(\n    options: Parameters<RelationshipEventLog[\"page\"]>[0],\n  ): Promise<RelationshipEventPage> {\n    this.#log = await this.#refreshFromDurableHistory();\n    return this.#log.page(options);\n  }\n\n  /**\n   * Refresh once under the shared store lock, then stream a coherent immutable\n   * prefix without holding the writer lock while the consumer processes batches.\n   */\n  public async *stream(\n    options: RelationshipEventStreamOptions = {},\n  ): AsyncGenerator<readonly RelationshipEvent[]> {\n    this.#log = await this.#refreshFromDurableHistory();\n    yield* this.#log.stream(options);\n  }\n\n  /** Refresh once and fold a coherent durable prefix into application state. */\n  public async project<State>(\n    initialState: State,\n    reducer: RelationshipEventReducer<State>,\n    options: Omit<RelationshipEventStreamOptions, \"batchSize\"> = {},\n  ): Promise<RelationshipEventProjection<State>> {\n    this.#log = await this.#refreshFromDurableHistory();\n    return this.#log.project(initialState, reducer, options);\n  }\n\n  /** Serialize a durable refresh with writers so readers never observe a torn JSONL tail. */\n  async #refreshFromDurableHistory(): Promise<RelationshipEventLog> {\n    const release = await acquireRelationshipStoreLock(this.#pmRoot);\n    try {\n      const target = await resolveRelationshipEventStorePath(\n        this.#pmRoot,\n        this.#path,\n      );\n      return (\n        await loadRelationshipEventLog(\n          target,\n          this.#nodes,\n          this.#registry,\n        )\n      ).log;\n    } finally {\n      await release();\n    }\n  }\n}\n"],"names":[],"mappings":"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","debugId":"c2ea8300-fc2a-5562-ba56-f5364990f479"}

package/dist/sdk/relationship-migration.d.ts

@@ -0,0 +1,42 @@
+import { type WorkspaceRelationshipItem } from "./graph/assembly.js";
+import type { RelationshipEventInput } from "./relationship-history.js";
+import type { RelationshipKindRegistry } from "./relationships.js";
+/** Controls for deterministic legacy relationship-event planning. */
+export interface RelationshipEventBackfillOptions {
+    /** Stable migration identity retained in generated event and relationship ids. */
+    migrationId: string;
+    /** Attributable actor responsible for the migration. */
+    author: string;
+    /** Valid event timestamp shared by the deterministic migration batch. */
+    timestamp: string;
+    /** Optional custom relationship ontology used during legacy normalization. */
+    registry?: RelationshipKindRegistry;
+    /** Event ids already committed by an earlier partial or concurrent run. */
+    existingEventIds?: Iterable<string>;
+}
+/** Deterministic migration plan plus compact governance evidence. */
+export interface RelationshipEventBackfillPlan {
+    /** Caller-provided stable migration identity. */
+    migration_id: string;
+    /** SHA-256 identity of the complete normalized plan before resume filtering. */
+    fingerprint: string;
+    /** Fixed node universe required when opening a relationship event store. */
+    nodes: readonly string[];
+    /** Missing deterministic events that remain to be committed. */
+    events: readonly RelationshipEventInput[];
+    /** Total unique normalized edges represented by the complete plan. */
+    edge_count: number;
+    /** Events omitted because their deterministic ids already exist. */
+    skipped_existing_count: number;
+    /** Duplicate raw dependency identities found before graph deduplication. */
+    duplicate_dependency_rows: number;
+    /** Missing internal references retained as explicit placeholder nodes. */
+    dangling_reference_count: number;
+}
+/**
+ * Convert legacy item relationship fields into an immutable deterministic event
+ * batch. Input order does not affect ids, fingerprints, or event order.
+ * Dangling internal targets and external dependency targets become explicit
+ * nodes so replay never silently drops contextual edges.
+ */
+export declare function planRelationshipEventBackfill(items: readonly WorkspaceRelationshipItem[], options: RelationshipEventBackfillOptions): RelationshipEventBackfillPlan;

package/dist/sdk/relationship-migration.js

@@ -0,0 +1,78 @@
+/**
+ * @module sdk/relationship-migration
+ *
+ * Plans deterministic, resumable migration of legacy item hierarchy and
+ * dependency fields into the immutable relationship-event platform. Planning
+ * is storage-independent and side-effect free: callers can inspect governance
+ * evidence, persist the event batch through {@link RelationshipEventStore}, or
+ * feed the same plan into another conforming durable adapter.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="f9779cc4-d1b9-5b9c-ad7c-69d125261898")}catch(e){}}();
+import { createHash } from "node:crypto";
+import { assembleWorkspaceRelationshipGraph, } from "./graph/assembly.js";
+/** Validate and normalize one required migration text field. */
+function requiredMigrationText(value, field) {
+    if (typeof value !== "string" || value.trim().length === 0)
+        throw new TypeError(`Relationship backfill ${field} must be non-empty`);
+    return value.trim();
+}
+/**
+ * Convert legacy item relationship fields into an immutable deterministic event
+ * batch. Input order does not affect ids, fingerprints, or event order.
+ * Dangling internal targets and external dependency targets become explicit
+ * nodes so replay never silently drops contextual edges.
+ */
+export function planRelationshipEventBackfill(items, options) {
+    const migrationId = requiredMigrationText(options.migrationId, "migrationId");
+    const author = requiredMigrationText(options.author, "author");
+    const parsedTimestamp = Date.parse(options.timestamp);
+    if (!Number.isFinite(parsedTimestamp))
+        throw new TypeError("Relationship backfill timestamp must be valid");
+    const timestamp = new Date(parsedTimestamp).toISOString();
+    const assembly = assembleWorkspaceRelationshipGraph(items, undefined, options.registry);
+    const nodes = assembly.graph.nodes();
+    const completeEvents = assembly.graph.edges().map((edge) => {
+        const digest = createHash("sha256")
+            .update(JSON.stringify([
+            migrationId,
+            edge.kind,
+            edge.source,
+            edge.target,
+            edge.createdAt ?? null,
+            edge.author ?? null,
+            edge.payload ?? null,
+        ]))
+            .digest("hex")
+            .slice(0, 24);
+        return Object.freeze({
+            eventId: `backfill:${migrationId}:${digest}`,
+            relationshipId: `migration:${migrationId}:${digest}`,
+            action: "add",
+            edge,
+            author,
+            timestamp,
+            reason: `Backfill ${migrationId} from legacy item metadata`,
+        });
+    });
+    const fingerprint = createHash("sha256")
+        .update(JSON.stringify({ migrationId, nodes, events: completeEvents }))
+        .digest("hex");
+    const existingEventIds = new Set([...(options.existingEventIds ?? [])]
+        .filter((id) => typeof id === "string")
+        .map((id) => id.trim())
+        .filter(Boolean));
+    const events = completeEvents.filter((event) => !existingEventIds.has(event.eventId));
+    return Object.freeze({
+        migration_id: migrationId,
+        fingerprint,
+        nodes,
+        events: Object.freeze(events),
+        edge_count: completeEvents.length,
+        skipped_existing_count: completeEvents.length - events.length,
+        duplicate_dependency_rows: assembly.duplicateRows.length,
+        dangling_reference_count: assembly.dangling.active.length + assembly.dangling.legacy_terminal.length,
+    });
+}
+//# sourceMappingURL=relationship-migration.js.map
+//# debugId=f9779cc4-d1b9-5b9c-ad7c-69d125261898

package/dist/sdk/relationship-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relationship-migration.js","sources":["sdk/relationship-migration.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/relationship-migration\n *\n * Plans deterministic, resumable migration of legacy item hierarchy and\n * dependency fields into the immutable relationship-event platform. Planning\n * is storage-independent and side-effect free: callers can inspect governance\n * evidence, persist the event batch through {@link RelationshipEventStore}, or\n * feed the same plan into another conforming durable adapter.\n */\nimport { createHash } from \"node:crypto\";\nimport {\n  assembleWorkspaceRelationshipGraph,\n  type WorkspaceRelationshipItem,\n} from \"./graph/assembly.js\";\nimport type { RelationshipEventInput } from \"./relationship-history.js\";\nimport type { RelationshipKindRegistry } from \"./relationships.js\";\n\n/** Controls for deterministic legacy relationship-event planning. */\nexport interface RelationshipEventBackfillOptions {\n  /** Stable migration identity retained in generated event and relationship ids. */\n  migrationId: string;\n  /** Attributable actor responsible for the migration. */\n  author: string;\n  /** Valid event timestamp shared by the deterministic migration batch. */\n  timestamp: string;\n  /** Optional custom relationship ontology used during legacy normalization. */\n  registry?: RelationshipKindRegistry;\n  /** Event ids already committed by an earlier partial or concurrent run. */\n  existingEventIds?: Iterable<string>;\n}\n\n/** Deterministic migration plan plus compact governance evidence. */\nexport interface RelationshipEventBackfillPlan {\n  /** Caller-provided stable migration identity. */\n  migration_id: string;\n  /** SHA-256 identity of the complete normalized plan before resume filtering. */\n  fingerprint: string;\n  /** Fixed node universe required when opening a relationship event store. */\n  nodes: readonly string[];\n  /** Missing deterministic events that remain to be committed. */\n  events: readonly RelationshipEventInput[];\n  /** Total unique normalized edges represented by the complete plan. */\n  edge_count: number;\n  /** Events omitted because their deterministic ids already exist. */\n  skipped_existing_count: number;\n  /** Duplicate raw dependency identities found before graph deduplication. */\n  duplicate_dependency_rows: number;\n  /** Missing internal references retained as explicit placeholder nodes. */\n  dangling_reference_count: number;\n}\n\n/** Validate and normalize one required migration text field. */\nfunction requiredMigrationText(value: unknown, field: string): string {\n  if (typeof value !== \"string\" || value.trim().length === 0)\n    throw new TypeError(`Relationship backfill ${field} must be non-empty`);\n  return value.trim();\n}\n\n/**\n * Convert legacy item relationship fields into an immutable deterministic event\n * batch. Input order does not affect ids, fingerprints, or event order.\n * Dangling internal targets and external dependency targets become explicit\n * nodes so replay never silently drops contextual edges.\n */\nexport function planRelationshipEventBackfill(\n  items: readonly WorkspaceRelationshipItem[],\n  options: RelationshipEventBackfillOptions,\n): RelationshipEventBackfillPlan {\n  const migrationId = requiredMigrationText(options.migrationId, \"migrationId\");\n  const author = requiredMigrationText(options.author, \"author\");\n  const parsedTimestamp = Date.parse(options.timestamp);\n  if (!Number.isFinite(parsedTimestamp))\n    throw new TypeError(\"Relationship backfill timestamp must be valid\");\n  const timestamp = new Date(parsedTimestamp).toISOString();\n  const assembly = assembleWorkspaceRelationshipGraph(\n    items,\n    undefined,\n    options.registry,\n  );\n  const nodes = assembly.graph.nodes();\n  const completeEvents = assembly.graph.edges().map((edge) => {\n    const digest = createHash(\"sha256\")\n      .update(\n        JSON.stringify([\n          migrationId,\n          edge.kind,\n          edge.source,\n          edge.target,\n          edge.createdAt ?? null,\n          edge.author ?? null,\n          edge.payload ?? null,\n        ]),\n      )\n      .digest(\"hex\")\n      .slice(0, 24);\n    return Object.freeze({\n      eventId: `backfill:${migrationId}:${digest}`,\n      relationshipId: `migration:${migrationId}:${digest}`,\n      action: \"add\" as const,\n      edge,\n      author,\n      timestamp,\n      reason: `Backfill ${migrationId} from legacy item metadata`,\n    });\n  });\n  const fingerprint = createHash(\"sha256\")\n    .update(JSON.stringify({ migrationId, nodes, events: completeEvents }))\n    .digest(\"hex\");\n  const existingEventIds = new Set(\n    [...(options.existingEventIds ?? [])]\n      .filter((id): id is string => typeof id === \"string\")\n      .map((id) => id.trim())\n      .filter(Boolean),\n  );\n  const events = completeEvents.filter(\n    (event) => !existingEventIds.has(event.eventId),\n  );\n  return Object.freeze({\n    migration_id: migrationId,\n    fingerprint,\n    nodes,\n    events: Object.freeze(events),\n    edge_count: completeEvents.length,\n    skipped_existing_count: completeEvents.length - events.length,\n    duplicate_dependency_rows: assembly.duplicateRows.length,\n    dangling_reference_count:\n      assembly.dangling.active.length + assembly.dangling.legacy_terminal.length,\n  });\n}\n"],"names":[],"mappings":"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","debugId":"f9779cc4-d1b9-5b9c-ad7c-69d125261898"}

package/dist/sdk/structured-mutations.js

@@ -5,8 +5,8 @@
  * transaction contract and normalizes full item documents for CLI round trips.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="916a227a-1ec9-5af6-9b71-e871af2d7f0c")}catch(e){}}();
-import { EXIT_CODE } from "../core/shared/constants.js";
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d482b64e-460e-515c-9dcd-43c6210167d2")}catch(e){}}();
+import { EXIT_CODE, ITEM_PROJECT_CONTEXT_KEYS, } from "../core/shared/constants.js";
 import { PmCliError } from "../core/shared/errors.js";
 import { levenshteinDistanceWithinLimit } from "../core/shared/levenshtein.js";
 import { CLOSE_FLAG_CONTRACTS } from "./cli-contracts/flag-contracts.js";
@@ -44,29 +44,8 @@ const ITEM_FIELD_KEYS = new Set([
     "definition_of_ready",
     "order",
     "rank",
-    "goal",
-    "objective",
-    "value",
-    "impact",
-    "outcome",
-    "why_now",
     "assignee",
-    "parent",
-    "reviewer",
-    "risk",
-    "confidence",
-    "sprint",
-    "release",
-    "blocked_by",
-    "blocked_reason",
-    "unblock_note",
-    "reporter",
-    "severity",
-    "environment",
-    "repro_steps",
-    "resolution",
-    "expected_result",
-    "actual_result",
+    ...ITEM_PROJECT_CONTEXT_KEYS,
     "affected_version",
     "fixed_version",
     "component",
@@ -372,4 +351,4 @@ export function validateItemMutationRows(value) {
     return parseItemMutationBatch(JSON.stringify(value));
 }
 //# sourceMappingURL=structured-mutations.js.map
-//# debugId=916a227a-1ec9-5af6-9b71-e871af2d7f0c
+//# debugId=d482b64e-460e-515c-9dcd-43c6210167d2