{"version":"2.1.309","anchor":"setup-failure-kind-attached-to-git-proxy-config-errors-vm-n","canonical_anchor":"setup-failure-kind-attached-to-git-proxy-config-errors-vm-n","heading":"Runner and remote-session setup failures now say what kind of failure it was","tier":"notice","area":"Cloud Sessions","scope":"both","heads_up":false,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.309\/e\/setup-failure-kind-attached-to-git-proxy-config-errors-vm-n","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.309","markdown":"### Runner and remote-session setup failures now say what kind of failure it was\n\nWhen a self-hosted runner or remote session fails to set up, the error now carries a failure kind such as filesystem error or repo settings rejected\n\n**What**\n\nA self-hosted runner is a machine you run yourself that starts Claude Code sessions for the web. When setting up such a session fails, the error is now tagged with a failure kind instead of being passed on unlabelled:\n\n- Failing to write the git proxy configuration is tagged `SETUP_FAILURE_KIND_SOURCE_PREP_FAILED`.\n\n- Failing to restore git hook stubs, or to clean up git state in the runner's home folder, is tagged `SETUP_FAILURE_KIND_FILESYSTEM_ERROR`.\n\n- Failures while confining the session to its folders or resolving real paths are tagged with kinds such as `SETUP_FAILURE_KIND_REPO_SETTINGS_REJECTED` and `SETUP_FAILURE_KIND_FILESYSTEM_ERROR`. Clone failures go through a similar wrapper.\n\n- The error result reported when runner setup fails now includes a `setup_failure_kind` field.\n\nOther runner setup changes in the same code:\n\n- The `disableAllHooks` warning is skipped when a new flag is set.\n\n- The list of extra working folders takes an extra input.\n\n- In VM mode, host registration also passes along notes.\n\n**Why**\n\nPrograms and people watching runner sessions can tell what kind of setup problem happened, such as a filesystem error or rejected repository settings, instead of seeing a generic setup error.\n\n- Area: Cloud Sessions\n- Tier: You'll notice\n- Useful: 2\/5\n- Signal: 2\/5\n- Scope: both\n- Heads-up: no"}