pi-proactive 0.2.0-beta.6 → 0.2.0-beta.8

package/BREAKING-CHANGES.md

@@ -0,0 +1,27 @@
+# 破坏性变更（Breaking Changes）
+
+> 与 `CHANGELOG.md` 配套：CHANGELOG 按版本列**全部**变化；本文件只列**会破坏现有用法**的变更 + 迁移做法。
+> **判定标准**：升级后，若不改用户侧配置或用法就可能装不上 / 装上不加载 / 行为改变 ⇒ 属破坏性变更。
+> **约定**：破坏性变更只允许出现在 **beta 版本的 minor 位**（如 `0.2.0-beta.6`），且必须在 CHANGELOG 有对应条目。
+
+## 0.2.0-beta.6
+### BC-1：typebox 由 `dependencies` 移出，改为 `peerDependencies` + `bundledDependencies`
+```
+为什么：宿主（Pi）要求宿主提供的包只能出现在 peerDependencies；放在 dependencies 会触发宿主告警
+  "typebox 必须在 peerDependencies、不能放 dependencies"，并可能造成运行时重复实例。
+影响：
+ · 依赖方（含把 pi-proactive 作为库引入的项目）安装时不再自动安装 typebox 副本 → 需自行保证 typebox 可解析
+ · 使用【混合安装目录】（该目录有与本包无关的 peer 冲突）时，安装可能仍需 --legacy-peer-deps
+   （这条冲突来自目录里的其它包，不是本包）
+ · 【干净空目录不需要 --legacy-peer-deps】（typebox 已随包 bundled）
+迁移：
+ 1) 直接升级：cd ~/.pi/agent/npm && npm install pi-proactive@latest
+ 2) 若安装报 peer 冲突 → 加 --legacy-peer-deps（仅混合目录需要）
+ 3) 若你此前按旧文档"必须 --legacy-peer-deps"操作 → 可以去掉该参数
+影响范围判断：本包自身运行不受影响（typebox 随包 bundled）；主要影响【把本包当库引入】的用法。
+```
+
+## 历史
+```
+（beta.5 及更早：无已登记的破坏性变更）
+```

package/CHANGELOG.md

@@ -8,7 +8,36 @@
 ---
 
 
-### 0.2.0-beta.6 — 用户可见新增：跨平台常驻安装 + 独立枚举器
+### 0.2.0-beta.8 — App 模式（不想开终端就能用）
+
+**用户可见新增**
+- `app/app.mjs`：App 最小可用外壳 —— 一条命令 `start` 起 pi 并注入 pi-proactive，附通知与只读监督面
+  · 子命令：`start` / `stop` / `status` / `describe` / `guide` / `ask "<…>"`
+  · **状态等待代替固定等待**：等扩展真的注册了才叫就绪；超时明确报【未就绪】+ 诊断（不 sleep 后假装成功）
+  · 默认用【专属短路径 agent 根】（端点 <100B）；`--shared` 才与宿主共用 `~/.pi/agent`
+  · `stop` 后七处零残留（进程 / socket / 端点 / agent 根 / 锁 / 日志 / launchd 单元）
+- `app/evidence.mjs`：一条命令打出 AC1–AC6 + D1–D4 的实际取证
+- 使用手册 `manual/USAGE.html` 新增 App 一节
+
+**修复**
+- 凭据谎报：pi 在新建 agent 根会写空 `{}` auth.json —— 此前被当作"有凭据"而谎报"能做事"；现按内容判定（只有真有 provider 条目才算）
+
+**仍标【未验证】**
+- 模型真回话（隔离根无凭据，零真实模型调用）· 通知中心肉眼可见 · "助理第一次主动联系我" · 信箱路径未取证 · Windows 分支未实现
+
+0.2.0-beta.7 — 补齐交付三件套（HTML 使用手册 + BREAKING CHANGES）
+
+**用户可见新增**
+- `docs/USAGE.html`：随包发布的 HTML 使用手册（安装 / 三条入口 / 常驻助理 / 状态一屏三块 / 按成因分性的故障排查 / 开发者向枚举与对拍）
+- `BREAKING-CHANGES.md`：破坏性变更登记与迁移做法（首条 = beta.6 的 BC-1 typebox 声明变更）
+
+**判据**
+- 新增门禁段 **G20 交付三件套**：HTML 手册存在且含当前版本 · CHANGELOG 含当前版本 ·
+  BREAKING CHANGES 含当前版本节（有破坏性则须含"迁移"）· package.json files 收录三件（否则用户拿不到）
+
+0.2.0-beta.6 — 用户可见新增：跨平台常驻安装 + 独立枚举器
+
+> ⚠️ **含破坏性变更**（BC-1：typebox 由 dependencies 移出 → peerDependencies + bundledDependencies）⇒ 迁移做法见 `BREAKING-CHANGES.md`
 
 **新增能力（可直接用）**
 - `tools/daemon-install.mjs` / `tools/daemon-uninstall.mjs` / `daemon/run-daemon.mjs`：

