# v0.1.9 — DSH 0.2.1-rc.2 adaptation

[简体中文](./v0.1.9.zh-CN.md)

Version `0.1.9` upgrades DeepSeek Harness from `0.2.0-rc.2` to `0.2.1-rc.2` at
`687f282e8625c6b8d11ff58211a90524be2e4317`. External runtimes require
`>=0.2.1-rc.2 <0.2.2` and an isolated behavioral probe. Node remains
`^22.19.0 || >=24.2.0`.

## Changes

- Accepts `native` and `ptc` tool modes. `code` remains a PTC alias; `both`
  now fails before runtime discovery, probes, or DSH Home changes.
- Removes runtime invariant companions and the standalone in-process subagent
  driver. Subagents follow managed activations and parent completion notices;
  Started receipts remain distinct from final answers.
- Removes the unsupported `{{cwd}}` prompt variable. File mentions follow the
  persisted current directory while Session project identity remains unchanged.
- Keeps DSH-owned model selection, credentials, resolved settings, live replies,
  V4 replay, attachments, approvals, and questions. Saved API keys now precede
  environment fallbacks in this interactive profile.
- Uses the official MCP owner package with client `2.2.0`, replacing its old
  repack. Retains the LibreOffice repack because upstream still pins fflate
  `0.8.2`; the repack selects `0.8.3`.
- Synchronizes 2,083 official documentation files from the exact target commit.
  The mirror remains outside the npm package.

## Install

```bash
npx --yes --legacy-peer-deps dsh-claude-tui@0.1.9
```

For a persistent command:

```bash
npm install --global --legacy-peer-deps dsh-claude-tui@0.1.9
dshtui
```

From this checkout:

```bash
corepack pnpm install --frozen-lockfile
corepack pnpm build
DSH_HOME=/tmp/dsh-claude-tui-0.2.1-rc.2 DSH_CLAUDE_TUI_RUNTIME=bundled node lib/cli.js
```

Use a separate Home for cross-version testing. Session format remains V4, but
that does not establish downgrade compatibility for new event or plugin records.
Supported predecessor migrations preserve the original files.

## Verification status

Before PR review, on macOS arm64 / Node `24.16.0`, `CI=true corepack pnpm check` exited 0:
**16 files, 215 passed, 1 skipped**. Documentation integrity (2,083 original
files), typecheck, build, full installed dependency tree, fresh-cache
`--legacy-peer-deps` installation, native subagent messaging and successful
settlement, PTC turns, shutdown/resume, V0/V3 migration, external runtime,
terminal regressions, and MCP checks passed. Workspace and production audits
reported 0; the production graph has 644 dependencies, including 299 DSH
packages at the exact target. The retained Office repack reproduced byte for byte.

The later Node `22.23.3` fresh-cache ordinary npm peer-resolution installed-bundle
gate also exited 0: **1 file, 16 passed, 1 optional clipboard test skipped**
(17 total), in **331.66 seconds**. It covered native subagents, PTC, MCP, probes,
and the newly added packed replay of a released `0.2.0-rc.2` V4 fixture, including
its restored tool result and unchanged original-byte prefix. That added case is
not counted in the earlier Node 24 total. See the
[verification table](../harness-0.2.1-rc.2-adaptation.md#verification--验证).
Older-release results remain historical.

[PR #24](https://github.com/cogine-ai/dsh-claude-tui/pull/24) review found a
subagent roster-label ordering issue. Retaining child identity and reading the
latest catalog during rendering fixes it; 64 focused application tests and
typecheck passed afterward. The counts above remain pre-review baseline
evidence. Current review and [CI results](https://github.com/cogine-ai/dsh-claude-tui/pull/24/checks)
are recorded on the PR.

Installed-artifact fixtures use local model and MCP servers. These local results
do not establish production-provider or Windows ConPTY acceptance.
The opt-in real system-clipboard test was skipped. Publication and registry
identity are verified separately through the
[v0.1.9 Release](https://github.com/cogine-ai/dsh-claude-tui/releases/tag/v0.1.9)
and npm metadata.

See the [adaptation record](../harness-0.2.1-rc.2-adaptation.md) and
[launcher rules](../launcher-environment-compatibility.md).