Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

evidencectl doctor: opaque error for a relative --runtime-config path

Open Beginner friendly
#1,449 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
76/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
rust
Domain
cli

Research direction

Start in crates/registry-evidencectl/src/doctor.rs around line 875, where relative --runtime-config path handling is documented. Reproduce the doctor command with the relative and absolute runtime.yaml paths, then verify that the relative form resolves or is accepted and exposes the underlying configuration problem instead of returning the opaque failure message.

Written by the indexing model from the issue text.

Description

agent-ready area:evidence bug criticality:p3 triage:needs-implementation

Running evidencectl doctor --runtime-config hosts/staging/candidate-1/runtime.yaml (a relative
path) gives error[evidence.doctor.failed] ... Evidence could not inspect the selected runtime configuration. Running the identical check with the absolute path reveals the real cause (in this
repro, a TLS CA bundle file that was writable, fixed with chmod 444). doctor's path handling lives
in crates/registry-evidencectl/src/doctor.rs, which already documents its intent to resolve a
project-relative path where possible (around line 875).

This only affects an operator running doctor interactively; it does not block anything already
running, since the absolute-path form of the same command already works.

The audit recommended accepting or resolving relative --runtime-config paths so this class of
opaque failure does not happen at all.

Found in the 2026-09-24 lifecycle audit (EVID-21); the detailed finding is in the internal audit
report.

Dominant language
Rust
Stars
2
Forks
0
Avg merge
5h 13m
Merged PRs (30d)
176

Getting set up

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.

More from registrystack/registry-stack

All issues in registrystack/registry-stack

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.