{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "$id": "https://deltabox.studio/schemas/dbx.config.json",
    "title": "dbx.config",
    "description": "The dbx configuration model (the @deltabox/toolchain settings live under `toolchain`).",
    "type": "object",
    "properties": {
        "toolchain": {
            "$ref": "#/$defs/ToolchainConfigSections",
            "description": "The `@deltabox/toolchain` settings (every section is opt-in by presence)."
        }
    },
    "additionalProperties": false,
    "$defs": {
        "ToolchainConfigSections": {
            "type": "object",
            "properties": {
                "enabled": {
                    "$ref": "#/$defs/ToolchainEnabledConfig"
                },
                "project": {
                    "description": "Project metadata: canonical `package.json` fields and template tokens (inherited by workspaces).",
                    "$ref": "#/$defs/ToolchainProjectConfig"
                },
                "ci": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainCiConfig"
                        }
                    ],
                    "description": "GitHub Actions workflows to generate (CI, release, issues, changelog, sync)."
                },
                "changelog": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ChangelogConfig"
                        }
                    ],
                    "description": "Manual changelog pipeline options for `dbx changelog`, the VS Code actions and the API. `ci.changelog` inherits these options."
                },
                "fmt": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainFmtConfig"
                        }
                    ],
                    "description": "Formatter configuration: Oxc/Biome options, editor defaults and tools."
                },
                "lint": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainLintConfig"
                        }
                    ],
                    "description": "Linter configuration: Oxc/Biome/ESLint options and editor defaults."
                },
                "biome": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainBiomeConfig"
                        }
                    ],
                    "description": "Biome config generation (for consumers that still want a `biome.json`)."
                },
                "tsconfig": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainTsconfigConfig"
                        }
                    ],
                    "description": "Workspace tsconfig generation (path aliases + project references)."
                },
                "loader": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainLoaderConfig"
                        }
                    ],
                    "description": "How `dbx.config.*` files are imported (tsconfig discovery)."
                },
                "templates": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainTemplatesConfig"
                        }
                    ],
                    "description": "Template sources / scaffolding."
                },
                "registry": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainRegistryConfig"
                        }
                    ],
                    "description": "Allow/deny host and path globs for template/provider registries."
                },
                "catalogs": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainCatalogsConfig"
                        }
                    ],
                    "description": "Package catalogs written to the package manager catalog file (`catalog:`)."
                },
                "vite": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainViteConfig"
                        }
                    ],
                    "description": "The full Vite+ config; `dbx sync` writes the root `vite.config.ts` from it."
                },
                "watch": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainWatchConfig"
                        }
                    ],
                    "description": "Watch behaviour for `dbx watch`."
                },
                "sync": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainSyncConfig"
                        }
                    ],
                    "description": "`dbx sync` behaviour (formatting of the generated managed files)."
                },
                "logger": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainLoggerConfig"
                        }
                    ],
                    "description": "Logging level, colours and prefix for toolchain output."
                },
                "providers": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainProvidersConfig"
                        }
                    ],
                    "description": "Provider command behaviour (eg. colour for the passthrough commands)."
                },
                "mcp": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainMcpConfig"
                        }
                    ],
                    "description": "Install the official dbx skill (and MCP helpers) into AI agent harnesses."
                },
                "hooks": {
                    "$ref": "#/$defs/ToolchainHooks"
                }
            },
            "additionalProperties": false
        },
        "ToolchainEnabledConfig": {
            "anyOf": [
                {
                    "type": "boolean"
                },
                {
                    "type": "object",
                    "properties": {
                        "disabled": {
                            "default": false,
                            "type": "boolean",
                            "description": "Disable the toolchain for this scope."
                        },
                        "scope": {
                            "type": "string",
                            "enum": [
                                "global",
                                "workspace"
                            ],
                            "description": "The scope the value applies to. Config files and the Vite plugin may only use `workspace`; `global` is reserved for the CLI/programmatic API and the VS Code extension."
                        }
                    },
                    "required": [
                        "scope"
                    ],
                    "additionalProperties": false
                }
            ],
            "description": "Enable/disable the toolchain. The shorthand is workspace-scoped; the object form is reserved for APIs and the VS Code extension."
        },
        "ProjectType": {
            "type": "string",
            "enum": [
                "monorepo-root",
                "monorepo-workspace",
                "project"
            ],
            "description": "The project kind (detected when omitted)."
        },
        "ToolchainProjectConfig": {
            "type": "object",
            "properties": {
                "type": {
                    "$ref": "#/$defs/ProjectType"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "type": "boolean"
                },
                "name": {
                    "type": "string",
                    "description": "The unscoped project name (written as `<scope>/<name>`)."
                },
                "scope": {
                    "type": "string",
                    "description": "The npm scope, eg. `@org`."
                },
                "author": {
                    "type": "string",
                    "description": "Package author (`package.json` `author`)."
                },
                "license": {
                    "type": "string",
                    "description": "SPDX license id (`package.json` `license`)."
                },
                "homepage": {
                    "type": "string",
                    "description": "Project homepage (`package.json` `homepage`)."
                },
                "repo": {
                    "type": "string",
                    "description": "Repository URL (`package.json` `repository`). For a workspace it also resolves to the workspace path (`repository.directory`)."
                },
                "nodeVersion": {
                    "type": "string",
                    "description": "Node version for CI/templates, eg. `22` (not `package.json` `engines`)."
                },
                "packageManager": {
                    "default": "yarn",
                    "type": "string",
                    "description": "Package manager name, written as `<name>@<version>`."
                },
                "packageManagerVersion": {
                    "type": "string",
                    "description": "Package manager version, eg. `4.17.1`."
                },
                "description": {
                    "type": "string",
                    "description": "One-line description (`package.json` `description`)."
                },
                "inherit": {
                    "default": true,
                    "type": "boolean",
                    "description": "Inherit the parent project metadata. Set false to keep this project metadata independent of the root config (other sections still merge normally)."
                },
                "manageConfigless": {
                    "default": false,
                    "type": "boolean",
                    "description": "Manage projects that have no dbx.config.* of their own by inheriting the nearest ancestor config. Disabled by default so configless projects are never touched unless explicitly opted in."
                }
            },
            "additionalProperties": false,
            "description": "Project metadata: canonical `package.json` fields and template tokens (shared fields are inherited by workspaces)."
        },
        "ToolchainCiConfig": {
            "type": "object",
            "properties": {
                "ci": {
                    "description": "The CI checks workflow (`ci.yml`).",
                    "$ref": "#/$defs/WorkflowSetting"
                },
                "changelog": {
                    "description": "The changelog/version workflow (`changelog.yml`) plus the changelog pipeline config (versioning, VS Code settings, commitlint).",
                    "$ref": "#/$defs/ChangelogWorkflowSetting"
                },
                "release": {
                    "description": "The release workflow (`release.yml`), including prerelease marking.",
                    "$ref": "#/$defs/ReleaseWorkflowSetting"
                },
                "issues": {
                    "description": "The issue-title workflow (`issues.yml`).",
                    "$ref": "#/$defs/WorkflowSetting"
                },
                "sync": {
                    "description": "The toolchain sync workflow (`sync.yml`).",
                    "$ref": "#/$defs/WorkflowSetting"
                },
                "dependabot": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainDependabotConfig"
                        }
                    ],
                    "description": "Dependabot version-update automation (`.github/dependabot.yml`)."
                },
                "custom": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "$ref": "#/$defs/CustomWorkflowSettings"
                    },
                    "description": "Additional custom workflows, keyed by id (eg. `custom.my-workflow`). Each id writes `<dir>/<filename ?? id>.yml`."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "GitHub Actions workflows to generate (CI, release, issues, changelog, sync)."
        },
        "GitHubWorkflowSetting": {
            "type": "object",
            "properties": {
                "provider": {
                    "type": "string",
                    "const": "github",
                    "description": "Use a complete GitHub Actions workflow."
                },
                "workflow": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "The complete workflow object.",
                    "see": "https://docs.github.com/en/actions/writing-workflows/workflow-syntax-for-github-actions"
                },
                "filename": {
                    "type": "string",
                    "description": "Override the generated file name."
                },
                "dir": {
                    "type": "string",
                    "description": "Directory for the generated file."
                },
                "setup": {
                    "default": false,
                    "type": "boolean",
                    "description": "Inject the provider-specific checkout/Node/Corepack/install setup (default false = the workflow is written as-is)."
                },
                "enabled": {
                    "type": "boolean",
                    "description": "Enable/disable this workflow (default: enabled when present)."
                }
            },
            "required": [
                "provider",
                "workflow"
            ],
            "additionalProperties": false,
            "description": "A complete GitHub Actions workflow written to `.github/workflows/<id>.yml` (or `filename`/`dir`)."
        },
        "GitLabWorkflowSetting": {
            "type": "object",
            "properties": {
                "provider": {
                    "type": "string",
                    "const": "gitlab",
                    "description": "Use a GitLab CI pipeline."
                },
                "workflow": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "The complete pipeline object.",
                    "see": "https://docs.gitlab.com/ee/ci/yaml/"
                },
                "filename": {
                    "type": "string",
                    "description": "Override the generated file name."
                },
                "dir": {
                    "type": "string",
                    "description": "Directory for the generated file."
                },
                "setup": {
                    "default": false,
                    "type": "boolean",
                    "description": "Inject the provider-specific checkout/Node/Corepack/install setup (default false = the workflow is written as-is)."
                },
                "enabled": {
                    "type": "boolean",
                    "description": "Enable/disable this workflow (default: enabled when present)."
                }
            },
            "required": [
                "provider",
                "workflow"
            ],
            "additionalProperties": false,
            "description": "A complete GitLab CI pipeline written to `.gitlab-ci.yml` (or `filename`/`dir`)."
        },
        "AzureWorkflowSetting": {
            "type": "object",
            "properties": {
                "provider": {
                    "type": "string",
                    "const": "azure",
                    "description": "Use an Azure Pipelines pipeline."
                },
                "workflow": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "The complete pipeline object.",
                    "see": "https://learn.microsoft.com/en-us/azure/devops/pipelines/yaml-schema/"
                },
                "filename": {
                    "type": "string",
                    "description": "Override the generated file name."
                },
                "dir": {
                    "type": "string",
                    "description": "Directory for the generated file."
                },
                "setup": {
                    "default": false,
                    "type": "boolean",
                    "description": "Inject the provider-specific checkout/Node/Corepack/install setup (default false = the workflow is written as-is)."
                },
                "enabled": {
                    "type": "boolean",
                    "description": "Enable/disable this workflow (default: enabled when present)."
                }
            },
            "required": [
                "provider",
                "workflow"
            ],
            "additionalProperties": false,
            "description": "A complete Azure Pipelines pipeline written to `azure-pipelines.yml` (or `filename`/`dir`)."
        },
        "WorkflowOptions": {
            "type": "object",
            "properties": {
                "provider": {
                    "default": "github",
                    "type": "string",
                    "const": "github",
                    "description": "Workflow vendor for a full `workflow` object."
                },
                "pushBranches": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Replace `on.push.branches`."
                },
                "pullRequestBranches": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Replace `on.pull_request.branches`."
                },
                "triggers": {
                    "$ref": "#/$defs/WorkflowTriggers"
                },
                "extra": {
                    "$ref": "#/$defs/WorkflowExtra"
                },
                "steps": {
                    "anyOf": [
                        {
                            "$ref": "#/$defs/WorkflowStepsConfig"
                        },
                        {
                            "type": "array",
                            "items": {
                                "$ref": "#/$defs/WorkflowStepsConfig"
                            }
                        }
                    ],
                    "description": "Extra steps for a job (one group, or per-job groups)."
                },
                "jobs": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "$ref": "#/$defs/WorkflowJob"
                    },
                    "description": "Extra complete jobs merged in."
                },
                "tokens": {
                    "$ref": "#/$defs/WorkflowTokens"
                },
                "filename": {
                    "type": "string",
                    "description": "Override the generated workflow file name (eg. `deploy.yml`)."
                },
                "dir": {
                    "default": ".github/workflows",
                    "type": "string",
                    "description": "Directory for the workflow file."
                },
                "setup": {
                    "default": false,
                    "type": "boolean",
                    "description": "Inject the shared checkout/Node/Corepack/install steps into custom workflow jobs; built-in workflows already include them."
                },
                "enabled": {
                    "description": "Enable/disable this workflow (default: enabled when present).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Per-workflow overrides merged over the generated default."
        },
        "WorkflowTriggers": {
            "type": "object",
            "properties": {
                "push": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Push trigger (`on.push`)."
                },
                "pull_request": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Pull-request trigger (`on.pull_request`)."
                },
                "pull_request_target": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Pull-request-target trigger (`on.pull_request_target`)."
                },
                "workflow_dispatch": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Manual trigger (`on.workflow_dispatch`)."
                },
                "workflow_call": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Reusable workflow trigger (`on.workflow_call`)."
                },
                "workflow_run": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Triggered by another workflow (`on.workflow_run`)."
                },
                "schedule": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {},
                        "additionalProperties": {},
                        "description": "Scheduled trigger (`on.schedule`)."
                    },
                    "description": "Scheduled trigger list (`on.schedule`)."
                },
                "release": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Release trigger (`on.release`)."
                }
            },
            "additionalProperties": {
                "$ref": "#/$defs/ConfigJsonValue"
            },
            "description": "Extra `on.*` workflow triggers."
        },
        "ConfigJsonValue": {
            "description": "Any JSON value.",
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "type": "number"
                },
                {
                    "type": "boolean"
                },
                {
                    "type": "null"
                },
                {
                    "type": "array",
                    "items": {
                        "$ref": "#/$defs/ConfigJsonValue"
                    }
                },
                {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "$ref": "#/$defs/ConfigJsonValue"
                    }
                }
            ]
        },
        "WorkflowExtra": {
            "type": "object",
            "properties": {
                "permissions": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": "string"
                    },
                    "description": "Workflow permissions."
                },
                "concurrency": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "object",
                            "properties": {
                                "group": {
                                    "type": "string",
                                    "description": "Concurrency group."
                                },
                                "cancel-in-progress": {
                                    "description": "Cancel in-progress runs (boolean or expression).",
                                    "type": [
                                        "boolean",
                                        "string"
                                    ]
                                }
                            },
                            "required": [
                                "group"
                            ],
                            "additionalProperties": {
                                "$ref": "#/$defs/ConfigJsonValue"
                            }
                        }
                    ],
                    "description": "Workflow concurrency."
                },
                "env": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": "string"
                    },
                    "description": "Workflow environment variables."
                },
                "defaults": {
                    "type": "object",
                    "properties": {
                        "run": {
                            "type": "object",
                            "properties": {
                                "shell": {
                                    "type": "string",
                                    "description": "Default shell."
                                },
                                "working-directory": {
                                    "type": "string",
                                    "description": "Default working directory."
                                }
                            },
                            "additionalProperties": {
                                "$ref": "#/$defs/ConfigJsonValue"
                            }
                        }
                    },
                    "additionalProperties": {
                        "$ref": "#/$defs/ConfigJsonValue"
                    },
                    "description": "Default settings for `run` steps."
                },
                "name": {
                    "type": "string",
                    "description": "Workflow name."
                },
                "run-name": {
                    "type": "string",
                    "description": "Workflow run name."
                },
                "timeout-minutes": {
                    "type": "number",
                    "description": "Job timeout in minutes."
                },
                "container": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Container for the job."
                },
                "strategy": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Build matrix / strategy."
                }
            },
            "additionalProperties": {
                "$ref": "#/$defs/ConfigJsonValue"
            },
            "description": "Extra top-level workflow keys (`permissions`, `concurrency`, `env`, ...)."
        },
        "WorkflowStepsConfig": {
            "type": "object",
            "properties": {
                "job": {
                    "type": "string",
                    "description": "Target job id (defaults to the primary/first job)."
                },
                "before": {
                    "type": "array",
                    "items": {
                        "$ref": "#/$defs/WorkflowStep"
                    },
                    "description": "Steps inserted at the start."
                },
                "after": {
                    "type": "array",
                    "items": {
                        "$ref": "#/$defs/WorkflowStep"
                    },
                    "description": "Steps appended at the end."
                }
            },
            "additionalProperties": false,
            "description": "Extra steps to inject into a workflow job."
        },
        "WorkflowStep": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string",
                    "description": "Step display name."
                },
                "id": {
                    "type": "string",
                    "description": "Step id (for `steps.<id>` outputs)."
                },
                "if": {
                    "type": "string",
                    "description": "Conditional expression (`if:`)."
                },
                "uses": {
                    "type": "string",
                    "description": "Action to run (`uses:`), eg. `actions/checkout@v4`."
                },
                "run": {
                    "type": "string",
                    "description": "Shell command(s) to run (`run:`)."
                },
                "shell": {
                    "type": "string",
                    "description": "Shell to run `run` in, eg. `bash`."
                },
                "working-directory": {
                    "type": "string",
                    "description": "Directory the step runs in."
                },
                "with": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": [
                            "string",
                            "number",
                            "boolean"
                        ]
                    },
                    "description": "Inputs for a `uses` action."
                },
                "env": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": "string"
                    },
                    "description": "Environment variables for the step."
                }
            },
            "additionalProperties": false,
            "description": "A GitHub Actions workflow step."
        },
        "WorkflowJob": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string",
                    "description": "Job display name."
                },
                "runs-on": {
                    "type": "string",
                    "description": "The runner label or expression."
                },
                "if": {
                    "type": "string",
                    "description": "Conditional expression (`if:`)."
                },
                "needs": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Job id(s) this job depends on."
                },
                "environment": {
                    "type": "string",
                    "description": "A GitHub environment name."
                },
                "permissions": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": "string"
                    },
                    "description": "Job permissions."
                },
                "env": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": "string"
                    },
                    "description": "Environment variables."
                },
                "outputs": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": "string"
                    },
                    "description": "Job outputs."
                },
                "concurrency": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Job concurrency settings."
                },
                "timeout-minutes": {
                    "type": "number",
                    "description": "The job timeout in minutes."
                },
                "strategy": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "A build matrix / strategy."
                },
                "services": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Service containers."
                },
                "steps": {
                    "type": "array",
                    "items": {
                        "$ref": "#/$defs/WorkflowStep"
                    },
                    "description": "The job steps."
                }
            },
            "required": [
                "runs-on",
                "steps"
            ],
            "additionalProperties": {
                "$ref": "#/$defs/ConfigJsonValue"
            },
            "description": "A complete GitHub Actions workflow job."
        },
        "WorkflowTokens": {
            "type": "object",
            "properties": {
                "name": {
                    "type": "string",
                    "description": "Project name (`{{ name }}`)."
                },
                "scope": {
                    "type": "string",
                    "description": "Package scope (`{{ scope }}`)."
                },
                "author": {
                    "type": "string",
                    "description": "Author (`{{ author }}`)."
                },
                "license": {
                    "type": "string",
                    "description": "License (`{{ license }}`)."
                },
                "homepage": {
                    "type": "string",
                    "description": "Homepage (`{{ homepage }}`)."
                },
                "repo": {
                    "type": "string",
                    "description": "Repository URL (`{{ repo }}`)."
                },
                "description": {
                    "type": "string",
                    "description": "Description (`{{ description }}`)."
                },
                "nodeVersion": {
                    "type": "string",
                    "description": "Node version (`{{ nodeVersion }}`)."
                },
                "packageManager": {
                    "type": "string",
                    "description": "Package manager (`{{ packageManager }}`)."
                },
                "yarnVersion": {
                    "type": "string",
                    "description": "Yarn version (`{{ yarnVersion }}`)."
                },
                "packageManagerVersion": {
                    "type": "string",
                    "description": "Package manager version (`{{ packageManagerVersion }}`)."
                },
                "mainBranch": {
                    "type": "string",
                    "description": "Main branch (`{{ mainBranch }}`)."
                },
                "devBranch": {
                    "type": "string",
                    "description": "Dev branch (`{{ devBranch }}`)."
                },
                "vitePlus": {
                    "type": "boolean",
                    "description": "Use `voidzero-dev/setup-vp` for this workflow (default: detected from the project)."
                },
                "releasePrerelease": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "string",
                            "const": "auto"
                        }
                    ],
                    "description": "Whether a version with a prerelease suffix (eg. `3.0.0-beta.2`) should be marked as a GitHub prerelease (`{{ releasePrerelease }}`). `auto` detects the suffix, `true` always marks and `false` never marks."
                },
                "setupVpVersion": {
                    "type": "string",
                    "description": "Exact `voidzero-dev/setup-vp` version or commit SHA to pin."
                }
            },
            "additionalProperties": {
                "type": [
                    "string",
                    "number",
                    "boolean"
                ]
            },
            "description": "Per-workflow token overrides (`nodeVersion`, `packageManager`, ...)."
        },
        "WorkflowSetting": {
            "anyOf": [
                {
                    "type": "boolean"
                },
                {
                    "type": "string"
                },
                {
                    "$ref": "#/$defs/GitHubWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/GitLabWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/AzureWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/WorkflowOptions"
                }
            ],
            "description": "`true`/`false` to enable/disable, an object to override parts of the default, a complete GitHub/GitLab/Azure workflow (with `provider`), or a raw YAML string written verbatim as the workflow file."
        },
        "CiChangelogConfig": {
            "type": "object",
            "properties": {
                "provider": {
                    "default": "github",
                    "type": "string",
                    "const": "github",
                    "description": "Workflow vendor for a full `workflow` object."
                },
                "pushBranches": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Replace `on.push.branches`."
                },
                "pullRequestBranches": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Replace `on.pull_request.branches`."
                },
                "triggers": {
                    "$ref": "#/$defs/WorkflowTriggers"
                },
                "extra": {
                    "$ref": "#/$defs/WorkflowExtra"
                },
                "steps": {
                    "anyOf": [
                        {
                            "$ref": "#/$defs/WorkflowStepsConfig"
                        },
                        {
                            "type": "array",
                            "items": {
                                "$ref": "#/$defs/WorkflowStepsConfig"
                            }
                        }
                    ],
                    "description": "Extra steps for a job (one group, or per-job groups)."
                },
                "jobs": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "$ref": "#/$defs/WorkflowJob"
                    },
                    "description": "Extra complete jobs merged in."
                },
                "tokens": {
                    "$ref": "#/$defs/WorkflowTokens"
                },
                "filename": {
                    "type": "string",
                    "description": "Override the generated workflow file name (eg. `deploy.yml`)."
                },
                "dir": {
                    "default": ".github/workflows",
                    "type": "string",
                    "description": "Directory for the workflow file."
                },
                "setup": {
                    "default": false,
                    "type": "boolean",
                    "description": "Inject the shared checkout/Node/Corepack/install steps into custom workflow jobs; built-in workflows already include them."
                },
                "enabled": {
                    "description": "Enable/disable the changelog workflow and pipeline (default: enabled when present).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                },
                "branches": {
                    "$ref": "#/$defs/ChangelogBranchesConfig"
                },
                "commitlint": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ChangelogCommitlintConfig"
                        }
                    ],
                    "description": "commitlint config; set `false` to disable the Conventional-Commits pipeline."
                },
                "versioning": {
                    "default": true,
                    "description": "Automatic version bumping on changelog generation.",
                    "$ref": "#/$defs/ChangelogVersioning"
                },
                "intro": {
                    "description": "Opt-in text inserted at the start of the new changelog entry, globally or for matching targets (workspaces/root).",
                    "$ref": "#/$defs/ChangelogTextSetting"
                },
                "outro": {
                    "description": "Opt-in text appended to the new changelog entry, globally or for matching targets (workspaces/root).",
                    "$ref": "#/$defs/ChangelogTextSetting"
                },
                "vscode": {
                    "default": true,
                    "type": "boolean",
                    "description": "Write the Conventional-Commits VS Code settings."
                },
                "groups": {
                    "anyOf": [
                        {
                            "type": "array",
                            "items": {
                                "anyOf": [
                                    {
                                        "type": "string"
                                    },
                                    {
                                        "$ref": "#/$defs/ChangelogGroupOptions"
                                    }
                                ]
                            },
                            "description": "An ordered list of CC types or group objects."
                        },
                        {
                            "type": "object",
                            "propertyNames": {
                                "type": "string"
                            },
                            "additionalProperties": {
                                "anyOf": [
                                    {
                                        "type": "string"
                                    },
                                    {
                                        "$ref": "#/$defs/ChangelogGroupOptions"
                                    },
                                    {
                                        "type": "boolean"
                                    }
                                ]
                            },
                            "description": "A CC type to title/options/visibility record."
                        },
                        {
                            "description": "A custom group builder (TS/JS configs only)."
                        }
                    ],
                    "description": "Conventional-Commits group order/titles: an ordered array of CC types or `{ type, title, order, hidden }`, a type->title/options record, or a callback (TS/JS configs only)."
                },
                "breaking": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "string",
                            "enum": [
                                "conventional",
                                "any"
                            ]
                        },
                        {
                            "type": "object",
                            "properties": {
                                "pattern": {
                                    "type": "string",
                                    "description": "A regular expression matched against the subject and body."
                                },
                                "match": {
                                    "type": "string",
                                    "description": "A substring matched against the subject and body."
                                }
                            },
                            "additionalProperties": false
                        },
                        {
                            "description": "A custom breaking-change predicate (TS/JS configs only)."
                        }
                    ],
                    "description": "How breaking changes are detected: `conventional` (default: a `!` in the CC subject or a `BREAKING CHANGE:` footer), `any` (legacy loose match), `false` (disable), `{ pattern }` / `{ match }`, or a callback (TS/JS configs only)."
                },
                "release": {
                    "description": "Release-body aggregation options, used by `dbx changelog --release-body` and the generated release workflow.",
                    "$ref": "#/$defs/ChangelogReleaseConfig"
                }
            },
            "additionalProperties": false,
            "description": "Changelog workflow + pipeline: versioning, VS Code settings and commitlint."
        },
        "ChangelogBranchesConfig": {
            "type": "object",
            "properties": {
                "main": {
                    "default": [
                        "main"
                    ],
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Branch glob(s) the CI + release workflows run on, and the release PR base."
                },
                "dev": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Branch glob(s) the changelog/version workflow runs on. No default: when omitted it reuses `main` (so a single-branch repo needs no `dev`)."
                }
            },
            "additionalProperties": false,
            "description": "Branches the generated workflows target."
        },
        "ChangelogCommitlintConfig": {
            "type": "object",
            "properties": {
                "dir": {
                    "type": "string",
                    "description": "Directory the generated `commitlint.config.mjs` is written to (default: the project root). The generated commit hook and CI use `--config` to point at it."
                },
                "types": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Allowed commit types (commitlint)."
                },
                "scopes": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Allowed commit scopes (commitlint)."
                },
                "enabled": {
                    "description": "Enable commitlint (default true when the changelog is enabled). Set false to generate changelogs without the Conventional-Commits pipeline.",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "commitlint config, output location and allow-lists."
        },
        "ChangelogVersioningConfig": {
            "type": "object",
            "properties": {
                "target": {
                    "default": "uniform",
                    "description": "`uniform` bumps the root and every workspace to one shared version; `root-only` bumps the root only; `individual` bumps each changed workspace independently.",
                    "$ref": "#/$defs/ChangelogVersioningTarget"
                },
                "workspaces": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Glob patterns selecting the workspaces to version (relative to the root). Defaults to the root `package.json` `workspaces` field; when there is none the root `package.json` is used on its own."
                },
                "prerelease": {
                    "anyOf": [
                        {
                            "$ref": "#/$defs/ChangelogTargetedPrerelease"
                        },
                        {
                            "type": "array",
                            "items": {
                                "anyOf": [
                                    {
                                        "$ref": "#/$defs/ChangelogTargetedPrerelease"
                                    },
                                    {
                                        "type": "string",
                                        "pattern": "^[0-9A-Za-z-]+$",
                                        "description": "Opt into a prerelease cycle (eg. `beta`, `rc`). Stable versions bump their core and start at `<tag>.0`; existing prereleases keep their core and increment the counter for the same tag, so the suffix is never appended twice."
                                    }
                                ]
                            }
                        },
                        {
                            "type": "string",
                            "pattern": "^[0-9A-Za-z-]+$",
                            "description": "Opt into a prerelease cycle (eg. `beta`, `rc`). Stable versions bump their core and start at `<tag>.0`; existing prereleases keep their core and increment the counter for the same tag, so the suffix is never appended twice."
                        }
                    ],
                    "description": "The prerelease tag globally, or per-target via `{ target, options }`."
                },
                "bump": {
                    "type": "object",
                    "properties": {
                        "major": {
                            "anyOf": [
                                {
                                    "$ref": "#/$defs/ChangelogTargetedBump"
                                },
                                {
                                    "type": "array",
                                    "items": {
                                        "anyOf": [
                                            {
                                                "$ref": "#/$defs/ChangelogTargetedBump"
                                            },
                                            {
                                                "$ref": "#/$defs/ChangelogBumpRule"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "$ref": "#/$defs/ChangelogBumpRule"
                                }
                            ],
                            "description": "A bump rule globally, or per-target via `{ target, include, exclude, options }`."
                        },
                        "minor": {
                            "anyOf": [
                                {
                                    "$ref": "#/$defs/ChangelogTargetedBump"
                                },
                                {
                                    "type": "array",
                                    "items": {
                                        "anyOf": [
                                            {
                                                "$ref": "#/$defs/ChangelogTargetedBump"
                                            },
                                            {
                                                "$ref": "#/$defs/ChangelogBumpRule"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "$ref": "#/$defs/ChangelogBumpRule"
                                }
                            ],
                            "description": "A bump rule globally, or per-target via `{ target, include, exclude, options }`."
                        },
                        "patch": {
                            "anyOf": [
                                {
                                    "$ref": "#/$defs/ChangelogTargetedBump"
                                },
                                {
                                    "type": "array",
                                    "items": {
                                        "anyOf": [
                                            {
                                                "$ref": "#/$defs/ChangelogTargetedBump"
                                            },
                                            {
                                                "$ref": "#/$defs/ChangelogBumpRule"
                                            }
                                        ]
                                    }
                                },
                                {
                                    "$ref": "#/$defs/ChangelogBumpRule"
                                }
                            ],
                            "description": "A bump rule globally, or per-target via `{ target, include, exclude, options }`."
                        }
                    },
                    "additionalProperties": false,
                    "description": "Custom bump rules for major/minor/patch (matchers or callbacks), globally or per-target via `{ target, options }`. Configuring any level replaces Conventional-Commits detection for that target; the result is at least a patch bump."
                },
                "allowOverBump": {
                    "anyOf": [
                        {
                            "$ref": "#/$defs/ChangelogTargetedAllowOverBump"
                        },
                        {
                            "type": "array",
                            "items": {
                                "anyOf": [
                                    {
                                        "$ref": "#/$defs/ChangelogTargetedAllowOverBump"
                                    },
                                    {
                                        "default": false,
                                        "type": "boolean",
                                        "description": "Apply a bump once per matching change instead of once per run."
                                    }
                                ]
                            }
                        },
                        {
                            "default": false,
                            "type": "boolean",
                            "description": "Apply a bump once per matching change instead of once per run."
                        }
                    ],
                    "description": "Enable over-bumping globally, or per-target via `{ target, options }`."
                },
                "commit": {
                    "anyOf": [
                        {
                            "$ref": "#/$defs/ChangelogTargetedCommit"
                        },
                        {
                            "type": "array",
                            "items": {
                                "anyOf": [
                                    {
                                        "$ref": "#/$defs/ChangelogTargetedCommit"
                                    },
                                    {
                                        "description": "Commit message formatting/credit options (with an optional formatter callback).",
                                        "$ref": "#/$defs/ChangelogCommitFormatConfig"
                                    }
                                ]
                            }
                        },
                        {
                            "description": "Commit message formatting/credit options (with an optional formatter callback).",
                            "$ref": "#/$defs/ChangelogCommitFormatConfig"
                        }
                    ],
                    "description": "Commit formatting globally, or per-target via `{ target, options }`."
                },
                "provider": {
                    "anyOf": [
                        {
                            "$ref": "#/$defs/ChangelogTargetedProvider"
                        },
                        {
                            "type": "array",
                            "items": {
                                "anyOf": [
                                    {
                                        "$ref": "#/$defs/ChangelogTargetedProvider"
                                    },
                                    {
                                        "anyOf": [
                                            {
                                                "type": "string"
                                            },
                                            {
                                                "$ref": "#/$defs/ChangelogProviderConfig"
                                            },
                                            {
                                                "description": "A custom provider callback returning the changelog body (TS/JS configs only)."
                                            }
                                        ],
                                        "description": "`default`, `changesets`, a built-in provider id, or a custom provider/callback."
                                    }
                                ]
                            }
                        },
                        {
                            "anyOf": [
                                {
                                    "type": "string"
                                },
                                {
                                    "$ref": "#/$defs/ChangelogProviderConfig"
                                },
                                {
                                    "description": "A custom provider callback returning the changelog body (TS/JS configs only)."
                                }
                            ],
                            "description": "`default`, `changesets`, a built-in provider id, or a custom provider/callback."
                        }
                    ],
                    "description": "The provider globally, or per-target via `{ target, options }`. The `changesets` provider is repository-wide and runs once when any versioned target selects it."
                }
            },
            "additionalProperties": false,
            "description": "Automatic version bumping options."
        },
        "ChangelogVersioningTarget": {
            "type": "string",
            "enum": [
                "uniform",
                "root-only",
                "individual"
            ],
            "description": "Where the changelog version bump is applied."
        },
        "ChangelogTargetedPrerelease": {
            "type": "object",
            "properties": {
                "target": {
                    "type": "string",
                    "description": "A workspace path relative to the repository root (`.` for the root), or a glob such as `apps/*`. When omitted the entry applies to every target."
                },
                "include": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Only apply to workspaces whose repo-relative directory matches one of these globs (tsconfig-style include)."
                },
                "exclude": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Skip workspaces whose repo-relative directory matches these globs."
                },
                "options": {
                    "type": "string",
                    "pattern": "^[0-9A-Za-z-]+$",
                    "description": "Opt into a prerelease cycle (eg. `beta`, `rc`). Stable versions bump their core and start at `<tag>.0`; existing prereleases keep their core and increment the counter for the same tag, so the suffix is never appended twice."
                }
            },
            "required": [
                "options"
            ],
            "additionalProperties": false,
            "description": "The option value plus the targets it applies to."
        },
        "ChangelogTargetedBump": {
            "type": "object",
            "properties": {
                "target": {
                    "type": "string",
                    "description": "A workspace path relative to the repository root (`.` for the root), or a glob such as `apps/*`. When omitted the entry applies to every target."
                },
                "include": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Only apply to workspaces whose repo-relative directory matches one of these globs (tsconfig-style include)."
                },
                "exclude": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Skip workspaces whose repo-relative directory matches these globs."
                },
                "options": {
                    "$ref": "#/$defs/ChangelogBumpRule"
                }
            },
            "required": [
                "options"
            ],
            "additionalProperties": false,
            "description": "The option value plus the targets it applies to."
        },
        "ChangelogBumpRule": {
            "anyOf": [
                {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "string"
                        },
                        {
                            "$ref": "#/$defs/ChangelogBumpRuleMatch"
                        },
                        {
                            "description": "A custom bump matcher (TS/JS configs only)."
                        }
                    ]
                },
                {
                    "type": "array",
                    "items": {
                        "anyOf": [
                            {
                                "type": "boolean"
                            },
                            {
                                "type": "string"
                            },
                            {
                                "$ref": "#/$defs/ChangelogBumpRuleMatch"
                            },
                            {
                                "description": "A custom bump matcher (TS/JS configs only)."
                            }
                        ]
                    }
                }
            ],
            "description": "A bump rule: a matcher/callback or a list of matchers/callbacks."
        },
        "ChangelogBumpRuleMatch": {
            "type": "object",
            "properties": {
                "breaking": {
                    "type": "boolean",
                    "description": "Match only commits whose breaking state equals this value."
                },
                "type": {
                    "type": "string",
                    "description": "Match this Conventional-Commits type."
                },
                "types": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Match any of these CC types."
                },
                "scope": {
                    "type": "string",
                    "description": "Match this Conventional-Commits scope."
                },
                "scopes": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Match any of these CC scopes."
                },
                "pattern": {
                    "type": "string",
                    "description": "Match this regular expression."
                },
                "match": {
                    "type": "string",
                    "description": "Match this substring."
                }
            },
            "additionalProperties": false,
            "description": "A declarative bump matcher."
        },
        "ChangelogTargetedAllowOverBump": {
            "type": "object",
            "properties": {
                "target": {
                    "type": "string",
                    "description": "A workspace path relative to the repository root (`.` for the root), or a glob such as `apps/*`. When omitted the entry applies to every target."
                },
                "include": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Only apply to workspaces whose repo-relative directory matches one of these globs (tsconfig-style include)."
                },
                "exclude": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Skip workspaces whose repo-relative directory matches these globs."
                },
                "options": {
                    "default": false,
                    "type": "boolean",
                    "description": "Apply a bump once per matching change instead of once per run."
                }
            },
            "additionalProperties": false,
            "description": "The option value plus the targets it applies to."
        },
        "ChangelogTargetedCommit": {
            "type": "object",
            "properties": {
                "target": {
                    "type": "string",
                    "description": "A workspace path relative to the repository root (`.` for the root), or a glob such as `apps/*`. When omitted the entry applies to every target."
                },
                "include": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Only apply to workspaces whose repo-relative directory matches one of these globs (tsconfig-style include)."
                },
                "exclude": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Skip workspaces whose repo-relative directory matches these globs."
                },
                "options": {
                    "description": "Commit message formatting/credit options (with an optional formatter callback).",
                    "$ref": "#/$defs/ChangelogCommitFormatConfig"
                }
            },
            "required": [
                "options"
            ],
            "additionalProperties": false,
            "description": "The option value plus the targets it applies to."
        },
        "ChangelogDetailsConfig": {
            "anyOf": [
                {
                    "type": "boolean"
                },
                {
                    "type": "object",
                    "properties": {
                        "enabled": {
                            "default": true,
                            "type": "boolean",
                            "description": "Enable/disable details wrapping."
                        },
                        "lifecycle": {
                            "default": "after",
                            "type": "string",
                            "enum": [
                                "after",
                                "before"
                            ],
                            "description": "Apply details after the changelog formatting pipeline (default `after`, so custom searches regex-match the formatted text) or before it (`before`)."
                        },
                        "minCommits": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Default minimum entries for every details section (a nested minCommits wins; the body defaults to 10)."
                        },
                        "descriptions": {
                            "default": true,
                            "anyOf": [
                                {
                                    "type": "boolean"
                                },
                                {
                                    "$ref": "#/$defs/ChangelogDetailsOptions"
                                }
                            ],
                            "description": "Wrap commit description paragraphs in a nested collapsible."
                        },
                        "body": {
                            "anyOf": [
                                {
                                    "type": "boolean"
                                },
                                {
                                    "$ref": "#/$defs/ChangelogDetailsOptions"
                                }
                            ],
                            "description": "Wrap the version body in a collapsible titled Release notes (default false; enabled by default with release body wrapping; requires 10 commits by default)."
                        },
                        "releaseNotes": {
                            "anyOf": [
                                {
                                    "type": "boolean"
                                },
                                {
                                    "$ref": "#/$defs/ChangelogDetailsOptions"
                                }
                            ],
                            "description": "Wrap the release body entry in a collapsible titled Release notes."
                        },
                        "intro": {
                            "anyOf": [
                                {
                                    "type": "boolean"
                                },
                                {
                                    "$ref": "#/$defs/ChangelogDetailsOptions"
                                }
                            ],
                            "description": "Wrap the intro text in a collapsible."
                        },
                        "outro": {
                            "anyOf": [
                                {
                                    "type": "boolean"
                                },
                                {
                                    "$ref": "#/$defs/ChangelogDetailsOptions"
                                }
                            ],
                            "description": "Wrap the outro text in a collapsible."
                        },
                        "footer": {
                            "anyOf": [
                                {
                                    "type": "boolean"
                                },
                                {
                                    "$ref": "#/$defs/ChangelogDetailsOptions"
                                }
                            ],
                            "description": "Wrap the package-changes footer in a collapsible."
                        },
                        "breaking": {
                            "anyOf": [
                                {
                                    "type": "boolean"
                                },
                                {
                                    "$ref": "#/$defs/ChangelogDetailsOptions"
                                }
                            ],
                            "description": "Wrap the breaking-changes section in a collapsible."
                        },
                        "types": {
                            "anyOf": [
                                {
                                    "anyOf": [
                                        {
                                            "type": "boolean"
                                        },
                                        {
                                            "$ref": "#/$defs/ChangelogDetailsOptions"
                                        }
                                    ],
                                    "description": "Enable/disable this collapsible, optionally with a title/expanded state."
                                },
                                {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                }
                            ],
                            "description": "Wrap these CC type sections (all types when `true`; enabled by default)."
                        },
                        "custom": {
                            "anyOf": [
                                {
                                    "$ref": "#/$defs/ChangelogDetailsCustom"
                                },
                                {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/$defs/ChangelogDetailsCustom"
                                    }
                                }
                            ],
                            "description": "Wrap matching text (the match or `start` match becomes the summary)."
                        }
                    },
                    "additionalProperties": false
                }
            ],
            "description": "Wrap changelog sections/text in markdown `<details>` collapsibles. `true` enables descriptions, release notes, breaking changes and type sections; use an object or `false` to opt out."
        },
        "ChangelogDetailsOptions": {
            "type": "object",
            "properties": {
                "title": {
                    "type": "string",
                    "description": "Custom `<summary>` text."
                },
                "expanded": {
                    "type": "boolean",
                    "description": "Render the collapsible open by default."
                },
                "minCommits": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991,
                    "description": "Minimum entries in the section before wrapping (nested overrides the top-level default)."
                }
            },
            "additionalProperties": false,
            "description": "Collapsible presentation: summary text, expanded state and minimum entry count."
        },
        "ChangelogDetailsCustom": {
            "anyOf": [
                {
                    "description": "A string or regular expression (TS/JS configs only for RegExp)."
                },
                {
                    "type": "object",
                    "properties": {
                        "title": {
                            "type": "string",
                            "description": "Custom `<summary>` text."
                        },
                        "expanded": {
                            "type": "boolean",
                            "description": "Render the collapsible open by default."
                        },
                        "minCommits": {
                            "type": "integer",
                            "minimum": 0,
                            "maximum": 9007199254740991,
                            "description": "Minimum entries in the section before wrapping (nested overrides the top-level default)."
                        },
                        "start": {
                            "description": "The opening marker."
                        },
                        "end": {
                            "description": "The closing marker."
                        }
                    },
                    "additionalProperties": false,
                    "description": "A start/end marker pair with optional presentation options."
                }
            ],
            "description": "A custom collapsible matcher."
        },
        "ChangelogCommitFormatConfig": {
            "type": "object",
            "properties": {
                "author": {
                    "default": true,
                    "type": "boolean",
                    "description": "Include the `by <author>` credit."
                },
                "commitSha": {
                    "default": true,
                    "type": "boolean",
                    "description": "Include the commit hash link."
                },
                "issues": {
                    "default": true,
                    "type": "boolean",
                    "description": "Include issue/fixes links."
                },
                "authorAvatar": {
                    "default": false,
                    "type": "boolean",
                    "description": "Prefix the author with their GitHub avatar."
                },
                "format": {
                    "description": "Fully custom commit line formatter (TS/JS configs only; return the bullet body)."
                },
                "details": {
                    "$ref": "#/$defs/ChangelogDetailsConfig"
                }
            },
            "additionalProperties": false,
            "description": "Commit message formatting/credit options."
        },
        "ChangelogTargetedProvider": {
            "type": "object",
            "properties": {
                "target": {
                    "type": "string",
                    "description": "A workspace path relative to the repository root (`.` for the root), or a glob such as `apps/*`. When omitted the entry applies to every target."
                },
                "include": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Only apply to workspaces whose repo-relative directory matches one of these globs (tsconfig-style include)."
                },
                "exclude": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Skip workspaces whose repo-relative directory matches these globs."
                },
                "options": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "$ref": "#/$defs/ChangelogProviderConfig"
                        },
                        {
                            "description": "A custom provider callback returning the changelog body (TS/JS configs only)."
                        }
                    ],
                    "description": "`default`, `changesets`, a built-in provider id, or a custom provider/callback."
                }
            },
            "required": [
                "options"
            ],
            "additionalProperties": false,
            "description": "The option value plus the targets it applies to."
        },
        "ChangelogProviderConfig": {
            "type": "object",
            "properties": {
                "id": {
                    "type": "string",
                    "description": "The provider id."
                },
                "run": {
                    "description": "A custom provider callback returning the changelog body (TS/JS configs only)."
                }
            },
            "required": [
                "id",
                "run"
            ],
            "additionalProperties": false,
            "description": "A custom changelog provider object."
        },
        "ChangelogVersioning": {
            "default": true,
            "anyOf": [
                {
                    "type": "boolean"
                },
                {
                    "$ref": "#/$defs/ChangelogVersioningConfig"
                }
            ],
            "description": "Automatic version bumping when a changelog entry is generated."
        },
        "ChangelogTextEntry": {
            "anyOf": [
                {
                    "$ref": "#/$defs/ChangelogTextContentEntry"
                },
                {
                    "$ref": "#/$defs/ChangelogTextFileEntry"
                }
            ],
            "description": "A changelog intro/outro entry (`content` or `file`, plus the target selector)."
        },
        "ChangelogTextContentEntry": {
            "type": "object",
            "properties": {
                "enabled": {
                    "default": true,
                    "type": "boolean",
                    "description": "Set false to skip this entry."
                },
                "target": {
                    "type": "string",
                    "description": "A workspace path relative to the repository root (`.` for the root), or a glob such as `apps/*`. When omitted the entry applies to every target."
                },
                "include": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Only apply to workspaces whose repo-relative directory matches one of these globs (tsconfig-style include)."
                },
                "exclude": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Skip workspaces whose repo-relative directory matches these globs."
                },
                "content": {
                    "type": "string",
                    "description": "The text inserted into the changelog entry."
                },
                "file": {
                    "description": "Not allowed with `content`.",
                    "not": {}
                }
            },
            "required": [
                "content"
            ],
            "additionalProperties": false
        },
        "ChangelogTextFileEntry": {
            "type": "object",
            "properties": {
                "enabled": {
                    "default": true,
                    "type": "boolean",
                    "description": "Set false to skip this entry."
                },
                "target": {
                    "type": "string",
                    "description": "A workspace path relative to the repository root (`.` for the root), or a glob such as `apps/*`. When omitted the entry applies to every target."
                },
                "include": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Only apply to workspaces whose repo-relative directory matches one of these globs (tsconfig-style include)."
                },
                "exclude": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Skip workspaces whose repo-relative directory matches these globs."
                },
                "content": {
                    "description": "Not allowed with `file`.",
                    "not": {}
                },
                "file": {
                    "type": "string",
                    "description": "Path to a file containing the text (relative to the repository root or absolute). It is read at changelog-generation time."
                }
            },
            "required": [
                "file"
            ],
            "additionalProperties": false
        },
        "ChangelogTextSetting": {
            "anyOf": [
                {
                    "$ref": "#/$defs/ChangelogTextEntry"
                },
                {
                    "type": "array",
                    "items": {
                        "$ref": "#/$defs/ChangelogTextEntry"
                    }
                }
            ],
            "description": "A changelog intro/outro entry or an array of entries (`Arrayable`)."
        },
        "ChangelogGroupOptions": {
            "type": "object",
            "properties": {
                "type": {
                    "type": "string",
                    "description": "The CC type (required for object entries in an array)."
                },
                "title": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "description": "A custom group title callback (TS/JS configs only)."
                        }
                    ],
                    "description": "Custom heading title (or callback; TS/JS configs only)."
                },
                "order": {
                    "anyOf": [
                        {
                            "type": "number"
                        },
                        {
                            "description": "A custom group order callback (TS/JS configs only)."
                        }
                    ],
                    "description": "Sort position; lower comes first (or callback; TS/JS configs only)."
                },
                "hidden": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "description": "A custom group hidden callback (TS/JS configs only)."
                        }
                    ],
                    "description": "Omit this group from the rendered changelog (or callback; TS/JS only)."
                }
            },
            "additionalProperties": false,
            "description": "One Conventional-Commits group."
        },
        "ChangelogReleaseConfig": {
            "type": "object",
            "properties": {
                "group": {
                    "default": false,
                    "type": "boolean",
                    "description": "Group every changelog version since the previous published release into one release body instead of exposing each intermediate version separately. A stable release skips prerelease versions when it picks that boundary, so all prereleases since the last stable release are part of the same body; a prerelease release still stops at the previous prerelease."
                },
                "includePrereleases": {
                    "default": false,
                    "type": "boolean",
                    "description": "Let a prerelease version bound the grouped body even for a stable release (so the stable body only covers the changes since the latest prerelease)."
                },
                "since": {
                    "type": "string",
                    "description": "Explicit lower boundary for the grouped body: a version or tag (eg. `1.2.0`, `v1.2.0`, `@scope/pkg@1.2.0`). Overrides the published-release lookup; a missing version falls back to automatic discovery."
                }
            },
            "additionalProperties": false,
            "description": "Release-body aggregation: group every version since the previous published release into one entry."
        },
        "ChangelogWorkflowSetting": {
            "anyOf": [
                {
                    "type": "boolean"
                },
                {
                    "type": "string"
                },
                {
                    "$ref": "#/$defs/GitHubWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/GitLabWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/AzureWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/CiChangelogConfig"
                }
            ],
            "description": "`true`/`false` to enable/disable, a complete GitHub/GitLab/Azure workflow (with `provider`), the changelog pipeline config object, or a raw YAML string written verbatim as the changelog workflow file."
        },
        "ReleaseWorkflowOptions": {
            "type": "object",
            "properties": {
                "provider": {
                    "default": "github",
                    "type": "string",
                    "const": "github",
                    "description": "Workflow vendor for a full `workflow` object."
                },
                "pushBranches": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Replace `on.push.branches`."
                },
                "pullRequestBranches": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Replace `on.pull_request.branches`."
                },
                "triggers": {
                    "$ref": "#/$defs/WorkflowTriggers"
                },
                "extra": {
                    "$ref": "#/$defs/WorkflowExtra"
                },
                "steps": {
                    "anyOf": [
                        {
                            "$ref": "#/$defs/WorkflowStepsConfig"
                        },
                        {
                            "type": "array",
                            "items": {
                                "$ref": "#/$defs/WorkflowStepsConfig"
                            }
                        }
                    ],
                    "description": "Extra steps for a job (one group, or per-job groups)."
                },
                "jobs": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "$ref": "#/$defs/WorkflowJob"
                    },
                    "description": "Extra complete jobs merged in."
                },
                "tokens": {
                    "$ref": "#/$defs/WorkflowTokens"
                },
                "filename": {
                    "type": "string",
                    "description": "Override the generated workflow file name (eg. `deploy.yml`)."
                },
                "dir": {
                    "default": ".github/workflows",
                    "type": "string",
                    "description": "Directory for the workflow file."
                },
                "setup": {
                    "default": false,
                    "type": "boolean",
                    "description": "Inject the shared checkout/Node/Corepack/install steps into custom workflow jobs; built-in workflows already include them."
                },
                "enabled": {
                    "description": "Enable/disable this workflow (default: enabled when present).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                },
                "prerelease": {
                    "default": "auto",
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "string",
                            "const": "auto"
                        }
                    ],
                    "description": "Mark a version with a prerelease suffix (eg. `3.0.0-beta.2`) as a GitHub prerelease when a release job creates it. `auto` (default) detects a semver suffix after `-`; `true` always marks; `false` never marks. Custom release jobs can read the `{{ releasePrerelease }}` token."
                }
            },
            "additionalProperties": false,
            "description": "Release workflow overrides, including GitHub prerelease marking."
        },
        "ReleaseWorkflowSetting": {
            "anyOf": [
                {
                    "type": "boolean"
                },
                {
                    "type": "string"
                },
                {
                    "$ref": "#/$defs/GitHubWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/GitLabWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/AzureWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/ReleaseWorkflowOptions"
                }
            ],
            "description": "`true`/`false`, a raw YAML string, a complete GitHub/GitLab/Azure workflow, or release workflow overrides (including `prerelease`)."
        },
        "ToolchainDependabotConfig": {
            "type": "object",
            "properties": {
                "schedule": {
                    "default": "weekly",
                    "type": "string",
                    "enum": [
                        "daily",
                        "weekly",
                        "monthly"
                    ],
                    "description": "Dependabot update interval."
                },
                "directories": {
                    "default": [
                        "/"
                    ],
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Directories to scan."
                },
                "ecosystems": {
                    "default": [
                        "github-actions",
                        "npm"
                    ],
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Package ecosystems. `github-actions` keeps `voidzero-dev/setup-vp` and the other actions up to date."
                },
                "labels": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Labels added to the update PRs."
                },
                "openPullRequestsLimit": {
                    "default": 5,
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100,
                    "description": "Maximum open update PRs per entry."
                },
                "groups": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": "object",
                        "properties": {
                            "applies-to": {
                                "default": "version-updates",
                                "type": "string",
                                "enum": [
                                    "version-updates",
                                    "security-updates"
                                ],
                                "description": "Which update kind this group applies to."
                            },
                            "patterns": {
                                "default": [
                                    "*"
                                ],
                                "type": "array",
                                "items": {
                                    "type": "string"
                                },
                                "description": "Package name patterns."
                            },
                            "exclude-patterns": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                },
                                "description": "Package name patterns to exclude."
                            },
                            "update-types": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                },
                                "description": "Update types to group (eg. `[\"minor\", \"patch\"]`)."
                            }
                        },
                        "additionalProperties": false
                    },
                    "description": "Dependabot update groups, keyed by group name."
                },
                "security": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainDependabotSecurityConfig"
                        }
                    ],
                    "description": "Security updates: enable Dependabot security updates, group vulnerability PRs and apply a severity threshold. Requires a repository admin token for the generated workflow."
                },
                "allow": {
                    "anyOf": [
                        {
                            "type": "array",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "dependency-name": {
                                        "type": "string",
                                        "description": "Dependency name or `*` pattern."
                                    },
                                    "dependency-type": {
                                        "type": "string",
                                        "enum": [
                                            "direct",
                                            "indirect",
                                            "production",
                                            "development"
                                        ],
                                        "description": "Restrict the rule to a dependency type."
                                    },
                                    "update-types": {
                                        "type": "array",
                                        "items": {
                                            "type": "string"
                                        },
                                        "description": "Update types (eg. `version-update:semver-major`)."
                                    },
                                    "versions": {
                                        "type": "array",
                                        "items": {
                                            "type": "string"
                                        },
                                        "description": "Version ranges to allow/ignore."
                                    }
                                },
                                "required": [
                                    "dependency-name"
                                ],
                                "additionalProperties": false
                            }
                        },
                        {
                            "type": "object",
                            "propertyNames": {
                                "type": "string"
                            },
                            "additionalProperties": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "dependency-name": {
                                            "type": "string",
                                            "description": "Dependency name or `*` pattern."
                                        },
                                        "dependency-type": {
                                            "type": "string",
                                            "enum": [
                                                "direct",
                                                "indirect",
                                                "production",
                                                "development"
                                            ],
                                            "description": "Restrict the rule to a dependency type."
                                        },
                                        "update-types": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            },
                                            "description": "Update types (eg. `version-update:semver-major`)."
                                        },
                                        "versions": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            },
                                            "description": "Version ranges to allow/ignore."
                                        }
                                    },
                                    "required": [
                                        "dependency-name"
                                    ],
                                    "additionalProperties": false
                                }
                            }
                        }
                    ],
                    "description": "Rules for every ecosystem (an array) or keyed by package ecosystem (eg. `{ npm: [...] }`; `*` is the fallback)."
                },
                "ignore": {
                    "anyOf": [
                        {
                            "type": "array",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "dependency-name": {
                                        "type": "string",
                                        "description": "Dependency name or `*` pattern."
                                    },
                                    "dependency-type": {
                                        "type": "string",
                                        "enum": [
                                            "direct",
                                            "indirect",
                                            "production",
                                            "development"
                                        ],
                                        "description": "Restrict the rule to a dependency type."
                                    },
                                    "update-types": {
                                        "type": "array",
                                        "items": {
                                            "type": "string"
                                        },
                                        "description": "Update types (eg. `version-update:semver-major`)."
                                    },
                                    "versions": {
                                        "type": "array",
                                        "items": {
                                            "type": "string"
                                        },
                                        "description": "Version ranges to allow/ignore."
                                    }
                                },
                                "required": [
                                    "dependency-name"
                                ],
                                "additionalProperties": false
                            }
                        },
                        {
                            "type": "object",
                            "propertyNames": {
                                "type": "string"
                            },
                            "additionalProperties": {
                                "type": "array",
                                "items": {
                                    "type": "object",
                                    "properties": {
                                        "dependency-name": {
                                            "type": "string",
                                            "description": "Dependency name or `*` pattern."
                                        },
                                        "dependency-type": {
                                            "type": "string",
                                            "enum": [
                                                "direct",
                                                "indirect",
                                                "production",
                                                "development"
                                            ],
                                            "description": "Restrict the rule to a dependency type."
                                        },
                                        "update-types": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            },
                                            "description": "Update types (eg. `version-update:semver-major`)."
                                        },
                                        "versions": {
                                            "type": "array",
                                            "items": {
                                                "type": "string"
                                            },
                                            "description": "Version ranges to allow/ignore."
                                        }
                                    },
                                    "required": [
                                        "dependency-name"
                                    ],
                                    "additionalProperties": false
                                }
                            }
                        }
                    ],
                    "description": "Rules for every ecosystem (an array) or keyed by package ecosystem (eg. `{ npm: [...] }`; `*` is the fallback)."
                },
                "filename": {
                    "default": "dependabot.yml",
                    "type": "string",
                    "description": "Override the generated file name."
                },
                "dir": {
                    "default": ".github",
                    "type": "string",
                    "description": "Directory for the config."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Dependabot automation (`.github/dependabot.yml`, plus optional security updates). Opt-in by presence.",
            "see": "https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file"
        },
        "ToolchainDependabotSecurityConfig": {
            "type": "object",
            "properties": {
                "enabled": {
                    "type": "boolean",
                    "description": "Enable or disable the security-update automation."
                },
                "vulnerabilities": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {
                                "severity": {
                                    "default": "all",
                                    "anyOf": [
                                        {
                                            "type": "string",
                                            "enum": [
                                                "low",
                                                "moderate",
                                                "medium",
                                                "high",
                                                "critical",
                                                "all"
                                            ]
                                        },
                                        {
                                            "minItems": 1,
                                            "type": "array",
                                            "items": {
                                                "type": "string",
                                                "enum": [
                                                    "low",
                                                    "moderate",
                                                    "medium",
                                                    "high",
                                                    "critical",
                                                    "all"
                                                ]
                                            }
                                        }
                                    ],
                                    "description": "Only keep vulnerability PRs at or above this severity (or exactly the listed severities). `all` keeps every alert. `moderate` is accepted as an alias for GitHub's `medium`."
                                }
                            },
                            "additionalProperties": false,
                            "description": "Narrow vulnerability PRs to a severity threshold."
                        }
                    ],
                    "description": "Open PRs for vulnerable dependencies. Enabled by default when `security` is set; set false to disable Dependabot security updates."
                },
                "pr": {
                    "type": "object",
                    "properties": {
                        "strategy": {
                            "default": "grouped",
                            "type": "string",
                            "enum": [
                                "grouped",
                                "individual"
                            ],
                            "description": "Group security updates into one PR per ecosystem (default) or one PR per update."
                        }
                    },
                    "additionalProperties": false,
                    "description": "Pull-request strategy for security updates."
                },
                "workflow": {
                    "default": true,
                    "type": "boolean",
                    "description": "Generate the workflow that enables Dependabot security updates and applies the severity threshold. Default true."
                }
            },
            "additionalProperties": false,
            "description": "Dependabot security-update automation."
        },
        "CustomWorkflowSettings": {
            "anyOf": [
                {
                    "type": "string"
                },
                {
                    "$ref": "#/$defs/GitHubWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/GitLabWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/AzureWorkflowSetting"
                },
                {
                    "$ref": "#/$defs/WorkflowOptions"
                }
            ],
            "description": "A custom workflow: a raw YAML string, a complete GitHub/GitLab/Azure workflow (with `provider`), or GitHub settings merged over an empty workflow (use `triggers`, `extra` and `jobs` to define it)."
        },
        "ChangelogConfig": {
            "type": "object",
            "properties": {
                "commitlint": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ChangelogCommitlintConfig"
                        }
                    ],
                    "description": "commitlint config; set `false` to disable the Conventional-Commits pipeline."
                },
                "versioning": {
                    "default": true,
                    "description": "Automatic version bumping on changelog generation.",
                    "$ref": "#/$defs/ChangelogVersioning"
                },
                "intro": {
                    "description": "Opt-in text inserted at the start of the new changelog entry, globally or for matching targets (workspaces/root).",
                    "$ref": "#/$defs/ChangelogTextSetting"
                },
                "outro": {
                    "description": "Opt-in text appended to the new changelog entry, globally or for matching targets (workspaces/root).",
                    "$ref": "#/$defs/ChangelogTextSetting"
                },
                "vscode": {
                    "default": true,
                    "type": "boolean",
                    "description": "Write the Conventional-Commits VS Code settings."
                },
                "groups": {
                    "anyOf": [
                        {
                            "type": "array",
                            "items": {
                                "anyOf": [
                                    {
                                        "type": "string"
                                    },
                                    {
                                        "$ref": "#/$defs/ChangelogGroupOptions"
                                    }
                                ]
                            },
                            "description": "An ordered list of CC types or group objects."
                        },
                        {
                            "type": "object",
                            "propertyNames": {
                                "type": "string"
                            },
                            "additionalProperties": {
                                "anyOf": [
                                    {
                                        "type": "string"
                                    },
                                    {
                                        "$ref": "#/$defs/ChangelogGroupOptions"
                                    },
                                    {
                                        "type": "boolean"
                                    }
                                ]
                            },
                            "description": "A CC type to title/options/visibility record."
                        },
                        {
                            "description": "A custom group builder (TS/JS configs only)."
                        }
                    ],
                    "description": "Conventional-Commits group order/titles: an ordered array of CC types or `{ type, title, order, hidden }`, a type->title/options record, or a callback (TS/JS configs only)."
                },
                "breaking": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "string",
                            "enum": [
                                "conventional",
                                "any"
                            ]
                        },
                        {
                            "type": "object",
                            "properties": {
                                "pattern": {
                                    "type": "string",
                                    "description": "A regular expression matched against the subject and body."
                                },
                                "match": {
                                    "type": "string",
                                    "description": "A substring matched against the subject and body."
                                }
                            },
                            "additionalProperties": false
                        },
                        {
                            "description": "A custom breaking-change predicate (TS/JS configs only)."
                        }
                    ],
                    "description": "How breaking changes are detected: `conventional` (default: a `!` in the CC subject or a `BREAKING CHANGE:` footer), `any` (legacy loose match), `false` (disable), `{ pattern }` / `{ match }`, or a callback (TS/JS configs only)."
                },
                "release": {
                    "description": "Release-body aggregation options, used by `dbx changelog --release-body` and the generated release workflow.",
                    "$ref": "#/$defs/ChangelogReleaseConfig"
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Manual `toolchain.changelog` pipeline config for `dbx changelog`, the VS Code actions and the API; `ci.changelog` inherits these options."
        },
        "ToolchainFmtConfig": {
            "type": "object",
            "properties": {
                "vscode": {
                    "default": false,
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainVscodeSettings"
                        }
                    ],
                    "description": "Add project-scoped VS Code settings: `true`/`false` or `{ overrides, exclude }` (existing keys are kept)."
                },
                "oxc": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {},
                            "additionalProperties": {},
                            "description": "Oxfmt configuration options.",
                            "see": "https://oxc.rs/docs/guide/usage/formatter/config-file-reference.html"
                        }
                    ],
                    "description": "Oxfmt options (`true` = defaults, `false` = disabled). `toolchain.vite.fmt` overrides these (deep merge)."
                },
                "biome": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {},
                            "additionalProperties": {},
                            "description": "Biome configuration options.",
                            "see": "https://biomejs.dev/reference/configuration/"
                        }
                    ],
                    "description": "Biome formatter options (`true` = defaults, `false` = disabled); merged into the generated `biome.json` (arrays union; `$remove:`/`$reset` prune or replace them)."
                },
                "prettier": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {},
                            "additionalProperties": {},
                            "description": "Prettier configuration options.",
                            "see": "https://prettier.io/docs/options"
                        }
                    ],
                    "description": "Prettier options (`true` = defaults, `false` = disabled)."
                },
                "dprint": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {},
                            "additionalProperties": {},
                            "description": "Dprint configuration options.",
                            "see": "https://dprint.dev/config/"
                        }
                    ],
                    "description": "Dprint options (`true` = defaults, `false` = disabled)."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Formatter configuration: Oxc/Biome configs, editor defaults and source-tool options."
        },
        "ToolchainVscodeSettings": {
            "type": "object",
            "properties": {
                "overrides": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Settings deep-merged over the generated editor defaults."
                },
                "exclude": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Exact setting keys (eg. `editor.defaultFormatter`) to omit."
                }
            },
            "additionalProperties": false
        },
        "ToolchainLintConfig": {
            "type": "object",
            "properties": {
                "vscode": {
                    "default": false,
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainVscodeSettings"
                        }
                    ],
                    "description": "Add project-scoped VS Code settings: `true`/`false` or `{ overrides, exclude }` (existing keys are kept)."
                },
                "oxc": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {},
                            "additionalProperties": {},
                            "description": "Oxlint configuration options.",
                            "see": "https://oxc.rs/docs/guide/usage/linter/config-file-reference.html"
                        }
                    ],
                    "description": "Oxlint options (`true` = defaults, `false` = disabled). `toolchain.vite.lint` overrides these (deep merge)."
                },
                "biome": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {},
                            "additionalProperties": {},
                            "description": "Biome configuration options.",
                            "see": "https://biomejs.dev/reference/configuration/"
                        }
                    ],
                    "description": "Biome linter options (`true` = defaults, `false` = disabled); merged into the generated `biome.json` (arrays union; `$remove:`/`$reset` prune or replace them)."
                },
                "eslint": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {},
                            "additionalProperties": {},
                            "description": "ESLint configuration options.",
                            "see": "https://eslint.org/docs/latest/use/configure/configuration-files"
                        }
                    ],
                    "description": "ESLint options (`true` = defaults, `false` = disabled)."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Linter configuration: Oxc/Biome configs, editor defaults and ESLint options."
        },
        "ToolchainBiomeConfig": {
            "type": "object",
            "properties": {
                "vscode": {
                    "default": true,
                    "type": "boolean",
                    "description": "Write the Biome VS Code settings."
                },
                "overrides": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Deep-merged over the generated `biome.json` (arrays union; `$remove:`/`$reset` prune or replace them).",
                    "see": "https://biomejs.dev/reference/configuration/"
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Biome config generation (for consumers that still want a `biome.json`).",
            "deprecated": true,
            "deprecationMessage": "use `toolchain.fmt.biome` / `toolchain.lint.biome`. Still writes `biome.json`."
        },
        "ToolchainTsconfigConfig": {
            "type": "object",
            "properties": {
                "glob": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Glob(s) for the workspace default tsconfig files. Defaults to matching every `defaultFile` recursively."
                },
                "exclude": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Glob(s) to exclude from `glob`. Defaults to the common ignored paths (`node_modules`, `.dbx`, `dist`, `build`, ...)."
                },
                "gitignore": {
                    "default": true,
                    "type": "boolean",
                    "description": "Also respect `.gitignore` files (root + nested) when matching `glob`."
                },
                "refs": {
                    "default": false,
                    "type": "boolean",
                    "description": "Wire project references."
                },
                "composite": {
                    "default": false,
                    "type": "boolean",
                    "description": "Emit `composite: true`."
                },
                "aliases": {
                    "default": true,
                    "type": "boolean",
                    "description": "Inject path aliases."
                },
                "flattenRemoteExtends": {
                    "default": false,
                    "type": "boolean",
                    "description": "Inline the compiler options inherited from a remote `http(s)` `extends` chain into the generated workspace configs. Useful when a tool cannot follow a remote URL; path-valued options such as `paths`/`baseUrl` are skipped because they describe the remote tree. Settings the generated config already defines always win."
                },
                "auto": {
                    "default": false,
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainTsconfigAliasAutoSetting"
                        }
                    ],
                    "description": "Auto-generate the root workspaces tsconfig paths/references from the project graph. Set true to derive them from the project graph; set false to only use the entries you define yourself. An object additionally accepts `include`/`exclude`, `rewriteAlias`, `modes`, `prefix`, `devMode` and `dist`."
                },
                "aliasAuto": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainTsconfigAliasAutoSetting"
                        }
                    ],
                    "description": "Auto-generate path aliases (defaults to `auto`; `aliases` must also be enabled). Accepts the same `include`/`exclude`/`rewriteAlias`/`modes`/`prefix`/`devMode`/`dist` object as `auto`."
                },
                "refsAuto": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainTsconfigAutoSetting"
                        }
                    ],
                    "description": "Auto-generate project references (defaults to `auto`; `refs` must also be enabled)."
                },
                "autoSrcDir": {
                    "type": "string",
                    "description": "Source directory used to resolve workspace entry points when `package.json` does not declare `exports`/`main`/`types` (default: the workspace's final tsconfig `rootDir`/`baseUrl`, falling back to `src`)."
                },
                "indent": {
                    "default": 4,
                    "type": "number",
                    "description": "JSON indentation."
                },
                "rootFile": {
                    "default": "tsconfig.workspaces.json",
                    "type": "string",
                    "description": "The workspaces tsconfig file name that holds `paths` + `references`."
                },
                "defaultFile": {
                    "default": "tsconfig.default.json",
                    "type": "string",
                    "description": "The workspace default tsconfig file name that the generator expands."
                },
                "buildFile": {
                    "default": "tsconfig.build.json",
                    "type": "string",
                    "description": "The workspace build tsconfig file name."
                },
                "baseFile": {
                    "default": "tsconfig.base.json",
                    "type": "string",
                    "description": "The root base tsconfig file name."
                },
                "extends": {
                    "type": "object",
                    "properties": {
                        "base": {
                            "anyOf": [
                                {
                                    "type": "string"
                                },
                                {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                {
                                    "type": "boolean",
                                    "const": false
                                }
                            ],
                            "description": "`extends` written into scaffolded `tsconfig.base.json` files (or `false` to remove the field)."
                        },
                        "default": {
                            "anyOf": [
                                {
                                    "type": "string"
                                },
                                {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                {
                                    "type": "boolean",
                                    "const": false
                                }
                            ],
                            "description": "`extends` written into scaffolded `tsconfig.default.json` files (or `false` to remove the field)."
                        },
                        "build": {
                            "anyOf": [
                                {
                                    "type": "string"
                                },
                                {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                },
                                {
                                    "type": "boolean",
                                    "const": false
                                }
                            ],
                            "description": "`extends` written into scaffolded `tsconfig.build.json` files. Default `./tsconfig.default.json`; use `./tsconfig.json` to let builds reuse the path aliases (at the cost of pulling workspace source into the build)."
                        }
                    },
                    "additionalProperties": false,
                    "description": "Per-file `extends` overrides for generated/scaffolded tsconfig templates."
                },
                "overrides": {
                    "$ref": "#/$defs/ToolchainTsconfigOverrides"
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Workspace tsconfig generation (path aliases + project references)."
        },
        "ToolchainTsconfigAliasAutoSetting": {
            "type": "object",
            "properties": {
                "include": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Only auto-wire entries matching these globs (`auto`: workspace dirs; `aliasAuto`: rewritten alias keys; `refsAuto`: reference paths)."
                },
                "exclude": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Skip entries matching these globs (same targets as `include`)."
                },
                "rewriteAlias": {
                    "anyOf": [
                        {
                            "type": "object",
                            "propertyNames": {
                                "type": "string"
                            },
                            "additionalProperties": {
                                "type": "string"
                            }
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "object",
                                "properties": {
                                    "pattern": {
                                        "anyOf": [
                                            {
                                                "type": "string"
                                            },
                                            {
                                                "type": "array",
                                                "items": {
                                                    "type": "string"
                                                }
                                            }
                                        ]
                                    },
                                    "replacement": {
                                        "type": "string"
                                    }
                                },
                                "required": [
                                    "pattern",
                                    "replacement"
                                ],
                                "additionalProperties": false
                            }
                        }
                    ],
                    "description": "Rewrite the alias keys auto-wiring generates (custom keys are preserved). Patterns are URL-rewrite style: a string is a regular-expression source and replacements support `$1`, `$2`, ... capture groups. Examples: `{ \"^@org/(.+)$\": \"@org/pkg/$1\" }` (string patterns), `[{ pattern: /^@org\\/(.+)$/, replacement: \"@org/pkg/$1\" }]` (RegExp patterns), `[{ pattern: [\"^@org/a$\", \"^@org/b$\"], replacement: \"@org/x\" }]` (an array of keys), and an array of such rules (applied in order; the first matching rule wins). `RegExp` patterns are only available from TS/JS configs; JSON configs use string patterns."
                },
                "modes": {
                    "anyOf": [
                        {
                            "type": "string",
                            "const": "auto"
                        },
                        {
                            "type": "string",
                            "const": "exports"
                        },
                        {
                            "type": "string",
                            "const": "project-structure"
                        },
                        {
                            "type": "array",
                            "items": {
                                "anyOf": [
                                    {
                                        "type": "string",
                                        "const": "exports"
                                    },
                                    {
                                        "type": "string",
                                        "const": "project-structure"
                                    }
                                ]
                            }
                        }
                    ],
                    "description": "Alias discovery: `auto` (exports, then the project structure), `exports` (package.json exports/types/main only), `project-structure` (scan the source tree), or an array combining `exports` and `project-structure`."
                },
                "prefix": {
                    "type": "string",
                    "description": "Prefix for generated aliases instead of the package scope (eg. `@` produces `@/<package>` and `@/<package>/<subpath>`)."
                },
                "devMode": {
                    "default": true,
                    "type": "boolean",
                    "description": "Resolve generated aliases to source files. Set false to point at the distributed files instead."
                },
                "dist": {
                    "type": "string",
                    "description": "Output directory used to map source/dist targets (default: the workspace tsconfig's `outDir`, then `dist`)."
                }
            },
            "additionalProperties": false
        },
        "ToolchainTsconfigAutoSetting": {
            "type": "object",
            "properties": {
                "include": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Only auto-wire entries matching these globs (`auto`: workspace dirs; `aliasAuto`: rewritten alias keys; `refsAuto`: reference paths)."
                },
                "exclude": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Skip entries matching these globs (same targets as `include`)."
                }
            },
            "additionalProperties": false
        },
        "ToolchainTsconfigOverrides": {
            "type": "object",
            "properties": {
                "base": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Deep-merged into the root base tsconfig (`baseFile`) during sync.",
                    "see": "https://www.typescriptlang.org/tsconfig"
                },
                "default": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Deep-merged into every workspace default tsconfig (`defaultFile`) during sync.",
                    "see": "https://www.typescriptlang.org/tsconfig"
                },
                "build": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Deep-merged into every workspace build tsconfig (`buildFile`) during sync.",
                    "see": "https://www.typescriptlang.org/tsconfig"
                },
                "root": {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {},
                    "description": "Deep-merged into the root workspaces tsconfig (`rootFile`) during sync.",
                    "see": "https://www.typescriptlang.org/tsconfig"
                }
            },
            "additionalProperties": false,
            "description": "Managed overrides deep-merged into the base/root/default/build tsconfig files during sync. The originals are snapshotted in the manifest, so removing a key reverts it (restoring the original value when the file defined one)."
        },
        "ToolchainLoaderConfig": {
            "type": "object",
            "properties": {
                "tsconfig": {
                    "default": true,
                    "description": "The tsconfig the config loader uses. `true` selects the nearest `tsconfig.json`; a string selects a different file (relative to the project root); `false` disables tsconfig resolution.",
                    "type": [
                        "boolean",
                        "string"
                    ]
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "How `dbx.config.*` files are imported (tsconfig discovery).",
            "see": "https://tsx.is"
        },
        "ToolchainTemplatesConfig": {
            "type": "object",
            "properties": {
                "sources": {
                    "type": "array",
                    "items": {
                        "$ref": "#/$defs/ToolchainTemplateSource"
                    },
                    "description": "Extra sources on top of the builtin + registry sources."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Template sources / scaffolding."
        },
        "ToolchainTemplateSource": {
            "type": "object",
            "properties": {
                "type": {
                    "$ref": "#/$defs/ToolchainTemplateSourceType"
                },
                "locate": {
                    "type": "string",
                    "description": "A builtin id, local dir, npm scope, git URL or Vite+ id."
                },
                "id": {
                    "type": "string",
                    "description": "Stable id (defaults to the basename/scope)."
                },
                "name": {
                    "type": "string",
                    "description": "Display name override."
                },
                "description": {
                    "type": "string",
                    "description": "Description override."
                },
                "kind": {
                    "$ref": "#/$defs/ToolchainTemplateKind"
                },
                "ref": {
                    "type": "string",
                    "description": "Git branch/tag/commit."
                },
                "registry": {
                    "type": "string",
                    "description": "Custom npm registry URL (default: the project package manager registry)."
                },
                "subdir": {
                    "type": "string",
                    "description": "Subdirectory within the source that holds the template."
                },
                "tags": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Free-form tags."
                },
                "online": {
                    "type": "boolean",
                    "description": "Whether the source needs network access."
                }
            },
            "required": [
                "type",
                "locate"
            ],
            "additionalProperties": false,
            "description": "A template source: builtin, local, npm, git or Vite+."
        },
        "ToolchainTemplateSourceType": {
            "type": "string",
            "enum": [
                "builtin",
                "local",
                "npm",
                "git",
                "vite-plus",
                "remote"
            ],
            "description": "How to load the source."
        },
        "ToolchainTemplateKind": {
            "type": "string",
            "enum": [
                "project",
                "workspace",
                "application",
                "folder",
                "tooling",
                "pipeline"
            ],
            "description": "What the template produces."
        },
        "ToolchainRegistryConfig": {
            "type": "object",
            "properties": {
                "templates": {
                    "description": "Allow/deny globs for template sources and registries.",
                    "$ref": "#/$defs/ToolchainRegistryPolicy"
                },
                "providers": {
                    "description": "Allow/deny globs for provider sources and registries.",
                    "$ref": "#/$defs/ToolchainRegistryPolicy"
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Registry source allow/deny policies (templates + providers)."
        },
        "ToolchainRegistryPolicy": {
            "type": "object",
            "properties": {
                "allow": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Allowed host/path globs. When non-empty, only matching sources are used (eg. `*.example.com`, `https://registry.example.com/**`)."
                },
                "deny": {
                    "type": "array",
                    "items": {
                        "type": "string"
                    },
                    "description": "Denied host/path globs (checked before `allow`)."
                }
            },
            "additionalProperties": false,
            "description": "Registry source allow/deny globs."
        },
        "ToolchainCatalogsConfig": {
            "type": "object",
            "properties": {
                "packages": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": "string"
                    },
                    "description": "The default catalog: package name -> version range."
                },
                "named": {
                    "type": "object",
                    "propertyNames": {
                        "type": "string"
                    },
                    "additionalProperties": {
                        "type": "object",
                        "propertyNames": {
                            "type": "string"
                        },
                        "additionalProperties": {
                            "type": "string"
                        }
                    },
                    "description": "Named catalogs (Yarn `catalogs:` / pnpm `catalogs:`): name -> packages."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Package catalogs written to the package manager catalog file (`catalog:`)."
        },
        "ToolchainViteConfig": {
            "type": "object",
            "properties": {
                "config": {
                    "default": true,
                    "description": "Write the managed Vite config. A string sets its file name/path (relative to the project, or an absolute path inside it).",
                    "type": [
                        "boolean",
                        "string"
                    ]
                },
                "shim": {
                    "default": "runtime",
                    "type": "string",
                    "enum": [
                        "runtime",
                        "static"
                    ],
                    "description": "How the generated `vite.config.ts` is rendered. `runtime` loads the config from `dbx.config.*`; `static` serializes it into the file so the shim does not import `@deltabox/toolchain` (it then needs no built `dist`)."
                },
                "shimImport": {
                    "type": "string",
                    "description": "Module specifier used to import `resolveVite` in runtime shims (default `@deltabox/toolchain/vite`; the legacy `vite-plugin-dbx` is still accepted). A relative path is resolved from the repo root and rewritten relative to each generated config - useful for dogfooding a source checkout without a built `dist`."
                },
                "fmt": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {},
                            "additionalProperties": {},
                            "description": "Oxfmt configuration options.",
                            "see": "https://oxc.rs/docs/guide/usage/formatter/config-file-reference.html"
                        }
                    ],
                    "description": "Oxfmt options; `true` uses the toolchain defaults."
                },
                "lint": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {},
                            "additionalProperties": {},
                            "description": "Oxlint configuration options.",
                            "see": "https://oxc.rs/docs/guide/usage/linter/config-file-reference.html"
                        }
                    ],
                    "description": "Oxlint options; `true` uses the toolchain defaults."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": {},
            "description": "The full Vite+ config; `dbx sync` writes the root `vite.config.ts` from it."
        },
        "ToolchainWatchConfig": {
            "type": "object",
            "properties": {
                "debounce": {
                    "default": 150,
                    "type": "number",
                    "description": "Debounce window in ms."
                },
                "exclude": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Glob(s) excluded from watching. Defaults to the common ignored paths (`node_modules`, `.dbx`, `dist`, `build`, ...)."
                },
                "gitignore": {
                    "default": true,
                    "type": "boolean",
                    "description": "Also respect `.gitignore` files (root + nested) when watching."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Watch behaviour for `dbx watch`."
        },
        "ToolchainSyncConfig": {
            "type": "object",
            "properties": {
                "format": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "type": "object",
                            "properties": {
                                "enabled": {
                                    "type": "boolean",
                                    "description": "Format the managed files after writing them (default true once enabled)."
                                },
                                "fix": {
                                    "type": "boolean",
                                    "description": "Rewrite the managed files with the formatter (default true). Set false to run the formatter in check mode instead."
                                },
                                "command": {
                                    "type": "string",
                                    "description": "Override the formatter command. `{files}` expands to the managed files (space-separated); when it is absent the files are appended."
                                },
                                "exclude": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    },
                                    "description": "Globs of managed files to leave unformatted (per-file opt-out)."
                                }
                            },
                            "additionalProperties": false
                        }
                    ],
                    "description": "Opt-in formatting of the managed files after generation. `true` uses the defaults, `false` disables it, and an object tunes `enabled`/`fix`/`command`/`exclude`."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "`dbx sync` behaviour (formatting of the managed files)."
        },
        "ToolchainLoggerConfig": {
            "type": "object",
            "properties": {
                "level": {
                    "default": "info",
                    "type": "string",
                    "enum": [
                        "debug",
                        "info",
                        "warn",
                        "error",
                        "silent"
                    ],
                    "description": "Minimum level to print."
                },
                "color": {
                    "default": true,
                    "type": "boolean",
                    "description": "Force colours on/off; `--no-color` disables."
                },
                "name": {
                    "default": "dbx",
                    "type": "string",
                    "description": "Prefix non-indented lines with `<name>:`."
                },
                "suppress": {
                    "anyOf": [
                        {
                            "type": "string"
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    ],
                    "description": "Warning/error id, message substring, or `/regex/` to silence (single value or array)."
                },
                "logger": {
                    "type": "object",
                    "properties": {
                        "raw": {
                            "description": "Write raw stdout."
                        },
                        "rawError": {
                            "description": "Write raw stderr."
                        },
                        "write": {
                            "description": "Write to a specific output channel."
                        },
                        "debug": {
                            "description": "Print a debug message."
                        },
                        "info": {
                            "description": "Print an info message."
                        },
                        "success": {
                            "description": "Print a success message."
                        },
                        "warn": {
                            "description": "Print a warning."
                        },
                        "error": {
                            "description": "Print an error."
                        }
                    },
                    "required": [
                        "raw",
                        "rawError",
                        "write",
                        "debug",
                        "info",
                        "success",
                        "warn",
                        "error"
                    ],
                    "additionalProperties": false,
                    "description": "Custom `ToolchainLogger` implementation (TS/JS configs only; JSON cannot carry functions)."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Logging level, colours and prefix for toolchain output."
        },
        "ToolchainProvidersConfig": {
            "type": "object",
            "properties": {
                "color": {
                    "type": "boolean",
                    "description": "Force provider command colours on/off (default: inherit the logger)."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Provider command behaviour (eg. colour for the passthrough commands)."
        },
        "ToolchainMcpConfig": {
            "type": "object",
            "properties": {
                "skills": {
                    "anyOf": [
                        {
                            "type": "boolean"
                        },
                        {
                            "$ref": "#/$defs/ToolchainMcpSkillsConfig"
                        }
                    ],
                    "description": "Install the official dbx skill into agent harnesses during `dbx sync`. Opt in by defining this section."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "MCP server and skill installation for AI harnesses."
        },
        "ToolchainMcpSkillsConfig": {
            "type": "object",
            "properties": {
                "agents": {
                    "anyOf": [
                        {
                            "type": "string",
                            "enum": [
                                "claude",
                                "codex",
                                "vscode",
                                "opencode",
                                "pi",
                                "custom"
                            ]
                        },
                        {
                            "type": "array",
                            "items": {
                                "type": "string",
                                "enum": [
                                    "claude",
                                    "codex",
                                    "vscode",
                                    "opencode",
                                    "pi",
                                    "custom"
                                ]
                            }
                        }
                    ],
                    "description": "Agent harness(es) to install into (default: every builtin provider). `custom` requires `dir`."
                },
                "scope": {
                    "default": "project",
                    "type": "string",
                    "enum": [
                        "project",
                        "global"
                    ],
                    "description": "Write the skill into the project (default) or the user profile."
                },
                "dir": {
                    "type": "string",
                    "description": "Custom directory to write the skill into (with `agents: ['custom']`)."
                },
                "force": {
                    "default": false,
                    "type": "boolean",
                    "description": "Overwrite an existing skill file (default: keep it)."
                },
                "enabled": {
                    "description": "Enable/disable this section (default: enabled when defined).",
                    "type": "boolean"
                },
                "regenerate": {
                    "description": "Regenerate this section's managed files during `dbx sync`. When false, existing files are left untouched and are neither written nor drift-checked.",
                    "default": true,
                    "type": "boolean"
                }
            },
            "additionalProperties": false,
            "description": "Install the official dbx docs skill into AI agent harnesses."
        },
        "ToolchainHooks": {
            "type": "object",
            "properties": {
                "afterLoad": {
                    "description": "Runs after the config is loaded and its tokens are resolved."
                },
                "beforeSync": {
                    "description": "Runs once before the sync tasks."
                },
                "beforeTask": {
                    "description": "Runs before each sync task."
                },
                "afterTask": {
                    "description": "Runs after each sync task, with the files it produced (if any)."
                },
                "afterSync": {
                    "description": "Runs once after the sync tasks with the result summary."
                },
                "beforeVersion": {
                    "description": "Runs after the bump is planned and before `dbx changelog` writes versions/changelogs."
                },
                "afterVersion": {
                    "description": "Runs after `dbx changelog` writes the new versions and changelogs."
                },
                "onChange": {
                    "description": "Runs on every watch-triggered change."
                }
            },
            "additionalProperties": false,
            "description": "Lifecycle hooks (functions; TS/JS configs only). Return values are awaited."
        }
    },
    "required": []
}
