docs: runner doctor scan 2026-07-15/16 — add D7 (gVisor/Bun JIT), update B2 (proxy --env), update C8 (BYOK sentinel)

[Copilot]

Runner Doctor knowledge-base sync for the 2026-07-15–16 scan window. Three new lessons across two catalog files (shared/self-hosted-failure-modes.md and self-hosted-runner-doctor.md).

New: D7 — gVisor + Bun/JSC JIT crash

Claude Code (Bun runtime) crashes with SIGSEGV/SIGABRT under --container-runtime gvisor because JSC JIT requires W^X memory operations that gVisor's restricted syscall surface blocks. Each retry fails with exit code 1, often with no output.

Fix: --env BUN_JSC_useJIT=0 forces JSC into interpreter mode. A postprocess-smoke-workflows.ts hook auto-injects this for smoke-gvisor-claude workflows on recompile.

Added:

• D7 row in Category D table
• D7 entry in the error-string quick-lookup table
• D7 symptom match and fix note in the runner doctor playbook

Update: B2 — proxy --env override silently blocked

AWF ≤ v0.27.32 dropped NO_PROXY/HTTP_PROXY/HTTPS_PROXY when passed via --env because PROXY_ENV_VARS were in the credential exclusion set. Fixed in #6267 (proxy vars now checked against allowlist and passed through additionalEnv).

Updated B2 Fix column and citations in both files.

Update: C8 — offline BYOK sentinel triggers 400 on Business/Enterprise

gh-aw offline mode sets COPILOT_PROVIDER_API_KEY=dummy-byok-key-for-offline-mode as a sentinel. AWF before #6237 treated it as a real BYOK key, suppressing GitHub-token auth and producing 400 on api.business/enterprise.githubcopilot.com. Fixed by classifying the sentinel as a non-credential placeholder.

Updated C8 Signal and Fix columns, added #6237 to citations in both files.

---

Note: .github/agents/self-hosted-runner-doctor.md (portable agent copy) is not updated here — that directory is access-restricted in the agent environment.

[Copilot]

Pull request overview

Updates Runner Doctor guidance for proxy overrides, Copilot offline authentication, and Claude/Bun crashes under gVisor.

Changes:

• Documents the #6267 proxy environment fix.
• Expands C8 for the offline BYOK sentinel fix.
• Adds D7 for Bun JIT failures under gVisor.

Show a summary per file

File	Description
.github/workflows/shared/self-hosted-failure-modes.md	Updates B2/C8 and adds D7 catalog entries.
.github/workflows/self-hosted-runner-doctor.md	Adds C8 and D7 diagnostic guidance.

Review details

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

• Files reviewed: 2/2 changed files
• Comments generated: 4
• Review effort level: Medium

[lpcox]

@copilot address review feedback

[Copilot]

@copilot address review feedback

Done in the latest commit. Here's a summary of each fix:

