@michengai/dsh-archive-manager 0.1.35 → 0.1.37

package/CHANGELOG.md

@@ -4,6 +4,16 @@
 
 Published release notes are retained below; new versions are added without removing earlier entries.
 
+## 0.1.37 - 2026-09-10
+
+- Fix rebuilt archive summaries remaining unusable on DSH `0.1.5-rc.1`; caches with missing or outdated format versions are rebuilt from the session transcript and reused on subsequent visits.
+
+## 0.1.36 - 2026-09-10
+
+- Harden release delivery: align dependency cooling preflight and synchronize bilingual GitHub Releases only after confirming the exact npm version and commit; recover already-published releases without reinstalling or republishing.
+- Wait for npm latest propagation to avoid incorrectly marking new releases as non-Latest; fix negative timeout values and deadline diagnostics while preserving abort causes and ordinary network errors.
+- Add release recovery, CLI, bilingual notes, and deadline regressions; plugin runtime behavior and the four-version compatibility range remain unchanged.
+
 ## 0.1.35 - 2026-09-10
 
 - Support DSH `0.1.5-rc.1`: restore workspace selection, session opening, and fork navigation; dismiss global panels when opening or creating sessions, and suppress stale navigation and draft handoff after panel switches or disposal.

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,16 @@
 
 以下发布说明会持续保留；新增版本时不再删除较早记录。
 
+## 0.1.37 - 2026-09-10
+
+- 修复 DSH `0.1.5-rc.1` 中归档摘要重建后缓存仍不可用的问题；缺失版本或旧代际缓存会从会话原文重建，后续访问复用有效缓存。
+
+## 0.1.36 - 2026-09-10
+
+- 加固发布流程：统一依赖冷却预检，在 npm 精确版本与提交确认后再同步双语 GitHub Release；已发布版本可直接恢复 Release，无需重复安装或发布。
+- 等待 npm latest 传播，避免新版本误标为非 Latest；修复等待截止点的负超时参数和错误提示，保留原始中止原因及普通网络错误。
+- 补充发布恢复、CLI、双语说明与截止边界回归；插件运行实现及四版本兼容范围保持不变。
+
 ## 0.1.35 - 2026-09-10
 
 - 适配 DSH `0.1.5-rc.1`：补齐工作区选择、打开会话与分叉导航，在新建或打开会话时退出全局面板；切换面板或卸载后不再执行迟到的导航及草稿交接。

package/README.md

