# Changelog

0.4.3: host enumeration addendum for DSH 0.2.1-rc.3 (declaration-only bump; contract plane zero diff).

## 0.4.2 (2026-10-18)

- hosts: 追加 0.2.1-rc.2 声明面枚举（34/34 @deepseek-ai/* 宿主 peer 逐包 npm 实测 rc.2 在版；本插件不触 ctx.web provider 与 conversation.input.model.label 槽，代码零改动，纯元数据发版；农场 rc.2 格挂账待命）

All notable changes to this project are documented in this file.
The format follows [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).

- [English README](./README.md)
- [中文 README](./README.zh.md)
- [日本語 README](./README.ja.md)
- [한국어 README](./README.ko.md)
- [Français README](./README.fr.md)
- [Deutsch README](./README.de.md)
- [Italiano README](./README.it.md)
- [Русский README](./README.ru.md)
- [Español README](./README.es.md)
- [Installation guide](./INSTALL.md)
- [中文安装指南](./INSTALL.zh.md)
- [日本語インストールガイド](./INSTALL.ja.md)
- [한국어 설치 안내](./INSTALL.ko.md)
- [Guide d'installation](./INSTALL.fr.md)
- [Installationsanleitung](./INSTALL.de.md)
- [Guida all'installazione](./INSTALL.it.md)
- [Руководство по установке](./INSTALL.ru.md)
- [Guía de instalación](./INSTALL.es.md)
- [Changelog](./CHANGELOG.md)
- [日本語 changelog](./CHANGELOG.ja.md)
- [한국어 changelog](./CHANGELOG.ko.md)
- [Français changelog](./CHANGELOG.fr.md)
- [Deutsch changelog](./CHANGELOG.de.md)
- [Italiano changelog](./CHANGELOG.it.md)
- [Русский changelog](./CHANGELOG.ru.md)
- [Español changelog](./CHANGELOG.es.md)

## 0.4.1 — 2026-10-17

### Changed

- **Host enum extended to the 0.2.1 line: `0.2.1-rc.1` added** (16 rc across 7 lines),
  propagated by `scripts/sync-hosts.mjs` to `peerDependencies` + `engines.dsh` +
  `dsh.plugin.json` + nine-language README blocks. No code change: the plugin's only
  host contract, `systemPrompt.context({ name, order, text })`, has no rc.1 breakage
  touchpoint.

### Added

- `scripts:hosts:check` (sync-hosts verify mode) wired into `prepack`, so `npm pack` /
  `npm publish` refuse to ship when any declaration site drifts from `scripts/hosts.mjs`.
- `publishConfig.registry` pinned to `https://registry.npmjs.org`.

## 0.4.0 — 2026-10-04

### Changed

- **Single artifact covers every DSH rc from 0.1.0 through 0.2.0 (15 rc).** The
  per-line artifact + dist-tag model is retired: one `dsh-date-wrapper@0.4.0` now
  declares `0.1.0-rc.2 … 0.2.0-rc.2` in `peerDependencies` (new optional peer
  `@deepseek-ai/dsh-system-prompt`, exact enum) and `engines.dsh`, distributed to
  package.json + `dsh.plugin.json` + nine-language READMEs by
  `scripts/sync-hosts.mjs` from the single source `scripts/hosts.mjs`.
- **Runtime-verified on all 15 rc** in a local isolation matrix (per-rc sandboxed
  host install + headless boot); `publishConfig.tag` is now `latest` (the
  `dsh-0.1.5` / `dsh-0.1.7` / `dsh-0.2.0` dist-tags also point at 0.4.0).
- **Docs:** all nine READMEs' compatibility claims are now script-managed
  (`<!-- host-compat:begin/end -->` blocks); the hand-written per-line tables are
  marked historical.

### Added

- `scripts/hosts.mjs`, `scripts/sync-hosts.mjs` (enum → three declaration sites +
  manifest version + nine-language README blocks), `scripts/test-host-compat.mjs`
  (local isolation matrix runner: pinned cordis line + host-CLI-authored profile +
  boot-shape negotiation).
- `tests/dayroll.test.mjs` — snapshot dedupe semantics (0 events same day,
  exactly 1 on day rollover); suite now 22 tests.

## Unreleased

### Changed

- **DSH dual-version support (0.1.0-rc.7 … 0.1.2-rc.1).** Documented the compatibility matrix in
  the README (EN/ZH) and added `engines.dsh`. No code change: the plugin's only host contract,
  `systemPrompt.context({ name, order, text })`, is signature- and semantics-identical between
  `dsh-v0.1.1-rc.2` and `dsh-v0.1.2-rc.1`, and the plugin registers no settings namespace, reads
  no session data and makes no RPC call.

## 0.3.0 — 2026-09-29

### Changed

- **DSH 0.2.0 line support (`>=0.2.0-rc.1 <0.2.1-0`).** `engines.dsh` updated in both
  `package.json` and `dsh.plugin.json`; version bumped to 0.3.0 in both manifests. No code
  change: between `dsh-v0.1.7-rc.2` and `dsh-v0.2.0-rc.1` the `packages/core/system-prompt`
  diff is a single version line, the `order: 116` slot stays collision-free (110/115/120
  unchanged), and the plugin migration guide has no `systemPrompt` entry. The 0.1.x line
  (0.1.0-rc.7 → 0.1.7.x) remains served by artifact ≤ 0.2.0 (dist-tag `dsh-0.1.7`).

### Fixed

- Reconciled the npm-published 0.2.0 version bump into git history (it was previously
  published from an uncommitted working tree).

## 0.1.0 — 2026-09-08

First release.

### Added

- Host-half plugin that registers the current date as a dynamic runtime context (`systemPrompt.context`), rendered as `Current date: 2026-09-08 Asia/Shanghai Tuesday` — 46 characters, roughly 12 tokens, no time of day.
- `cordis.patch.yml` bundle patch with a single `insert` row (`id: date-wrapper`, `config.timeZone: Asia/Shanghai`).
- `timeZone` configuration validated at startup: an invalid or unresolvable IANA zone throws instead of silently falling back to UTC.
- Fail-soft text provider: a render failure returns an empty string, so prompt assembly never throws on the plugin's behalf.
- 18 assertions via `node --test`: zone projection, weekday correctness across zone boundaries, exact format and length, degradation, config validation, and the registration contract against a fake context.
- ESLint 10 flat config; `npm run verify` gates lint + tests.
- Zero runtime dependencies and zero `@deepseek-ai/*` imports.

### Documentation

- `README.{md,zh,ja,ko}`, `INSTALL.{md,zh,ja,ko}`, `CHANGELOG.{md,ja,ko}` with cross-linked language switches.
- Version-compatibility matrix covering 0.1.0-rc.7 → 0.1.3-alpha.2.
- `docs/dsh-session-and-context-mechanics.md` — how DSH turns sessions into JSONL and assembles requests (Chinese).
- `HANDOVER.md` — project handover and design rationale (Chinese).

### Notes

- Functional overlap with `@deepseek-ai/dsh-time-context`: do not mount both.
- No settings panel by design — activating or deactivating the plugin row is the switch.
- Inactive under fixed-prompt presets whose persona sets `includeRuntimeContext: false`.