@zaclinley/dsh-mailharbor 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -1,12 +1,31 @@
 # Changelog
 
-All notable changes to this project are documented here. The format follows
-[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
-[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+## 0.2.1
 
-## [Unreleased]
+### Patch Changes
 
-## [0.1.0] - 2026-11-06
+- 7f5a956: Adapt the sidebar unread badge to the shell: a compact accent pill at the icon
+  corner instead of a white blob that covered the envelope (the old badge used
+  `--dsw-alias-brand-primary`, which is near-white in the dark theme).
+
+## 0.2.0
+
+### Minor Changes
+
+- b9e52c2: Redesign the panel to match the DSH design system, and add a migration path from
+  the retired `dsh-plugin-mail` data directory.
+
+  - Buttons now use the shell's primary/ghost tokens (the old panel rendered a
+    white-on-white send button in dark mode).
+  - Rows are real list items instead of buttons, so the shell's button layout no
+    longer centers and squashes sender, subject and snippet.
+  - Reader, composer and settings use the same cards, spacing and icon set.
+  - Modals render in a themed portal; previously they escaped the panel's CSS
+    variables and lost their background.
+  - `scripts/migrate-legacy.mjs` points an account at the old backup (or copies
+    it), converts read-state keys and drafts, and copies the Keychain password.
+
+## 0.1.0 - 2026-11-06
 
 First public release: the core mail workspace, rebuilt on a real build pipeline.
 

package/README.md

@@ -1,5 +1,10 @@
 # MailHarbor
 
+[![CI](https://github.com/Zac-Linley/dsh-plugin-mailharbor/actions/workflows/ci.yml/badge.svg)](https://github.com/Zac-Linley/dsh-plugin-mailharbor/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@zaclinley/dsh-mailharbor.svg)](https://www.npmjs.com/package/@zaclinley/dsh-mailharbor)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![DSH](https://img.shields.io/badge/DSH-0.2.x-4B67B4)](https://github.com/Zac-Linley/dsh-plugin-mailharbor)
+
 **A multi-account IMAP/SMTP mail workspace for [DeepSeek Harness](https://github.com/Zac-Linley/dsh-plugin-mailharbor).**
 
 MailHarbor adds a **Mail** entry to the DSH sidebar and a full mail workspace to the main panel:
@@ -64,6 +69,26 @@ dsh plugin --profile desktop add link:$PWD
   AUTH, otherwise wait for the OAuth2 release.
 - Yahoo: app password. Self-hosted: any IMAP/SMTP endpoints with STARTTLS or implicit TLS.
 
+## Migrating from `dsh-plugin-mail`
+
+The package was renamed and the data root moved (`~/.dsh/mail-plugin` → `~/.dsh/mailharbor`).
+A migration script ships with the package:
+
+```bash
+# preview what would change
+node node_modules/@zaclinley/dsh-mailharbor/scripts/migrate-legacy.mjs --dry-run
+
+# point the new account at the existing backup (no copy; instant, keeps the large DB in place)
+node node_modules/@zaclinley/dsh-mailharbor/scripts/migrate-legacy.mjs
+
+# or make a self-contained copy under the new data root
+node node_modules/@zaclinley/dsh-mailharbor/scripts/migrate-legacy.mjs --copy
+```
+
+It matches accounts by email, repoints `dataDir`, converts read-state keys and drafts to the new
+shapes, and copies the macOS Keychain password to the new service name. OAuth2 accounts are skipped
+until OAuth support ships. Restart DSH afterwards so the Host reopens the database.
+
 ## Data and privacy
 
 | What                    | Where                                                                                |
@@ -134,9 +159,10 @@ must be able to publish `@zaclinley/*`. See [CONTRIBUTING.md](CONTRIBUTING.md).
 | Version   | Scope                                                                        |
 | --------- | ---------------------------------------------------------------------------- |
 | **0.1.x** | Core mail workspace, backup, tools, settings, publishing pipeline            |
-| 0.2       | OAuth2 + XOAUTH2 (Gmail loopback/PKCE, Microsoft device code), token refresh |
-| 0.3       | AI summaries, compose assist, natural-language search, writing style profile |
-| 0.4       | CalDAV tasks, Markdown/PDF reports                                           |
+| 0.2       | UI overhaul, migration from `dsh-plugin-mail`, installer polish              |
+| 0.3       | OAuth2 + XOAUTH2 (Gmail loopback/PKCE, Microsoft device code), token refresh |
+| 0.4       | AI summaries, compose assist, natural-language search, writing style profile |
+| 0.5       | CalDAV tasks, Markdown/PDF reports                                           |
 | Later     | Export/import, onboarding, richer attachments                                |
 
 ## Star history

package/README.zh.md

@@ -1,5 +1,10 @@
 # MailHarbor（邮件港）
 
+[![CI](https://github.com/Zac-Linley/dsh-plugin-mailharbor/actions/workflows/ci.yml/badge.svg)](https://github.com/Zac-Linley/dsh-plugin-mailharbor/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@zaclinley/dsh-mailharbor.svg)](https://www.npmjs.com/package/@zaclinley/dsh-mailharbor)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![DSH](https://img.shields.io/badge/DSH-0.2.x-4B67B4)](https://github.com/Zac-Linley/dsh-plugin-mailharbor)
+
 **把多个 IMAP/SMTP 邮箱接进 [DeepSeek Harness](https://github.com/Zac-Linley/dsh-plugin-mailharbor) 的邮件工作区。**
 
 MailHarbor 在 DSH 左侧栏加一个「邮件」入口，主面板里是完整的收发邮件工作区：浏览本地备份或
@@ -61,6 +66,24 @@ dsh plugin --profile desktop add link:$PWD
 - Microsoft 365：基本认证已停用；只有租户仍允许 IMAP AUTH 时才能用应用专用密码，否则等 OAuth2 版本。
 - Yahoo：应用专用密码。自建邮箱：任何支持 STARTTLS 或隐式 TLS 的 IMAP/SMTP 都可以。
 
+## 从 `dsh-plugin-mail` 迁移
+
+包名改了，数据根目录也从 `~/.dsh/mail-plugin` 换到了 `~/.dsh/mailharbor`。安装包里附带迁移脚本：
+
+```bash
+# 只预览，不写入
+node node_modules/@zaclinley/dsh-mailharbor/scripts/migrate-legacy.mjs --dry-run
+
+# 默认：新账号直接指向旧备份目录（不复制，秒级完成，8 GB 数据库原地保留）
+node node_modules/@zaclinley/dsh-mailharbor/scripts/migrate-legacy.mjs
+
+# 或者复制一份到新数据目录（占用双倍磁盘）
+node node_modules/@zaclinley/dsh-mailharbor/scripts/migrate-legacy.mjs --copy
+```
+
+脚本按邮箱匹配账号，改写 `dataDir`，把已读状态和草稿转换成新结构，并把 macOS 钥匙串密码复制到
+新的 service 名下。OAuth2 账号会跳过（等 OAuth 支持发布）。迁移完重启 DSH，Host 才会重新打开数据库。
+
 ## 数据与隐私
 
 | 内容             | 位置                                                                  |
@@ -130,9 +153,10 @@ CI 会在 `main` 上通过 `.github/workflows/release.yml` 发布；仓库需要
 | 版本      | 范围                                                                  |
 | --------- | --------------------------------------------------------------------- |
 | **0.1.x** | 核心邮件工作区、备份、工具、设置、发布流水线                          |
-| 0.2       | OAuth2 + XOAUTH2（Gmail loopback/PKCE、Microsoft 设备码）、token 刷新 |
-| 0.3       | AI 摘要、起草辅助、自然语言搜索、写作风格档案                         |
-| 0.4       | CalDAV 任务、Markdown/PDF 报告                                        |
+| 0.2       | 界面重做、从 `dsh-plugin-mail` 迁移数据、安装体验                     |
+| 0.3       | OAuth2 + XOAUTH2（Gmail loopback/PKCE、Microsoft 设备码）、token 刷新 |
+| 0.4       | AI 摘要、起草辅助、自然语言搜索、写作风格档案                         |
+| 0.5       | CalDAV 任务、Markdown/PDF 报告                                        |
 | 以后      | 导出/导入、引导流程、更完整的附件支持                                 |
 
 ## 许可证