# Changelog

All notable changes to this project are documented here.

The format follows Keep a Changelog, and the project uses Semantic Versioning.

## Unreleased

### Added

- Complete product and architecture documentation under `docs/`.
- Validated interactive architecture diagram with repository source evidence.
- Agent onboarding instructions in `AGENTS.md`.
- Tool contract, extension guide, test/release guide, operations runbook, roadmap, and architecture decision records.

## [0.4.0] - 2026-08-26

### Added

- R2 工具（`pane_run` / `agent_start` / `agent_prompt`）新增 `preview` 参数：只返回结构化预览，不执行。
- 新增 `DSH_HERDR_PREVIEW_REQUIRED` 环境变量：设置后 R2 工具必须先 `preview=true`，否则返回 `preview_required`。
- `workspace create` / `tab create` / `pane split` 支持 `env` 数组，映射为重复 `--env KEY=VALUE`。
- CI 新增 `full-build` job：固定 DeepSeek Harness checkout 版本，执行 DSH host 构建、插件 typecheck/build/全量测试和 package 检查。

## [0.3.0] - 2026-08-26

### Added

- 新增 `_dsh_herdr_doctor`：只读健康检查，汇总 herdr 版本、status、session、workspace、agent 状态（server 未运行也能返回可诊断结果）。
- 新增 `_dsh_herdr_agent_explain`：返回 agent 检测状态 JSON，便于排查未识别/误识别问题。
- 工具总数增至 24。
- 新增 GitHub Actions CI：package 元数据校验、核心单元测试和 npm pack 内容检查。
- 失败结果新增顶层 `errorCode` 字段（如 `server_not_running`），可直接判断错误类型。

## [0.2.0] - 2026-08-26

### Added

- 新增 `_dsh_herdr_pane_layout`、`_dsh_herdr_pane_process_info`、`_dsh_herdr_pane_edges` 三个显式目标的只读 pane 诊断工具（共 22 个工具）。
- 新增 Node 测试套件：argv 映射、运行时归一化、插件注册与唯一性检查。
- 新增 `npm test` 脚本。

### Changed

- CLI 映射集中到 `src/argv.ts`，`runHerdr` 抽取到 `src/runtime.ts`，便于测试与维护。
- JSON 成功输出只返回 `data`，不再重复返回原始 `stdout`；纯文本读取仍保留 `stdout`。

### Fixed

- 失败时解析 Herdr stderr 中的 JSON（例如 `server_not_running`），结构化错误码进入 `data`。
- 支持 `DSH_HERDR_CLI_TIMEOUT_MS` 作为子进程硬超时兜底。
- pane/agent 读取不再 `trim()` 原始输出，保留文本格式。

## 0.1.0 - 2026-08-26

### Added

- Workspace list, get, and create tools.
- Tab list, get, and create tools.
- Pane list, get, read, split, run, wait-output, and send-text tools.
- Agent list, get, read, start, wait, and prompt tools.
- Explicit-target and `--no-focus` safety defaults.

### Changed

- Expanded README with management workflows and safety boundaries.

## 0.0.2 - 2026-08-26

### Fixed

- Removed unnecessary host peer requirements.
- Marked DSH tools as an optional host-provided peer.

## 0.0.1 - 2026-08-26

### Added

- Initial DSH toolkit plugin for Herdr workspace, pane, and agent access.
- GitHub installation support and DSH bundle patch.