@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/relationship-migration.js

@@ -1,78 +1,2 @@
-/**
- * @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]="54a3448c-719c-5404-a9b9-c3072a2fdce2")}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,
-    });
-}
+!(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]="41ef1735-c534-5b84-8367-1278007cb7c6")}catch(e2){}})();import{createHash}from"node:crypto";import{assembleWorkspaceRelationshipGraph}from"./graph/assembly.js";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()}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,void 0,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})}export{planRelationshipEventBackfill};
 //# sourceMappingURL=relationship-migration.js.map
-//# debugId=54a3448c-719c-5404-a9b9-c3072a2fdce2