Compare commits

..
Author SHA1 Message Date
weichenandCursor 16cafca00c Approve Generative UI auto-trigger opt-in design
Why: Capture the fixed opt-in/budget/anti-self-trigger decisions and
update the usage guide boundary list.
Evidence: proposal r1 status approved
Impact: Authority for backend auto-present implementation.
Refs: plan GenUI boundaries T2/T3

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-12 03:46:26 +00:00
weichen 3e68448f11 Merge pull request 'Record the admin-zone partition delivery in the two-trees plan (WP3-I3)' (#78) from feature/adminzone-plan-progress into main 2026-10-12 03:28:53 +00:00
weichen 0b314e2029 Record the admin-zone partition delivery in the two-trees plan progress
Why: policy requires updating applicable plan progress on task
completion; WP3-I3 landed the admin-zone entrance via the generic
declaration mechanism.
Evidence: Dev PR #414 and live verification comment (R5, SELF).
Impact: progress line of 2026-10-11-rdm-two-trees-trace-audit-integration.md only.
Refs: WP3-I3/KTD4.
2026-10-12 03:24:50 +00:00
weichen 62da617648 Merge pull request 'Approve B-class allowlist for help and intent actions' (#77) from feature/genui-bclass-help-intent into main 2026-10-12 03:23:27 +00:00
3 changed files with 52 additions and 2 deletions
@@ -9,7 +9,7 @@ product_contract_source: ce-plan-bootstrap
# RDM 两树一网集成、完善与追溯审计展示方案
修订:r1(2026-10-11 并入用户裁定);确认状态:用户评审通过(2026-10-11,需求拆解至实施计划五阶段一并,含 KTD4 双层管理员裁定);推进状态:U1–U5 全部实施并合入(RDM PR #195/#197/#201/#213;Dev PR #368,2026-10-11);U6(团队存储)独立后续;运行验收属部署环境。
修订:r1(2026-10-11 并入用户裁定);确认状态:用户评审通过(2026-10-11,需求拆解至实施计划五阶段一并,含 KTD4 双层管理员裁定);推进状态:U1–U5 全部实施并合入(RDM PR #195/#197/#201/#213;Dev PR #368,2026-10-11);管理区「项目追溯与审计」入口经通用声明机制补齐(扩展面 2.9.0 Registry.AddAdminZone;Backend #165、Frontend #63/#64、RDM #240、Dev #414,2026-10-12;rdm.audit 分区随 rdm 插件声明,区内能力仍由 rdm.inspect.* fail-closed);管理页插件清单另合并编译插件条目(Dev #404,2026-10-12)。U6(团队存储)独立后续;运行验收属部署环境。
需求负责人:weichen;方案编制:Codex;实施负责人:待实施立项时指定。
来源:2026-10-11 用户要求检查两树一网现状,并设计简单直观的项目追溯、审计展示;同轮明确选择“完善 RDM,并补齐必要的基座能力”。
目标仓:Agent-System-RDM;下文 `RDM:` 路径相对于该仓,`Dev:` 路径相对于 Agent-System-Dev;所有建议接口名均为候选契约。
@@ -0,0 +1,48 @@
---
title: Generative UI auto-trigger opt-in design
date: 2026-10-12
type: feat
revision: r1
status: approved
product_contract_source: generative-ui-r2-U6-U7-boundary
---
# Generative UI 自动触发 opt-in 设计(r1)
依据:主记录 r2(语义事件 / 预算 / 防自激);收口稿已知边界;用户 2026-10-12
计划确认「边界三项全部做」并将本表定案作为实施基线。
负责人:裁定 weichen(用户,经执行计划确认);起草 Agent;更新时间 2026-10-12。
## 定案表
| 项 | 定案 |
|---|---|
| 开关 | owner 级 settings:`plugins.generative-ui.autoPresent`,默认 `false`;**不**写入 `plugin_activation`(避免 bump epoch) |
| 前提 | `plugin_activation(generative-ui).enabled` 为真;否则 auto 无效 |
| 事件 | 仅:任务阶段跃迁(plan/todo 状态变化)、材料/工件完成(material notice、document artifact) |
| 禁止事件 | per-token / 每条 SSE、`surface.updated`、动作回执、present 成功路径 |
| 动作 | 注入 system-reminder,**只**建议调用一次 `generative-ui.present`;不自动点 actions;不改写任务事实 |
| 预算 | 每任务(conversation)每小时 ≤3 次;耗尽写审计 `genui.auto_present_exhausted` |
| 冷却 | 同会话自动触发间隔 ≥60s |
| UX | 复用 U6 pin/follow;固定后新页不抢占 |
| 门槛 | 扩大范围仍以人类效率约 +20% 为后续条件;本增量只落地最小 opt-in |
## 实施面
- Backend:settings schema/defaults;`genui.Auto` 闸门;runmgr 语义钩子;审计。
- Frontend:SettingsModal 经 schema 出开关(无需专用页)。
- Documents:本提案 + 使用说明边界条目更新。
## 验收线
1. 默认关:无 reminder / 无额外 present 建议。
2. 仅 activation∧opt-in 时,材料完成 / 阶段跃迁 / document 工件可触发。
3. surface/action/present 路径不重入。
4. 第 4 次/小时审计耗尽并停止。
5. 冷却内跳过。
## 裁定记录
用户经「Implement the plan」确认本定案表;本文 `status: approved`,实施任务
`feature/genui-auto-trigger-optin` 按本表交付。
@@ -79,7 +79,9 @@ Frontend #58/#59,Dev #381/#382/#387/#388):工具描述缺「何时用」
### 已知边界与后续项
- 自动触发模式默认关闭(后续 opt-in,需预算与防自激设计)。
- 自动触发 opt-in:settings `plugins.generative-ui.autoPresent`(默认关;须同时
Surface activation);语义事件 + 预算≤3/时 + 冷却≥60s;设计见
`2026-10-12-generative-ui-auto-trigger.md`。
- B 类命令:已加白 `builtin.help` / `system.intent`(button 入口 intent 只读匹配、
不嵌套分发;提案 `2026-10-12-generative-ui-bclass-help-intent.md`);其余仍逐条评审。
- 人类可用性对照以 owner 实际使用替代(2026-10-11 用户裁定),本轮体感「初步不错」,