@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/governance/workspace-position.js

@@ -1,164 +1,2 @@
-/**
- * @module sdk/governance/workspace-position
- *
- * Produces one bounded, read-only workspace readiness answer from merge-fence,
- * merge-receipt, and append-only history evidence.
- */
-
-!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]="e900c117-6d8d-55d3-86df-f543dc499930")}catch(e){}}();
-import { getActiveExtensionRegistrations } from "../../core/extensions/index.js";
-import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
-import { nowIso } from "../../core/shared/time.js";
-import { resolvePmRoot } from "../../core/store/paths.js";
-import { readSettings } from "../../core/store/settings.js";
-import { renderPmCommand } from "../command-line.js";
-import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { auditMergeAttributeFence, auditMergeDriverConfiguration, findGitWorkspaceRoot, resolveProjectMergeTypeFolders, } from "../merge/install.js";
-import { inspectMergeReceiptEvidence, partitionMergeReceipts, } from "../merge/receipts.js";
-import { buildValidateHistoryDriftCheck } from "./validate-history-drift.js";
-import { readValidateItems } from "./validate-item-reader.js";
-function selectWorkspacePositionState(params) {
-    if (params.invalidEvidenceCount > 0)
-        return "merge_evidence_invalid";
-    if (!params.historyEvidenceValid)
-        return "history_evidence_invalid";
-    if (params.pendingDecisionCount > 0 || params.losslessCount > 0) {
-        return "merge_reconciliation_required";
-    }
-    if (params.driftedItemCount > 0)
-        return "history_repair_required";
-    if (params.fence.status !== "ok" ||
-        params.drivers === null ||
-        params.drivers.status !== "ok") {
-        return "merge_fence_unprepared";
-    }
-    return "ready";
-}
-function commandForWorkspacePositionState(state, pmRoot, platform = process.platform) {
-    const commandArgs = ["--pm-path", pmRoot];
-    if (state === "merge_evidence_invalid")
-        return renderPmCommand([...commandArgs, "merge", "report"], platform);
-    if (state === "history_evidence_invalid") {
-        return renderPmCommand([...commandArgs, "validate", "--check-history-drift", "--full"], platform);
-    }
-    if (state === "merge_reconciliation_required") {
-        return renderPmCommand([...commandArgs, "merge", "reconcile"], platform);
-    }
-    if (state === "history_repair_required") {
-        return renderPmCommand([...commandArgs, "history-repair", "--all"], platform);
-    }
-    if (state === "merge_fence_unprepared") {
-        return renderPmCommand([...commandArgs, "merge", "install"], platform);
-    }
-    return null;
-}
-/** Normalize defensive history-check evidence into the bounded position shape. */
-function normalizeWorkspaceHistoryDrift(details) {
-    const driftedItemIds = Array.isArray(details.drifted_items)
-        ? details.drifted_items.filter((entry) => typeof entry === "string")
-        : [];
-    const evidenceValid = Array.isArray(details.drifted_items) &&
-        details.drifted_items.every((entry) => typeof entry === "string") &&
-        typeof details.drifted_items_count === "number" &&
-        Number.isInteger(details.drifted_items_count) &&
-        details.drifted_items_count >= 0 &&
-        typeof details.drifted_items_truncated === "boolean" &&
-        typeof details.counts === "object" &&
-        details.counts !== null &&
-        !Array.isArray(details.counts);
-    return {
-        evidence_valid: evidenceValid,
-        drifted_item_count: typeof details.drifted_items_count === "number"
-            ? details.drifted_items_count
-            : driftedItemIds.length,
-        drifted_item_ids: driftedItemIds,
-        drifted_item_ids_truncated: details.drifted_items_truncated === true,
-        counts: typeof details.counts === "object" && details.counts !== null
-            ? details.counts
-            : {},
-    };
-}
-/** Read aggregate workspace position without flags, session state, or mutation. */
-export async function readWorkspacePosition(global) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertInitializedTracker(pmRoot);
-    const settings = await readSettings(pmRoot);
-    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-    const itemReadWarnings = [];
-    const items = await readValidateItems({
-        includeBody: true,
-        pmRoot,
-        settings,
-        typeToFolder: typeRegistry.type_to_folder,
-        warnings: itemReadWarnings,
-    });
-    const gitWorkspaceRoot = await findGitWorkspaceRoot(pmRoot);
-    const [fence, drivers, receiptEvidence, drift] = await Promise.all([
-        auditMergeAttributeFence(pmRoot, resolveProjectMergeTypeFolders(settings)),
-        gitWorkspaceRoot === null
-            ? Promise.resolve(null)
-            : auditMergeDriverConfiguration(gitWorkspaceRoot),
-        inspectMergeReceiptEvidence(gitWorkspaceRoot ?? pmRoot, {
-            includeLossless: true,
-            pmRoot,
-        }),
-        buildValidateHistoryDriftCheck(pmRoot, items, false),
-    ]);
-    const { pendingDecisions, lossless } = partitionMergeReceipts(receiptEvidence.receipts);
-    const pendingItemIds = [
-        ...new Set(pendingDecisions.map((receipt) => receipt.item_id)),
-    ].sort((left, right) => left.localeCompare(right));
-    const driftDetails = drift.check.details;
-    const historyDrift = normalizeWorkspaceHistoryDrift(driftDetails);
-    const state = selectWorkspacePositionState({
-        invalidEvidenceCount: receiptEvidence.invalid_evidence_count,
-        pendingDecisionCount: pendingDecisions.length,
-        losslessCount: lossless.length,
-        historyEvidenceValid: historyDrift.evidence_valid,
-        driftedItemCount: historyDrift.drifted_item_count,
-        fence,
-        drivers,
-    });
-    return {
-        ok: state === "ready",
-        state,
-        merge_fence: {
-            committed: fence,
-            clone_local_drivers: drivers,
-        },
-        merge_receipts: {
-            pending_decision_count: pendingDecisions.length,
-            pending_item_ids: pendingItemIds.slice(0, 25),
-            pending_item_ids_truncated: pendingItemIds.length > 25,
-            lossless_count: lossless.length,
-            invalid_evidence_count: receiptEvidence.invalid_evidence_count,
-        },
-        history_drift: historyDrift,
-        next_action: {
-            command: commandForWorkspacePositionState(state, pmRoot),
-            reason: state,
-        },
-        warnings: [...new Set(itemReadWarnings)].sort((left, right) => left.localeCompare(right)),
-        generated_at: nowIso(),
-    };
-}
-/** Render the bounded workspace position for human CLI output. */
-export function formatWorkspacePositionHuman(result) {
-    const action = result.next_action.command ?? "none";
-    return [
-        `workspace_position: ${result.state}`,
-        `merge_fence: ${result.merge_fence.committed.status}`,
-        `clone_local_drivers: ${result.merge_fence.clone_local_drivers?.status ?? "unavailable"}`,
-        `pending_merge_decisions: ${result.merge_receipts.pending_decision_count}`,
-        `history_drifted_items: ${result.history_drift.drifted_item_count}`,
-        `next_action: ${action}`,
-    ].join("\n");
-}
-/** Public contract for focused unit verification. */
-export const _testOnlyWorkspacePosition = {
-    commandForWorkspacePositionState,
-    normalizeWorkspaceHistoryDrift,
-    selectWorkspacePositionState,
-};
+!(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]="48abeea1-703c-57e9-9d99-787cb2829efb")}catch(e2){}})();import{getActiveExtensionRegistrations}from"../../core/extensions/index.js";import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{nowIso}from"../../core/shared/time.js";import{resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";import{renderPmCommand}from"../command-line.js";import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{auditMergeAttributeFence,auditMergeDriverConfiguration,findGitWorkspaceRoot,resolveProjectMergeTypeFolders}from"../merge/install.js";import{inspectMergeReceiptEvidence,partitionMergeReceipts}from"../merge/receipts.js";import{buildValidateHistoryDriftCheck}from"./validate-history-drift.js";import{readValidateItems}from"./validate-item-reader.js";function selectWorkspacePositionState(params){if(params.invalidEvidenceCount>0)return"merge_evidence_invalid";if(!params.historyEvidenceValid)return"history_evidence_invalid";if(params.pendingDecisionCount>0||params.losslessCount>0){return"merge_reconciliation_required"}if(params.driftedItemCount>0)return"history_repair_required";if(params.fence.status!=="ok"||params.drivers===null||params.drivers.status!=="ok"){return"merge_fence_unprepared"}return"ready"}function commandForWorkspacePositionState(state,pmRoot,platform=process.platform){const commandArgs=["--pm-path",pmRoot];if(state==="merge_evidence_invalid")return renderPmCommand([...commandArgs,"merge","report"],platform);if(state==="history_evidence_invalid"){return renderPmCommand([...commandArgs,"validate","--check-history-drift","--full"],platform)}if(state==="merge_reconciliation_required"){return renderPmCommand([...commandArgs,"merge","reconcile"],platform)}if(state==="history_repair_required"){return renderPmCommand([...commandArgs,"history-repair","--all"],platform)}if(state==="merge_fence_unprepared"){return renderPmCommand([...commandArgs,"merge","install"],platform)}return null}function normalizeWorkspaceHistoryDrift(details){const driftedItemIds=Array.isArray(details.drifted_items)?details.drifted_items.filter(entry=>typeof entry==="string"):[];const evidenceValid=Array.isArray(details.drifted_items)&&details.drifted_items.every(entry=>typeof entry==="string")&&typeof details.drifted_items_count==="number"&&Number.isInteger(details.drifted_items_count)&&details.drifted_items_count>=0&&typeof details.drifted_items_truncated==="boolean"&&typeof details.counts==="object"&&details.counts!==null&&!Array.isArray(details.counts);return{evidence_valid:evidenceValid,drifted_item_count:typeof details.drifted_items_count==="number"?details.drifted_items_count:driftedItemIds.length,drifted_item_ids:driftedItemIds,drifted_item_ids_truncated:details.drifted_items_truncated===true,counts:typeof details.counts==="object"&&details.counts!==null?details.counts:{}}}async function readWorkspacePosition(global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const itemReadWarnings=[];const items=await readValidateItems({includeBody:true,pmRoot,settings,typeToFolder:typeRegistry.type_to_folder,warnings:itemReadWarnings});const gitWorkspaceRoot=await findGitWorkspaceRoot(pmRoot);const[fence,drivers,receiptEvidence,drift]=await Promise.all([auditMergeAttributeFence(pmRoot,resolveProjectMergeTypeFolders(settings)),gitWorkspaceRoot===null?Promise.resolve(null):auditMergeDriverConfiguration(gitWorkspaceRoot),inspectMergeReceiptEvidence(gitWorkspaceRoot??pmRoot,{includeLossless:true,pmRoot}),buildValidateHistoryDriftCheck(pmRoot,items,false)]);const{pendingDecisions,lossless}=partitionMergeReceipts(receiptEvidence.receipts);const pendingItemIds=[...new Set(pendingDecisions.map(receipt=>receipt.item_id))].sort((left,right)=>left.localeCompare(right));const driftDetails=drift.check.details;const historyDrift=normalizeWorkspaceHistoryDrift(driftDetails);const state=selectWorkspacePositionState({invalidEvidenceCount:receiptEvidence.invalid_evidence_count,pendingDecisionCount:pendingDecisions.length,losslessCount:lossless.length,historyEvidenceValid:historyDrift.evidence_valid,driftedItemCount:historyDrift.drifted_item_count,fence,drivers});return{ok:state==="ready",state,merge_fence:{committed:fence,clone_local_drivers:drivers},merge_receipts:{pending_decision_count:pendingDecisions.length,pending_item_ids:pendingItemIds.slice(0,25),pending_item_ids_truncated:pendingItemIds.length>25,lossless_count:lossless.length,invalid_evidence_count:receiptEvidence.invalid_evidence_count},history_drift:historyDrift,next_action:{command:commandForWorkspacePositionState(state,pmRoot),reason:state},warnings:[...new Set(itemReadWarnings)].sort((left,right)=>left.localeCompare(right)),generated_at:nowIso()}}function formatWorkspacePositionHuman(result){const action=result.next_action.command??"none";return[`workspace_position: ${result.state}`,`merge_fence: ${result.merge_fence.committed.status}`,`clone_local_drivers: ${result.merge_fence.clone_local_drivers?.status??"unavailable"}`,`pending_merge_decisions: ${result.merge_receipts.pending_decision_count}`,`history_drifted_items: ${result.history_drift.drifted_item_count}`,`next_action: ${action}`].join("\n")}const _testOnlyWorkspacePosition={commandForWorkspacePositionState,normalizeWorkspaceHistoryDrift,selectWorkspacePositionState};export{_testOnlyWorkspacePosition,formatWorkspacePositionHuman,readWorkspacePosition};
 //# sourceMappingURL=workspace-position.js.map
-//# debugId=e900c117-6d8d-55d3-86df-f543dc499930

package/dist/sdk/governance.d.ts

@@ -26,3 +26,4 @@ export * from "./author-attribution.js";
 export * from "./mutation-guard.js";
 export * from "./governance/provenance-health.js";
 export * from "./similarity.js";
+export * from "./history/maintenance.js";

package/dist/sdk/governance.js

@@ -1,32 +1,2 @@
-/**
- * @module sdk/governance
- *
- * Provides validation, health, integrity, and mutation-policy primitives.
- */
-
-!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]="5e2aaa83-a109-5e44-b9b3-316501ffadf4")}catch(e){}}();
-export * from "./governance/gc.js";
-export * from "./governance/health.js";
-export * from "./governance/extension-host-version.js";
-export * from "./governance/assurance.js";
-export * from "./governance/assurance-action.js";
-export * from "./governance/assurance-mutation-error.js";
-export * from "./governance/assurance-presets.js";
-export * from "./governance/assurance-runtime.js";
-export * from "./governance/boundary-fixtures.js";
-export * from "./governance/defect-recurrence.js";
-export * from "./governance/defect-recurrence-coverage.js";
-export { runReindex, } from "./governance/reindex.js";
-export * from "./governance/stale-work.js";
-export * from "./governance/storage-integrity.js";
-export * from "./governance/status-role-diagnostics.js";
-export * from "./governance/workspace-position.js";
-export { runUpgrade, } from "./governance/upgrade.js";
-export * from "./governance/validate.js";
-export * from "./governance/linked-file-report.js";
-export * from "./author-attribution.js";
-export * from "./mutation-guard.js";
-export * from "./governance/provenance-health.js";
-export * from "./similarity.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]="067c057c-811b-5708-bbad-bb5c06fe06b1")}catch(e2){}})();export*from"./governance/gc.js";export*from"./governance/health.js";export*from"./governance/extension-host-version.js";export*from"./governance/assurance.js";export*from"./governance/assurance-action.js";export*from"./governance/assurance-mutation-error.js";export*from"./governance/assurance-presets.js";export*from"./governance/assurance-runtime.js";export*from"./governance/boundary-fixtures.js";export*from"./governance/defect-recurrence.js";export*from"./governance/defect-recurrence-coverage.js";import{runReindex}from"./governance/reindex.js";export*from"./governance/stale-work.js";export*from"./governance/storage-integrity.js";export*from"./governance/status-role-diagnostics.js";export*from"./governance/workspace-position.js";import{runUpgrade}from"./governance/upgrade.js";export*from"./governance/validate.js";export*from"./governance/linked-file-report.js";export*from"./author-attribution.js";export*from"./mutation-guard.js";export*from"./governance/provenance-health.js";export*from"./similarity.js";export*from"./history/maintenance.js";export{runReindex,runUpgrade};
 //# sourceMappingURL=governance.js.map
