llnl / llnl/wormhole-cli

Implement route health check and recovery

Open
#5 0 comments 0 reactions 1 assignee View on GitHub

@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 N attempts, shutdown)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.