@@ -55,7 +55,7 @@ For a ready-to-use workbench, download [DSH Codex Desktop](https://github.com/Mi
 
 ## Prerequisites
 
-- The current source supports DeepSeek Harness `0.1.5-rc.1` and the legacy hosts below. These changes have not yet been published to npm. Later versions require separate validation.
+- The current source supports DeepSeek Harness `0.1.5-rc.1` and the legacy hosts below. These changes were published in plugin `0.1.35`. Later versions require separate validation.
 
 - A working DeepSeek Harness Web installation with `dsh` available in PowerShell.
 - Examples use the `web` profile; replace it with the target profile.
@@ -76,10 +76,10 @@ Do not run `test/fixtures/*.mjs` directly. Fixtures validate the isolated entry
 
 | DSH | Cordis | Automated regression |
 | --- | --- | --- |
-| `0.1.0-rc.8` | `4.0.1` | 141 passed |
-| `0.1.1-rc.2` | `4.0.1` | 141 passed, plus legacy cache migration validation |
-| `0.1.2-rc.1` | `4.0.2` | 141 passed |
-| `0.1.5-rc.1` | `4.0.2` | 144 passed |
+| `0.1.0-rc.8` | `4.0.1` | 153 passed |
+| `0.1.1-rc.2` | `4.0.1` | 153 passed, plus legacy cache migration validation |
+| `0.1.2-rc.1` | `4.0.2` | 153 passed |
+| `0.1.5-rc.1` | `4.0.2` | 156 passed |
 
 Coverage includes workspace navigation, global-panel dismissal, cancellation of stale navigation, sidebar wiring, peer version acceptance, client Remote integration, archive/restore, real JSONL/Zstandard deletion and subagent cascades, and queries/reopened storage after deletion. Tested on Windows / Node.js 24. A real browser acceptance run also passed in an isolated DSH 0.1.5-rc.1 Web Profile: package installation, archive/restore, deletion cancellation and confirmation, subagent cascades, cross-filter batch deletion, workspace selection, returning from global panels, new sessions and forks, content search, and restart persistence. Content search requires an open host query database; it passed after changing the isolated Profile from `openAt: never` to `startup`. The other three versions have isolated automated coverage only; no external model calls were made. The latest storage fixture isolates only the upstream POSIX `fs-ext` import that cannot load on Windows; file operations and native Windows locking still use the official implementation.
 
@@ -186,3 +186,11 @@ pnpm verify
 ## License
 
 Licensed under [Apache License 2.0](LICENSE).
+
+Before creating or pushing a release tag, run `pnpm release:preflight` in PowerShell 7 (`pwsh`). It installs from the official npm registry with a frozen lockfile and the same 1440-minute release-age policy as CI, then runs the full `verify` suite. Recent dependencies require committed, exact-version exclusions; manual retries never add exclusions dynamically.
+
+Tag releases and manual retries verify the exact npm version and `gitHead` before creating or updating the bilingual GitHub Release. Network, authorization, or metadata errors stop the flow. Retrying an older tag does not take GitHub Latest away from the npm latest version. These release controls do not change the four supported host versions.
+
+Recovery checks the npm package name, version, and tag commit first. An exact match skips dependency installation, full builds, and republishing, and only synchronizes the Release. Unpublished old tags must still satisfy their original cooling policy. Exact-version and latest propagation each have a two-minute deadline; a lagging latest tag does not create a non-Latest Release prematurely.
+
+Updating main does not retrigger an existing tag. After pushing workflow changes, manually run `publish.yml` on main with the original tag (for example, `v0.1.35`); do not move or recreate the tag.

package/README.zh-CN.md

@@ -4,7 +4,7 @@
 
 <div align="center">
 
-  # DSH Archive Manager
+# DSH Archive Manager
 
   **在 DeepSeek Harness 中安全管理已归档会话**
 
@@ -55,7 +55,7 @@
 
 ## 前置条件
 
-- 当前源码已适配 DeepSeek Harness `0.1.5-rc.1`，并保留下表中的旧版兼容路径；本次改动尚未发布到 npm。后续版本需另行验证。
+- 当前源码已适配 DeepSeek Harness `0.1.5-rc.1`，并保留下表中的旧版兼容路径；已随插件 `0.1.35` 发布到 npm。后续版本需另行验证。
 
 - 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 `dsh`。
 - 以下示例使用 `web` profile；请替换为实际目标 profile。
@@ -76,10 +76,10 @@ DSH peer 依赖仅接受 `0.1.0-rc.8 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1`
 
 | DSH | Cordis | 自动回归 |
 | --- | --- | --- |
-| `0.1.0-rc.8` | `4.0.1` | 141 项通过 |
-| `0.1.1-rc.2` | `4.0.1` | 141 项通过，另含旧缓存迁移验证 |
-| `0.1.2-rc.1` | `4.0.2` | 141 项通过 |
-| `0.1.5-rc.1` | `4.0.2` | 144 项通过 |
+| `0.1.0-rc.8` | `4.0.1` | 153 项通过 |
+| `0.1.1-rc.2` | `4.0.1` | 153 项通过，另含旧缓存迁移验证 |
+| `0.1.2-rc.1` | `4.0.2` | 153 项通过 |
+| `0.1.5-rc.1` | `4.0.2` | 156 项通过 |
 
 覆盖新版工作区导航、全局面板退出、异步导航取消、侧栏接线、peer 版本接纳、客户端 Remote、归档/恢复、真实 JSONL/Zstandard 删除与子会话级联、删除后重新查询及重新打开存储。验证环境为 Windows / Node.js 24。另已在隔离 DSH 0.1.5-rc.1 Web Profile 中完成真实浏览器验收：包安装、归档恢复、取消与确认删除、子会话级联、跨筛选批量删除、工作区选择、全局面板返回会话、新建与分叉、正文搜索和重启持久性均通过。正文搜索需开启宿主查询数据库；本次将隔离 Profile 的 `openAt: never` 改为 `startup` 后验证通过。其余三个版本仅完成隔离自动测试，未逐版执行浏览器验收；未调用外部模型。新版存储夹具仅隔离上游无法在 Windows 加载的 POSIX `fs-ext` 导入，实际文件操作与 Windows 原生锁仍使用官方实现。
 
@@ -186,3 +186,11 @@ pnpm verify
 ## 许可证
 
 本项目采用 [Apache License 2.0](LICENSE)。
+
+发布前在 PowerShell 7 (`pwsh`) 执行 `pnpm release:preflight`，通过后再创建、推送版本标签。该入口使用官方 npm registry、冻结锁文件及与 CI 一致的 1440 分钟依赖冷却策略，然后运行完整 `verify`。刚发布的依赖仅通过已提交的精确版本豁免接纳；手动重试不会动态修改豁免配置。
+
+标签发布与手动重试统一经过 npm 精确版本和 `gitHead` 校验，确认 npm 可查询后才创建或更新双语 GitHub Release。网络、权限或元数据异常会停止流程；旧标签重试不会抢占 npm 最新版本对应的 GitHub Latest。仅新增了发布控制，不改变四个宿主版本的兼容范围。
+
+恢复已发布版本时，流程先校验 npm 包名、版本和标签提交：一致则跳过依赖安装、完整构建和再次发布，仅补同步 Release；未发布的旧标签仍需满足原标签的冷却策略，不能通过重试绕过。精确版本及 latest 传播分别最多等待两分钟，latest 落后时不提前创建非 Latest Release。
+
+已推送的旧标签不会因 main 更新而重新触发。推送工作流更新后，可手动运行 `publish.yml`，选择 main 并填写原标签（例如 `v0.1.35`）；无需移动或重新创建标签。

package/lib/workspace.js

@@ -318,6 +318,8 @@ var ArchiveWorkspaceRegistry = class extends WorkspaceRegistry {
       const restored = projections.restore({}, stored.events, 0, meta, inheritedEventCount);
       if (restored === void 0 || typeof restored !== "object" || restored.checkpoint === void 0) return false;
       await cache.put(header.id, {
+        // 支持的宿主头部均有 version；新版缓存校验格式代际，旧版逐字段比较忽略此键。
+        formatVersion: meta.version,
         createdAt: meta.createdAt,
         ...meta.cwd === void 0 ? {} : { cwd: meta.cwd },
         isSeeded: meta.isSeeded ?? false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-archive-manager",
-  "version": "0.1.35",
+  "version": "0.1.37",
   "description": "NPM-installable DSH Web plugin for managing archived sessions.",
   "type": "module",
   "packageManager": "pnpm@11.22.0",
@@ -33,6 +33,7 @@
     "test:compat": "node scripts/test-legacy-compatibility.mjs && pnpm test:matrix",
     "pack:check": "pnpm pack --dry-run",
     "verify": "pnpm test && pnpm test:compat && pnpm pack:check && node scripts/check-generated.mjs",
+    "release:preflight": "pwsh -NoProfile -File scripts/release-preflight.ps1",
     "prepublishOnly": "pnpm verify"
   },
   "peerDependencies": {