@open-agent-toolkit/cli 0.2.64 → 0.2.66

package/dist/commands/pjm/remote/purpose-policy.d.ts

@@ -0,0 +1,29 @@
+import type { OatPjmRemoteOperationClass } from '../../../config/oat-config.js';
+import type { RemoteBindingMetadata } from './schema.js';
+export type BindingPurpose = RemoteBindingMetadata['purposes'][number];
+export type SharedRemoteField = 'title' | 'description' | 'priority';
+export type FieldDirection = 'inbound' | 'outbound';
+export type CloseoutAnnotationPolicy = 'propose' | 'none';
+export type CloseoutTransitionPolicy = 'propose' | 'provider-automation' | 'none';
+export interface PurposePolicy {
+    fields: Record<SharedRemoteField, readonly FieldDirection[]>;
+    lifecycle: readonly OatPjmRemoteOperationClass[];
+    closeout: {
+        annotation: CloseoutAnnotationPolicy;
+        transition: CloseoutTransitionPolicy;
+    };
+}
+export interface ComposedPurposePolicy {
+    purposes: BindingPurpose[];
+    fields: Record<SharedRemoteField, FieldDirection[]>;
+    lifecycle: OatPjmRemoteOperationClass[];
+    closeout: {
+        annotation: CloseoutAnnotationPolicy;
+        transition: CloseoutTransitionPolicy | 'choice-required';
+    };
+    choiceRequired: boolean;
+    noOp: boolean;
+}
+export declare const PURPOSE_POLICIES: Readonly<Record<BindingPurpose, PurposePolicy>>;
+export declare function composePurposePolicies(purposes: readonly BindingPurpose[]): ComposedPurposePolicy;
+//# sourceMappingURL=purpose-policy.d.ts.map

package/dist/commands/pjm/remote/purpose-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"purpose-policy.d.ts","sourceRoot":"","sources":["../../../../src/commands/pjm/remote/purpose-policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAErE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AACvE,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,CAAC;AACrE,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,CAAC;AACpD,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,MAAM,CAAC;AAC1D,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,qBAAqB,GACrB,MAAM,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC,iBAAiB,EAAE,SAAS,cAAc,EAAE,CAAC,CAAC;IAC7D,SAAS,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACjD,QAAQ,EAAE;QACR,UAAU,EAAE,wBAAwB,CAAC;QACrC,UAAU,EAAE,wBAAwB,CAAC;KACtC,CAAC;CACH;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,iBAAiB,EAAE,cAAc,EAAE,CAAC,CAAC;IACpD,SAAS,EAAE,0BAA0B,EAAE,CAAC;IACxC,QAAQ,EAAE;QACR,UAAU,EAAE,wBAAwB,CAAC;QACrC,UAAU,EAAE,wBAAwB,GAAG,iBAAiB,CAAC;KAC1D,CAAC;IACF,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;CACf;AAWD,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,aAAa,CAAC,CAkDzE,CAAC;AAkBL,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAClC,qBAAqB,CA2DvB"}

package/dist/commands/pjm/remote/purpose-policy.js

