release: cut v1.0.0 — the "just diting" release (#39)

chenchaoyi · claude · web-flow · commit 129a0d6e4655 · 2026-05-13T10:01:19.000+08:00
Bump pyproject.toml + uv.lock 0.9.0 → 1.0.0 and consolidate the two proposals archived since v0.9.0 into a single [1.0.0] — 2026-05-13 section in CHANGELOG.md and docs/zh/CHANGELOG.md. Major version jump because the install surface materially changes: - v0.9.0 required `git clone` + `uv sync` + `make helper` + Xcode CLT. Audience: Python developers willing to set up a build environment. - v1.0.0 ships a curl-bash one-liner that drops a self-contained binary plus the helper bundle in place. Audience: anyone with a Mac. Combined with the unified row-select + live detail modals (PR #35) across Wi-Fi / BLE / Bonjour, the TUI now has a coherent gesture model end-users can learn once and apply everywhere. Source-from-tree (`uv run diting`) developer flow is preserved exactly — both paths coexist on the same machine. This tag will be the first to trigger the release workflow added in PR #37. Watch the GitHub Actions run for `macos-14` + `macos-13` matrix builds and the `shasums` follow-up job; verify the resulting release assets satisfy install.sh end-to-end. Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -9,6 +9,93 @@ the project follows [Semantic Versioning](https://semver.org/) where
 practical. The leading `v0.x` line is allowed to break minor
 behaviours between releases.
 
+## [1.0.0] — 2026-05-13
+
+**The "just diting" release.** The install ceiling drops from "clone
+the repo, install uv, build the Swift helper, run uv sync" to a
+single curl-bash one-liner that ships a self-contained binary plus
+the helper bundle. End users no longer need Python, `uv`, or Xcode
+Command Line Tools on their machine. The TUI gets one last round of
+polish: a unified row-select gesture across all three list panels
+(Wi-Fi / BLE / Bonjour), each with its own detail modal that walks
+the list live as the user presses ↑ / ↓.
+
+### Added
+- **One-line installer.** `curl -fsSL
+  https://raw.githubusercontent.com/chenchaoyi/diting/main/install.sh
+  | bash` detects arch (`darwin-arm64` / `darwin-x86_64`), pulls the
+  matching tarball from the GitHub Release, verifies SHA256, extracts
+  to `~/.local/share/diting/`, symlinks `~/.local/bin/diting`, copies
+  the Swift helper to `~/Library/Application Support/diting/`, strips
+  the quarantine xattr, and `open -g`s the helper once to prime TCC
+  prompts. PATH-update hint for zsh / bash / fish printed when
+  `~/.local/bin` isn't on PATH. `DITING_VERSION=vX.Y.Z` env var pins
+  a specific release.
+- **PyInstaller release pipeline.** New GitHub Actions workflow
+  (`.github/workflows/release.yml`) triggered by `v*` tag push;
+  `macos-14` arm64 + `macos-13` x86_64 matrix builds the helper,
+  freezes the Python interpreter + deps via PyInstaller, packages
+  the tarball, and uploads to the GitHub Release. A follow-up job
+  aggregates `SHASUMS256.txt` from both arch builds.
+- **Wi-Fi detail modal** (`i` / `Enter` / mouse-click on any scan
+  row). Identity (SSID / BSSID / AP-name from `aps.yaml` / OUI
+  vendor / "(associated)" annotation), Radio (channel / band /
+  width / PHY / security), Signal (RSSI / noise / SNR), Beacon IE
+  (BSS load, station count, 802.11r/k/v support — section omitted
+  when all absent), Activity. BSSID redaction shows an actionable
+  TCC hint instead of going silent.
+- **Bonjour detail modal** (same gesture on the mDNS panel).
+  Identity (instance / service type / category via i18n / vendor),
+  Network (host / port / IPv4 + IPv6 addresses listed separately),
+  TXT records with auto-fold for values > 60 chars (`<N-byte
+  payload>` placeholder + 16-byte hex preview so AirPlay receivers
+  with 30+ keys don't blow out the modal), Activity.
+- **Live navigation inside any detail modal.** While a modal is
+  open, ↑ / ↓ advance the underlying selection AND the modal body
+  re-renders to track the new row. Walk a list of APs, BLE devices,
+  or Bonjour services without close-and-reopen cycles. BLE modal
+  also re-fetches per-device RSSI history so the sparkline updates.
+
+### Changed
+- **Unified row-select gesture across all three list views.** The
+  ↑ / ↓ / `i` / `Enter` / mouse-click contract that BLE has had
+  since v0.7 now applies to Wi-Fi and Bonjour too. Each panel's
+  arrow-key action is view-gated so the same physical key is safe
+  across views. Pin in `openspec/specs/tui-shell/spec.md` so future
+  list panels inherit the contract by default.
+- **`find_helper()` search order gains a fifth candidate**:
+  `~/Library/Application Support/diting/diting-tianer.app`, where
+  the curl-bash installer drops the bundle. The in-repo dev build
+  stays pinned first so contributors running `uv run diting` from
+  a checkout always pick up their freshly-`make helper`ed bundle.
+- **README** leads with the one-liner; the existing clone + `uv
+  sync` + `make helper` flow moves under "From source (for
+  contributors)" — preserved exactly. Both paths coexist on the
+  same machine.
+
+### Fixed
+- **Wi-Fi selection collides cleanly under TCC-redacted scans.**
+  When BSSID is `None` (Location Services denied), the selection
+  key falls back to `f"{ssid}#{channel}"` so users without grants
+  can still navigate the list. Documented collision behaviour for
+  the same-SSID-on-same-channel edge case.
+- **Modal-close keys don't mutate selection.** `Esc` / `i` / `q`
+  close any detail modal without clearing the panel highlight, so
+  reopening returns to the same row.
+
+### Bookkeeping
+- **`docs/RELEASE.md`** (+ `docs/zh/RELEASE.md` mirror) — maintainer
+  runbook for cutting a release: version bump, tag, watch the
+  workflow, manual smoke, GitHub Release notes, dispatch dry-runs,
+  troubleshooting (PyInstaller hooks, Gatekeeper, future `macos-13`
+  runner retirement).
+- **`docs/workflow.md`** (+ ZH mirror) notes that `uv run diting` is
+  the developer path and the curl one-liner is the end-user path;
+  both are first-class.
+- Canonical OpenSpec count: 17 → 20 (new `wifi-detail-modal`,
+  `bonjour-detail-modal`, `installation`; modified `ble-detail-modal`,
+  `tui-shell`, `macos-helper`).
+
 ## [0.9.0] — 2026-05-12
 
 The **Bonjour release.** diting grows a third TUI panel — mDNS /
diff --git a/docs/zh/CHANGELOG.md b/docs/zh/CHANGELOG.md
@@ -8,6 +8,77 @@
 [Semantic Versioning](https://semver.org/)。`v0.x` 阶段允许破坏性的次要
 行为变更。
 
+## [1.0.0] — 2026-05-13
+
+**「直接 diting 就能用」版**。安装门槛从「clone 仓库、装 uv、编 Swift
+helper、跑 uv sync」降到一行 curl-bash —— 装出来的是自包含二进制 +
+helper bundle，用户机器上不再需要 Python、`uv` 或 Xcode 命令行工具。
+TUI 这一版也补齐最后一块拼图：三块列表面板（Wi-Fi / BLE / Bonjour）
+共享同一套行选中手势，每块都有自己的详情 modal，按 ↑ / ↓ 时 modal 跟
+着光标走，不用关再开。
+
+### 新增
+- **一行 installer**：`curl -fsSL
+  https://raw.githubusercontent.com/chenchaoyi/diting/main/install.sh
+  | bash`。识别架构（`darwin-arm64` / `darwin-x86_64`），从 GitHub
+  Release 拉对应 tarball，校验 SHA256，解压到 `~/.local/share/diting/`，
+  symlink `~/.local/bin/diting`，把 Swift helper 拷贝到
+  `~/Library/Application Support/diting/`，剥离 quarantine xattr，
+  `open -g` 一次触发 TCC 授权弹窗。`~/.local/bin` 不在 PATH 时按
+  zsh / bash / fish 打印对应的 PATH 更新提示。`DITING_VERSION=vX.Y.Z`
+  环境变量锁版本。
+- **PyInstaller 发布流水线**。新 GitHub Actions workflow
+  (`.github/workflows/release.yml`)，`v*` tag 推送触发；`macos-14`
+  arm64 + `macos-13` x86_64 matrix 构建 helper、用 PyInstaller 冻结
+  Python 解释器 + 依赖、打 tarball、上传到 GitHub Release。后续 job
+  把两边的 `.sha256` 汇总成 `SHASUMS256.txt`。
+- **Wi-Fi 详情 modal**（在任意扫描行按 `i` / `Enter` 或鼠标点击）。
+  身份段（SSID / BSSID / 来自 `aps.yaml` 的 AP 名 / OUI 厂商 /
+  「当前连接」标注），射频段（信道 / 频段 / 带宽 / PHY / 加密），
+  信号段（RSSI / 噪声 / SNR），Beacon IE 段（BSS 负载、终端数、
+  802.11r/k/v 支持 —— 全部缺失时整段省略），活动段。BSSID 被 TCC
+  屏蔽时给出可操作的提示，不再静默。
+- **Bonjour 详情 modal**（同一手势移植到 mDNS 面板）。身份段（实例 /
+  服务类型 / i18n 类别 / 厂商），网络段（host / port / IPv4 + IPv6
+  地址分行），TXT 记录段对 > 60 字符的值自动折叠（`<N-byte payload>`
+  + 前 16 字节 hex 预览，避免 30+ TXT key 的 AirPlay 接收器把 modal
+  撑爆），活动段。
+- **任意详情 modal 内的实时导航**。modal 打开后按 ↑ / ↓ 既移动底下面
+  板的选中，又重渲 modal 内容跟到新行。不用关再开就能扫一遍 AP / BLE
+  设备 / Bonjour 服务。BLE modal 还会按设备拉一次 RSSI 历史，sparkline
+  跟着切换。
+
+### 变更
+- **三个列表视图统一行选中手势**。BLE 自 v0.7 起就有的 ↑ / ↓ / `i`
+  / `Enter` / 鼠标点击合约现在 Wi-Fi 与 Bonjour 也按。每个面板的方
+  向键 action 都按视图门控，同一物理键在不同视图下安全。规则落到
+  `openspec/specs/tui-shell/spec.md`，未来新加列表面板默认继承。
+- **`find_helper()` 搜索顺序增加第 5 个候选**：`~/Library/Application
+  Support/diting/diting-tianer.app`，即 curl-bash installer 落地的位
+  置。in-repo 开发构建仍排在最前，确保贡献者跑 `uv run diting` 永远
+  拿到刚 `make helper` 出来的 bundle。
+- **README** 开头改成一行 installer；原 `git clone` + `uv sync` +
+  `make helper` 流程移到「从源码安装（贡献者）」二级标题下，原封保
+  留。两条路径同机共存。
+
+### 修复
+- **TCC 屏蔽扫描时 Wi-Fi 选中健码退化无冲突**。BSSID 为 `None` 时
+  选中键退化为 `f"{ssid}#{channel}"`，未授定位的用户仍可上下导航。
+  同名 SSID 同信道的冲突边界条件已记录在 spec 里。
+- **关 modal 不动选中**。`Esc` / `i` / `q` 关任意详情 modal 都不清
+  除面板高亮，重新打开还回到同一行。
+
+### 维护备注
+- **`docs/RELEASE.md`**（+ `docs/zh/RELEASE.md` 镜像）—— 发版 runbook：
+  版本号 bump、打 tag、盯 workflow、人工冒烟、GitHub Release 文案、
+  workflow_dispatch 干跑、排查（PyInstaller hooks / Gatekeeper /
+  `macos-13` runner 终将退役）。
+- **`docs/workflow.md`**（+ 中文镜像）说明 `uv run diting` 是开发者路
+  径、curl 一行是用户路径，两者都属于一等公民。
+- OpenSpec 规范条数：17 → 20（新增 `wifi-detail-modal`、
+  `bonjour-detail-modal`、`installation`；修改 `ble-detail-modal`、
+  `tui-shell`、`macos-helper`）。
+
 ## [0.9.0] — 2026-05-12
 
 **「Bonjour 版」**。TUI 第三块面板从「Wi-Fi / BLE 二选」扩展为
diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "diting"
-version = "0.9.0"
+version = "1.0.0"
 description = "macOS terminal listening post for Wi-Fi, BLE, link health, and the RF environment — your Mac hears more than it tells you"
 readme = "README.md"
 license = "MIT"
diff --git a/uv.lock b/uv.lock
