Function getBackendDiagnosticGuide

Returns
    | {
        code: "stale_read";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "refresh-and-replan";
            message: "Discard the incomplete model/bytes read and restart with readSessionState. Use its revision for every readResourceBytes call. No historical state is retained or reserved; do not combine resources from different edit revisions.";
        };
    }
    | {
        code: "session_read_failed";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Inspect error.reason: invalid_query requires valid inputs; not_found/ambiguous requires exact current resource identifiers; unsupported_resource/bytes_unavailable means primary bytes cannot be read from this session. Budget or non-JSON failures require host inspection. Preserve unsaved work; do not save, reopen, repair or mutate the model merely to obtain a read.";
        };
    }
    | {
        code: "transaction_preview_failed";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "No complete preview is available. Inspect error.reason with the host: response_budget_exceeded requires a smaller independently meaningful authorized batch; projection_failed requires inspecting the project serialization failure. Preserve the session and never treat a missing or truncated impact as approval to apply or save.";
        };
    }
    | {
        code: "stale_write";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "refresh-and-replan";
            message: "Refresh the outline and affected entities, then replan from their current revision and preflight again. A preview reserves no revision. Never replace expectedRevision and blindly retry the original transaction or save.";
        };
    }
    | {
        code: "entity_query_failed";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Inspect error.reason: invalid_query requires correcting the target; not_found/ambiguous requires current exact identifiers; response_budget_exceeded/non_json_value requires host inspection of the entity. Do not broaden queries or mutate data to evade the response limits.";
        };
    }
    | {
        code: "session_not_found";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Ask the host to confirm the runtime and project, recover any unsaved state, then explicitly open a new session if appropriate. Session IDs are runtime-local. Read its new revision and replan; never reuse an expired session or assume disk contains unsaved changes.";
        };
    }
    | {
        code: "session_close_failed";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "The session and lock ownership remain registered. Inspect the reported lock release failure, correct the storage problem, then retry closeSession with the same session ID. Do not remove the lock file or open a replacement session to bypass the owner.";
        };
    }
    | {
        code: "path_policy_violation";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Ask the host to review the attempted path and authorized project root. saveSession only writes the original project; it is not Save As. Do not widen allowed roots or bypass path checks. A separately authorized export may use materializeSession.";
        };
    }
    | {
        code: "project_root_not_allowed";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Ask the host to review the attempted path and authorized project root. saveSession only writes the original project; it is not Save As. Do not widen allowed roots or bypass path checks. A separately authorized export may use materializeSession.";
        };
    }
    | {
        code: "invalid_package_selector";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-selector";
            message: "Read the current outline and query the relevant entity. Use its exact identifiers, inspect the reported selector path, then rebuild and preflight the transaction. Do not guess identifiers or retry the unchanged transaction.";
        };
    }
    | {
        code: "invalid_component_selector";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-selector";
            message: "Read the current outline and query the relevant entity. Use its exact identifiers, inspect the reported selector path, then rebuild and preflight the transaction. Do not guess identifiers or retry the unchanged transaction.";
        };
    }
    | {
        code: "invalid_resource_selector";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-selector";
            message: "Read the current outline and query the relevant entity. Use its exact identifiers, inspect the reported selector path, then rebuild and preflight the transaction. Do not guess identifiers or retry the unchanged transaction.";
        };
    }
    | {
        code: "invalid_display_node_selector";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-selector";
            message: "Read the current outline and query the relevant entity. Use its exact identifiers, inspect the reported selector path, then rebuild and preflight the transaction. Do not guess identifiers or retry the unchanged transaction.";
        };
    }
    | {
        code: "invalid_resource_folder_selector";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-selector";
            message: "Read the current outline and query the relevant entity. Use its exact identifiers, inspect the reported selector path, then rebuild and preflight the transaction. Do not guess identifiers or retry the unchanged transaction.";
        };
    }
    | {
        code: "invalid_branch_selector";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-selector";
            message: "Read the current outline and query the relevant entity. Use its exact identifiers, inspect the reported selector path, then rebuild and preflight the transaction. Do not guess identifiers or retry the unchanged transaction.";
        };
    }
    | {
        code: "invalid_gear_selector";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-selector";
            message: "Read the current outline and query the relevant entity. Use its exact identifiers, inspect the reported selector path, then rebuild and preflight the transaction. Do not guess identifiers or retry the unchanged transaction.";
        };
    }
    | {
        code: "invalid_look_gear_selector";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-selector";
            message: "Read the current outline and query the relevant entity. Use its exact identifiers, inspect the reported selector path, then rebuild and preflight the transaction. Do not guess identifiers or retry the unchanged transaction.";
        };
    }
    | {
        code: "selector_ambiguity";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-selector";
            message: "Read the current outline and query the relevant entity. Use its exact identifiers, inspect the reported selector path, then rebuild and preflight the transaction. Do not guess identifiers or retry the unchanged transaction.";
        };
    }
    | {
        code: "unavailable_resource_source_bytes";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "host-action";
            message: "Ask the host to inspect the reported source and hydrate its bytes through project I/O or import. Preserve unsaved work; reopening disk state can discard it. No session hydration/repair API is exposed. Revalidate and replan after the host has supplied a complete project.";
        };
    }
    | {
        code: "missing_source";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Ask the host to inspect the reported source and hydrate its bytes through project I/O or import. Preserve unsaved work; reopening disk state can discard it. No session hydration/repair API is exposed. Revalidate and replan after the host has supplied a complete project.";
        };
    }
    | {
        code: "unreadable_source";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Ask the host to inspect the reported source and hydrate its bytes through project I/O or import. Preserve unsaved work; reopening disk state can discard it. No session hydration/repair API is exposed. Revalidate and replan after the host has supplied a complete project.";
        };
    }
    | {
        code: "decode_capability_unavailable";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Validation is incomplete, not passed. Inspect whether source bytes are unloaded or a decoder is unavailable. Ask the host to hydrate sources or provide the required decoder (Node image validation uses optional Sharp), then validate again. Do not install dependencies or change the project automatically.";
        };
    }
    | {
        code: "session_id_conflict";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Use getSession to inspect the existing session. Reuse it only for the intended project, or choose a new session ID; do not close another owner\\u0027s session to make room.";
        };
    }
    | {
        code: "lock_conflict";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Another owner holds the project lock. Preserve unsaved work and ask that owner to close its session, then explicitly reopen. Never remove a live lock, force-close a peer, or bypass locking.";
        };
    }
    | {
        code: "event_cursor_invalid";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "refresh-and-replan";
            message: "Read the error and getEvents cursor bounds. Request a fresh bounded event page without the invalid cursor and refresh the current outline before replanning; missing retained history is not evidence that nothing changed.";
        };
    }
    | {
        code: "corrupt_source";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Ask the host to inspect the reported source and hydrate its bytes through project I/O or import. Preserve unsaved work; reopening disk state can discard it. No session hydration/repair API is exposed. Revalidate and replan after the host has supplied a complete project.";
        };
    }
    | {
        code: "unsupported_operation";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "transaction_unsupported";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "unsupported_display_node_kind";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "unsupported_cross_package_image_ref";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "unsupported_gear_kind";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "unsupported_resource_mutation";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "unsupported_display_node_mutation";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "unsupported_text_field_target";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "unsupported_display_node_field";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "unsupported_operation_batch";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "unsupported_resource_kind";
        docsUri: string;
        owners: readonly ["core.transaction", "core.validation"];
        remediation: {
            kind: "revise-operation";
            message: "Read the operation schema, capabilities and reported target kind/field. Stop unsupported work or replan using supported operations with equivalent intended semantics. Never silently drop fields or objects to make a transaction pass.";
        };
    }
    | {
        code: "invalid_project_settings";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_package_settings";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_display_node_payload";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_resource_name";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_resource_path";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_resource_folder_path";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_resource_folder_atlas";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_attach_index";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_controller_payload";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_transition_payload";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_look_gear_payload";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_gear_payload";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_resource_payload";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_resource_bytes";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_movie_clip_jta";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_resource_index";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_branch_name";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_package_payload";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_package_index";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_component_payload";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_component_index";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_component_move";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "invalid_uam";
        docsUri: string;
        owners: readonly ["core.transaction", "core.validation"];
        remediation: {
            kind: "revise-operation";
            message: "Inspect the diagnostic path and current operation schema or UAM issues. Correct values, required fields and indices against exact queried entities, then preflight. Do not invent defaults or coerce away invalid data.";
        };
    }
    | {
        code: "project_settings_unchanged";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "refresh-and-replan";
            message: "Query current settings/entity and compare with the request. If already satisfied, report no change; otherwise replan from the current revision. Do not manufacture a mutation or resubmit the same no-op.";
        };
    }
    | {
        code: "package_settings_unchanged";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "refresh-and-replan";
            message: "Query current settings/entity and compare with the request. If already satisfied, report no change; otherwise replan from the current revision. Do not manufacture a mutation or resubmit the same no-op.";
        };
    }
    | {
        code: "display_node_props_unchanged";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "refresh-and-replan";
            message: "Query current settings/entity and compare with the request. If already satisfied, report no change; otherwise replan from the current revision. Do not manufacture a mutation or resubmit the same no-op.";
        };
    }
    | {
        code: "resource_folder_atlas_unchanged";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "refresh-and-replan";
            message: "Query current settings/entity and compare with the request. If already satisfied, report no change; otherwise replan from the current revision. Do not manufacture a mutation or resubmit the same no-op.";
        };
    }
    | {
        code: "duplicate_look_gear_controller";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "duplicate_transition_name";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "duplicate_look_gear_state_page";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "duplicate_gear_controller";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "duplicate_gear_state_page";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "duplicate_branch_name";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "duplicate_component_id";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "resource_folder_conflict";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "duplicate_resource_id";
        docsUri: string;
        owners: readonly ["core.transaction", "core.validation"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "duplicate_package_id";
        docsUri: string;
        owners: readonly ["core.transaction", "core.validation"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "duplicate_package_name";
        docsUri: string;
        owners: readonly ["core.transaction", "core.validation"];
        remediation: {
            kind: "revise-operation";
            message: "Query current entities and resolve the conflicting ID, name or page explicitly. Choose an unused value only when authorized by the intended edit, then preflight. Never overwrite or delete an existing entity to clear the conflict.";
        };
    }
    | {
        code: "resource_folder_not_empty";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query affected entities and references before editing, moving or removing anything. Replan intended dependent changes together and preflight. Do not delete dependent objects or strip references without authorization.";
        };
    }
    | {
        code: "branch_not_empty";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query affected entities and references before editing, moving or removing anything. Replan intended dependent changes together and preflight. Do not delete dependent objects or strip references without authorization.";
        };
    }
    | {
        code: "branch_referenced";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query affected entities and references before editing, moving or removing anything. Replan intended dependent changes together and preflight. Do not delete dependent objects or strip references without authorization.";
        };
    }
    | {
        code: "invalid_resource_reference";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query affected entities and references before editing, moving or removing anything. Replan intended dependent changes together and preflight. Do not delete dependent objects or strip references without authorization.";
        };
    }
    | {
        code: "invalid_component_reference";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query affected entities and references before editing, moving or removing anything. Replan intended dependent changes together and preflight. Do not delete dependent objects or strip references without authorization.";
        };
    }
    | {
        code: "invalid_group_reference";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query affected entities and references before editing, moving or removing anything. Replan intended dependent changes together and preflight. Do not delete dependent objects or strip references without authorization.";
        };
    }
    | {
        code: "package_referenced";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query affected entities and references before editing, moving or removing anything. Replan intended dependent changes together and preflight. Do not delete dependent objects or strip references without authorization.";
        };
    }
    | {
        code: "component_referenced";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query affected entities and references before editing, moving or removing anything. Replan intended dependent changes together and preflight. Do not delete dependent objects or strip references without authorization.";
        };
    }
    | {
        code: "component_has_package_dependencies";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "revise-operation";
            message: "Query affected entities and references before editing, moving or removing anything. Replan intended dependent changes together and preflight. Do not delete dependent objects or strip references without authorization.";
        };
    }
    | {
        code: "dangling_resource_reference";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "revise-operation";
            message: "Query affected entities and references before editing, moving or removing anything. Replan intended dependent changes together and preflight. Do not delete dependent objects or strip references without authorization.";
        };
    }
    | {
        code: "invalid_project_xml";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Inspect the project path and validation diagnostics with the host. Correct source XML/settings or unsupported geometry using authoritative project data; preserve originals and unsaved work before reopening or validating. Do not guess missing structure or discard rejected content.";
        };
    }
    | {
        code: "invalid_package_xml";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Inspect the project path and validation diagnostics with the host. Correct source XML/settings or unsupported geometry using authoritative project data; preserve originals and unsaved work before reopening or validating. Do not guess missing structure or discard rejected content.";
        };
    }
    | {
        code: "invalid_branch_package_xml";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Inspect the project path and validation diagnostics with the host. Correct source XML/settings or unsupported geometry using authoritative project data; preserve originals and unsaved work before reopening or validating. Do not guess missing structure or discard rejected content.";
        };
    }
    | {
        code: "invalid_component_xml";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Inspect the project path and validation diagnostics with the host. Correct source XML/settings or unsupported geometry using authoritative project data; preserve originals and unsaved work before reopening or validating. Do not guess missing structure or discard rejected content.";
        };
    }
    | {
        code: "invalid_project_value";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Inspect the project path and validation diagnostics with the host. Correct source XML/settings or unsupported geometry using authoritative project data; preserve originals and unsaved work before reopening or validating. Do not guess missing structure or discard rejected content.";
        };
    }
    | {
        code: "desktop_incompatible_geometry";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Inspect the project path and validation diagnostics with the host. Correct source XML/settings or unsupported geometry using authoritative project data; preserve originals and unsaved work before reopening or validating. Do not guess missing structure or discard rejected content.";
        };
    }
    | {
        code: "invalid_settings_json";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Inspect the project path and validation diagnostics with the host. Correct source XML/settings or unsupported geometry using authoritative project data; preserve originals and unsaved work before reopening or validating. Do not guess missing structure or discard rejected content.";
        };
    }
    | {
        code: "path_collision";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Ask the host to review the attempted path and authorized project root. saveSession only writes the original project; it is not Save As. Do not widen allowed roots or bypass path checks. A separately authorized export may use materializeSession.";
        };
    }
    | {
        code: "unsafe_path";
        docsUri: string;
        owners: readonly ["core.validation"];
        remediation: {
            kind: "host-action";
            message: "Ask the host to review the attempted path and authorized project root. saveSession only writes the original project; it is not Save As. Do not widen allowed roots or bypass path checks. A separately authorized export may use materializeSession.";
        };
    }
    | {
        code: "capability_unavailable";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Read capability/error details. Ask the host to provide the required filesystem, decoder or complete UAM adapter. Preserve the session and unsaved work; do not substitute a lossy path or bypass checks.";
        };
    }
    | {
        code: "uam_fidelity_unsupported";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Read capability/error details. Ask the host to provide the required filesystem, decoder or complete UAM adapter. Preserve the session and unsaved work; do not substitute a lossy path or bypass checks.";
        };
    }
    | {
        code: "save_partial_failure";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Preserve the dirty session and inspect the error, actual target files and permissions with the host. Partial writes may have changed files: verify or recover them before a newly authorized save. Do not clear dirty state, discard memory or blindly retry.";
        };
    }
    | {
        code: "write_failed";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Preserve the dirty session and inspect the error, actual target files and permissions with the host. Partial writes may have changed files: verify or recover them before a newly authorized save. Do not clear dirty state, discard memory or blindly retry.";
        };
    }
    | {
        code: "project_open_failed";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Inspect the project path and validation diagnostics with the host. Correct source XML/settings or unsupported geometry using authoritative project data; preserve originals and unsaved work before reopening or validating. Do not guess missing structure or discard rejected content.";
        };
    }
    | {
        code: "materialize_validation_failed";
        docsUri: string;
        owners: readonly ["backend"];
        remediation: {
            kind: "host-action";
            message: "Inspect the project path and validation diagnostics with the host. Correct source XML/settings or unsupported geometry using authoritative project data; preserve originals and unsaved work before reopening or validating. Do not guess missing structure or discard rejected content.";
        };
    }
    | {
        code: "execution_failure";
        docsUri: string;
        owners: readonly ["core.transaction"];
        remediation: {
            kind: "host-action";
            message: "Inspect the execution/cache failure and current session/revision. Preserve sources and unsaved work and report the cause to the host. Replan after resolution; failed execution or cache work is not a completed edit.";
        };
    }