# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.3.0] - 2026-11-04

npm distribution release.

### Added

- **npm distribution**: the plugin is now published as `@baipengyan0101/dsh-harnessmm`; install it from the DSH
  Plugins page ("添加插件 / Add plugin" → package name) or with
  `dsh plugin --profile desktop add @baipengyan0101/dsh-harnessmm`.
- `prepack` rebuilds the host/client artifacts automatically, so the published tarball always contains a
  fresh `index.js` / `client.js`.
- npm and GitHub install sections (npm recommended) in both READMEs; npm package page linked from the
  project metadata; `license: Apache-2.0`, keywords and `publishConfig.access: public`.
- `scripts/install.mjs` now derives the package name from `package.json`, computes the profile symlink
  path from the npm scope, and migrates profiles that still reference the old `@local/dsh-harnessmm`
  dependency / bundle entry / symlink.

### Changed

- **Package name**: `@local/dsh-harnessmm` → `@baipengyan0101/dsh-harnessmm`. The client tab id / pane key follow the package
  name (`@baipengyan0101/dsh-harnessmm/panel`). Existing local installs must re-run `node scripts/install.mjs`
  (or reinstall from npm) so the profile points at the new package name.
- Client contract checks derive the expected package id from `package.json` instead of hard-coding it.

### Docs

- README (zh/en): npm install section first, GitHub install kept as a subsection, profile migration note,
  0.3.0 changelog summary.
- `docs/view-model.md` and `docs/verification.md`: updated plugin id / tab id / symlink path; npm publish
  and install verification evidence.

## [0.2.1] - 2026-11-04


First public release.

### Added

- **Native host engine** (`index.js`): EDG authoring instructions in the system prompt, `llm/stream`
  wrapping, Guarded Decision Reuse (GDR) on native tool receipts, Certified Callback Substitution (CCS)
  dispatch through the native tool interface, signed `<HARNESSMM_RECEIPT>` markers on foreground bash/pwsh
  results, and a read-only `harnessmm_status` tool.
- **Session-view panel** (`client.js`): 「决策复用」 read-only panel available as a conversation-view tab
  (slot `conversation.view`, order 20, right after the built-in Trajectory tab) and as a right-sidebar tab;
  layered EDG rendering, decision timeline, guard badges, certificates, plan inspector, measured-token strip.
- **Projection** (`harnessmm`, wire v1): folds committed session-log events only — EDG banks parsed from
  `<CHISEL_PLAN>`, substitution calls matched by `chisel_<sha24>_<label>`, guards recomputed from receipts.
- **Install tooling**: `scripts/install.mjs` (idempotent Route-B profile installer with `--dry-run` /
  `--uninstall`) and `scripts/build.mjs` (`--host` / `--client` / `--preview`).
- **Fixture-driven preview** and 4 check suites: host 21, engine 23, client 114, integration.
- **Docs**: `docs/view-model.md` (host↔client wire contract), `docs/verification.md` (test matrix + live
  evidence), `README.md` (Chinese) and `README.en.md` (English), Apache-2.0 `LICENSE` + `NOTICE`.

### Changed

- Collapsed engine hand-off now uses a trimmed message projection (≤600 chars per user text, last 32 user
  turns, DSH provenance dropped) so the upstream v6 65 536-byte public-state cap is respected on long
  sessions.
- `harnessmm_status` and panel counters are observability-only; no counterfactual "tokens saved" metric.

### Removed

- Composer pill 「决策」 (`conversation.input.right` slot) — the panel is reachable from the conversation-view
  tab row and the right sidebar.

### Fixed

- DSH usage chunks carry `{inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens}` without
  `totalTokens`; the adapter now normalizes them so deterministic admission can compute net savings.
- Authored bank candidates must satisfy their native tool JSON schema; the EDG instruction now states that
  DSH bash requires both `description` and `command`.
- Main-view panel sizing: the conversation-view panel fills the scroll-body viewport (fixed header, internal
  scrolling) using the `data-conversation-composer-overlay` contract, instead of growing to document height.
- Projection goal selection only accepts real human `user/message` turns; injected runtime-context /
  time-context / approval / mnemon reminders are skipped.
- Guard verdicts are evaluated against the predecessor receipt at substitution dispatch (authoring
  semantics), not against the node's own output.
- Client placeholders (`{n}`, `{step}`, `{pct}`) are interpolated; policy chips, timeline rows and zoom labels
  render correctly.

### Docs

- Plugin metadata (`locale/{zh,en}.json`), `package.json` repository/homepage/engines fields, and a
  GitHub-first one-click install section in both READMEs.

## [0.2.0] - 2026-11-04

Initial development version (pre-public release): host-side EDG/GDR/CCS engine ported from the HarnessMM
reference and the community `@local/dsh-harnessmm` adapter, right-sidebar observability panel, install script,
tests and design documents.

[0.3.0]: https://github.com/baipengyan/dsh-harnessmm/releases/tag/v0.3.0
[0.2.1]: https://github.com/baipengyan/dsh-harnessmm/releases/tag/v0.2.1
[0.2.0]: https://github.com/baipengyan/dsh-harnessmm/commit/41d4d27