Skip to content

Commit 7f1b05f

Browse files
committed
docs(release): prepare beta1 restart replacement
Summary: Document the Windows second-launch root fix, bounded SQLite cleanup, same-version manual reinstall requirement, and release-gate behavior across the changelog, localized README surfaces, website changelog, and beta release record. Refs: - Change: spec/changes/active/windows-canonical-authority-second-launch - Change: spec/changes/active/database-resource-lifecycle-hardening - Release: spec/releases/0.6.0-beta.1.md Verification: - pnpm --dir website sync:release: passed; stable metadata remains v0.5.9 - affected-file Prettier check: passed (generated spec index excluded) - pnpm spec:test: passed - git diff --check: passed - publication and final remote asset checks: pending candidate and tag workflows
1 parent b4af6eb commit 7f1b05f

11 files changed

Lines changed: 74 additions & 34 deletions

File tree

CHANGELOG.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
## [Unreleased]
22

3-
## [0.6.0-beta.1] - 2026-08-19
3+
## [0.6.0-beta.1] - 2026-08-20
44

55
### 新功能 / Features
66

@@ -15,6 +15,10 @@
1515

1616
### 问题修复 / Fixes
1717

18+
- **Windows 覆盖安装后二次启动修复**:canonical SQLite 验证库与 stage 库改用有界的同目录随机名称,避免第二次启动进入文件权威发布时超过 Windows SQLite VFS 路径上限;Windows x64 发布门禁现在会在同一升级档案上连续完成两次正常启动
19+
- **Windows Second-Launch Fix After Overwrite Install**: Canonical SQLite verification and stage databases now use bounded random sibling names so second-launch file-authority publication stays within the Windows SQLite VFS path limit; the Windows x64 release gate now completes two clean launches against the same upgraded profile
20+
- **数据库失败清理与外部会话句柄**:任务自有 SQLite 现在统一清理 journal/WAL sidecars 与相邻 `.lock`,canonical checkpoint 不再放大父路径;Cherry Studio、Hermes 与 NanoClaw 的无效 schema 或成对数据库打开失败会关闭已取得的连接
21+
- **Database Failure Cleanup and External Session Handles**: Task-owned SQLite now consistently removes journal/WAL sidecars and adjacent `.lock` directories, canonical checkpoints no longer amplify parent paths, and Cherry Studio, Hermes, and NanoClaw close acquired connections after invalid schemas or paired-store open failures
1822
- **替换候选的升级与恢复安全**:补上 Windows x64 从 `0.5.9` 升级到候选包的真实冷启动门禁,并完善 canonical 文件图自愈、SQLite/Markdown 候选恢复、媒体补齐、AI 模型配置恢复和旧 Agent Skill 链接收敛
1923
- **Replacement Candidate Upgrade and Recovery Safety**: Added a real packaged Windows x64 cold-start gate for `0.5.9` upgrades and hardened canonical graph self-heal, SQLite/Markdown candidate recovery, media restoration, AI model configuration recovery, and legacy Agent Skill link reconciliation
2024
- **Agent 数据与原生交互修正**:Overview 不再把未加载或失败资产显示为 `0`,额度回到系统原生菜单,配置编辑器恢复文件树与主编辑画布的语义层级
@@ -28,8 +32,8 @@
2832

2933
### 维护 / Maintenance
3034

31-
- **同版本 Draft 原位替换**:保留 `v0.6.0-beta.1` 版本号,以带旧值校验的 tag 更新和 draft `--clobber` 资产替换覆盖已撤回候选;所有平台门禁完成前不会自动公开
32-
- **In-Place Same-Version Draft Replacement**: Reuses `v0.6.0-beta.1` through a leased tag update and draft asset replacement with `--clobber`; the prerelease is not promoted automatically before all platform gates pass
35+
- **同版本 Prerelease 原位替换**:保留 `v0.6.0-beta.1` 版本号,以带旧值校验的 tag 更新和 `--clobber` 资产替换覆盖受影响的预览包;完整验证、Windows 双启动及平台签名门禁全部通过后才进入 Release job。已安装同版本的用户不会收到“更高版本”自动更新,需要手动覆盖安装修复包
36+
- **In-Place Same-Version Prerelease Replacement**: Reuses `v0.6.0-beta.1` through a leased tag update and `--clobber` asset replacement for the affected preview; the Release job remains blocked on full verification, the Windows two-launch smoke, and platform signing gates. Existing installs of the same version will not see a newer-version auto-update and must manually overwrite-install the fixed package
3337
- **大型模块与测试拆分**:按职责拆分 AI 请求、Prompt 编辑器、canonical 恢复、MCP 持久化、macOS injector 与 CLI 测试热点,并收紧文件行数基线
3438
- **Large Module and Test Splits**: Split AI requests, Prompt editors, canonical recovery, MCP persistence, the macOS injector, and CLI test hotspots by responsibility while tightening file-size baselines
3539
- **0.6.0-beta.1 预览版准备**:Desktop、CLI、自部署 Web、Cloudflare Worker 与 Mobile 使用明确的 prerelease 版本;官网稳定版徽标和下载链接继续指向已发布的 `0.5.9`

