Skip to content

fix: clarify sandboxed local server failures#167

Merged
blimmer merged 1 commit into
mainfrom
codex/network-sandbox-error-message
May 19, 2026
Merged

fix: clarify sandboxed local server failures#167
blimmer merged 1 commit into
mainfrom
codex/network-sandbox-error-message

Conversation

@blimmer
Copy link
Copy Markdown
Contributor

@blimmer blimmer commented May 18, 2026

Summary

ContextBridge now recognizes likely localhost bind failures caused by coding harness network sandboxes and reports them as user-recoverable environment errors. This gives users actionable guidance instead of the confusing Bun message Failed to start server. Is port 0 in use?, and it avoids sending these sandbox failures to Sentry as runtime errors. Closes #168; fixes PLANBRIDGE-BACKEND-E.

Review focus

Please check the boundary choice: the server API stays throw-based, while CLI annotation handlers classify only known local network sandbox signals before converting them to warn-level command errors. Explicit port conflicts, including CONTEXTBRIDGE_PORT, should remain normal runtime errors.

Commits

  • f100e05 — clarify sandboxed local server failures

@blimmer blimmer force-pushed the codex/network-sandbox-error-message branch from 5b4d845 to 03cd91c Compare May 18, 2026 16:38
@blimmer blimmer force-pushed the codex/network-sandbox-error-message branch from 03cd91c to f100e05 Compare May 18, 2026 17:18
@blimmer blimmer marked this pull request as ready for review May 18, 2026 17:19
@blimmer blimmer requested a review from jcarver989 as a code owner May 18, 2026 17:19
@blimmer blimmer merged commit c3de712 into main May 19, 2026
12 checks passed
@blimmer blimmer deleted the codex/network-sandbox-error-message branch May 19, 2026 13:41
blimmer pushed a commit that referenced this pull request May 19, 2026
🤖 I have created a release *beep* *boop*
---


##
[0.7.1](v0.7.0...v0.7.1)
(2026-05-19)


### Bug Fixes

* clarify sandboxed local server failures
([#167](#167))
([c3de712](c3de712))
* **website:** typo in website agent instructions copy
([#149](#149))
([6c85ebd](6c85ebd))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

Co-authored-by: contextbridge-pr-automation[bot] <259134118+contextbridge-pr-automation[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

bug: show actionable error for sandboxed local server startup failures

2 participants