@@ -0,0 +1,118 @@
+const INBOUND = Object.freeze(['inbound']);
+const BIDIRECTIONAL = Object.freeze(['inbound', 'outbound']);
+const NO_DIRECTIONS = Object.freeze([]);
+const CLOSEOUT_LIFECYCLE = Object.freeze([
+    'annotate',
+    'transition',
+]);
+const NO_LIFECYCLE = Object.freeze([]);
+export const PURPOSE_POLICIES = Object.freeze({
+    source: Object.freeze({
+        fields: Object.freeze({
+            title: INBOUND,
+            description: INBOUND,
+            priority: INBOUND,
+        }),
+        lifecycle: CLOSEOUT_LIFECYCLE,
+        closeout: Object.freeze({
+            annotation: 'propose',
+            transition: 'propose',
+        }),
+    }),
+    planning: Object.freeze({
+        fields: Object.freeze({
+            title: BIDIRECTIONAL,
+            description: BIDIRECTIONAL,
+            priority: BIDIRECTIONAL,
+        }),
+        lifecycle: CLOSEOUT_LIFECYCLE,
+        closeout: Object.freeze({
+            annotation: 'propose',
+            transition: 'propose',
+        }),
+    }),
+    delivery: Object.freeze({
+        fields: Object.freeze({
+            title: NO_DIRECTIONS,
+            description: NO_DIRECTIONS,
+            priority: NO_DIRECTIONS,
+        }),
+        lifecycle: NO_LIFECYCLE,
+        closeout: Object.freeze({
+            annotation: 'none',
+            transition: 'provider-automation',
+        }),
+    }),
+    reference: Object.freeze({
+        fields: Object.freeze({
+            title: NO_DIRECTIONS,
+            description: NO_DIRECTIONS,
+            priority: NO_DIRECTIONS,
+        }),
+        lifecycle: NO_LIFECYCLE,
+        closeout: Object.freeze({
+            annotation: 'none',
+            transition: 'none',
+        }),
+    }),
+});
+const SHARED_FIELDS = [
+    'title',
+    'description',
+    'priority',
+];
+const OPERATION_ORDER = [
+    'create',
+    'update-fields',
+    'annotate',
+    'transition',
+    'delete',
+    'relink',
+    'detach',
+    'recreate',
+];
+export function composePurposePolicies(purposes) {
+    if (purposes.length === 0) {
+        throw new Error('A binding must declare at least one purpose.');
+    }
+    const uniquePurposes = new Set();
+    for (const purpose of purposes) {
+        if (!(purpose in PURPOSE_POLICIES)) {
+            throw new Error(`Unknown purpose '${String(purpose)}'.`);
+        }
+        if (uniquePurposes.has(purpose)) {
+            throw new Error('Binding purposes must be unique.');
+        }
+        uniquePurposes.add(purpose);
+    }
+    const policies = purposes.map((purpose) => PURPOSE_POLICIES[purpose]);
+    const fields = Object.fromEntries(SHARED_FIELDS.map((field) => [
+        field,
+        intersectOrdered(policies.map((policy) => policy.fields[field]), ['inbound', 'outbound']),
+    ]));
+    const lifecycle = intersectOrdered(policies.map((policy) => policy.lifecycle), OPERATION_ORDER);
+    const annotation = policies.every((policy) => policy.closeout.annotation === 'propose')
+        ? 'propose'
+        : 'none';
+    const transitionValues = new Set(policies.map((policy) => policy.closeout.transition));
+    const nonNoneTransitions = new Set([...transitionValues].filter((value) => value !== 'none'));
+    const transition = transitionValues.has('none')
+        ? 'none'
+        : nonNoneTransitions.size > 1
+            ? 'choice-required'
+            : ([...nonNoneTransitions][0] ?? 'none');
+    const choiceRequired = transition === 'choice-required';
+    const noOp = SHARED_FIELDS.every((field) => fields[field].length === 0) &&
+        lifecycle.length === 0;
+    return {
+        purposes: [...purposes],
+        fields,
+        lifecycle,
+        closeout: { annotation, transition },
+        choiceRequired,
+        noOp,
+    };
+}
+function intersectOrdered(values, order) {
+    return order.filter((candidate) => values.every((value) => value.includes(candidate)));
+}

package/dist/commands/pjm/remote/reconcile.d.ts

