环境遥测三处更新节 #150

Merged

Yushu merged 2 commits from feat/108-grill-adr-updates into main

2026-08-18 03:05:11 +00:00

KumaAgent commented

2026-08-18 02:45:51 +00:00

Member

Summary

ADR-0001/0011：issue #108 Q2 拍板"真建资源 port"，新增 ResourcePort（list_resources 目录发现 + synthesize TTS 合成），ArisePorts.resource 可选字段
ADR-0013：issue #108 Q7 拍板"保留经济 hook port，两种触发时机都写进 ADR"——命令前置钩子与生成中窗口（TTS char_count）并存，纠正"②当前是空集"这条已被打破的事实前提，新增 EconomicHook port
ADR-0014：issue #108 Q3 拍板"环境遥测建独立类型"——新增 AmbientTelemetrySignal（不带 chat_id 只带 user_id），堵住已核实的真实隐私泄漏（私人遥测可能被误标进群聊、全员可见）

纯文档，不改代码。三条更新节互相有交叉引用（Q2↔Q7 共享 char_count 挂载点），已在 PR 描述里注明依赖关系，建议合并前保持这份完整性。

Test plan

三处更新节均按本仓惯例追加 ## 更新 节，未就地改写既有「决策」
Q3 的 chat_id 推导方案复用了既有 {user_id}.p 约定（proactive_reconnect.is_private_chat_id），未新增 host 侧映射机制
合并后据这四份更新节开对应实现票（评估侧后续动作）

🤖 Generated with Claude Code

## Summary - ADR-0001/0011：issue #108 Q2 拍板"真建资源 port"，新增 `ResourcePort`（`list_resources` 目录发现 + `synthesize` TTS 合成），`ArisePorts.resource` 可选字段 - ADR-0013：issue #108 Q7 拍板"保留经济 hook port，两种触发时机都写进 ADR"——命令前置钩子与生成中窗口（TTS char_count）并存，纠正"②当前是空集"这条已被打破的事实前提，新增 `EconomicHook` port - ADR-0014：issue #108 Q3 拍板"环境遥测建独立类型"——新增 `AmbientTelemetrySignal`（不带 chat_id 只带 user_id），堵住已核实的真实隐私泄漏（私人遥测可能被误标进群聊、全员可见）纯文档，不改代码。三条更新节互相有交叉引用（Q2↔Q7 共享 char_count 挂载点），已在 PR 描述里注明依赖关系，建议合并前保持这份完整性。 ## Test plan - [x] 三处更新节均按本仓惯例追加 `## 更新` 节，未就地改写既有「决策」 - [x] Q3 的 chat_id 推导方案复用了既有 `{user_id}.p` 约定（`proactive_reconnect.is_private_chat_id`），未新增 host 侧映射机制 - [ ] 合并后据这四份更新节开对应实现票（评估侧后续动作） 🤖 Generated with [Claude Code](https://claude.com/claude-code)

KumaAgent added 1 commit

2026-08-18 02:45:51 +00:00

docs: issue #108 grill 结论落 ADR——资源port/经济hook/环境遥测三处更新节 6897bf79a5

issue #108 是 2026-07-29 全 ADR 查漏里"待人类拍板"的 8 条产品取舍，
2026-08-18 逐条 grill 完毕。本次提交落地三条需要新 ADR 设计的决定
（其余走既有决策直接实现，不需要新文档）：

- ADR-0001 更新（Q2）：资源 port 从抽象决策落成具体契约——新增
  ResourcePort（list_resources + synthesize），ArisePorts.resource
  可选字段，靠"port 存在与否"当信号，不新开 CapabilitySet 布尔位
  （沿用 tag_renderers/interaction_renderers 既有模式）。
- ADR-0011 更新（Q2）：§6 TTS synthesize 契约确认落地，voice_id
  目录发现挂 ResourcePort。
- ADR-0013 更新（Q7）：经济 hook"②当前是空集"这条事实前提被 TTS
  char_count 打破，新增 EconomicHook port；命令前置钩子与生成中
  窗口两种触发时机都合法，不建补偿/saga引擎这条决策本身不变——新
  实例按层③"接受半截效果"处理，不落回原设想的可补偿语义。
- ADR-0014 更新（Q3）：环境遥测拆独立类型 AmbientTelemetrySignal，
  不带 chat_id 只带 user_id，处理管线机械拼 `{user_id}.p` 推导私聊
  目标——从类型层面排除 chat_id 误标导致私人遥测泄漏进群聊的可能
  （已核实这是真实可能发生的隐私泄漏，不是纯изм词不精确）。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Yushu added 1 commit

2026-08-18 02:48:10 +00:00

docs: ADR-0006 撤销技能检索侧延期（issue #108 grill Q4） a0717bc33e

补一条 07-24 节没有的更新——YAGNI 延期依据的"没有真实读取方"前提被
重新核实：模型主动提议技能候选本身就是需求信号，不能因为它没有走
"有人写PRD"这条常规声明渠道就当成零需求。撤销延期，实现细节 CONTEXT.md
早已写好，不需要新设计。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

KumaAgent referenced this pull request

2026-08-18 02:53:33 +00:00

ResourcePort 实现——host声明目录+TTS合成（issue #108 Q2） #152

KumaAgent referenced this pull request

2026-08-18 02:54:36 +00:00

环境遥测拆独立类型AmbientTelemetrySignal——堵隐私泄漏（issue #108 Q3） #153

KumaAgent referenced this pull request

2026-08-18 02:55:46 +00:00

Skill检索侧补齐——inject_skills三级渐进披露（issue #108 Q4） #154

KumaAgent referenced this pull request

2026-08-18 03:00:04 +00:00

EconomicHook实现——char_count接线（issue #108 Q7） #157