D7 (both files + portable copy): Removed the stale postprocess-smoke-workflows.ts hook reference. The Fix column and known-fix entry now document that AWF (PR #6276) automatically sets BUN_JSC_useJIT=0 at runtime via buildToolEnvironment() when Claude runs under gVisor. --env BUN_JSC_useJIT=0 is retained only as a manual fallback for older AWF builds without #6276. Citations updated to include #6276.

C8 Root cause (both files + portable copy): Expanded the root-cause column to describe both distinct defects explicitly — the pre-#5872 AWF_PLATFORM_TYPE guard short-circuit, and the post-#5872/#6237 BYOK sentinel (dummy-byok-key-for-offline-mode) suppressing the GitHub-token auth path. Also fixed the stray period (v0.27.16.; → v0.27.16;) in the Signal column.

Portable agent copy (.github/agents/self-hosted-runner-doctor.md): Added the complete D7 entry (catalog table row, error-string quick-lookup entry, and known-fix paragraph), updated C8 Signal/Root-cause/Fix/Citations to match the catalog, and updated B2 with the #6267 proxy --env fix.

[github-actions]

✅ Copilot review passed with no inline comments.

@copilot Add the ready-for-aw label to this PR to trigger agentic CI smoke tests.

[github-actions]

✅ Smoke Copilot BYOK completed. Copilot BYOK mode operational. 🔓

[github-actions]

Chroot tests passed! Smoke Chroot - All security and functionality tests succeeded.

[github-actions]

❌ Smoke Copilot BYOK AOAI (api-key) reports failed. AOAI BYOK (api-key) mode investigation needed...

[github-actions]

🔌 Smoke Services — All services reachable! ✅

[github-actions]

✅ Smoke Gemini completed. All facets verified. 💎

[github-actions]

✅ Build Test Suite completed successfully!

[github-actions]

🔑 Smoke Copilot PAT PAT auth validated. All systems operational. ✅

[github-actions]

📡 Smoke OTel Tracing completed. All tracing scenarios validated. ✅

[github-actions]

✅ Contribution Check completed successfully!

PR #6315 is documentation-only and satisfies the applicable CONTRIBUTING.md guidelines: documentation is updated, the description is clear with related PR references, no new functionality requires tests, and files are organized under the existing .github documentation/workflow locations.

[github-actions]

❌ Smoke Copilot BYOK AOAI (Entra) reports failed. AOAI BYOK (Entra) mode investigation needed...

[github-actions]

📰 VERDICT: Smoke Copilot has concluded. All systems operational. This is a developing story. 🎤

[github-actions]

🚀 Security Guard has started processing this pull request

[github-actions]

🌑 The shadows whisper... Smoke Codex failed. The oracle requires further meditation...

[github-actions]

📰 VERDICT: Smoke Docker Sbx has concluded. All systems operational. This is a developing story. 🎤

[github-actions]

✅ Smoke Claude passed

[github-actions]

🔍 Smoke Test: Copilot PAT Auth

Test	Status
GitHub MCP	✅ Connected
GitHub.com HTTP	⚠️ N/A — template vars not expanded
File Write/Read	⚠️ N/A — template vars not expanded

Overall: PARTIAL — ${{ steps.smoke-data.outputs.* }} were not substituted before agent execution.

Auth mode: PAT (COPILOT_GITHUB_TOKEN)

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

🔑 PAT report filed by Smoke Copilot PAT
_{Add label ready-for-aw to run again}

[github-actions]

Smoke test: direct BYOK mode (COPILOT_PROVIDER_API_KEY)

• GitHub MCP: ✅
• GitHub.com HTTP: ⚠️ (pre-fetched data unresolved)
• File write/read: ⚠️ (pre-fetched data unresolved)
• BYOK inference (api-proxy → api.githubcopilot.com): ✅

Running in direct BYOK mode (COPILOT_PROVIDER_API_KEY) via api-proxy → api.githubcopilot.com
Overall: PARTIAL — @lpcox

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

🔑 BYOK report filed by Smoke Copilot BYOK
_{Add label ready-for-aw to run again}

[github-actions]

🤖 Smoke Test Results

Test	Status
GitHub MCP connectivity	✅
GitHub.com HTTP	✅
File write/read	✅

Overall: PASS

Author: @lpcox

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

📰 BREAKING: Report filed by Smoke Copilot
_{Add label ready-for-aw to run again}

[github-actions]

Smoke Test: Claude Engine Validation

Check	Result
API Status	✅ PASS
GH Check	✅ PASS
File Status	✅ PASS

Overall Result: PASS

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by Smoke Claude for #6315 · 35.3 AIC · ⊞ 3.3K · ◷
_{Add label ready-for-aw to run again}

[github-actions]

Smoke Test Results

• PR chore: upgrade gh-aw extension to latest pre-release #6324: [Filtered - Access Denied]
• PR chore: update model-to-API mapping (2026-07-17) #6317: [Filtered - Access Denied]
• GitHub MCP Testing: ❌ (Secrecy Filtered)
• GitHub Connectivity: ❌ (Status 000)
• File Writing Testing: ✅
• Bash Tool Testing: ✅

Overall status: FAIL

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• localhost

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "localhost"

See Network Configuration for more information.

💎 Faceted by Smoke Gemini
_{Add label ready-for-aw to run again}

[github-actions]

Smoke Test: Services Connectivity

• Redis PING: ❌ (host.docker.internal DNS resolution failed)
• PostgreSQL pg_isready: ❌ (no response)
• PostgreSQL SELECT 1: ❌ (host not reachable)

Overall: FAIL — service containers unreachable (host.docker.internal does not resolve; 172.17.0.1 also unreachable).

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

🔌 Service connectivity validated by Smoke Services
_{Add label ready-for-aw to run again}

[github-actions]

🔍 Smoke Test: API Proxy OpenTelemetry Tracing

Scenario	Result	Notes
S1: Module Loading	✅ Pass	otel.js loads successfully; exports: startRequestSpan, setTokenAttributes, setBudgetAttributes, endSpan, endSpanError, shutdown, isEnabled
S2: Test Suite	✅ Pass	59/59 tests passed across otel.test.js and otel-fanout.test.js
S3: Env Var Forwarding	✅ Pass	src/services/api-proxy-env-config.ts forwards GH_AW_OTLP_ENDPOINTS, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_HEADERS, GITHUB_AW_OTEL_TRACE_ID, GITHUB_AW_OTEL_PARENT_SPAN_ID, OTEL_SERVICE_NAME to the api-proxy container
S4: Token Tracker Integration	✅ Pass	onUsage callback exists in token-tracker-http.js (line 285, invoked at line 343) as the OTEL hook point
S5: OTEL Diagnostics	✅ Pass	isEnabled() returns true; graceful degradation uses FileSpanExporter when no OTLP config is set

All 5 scenarios passed. OTEL tracing integration is fully functional.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

📡 OTel tracing validated by Smoke OTel Tracing
_{Add label ready-for-aw to run again}

[github-actions]

🏗️ Build Test Suite Results

Ecosystem	Project	Build/Install	Tests	Status
Bun	elysia	✅	1/1 passed	✅ PASS
Bun	hono	✅	1/1 passed	✅ PASS
C++	fmt	✅	N/A	✅ PASS
C++	json	✅	N/A	✅ PASS
Deno	oak	N/A	1/1 passed	✅ PASS
Deno	std	N/A	1/1 passed	✅ PASS
.NET	hello-world	✅	N/A	✅ PASS
.NET	json-parse	✅	N/A	✅ PASS
Go	color	✅	1/1 passed	✅ PASS
Go	env	✅	1/1 passed	✅ PASS
Go	uuid	✅	1/1 passed	✅ PASS
Java	gson	✅	1/1 passed	✅ PASS
Java	caffeine	✅	1/1 passed	✅ PASS
Node.js	clsx	✅	passed	✅ PASS
Node.js	execa	✅	passed	✅ PASS
Node.js	p-limit	✅	passed	✅ PASS
Rust	fd	✅	1/1 passed	✅ PASS
Rust	zoxide	✅	1/1 passed	✅ PASS

Overall: 8/8 ecosystems passed — ✅ PASS

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by Build Test Suite for #6315 · 31.1 AIC · ⊞ 6.9K · ◷
_{Add label ready-for-aw to run again}

[github-actions]

Chroot Version Comparison Results

Runtime	Host Version	Chroot Version	Match?
Python	Python 3.12.13	Python 3.12.3	❌ NO
Node.js	v24.18.0	v22.23.1	❌ NO
Go	go1.22.12	go1.22.12	✅ YES

Result: Not all tests passed — Python and Node.js versions differ between host and chroot.

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Tested by Smoke Chroot
_{Add label ready-for-aw to run again}

[github-actions]

🔍 Smoke Test Results — Docker Sbx

Test	Result
GitHub MCP connectivity	✅ Connected (data filtered by secrecy policy)
GitHub.com HTTP	⚠️ Pre-step template vars unexpanded (${{ }} not resolved)
File write/read	⚠️ Pre-step template vars unexpanded (${{ }} not resolved)

Overall: ⚠️ PARTIAL — smoke-data pre-step outputs were not interpolated into the workflow prompt. MCP connectivity confirmed.

cc @lpcox

📰 BREAKING: Report filed by Smoke Docker Sbx
_{Add label ready-for-aw to run again}