@@ -0,0 +1,42 @@
+import type { OatPjmRemoteDescriptionMode } from '../../../config/oat-config.js';
+import type { FieldDirection, SharedRemoteField } from './purpose-policy.js';
+export type ReconciliationClass = 'no-change' | 'local-only' | 'remote-only' | 'converged' | 'disjoint' | 'conflict' | 'remote-anomaly' | 'uncertain-operation';
+export type ReconciliationDirection = 'inbound' | 'outbound' | 'none' | 'choice-required';
+export type RemoteLifecycleCondition = 'active' | 'archived' | 'moved' | 'missing-or-invisible' | 'deleted-confirmed' | 'temporarily-unavailable';
+export interface SharedFieldValues {
+    title: string | null;
+    description: string | null;
+    priority: string | null;
+}
+export interface ReconciliationInput {
+    base: SharedFieldValues;
+    local: SharedFieldValues;
+    remote: SharedFieldValues;
+    fieldDirections: Record<SharedRemoteField, readonly FieldDirection[]>;
+    descriptionMode: OatPjmRemoteDescriptionMode;
+    priorityMapping: boolean;
+    remoteLifecycle: RemoteLifecycleCondition;
+    uncertainOperation: boolean;
+}
+export interface FieldReconciliation {
+    field: SharedRemoteField;
+    base: string | null;
+    local: string | null;
+    remote: string | null;
+    classification: Exclude<ReconciliationClass, 'disjoint' | 'remote-anomaly' | 'uncertain-operation'>;
+    proposedDirection: ReconciliationDirection;
+}
+export interface BindingReconciliationPreview {
+    classification: ReconciliationClass;
+    fields: {
+        title: FieldReconciliation;
+        description: FieldReconciliation & {
+            scope: 'none' | 'managed-section' | 'full';
+        };
+        priority?: FieldReconciliation;
+    };
+    choiceRequired: boolean;
+    blockedBy: string[];
+}
+export declare function reconcileBinding(input: ReconciliationInput): BindingReconciliationPreview;
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/commands/pjm/remote/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../../../src/commands/pjm/remote/reconcile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAC3B,WAAW,GACX,YAAY,GACZ,aAAa,GACb,WAAW,GACX,UAAU,GACV,UAAU,GACV,gBAAgB,GAChB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,UAAU,GACV,MAAM,GACN,iBAAiB,CAAC;AAEtB,MAAM,MAAM,wBAAwB,GAChC,QAAQ,GACR,UAAU,GACV,OAAO,GACP,sBAAsB,GACtB,mBAAmB,GACnB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC,iBAAiB,EAAE,SAAS,cAAc,EAAE,CAAC,CAAC;IACtE,eAAe,EAAE,2BAA2B,CAAC;IAC7C,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,wBAAwB,CAAC;IAC1C,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,iBAAiB,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc,EAAE,OAAO,CACrB,mBAAmB,EACnB,UAAU,GAAG,gBAAgB,GAAG,qBAAqB,CACtD,CAAC;IACF,iBAAiB,EAAE,uBAAuB,CAAC;CAC5C;AAED,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,mBAAmB,CAAC;IACpC,MAAM,EAAE;QACN,KAAK,EAAE,mBAAmB,CAAC;QAC3B,WAAW,EAAE,mBAAmB,GAAG;YACjC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,MAAM,CAAC;SAC5C,CAAC;QACF,QAAQ,CAAC,EAAE,mBAAmB,CAAC;KAChC,CAAC;IACF,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,mBAAmB,GACzB,4BAA4B,CA6C9B"}

package/dist/commands/pjm/remote/reconcile.js

