docs: distill v0.1.9 release session

Author: linhay

.agents/tritonkit-skills/internal/tritonkit-ops-governance/SKILL.md

@@ -46,6 +46,8 @@ metadata:
 - 上报 GitHub issue 前必须脱敏工程和个人信息：真实工程名、App 名、bundle ID、team ID、组织名、用户名、账号、邮箱、手机号、内网域名、绝对私有路径、完整私有日志、未脱敏截图和证据包不得进入公开 issue；必要时使用 `<private-app>`、`<bundle-id>`、`<user>`、`<internal-host>`、`<repo-path>` 等占位符，并保留平台版本、TritonKit 版本、命令、错误码和最小可复现片段。
 - GitHub Actions 状态观察优先使用 `docs-linhay/scripts/gh-run-summary.sh --watch <run-id>`；失败后再拉完整日志，避免 `gh run watch` 重复输出淹没关键状态。
 - 发布脚本查找 GitHub Actions run 时必须从 `gh run list --json headBranch,url` 的 URL 字符串解析 run id；不要通过 `databaseId` + Go template 渲染大整数，避免被格式化成科学计数法后导致 `gh run view` 404。
+- Release 脚本完成后，完成定义是 arm64 CLI 包、skill 包、checksum manifest、GitHub Release 和 Homebrew tap 已可用；x86_64 CLI 资产由 Intel runner 后补，不阻塞 Apple Silicon 发布闭环。若额外开了 `gh-run-summary --watch` 观察 backfill，release 脚本完成后可停止本地 watcher，但不要取消 GitHub Actions run。
+- Release tag 推送完成后再写 memory 时，只用 docs-only commit 推回 `main`，不要移动 tag；随后观察该 docs-only main CI 通过，作为整理收尾证据。
 
 ## 文档与记忆
 

docs-linhay/dev/20260525-session-distillation.md

