zeroclaw-labs/zeroclaw

[Feature]: Add self-test and doctor tests for web_dist_dir for using tilde (~) or $HOME which will fail Web UI from starting

Open

#6079 opened on Apr 24, 2026

View on GitHub
 (1 comment) (0 reactions) (0 assignees)Rust (31,341 stars) (4,614 forks)batch import
configenhancementgatewayhelp wantedpriority:p2risk: lowstatus:acceptedstatus:no-stale

Description

Summary

Improve the fault check when using self-test and doctor

Problem statement

The problem is that the config for: web_dist_dir cannot contain any tildes (~) or variables ($HOME), as in "~/yo_mama/zeroclaw/web/dist".

We need a check for ~ or $.

Proposed solution

Make these check for ~ or $.

zeroclaw self-test
zeroclaw doctor

Non-goals / out of scope

na

Alternatives considered

none

Acceptance criteria

Make a check for ~ or $ in the web_dist_dir config.

Architecture impact

none

Risk and rollback

none

Breaking change?

No

Data hygiene checks

  • I removed personal/sensitive data from examples, payloads, and logs.
  • I used neutral, project-focused wording and placeholders.

Contributor guide

Tech stack
rust
Domain
backend
Issue type
feature
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Rust basicsconfig file parsing
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
80
Research direction
The issue requires adding a check in the self test and doctor commands to validate that the `web dist dir` config value does not contain tilde (~) or dollar sign ($). Locate the configuration parsing module (likely `src/config.rs`) and add a simple string check (e.g., contains '~' or '$'). Then update the self test and doctor commands to perform this validation and emit a clear error message. No breaking changes expected.