提案 01:删除无生产消费者的遗留导出与 goalComplete 写-only 字段
状态: 待评审 日期: 2026-10-14 扫描域: src/、test/(消费者核对含 assets/、scripts/、vendor/、hooks/)
问题
ab47197(移除生命周期工具内核,回归纯 Prompt + goal 架构)删除了工具与调用链,但以下符号与字段仍留在源码中,只有测试消费者(或完全没有读者):
1. parsePrUrlNumber(src/util/gh.ts:5)
- 生产消费者:无。
rg "parsePrUrlNumber" src scripts assets vendor hooks仅命中定义。 - 唯一消费者:
test/util/gh.test.ts:2-16。 - 引入于
b76dc3f(为生命周期工具的gh pr create解析 PR URL),消费者随工具在ab47197一并删除。 - 插件内已无
gh子进程调用(rg "execFile.*gh" src为 0 命中);PR 由编排器在 shell 中执行。
2. upsertProjectProfile(src/kernel/profile.ts:86-98)
- 生产消费者:无。Profile 回写已回归 Prompt:
assets/skills/flow-setup/SKILL.md:27,74指示 agent 用自身编辑工具维护根AGENTS.md的 Project Profile 区块。 - 唯一消费者:
test/kernel/profile.test.ts:162-181(合成字符串用例)。 - 读取侧
readProjectProfile有生产消费者(src/plugin/server.ts:197),不动。
3. isAllowedInAutoMode(src/kernel/permission.ts:44-46)
- 定义即
matchPermission(rules, command) === "allow"的一行别名。 - 生产消费者:无。唯一消费者
test/adversarial/06-permission-bypass.test.ts:23-27。 matchPermission本身保留:它是 adversarial 测试自建的判定 oracle(:29-73 用它对真实资产权限矩阵断言),删除会让安全矩阵失去评估函数。
4. goalComplete 字段(写-only)
- 写入:
src/plugin/goal.ts:271(goal complete 时写{ goalComplete: true, status: "completed" })。 - 字段定义与补丁键:
src/kernel/session-index.ts:21,88。 - 读取者:无(
rg "goalComplete" src仅 3 处,皆为定义与写入)。 - 来源:
7998481为已删除的complete-flow工具添加的跨会话标记;读取侧随工具在ab47197删除(旧实现见ab47197^:src/plugin/flow-control.ts:253-265)。 - 唯一断言:
test/plugin/goal-tool.test.ts:238-240(断言自身写入结果,循环论证)。 - 注:session-index 其余镜像字段的处理见提案 02;本项可独立先落地。
5. goal allowlist 双份(漂移风险)
GOAL_ALLOWED_AGENTS = new Set(["dev-lifecycle", "goal-verify"])(src/plugin/goal.ts:197,已导出)。src/plugin/server.ts:266-269权限规则层再次硬编码同一字面量new Set(["dev-lifecycle", "goal-verify"])。- 注释自称"与权限规则层一致",但两处授权事实靠人工同步,属于同一事实的双表示。
提案
- 删除
src/util/gh.ts与test/util/gh.test.ts(该文件唯一函数即parsePrUrlNumber)。 - 删除
upsertProjectProfile(src/kernel/profile.ts:86-98)及测试块(test/kernel/profile.test.ts:162-181、顶部 import)。 - 删除
isAllowedInAutoMode;test/adversarial/06-permission-bypass.test.ts:23-27删除(其断言等价于 :16-21 的最后匹配语义 + 默认 ask;auto 模式是宿主行为,内核不再表达)。若想保留"auto 仅 allow"的表述,可改写为对matchPermission的注释性用例,但不要为别名保留实现。 - 删除
goalComplete:goal.ts:271的补丁收缩为{ status: "completed" }(status的完整退场见提案 02),删除session-index.ts:21字段与:88补丁键,删除test/plugin/goal-tool.test.ts:238-240的断言。 src/plugin/server.ts改为import { GOAL_ALLOWED_AGENTS } from "./goal.js",权限规则层使用{ action: "goal", allowed: GOAL_ALLOWED_AGENTS }。cabbage名单(仅 dev-lifecycle)保持现状,不为此新建常量。
为什么不保留?
parsePrUrlNumber/upsertProjectProfile:唯一"未来用处"是重建插件内 gh 自动化或 setup 工具,但二者都在ab47197被有意移出内核;若回归,应基于当时 CLI/写入语义重新设计,而不是让孤儿函数长期占据复习面。isAllowedInAutoMode:一行别名;测试直接调用matchPermission的语义完全等价。goalComplete:即使在旧设计中它也只是"跨会话完成标记"的冗余副本;若未来需要跨会话识别,应读 goal 元数据(autoResume 已经在用的单一权威),而不是新建第二文件镜像。- allowlist 双份:授权事实的单点化是安全边界的一致性要求;
goal.ts已导出常量,server 侧复用无额外成本。
验收标准
rg -n "parsePrUrlNumber|upsertProjectProfile|isAllowedInAutoMode|goalComplete" src/ test/→ 0 命中。- adversarial 测试仍覆盖真实资产权限矩阵(
:29-73不变)。 npm run typecheck && npm test通过。- 历史引用(
docs/dev/specs/thin-kernel-workflow.md:86,507,516)属自标"已废弃"文档,不改。
风险
- 低。全部符号不经由 package
exports对外(对外仅dist/index.js的插件入口与./server别名),无兼容义务。 server.ts复用常量后,若未来新增 goal 授权 agent,只需改一处,行为不变。