package/README.md

@@ -406,25 +406,25 @@ Usage: `/proactive <子命令>`。下表**逐条对应实现里实际注册的
 <!-- BEGIN:GEN commands -->
 | 命令 | 参数形态 | 做什么 | 状态 |
 | --- | --- | --- | --- |
-| `/proactive status` | `无` | 总览：开关、空闲计时、待触发任务、对端在线、上次主动、本小时用量。 | 已实现 · `pi-proactive/src/commands.ts:632` |
-| `/proactive on` | `无` | 打开全部「代理自发」行为（空闲触发、模型自调度、跨会话自发请求）。 | 已实现 · `pi-proactive/src/commands.ts:668` |
-| `/proactive off` | `无` | 关闭全部「代理自发」行为；已排期任务保留但不再触发。 | 已实现 · `pi-proactive/src/commands.ts:669` |
-| `/proactive test` | `无` | 立即模拟一次触发（走完整「护栏 → 投递」链路），用于验证主动能力是否真的生效。 | 已实现 · `pi-proactive/src/commands.ts:758` |
-| `/proactive tasks` | `无` | 列出所有待触发任务（编号 / 类型 / 下次到期 / 归属 / 触发次数）。 | 已实现 · `pi-proactive/src/commands.ts:761` |
-| `/proactive cancel` | `<id>` | 取消一个任务。 | 已实现 · `pi-proactive/src/commands.ts:787` |
-| `/proactive idle` | `on\|off` | 打开 / 关闭空闲触发并设定阈值（on 可带时长参数，省略 = 用上次设定）。 | 已实现 · `pi-proactive/src/commands.ts:827` |
-| `/proactive peers` | `[--all\|--idle\|--name <子串>\|--detail <agentId>]` | 列出已注册的对端与在线状态（名字 / 忙闲 / 最后心跳）；可加 --all / --idle / --name / --detail。 | 已实现 · `pi-proactive/src/commands.ts:689` |
-| `/proactive spawn` | `[名字]` | 创建一个对端会话（子进程 pi --mode rpc）；本会话退出时一并终止。 | 已实现 · `pi-proactive/src/commands.ts:735` |
-| `/proactive in` | `<时长> <内容>` | 排一个延迟任务（默认只属于当前会话）。 | 已实现 · `pi-proactive/src/commands.ts:805` |
-| `/proactive at` | `<HH:MM> <内容>` | 排一个绝对时间任务。 | 已实现 · `pi-proactive/src/commands.ts:806` |
-| `/proactive every` | `<时长> <内容>` | 排一个周期任务。 | 已实现 · `pi-proactive/src/commands.ts:807` |
-| `/proactive help` | `无` | 打印命令速查表（命令表 / 配置键 / 最常见故障 / 详细文档路径）。 | 已实现 · `pi-proactive/src/commands.ts:842` |
-| `/proactive history` | `[peer\|me] [条数]` | 查看最近的主动行为记录（时间 / 类型 / 目标 / 结果 / 被护栏拦下的原因）。 | 已实现 · `pi-proactive/src/commands.ts:765` |
-| `/proactive doctor` | `[--json]` | 只读体检：逐项健康判定 + 处置建议（--json 机器可读）；不打扰、不耗额度。 | 已实现 · `pi-proactive/src/commands.ts:640` |
-| `/proactive progress` | `无` | 项目进度 + ETA：区间 + 置信度 + 归因 + 阻塞项（不给单点数字；口径 = scripts/progress-clock.py）。 | 已实现 · `pi-proactive/src/commands.ts:648` |
-| `/proactive tell` | `<peer> <内容> [--kind ask\|task\|notify]` | 人侧给另一个会话下指令（--kind ask\|task\|notify，缺省 ask 要回话）；回信落回本会话。 | 已实现 · `pi-proactive/src/commands.ts:755` |
-| `/proactive assistant` | `on\|off\|status\|restart` | 常驻助理（7×24）控制：on 打开（后台装，不阻塞会话）/ off 关闭（回执含残留终检）/ status 看宿主·进程·心跳·上次联系 / restart 重装。与终端 CLI 共用同一套安装/卸载实现。 | 已实现 · `pi-proactive/src/commands.ts:724` |
-| `/proactive config` | `[undo] [--json]` | 列出全部配置项（当前值 / 缺省值 / 取值范围 / 一句说明），先报警写错的项；config undo 撤销上一次配置改动。 | 已实现 · `pi-proactive/src/commands.ts:655` |
+| `/proactive status` | `无` | 总览：开关、空闲计时、待触发任务、对端在线、上次主动、本小时用量。 | 已实现 · `pi-proactive/src/commands.ts:633` |
+| `/proactive on` | `无` | 打开全部「代理自发」行为（空闲触发、模型自调度、跨会话自发请求）。 | 已实现 · `pi-proactive/src/commands.ts:669` |
+| `/proactive off` | `无` | 关闭全部「代理自发」行为；已排期任务保留但不再触发。 | 已实现 · `pi-proactive/src/commands.ts:670` |
+| `/proactive test` | `无` | 立即模拟一次触发（走完整「护栏 → 投递」链路），用于验证主动能力是否真的生效。 | 已实现 · `pi-proactive/src/commands.ts:806` |
+| `/proactive tasks` | `无` | 列出所有待触发任务（编号 / 类型 / 下次到期 / 归属 / 触发次数）。 | 已实现 · `pi-proactive/src/commands.ts:809` |
+| `/proactive cancel` | `<id>` | 取消一个任务。 | 已实现 · `pi-proactive/src/commands.ts:835` |
+| `/proactive idle` | `on\|off` | 打开 / 关闭空闲触发并设定阈值（on 可带时长参数，省略 = 用上次设定）。 | 已实现 · `pi-proactive/src/commands.ts:875` |
+| `/proactive peers` | `[--all\|--idle\|--name <子串>\|--detail <agentId>]` | 列出已注册的对端与在线状态（名字 / 忙闲 / 最后心跳）；可加 --all / --idle / --name / --detail。 | 已实现 · `pi-proactive/src/commands.ts:690` |
+| `/proactive spawn` | `[名字]` | 创建一个对端会话（子进程 pi --mode rpc）；本会话退出时一并终止。 | 已实现 · `pi-proactive/src/commands.ts:783` |
+| `/proactive in` | `<时长> <内容>` | 排一个延迟任务（默认只属于当前会话）。 | 已实现 · `pi-proactive/src/commands.ts:853` |
+| `/proactive at` | `<HH:MM> <内容>` | 排一个绝对时间任务。 | 已实现 · `pi-proactive/src/commands.ts:854` |
+| `/proactive every` | `<时长> <内容>` | 排一个周期任务。 | 已实现 · `pi-proactive/src/commands.ts:855` |
+| `/proactive help` | `无` | 打印命令速查表（命令表 / 配置键 / 最常见故障 / 详细文档路径）。 | 已实现 · `pi-proactive/src/commands.ts:890` |
+| `/proactive history` | `[peer\|me] [条数]` | 查看最近的主动行为记录（时间 / 类型 / 目标 / 结果 / 被护栏拦下的原因）。 | 已实现 · `pi-proactive/src/commands.ts:813` |
+| `/proactive doctor` | `[--json]` | 只读体检：逐项健康判定 + 处置建议（--json 机器可读）；不打扰、不耗额度。 | 已实现 · `pi-proactive/src/commands.ts:641` |
+| `/proactive progress` | `无` | 项目进度 + ETA：区间 + 置信度 + 归因 + 阻塞项（不给单点数字；口径 = scripts/progress-clock.py）。 | 已实现 · `pi-proactive/src/commands.ts:649` |
+| `/proactive tell` | `<peer> <内容> [--kind ask\|task\|notify]` | 人侧给另一个会话下指令（--kind ask\|task\|notify，缺省 ask 要回话）；回信落回本会话。 | 已实现 · `pi-proactive/src/commands.ts:803` |
+| `/proactive assistant` | `on\|off\|status\|restart` | 常驻助理（7×24）控制：on 打开（后台装，不阻塞会话）/ off 关闭（回执含残留终检）/ status 看宿主·进程·心跳·上次联系 / restart 重装。与终端 CLI 共用同一套安装/卸载实现。 | 已实现 · `pi-proactive/src/commands.ts:772` |
+| `/proactive config` | `[undo] [--json]` | 列出全部配置项（当前值 / 缺省值 / 取值范围 / 一句说明），先报警写错的项；config undo 撤销上一次配置改动。 | 已实现 · `pi-proactive/src/commands.ts:656` |
 <!-- END:GEN commands -->
 
 排期命令的排期结果会**当场回执**（任务 id、相对到期、绝对到期），任务**落盘**在任务表里，进程退出后仍在，