Complete central provider, resource, scheduling, and recovery contracts

src/apps/cli/commands/centralRemoteAdministration.ts

@@ -30,6 +30,10 @@ function detailMessage(detail: unknown): string {
     return detail instanceof Error ? detail.message : String(detail);
 }
 
+function assertNeverCentralRemoteAdministrationFailureReason(reason: never): never {
+    throw new Error(`Unexpected central remote administration failure reason: ${String(reason)}`);
+}
+
 function reportMilestoneObservation(
     standardIo: StandardIo,
     observation: Extract<
@@ -56,7 +60,8 @@ function reportCentralRemoteAdministrationResult(
         return;
     }
 
-    switch (result.reason) {
+    const reason = result.reason;
+    switch (reason) {
         case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.NO_ACTIVE_REPLICATOR:
             standardIo.writeStderr("[Verification] No active replicator found\n");
             return;
@@ -65,6 +70,11 @@ function reportCentralRemoteAdministrationResult(
                 `[Verification] Failed to connect to the configured remote: ${detailMessage(result.detail)}\n`
             );
             return;
+        case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.ACTIVE_CONFIGURATION_MISMATCH:
+            standardIo.writeStderr(
+                "[Verification] The active remote configuration changed before remote administration could begin.\n"
+            );
+            return;
         case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.MILESTONE_NOT_FOUND:
             standardIo.writeStderr("[Verification] Milestone document not found on remote.\n");
             return;
@@ -83,6 +93,8 @@ function reportCentralRemoteAdministrationResult(
         case CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.POSTCONDITION_MISMATCH:
             standardIo.writeStderr("[Verification] The requested remote state was not observed.\n");
             return;
+        default:
+            return assertNeverCentralRemoteAdministrationFailureReason(reason);
     }
 }
 

src/apps/cli/commands/runCommand.unit.spec.ts

@@ -786,6 +786,29 @@ describe("runCommand abnormal cases", () => {
             expect(verificationOutput).not.toContain("CouchDB");
         });
 
+        it("reports when the active remote configuration changes before administration begins", async () => {
+            const core = createCoreMock();
+            core.services.replicator.runCentralRemoteAdministration.mockResolvedValueOnce({
+                status: CENTRAL_REMOTE_ADMINISTRATION_RESULT_STATUSES.VERIFICATION_FAILED,
+                reason: CENTRAL_REMOTE_ADMINISTRATION_FAILURE_REASONS.ACTIVE_CONFIGURATION_MISMATCH,
+            });
+
+            const result = await runCommand(makeOptions("mark-resolved", []), {
+                ...context,
+                core,
+            });
+
+            expect(result).toBe(false);
+            const verificationOutput = core.services.context.standardIo.writeStderr.mock.calls
+                .map(([chunk]: [string | Uint8Array]) =>
+                    typeof chunk === "string" ? chunk : new TextDecoder().decode(chunk)
+                )
+                .join("");
+            expect(verificationOutput).toContain(
+                "[Verification] The active remote configuration changed before remote administration could begin.\n"
+            );
+        });
+
         it("fails by default when remote administration cannot verify its postcondition", async () => {
             const core = createCoreMock();
             core.services.replicator.runCentralRemoteAdministration.mockResolvedValueOnce({