README.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -360,11 +360,13 @@ Skill 导入、版本快照和分发统一应用内置忽略规则与根目录 `
360360

361361
完整版本说明:**[CHANGELOG.md](./CHANGELOG.md)**
362362

363-
### v0.6.0-beta.1(2026-08-19,替换预览版)
363+
### v0.6.0-beta.1(2026-08-20,替换预览版)
364364

365365
- 统一 Agent 工作台集中管理 Skills、MCP、Plugins、Rules、供应商/模型、配置文件、额度和历史会话
366-
- 文件优先 canonical 数据权威、恢复候选、自愈和 Windows `0.5.9` 升级冷启动门禁共同保护预览用户数据
367-
- 本次原位替换已撤回的同名 beta draft;最新稳定版继续是 `v0.5.9`
366+
- 文件优先 canonical 数据权威、恢复候选、自愈和 Windows `0.5.9` 升级双启动门禁共同保护预览用户数据
367+
- 有界 SQLite 临时库路径修复覆盖安装后第二次启动失败;本次在相同 beta tag 原位替换受影响的预览包
368+
- 已安装旧 `v0.6.0-beta.1` 的用户需要手动下载并覆盖安装修复包,同版本替换不会触发自动更新
369+
- 最新稳定版继续是 `v0.5.9`
368370

369371
### v0.5.9(2026-07-09,正式版)
370372

docs/README.de.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -324,11 +324,13 @@ Häufige globale Flags:
324324

325325
Vollständiges Changelog: **[CHANGELOG.md](../CHANGELOG.md)**
326326

327-
### v0.6.0-beta.1 (2026-08-19, Ersatz-Preview)
327+
### v0.6.0-beta.1 (2026-08-20, Ersatz-Preview)
328328

329329
- Der einheitliche Agent-Workspace verwaltet Skills, MCP, Plugins, Rules, Provider/Modelle, Konfigurationsdateien, Kontingente und Verläufe an einem Ort
330-
- File-first canonical authority, Wiederherstellungskandidaten, Self-Heal und ein paketierter Windows-`0.5.9`-Upgrade-Kaltstart-Gate schützen Preview-Daten
331-
- Dieser Stand ersetzt den zurückgezogenen Draft unter demselben Beta-Tag; die aktuelle Stable bleibt `v0.5.9`
330+
- File-first canonical authority, Wiederherstellungskandidaten, Self-Heal und ein paketierter Windows-`0.5.9`-Upgrade-Gate mit zwei Starts schützen Preview-Daten
331+
- Begrenzte SQLite-Temporärpfade beheben den zweiten Start nach einer Überschreibinstallation; die betroffene Preview wird unter demselben Beta-Tag ersetzt
332+
- Bereits installierte alte `v0.6.0-beta.1`-Pakete müssen manuell heruntergeladen und überschrieben werden, da ein Ersatz mit derselben Version kein Auto-Update auslöst
333+
- Die aktuelle Stable bleibt `v0.5.9`
332334

333335
### v0.5.9 (2026-07-09, Stable)
334336

docs/README.en.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -341,11 +341,13 @@ Common global flags:
341341

342342
Full changelog: **[CHANGELOG.md](../CHANGELOG.md)**
343343

344-
### v0.6.0-beta.1 (2026-08-19, replacement preview)
344+
### v0.6.0-beta.1 (2026-08-20, replacement preview)
345345

346346
- The unified Agent workbench manages Skills, MCP, Plugins, Rules, providers/models, config files, quotas, and session history in one place
347-
- File-first canonical authority, recovery candidates, self-heal, and a packaged Windows `0.5.9` upgrade cold-start gate protect preview user data
348-
- This refresh replaces the withdrawn draft under the same beta tag; the latest stable release remains `v0.5.9`
347+
- File-first canonical authority, recovery candidates, self-heal, and a packaged Windows `0.5.9` two-launch upgrade gate protect preview user data
348+
- Bounded SQLite temporary paths fix the post-upgrade second-launch failure; this refresh replaces the affected preview in place under the same beta tag
349+
- Existing installs of the old `v0.6.0-beta.1` must manually download and overwrite-install the fixed package because a same-version replacement does not trigger auto-update
350+
- The latest stable release remains `v0.5.9`
349351

350352
### v0.5.9 (2026-07-09, stable)
351353

docs/README.es.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -324,11 +324,13 @@ Flags globales habituales:
324324

325325
Changelog completo: **[CHANGELOG.md](../CHANGELOG.md)**
326326

327-
### v0.6.0-beta.1 (2026-08-19, preview de reemplazo)
327+
### v0.6.0-beta.1 (2026-08-20, preview de reemplazo)
328328

329329
- El workspace unificado de Agent gestiona Skills, MCP, Plugins, Rules, proveedores/modelos, archivos de configuración, cuotas e historial en un solo lugar
330-
- La autoridad canonical basada en archivos, los candidatos de recuperación, la autorreparación y el arranque en frío empaquetado de Windows desde `0.5.9` protegen los datos de preview
331-
- Esta versión reemplaza el draft retirado bajo el mismo tag beta; la versión estable más reciente sigue siendo `v0.5.9`
330+
- La autoridad canonical basada en archivos, los candidatos de recuperación, la autorreparación y una puerta de dos arranques empaquetados de Windows desde `0.5.9` protegen los datos de preview
331+
- Las rutas temporales acotadas de SQLite corrigen el segundo arranque tras una instalación sobrescrita; esta versión reemplaza la preview afectada bajo el mismo tag beta
332+
- Las instalaciones existentes de la antigua `v0.6.0-beta.1` deben descargar e instalar manualmente el paquete corregido, ya que un reemplazo con la misma versión no activa la actualización automática
333+
- La versión estable más reciente sigue siendo `v0.5.9`
332334

333335
### v0.5.9 (2026-07-09, estable)
334336

docs/README.fr.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -324,11 +324,13 @@ Options globales courantes :
324324

325325
Journal complet : **[CHANGELOG.md](../CHANGELOG.md)**
326326

327-
### v0.6.0-beta.1 (2026-08-19, aperçu de remplacement)
327+
### v0.6.0-beta.1 (2026-08-20, aperçu de remplacement)
328328

329329
- Le workspace Agent unifié gère Skills, MCP, Plugins, Rules, fournisseurs/modèles, fichiers de configuration, quotas et historique au même endroit
330-
- L'autorité canonical orientée fichiers, les candidats de récupération, l'auto-réparation et le démarrage à froid Windows packagé depuis `0.5.9` protègent les données de préversion
331-
- Cette version remplace le draft retiré sous le même tag beta ; la dernière version stable reste `v0.5.9`
330+
- L'autorité canonical orientée fichiers, les candidats de récupération, l'auto-réparation et un gate Windows packagé à deux démarrages depuis `0.5.9` protègent les données de préversion
331+
- Des chemins temporaires SQLite bornés corrigent le deuxième démarrage après une installation par-dessus l'existante ; cette version remplace l'aperçu affecté sous le même tag beta
332+
- Les installations existantes de l'ancienne `v0.6.0-beta.1` doivent télécharger et réinstaller manuellement le paquet corrigé, car un remplacement avec la même version ne déclenche pas la mise à jour automatique
333+
- La dernière version stable reste `v0.5.9`
332334

333335
### v0.5.9 (2026-07-09, stable)
334336

docs/README.ja.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -324,11 +324,13 @@ Skill のインポート、バージョンスナップショット、配布で
324324

325325
完全な変更履歴: **[CHANGELOG.md](../CHANGELOG.md)**
326326

327-
### v0.6.0-beta.1(2026-08-19、差し替えプレビュー)
327+
### v0.6.0-beta.1(2026-08-20、差し替えプレビュー)
328328

329329
- 統合 Agent ワークベンチで Skills、MCP、Plugins、Rules、プロバイダー/モデル、設定ファイル、クォータ、履歴を一元管理します
330-
- ファイル優先 canonical authority、復旧候補、self-heal、Windows `0.5.9` アップグレードのパッケージ cold-start gate でプレビューデータを保護します
331-
- 取り下げ済み draft を同じ beta tag で差し替えます。最新安定版は引き続き `v0.5.9` です
330+
- ファイル優先 canonical authority、復旧候補、self-heal、Windows `0.5.9` アップグレードのパッケージ 2 回起動 gate でプレビューデータを保護します
331+
- 有界な SQLite 一時パスで上書きインストール後の 2 回目起動失敗を修正し、影響を受けたプレビューを同じ beta tag で差し替えます
332+
-`v0.6.0-beta.1` をインストール済みの場合、同一バージョンの差し替えでは自動更新されないため、修正版を手動でダウンロードして上書きインストールする必要があります
333+
- 最新安定版は引き続き `v0.5.9` です
332334

333335
### v0.5.9(2026-07-09、正式版)
334336

docs/README.zh-TW.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -324,11 +324,13 @@ Skill 匯入、版本快照與分發會統一套用內建忽略規則和根目
324324

325325
完整版本說明:**[CHANGELOG.md](../CHANGELOG.md)**
326326

327-
### v0.6.0-beta.1(2026-08-19,替換預覽版)
327+
### v0.6.0-beta.1(2026-08-20,替換預覽版)
328328

329329
- 統一 Agent 工作台集中管理 Skills、MCP、Plugins、Rules、供應商/模型、設定檔、額度與歷史對話
330-
- 檔案優先 canonical 權威、復原候選、自我修復與 Windows `0.5.9` 升級冷啟動門禁共同保護預覽使用者資料
331-
- 本次以相同 beta tag 原位替換已撤回的 draft;最新穩定版仍為 `v0.5.9`
330+
- 檔案優先 canonical 權威、復原候選、自我修復與 Windows `0.5.9` 升級雙啟動門禁共同保護預覽使用者資料
331+
- 有界 SQLite 暫存資料庫路徑修正覆蓋安裝後第二次啟動失敗;本次以相同 beta tag 原位替換受影響的預覽包
332+
- 已安裝舊 `v0.6.0-beta.1` 的使用者需要手動下載並覆蓋安裝修正包,同版本替換不會觸發自動更新
333+
- 最新穩定版仍為 `v0.5.9`
332334

333335
### v0.5.9(2026-07-09,正式版)
334336

spec/releases/0.6.0-beta.1.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,3 +126,21 @@ with stronger migration and recovery behavior.
126126
- The replacement candidate passed the Windows packaged upgrade cold start and
127127
the complete build matrix, then was explicitly promoted on 2026-08-19 after
128128
all replacement artifacts and public boundaries were verified.
129+
130+
## Post-Publication Windows Restart Issue
131+
132+
- Reported on 2026-08-20: an overwrite installation opened successfully once,
133+
but the next Windows launch failed before the main window with
134+
`SQLite3Error: Could not open the database` on a canonical catalog
135+
`.db.stage-<pid>-<uuid>` path.
136+
- The release smoke proved only the first upgraded launch. That launch can
137+
defer canonical authority until renderer persistence migration completes,
138+
so it did not exercise the failing second-launch checkpoint path.
139+
- Local remediation is tracked by
140+
`spec/changes/active/windows-canonical-authority-second-launch/`. The public
141+
prerelease is not yet claimed fixed; a real Windows x64 two-launch workflow
142+
and replacement publication are required.
143+
- Because the replacement keeps version `0.6.0-beta.1`, clients that already
144+
installed the affected build will not treat it as a newer automatic update.
145+
After publication, those users must manually download and overwrite-install
146+
the fixed package; fresh downloads receive the replacement assets.

spec/releases/README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,13 +14,13 @@
1414

1515
## Release Index
1616

17-
| Version | Status | Path | Updated |
18-
| -------------- | -------------------- | ------------------------------- | ---------- |
19-
| `0.6.0-beta.1` | published prerelease | `spec/releases/0.6.0-beta.1.md` | 2026-08-19 |
20-
| `0.6.0` | preparation | `spec/releases/0.6.0.md` | 2026-07-30 |
21-
| `0.5.9` | stable Latest | `spec/releases/0.5.9.md` | 2026-08-19 |
22-
| `0.5.9-beta.2` | published beta | `spec/releases/0.5.9-beta.2.md` | 2026-07-10 |
23-
| `0.5.9-beta.1` | published beta | `spec/releases/0.5.9-beta.1.md` | 2026-07-10 |
17+
| Version | Status | Path | Updated |
18+
| -------------- | ------------------------------------------- | ------------------------------- | ---------- |
19+
| `0.6.0-beta.1` | published prerelease; Windows restart issue | `spec/releases/0.6.0-beta.1.md` | 2026-08-20 |
20+
| `0.6.0` | preparation | `spec/releases/0.6.0.md` | 2026-07-30 |
21+
| `0.5.9` | stable record | `spec/releases/0.5.9.md` | 2026-08-19 |
22+
| `0.5.9-beta.2` | published beta | `spec/releases/0.5.9-beta.2.md` | 2026-07-10 |
23+
| `0.5.9-beta.1` | published beta | `spec/releases/0.5.9-beta.1.md` | 2026-07-10 |
2424

2525
## Routing Rule
2626

0 commit comments

Comments
 (0)