docs: sync README and CHANGELOG for v0.3.0

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: GoldVelen

CHANGELOG.md

@@ -1,34 +1,47 @@
 # Changelog
 
-## Unreleased
+## v0.3.0
 
-### Bug Fixes
+### Features
 
-- enforce strict plan-to-implementation pipeline discipline (2026-05-24)
-- empty PID file falsely detected as running (2026-05-24)
+- auto fallback with degraded backend tracking
+- TUI dashboard (real-time health, stats, logs)
+- Web management UI at /web
+- stats/health monitoring (cmr stats, cmr health)
+- pipeline progress output, per-stage timeout, and Ctrl+C checkpoint/resume
+- multi-input pipeline modes (interactive, --file, --stdin, args)
+- setup guard prompts for setup if config missing
 
-### Features
+### Bug Fixes
 
-- improve CLI daemon, add setup and pipeline commands (2026-05-24)
-- add pipeline engine for auto model dispatch (2026-05-24)
-- multi-backend routing with modelPattern, enhanced logging (2026-05-24)
-- add config validation and hot reload (2026-05-24)
+- correct public/index.html path resolution in web route
+- dashboard non-TTY guard
+- pipeline SIGINT now aborts mid-stage via AbortSignal
 
 ### Documentation
 
-- update README and package.json for v0.2.0 (2026-05-24)
-- bilingual README (EN/CN) (2026-05-24)
+- README v0.3.0 features section
+- architecture diagram in README
+- bilingual updates (EN/CN)
 
-### Tests
+## v0.2.0
 
-- add validator, watcher, and integration tests (2026-05-24)
+### Features
 
-## v0.1.0
+- pipeline engine for auto model dispatch
+- multi-backend routing with modelPattern
+- config validation and hot reload
+- CLI daemon, setup and pipeline commands
 
-### Features
+### Bug Fixes
+
+- empty PID file falsely detected as running
+- strict plan-to-implementation pipeline discipline
 
-- initial release (2026-05-24)
+### Documentation
+
+- bilingual README (EN/CN)
 
-### Chores
+## v0.1.0
 
-- init project skeleton (2026-05-24)
+- initial release

README.md

@@ -46,6 +46,8 @@ cmr status     # Verify it's running
 
 If no config exists, `cmr start` and other commands will prompt you to run `cmr setup` first.
 
+After starting, visit `http://127.0.0.1:3457/web` for the web management UI.
+
 ## Install / 安装
 
 ```bash
@@ -177,7 +179,7 @@ cmr stats  # Check failure counts and degraded status
 
 ### Real-time Dashboard / 实时面板
 
-**`cmr dashboard`** provides a live terminal dashboard with backend health, request stats, and recent logs — all updating every second. Press `q` to quit.
+**`cmr dashboard`** provides a live terminal dashboard with backend health, request stats, and recent logs — all updating every second. Press `q` to quit. Requires an interactive terminal at least 80 columns wide.
 
 ### Web Management UI
 
@@ -187,6 +189,8 @@ Visit `http://127.0.0.1:3457/web` for a browser-based management interface:
 - Run pipeline tasks
 - Watch live logs
 
+> **Security note**: Web UI binds to localhost only. Do not expose port 3457 to public networks.
+
 ### Pipeline Enhancements
 
 - **Multi-input modes**: `cmr run` (interactive), `cmr run <task>`, `cmr run --file task.txt`, `echo "task" | cmr run --stdin`
@@ -222,19 +226,51 @@ Edit the `aliases` section in your config / 编辑配置中的 `aliases` 字段
 
 ## Upgrade from v0.1.x / 从 v0.1.x 升级
 
-cmr v0.2.0 is fully backward-compatible with your existing `config.json`. On first load:
+cmr v0.3.0 is fully backward-compatible with v0.1.x and v0.2.x configs. On first load:
 
 1. The old `backends` format (with `url` + `apiKey` only) is auto-migrated to the new format with default `path`, `modelPattern`, and `sanitizer` values
 2. Environment variables `CMR_DEEPSEEK_KEY` and `CMR_CLAUDE_KEY` still work
 3. Logging now displays backend URL hostnames instead of hardcoded service names
 4. The hot reload watcher is automatically active — no configuration needed
 
+## Architecture / 架构
+
+```
+src/
+├── server.ts             HTTP server with retry loop & fallback
+├── router.ts             Backend selection (modelPattern + degraded filter)
+├── pipeline.ts           Multi-stage model orchestration
+├── config.ts             Config load + hot reload + env override
+├── watcher.ts            fs.watch on config.json
+├── validator.ts          Config schema validation
+├── sanitize.ts           DeepSeek request sanitizer
+├── stats/                Per-backend metrics (immutable store)
+│   ├── stats-store.ts    State + recordRequest/recordFailure/isDegraded
+│   ├── stats-middleware.ts res.writeHead/end interception
+│   └── stats-types.ts
+├── server/routes/        HTTP endpoints
+│   ├── stats.ts          GET /stats
+│   ├── logs.ts           GET /logs
+│   ├── web.ts            GET /web (serves public/index.html)
+│   ├── api-config.ts     GET/POST /api/config
+│   ├── api-run.ts        POST /api/run, GET /api/run/:id
+│   └── api-logs.ts       GET /api/logs
+├── commands/             CLI commands (used by bin/cmr.js)
+│   ├── stats.ts
+│   └── health.ts
+└── utils/
+    ├── http-client.ts    Backend reachability check
+    └── changelog-generator.ts
+```
+
+Zero runtime dependencies — only Node.js built-ins.
+
 ## Tech / 技术栈
 
 - **Runtime**: Node.js ≥ 18 (ESM)
 - **Language**: TypeScript (strict mode)
 - **Dependencies**: 0 runtime dependencies
-- **Test**: Node.js built-in test runner, 75 tests across 23 suites
+- **Test**: Node.js built-in test runner, 88 tests across 27 suites
 - **Dist**: npm package with `cmr` CLI
 
 ## License / 许可