@cotal-ai/workspace 0.11.6 → 0.12.0

package/dist/maintenance.d.ts

@@ -0,0 +1,506 @@
+/** Version 1 lives in `<project>/.cotal/maintenance/v1`; the lock is shared across versions. */
+export declare const MAINTENANCE_JOURNAL_VERSION: 1;
+export declare const MAINTENANCE_RESUME_DOCUMENT_VERSION: 1;
+export declare const MAX_MAINTENANCE_RESUME_BYTES: number;
+export type MaintenanceAuthMode = "auth" | "open" | "user";
+export type OwnerStatus = "alive" | "dead" | "unknown";
+export interface StoreIdentity {
+    readonly path: string;
+    /** Decimal strings preserve the full `bigint` values returned by `stat`. */
+    readonly dev: string;
+    readonly ino: string;
+    /** Random marker persisted inside the store, so inode reuse cannot impersonate the old store. */
+    readonly generation: string;
+}
+export interface ProcessOwner {
+    readonly pid: number;
+    readonly host: string;
+    readonly startedAt: string;
+    readonly id: string;
+}
+export interface MaintenanceRecourse {
+    readonly action: "retry" | "inspect" | "rollback" | "repair" | "cleanup";
+    readonly description: string;
+    readonly command?: string;
+    readonly paths?: readonly string[];
+}
+export type MaintenanceErrorCode = "invalid-path" | "path-exists" | "path-missing" | "identity-mismatch" | "ambiguous-filesystem-state" | "journal-missing" | "journal-corrupt" | "journal-version" | "invalid-transition" | "lock-held" | "lock-owner-ambiguous" | "lock-lost" | "claim-live" | "claim-owner-ambiguous" | "claim-not-expired" | "cleanup-incomplete" | "rollback-forbidden" | "cleanup-forbidden" | "cleanup-complete" | "resume-missing" | "resume-mismatch" | "resume-invalid" | "resume-too-large" | "listener-proof-invalid" | "listener-proof-missing" | "listener-proof-mismatch" | "listener-owner-alive" | "listener-owner-dead" | "listener-owner-ambiguous" | "activation-evidence-invalid";
+export interface MaintenanceErrorDetails {
+    readonly root?: string;
+    readonly attemptId?: string;
+    readonly paths?: readonly string[];
+    readonly expected?: StoreIdentity;
+    readonly actual?: StoreIdentity;
+    readonly recourse: readonly MaintenanceRecourse[];
+}
+/** Stable code and structured recourse are the consumer contract; `message` is diagnostic text. */
+export declare class MaintenanceError extends Error {
+    readonly brand = "cotal:workspace:maintenance-error";
+    readonly code: MaintenanceErrorCode;
+    readonly details: MaintenanceErrorDetails;
+    constructor(code: MaintenanceErrorCode, message: string, details: MaintenanceErrorDetails);
+}
+export declare function isMaintenanceError(error: unknown): error is MaintenanceError;
+interface JournalBase {
+    readonly version: typeof MAINTENANCE_JOURNAL_VERSION;
+    readonly revision: number;
+    readonly updatedAt: string;
+    readonly space: string;
+    readonly mode: MaintenanceAuthMode;
+    readonly source: StoreIdentity;
+    readonly resume: MaintenanceResumeDescriptor;
+    readonly cut: MaintenanceCutContext;
+}
+interface CompletedJournalBase extends JournalBase {
+    readonly cutCompletion: MaintenanceCutCompletionEvidence;
+}
+export interface MaintenanceCutContext {
+    readonly attemptId: string;
+    readonly intentAt: string;
+    readonly launch: {
+        readonly server: string;
+        readonly [key: string]: JsonValue;
+    };
+}
+export interface MaintenanceCutCompletionEvidence {
+    readonly attemptId: string;
+    readonly observedAt: string;
+    readonly managerCommit: {
+        readonly operation: "commitPreservation";
+        readonly attemptId: string;
+        readonly state: "preserved";
+    };
+    readonly stopped: {
+        readonly manager: true;
+        readonly broker: true;
+        readonly localProcesses: true;
+    };
+    readonly listener: {
+        readonly endpoint: string;
+        readonly unreachable: true;
+    };
+}
+export interface MaintenanceCutIntentRecord extends JournalBase {
+    readonly state: "cut-intent";
+}
+/** Durable proof the manager committed preservation, written BEFORE any process stop so a crash
+ *  between manager commit and the final ready promotion recovers without a live manager. */
+export interface MaintenanceCutCommittedRecord extends JournalBase {
+    readonly state: "cut-committed";
+    readonly managerCommittedAt: string;
+    readonly managerCommit: MaintenanceCutCompletionEvidence["managerCommit"];
+}
+export interface MaintenanceReadyRecord extends CompletedJournalBase {
+    readonly state: "ready";
+}
+/** One filesystem tree or file owned by a single maintenance attempt. A slot journaled BEFORE the
+ *  path is created carries no inode ("pending"); it is upgraded with the exact dev/ino immediately
+ *  after creation, so recovery can never delete a replacement. */
+export interface AttemptOwnedPath {
+    readonly label: "clone" | "destination" | "staging" | "quarantine" | "sanitized" | "config";
+    readonly path: string;
+    readonly dev?: string;
+    readonly ino?: string;
+}
+export interface MaintenanceClaim {
+    readonly attemptId: string;
+    readonly deadline: string;
+    readonly coordinator: ProcessOwner;
+    readonly owners: readonly ProcessOwner[];
+    readonly ownedPaths?: readonly AttemptOwnedPath[];
+}
+/** Liveness claim covering the whole pre-commit restore window. Concurrent commands refuse while
+ *  it is live; recovery requires the deadline elapsed and every recorded owner proven dead. */
+export interface RestoreClaim {
+    readonly deadline: string;
+    readonly coordinator: ProcessOwner;
+    readonly owners: readonly ProcessOwner[];
+}
+export type RestoreClaimAssessment = "live" | "stale" | "ambiguous";
+export interface MaintenanceClaimedRecord extends CompletedJournalBase {
+    readonly state: "claimed";
+    readonly claim: MaintenanceClaim;
+}
+export type RestorePhase = "move-pending" | "source-moved" | "source-retained" | "disaster-source-missing";
+export interface PreviousSource {
+    /** A fallback is a renamed source; retained means an alternate-target restore left it in place. */
+    readonly kind: "fallback" | "retained";
+    readonly identity: StoreIdentity;
+}
+export interface CleanupProgress {
+    /** Only `attempt-target` is attempt-owned. `previous-source` requires the explicit cleanup API. */
+    readonly kind: "attempt-target" | "previous-source";
+    readonly status: "pending" | "complete";
+    readonly originalPath: string;
+    readonly tombPath: string;
+    readonly identity: StoreIdentity;
+}
+export interface RestoreContext {
+    readonly attemptId: string;
+    readonly method: "same-path" | "alternate" | "disaster";
+    readonly targetPath: string;
+    readonly fallbackPath?: string;
+    readonly previousSource?: PreviousSource;
+    readonly target?: StoreIdentity;
+    readonly cleanup?: CleanupProgress;
+    /** Attempt-owned working trees (staging, quarantine, sanitized) journaled before use so crash
+     *  recovery deletes exactly these inodes and nothing else. */
+    readonly ownedPaths?: readonly AttemptOwnedPath[];
+}
+export interface RestoreReadyRecord extends CompletedJournalBase {
+    readonly state: "restore-ready";
+    readonly phase: RestorePhase;
+    readonly restore: RestoreContext;
+    readonly claim: RestoreClaim;
+}
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+/** Manager-independent preservation payload. Callers own both JSON-safe shapes. */
+export interface MaintenanceResumeDocument<Inventory extends JsonValue = JsonValue, Launch extends JsonValue = JsonValue> {
+    readonly version: typeof MAINTENANCE_RESUME_DOCUMENT_VERSION;
+    readonly inventory: Inventory;
+    readonly launch: Launch;
+}
+/** Content-addressed descriptor persisted in every maintenance journal state. */
+export interface MaintenanceResumeDescriptor {
+    readonly version: typeof MAINTENANCE_RESUME_DOCUMENT_VERSION;
+    readonly file: "resume.json";
+    readonly bytes: number;
+    readonly sha256: string;
+}
+/** Bounded, non-secret identity of the normal listener spawned for one restore attempt. */
+export interface RestoreListenerProof {
+    readonly attemptId: string;
+    readonly serverName: string;
+    readonly serverNonce: string;
+    readonly processOwner: ProcessOwner;
+    readonly serverEndpoint: string;
+    readonly target: StoreIdentity;
+}
+/** Durable invalidation of one dead listener identity for this unchanged restore attempt. */
+export interface RestoreListenerReplacement {
+    readonly generation: number;
+    readonly replacedAt: string;
+    readonly proof: RestoreListenerProof;
+}
+export interface ReplaceDeadRestoreListenerOptions {
+    readonly ownerStatus?: (owner: ProcessOwner) => OwnerStatus;
+}
+export interface ManagerCommitEvidence {
+    readonly attemptId: string;
+    readonly state: "awaitingFinalize";
+    readonly durableCommitToken: string;
+}
+export interface ManagerFinalizeEvidence {
+    readonly attemptId: string;
+    readonly state: "active";
+    readonly durableCommitToken: string;
+}
+export interface RestoreActivationEvidence {
+    readonly attemptId: string;
+    readonly listenerReady: true;
+    readonly observedAt: string;
+    readonly managerCommit: ManagerCommitEvidence;
+    readonly managerFinalize: ManagerFinalizeEvidence;
+}
+export interface CommitIntentRecord extends CompletedJournalBase {
+    readonly state: "commit-intent";
+    readonly restore: RestoreContext & {
+        readonly target: StoreIdentity;
+    };
+    readonly launch: {
+        readonly [key: string]: JsonValue;
+    };
+    readonly listenerProof?: RestoreListenerProof;
+    readonly listenerReplacements?: readonly RestoreListenerReplacement[];
+}
+export interface RestoreManagerCommittedRecord extends CompletedJournalBase {
+    readonly state: "manager-committed";
+    readonly restore: RestoreContext & {
+        readonly target: StoreIdentity;
+    };
+    readonly launch: {
+        readonly [key: string]: JsonValue;
+    };
+    readonly listenerProof: RestoreListenerProof;
+    readonly listenerReplacements?: readonly RestoreListenerReplacement[];
+    readonly managerCommittedAt: string;
+    readonly managerCommit: ManagerCommitEvidence;
+}
+export interface RestoreActiveRecord extends CompletedJournalBase {
+    readonly state: "active";
+    readonly restore: RestoreContext & {
+        readonly target: StoreIdentity;
+    };
+    readonly launch: {
+        readonly [key: string]: JsonValue;
+    };
+    readonly listenerProof?: RestoreListenerProof;
+    readonly listenerReplacements?: readonly RestoreListenerReplacement[];
+    readonly managerCommittedAt: string;
+    readonly managerCommit: ManagerCommitEvidence;
+    readonly activeAt: string;
+    readonly details: RestoreActivationEvidence;
+}
+export interface RestoreDegradedRecord extends CompletedJournalBase {
+    readonly state: "degraded";
+    readonly restore: RestoreContext & {
+        readonly target: StoreIdentity;
+    };
+    readonly launch: {
+        readonly [key: string]: JsonValue;
+    };
+    readonly listenerProof?: RestoreListenerProof;
+    readonly listenerReplacements?: readonly RestoreListenerReplacement[];
+    /** Present when degradation followed manager commitment, including after finalization. */
+    readonly managerCommittedAt?: string;
+    readonly managerCommit?: ManagerCommitEvidence;
+    /** Present when degradation followed finalization; such a listener is not replaceable here. */
+    readonly activeAt?: string;
+    readonly details?: RestoreActivationEvidence;
+    readonly degradedAt: string;
+    readonly reason: string;
+    readonly recourse: readonly MaintenanceRecourse[];
+}
+/** Fsynced launch inputs for resuming the unchanged ready source through the normal listener. */
+export interface OrdinaryResumeContext {
+    readonly attemptId: string;
+    readonly intentAt: string;
+    readonly launch: {
+        readonly [key: string]: JsonValue;
+    };
+}
+export interface OrdinaryResumeActivationEvidence {
+    readonly operation: "resumePreserved";
+    readonly attemptId: string;
+    readonly state: "awaitingCommit";
+    readonly observedAt: string;
+}
+/** Exact bound listener identity + retired-listener history shared by every resume phase. The
+ *  proof's `target` is the preserved SOURCE store identity for an ordinary resume. */
+interface OrdinaryResumeListenerState {
+    readonly listenerProof?: RestoreListenerProof;
+    readonly listenerReplacements?: readonly RestoreListenerReplacement[];
+}
+export interface OrdinaryResumeIntentRecord extends CompletedJournalBase, OrdinaryResumeListenerState {
+    readonly state: "resume-intent";
+    readonly ordinaryResume: OrdinaryResumeContext;
+}
+export interface OrdinaryResumeActiveRecord extends CompletedJournalBase, OrdinaryResumeListenerState {
+    readonly state: "resume-active";
+    readonly ordinaryResume: OrdinaryResumeContext;
+    readonly activeAt: string;
+    /** Caller-supplied proof/result data for listener readiness and same-principal activation. */
+    readonly activation: OrdinaryResumeActivationEvidence;
+}
+export interface OrdinaryResumeCommittedRecord extends CompletedJournalBase, OrdinaryResumeListenerState {
+    readonly state: "resume-committed";
+    readonly ordinaryResume: OrdinaryResumeContext;
+    readonly activeAt: string;
+    readonly activation: OrdinaryResumeActivationEvidence;
+    readonly managerCommittedAt: string;
+    readonly managerCommit: ManagerCommitEvidence;
+}
+export interface OrdinaryResumeDegradedRecord extends CompletedJournalBase, OrdinaryResumeListenerState {
+    readonly state: "resume-degraded";
+    readonly ordinaryResume: OrdinaryResumeContext;
+    readonly activeAt?: string;
+    readonly activation?: OrdinaryResumeActivationEvidence;
+    readonly managerCommittedAt?: string;
+    readonly managerCommit?: ManagerCommitEvidence;
+    readonly degradedAt: string;
+    readonly reason: string;
+    readonly recourse: readonly MaintenanceRecourse[];
+}
+/** Terminal, still-durable proof that activation succeeded and journal consumption is now safe. */
+export interface OrdinaryResumeRetiredRecord extends CompletedJournalBase, OrdinaryResumeListenerState {
+    readonly state: "resume-retired";
+    readonly ordinaryResume: OrdinaryResumeContext;
+    readonly activeAt: string;
+    readonly activation: OrdinaryResumeActivationEvidence;
+    readonly managerCommittedAt: string;
+    readonly managerCommit: ManagerCommitEvidence;
+    readonly retiredAt: string;
+    readonly retirement: ManagerFinalizeEvidence;
+}
+export type OrdinaryResumeRecord = OrdinaryResumeIntentRecord | OrdinaryResumeActiveRecord | OrdinaryResumeCommittedRecord | OrdinaryResumeDegradedRecord | OrdinaryResumeRetiredRecord;
+export type MaintenanceJournal = MaintenanceCutIntentRecord | MaintenanceCutCommittedRecord | MaintenanceReadyRecord | MaintenanceClaimedRecord | RestoreReadyRecord | CommitIntentRecord | RestoreManagerCommittedRecord | RestoreActiveRecord | RestoreDegradedRecord | OrdinaryResumeRecord;
+export interface MaintenancePaths {
+    readonly root: string;
+    readonly cotalDir: string;
+    readonly maintenanceDir: string;
+    readonly versionDir: string;
+    readonly journal: string;
+    readonly resume: string;
+    readonly prepareIntent: string;
+    readonly lock: string;
+    readonly reaper: string;
+}
+export interface MaintenanceLock {
+    readonly root: string;
+    readonly path: string;
+    readonly token: string;
+    readonly owner: ProcessOwner;
+}
+export interface AcquireMaintenanceLockOptions {
+    readonly owner?: ProcessOwner;
+    readonly ownerStatus?: (owner: ProcessOwner) => OwnerStatus;
+}
+export declare function maintenancePaths(root: string): MaintenancePaths;
+/** Read an already-bound store identity. Missing generation is a replacement ambiguity, not absence. */
+export declare function readStoreIdentity(path: string): StoreIdentity;
+/** Bind a stopped source or attempt-owned target to a non-reusable generation marker. */
+export declare function ensureStoreIdentity(path: string): StoreIdentity;
+export declare function sameStoreIdentity(a: StoreIdentity, b: StoreIdentity): boolean;
+export declare function assertStoreIdentity(expected: StoreIdentity): StoreIdentity;
+export declare function localProcessOwnerStatus(owner: ProcessOwner): OwnerStatus;
+export declare function acquireMaintenanceLock(root: string, options?: AcquireMaintenanceLockOptions): MaintenanceLock;
+export declare function releaseMaintenanceLock(lock: MaintenanceLock): void;
+export declare function withMaintenanceLock<T>(root: string, operation: (lock: MaintenanceLock) => T, options?: AcquireMaintenanceLockOptions): T;
+/** Atomically persist the bounded private resume inventory and launch provenance before publishing ready. */
+export declare function writeMaintenanceResumeDocument<Inventory extends JsonValue, Launch extends JsonValue>(lock: MaintenanceLock, document: MaintenanceResumeDocument<Inventory, Launch>): MaintenanceResumeDescriptor;
+/** Read exactly the fixed resume file after size, mode, SHA-256, version, and JSON-shape verification. */
+export declare function readMaintenanceResumeDocument<Inventory extends JsonValue = JsonValue, Launch extends JsonValue = JsonValue>(root: string, descriptor: MaintenanceResumeDescriptor): MaintenanceResumeDocument<Inventory, Launch>;
+export declare function readMaintenanceJournal(root: string): MaintenanceJournal | undefined;
+/** Attempt binding persisted BEFORE the manager is fenced, so a crash between manager preparation
+ *  and the cut-intent journal write can retry with the exact attempt the manager already holds. */
+export interface PreservationPrepareIntent {
+    readonly attemptId: string;
+    readonly space: string;
+    readonly mode: MaintenanceAuthMode;
+    readonly server: string;
+    readonly storeDir: string;
+}
+export declare function writePreservationPrepareIntent(lock: MaintenanceLock, intent: PreservationPrepareIntent): void;
+export declare function readPreservationPrepareIntent(root: string): PreservationPrepareIntent | undefined;
+export declare function clearPreservationPrepareIntent(lock: MaintenanceLock): void;
+/** Persist source identity and launch provenance before manager commitment or any process stop. */
+export declare function beginMaintenanceCut(lock: MaintenanceLock, input: {
+    readonly attemptId: string;
+    readonly space: string;
+    readonly mode: MaintenanceAuthMode;
+    readonly sourcePath: string;
+    readonly resume: MaintenanceResumeDescriptor;
+    readonly launch: {
+        readonly server: string;
+        readonly [key: string]: JsonValue;
+    };
+}): MaintenanceCutIntentRecord;
+/** Abandon an uncommitted cut: before `cut-committed`, no suppression is durable and no process was
+ *  stopped by the cut, so the intent may be safely abandoned instead of wedging on lost manager
+ *  memory. The content-addressed resume document is left in place for inspection. */
+export declare function abortMaintenanceCut(lock: MaintenanceLock): MaintenanceCutIntentRecord;
+/** Fsync the manager's preservation commitment BEFORE any process stop, so a crash between manager
+ *  commit and the ready promotion recovers idempotently without requiring a live manager. */
+export declare function recordPreservationManagerCommit(lock: MaintenanceLock, managerCommit: MaintenanceCutCompletionEvidence["managerCommit"]): MaintenanceCutCommittedRecord;
+/** Promote only the exact durable cut after all stopped/unreachable evidence has been supplied. */
+export declare function completeMaintenanceCut(lock: MaintenanceLock, evidence: MaintenanceCutCompletionEvidence): MaintenanceReadyRecord;
+export declare function claimMaintenanceReady(lock: MaintenanceLock, claim: MaintenanceClaim): MaintenanceClaimedRecord;
+/** Merge broker/watchdog owners and attempt-owned slots into the live claim. A slot journaled
+ *  before its path exists ("pending") is upgraded in place once the exact inode is known. */
+export declare function recordMaintenanceClaimResources(lock: MaintenanceLock, input: {
+    readonly owners?: readonly ProcessOwner[];
+    readonly ownedPaths?: readonly AttemptOwnedPath[];
+}): MaintenanceClaimedRecord;
+export declare function releaseMaintenanceClaim(lock: MaintenanceLock, attemptId: string): MaintenanceReadyRecord;
+export declare function recoverStaleMaintenanceClaim(lock: MaintenanceLock, options?: {
+    readonly now?: Date;
+    readonly ownerStatus?: (owner: ProcessOwner) => OwnerStatus;
+}): MaintenanceReadyRecord;
+/**
+ * Fsync normal-listener launch provenance before exposure. A crash after this transition is
+ * intentionally ambiguous: callers must inspect/recover forward or record `resume-degraded`.
+ */
+export declare function beginOrdinaryResume(lock: MaintenanceLock, input: {
+    readonly attemptId: string;
+    readonly launch: {
+        readonly [key: string]: JsonValue;
+    };
+}): OrdinaryResumeIntentRecord;
+/** Fsync the exact ordinary-resume listener identity after spawn and before activation. The
+ *  proof's target is the preserved SOURCE store. */
+export declare function bindOrdinaryResumeListener(lock: MaintenanceLock, proof: RestoreListenerProof): OrdinaryResumeIntentRecord | OrdinaryResumeDegradedRecord;
+/** Retire one exactly bound, provably dead resume listener before a fresh proof may be bound. A
+ *  manager-committed resume never replaces its listener: the durable token is bound to it. */
+export declare function replaceDeadOrdinaryResumeListener(lock: MaintenanceLock, proof: RestoreListenerProof, options?: ReplaceDeadRestoreListenerOptions): OrdinaryResumeIntentRecord | OrdinaryResumeActiveRecord | OrdinaryResumeDegradedRecord;
+/** Record that the normal listener is ready and retained principals were activated successfully. */
+export declare function markOrdinaryResumeActive(lock: MaintenanceLock, activation: OrdinaryResumeActivationEvidence): OrdinaryResumeActiveRecord;
+/** Preserve an ambiguous or failed post-intent result without rolling back or deleting any bytes. */
+export declare function markOrdinaryResumeDegraded(lock: MaintenanceLock, reason: string, recourse: readonly MaintenanceRecourse[]): OrdinaryResumeDegradedRecord;
+/** Fsync the manager's suppression-retaining commit token before requesting finalization. */
+export declare function recordOrdinaryResumeManagerCommit(lock: MaintenanceLock, evidence: ManagerCommitEvidence): OrdinaryResumeCommittedRecord;
+/** Durably authorize journal consumption only after exact token-bound manager finalization. */
+export declare function retireOrdinaryResume(lock: MaintenanceLock, retirement: ManagerFinalizeEvidence): OrdinaryResumeRetiredRecord;
+/**
+ * Consume only a durable retired marker. The source store and content-addressed resume document are
+ * deliberately left untouched; a crash leaves either `resume-retired` or an absent journal.
+ */
+export declare function consumeRetiredMaintenance(lock: MaintenanceLock): OrdinaryResumeRetiredRecord;
+export interface RestoreClaimInput {
+    readonly deadline: string;
+    readonly coordinator?: ProcessOwner;
+    readonly ownedPaths?: readonly AttemptOwnedPath[];
+}
+/** Assess the recorded pre-commit liveness claim. `live` while the deadline has not elapsed or any
+ *  recorded owner is alive; `stale` only when the deadline elapsed AND every owner is proven dead. */
+export declare function assessRestoreClaim(record: RestoreReadyRecord, options?: {
+    readonly now?: Date;
+    readonly ownerStatus?: (owner: ProcessOwner) => OwnerStatus;
+}): RestoreClaimAssessment;
+/** Append broker/watchdog owners and attempt-owned working trees to the live restore attempt so
+ *  recovery can refuse while they live and delete exactly these inodes once they are proven dead. */
+export declare function recordRestoreAttemptResources(lock: MaintenanceLock, input: {
+    readonly owners?: readonly ProcessOwner[];
+    readonly ownedPaths?: readonly AttemptOwnedPath[];
+}): RestoreReadyRecord;
+export declare function prepareSamePathRestore(lock: MaintenanceLock, input: {
+    readonly attemptId: string;
+    readonly targetPath: string;
+    readonly fallbackPath: string;
+    readonly claim: RestoreClaimInput;
+}): RestoreReadyRecord;
+export declare function interpretPendingStoreMove(record: RestoreReadyRecord): "not-moved" | "moved";
+/**
+ * Move the stopped source after interpreting either crash side. This is a cooperative filesystem
+ * transition: the caller must first prove every broker and other non-Cotal store user has exited.
+ * The maintenance lock excludes Cotal peers; it is not a shared-store lock for raw processes.
+ */
+export declare function moveSamePathRestoreSource(lock: MaintenanceLock): RestoreReadyRecord;
+export declare function prepareAlternateRestore(lock: MaintenanceLock, input: {
+    readonly attemptId: string;
+    readonly targetPath: string;
+    readonly claim: RestoreClaimInput;
+}): RestoreReadyRecord;
+export declare function prepareMissingSourceRestore(lock: MaintenanceLock, input: {
+    readonly attemptId: string;
+    readonly targetPath: string;
+    readonly claim: RestoreClaimInput;
+}): RestoreReadyRecord;
+export declare function bindRestoreTarget(lock: MaintenanceLock): RestoreReadyRecord;
+export declare function writeRestoreCommitIntent(lock: MaintenanceLock, launch: {
+    readonly [key: string]: JsonValue;
+}): CommitIntentRecord;
+/** Fsync the exact normal listener identity after spawn and before activation is published. */
+export declare function bindRestoreListener(lock: MaintenanceLock, proof: RestoreListenerProof): CommitIntentRecord;
+/**
+ * Retire one exactly bound, provably dead listener without changing the restore attempt. The
+ * atomic journal transition clears the current proof before another listener may be spawned.
+ */
+export declare function replaceDeadRestoreListener(lock: MaintenanceLock, proof: RestoreListenerProof, options?: ReplaceDeadRestoreListenerOptions): CommitIntentRecord;
+/** Fsync the manager's suppression-retaining commit token before requesting finalization. */
+export declare function recordRestoreManagerCommit(lock: MaintenanceLock, proof: RestoreListenerProof, evidence: ManagerCommitEvidence): RestoreManagerCommittedRecord;
+export declare function markRestoreActive(lock: MaintenanceLock, proof: RestoreListenerProof, evidence: ManagerFinalizeEvidence): RestoreActiveRecord;
+export declare function markRestoreDegraded(lock: MaintenanceLock, reason: string, recourse: readonly MaintenanceRecourse[]): RestoreDegradedRecord;
+/** Recover forward only by re-presenting the exact bound listener plus fresh readiness evidence. */
+export declare function repairRestoreDegradedToActive(lock: MaintenanceLock, proof: RestoreListenerProof, evidence: ManagerFinalizeEvidence): RestoreActiveRecord;
+export interface RollbackRestoreOptions {
+    /** Exact live-claim coordinator identity: the owning coordinator rolling back its own attempt. */
+    readonly asCoordinator?: ProcessOwner;
+    readonly now?: Date;
+    readonly ownerStatus?: (owner: ProcessOwner) => OwnerStatus;
+}
+export declare function rollbackRestore(lock: MaintenanceLock, options?: RollbackRestoreOptions): MaintenanceReadyRecord;
+export declare function cleanupRestoreFallback(lock: MaintenanceLock, attemptId: string): RestoreActiveRecord;
+export {};
+//# sourceMappingURL=maintenance.d.ts.map

package/dist/maintenance.d.ts.map

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