v0.4.2

Fixed

• --dry-run 在 5 个写命令上完全失效：start / stop / restart / restart-clean / recover 不识别 --dry-run 而真执行。补 _plan_*
  helper + dispatcher 接 _maybe_dry_run + COMMANDS_META.supports_dry_run: true + shell 补全 _DRY_RUN_CMDS 同步：
  • _plan_start — launchctl bootstrap / systemctl --user start +
    DNS 注入 + dns-lock + 系统代理激活
  • _plan_stop — dns-lock 停 + DNS 还原 + 系统代理关 +
    launchctl bootout / systemctl --user stop
  • _plan_restart / _plan_restart_clean（多一步 fs_remove cache_file）
  • _plan_recover — 3 个 Clash API endpoint（http_put action）
• 新 helper _service_start_argvs / _service_stop_argvs /
  _service_restart_argvs / _recover_curl_endpoints 作为 plan ↔ exec
  单一事实来源。

Added

• proxyctl version 子命令作为 --version flag 的等价别名。
  proxyctl version --json envelope cmd: "version" /
  data.version + supported_features。
• supported_features.lifecycle_dry_run: true /
  supported_features.version_subcommand: true。
• CI contract test 扩展：lifecycle 5 个命令 plan ⇔ exec 一致性 + 跨平台
  （macOS / Linux）+ 静态等价断言 + restart-clean 多 fs_remove 断言。
• VERSION 三源一致性 guard（pyproject.toml vs proxyctl.__version__
  vs cli.VERSION vs envelope.meta.proxyctl_version vs
  cmd_version_print --json data.version）。
• --json 错误路径不泄漏 traceback 的 5 个 USAGE 系列测试。
• agent-guide --list-sections 输出的每一个 slug 都 parametrize
  断言能取回非空 markdown。

Compatibility

• 零 schema 变更；0.4.1 公开 CLI 完全兼容