@@ -0,0 +1,101 @@
+export function reconcileBinding(input) {
+    const blockedBy = [];
+    if (!input.priorityMapping) {
+        blockedBy.push('priority-mapping-unavailable');
+    }
+    const title = reconcileField('title', input);
+    const description = {
+        ...reconcileField('description', input),
+        scope: descriptionScope(input.descriptionMode),
+    };
+    if (input.descriptionMode === 'none' &&
+        description.proposedDirection === 'outbound') {
+        description.proposedDirection = 'none';
+    }
+    const priority = input.priorityMapping
+        ? reconcileField('priority', input)
+        : undefined;
+    const fieldList = [title, description, ...(priority ? [priority] : [])];
+    let classification = classifyBinding(fieldList);
+    if (input.uncertainOperation) {
+        classification = 'uncertain-operation';
+        blockedBy.unshift('uncertain-operation');
+        blockDirections(fieldList);
+    }
+    else if (input.remoteLifecycle !== 'active') {
+        classification = 'remote-anomaly';
+        blockedBy.unshift(`remote-lifecycle:${input.remoteLifecycle}`);
+        blockDirections(fieldList);
+    }
+    return {
+        classification,
+        fields: {
+            title,
+            description,
+            ...(priority ? { priority } : {}),
+        },
+        choiceRequired: fieldList.some((field) => field.proposedDirection === 'choice-required'),
+        blockedBy,
+    };
+}
+function reconcileField(field, input) {
+    const base = input.base[field];
+    const local = input.local[field];
+    const remote = input.remote[field];
+    const classification = classifyField(base, local, remote);
+    return {
+        field,
+        base,
+        local,
+        remote,
+        classification,
+        proposedDirection: proposedDirection(classification, input.fieldDirections[field]),
+    };
+}
+function classifyField(base, local, remote) {
+    if (local === remote)
+        return local === base ? 'no-change' : 'converged';
+    const localChanged = local !== base;
+    const remoteChanged = remote !== base;
+    if (localChanged && remoteChanged)
+        return 'conflict';
+    if (localChanged)
+        return 'local-only';
+    if (remoteChanged)
+        return 'remote-only';
+    return 'no-change';
+}
+function proposedDirection(classification, allowed) {
+    if (classification === 'conflict')
+        return 'choice-required';
+    if (classification === 'local-only' && allowed.includes('outbound')) {
+        return 'outbound';
+    }
+    if (classification === 'remote-only' && allowed.includes('inbound')) {
+        return 'inbound';
+    }
+    return 'none';
+}
+function classifyBinding(fields) {
+    const classes = new Set(fields.map((field) => field.classification));
+    if (classes.has('conflict'))
+        return 'conflict';
+    if (classes.has('local-only') && classes.has('remote-only'))
+        return 'disjoint';
+    if (classes.has('local-only'))
+        return 'local-only';
+    if (classes.has('remote-only'))
+        return 'remote-only';
+    if (classes.has('converged'))
+        return 'converged';
+    return 'no-change';
+}
+function descriptionScope(mode) {
+    if (mode === 'replace')
+        return 'full';
+    return mode;
+}
+function blockDirections(fields) {
+    for (const field of fields)
+        field.proposedDirection = 'none';
+}

package/dist/commands/pjm/remote/resolution.d.ts