-//# debugId=5e2aaa83-a109-5e44-b9b3-316501ffadf4

package/dist/sdk/graph/adapter.js

@@ -1,182 +1,2 @@
-/**
- * @module sdk/graph/adapter
- *
- * Portable relationship-graph snapshots and a storage-neutral adapter
- * protocol for package-owned databases, replicated logs, and remote graph
- * services. Snapshots are immutable, content-addressed, and validated through
- * the same registry and graph kernel as native pm queries.
- */
-
-!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]="4586a8b2-07c8-53d4-9c5d-ca557ee07977")}catch(e){}}();
-import { createHash } from "node:crypto";
-import { stableStringify } from "../../core/shared/serialization.js";
-import { RelationshipGraph, RelationshipKindRegistry, } from "../relationships.js";
-/** Current portable relationship-graph snapshot format. */
-export const RELATIONSHIP_GRAPH_SNAPSHOT_VERSION = 1;
-/** Throw when cooperative cancellation has already been requested. */
-function throwIfAborted(signal) {
-    signal?.throwIfAborted();
-}
-/** Validate one non-empty adapter/workspace identifier. */
-function requireText(value, field) {
-    if (typeof value !== "string" || value.trim().length === 0)
-        throw new TypeError(`Relationship graph ${field} must be non-empty`);
-    return value.trim();
-}
-/** Build an immutable portable snapshot from a validated graph and registry. */
-export function createRelationshipGraphSnapshot(graph, registry, options = {}) {
-    const parsedTimestamp = Date.parse(options.createdAt ?? new Date().toISOString());
-    if (!Number.isFinite(parsedTimestamp))
-        throw new TypeError("Relationship graph createdAt must be a valid timestamp");
-    const nodes = graph.nodes();
-    const edges = graph.edges();
-    const kinds = registry.list();
-    return Object.freeze({
-        version: RELATIONSHIP_GRAPH_SNAPSHOT_VERSION,
-        fingerprint: createHash("sha256")
-            .update(stableStringify({ nodes, edges, kinds }))
-            .digest("hex"),
-        created_at: new Date(parsedTimestamp).toISOString(),
-        nodes,
-        edges,
-        kinds,
-    });
-}
-/** Return whether a decoded value is a plain property-bearing object. */
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/** Decode and fully validate a portable graph snapshot. */
-export function parseRelationshipGraphSnapshot(value) {
-    if (!isRecord(value))
-        throw new TypeError("Relationship graph snapshot must be an object");
-    if (value.version !== RELATIONSHIP_GRAPH_SNAPSHOT_VERSION)
-        throw new TypeError(`Unsupported relationship graph snapshot version: ${String(value.version)}`);
-    if (!Array.isArray(value.nodes) ||
-        value.nodes.some((id) => typeof id !== "string"))
-        throw new TypeError("Relationship graph snapshot nodes must be strings");
-    if (!Array.isArray(value.edges) || !Array.isArray(value.kinds))
-        throw new TypeError("Relationship graph snapshot edges and kinds must be arrays");
-    if (typeof value.created_at !== "string" ||
-        !Number.isFinite(Date.parse(value.created_at)))
-        throw new TypeError("Relationship graph snapshot created_at must be valid");
-    if (typeof value.fingerprint !== "string")
-        throw new TypeError("Relationship graph snapshot fingerprint must be a string");
-    const registry = new RelationshipKindRegistry([]);
-    for (const definition of value.kinds)
-        registry.register(definition);
-    const graph = new RelationshipGraph(value.nodes, value.edges, registry);
-    const snapshot = createRelationshipGraphSnapshot(graph, registry, {
-        createdAt: value.created_at,
-    });
-    if (snapshot.fingerprint !== value.fingerprint)
-        throw new TypeError("Relationship graph snapshot fingerprint mismatch");
-    return { snapshot, registry, graph };
-}
-/** Read and validate one adapter workspace. */
-export async function loadRelationshipGraphAdapter(adapter, context) {
-    requireText(adapter.name, "adapter name");
-    const workspace = requireText(context.workspace, "workspace");
-    throwIfAborted(context.signal);
-    const value = await adapter.read({ ...context, workspace });
-    throwIfAborted(context.signal);
-    return value === null ? null : parseRelationshipGraphSnapshot(value);
-}
-/**
- * Synchronize a complete graph snapshot with compare-and-swap protection and
- * verify the adapter's visible read after replacement.
- */
-export async function syncRelationshipGraphAdapter(adapter, context) {
-    const workspace = requireText(context.workspace, "workspace");
-    const validated = parseRelationshipGraphSnapshot(context.snapshot).snapshot;
-    const current = await loadRelationshipGraphAdapter(adapter, {
-        workspace,
-        signal: context.signal,
-    });
-    if (current?.snapshot.fingerprint === validated.fingerprint)
-        return {
-            adapter: adapter.name,
-            workspace,
-            disposition: "current",
-            fingerprint: validated.fingerprint,
-            previous_fingerprint: current.snapshot.fingerprint,
-            node_count: validated.nodes.length,
-            edge_count: validated.edges.length,
-        };
-    throwIfAborted(context.signal);
-    await adapter.replace({
-        workspace,
-        signal: context.signal,
-        snapshot: validated,
-        expected_fingerprint: current?.snapshot.fingerprint ?? null,
-    });
-    const visible = await loadRelationshipGraphAdapter(adapter, {
-        workspace,
-        signal: context.signal,
-    });
-    if (visible?.snapshot.fingerprint !== validated.fingerprint)
-        throw new Error(`Relationship graph adapter "${adapter.name}" did not expose the replaced snapshot`);
-    return {
-        adapter: adapter.name,
-        workspace,
-        disposition: "written",
-        fingerprint: validated.fingerprint,
-        ...(current ? { previous_fingerprint: current.snapshot.fingerprint } : {}),
-        node_count: validated.nodes.length,
-        edge_count: validated.edges.length,
-    };
-}
-/** Merge portable snapshots while rejecting semantic kind collisions. */
-export function federateRelationshipGraphSnapshots(values, options = {}) {
-    const loaded = values.map(parseRelationshipGraphSnapshot);
-    const definitions = new Map();
-    for (const entry of loaded) {
-        for (const definition of entry.snapshot.kinds) {
-            const prior = definitions.get(definition.kind);
-            if (prior && stableStringify(prior) !== stableStringify(definition))
-                throw new TypeError(`Conflicting federated relationship kind: ${definition.kind}`);
-            definitions.set(definition.kind, definition);
-        }
-    }
-    const registry = new RelationshipKindRegistry([...definitions.values()].sort((left, right) => left.kind.localeCompare(right.kind)));
-    const graph = new RelationshipGraph(new Set(loaded.flatMap((entry) => [...entry.snapshot.nodes])), loaded.flatMap((entry) => [...entry.snapshot.edges]), registry);
-    return createRelationshipGraphSnapshot(graph, registry, options);
-}
-/** In-memory reference adapter with atomic CAS behavior for tests and packages. */
-export class MemoryRelationshipGraphAdapter {
-    /** Stable adapter identifier used in diagnostics and conformance reports. */
-    name;
-    #snapshots = new Map();
-    /** Create a reference adapter with a stable diagnostic name. */
-    constructor(name = "memory") {
-        this.name = requireText(name, "adapter name");
-    }
-    /** Read an isolated clone of the current workspace snapshot. */
-    async read(context) {
-        throwIfAborted(context.signal);
-        const snapshot = this.#snapshots.get(requireText(context.workspace, "workspace"));
-        return snapshot ? structuredClone(snapshot) : null;
-    }
-    /** Atomically replace one workspace after enforcing its expected fingerprint. */
-    async replace(context) {
-        throwIfAborted(context.signal);
-        const workspace = requireText(context.workspace, "workspace");
-        const current = this.#snapshots.get(workspace);
-        if (context.expected_fingerprint !== undefined &&
-            (current?.fingerprint ?? null) !== context.expected_fingerprint)
-            throw new Error(`Relationship graph adapter conflict for ${workspace}`);
-        this.#snapshots.set(workspace, structuredClone(parseRelationshipGraphSnapshot(context.snapshot).snapshot));
-    }
-    /** Clear one workspace after enforcing its expected fingerprint. */
-    async clear(context) {
-        throwIfAborted(context.signal);
-        const workspace = requireText(context.workspace, "workspace");
-        const current = this.#snapshots.get(workspace);
-        if (context.expected_fingerprint !== undefined &&
-            (current?.fingerprint ?? null) !== context.expected_fingerprint)
-            throw new Error(`Relationship graph adapter conflict for ${workspace}`);
-        this.#snapshots.delete(workspace);
-    }
-}
+!(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]="eb475dcd-d16c-51fb-b248-b14cf5ade4de")}catch(e2){}})();import{createHash}from"node:crypto";import{stableStringify}from"../../core/shared/serialization.js";import{RelationshipGraph,RelationshipKindRegistry}from"../relationships.js";const RELATIONSHIP_GRAPH_SNAPSHOT_VERSION=1;function throwIfAborted(signal){signal?.throwIfAborted()}function requireText(value,field){if(typeof value!=="string"||value.trim().length===0)throw new TypeError(`Relationship graph ${field} must be non-empty`);return value.trim()}function createRelationshipGraphSnapshot(graph,registry,options={}){const parsedTimestamp=Date.parse(options.createdAt??new Date().toISOString());if(!Number.isFinite(parsedTimestamp))throw new TypeError("Relationship graph createdAt must be a valid timestamp");const nodes=graph.nodes();const edges=graph.edges();const kinds=registry.list();return Object.freeze({version:RELATIONSHIP_GRAPH_SNAPSHOT_VERSION,fingerprint:createHash("sha256").update(stableStringify({nodes,edges,kinds})).digest("hex"),created_at:new Date(parsedTimestamp).toISOString(),nodes,edges,kinds})}function isRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}function parseRelationshipGraphSnapshot(value){if(!isRecord(value))throw new TypeError("Relationship graph snapshot must be an object");if(value.version!==RELATIONSHIP_GRAPH_SNAPSHOT_VERSION)throw new TypeError(`Unsupported relationship graph snapshot version: ${String(value.version)}`);if(!Array.isArray(value.nodes)||value.nodes.some(id=>typeof id!=="string"))throw new TypeError("Relationship graph snapshot nodes must be strings");if(!Array.isArray(value.edges)||!Array.isArray(value.kinds))throw new TypeError("Relationship graph snapshot edges and kinds must be arrays");if(typeof value.created_at!=="string"||!Number.isFinite(Date.parse(value.created_at)))throw new TypeError("Relationship graph snapshot created_at must be valid");if(typeof value.fingerprint!=="string")throw new TypeError("Relationship graph snapshot fingerprint must be a string");const registry=new RelationshipKindRegistry([]);for(const definition of value.kinds)registry.register(definition);const graph=new RelationshipGraph(value.nodes,value.edges,registry);const snapshot=createRelationshipGraphSnapshot(graph,registry,{createdAt:value.created_at});if(snapshot.fingerprint!==value.fingerprint)throw new TypeError("Relationship graph snapshot fingerprint mismatch");return{snapshot,registry,graph}}async function loadRelationshipGraphAdapter(adapter,context){requireText(adapter.name,"adapter name");const workspace=requireText(context.workspace,"workspace");throwIfAborted(context.signal);const value=await adapter.read({...context,workspace});throwIfAborted(context.signal);return value===null?null:parseRelationshipGraphSnapshot(value)}async function syncRelationshipGraphAdapter(adapter,context){const workspace=requireText(context.workspace,"workspace");const validated=parseRelationshipGraphSnapshot(context.snapshot).snapshot;const current=await loadRelationshipGraphAdapter(adapter,{workspace,signal:context.signal});if(current?.snapshot.fingerprint===validated.fingerprint)return{adapter:adapter.name,workspace,disposition:"current",fingerprint:validated.fingerprint,previous_fingerprint:current.snapshot.fingerprint,node_count:validated.nodes.length,edge_count:validated.edges.length};throwIfAborted(context.signal);await adapter.replace({workspace,signal:context.signal,snapshot:validated,expected_fingerprint:current?.snapshot.fingerprint??null});const visible=await loadRelationshipGraphAdapter(adapter,{workspace,signal:context.signal});if(visible?.snapshot.fingerprint!==validated.fingerprint)throw new Error(`Relationship graph adapter "${adapter.name}" did not expose the replaced snapshot`);return{adapter:adapter.name,workspace,disposition:"written",fingerprint:validated.fingerprint,...current?{previous_fingerprint:current.snapshot.fingerprint}:{},node_count:validated.nodes.length,edge_count:validated.edges.length}}function federateRelationshipGraphSnapshots(values,options={}){const loaded=values.map(parseRelationshipGraphSnapshot);const definitions=new Map;for(const entry of loaded){for(const definition of entry.snapshot.kinds){const prior=definitions.get(definition.kind);if(prior&&stableStringify(prior)!==stableStringify(definition))throw new TypeError(`Conflicting federated relationship kind: ${definition.kind}`);definitions.set(definition.kind,definition)}}const registry=new RelationshipKindRegistry([...definitions.values()].sort((left,right)=>left.kind.localeCompare(right.kind)));const graph=new RelationshipGraph(new Set(loaded.flatMap(entry=>[...entry.snapshot.nodes])),loaded.flatMap(entry=>[...entry.snapshot.edges]),registry);return createRelationshipGraphSnapshot(graph,registry,options)}class MemoryRelationshipGraphAdapter{name;#snapshots=new Map;constructor(name="memory"){this.name=requireText(name,"adapter name")}async read(context){throwIfAborted(context.signal);const snapshot=this.#snapshots.get(requireText(context.workspace,"workspace"));return snapshot?structuredClone(snapshot):null}async replace(context){throwIfAborted(context.signal);const workspace=requireText(context.workspace,"workspace");const current=this.#snapshots.get(workspace);if(context.expected_fingerprint!==void 0&&(current?.fingerprint??null)!==context.expected_fingerprint)throw new Error(`Relationship graph adapter conflict for ${workspace}`);this.#snapshots.set(workspace,structuredClone(parseRelationshipGraphSnapshot(context.snapshot).snapshot))}async clear(context){throwIfAborted(context.signal);const workspace=requireText(context.workspace,"workspace");const current=this.#snapshots.get(workspace);if(context.expected_fingerprint!==void 0&&(current?.fingerprint??null)!==context.expected_fingerprint)throw new Error(`Relationship graph adapter conflict for ${workspace}`);this.#snapshots.delete(workspace)}}export{MemoryRelationshipGraphAdapter,RELATIONSHIP_GRAPH_SNAPSHOT_VERSION,createRelationshipGraphSnapshot,federateRelationshipGraphSnapshots,loadRelationshipGraphAdapter,parseRelationshipGraphSnapshot,syncRelationshipGraphAdapter};
 //# sourceMappingURL=adapter.js.map
-//# debugId=4586a8b2-07c8-53d4-9c5d-ca557ee07977