You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Add the minimal command-line and structured-diagnostics bootstrap needed by the
native executable, without introducing product commands or TUI behavior.
Introduce clap at the executable / composition boundary; provide a minimal
root CLI with functional --help and --version behavior.
Introduce tracing and tracing-subscriber. Add another logging helper crate
only if concrete implementation evidence requires it, and explain that
dependency in the issue result.
Initialize normal application logging at the composition boundary.
Route ordinary interactive/application diagnostics to the documented
application state/log location (obtained from the hum-platform resolver from Add platform application path resolution #2), not to a future full-screen TUI surface.
Preserve stdout/stderr for appropriate CLI / pre-TUI behavior.
Make initialization return meaningful errors rather than panic.
Ensure informational CLI operations (--help, --version) do not create
persistent hum directories merely to print output.
Use application paths supplied by the platform resolver rather than
recomputing them.
Do not create user-facing subcommands for future functionality.
Objective
Add the minimal command-line and structured-diagnostics bootstrap needed by the
native executable, without introducing product commands or TUI behavior.
Relevant specification
tracinglogging direction,
thiserror/anyhowsplitnot over a full-screen TUI;
--help/--versioncreate no persistent statestdout/stderrallowed for pre-TUI / non-interactive commandstracing, noprintln!loggingarchitecture, no telemetry
network
Dependencies
In scope
clapat the executable / composition boundary; provide a minimalroot CLI with functional
--helpand--versionbehavior.tracingandtracing-subscriber. Add another logging helper crateonly if concrete implementation evidence requires it, and explain that
dependency in the issue result.
application state/log location (obtained from the
hum-platformresolver fromAdd platform application path resolution #2), not to a future full-screen TUI surface.
stdout/stderrfor appropriate CLI / pre-TUI behavior.--help,--version) do not createpersistent
humdirectories merely to print output.recomputing them.
Do not create user-facing subcommands for future functionality.
Out of scope
Implementation constraints
tracing; there is no ordinaryprintln!-based applicationlogging architecture.
anyhowwhere appropriate; librarycrates are not converted wholesale to
anyhow.--help/--version.Acceptance criteria
hum --helpworks.hum --versionworks.hum-owned directories.fmt, Clippy, tests) passes.The exact visible help text beyond normal
clap-generated behavior is notfrozen unless tests require stable product semantics.
Testing and validation
--help/--versiontests where meaningful.create persistent application directories.
cargo fmt --all -- --check, Clippy,cargo test --workspace.Do not assert full log message text when only initialization behavior matters.
Expected commit
chore: bootstrap cli and logging