Implement route health check and recovery
Open
@connerccook is already working on this.
Since Sep 17, 2026.
- Dominant language
- Go
- Stars
- 6
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Description
Problem Statement
During the lifetime of a route, various things can happen: the tunnel connection can be lost, a user's access can be revoked invalidating their routes, etc. A periodic check of the route and it's status are necessary to handle these cases.
Proposed Solution
Add a background task that queries the associated route, reviews its status and responds accordingly. The most common initial case is that the connection to piko closes, transitions the route state to DOWN, and needs to be reopened. In the future, this background task will be where token rotation gets implemented
Exit Criteria
- A background job is started when a wormhole is opened
- The background job queries for its own associated route and passes this to any available handlers
- An API call that 404s for a route shuts down the wormhole-cli process
- A simple handler is created to reestablish a piko connection
- The job execution cycle is configurable
- A threshold for failed handler attempts is configurable (i.e. after
Nattempts, shutdown)
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.