@holmes-lab/holmes-kit 0.19.6 → 0.20.1

package/dist/holmes/spec/entity-renumber-transaction.d.ts

@@ -0,0 +1,82 @@
+import { readEntityRenumberSnapshot } from './entity-store';
+import { EntityRenumberChange } from './entity-renumber';
+import { SourceRenumberInventory } from './renumber';
+import { EntityByteChange, entityLockOwner } from './entity-transaction';
+type Snapshot = ReturnType<typeof readEntityRenumberSnapshot>;
+export declare const entitySourcePublicationOwner: (root: string) => {
+    token: string;
+    version: string;
+} | null;
+/** Caller holds the destination store first; inspection shares the existing publication namespace. */
+export declare function withEntitySourceInspection<T>(root: string, act: () => T | Promise<T>): Promise<T>;
+type SourceOwner = ReturnType<typeof entityLockOwner>;
+export declare function withRecoveredSourcePublication<T>(root: string, operationId: string, expected: SourceOwner, act: () => T, journal?: {
+    file: string;
+    version: string;
+}): T;
+interface RenumberStep {
+    phase: 'unseal' | 'document' | 'mapping' | 'source' | 'approve';
+    specId?: string;
+    change: EntityByteChange;
+}
+export interface EntityRenumberPlan {
+    schema: 'holmes-entity-renumber/1';
+    operationId: string;
+    snapshot: Snapshot;
+    changes: EntityRenumberChange[];
+    sources: SourceRenumberInventory;
+    policyFiles: Array<{
+        file: string;
+        version: string | null;
+    }>;
+    approvalTargets: string[];
+    steps: RenumberStep[];
+}
+export declare function entityRenumberTarget(plan: EntityRenumberPlan): string;
+/** Build candidates through the same transition policy as the ordinary official tools. No writes. */
+export declare function prepareEntityRenumberPlan(root: string, snapshot: Snapshot, changes: EntityRenumberChange[], sources: SourceRenumberInventory, operationId?: string, originalSources?: ReadonlyMap<string, string>): EntityRenumberPlan;
+export declare function validateEntityRenumberPlan(value: unknown): EntityRenumberPlan;
+export interface EntityRenumberRecoveryPlan {
+    schema: 'holmes-entity-renumber-recovery/1';
+    workspaceId: string;
+    storeLocator: string;
+    operationId: string;
+    journalVersion: string;
+    lockOwner: {
+        token: string;
+        version: string;
+    } | null;
+    appliedSteps: number;
+    state: 'pending' | 'applied' | 'conflict';
+}
+export declare function entityRenumberRecoveryTarget(plan: EntityRenumberRecoveryPlan): string;
+export declare function validateEntityRenumberRecoveryPlan(value: unknown): EntityRenumberRecoveryPlan;
+export declare function planEntityRenumberRecovery(storeRoot: string): EntityRenumberRecoveryPlan;
+/** No publication until current source semantics and official transition candidates match the journal. */
+/**
+ * @implements A-SPEC-639 — abandon a pending renumber a third state blocked: revert the operation's
+ * own publications, preserve foreign bytes, audit and retire it as abandoned under both ownerships.
+ */
+export declare function abandonEntityRenumber(storeRoot: string, inspected: unknown, authorize: () => void, audit: (plan: EntityRenumberPlan, outcome: {
+    restored: string[];
+    untouched: string[];
+    preserved: string[];
+}) => void): Promise<{
+    restored: string[];
+    untouched: string[];
+    preserved: string[];
+    ok: true;
+    state: "abandoned";
+    operationId: string;
+}>;
+export declare function recoverEntityRenumber(storeRoot: string, inspected: unknown, authorize: (specId?: string) => void, audit: (plan: EntityRenumberPlan, verifyOnly?: boolean) => void, beforePublish?: (plan: EntityRenumberPlan) => void): Promise<{
+    ok: true;
+    state: "completed";
+    operationId: string;
+}>;
+export declare function applyEntityRenumber(storeRoot: string, plan: EntityRenumberPlan, authorize: (specId?: string) => void, audit: (verifyOnly?: boolean) => void, beforePublish?: (plan: EntityRenumberPlan) => void): Promise<{
+    ok: true;
+    state: "completed";
+    operationId: string;
+}>;
+export {};