Arcane.system.saveFailurePolicy()

This focused page is derived from the mechanically checked full member inventory.

Syntax

Arcane.system.saveFailurePolicy(settings)

Parameters

{failFast:boolean}

Return value

Promise<{failFast:boolean}>

Description

Saves warn-first (false) or fail-fast (true) behavior. The preference does not expose quarantined documents or relax repository-write validation. Settings only.

Overview

Arcane.system.saveFailurePolicy(settings) persists the user-wide verification behavior. It requires preferences.write, app id settings, and the exclusive Core mutation boundary. settings must be an exact object containing only the boolean failFast field; values are not coerced.

The change affects subsequently created tracked operations. It does not change an already running operation and cannot weaken hard trust, authority, privilege, or integrity checks.

Result and side effect

The exact result is {failFast: boolean} with the saved value. A real host durably replaces the protected user-wide policy record; simulation changes only simulation state. The method emits no standard operation event.

Errors and recovery

INVALID_FAILURE_POLICY rejects missing, nonboolean, or extra fields. METHOD_NOT_ALLOWED means the caller is not admitted Settings. OPERATION_BUSY means another exclusive mutation is active; wait, re-read the policy, and let the operator confirm the still-desired value.

Example

async function saveFailurePolicyAfterConfirmation(failFast, confirmChange) {
    if (!confirmChange(failFast)) {
        return null;
    }
    return Arcane.system.saveFailurePolicy({failFast});
}

Reference group

Platform, installation, users, and system