Skip to main content

Module diagnostics

Module diagnostics 

Source
Expand description

Deep developer-environment diagnostics for limit dev.

Inspects PATH hygiene, key environment variables, installed dev tools, stack-specific context (virtualenvs, Cargo home, lock files) and commonly used dev ports, then folds everything into a single EnvironmentState snapshot with a HealthScore and beginner-friendly MentorMessages.

Structs§

NamedCheck
A single named check that can be scheduled on a worker thread.
PathReport
The result of analysing a raw PATH string.

Constants§

CHECK_TIMEOUT
Per-check timeout applied inside run_checks_parallel.
CORE_TOOLS
(command, version flag) pairs probed by the diagnostics.

Functions§

analyze_path
Splits and validates a raw PATH string.
build_snapshot
Builds a full EnvironmentState snapshot for a repository root.
check_editor
Checks that an editor is configured.
check_home
Checks that the user home directory is set and actually exists.
check_proxy
Reads the real proxy variables and reports their consistency.
collect_diagnostics
Runs every diagnostic and returns the full list.
dependency_audit
Checks that the project manifest exists and that dependencies are pinned by a lock file.
expand_windows_var
Expands a %VAR% reference inside a PATH entry (Windows style).
mentor_messages
Builds mentor guidance for all non-passing diagnostics, critical first.
path_checks
Checks that PATH is set and reports hygiene problems in separate diagnostics (broken entries, duplicates, current-directory entry).
path_separator
The separator the current platform uses to join PATH entries.
probe_tool
Runs tool --version and returns the first non-empty output line.
proxy_consistency
Classifies a pair of proxy variables into a status plus a message.
resolve_path_entry
Resolves a raw PATH entry into the filesystem path it refers to.
resolve_var
Looks up the first of two variable names (Windows name first).
run_checks_parallel
Runs a collection of blocking checks in parallel with a per-check timeout.
run_dev
Runs the full developer-environment inspection for limit dev.
run_full_diagnostics
Runs all checks in parallel and folds them into a full EnvironmentState.
stack_context_checks
Checks environment context that only matters for a given stack.
tools_on_path
One diagnostic per core tool: Pass when found, Fail when missing.