clearai-dsh 0.1.2 → 0.1.4

package/lib/host.js

@@ -9,7 +9,7 @@
  *
  * 为什么状态机必须在这一层:预设会被**重建**(组合文件的 mtime 一变,名册就重新挂载),
  * 而进程级的东西(投影注册、服务名)只能注册一次。把状态放在预设里,等于让一个会被重建的
- * 东西持有进程级资源——第二次挂载必然撞名(实测:webserver duplicate exact route)。
+ * 东西持有进程级资源——第二次挂载必然撞名(失效模式:webserver 报 duplicate exact route)。
  *
  * 面板也不再需要 HTTP 路由:投影单元的 `wire` 把视图推给浏览器,客户端用
  * `useProjection('clearai')` 读——免轮询、自带变更通知。
@@ -44,7 +44,7 @@ const stateSchema = z.looseObject({
 	skillUsage: z.record(z.string(), z.unknown()),
 })
 
-/** 浏览器读到的那个视图(面板契约,见 DESIGN.md §3.2)。 */
+/** 浏览器读到的那个视图(面板契约——客户端与宿主半各自消费它的同一批字段)。 */
 const viewSchema = z.looseObject({
 	ok: z.boolean(),
 	mounted: z.boolean(),
@@ -112,24 +112,24 @@ export function apply(ctx) {
 	 *   ① **动词白名单**:adopt_branch / abandon_fork / promote_skill,
 	 *      表外一律拒(与贡献表同一套「表外的名字不许出现」)——**取值**也在这一层校验
 	 *      (技能名合原生语法),宁可 400,也不静默半生效;
-	 *      `set_autonomy` 于 §34 摘掉:「在场与否」是运行时状态,不该是面板上的一个开关 ✗;
+	 *      `set_autonomy` 已摘掉:「在场与否」是运行时状态,不该是面板上的一个开关 ✗;
 	 *   ② **agent 不可达**:这些动词**没有工具 schema**——模型的工具面里不存在它们。
 	 *      模型能做的只是读到「人做了什么」这条事实(它进的是会话日志,不是内核状态);
 	 *   ③ **留下署名**:动作变成一条 `source.kind === 'user'` 的消息,折进投影时写
 	 *      `by:'user'`——「谁在什么时候裁了哪条世界线、扶正了哪个技能、把档切成了什么」都在日志里。
 	 *
-	 * 2026-09-11 砍掉两个动词(奥卡姆:它们是重复,不是能力):
+	 * 两个动词已砍掉(奥卡姆:它们是重复,不是能力):
 	 *   · `confirm_plan` —— 原生 `dsh-plan-mode` 就是「用户复核的出口」;而授权本来就「交付即落账」;
 	 *   · `invoke_skill` —— 原生 `/` 技能触发器做同一件事(还带候选菜单),我们那条只是在旁边
 	 *     又写了一遍同一个手势。
 	 *
 	 * 为什么走 HTTP 路由而不是 `harness.handle`:那是 cordis **动态插件**的座位,静态客户端包
-	 * 没有它(实测:全仓 `host.call` 只出现在动态运行时的两个包里)。宿主平面的路由是这条
+	 * 没有它(`host.call` 只在动态运行时的包里存在)。宿主平面的路由是这条
 	 * 通道在静态包里的对应物,与 ClearAI 面板自己的写接口(FastAPI 路由)同一个层级。
 	 */
 	/**
-	 * 面板用的三条 HTTP 面**必须挂 `connection` 的 exact fetch route 表**,不能只挂 `webServer`
-	 * (2026-09-11 实测换来的教训)。
+	 * 面板用的三条 HTTP 面**必须挂 `connection` 的 exact fetch route 表**,不能只挂 `webServer`——
+	 * 挂错层,浏览器里一按就是 404。
 	 *
 	 * 浏览器那侧的 `/api/*` 先落到 connection 的共享 channel:它先查 exact fetch route 表;
 	 * 查不到就把路径当成 RPC 端点(`/api/<ns>.<method>`)去问 interceptor;再查不到,
@@ -167,7 +167,7 @@ export function apply(ctx) {
 	/**
 	 * 盘上**实际**的输出成果:`products/` 底下真有、但**任何计划都还没声明**的那些文件。
 	 *
-	 * 为什么要它(2026-09-11 用户实测):在一个已经有产物的老项目里开新会话,「产物」栏只有
+	 * 为什么要它:在一个已经有产物的老项目里开新会话,「产物」栏只有
 	 * 「阶段 0 · 交付 0/0」—— 因为这一栏原来只认投影里的**声明**。可人此刻问的是「我拿到了什么」,
 	 * 盘上那份 46 KB 的 HTML 明明就在。声明与实际是两件事,这一栏本来就该两边都看得见。
 	 *
@@ -242,7 +242,7 @@ export function apply(ctx) {
 	}
 
 	/**
-	 * 把一道开着的人门**建成一张原生提问卡**(§20 混合路径)。
+	 * 把一道开着的人门**建成一张原生提问卡**(混合路径:内容走原生,裁决回我们的账本)。
 	 *
 	 * 问题与选项都从**投影**现算(此刻真实的分叉与技能),不在前端拼——前端只发一个手势。
 	 * 认不出来(那道门已经不在了)就返回 `null`:如实拒掉,不摆一张过期的卡。
@@ -354,7 +354,7 @@ export function apply(ctx) {
 			}
 			const action = request === null || typeof request !== 'object' ? '' : String(request.action ?? '')
 			/**
-			 * `ask` 是**界面手势**,不是事实动词(§20):它把某道等人的人门摆到**原生提问卡**上,
+			 * `ask` 是**界面手势**,不是事实动词:它把某道等人的人门摆到**原生提问卡**上,
 			 * 再由人在卡里选——选出来的答案仍走下面那条老路(人门消息 → 内核落事实)。
 			 * 所以白名单分两层:能**写事实**的只有 `HUMAN_GATE_ACTIONS`;能**发起提问**的另有一个。
 			 */
@@ -386,7 +386,7 @@ export function apply(ctx) {
 				return reply(400, { ok: false, error: 'bad_skill_name' })
 			}
 			/**
-			 * ── 混合路径(§20):点我们那条 → 用**原生提问卡**问 ──────────────────────
+			 * ── 混合路径:点我们那条 → 用**原生提问卡**问 ──────────────────────
 			 *
 			 * 为什么值这一条:我们自己的人门行(fork 裁决 / 采纳技能)现在只能在右栏面板里点按钮,
 			 * 而「人正在看对话」的时候,卡就在他眼前、还把输入框挡住——那是原生最擅长的形态。
@@ -428,7 +428,7 @@ export function apply(ctx) {
 				action === 'promote_skill'
 					? '候选状态正由内核改写(`status: active`),下一个回合它就在你的技能目录里'
 					/* 说准(rather than 说满):这句话写下的那一刻只到 inbox、还没进投影,
-					   所以不能断言「已经在投影里生效」——实测里模型看到它与卡片矛盾,停下来问过人(§17.5)。 */
+					   所以不能断言「已经在投影里生效」——失效模式是模型看到它与卡片矛盾,停下来问人。 */
 					: '跑 ConvergeFork 落实它——合并与清理是内核的活'
 			try {
 				appendHumanGate(agent, { detail, human, followUp })
@@ -445,7 +445,7 @@ export function apply(ctx) {
 		 *   声明(步骤 artifacts)、盘上在不在、多大、谁验的。**声明 vs 实际**是这个产品的核心对照。
 		 * `GET /api/clearai/brain?sessionId=` 工作区现状:技能目录(内核还没落事实时面板的兜底)。
 		 *
-		 * **没有「读文件正文」那条了**(2026-09-11 删):预览交给 DSH 原生的文档预览
+		 * **没有「读文件正文」那条了**:预览交给 DSH 原生的文档预览
 		 * (`dsh-client-ui-sidebar-documentpreview` 的 6 个实现 + 它自己的分页读盘),
 		 * 我们只按原生地址把文件递过去。少一条读面 = 少一处要维护的路径守卫,
 		 * 而且原生那边本来就有 markdown / 图片 / pdf / html 的渲染。
@@ -484,7 +484,7 @@ export function apply(ctx) {
 						}
 						const isFile = info !== null && info.isFile()
 						/**
-						 * `exists: false` 有两种成因,**面板必须分开说**(2026-09-11 长测抓到的):
+						 * `exists: false` 有两种成因,**面板必须分开说**(混着写会误导下一步动作):
 						 * 模型把 `lab/`(一个目录)声明成物证时,准入按「空目录」拒了它;
 						 * 而面板原来一律写「缺 · 盘上没有这个文件」——它明明在,只是不是文件。
 						 * 事实有两种,界面就别用一句话盖住。
@@ -514,7 +514,7 @@ export function apply(ctx) {
 		/**
 		 * `GET /api/clearai/brain?sessionId=` —— 工作区**现状**的实时技能目录。
 		 *
-		 * 为什么需要它(2026-09-11 用户实测):面板的数据来自会话日志的投影,而内核只在
+		 * 为什么需要它:面板的数据来自会话日志的投影,而内核只在
 		 * `agent/pre-step` 里落事实;于是**新建的会话在第一轮对话之前**,「技能 · 记忆」页签是空的
 		 * (提示还让人「先在 clear/skills/ 里放一个技能」——可那里明明躺着 18 个模板技能)。
 		 *
@@ -575,9 +575,11 @@ export function apply(ctx) {
 				/**
 				 * 运行态卡:注给模型的**事实**。
 				 *
-				 * `overrides.autonomy`:人刚在面板上切过档的那一拍,投影里还是旧档(消息先入 inbox、
-				 * 后落日志,而 pre-step 跑在它落账之前,§17.5)。卡片必须与这一回合**真正要跑的机制**
-				 * 同源,否则模型会读到两条互相矛盾的话——实测里它为此停下来问过人。
+				 * `overrides.autonomy`:面板上曾可以切档,而那一拍投影里还是旧档
+				 * (消息先入 inbox、后落日志,而 pre-step 跑在它落账之前)。切档入口已经摘除,
+				 * 但**这条覆盖通道保留**:一是旧会话日志里仍有那种记录,二是它保证了"卡片说的就是
+				 * 这一回合真正要跑的机制"这条不变量——两句话互相矛盾比一句话过期更糟
+				 * (旧投影与新消息同框时,模型会被矛盾卡住——所以宁缺毋假)。
 				 */
 				renderCard: (sessionId, overrides = {}) => {
 					const state = stateOf(sessionId)

package/package.json

@@ -1,10 +1,14 @@
 {
   "name": "clearai-dsh",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "ClearAI: The Epistemic Loop, native to DSH.",
   "type": "module",
   "private": false,
   "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Clearailhc/clearai-dsh.git"
+  },
   "main": "./lib/host.js",
   "exports": {
     ".": "./lib/host.js",
@@ -13,7 +17,7 @@
     "./package.json": "./package.json"
   },
   "bin": {
-    "clearai-dsh": "./bin/clearai.mjs"
+    "clearai-dsh": "bin/clearai.mjs"
   },
   "files": [
     "lib",
@@ -60,6 +64,8 @@
     "verify:deploy": "node tools/verify-deploy.mjs",
     "verify:install": "node tools/verify-clean-install.mjs",
     "pack": "node tools/build-package.mjs && npm pack ./dist/clearai-dsh",
-    "release": "node tools/build-package.mjs && node tools/verify-package.mjs && node tools/verify-clean-install.mjs && npm pack ./dist/clearai-dsh --pack-destination dist"
+    "release": "node tools/build-package.mjs && node tools/verify-package.mjs && node tools/verify-clean-install.mjs && npm pack ./dist/clearai-dsh --pack-destination dist",
+    "e2e": "node tools/e2e-run.mjs",
+    "e2e:long": "node tools/e2e-parallel.mjs"
   }
 }

package/presets/clearai/agent.cordis.yml

@@ -111,11 +111,11 @@
 
 # ── 认识论内核(本预设的灵魂) ───────────────────────────────────────────────
 
-# 18 件意图工具(计划/目标九件 + 世界线五件 + 侦察两件 + 外脑两件)+ 一个 guard + 每回合派生的运行态卡 +
-# 只增不删的台账 + 面板数据路由。逐条对照 docs/loop-philosophy.md 的五条哲学,
-# 见 ./plugins/clearai-kernel.js 的文件头。
+# 22 件意图工具(目标 2 + 计划 8 + 世界线 6 + 侦察 2 + 外脑 2 + 账本 2,见 `MECHANISM_TOOLS`)
+# + 一个 guard + 每回合派生的运行态卡 + 只增不删的台账 + 面板数据路由。
+# 逐条对照 docs/loop-philosophy.md 的五条哲学,见 ./plugins/clearai-kernel.js 的文件头。
 #
-# 外脑(阶段 5):**读侧全走宿主原生**——`./plugins/brain.js` 只把工作区投影成技能条目
+# 外脑:**读侧全走宿主原生**——`./plugins/brain.js` 只把工作区投影成技能条目
 # (`clear/skills/**` → 目录条目;`clear/memory/**` → 一个**虚拟条目** `project-memory`,
 # 正文现算所以没有「索引过期」),目录注入与按需加载由宿主的 `tool-skill` 承担(digest 变了才注入)。
 # 自建的只有写侧两件:`SaveSkill`(默认候选态)与 `WriteMemory`(字段校验 + 标题去重)。
@@ -124,21 +124,21 @@
 # 对读数排序,采纳最优的,落选的全部保留。算不出来就停下问人,绝不退化成随便挑一条。
 # git 世界线已落地(A+B 两档):用户仓库可用就地开分支 + worktree,不可用退到旁路账本仓库。
 #
-# 装配是**清单驱动**的(阶段 3):工具面、提示词段、机制开关、预算全部查表,代码里不出现模式名。
+# 装配是**清单驱动**的:工具面、提示词段、机制开关全部查表,代码里不出现模式名。
 #
-# 无人值守续跑(阶段 3.3):`autonomy: unattended` 时,立目标会同时在宿主 `goals` 服务上布防一枚
-# **续跑令牌**——计划收尾而目标未达成时,由宿主的回合驱动自己开下一轮。宿主目标只当**驱动器**,
-# 内核从不读它做判断(事实仍然只从投影里算出来);达成→收回,触礁/放弃→置阻塞,重启后自动补防。
-# 配置项就是机制的旋钮,默认值全部取 ClearAI 的代码事实:
+# 续跑:需要继续时,内核在宿主 `goals` 服务上布防一枚**续跑令牌**——计划收尾而目标未达成时,
+# 由宿主的回合驱动自己开下一轮。**要不要继续由门状态决定**(未授权 / 等裁决 / 有人在等 → 停),
+# 与运行档无关。宿主目标只当**驱动器**,内核从不读它做判断(事实仍然只从投影里算出来);
+# 达成→收回,触礁/放弃→置阻塞,重启后自动补防。
+# 配置项就是机制的旋钮:
 - id: clearai-kernel
   name: ./plugins/clearai-kernel.js
   config:
     # 连拦阈值:同一件事连续冲闸这么多次没过,计划置 blocked、停下等人。
-    # 模块默认是 3(`evidence.py` 的 _DEFAULT_BLOCKED_THRESHOLD);这里写 2 是产品立场
-    # 「人就在旁边,早点回来问」。2026-09-11 起它**不再随当档变**(它是质量闸,不是预算)。
+    # 默认 3;这里写 2 是产品立场「人就在旁边,早点回来问」。它是**质量闸,不随运行档变**。
     #
-    # 注意:同一个键在这个 config 里只能出现一次——YAML 的重复键会让 yaml 包直接抛错
-    # (2026-09-11 长测抓到的:顶层提到这里时下面还留着一份,DSH 的加载器却是静默取值的)。
+    # 注意:同一个键在这个 config 里只能出现一次——YAML 的重复键会让 yaml 包直接抛错,
+    # 而 DSH 的加载器是**静默取值**的,所以重复键会以"另一个值生效"的形式骗过所有人。
     blockedThreshold: 2
     # brief 质量门:低于此长度只警告不阻断(brief.py)
     minBriefChars: 280
@@ -147,7 +147,9 @@
     # L4 只认外部来源:做的人自己写过的路径不算观测
     l4RejectSelfWritten: true
     # 「≥2 条假设」在 ClearAI 只是文案;这里默认不强制,要开就把值改成 2
-    minHypotheses: 0
+    # 假设数量下限:首次立目标至少登记 2 条候选假设(0 条一样拦)。候选对比是检验的前提——
+    # 只有一个猜想时,「验证」容易退化成找证据支持自己。修订目标不受此限。
+    minHypotheses: 2
     # deny_rules 十条里可移植的九条(路径越狱那条不搬:宿主沙箱已经拥有它,ClearAI 自己也说「不重复」)
     bashDenyRules: true
     # 独立评估者:spawn = fresh context(fork 会继承历史,做的人与判的人就分不开了)
@@ -163,31 +165,33 @@
       - read_image
     # 每回合派生的运行态卡(只在状态变化时注入:前缀稳定是硬约束)
     runtimeCard: true
-    # 运行档:人在场 / 无人值守。它只换**机制**,不换人格、不换工具面:
-    #   · 澄清协议装哪一套(槽位 clarification 收敛;两套措辞互斥,永不同时在场);
-    #   · 立约是否即授权(无人值守档:选择它本身就是授权);
-    #   · 续跑策略(目标边界处:人在场停下等人 / 无人值守自己开下一轮);
-    #   · 续跑轮数上限(人在场:6 / 无人值守:512,见下面 maxAutoTurns)。
+    # 运行档:人在场 / 无人值守。**它只决定一件事**:澄清协议装哪一段
+    # (槽位 clarification 收敛;两套措辞互斥,永不同时在场)。
     #
-    # 这里写的是**初值**(新会话的默认档)。**当档是人可以在面板上随时切的**
-    # (输入框下方那条常驻条上的「档:…」,走人门动词 set_autonomy)——
-    # 「我现在在不在场」只有人知道,让配置文件替人回答是不对的。
+    # 它**不决定**下面这些——写清楚是因为这四处曾经被误认为跟着档走:
+    #   · 计划授权 —— 计划**永远**要人在原生审阅卡上批准(CreatePlan 里没有自动确认分支,
+    #     confirmed_by 只有 'user' 与 'progress');
+    #   · 续跑策略 —— 要不要继续由 turnDemand 从**门状态**算出来(未授权/裁决在飞/门开着 → hold);
+    #   · 续跑轮数 —— 只有一个默认值 128,不按档取;
+    #   · 面板开关 —— 人门动词 set_autonomy 已摘除,当前没有切换入口。
+    #
+    # 所以这里写的是**部署初值**,不是"人此刻在不在场"的表示。
+    # 真正表达"要不要人"的是**门**:计划待确认 / 等裁决 / 有人在等。
     autonomy: attended
-    # 续跑轮数上限。**不写**就按当档取(人在场 6 / 无人值守 512);写死则两档都用这个数。
-    # 这里**刻意不写**(2026-09-11 修正):以前留着 `maxAutoTurns: 6`,于是上面那句
-    # 「按档取」在实跑里从未生效——人切到无人值守,面板标签写着无人值守,额度却还是 6。
-    # 单元测试量的是「不写配置」的自由形态(512 拿得到),而真跑走的是这一份被写死的配置,
-    # 两者差了整整一个数量级,直到真跑读数摊出来才看见(§17.6)。
+    # 续跑轮数上限。**刻意不写**:不写就回落到 DEFAULT_MAX_AUTO_TURNS(128),在布防点现算。
+    # 显式写一个数就两档都用它。这个键存在的意义是**保险丝**:够长到能跑完一件真活,
+    # 又短到不会无声烧掉一整夜。
     # 执行者是**原生**:数字传到宿主目标的 maxGoalRounds,到限由 `dsh-goal-round-driver`
     # 自己 block(code='round-limit')——上限真的是机制在执行,不是一句嘱咐。
-    # 曾经这里还有一个 `budgets:` 块与 `tokenBudget`(8M/32M):2026-09-11 删了——上下文预算
-    # 本来就是原生 `dsh-token-meter` + `dsh-compaction-basic` 的活,那两个数字从未执行过。
+    # 上下文预算不在这里:那是原生 `dsh-token-meter` + `dsh-compaction-basic` 的活。
     # 贡献表(ClearAI `composition.py` 的装配语义):装配根遍历清单,清单里出现表外的名字
     # 当场抛错——未知机制 / 未知工具 / 未知段 / 已关机制却仍列着它的工具,四种错法都在装配期炸,
     # 而不是静默少装一件工具、等某一轮才发现。
     #
-    # 这里只写**机制开关**;tools / sections 缺省 = 目录全量(20 件意图工具、22 段提示词,
-    # 其中澄清协议那一段由 autonomy 在两套措辞里收敛)。要裁剪就把 tools 或 sections 显式写出来:
+    # 这里只写**机制开关**;tools / sections 缺省 = 目录全量(22 件意图工具、23 段提示词定义、
+    # 同一时刻 22 段在场——澄清协议那一段由 autonomy 在两套措辞里收敛)。
+    # 这些数字不靠人眼维持:`node tools/verify-truth-table.mjs` 会拿代码算出来的数核对它们。
+    # 要裁剪就把 tools 或 sections 显式写出来:
     #   tools: [SetGoal, CreatePlan, AdvancePlan, ...]      # 名字必须都在工具目录里
     #   sections: [clearai/foundation, clearai/loop-contract, clarification, ...]
     # `clarification` 是槽位名;直接写两套措辞里的哪一个会被拒绝(同时在场不可表示)。
@@ -200,6 +204,69 @@
         brain: true
         ledger: true
 
+# ── 人侧命令(/ 菜单) ────────────────────────────────────────────────────────
+
+# 五个命令都是**人侧界面**:四个只读状态窗(goal/plan/evidence/worldline,从账本现算,
+# 一个字都不落账) + 一个呈审捷径(plan-review,把「重新呈审」steer 给模型,
+# 授权记号仍走 RequestPlanReview 工具落账——命令处理器没有变更通道,这是权威边界)。
+- id: clearai-commands
+  name: ./plugins/commands.js
+
+# ── 工作方式(非权威能力,交还原生) ──────────────────────────────────────────
+
+# todo / 子代理 / workflow / ralph 是**工作方式**,不是认识论:它们一件 clearai 变更都
+# 产不出来(权威边界测试钉死:变更字面量只在内核、入口被标记把守)。模型干活不设限,
+# 但结论要进权威账本,只能由主线自己过观测准入与唯一完成动词。
+- id: tool-todo
+  name: '@deepseek-ai/dsh-tool-todo'
+  config:
+    allowParallelInProgress: true
+
+# `subagents` 注册表与 spawn/fork 后端在宿主平面;`workflows` 是谁都不在外面读的服务,
+# 所以到达它的行共享这一个 entry-local realm(与 standard 预设同形)。
+- id: delegation
+  name: cordis:group
+  group: true
+  isolate:
+    workflowEngine: true
+  config:
+    - id: tool-subagent-control
+      name: '@deepseek-ai/dsh-tool-subagent-control'
+
+    - id: tool-subagent-list-agents
+      name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
+
+    # 执行者自选模型:重活可以换模型跑(modelSelectionSettings 出面板设置)。
+    - id: tool-subagent
+      name: '@deepseek-ai/dsh-tool-subagent'
+      config:
+        provider: spawn
+        toolName: subagent
+        modelSelectionSettings: true
+        backgroundMode: continuable
+
+    # fork 不开模型选择:provider/model 与父保持一致,继承的历史才能继续吃 KV Cache。
+    - id: tool-subagent-fork
+      name: '@deepseek-ai/dsh-tool-subagent'
+      config:
+        provider: fork
+        toolName: subagent_fork
+        backgroundMode: continuable
+
+    - id: workflow-worker-thread
+      name: '@deepseek-ai/dsh-workflow-worker-thread'
+      config:
+        provider: spawn
+
+    - id: tool-workflow
+      name: '@deepseek-ai/dsh-tool-workflow'
+
+    - id: tool-ralph
+      name: '@deepseek-ai/dsh-tool-ralph'
+      config:
+        subagentProvider: spawn
+        maxRounds: 64
+
 # ── 其余模型面 ──────────────────────────────────────────────────────────────
 
 - id: tool-ask-user
@@ -217,10 +284,14 @@
 
 # ── 刻意不挂的行(是决策,不是遗漏) ─────────────────────────────────────────
 #
-# · `tool-todo` / `tool-goal` / `command-goal`:ClearAI 的目标与计划各自只有一本账。
-#   再挂一个模型可自行声明的状态源,就等于放弃「事实与判断分离」。目标与进度由
-#   clearai-kernel 持有,面板显示的就是它。
-# · `tool-subagent` / `tool-workflow` / `tool-ralph`:ClearAI 的子角色由 Harness 按触发派生
-#   (Scout/Evaluator),评估者的派遣已经在内核里;自由委派会重新引入「自己派一个来判自己」。
+# · `tool-goal` / `command-goal`:DSH 的 goals 服务已经被内核用作**续跑驱动器**
+#   (布防/收兵都走它);再挂上模型面的 goal 工具,模型就能自己声明目标状态——
+#   那是第二本账。ClearAI 的目标账只有一本,由内核持有,面板显示的就是它。
 # · `plan-mode`:那是 DSH 的计划模式,与本内核的 CreatePlan/AdvancePlan 是两套计划纪律。
 #   同时挂上就是第二本账。要它就得先决定哪一本是唯一账本。
+#
+# 曾经不挂、现在**挂回来了**的(阶段 5,权威边界由 test/authority-boundary.test.mjs 钉死):
+# · `tool-todo` / `tool-subagent` / `tool-workflow` / `tool-ralph`:这些是**工作方式**,
+#   产不出一条 clearai 变更。「不挂」当年防的是「自己派一个来判自己」——评估者的派遣
+#   在内核里(auditProvider),与模型面的 subagent 是两层;后者派出去的只是干活的,
+#   它的结论要进账本,只能回到主线过观测准入。

package/presets/clearai/plugins/brain.js

@@ -254,8 +254,8 @@ export function brainFingerprint(cwd) {
  *
  * `invalidate`(`registerProvider` 给的 `control.invalidate`)在**指纹真的变了**时被调用:
  * 宿主那边另有一层按「cwd + 作用域 + revision」做键的目录缓存,不 bump revision 的话,
- * 我们这边明明多了一条技能、它那边还会把旧表端出来(实测:第一回合的目录被缓存成空表,
- * 之后连模型都一直看不到 `clear/skills`——2026-09-11 的 E2E 抓到的就是这个)。
+ * 我们这边明明多了一条技能、它那边还会把旧表端出来——失效模式是第一回合的空目录被
+ * 缓存住,模型之后一直看不到 `clear/skills`。
  * 原生 filesystem provider 靠 watcher 做这件事,我们没有 watcher,就靠指纹。
  */
 export function createBrainProvider(options = {}) {