@@ -0,0 +1,86 @@
+# 2026-05-25 session distillation
+
+## 本轮沉淀的模式
+
+### 统一 device selector 改造闭环
+
+当一个 host-side 设备命令已经有平台专属 `--target` 入口，但 agent 侧需要统一入口时，默认把新入口设计为 `--device <selector>`，并保留旧参数作为兼容路径。
+
+本轮落地到 `triton device runtime-url`：
+
+- 首选：`triton device runtime-url --device harmony-a --probe-manifest --json`
+- 兼容：`triton device runtime-url --platform harmony --target <hdc-target> --probe-manifest --json`
+- selector 支持 alias、`harmony:<target>`、raw HDC target 和 `current`
+- `--device` 与旧 `--target` 同传时返回 `parameter_conflict`
+- schema examples、README、dev 文档、public skills 和 mock smoke 必须同步
+
+可复用检查点：
+
+1. 先补 schema / selector / round-trip 测试。
+2. 抽出平台中性 target 到平台专属 target 的 helper，避免多处手写转换。
+3. mock smoke 同时覆盖新推荐路径和旧兼容路径。
+4. 文档默认展示统一 selector，兼容路径只作为 fallback 说明。
+
+复用入口：
+
+- `Sources/TritonKitCLI/CLIHostCommands.swift`
+- `Sources/TritonKitCLI/CLIHostRuntime.swift`
+- `Sources/TritonKitCLI/CLISchemaRuntime.swift`
+- `CLI/Tests/TritonKitCLITests/DeviceCrossPlatformTests.swift`
+- `docs-linhay/scripts/verify-harmony-runtime-base-url-smoke.sh`
+- `.agents/tritonkit-skills/public/tritonkit-emulator-cli-takeover/SKILL.md`
+
+### release 收尾分层
+
+`docs-linhay/scripts/release.sh <version> --yes` 的完成定义是 Apple Silicon 发布闭环可用：
+
+- 本地 `verify.sh --local` 通过
+- tag 已推送
+- GitHub Release 已创建
+- arm64 CLI 包、skill 包、checksum manifest 已上传
+- Homebrew tap 已更新并可 `brew fetch --formula NeptuneKit/tap/triton`
+
+x86_64 CLI 资产由 Intel runner 后补上传并再次刷新 checksum / tap。它应被持续观察，但不阻塞 release 脚本返回，也不应在交付说明中写成发布未完成。
+
+本轮发版还沉淀出一个收尾顺序：
+
+1. 代码和 release 相关提交先进入 tag。
+2. tag release 完成后，再把“已发布版本、Release URL、Homebrew 验证、x86_64 后补状态”写入 memory。
+3. memory 写回用 docs-only commit 推回 `main`，不要移动 tag。
+4. 等这个 docs-only main CI 通过，作为会话收尾证据。
+5. 若开了额外 `gh-run-summary --watch` 观察 x86_64 backfill，发版主脚本完成后可停止本地 watcher；不能取消 GitHub Actions run。
+
+复用入口：
+
+- `docs-linhay/scripts/release.sh`
+- `docs-linhay/scripts/gh-run-summary.sh`
+- `.agents/tritonkit-skills/internal/tritonkit-ops-governance/SKILL.md`
+- `docs-linhay/memory/YYYY-MM-DD.md`
+
+## 本轮不纳入的内容
+
+- 不把 `device runtime-url` 扩展到 iOS；iOS embedded runtime 仍通过 `triton serve` 与 runtime target 选择处理。
+- 不删除 `--platform harmony --target` 兼容路径。
+- 不把 x86_64 后补等待作为发版脚本阻塞条件。
+- 不更新 `AGENTS.md`；本轮新增的是 release 收尾和 selector 改造的执行细节，沉淀到 skill / dev 文档即可。
+
+## 已完成验证
+
+- commit `1db99d1 feat: support device selector for runtime url` 已推送并进入 `v0.1.9`。
+- main CI run `26390606850` 通过。
+- 本地通过：
+  - `swift test --package-path CLI --scratch-path .build/cli --filter DeviceCrossPlatformTests`
+  - `swift test --package-path CLI --scratch-path .build/cli`
+  - `docs-linhay/scripts/verify-harmony-runtime-base-url-smoke.sh`
+  - `docs-linhay/scripts/verify.sh --local`
+  - `docs-linhay/scripts/check-docs.sh`
+  - `docs-linhay/scripts/qmd-sync.sh`
+- `v0.1.9` Release 已发布：https://github.com/NeptuneKit/TritonKit/releases/tag/v0.1.9
+- Homebrew arm64 链路已验证：`brew fetch --formula NeptuneKit/tap/triton` 返回 `Formula triton (0.1.9)`。
+- tag CI run `26391554956` 最终成功，x86_64 backfill 已上传 `triton-macos-x86_64.tar.gz` 并刷新 `tritonkit_checksums.txt`。
+- release 记录 commit `a9f2347 docs: record v0.1.9 release` 已推送，main docs-only CI run `26392284317` 通过。
+
+## 后续行动
+
+1. 继续收口剩余 host-side 命令的 `--device <selector>` 首选路径，优先选择 agent 高频命令。
+2. 下一次 release 继续沿用“tag 前 clean、tag 后 memory docs-only commit、main docs-only CI 通过”的收尾顺序。

docs-linhay/memory/2026-05-25.md

@@ -73,4 +73,10 @@
 - 发版脚本 `docs-linhay/scripts/release.sh v0.1.9 --yes` 完成：发版前本地 `verify.sh --local` 通过，GitHub Release 已发布，arm64 CLI 包、`tritonkit-skills.tar.gz` 与 `tritonkit_checksums.txt` 已上传。
 - GitHub Release：https://github.com/NeptuneKit/TritonKit/releases/tag/v0.1.9。
 - Homebrew arm64 链路已验证：`brew fetch --formula NeptuneKit/tap/triton` 返回 `Formula triton (0.1.9)`。
-- x86_64 CLI 资产按既定规则由 Intel runner 后补上传并刷新 checksum / tap，不阻塞 Apple Silicon 发布闭环。
+- x86_64 CLI 资产已由 Intel runner 后补上传，`tritonkit_checksums.txt` 已刷新；tag CI run `26391554956` 最终成功。
+
+## Session Distillation
+
+- 本轮整理沉淀到 `docs-linhay/dev/20260525-session-distillation.md`：统一 `device --device <selector>` 改造闭环、`runtime-url` 新旧路径兼容验证、release 收尾分层。
+- 已更新 `tritonkit-ops-governance`：release 脚本完成定义以 arm64/Homebrew 可用为准，x86_64 backfill 不阻塞；tag 后 memory 写回使用 docs-only commit 推回 `main`，不移动 tag。
+- 本轮不升级 `AGENTS.md`，因为新增内容是 release 收尾与 selector 改造执行细节，尚不需要扩展 repo-wide 长期约束。