@@ -0,0 +1,122 @@
+import { type RemoteProvider } from './provider.js';
+export interface ResolutionIdentity {
+    stableId: string;
+    context: Record<string, string | undefined>;
+    aliases: Array<{
+        kind: 'url' | 'display' | 'key';
+        value: string;
+    }>;
+}
+export interface ResolutionBinding {
+    bindingId: string;
+    provider: RemoteProvider;
+    targetRef: string;
+    remoteIdentity: ResolutionIdentity;
+    identityHistory: Array<{
+        provider: RemoteProvider;
+        identity: ResolutionIdentity;
+        replacedAt: string;
+        replacedByOperationId: string;
+    }>;
+    lifecycle: 'active' | 'blocked' | 'tombstoned';
+    snapshotDigest: string | null;
+}
+export interface ResolutionApproval {
+    previewDigest: string;
+    approvedAt: string;
+    source: string;
+}
+export interface ResolutionJournal {
+    schemaVersion: 1;
+    operationId: string;
+    bindingId: string;
+    kind: 'relink' | 'detach' | 'recreate';
+    previewDigest: string;
+    state: 'pending' | 'blocked' | 'partial' | 'uncertain' | 'complete';
+    bindingTransitionCompleted: boolean;
+    associationCompleted: boolean;
+    resultingBinding: ResolutionBinding | null;
+    searchCompleted?: boolean;
+    createIntentPersisted?: boolean;
+    createAttempted?: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ResolutionStore {
+    findByIdentity(provider: RemoteProvider, identity: ResolutionIdentity): Promise<string | null>;
+    writeBinding(binding: ResolutionBinding): Promise<void>;
+    writeAssociation(input: {
+        targetRef: string;
+        bindingId: string | null;
+        referenceRef: string | null;
+    }): Promise<void>;
+    readJournal(operationId: string): Promise<ResolutionJournal | null>;
+    writeJournal(journal: ResolutionJournal): Promise<void>;
+}
+interface CommonResolutionInput {
+    operationId: string;
+    binding: ResolutionBinding;
+    now: string;
+    previewDigest: string;
+    approval?: ResolutionApproval;
+    crash?: (point: 'after-binding' | 'after-association') => void;
+}
+export declare function relinkBinding(input: CommonResolutionInput & {
+    replacement: {
+        identity: ResolutionIdentity;
+        verifiedAt: string;
+        evidenceDigest: string;
+    };
+}, store: ResolutionStore): Promise<{
+    binding: ResolutionBinding;
+    journal: ResolutionJournal;
+}>;
+export declare function detachBinding(input: CommonResolutionInput & {
+    keepReference: boolean;
+}, store: ResolutionStore): Promise<{
+    binding: ResolutionBinding;
+    journal: ResolutionJournal;
+}>;
+export type DuplicateSearchOutcome = {
+    kind: 'found-existing';
+    replacement: {
+        identity: ResolutionIdentity;
+        verifiedAt: string;
+        evidenceDigest: string;
+    };
+} | {
+    kind: 'search-unavailable';
+} | {
+    kind: 'ambiguous';
+    candidates: string[];
+} | {
+    kind: 'no-match';
+};
+export type RecreateAttemptOutcome = {
+    kind: 'committed';
+    replacement: {
+        identity: ResolutionIdentity;
+        verifiedAt: string;
+        evidenceDigest: string;
+    };
+} | {
+    kind: 'uncertain';
+} | {
+    kind: 'rejected';
+};
+export declare function recreateBinding(input: CommonResolutionInput & {
+    searchDuplicates(): Promise<DuplicateSearchOutcome>;
+    createReplacement(): Promise<RecreateAttemptOutcome>;
+}, store: ResolutionStore): Promise<{
+    status: 'verified' | 'blocked' | 'uncertain';
+    binding: ResolutionBinding;
+    journal: ResolutionJournal;
+}>;
+export declare function buildResolutionPreviewDigest(input: {
+    kind: ResolutionJournal['kind'];
+    binding: ResolutionBinding;
+    replacement?: ResolutionIdentity;
+    keepReference?: boolean;
+}): string;
+export {};
+//# sourceMappingURL=resolution.d.ts.map

package/dist/commands/pjm/remote/resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolution.d.ts","sourceRoot":"","sources":["../../../../src/commands/pjm/remote/resolution.ts"],"names":[],"mappings":"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"}

package/dist/commands/pjm/remote/resolution.js

@@ -0,0 +1,243 @@
+import { semanticDigest } from './provider.js';
+export async function relinkBinding(input, store) {
+    assertFreshApproval(input);
+    assertVerifiedReplacement(input.replacement);
+    const duplicate = await store.findByIdentity(input.binding.provider, input.replacement.identity);
+    if (duplicate && duplicate !== input.binding.bindingId) {
+        throw new Error(`Replacement identity is already bound by '${duplicate}'.`);
+    }
+    let journal = await store.readJournal(input.operationId);
+    assertJournalMatches(journal, input, 'relink');
+    if (!journal) {
+        journal = createJournal(input, 'relink');
+        await store.writeJournal(journal);
+    }
+    if (!journal.bindingTransitionCompleted) {
+        const nextBinding = {
+            ...input.binding,
+            remoteIdentity: structuredClone(input.replacement.identity),
+            identityHistory: [
+                ...input.binding.identityHistory,
+                {
+                    provider: input.binding.provider,
+                    identity: structuredClone(input.binding.remoteIdentity),
+                    replacedAt: input.now,
+                    replacedByOperationId: input.operationId,
+                },
+            ],
+            lifecycle: 'active',
+        };
+        await store.writeBinding(nextBinding);
+        journal = {
+            ...journal,
+            state: 'partial',
+            bindingTransitionCompleted: true,
+            resultingBinding: nextBinding,
+            updatedAt: input.now,
+        };
+        await store.writeJournal(journal);
+        input.crash?.('after-binding');
+    }
+    if (!journal.associationCompleted) {
+        await store.writeAssociation({
+            targetRef: input.binding.targetRef,
+            bindingId: input.binding.bindingId,
+            referenceRef: null,
+        });
+        journal = completeAssociation(journal, input.now);
+        await store.writeJournal(journal);
+        input.crash?.('after-association');
+    }
+    return { binding: journal.resultingBinding, journal };
+}
+export async function detachBinding(input, store) {
+    assertFreshApproval(input);
+    let journal = await store.readJournal(input.operationId);
+    assertJournalMatches(journal, input, 'detach');
+    if (!journal) {
+        journal = createJournal(input, 'detach');
+        await store.writeJournal(journal);
+    }
+    if (!journal.bindingTransitionCompleted) {
+        const nextBinding = {
+            ...input.binding,
+            lifecycle: 'tombstoned',
+        };
+        await store.writeBinding(nextBinding);
+        journal = {
+            ...journal,
+            state: 'partial',
+            bindingTransitionCompleted: true,
+            resultingBinding: nextBinding,
+            updatedAt: input.now,
+        };
+        await store.writeJournal(journal);
+        input.crash?.('after-binding');
+    }
+    if (!journal.associationCompleted) {
+        await store.writeAssociation({
+            targetRef: input.binding.targetRef,
+            bindingId: null,
+            referenceRef: input.keepReference
+                ? `${input.binding.provider}:${input.binding.remoteIdentity.stableId}`
+                : null,
+        });
+        journal = completeAssociation(journal, input.now);
+        await store.writeJournal(journal);
+        input.crash?.('after-association');
+    }
+    return { binding: journal.resultingBinding, journal };
+}
+export async function recreateBinding(input, store) {
+    assertFreshApproval(input);
+    let journal = await store.readJournal(input.operationId);
+    assertJournalMatches(journal, input, 'recreate');
+    if (journal?.createAttempted && !journal.bindingTransitionCompleted) {
+        return {
+            status: 'uncertain',
+            binding: { ...input.binding, lifecycle: 'blocked' },
+            journal,
+        };
+    }
+    if (!journal) {
+        journal = createJournal(input, 'recreate');
+        await store.writeJournal(journal);
+    }
+    const search = await input.searchDuplicates();
+    journal = {
+        ...journal,
+        searchCompleted: true,
+        updatedAt: input.now,
+    };
+    await store.writeJournal(journal);
+    if (search.kind === 'search-unavailable' || search.kind === 'ambiguous') {
+        journal = { ...journal, state: 'blocked', updatedAt: input.now };
+        await store.writeJournal(journal);
+        return { status: 'blocked', binding: input.binding, journal };
+    }
+    let replacement = null;
+    if (search.kind === 'found-existing') {
+        replacement = search.replacement;
+    }
+    else {
+        journal = {
+            ...journal,
+            createIntentPersisted: true,
+            updatedAt: input.now,
+        };
+        await store.writeJournal(journal);
+        journal = { ...journal, createAttempted: true, updatedAt: input.now };
+        await store.writeJournal(journal);
+        const create = await input.createReplacement();
+        if (create.kind !== 'committed') {
+            journal = {
+                ...journal,
+                state: create.kind === 'uncertain' ? 'uncertain' : 'blocked',
+                updatedAt: input.now,
+            };
+            await store.writeJournal(journal);
+            return {
+                status: create.kind === 'uncertain' ? 'uncertain' : 'blocked',
+                binding: { ...input.binding, lifecycle: 'blocked' },
+                journal,
+            };
+        }
+        replacement = create.replacement;
+    }
+    assertVerifiedReplacement(replacement);
+    const duplicate = await store.findByIdentity(input.binding.provider, replacement.identity);
+    if (duplicate && duplicate !== input.binding.bindingId) {
+        throw new Error(`Replacement identity is already bound by '${duplicate}'.`);
+    }
+    if (!journal.bindingTransitionCompleted) {
+        const nextBinding = {
+            ...input.binding,
+            remoteIdentity: structuredClone(replacement.identity),
+            identityHistory: [
+                ...input.binding.identityHistory,
+                {
+                    provider: input.binding.provider,
+                    identity: structuredClone(input.binding.remoteIdentity),
+                    replacedAt: input.now,
+                    replacedByOperationId: input.operationId,
+                },
+            ],
+            lifecycle: 'active',
+        };
+        await store.writeBinding(nextBinding);
+        journal = {
+            ...journal,
+            state: 'partial',
+            bindingTransitionCompleted: true,
+            resultingBinding: nextBinding,
+            updatedAt: input.now,
+        };
+        await store.writeJournal(journal);
+        input.crash?.('after-binding');
+    }
+    if (!journal.associationCompleted) {
+        await store.writeAssociation({
+            targetRef: input.binding.targetRef,
+            bindingId: input.binding.bindingId,
+            referenceRef: null,
+        });
+        journal = completeAssociation(journal, input.now);
+        await store.writeJournal(journal);
+        input.crash?.('after-association');
+    }
+    return { status: 'verified', binding: journal.resultingBinding, journal };
+}
+function assertJournalMatches(journal, input, kind) {
+    if (journal &&
+        (journal.kind !== kind ||
+            journal.bindingId !== input.binding.bindingId ||
+            journal.previewDigest !== input.previewDigest)) {
+        throw new Error('Persisted resolution journal does not match the requested kind, binding, and preview.');
+    }
+}
+function assertFreshApproval(input) {
+    const approval = input.approval;
+    const age = approval
+        ? Date.parse(input.now) - Date.parse(approval.approvedAt)
+        : Number.POSITIVE_INFINITY;
+    if (!approval ||
+        approval.previewDigest !== input.previewDigest ||
+        !Number.isFinite(age) ||
+        age < 0 ||
+        age > 5 * 60 * 1_000) {
+        throw new Error('Resolution requires fresh approval of the exact preview.');
+    }
+}
+function assertVerifiedReplacement(replacement) {
+    if (replacement.identity.stableId.length === 0 ||
+        replacement.evidenceDigest.length === 0 ||
+        !Number.isFinite(Date.parse(replacement.verifiedAt))) {
+        throw new Error('Relink requires a verified stable replacement identity.');
+    }
+}
+function createJournal(input, kind) {
+    return {
+        schemaVersion: 1,
+        operationId: input.operationId,
+        bindingId: input.binding.bindingId,
+        kind,
+        previewDigest: input.previewDigest,
+        state: 'pending',
+        bindingTransitionCompleted: false,
+        associationCompleted: false,
+        resultingBinding: null,
+        createdAt: input.now,
+        updatedAt: input.now,
+    };
+}
+function completeAssociation(journal, updatedAt) {
+    return {
+        ...journal,
+        state: 'complete',
+        associationCompleted: true,
+        updatedAt,
+    };
+}
+export function buildResolutionPreviewDigest(input) {
+    return semanticDigest(input);
+}