feat: add runtime diagnostics and path management

README.md

@@ -2,22 +2,46 @@
 
 CoinHunter CLI is the executable tooling layer for CoinHunter.
 
-- Code lives in this repository.
-- User runtime data lives in `~/.coinhunter/`.
-- Hermes skills can call this CLI instead of embedding large script collections.
+• Code lives in this repository.
+• User runtime data lives in ~/.coinhunter/ by default.
+• Hermes skills can call this CLI instead of embedding large script collections.
+• Runtime locations can be overridden with COINHUNTER_HOME, HERMES_HOME, COINHUNTER_ENV_FILE, and HERMES_BIN.
 
-## Install (editable)
+## Install
+
+Editable install:
 
 ```bash
 pip install -e .
 ```
 
-## Example commands
+## Core commands
 
 ```bash
+coinhunter --version
+coinhunter doctor
+coinhunter paths
+coinhunter init
 coinhunter check-api
 coinhunter smart-executor balances
 coinhunter precheck
 coinhunter review-context 12
 coinhunter market-probe bybit-ticker BTCUSDT
 ```
+
+## Runtime model
+
+Default layout:
+
+• ~/.coinhunter/ stores config, positions, logs, reviews, and state.
+• ~/.hermes/.env stores exchange credentials unless COINHUNTER_ENV_FILE overrides it.
+• hermes is discovered from PATH first, then ~/.local/bin/hermes, unless HERMES_BIN overrides it.
+
+## Next refactor direction
+
+This repository now has a dedicated runtime layer and CLI diagnostics. The next major cleanup is to split command adapters from trading services so the internal architecture becomes:
+
+• commands/
+• services/
+• runtime/
+• domain logic