# Agent presets diagnostics

<!-- Generated by docs/modules/diagnostics from the package catalogs. Write a guide in docs/diagnostics/<CODE>.md instead of editing this file. -->

Each Agent presets error has a stable `code`. Its `docs` link opens the page of that code. This page lists all 177 codes, and [All diagnostics](https://vitehub.dev/docs/reference/diagnostics) lists every primitive.

## GitHub pull request operation errors

| Code | What happened |
| --- | --- |
| [`PRESETS_AUTO_MERGE_HEAD_UNCONFIRMED`](https://vitehub.dev/docs/presets/diagnostics/presets_auto_merge_head_unconfirmed) | GitHub did not confirm the expected pull request head. |
| [`PRESETS_AUTO_MERGE_REF_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_auto_merge_ref_changed) | Pull request ref changed during auto-merge admission. |
| [`PRESETS_AUTO_MERGE_UNCONFIRMED`](https://vitehub.dev/docs/presets/diagnostics/presets_auto_merge_unconfirmed) | GitHub did not confirm native auto-merge was enabled. |
| [`PRESETS_CHECKS_READ_INCOMPLETE`](https://vitehub.dev/docs/presets/diagnostics/presets_checks_read_incomplete) | GitHub could not read every check: \<warnings\> |
| [`PRESETS_COMMENT_MENTION_FORBIDDEN`](https://vitehub.dev/docs/presets/diagnostics/presets_comment_mention_forbidden) | Comments cannot contain GitHub mentions; use the guarded mention capability. |
| [`PRESETS_GITHUB_GRAPHQL_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_github_graphql_failed) | GitHub could not complete the pull request operation. |
| [`PRESETS_GITHUB_PAGINATION_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_github_pagination_invalid) | GitHub \<detail\>. |
| [`PRESETS_GITHUB_QUERY_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_github_query_failed) | GitHub could not complete the pull request query. |
| [`PRESETS_GITHUB_RESPONSE_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_github_response_invalid) | GitHub returned an invalid \<part\>. |
| [`PRESETS_MENTION_BODY_MENTION`](https://vitehub.dev/docs/presets/diagnostics/presets_mention_body_mention) | Mention body must not contain another mention. |
| [`PRESETS_MENTION_LOGIN_NOT_ALLOWED`](https://vitehub.dev/docs/presets/diagnostics/presets_mention_login_not_allowed) | GitHub login is not in the configured mention allowlist. |
| [`PRESETS_OPERATION_BASE_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_operation_base_changed) | Pull request base changed; discard this base CI comparison. |
| [`PRESETS_OPERATION_BASE_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_operation_base_missing) | This worker has no assigned base commit for CI comparison. |
| [`PRESETS_OPERATION_FILTER_MISMATCH`](https://vitehub.dev/docs/presets/diagnostics/presets_operation_filter_mismatch) | Pull request no longer matches the configured filter. |
| [`PRESETS_OPERATION_HEAD_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_operation_head_changed) | Pull request head changed; discard this worker's operations. |
| [`PRESETS_OPERATION_PULL_REQUEST_CLOSED`](https://vitehub.dev/docs/presets/diagnostics/presets_operation_pull_request_closed) | Pull request is no longer open and ready for repair. |
| [`PRESETS_OPERATION_UNAVAILABLE`](https://vitehub.dev/docs/presets/diagnostics/presets_operation_unavailable) | This worker has no \<operation\> operation. |
| [`PRESETS_PULL_REQUEST_BODY_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_pull_request_body_changed) | Pull request body changed while validating the update; retry. |
| [`PRESETS_PULL_REQUEST_BODY_MENTION`](https://vitehub.dev/docs/presets/diagnostics/presets_pull_request_body_mention) | Pull request bodies cannot add GitHub mentions; use the guarded mention capability. |
| [`PRESETS_PULL_REQUEST_INPUT_EMPTY`](https://vitehub.dev/docs/presets/diagnostics/presets_pull_request_input_empty) | \<name\> must not be empty. |
| [`PRESETS_PULL_REQUEST_UPDATE_EMPTY`](https://vitehub.dev/docs/presets/diagnostics/presets_pull_request_update_empty) | Provide a pull request title or body. |
| [`PRESETS_REPAIR_BASE_REVERTED`](https://vitehub.dev/docs/presets/diagnostics/presets_repair_base_reverted) | The merge result undoes changes that already landed on the base since this PR branched: \<files\> |
| [`PRESETS_REPAIR_CONFLICTS_UNRESOLVED`](https://vitehub.dev/docs/presets/diagnostics/presets_repair_conflicts_unresolved) | Resolve the remaining merge conflicts and call commitRepair with their file paths: \<files\> |
| [`PRESETS_REPAIR_INDEX_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_repair_index_changed) | Repair index changed during dependency validation. |
| [`PRESETS_REPAIR_INPUT_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_repair_input_missing) | A repair message and explicit file paths are required. |
| [`PRESETS_REPAIR_MERGE_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_repair_merge_changed) | Prepared merge metadata or index changed outside the host repair tools. |
| [`PRESETS_REPAIR_PATH_DIRECTORY`](https://vitehub.dev/docs/presets/diagnostics/presets_repair_path_directory) | Repair paths must name individual files. |
| [`PRESETS_REPAIR_PATH_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_repair_path_invalid) | Repair paths must name files inside the assigned checkout. |
| [`PRESETS_REPAIR_STAGED_CHANGES`](https://vitehub.dev/docs/presets/diagnostics/presets_repair_staged_changes) | Repair checkout contains unrelated staged changes. |
| [`PRESETS_REVIEW_THREAD_NOT_FOUND`](https://vitehub.dev/docs/presets/diagnostics/presets_review_thread_not_found) | Review thread does not belong to this pull request. |
| [`PRESETS_WORKFLOW_RUN_BASE_MISMATCH`](https://vitehub.dev/docs/presets/diagnostics/presets_workflow_run_base_mismatch) | Workflow run does not belong to this pull request's exact base commit. |
| [`PRESETS_WORKFLOW_RUN_HEAD_MISMATCH`](https://vitehub.dev/docs/presets/diagnostics/presets_workflow_run_head_mismatch) | Workflow run does not belong to this pull request head. |
| [`PRESETS_WORKFLOW_RUN_ID_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_workflow_run_id_invalid) | Expected a positive workflow run ID. |
| [`PRESETS_WORKSPACE_GIT_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_workspace_git_invalid) | Provider workspace must use an independent Git directory. |
| [`PRESETS_WORKSPACE_OVERLAPS_CHECKOUT`](https://vitehub.dev/docs/presets/diagnostics/presets_workspace_overlaps_checkout) | Provider workspace must be separate from prepared checkout. |

## Babysitter pass and inbox errors

| Code | What happened |
| --- | --- |
| [`PRESETS_BABYSITTER_ADMISSION_CHECK_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_admission_check_invalid) | Invalid admission.check result. Expected undefined or { reason, detail, retryAt }. |
| [`PRESETS_BABYSITTER_CHECKOUT_POOL_REPLACED`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_checkout_pool_replaced) | Refusing to clean replaced Babysitter checkout pool: \<path\> |
| [`PRESETS_BABYSITTER_CHECKOUT_POOL_UNSAFE`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_checkout_pool_unsafe) | Refusing to clean unsafe Babysitter checkout pool: \<root\> |
| [`PRESETS_BABYSITTER_GITHUB_CURSOR_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_github_cursor_invalid) | Invalid \<kind\> cursor |
| [`PRESETS_BABYSITTER_GITHUB_HEAD_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_github_head_missing) | GitHub returned no pull request head. |
| [`PRESETS_BABYSITTER_GITHUB_QUERY_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_github_query_failed) | GitHub \<query\> query failed: \<errors\> |
| [`PRESETS_BABYSITTER_HOST_EXECUTABLE_UNAVAILABLE`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_host_executable_unavailable) | The host executable \<program\> \<problem\>. |
| [`PRESETS_BABYSITTER_INBOX_STORAGE_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_inbox_storage_missing) | PullRequestInbox requires exactly one of path or storage. |
| [`PRESETS_BABYSITTER_PROMPT_TOO_LARGE`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_prompt_too_large) | GitHubPullRequest prompt exceeds transport safety limit: \<characters\> characters, \<bytes\> UTF-8 bytes; limit \<limit\>. All review/comment bodies were retained. No truncated prompt was sent. |
| [`PRESETS_DEPENDENCY_CHECKS_INCOMPLETE`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_checks_incomplete) | Dependency checks are incomplete: \<warnings\> |
| [`PRESETS_FEEDBACK_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_feedback_changed) | Feedback changed during pagination. Read again from offset zero. |
| [`PRESETS_FEEDBACK_NOT_FOUND`](https://vitehub.dev/docs/presets/diagnostics/presets_feedback_not_found) | Feedback is absent or deleted from the assigned PR snapshot. |
| [`PRESETS_FEEDBACK_OFFSET_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_feedback_offset_invalid) | Feedback offset exceeds the body length. |
| [`PRESETS_FEEDBACK_VERSION_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_feedback_version_missing) | Continue with the version returned by the first feedback read. |
| [`PRESETS_SANDBOX_BUNDLE_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_bundle_missing) | The repair Sandbox bundle is unavailable. |
| [`PRESETS_SANDBOX_COMMIT_EXPORT_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_commit_export_failed) | Cannot export the repair Sandbox commit: \<stderr\> |
| [`PRESETS_SANDBOX_COMMIT_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_commit_missing) | The repair Sandbox did not return a commit SHA. |
| [`PRESETS_SANDBOX_HEAD_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_head_changed) | The repair Sandbox HEAD changed during export. |
| [`PRESETS_SANDBOX_REPAIR_DESTINATION_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_repair_destination_changed) | Repair destination parent changed during transfer. |
| [`PRESETS_SANDBOX_REPAIR_DESTINATION_OUTSIDE`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_repair_destination_outside) | Repair destination parent must stay inside the checkout. |
| [`PRESETS_SANDBOX_REPAIR_FILE_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_repair_file_missing) | The repair Sandbox file disappeared during transfer. |
| [`PRESETS_SANDBOX_REPAIR_PARENT_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_repair_parent_invalid) | Repair Sandbox parent must be a regular directory. |
| [`PRESETS_SANDBOX_REPAIR_PATH_DIRECTORY`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_repair_path_directory) | Repair paths must name individual files. |
| [`PRESETS_SANDBOX_REPAIR_PATH_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_repair_path_invalid) | Repair paths must name files inside the assigned checkout. |
| [`PRESETS_SANDBOX_SYNC_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_sandbox_sync_failed) | Cannot synchronize repair Sandbox files: \<stderr\> |

## Babysitter errors

| Code | What happened |
| --- | --- |
| [`PRESETS_BABYSITTER_AGENT_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_agent_invalid) | Babysitter runtime requires a configured Babysitter Agent Definition. |
| [`PRESETS_BABYSITTER_BASE_COMMIT_UNREADABLE`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_base_commit_unreadable) | Conflict repair requires the exact live base branch commit. |
| [`PRESETS_BABYSITTER_DIRECT_MERGE_CLAIM_LOST`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_direct_merge_claim_lost) | The direct merge claim of this pull request changed before the Babysitter could record that GitHub enqueued the merge. |
| [`PRESETS_BABYSITTER_DRIVER_UNSUPPORTED`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_driver_unsupported) | Babysitter requires a Codex or Claude Code driver for its isolated Git checkout. |
| [`PRESETS_BABYSITTER_EXTERNAL_STATE_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_external_state_missing) | Missing external pull-request state. |
| [`PRESETS_BABYSITTER_GITHUB_LIST_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_github_list_missing) | GitHub did not return a list for \<path\>. |
| [`PRESETS_BABYSITTER_IGNORE_AUTHORS_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_ignore_authors_invalid) | Babysitter ignoreFeedbackAuthors must list GitHub logins. |
| [`PRESETS_BABYSITTER_INSTALL_COMMAND_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_install_command_failed) | Dependency installation failed. |
| [`PRESETS_BABYSITTER_LIFECYCLE_LABELS_CONFLICT`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_lifecycle_labels_conflict) | Configure Babysitter lifecycle labels or filter.labels, not both. |
| [`PRESETS_BABYSITTER_MAIN_REPAIR_NEEDS_PREFIX`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_main_repair_needs_prefix) | Babysitter mainRepair needs a mainRepairBranchPrefix: repair PRs are opened on branches with that prefix. |
| [`PRESETS_BABYSITTER_MERGE_QUEUE_QUERY_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_merge_queue_query_failed) | GitHub merge queue query failed: \<errors\> |
| [`PRESETS_BABYSITTER_MINOR_ROUNDS_NEED_BUDGET`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_minor_rounds_need_budget) | Babysitter minorReviewRounds needs a reviewPushBudget: settled rounds spend that budget. |
| [`PRESETS_BABYSITTER_NO_FINDINGS_PREFIX_EMPTY`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_no_findings_prefix_empty) | Babysitter noFindingsReviews cannot contain an empty prefix. |
| [`PRESETS_BABYSITTER_RECONCILE_STALLED`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_reconcile_stalled) | The Babysitter reconcile waited \<minutes\> minutes in its \<step\> step, so the Babysitter stopped it. |
| [`PRESETS_BABYSITTER_STACK_REPAIR_NEEDS_DIRECT_MERGE`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_stack_repair_needs_direct_merge) | Babysitter repairStackChildren requires merge: "direct": only a direct merge stops a stack child from merging into its parent's branch. |
| [`PRESETS_BABYSITTER_TOOL_FIELD_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_tool_field_invalid) | \<key\> must be \<expected\>. |
| [`PRESETS_BABYSITTER_TOOL_FIELD_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_tool_field_missing) | Missing \<key\>. |
| [`PRESETS_BABYSITTER_TOOL_PATHS_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_tool_paths_missing) | Expected explicit repair paths. |
| [`PRESETS_BABYSITTER_TOOL_RUN_ID_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_tool_run_id_missing) | Expected a run ID. |
| [`PRESETS_BABYSITTER_TOOL_UPDATE_EMPTY`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_tool_update_empty) | Expected a title or body. |
| [`PRESETS_BABYSITTER_WAKE_REPOSITORY_UNKNOWN`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_wake_repository_unknown) | External wake repository is outside the configured repositories. |
| [`PRESETS_DAILY_PUSH_BUDGET_SPENT`](https://vitehub.dev/docs/presets/diagnostics/presets_daily_push_budget_spent) | Daily push budget spent: this PR has \<count\> repair pushes in the last 24 hours, and the next push is allowed at \<nextAt\>. |
| [`PRESETS_DEPENDENCY_PATCH_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_patch_missing) | Dependency patch \<path\> does not exist in this checkout. |
| [`PRESETS_DEPENDENCY_REFRESH_LIMIT`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_refresh_limit) | refreshDependencies already ran \<limit\> time\<value\> in this pass, the limit. |

## Labeller errors

| Code | What happened |
| --- | --- |
| [`PRESETS_BABYSITTER_ENV_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_env_missing) | The Babysitter cannot start without \<value\>. |
| [`PRESETS_BABYSITTER_OPTION_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_option_invalid) | Babysitter \<option\> must be \<expected\>. |
| [`PRESETS_BABYSITTER_PLACEMENT_CAPACITY`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_placement_capacity) | See the page of the code. |
| [`PRESETS_GITHUB_APP_OWNER_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_github_app_owner_missing) | `createGitHubAppCredentials()` got `installationId` without `owner`. An installation belongs to one repository owner. |
| [`PRESETS_LABELLER_ACTION_FLAG_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_action_flag_invalid) | Labeller \<name\> \<key\> must be a boolean. |
| [`PRESETS_LABELLER_ACTION_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_action_invalid) | Labeller action "\<label\>" must be an object. |
| [`PRESETS_LABELLER_ACTION_LABEL_UNDECLARED`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_action_label_undeclared) | Labeller action "\<label\>" refers to an undeclared label. |
| [`PRESETS_LABELLER_ACTIONS_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_actions_invalid) | Labeller actions must be an object. |
| [`PRESETS_LABELLER_BODY_LIMIT_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_body_limit_invalid) | Labeller bodyLimit must be an integer from 1 to \<max\>. |
| [`PRESETS_LABELLER_CLEANUP_AGENT_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_cleanup_agent_invalid) | cleanupLabeller() expects an Agent that extends labeller. |
| [`PRESETS_LABELLER_CLEANUP_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_cleanup_invalid) | Labeller cleanup must be an object. |
| [`PRESETS_LABELLER_CLEANUP_LABEL_NAME_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_cleanup_label_name_invalid) | Labeller cleanup rule "\<name\>" needs a label name without quotes, backslashes, or control characters. |
| [`PRESETS_LABELLER_CLEANUP_LABEL_UNDECLARED`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_cleanup_label_undeclared) | Labeller cleanup rule "\<name\>" refers to an undeclared label. |
| [`PRESETS_LABELLER_CLEANUP_OLDER_THAN_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_cleanup_older_than_invalid) | Labeller cleanup rule "\<name\>" needs olderThan as a positive whole number of days. |
| [`PRESETS_LABELLER_LABEL_COUNT_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_label_count_invalid) | Labeller labels must contain between 1 and 254 labels. |
| [`PRESETS_LABELLER_LABEL_NAME_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_label_name_invalid) | Labeller label "\<name\>" is reserved or invalid. |
| [`PRESETS_LABELLER_LABEL_SETTINGS_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_label_settings_invalid) | Labeller label "\<name\>" must be an object. |
| [`PRESETS_LABELLER_LABELS_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_labels_invalid) | Labeller labels must be an object. |
| [`PRESETS_LABELLER_MIN_CONFIDENCE_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_min_confidence_invalid) | Labeller minConfidence must be between 0 and 1. |
| [`PRESETS_LABELLER_OPTION_NOT_BOOLEAN`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_option_not_boolean) | Labeller \<key\> must be a boolean. |
| [`PRESETS_LABELLER_PATTERN_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_pattern_invalid) | Labeller patterns must be non-empty strings of at most \<max\> characters. |
| [`PRESETS_LABELLER_REGEX_ESCAPE_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_regex_escape_invalid) | Labeller regex patterns may only escape literal regex characters. |
| [`PRESETS_LABELLER_REGEX_FLAGS_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_regex_flags_invalid) | Labeller regex patterns use only bounded syntax and the i, m, s, and u flags. |
| [`PRESETS_LABELLER_REGEX_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_regex_invalid) | Labeller regex pattern is invalid. |
| [`PRESETS_LABELLER_REGEX_SYNTAX_UNSUPPORTED`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_regex_syntax_unsupported) | Labeller regex patterns may not use repetition or grouping. |
| [`PRESETS_LABELLER_RULE_HEADER_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_rule_header_invalid) | Labeller rule "\<name\>" has an invalid header name. |
| [`PRESETS_LABELLER_RULE_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_rule_invalid) | Labeller rule "\<name\>" must be an object. |
| [`PRESETS_LABELLER_RULE_LABEL_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_rule_label_missing) | Labeller rule "\<name\>" must declare a label before enabling actions. |
| [`PRESETS_LABELLER_RULE_LABEL_UNDECLARED`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_rule_label_undeclared) | Labeller rule "\<name\>" refers to an undeclared label. |
| [`PRESETS_LABELLER_RULE_NESTING_TOO_DEEP`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_rule_nesting_too_deep) | Labeller rules may nest at most eight not clauses. |
| [`PRESETS_LABELLER_RULES_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_labeller_rules_invalid) | Labeller rules must be an object. |
| [`PRESETS_MERGE_DRAFT_AUTHORS_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_merge_draft_authors_invalid) | Babysitter merge.markDraftsReady must be an array of GitHub logins. |
| [`PRESETS_REVIEW_CURSOR_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_review_cursor_invalid) | GitHub returned an invalid review comment cursor. |
| [`PRESETS_REVIEW_MENTION_FORBIDDEN`](https://vitehub.dev/docs/presets/diagnostics/presets_review_mention_forbidden) | Comments cannot contain GitHub mentions; use the guarded mention capability. |
| [`PRESETS_REVIEW_OUTCOME_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_review_outcome_invalid) | Review thread outcome must be one of fixed, disproved, declined, pre-existing, duplicate. |
| [`PRESETS_REVIEW_REASON_REQUIRED`](https://vitehub.dev/docs/presets/diagnostics/presets_review_reason_required) | A \<outcome\> review thread needs a one-sentence reason. |
| [`PRESETS_REVIEW_SEVERE_DECLINED`](https://vitehub.dev/docs/presets/diagnostics/presets_review_severe_declined) | A valid P0 or P1 finding cannot be declined, whatever the review push budget. |

## Errors

| Code | What happened |
| --- | --- |
| [`PRESETS_BABYSITTER_REPOSITORIES_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_repositories_invalid) | Babysitter filter.repository.allow lists no "owner/name" repository. |

## Review thread errors

| Code | What happened |
| --- | --- |
| [`PRESETS_BABYSITTER_STATUS_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_babysitter_status_invalid) | Babysitter status must be an object whose comment and checkRun fields are booleans. |
| [`PRESETS_CHECK_LOG_SELECTION_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_check_log_selection_invalid) | readCheckLogs got an invalid line selection: \<reason\> |
| [`PRESETS_CHECK_LOG_START_PAST_END`](https://vitehub.dev/docs/presets/diagnostics/presets_check_log_start_past_end) | startLine \<startLine\> is past the log's \<totalLines\> lines. |
| [`PRESETS_REVIEW_COMMENT_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_review_comment_missing) | Review thread has no comment to answer. |

## GitHub install and host errors

| Code | What happened |
| --- | --- |
| [`PRESETS_CHECKOUT_CLEANUP_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_checkout_cleanup_failed) | Could not locate disposable checkout for cleanup: \<checkout\> |
| [`PRESETS_COREPACK_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_corepack_missing) | Babysitter host installation requires Corepack in PATH. Install Corepack on the trusted host; Node 25 and newer do not bundle it. |
| [`PRESETS_DEPENDENCIES_NOT_CURRENT`](https://vitehub.dev/docs/presets/diagnostics/presets_dependencies_not_current) | Dependency inputs changed or installation failed. Call refreshDependencies and rerun validation before committing. |
| [`PRESETS_DEPENDENCY_GIT_HOST_LOCAL`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_git_host_local) | Host-local Git dependencies are not allowed. |
| [`PRESETS_DEPENDENCY_GIT_UNSUPPORTED`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_git_unsupported) | Git dependencies require preparation inside the provider sandbox. |
| [`PRESETS_DEPENDENCY_HOST_UNTRUSTED`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_host_untrusted) | Dependency downloads require a trusted HTTPS registry or forge. |
| [`PRESETS_DEPENDENCY_INPUT_SYMLINK`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_input_symlink) | Dependency inputs must not be symbolic links. |
| [`PRESETS_DEPENDENCY_INPUTS_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_inputs_changed) | Dependency inputs changed during installation. Call refreshDependencies again before validation. |
| [`PRESETS_DEPENDENCY_PATCH_NOT_FILE`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_patch_not_file) | Dependency patches must be regular files. |
| [`PRESETS_DEPENDENCY_PATCH_PATH_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_patch_path_invalid) | Dependency patches must reference checkout files. |
| [`PRESETS_DEPENDENCY_PATCHES_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_patches_invalid) | Dependency patches must be a path mapping. |
| [`PRESETS_DEPENDENCY_PATH_HOST_LOCAL`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_path_host_local) | Host-local dependency paths are not allowed. |
| [`PRESETS_DEPENDENCY_PATH_OUTSIDE`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_path_outside) | Host-local dependency paths must stay inside the checkout. |
| [`PRESETS_DEPENDENCY_PROTOCOL_UNSUPPORTED`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_protocol_unsupported) | Unsupported dependency source protocol; downloads require a trusted HTTPS registry or forge. |
| [`PRESETS_DEPENDENCY_SYMLINK_OUTSIDE`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_symlink_outside) | Host-local dependency symlinks must stay inside the checkout. |
| [`PRESETS_DEPENDENCY_URL_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_dependency_url_invalid) | Dependency downloads require a trusted HTTPS URL with forward slashes. |
| [`PRESETS_GITHUB_APP_CREDENTIALS_INCOMPLETE`](https://vitehub.dev/docs/presets/diagnostics/presets_github_app_credentials_incomplete) | GitHub App appId, installationId, and privateKey must be configured together. |
| [`PRESETS_GITHUB_APP_NUMBER_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_github_app_number_invalid) | \<name\> must be a positive integer. |
| [`PRESETS_GITHUB_APP_REQUEST_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_github_app_request_failed) | GitHub App request /app failed with \<status\>. |
| [`PRESETS_GITHUB_APP_RESPONSE_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_github_app_response_invalid) | GitHub App request /app returned a response that the host cannot read. |
| [`PRESETS_GITHUB_APP_TOKEN_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_github_app_token_failed) | GitHub App token request failed with \<status\>. |
| [`PRESETS_GITHUB_APP_TOKEN_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_github_app_token_missing) | GitHub App token response did not include a token. |
| [`PRESETS_GITHUB_AUTH_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_github_auth_missing) | GitHub authentication is not configured. Set VITEHUB_GITHUB_TOKEN or GitHub App credentials. |
| [`PRESETS_GITHUB_DEPENDENCY_CONFLICT`](https://vitehub.dev/docs/presets/diagnostics/presets_github_dependency_conflict) | Resolve dependency conflicts in \<file\> and call refreshDependencies before validation. |
| [`PRESETS_GITHUB_HOST_APP_OWNER_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_github_host_app_owner_missing) | GitHub App owner must be configured with App credentials. |
| [`PRESETS_GITHUB_INSTALL_FAILED`](https://vitehub.dev/docs/presets/diagnostics/presets_github_install_failed) | Frozen dependency installation failed: \<detail\> |
| [`PRESETS_GITHUB_REPOSITORY_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_github_repository_invalid) | Expected a GitHub repository in owner/name form. |
| [`PRESETS_INSTALL_OUTPUT_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_install_output_changed) | Dependency output directory changed during installation. |
| [`PRESETS_LINKED_BIN_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_linked_bin_changed) | Linked dependency bin target changed during snapshot validation. |
| [`PRESETS_LINKED_BIN_GIT_METADATA`](https://vitehub.dev/docs/presets/diagnostics/presets_linked_bin_git_metadata) | Linked dependency bin targets must not read Git metadata. |
| [`PRESETS_LINKED_BIN_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_linked_bin_invalid) | Linked dependency bin targets must be file paths. |
| [`PRESETS_LINKED_BIN_NOT_FILE`](https://vitehub.dev/docs/presets/diagnostics/presets_linked_bin_not_file) | Linked dependency bin targets must be regular files. |
| [`PRESETS_LINKED_BIN_OUTSIDE`](https://vitehub.dev/docs/presets/diagnostics/presets_linked_bin_outside) | Linked dependency bin targets must stay inside the checkout. |
| [`PRESETS_LOCAL_DEPENDENCY_CONTENTS_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_local_dependency_contents_invalid) | Local dependency contents must be regular files and directories. |
| [`PRESETS_LOCKFILE_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_lockfile_missing) | Frozen dependency installation requires a supported lockfile. |
| [`PRESETS_NPM_CONFIG_UNSUPPORTED`](https://vitehub.dev/docs/presets/diagnostics/presets_npm_config_unsupported) | Unsupported project npm configuration: \<key\>. Host-local configuration paths and package-manager extensions are not allowed. |
| [`PRESETS_NPM_VERSION_UNSUPPORTED`](https://vitehub.dev/docs/presets/diagnostics/presets_npm_version_unsupported) | Host installation requires npm 7 or newer; older npm can execute repository onload scripts. |
| [`PRESETS_NPM_WORKSPACE_LINK_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_npm_workspace_link_invalid) | npm workspace links must reference checkout-relative paths. |
| [`PRESETS_PACKAGE_MANAGER_UNSUPPORTED`](https://vitehub.dev/docs/presets/diagnostics/presets_package_manager_unsupported) | packageManager must select an official matching package-manager version. |
| [`PRESETS_PNPM_CONFIG_UNSUPPORTED`](https://vitehub.dev/docs/presets/diagnostics/presets_pnpm_config_unsupported) | Unsupported project pnpm configuration: \<key\>. Host-local configuration paths and package-manager extensions are not allowed. |
| [`PRESETS_PULL_REQUEST_HEAD_CHANGED`](https://vitehub.dev/docs/presets/diagnostics/presets_pull_request_head_changed) | Pull request head changed from \<expected\> to \<actual\>. |
| [`PRESETS_PULL_REQUEST_HEAD_REF_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_pull_request_head_ref_invalid) | A pull request headRef cannot start with a dash. |
| [`PRESETS_PULL_REQUEST_HEAD_REF_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_pull_request_head_ref_missing) | A pull request headRef is required when headRepository is supplied. |
| [`PRESETS_PULL_REQUEST_HEAD_SHA_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_pull_request_head_sha_invalid) | A pull request headSha must be a full Git commit SHA. |
| [`PRESETS_PULL_REQUEST_PUSH_TARGET_MISSING`](https://vitehub.dev/docs/presets/diagnostics/presets_pull_request_push_target_missing) | Pull request source repository and branch are required to push. |
| [`PRESETS_PUSH_TARGET_HEAD_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_push_target_head_invalid) | Push target did not return a full Git commit SHA. |
| [`PRESETS_PUSH_TARGET_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_push_target_invalid) | Push target must be the root of its prepared Git checkout. |
| [`PRESETS_YARN_LOCKFILE_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_yarn_lockfile_invalid) | Invalid Yarn lockfile stanza; dependency fields must be structured. |
| [`PRESETS_YARN_OUTPUT_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_yarn_output_invalid) | Yarn installation output must use a regular checkout directory. |
| [`PRESETS_YARN_PATCH_SELECTOR_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_yarn_patch_selector_invalid) | Yarn dependency patches must use project-relative ~/ selectors; parent package filesystems cannot be fingerprinted by the host. |

## Babysitter merge and review option errors

| Code | What happened |
| --- | --- |
| [`PRESETS_MERGE_BYPASS_CHECKS_INVALID`](https://vitehub.dev/docs/presets/diagnostics/presets_merge_bypass_checks_invalid) | Babysitter merge.bypassInheritedChecks must map repositories to check names. |

<!-- vitehub-docs:section-links -->
## In this section

- [Overview](https://vitehub.dev/raw/docs/presets.md)
- [Babysitter](https://vitehub.dev/raw/docs/presets/babysitter.md)
- [Workspace preset](https://vitehub.dev/raw/docs/presets/workspace.md)
- [Gmail Labeller preset](https://vitehub.dev/raw/docs/presets/labeller.md)

All pages: [llms.txt](https://vitehub.dev/llms.txt)
