E04 修到零被拒线,harness 补七刀:跨进程租约与广播桥、原子写、引用墙、对话区按序号排

活动侧(E04 2.1.0 → 2.1.9,I01 1.2.2):
- 覆盖闭合成为机检:基座新增 distinct 读数,「计划盖住的客户数 = 候选行数」钉进
  S3 收步 / S4 哨兵 / 放行 L2;人加的候选客户不再被整单无视
- 「关键人待识别」占位句式全链退役:查无联系人先发数据录入卡收人;契约新增 refersTo,
  计划/回执的 contact_code 只许引用真实存在的联系人(安装期核引用目标)
- 台账更新确认摆全落库面:客户档案/联系人档案两张落库预览(touched: 数据源,
  正式现值 + 草稿叠加),可补改、可加行(自增主键由基座续号);姓名升必填
- 更新明细:update_key 位置键 + 「同一处只留一条」L2;依据写人话不带机器键;
  标题旁不摆单号;判据与文案不夹字段名;行标识去掉单标识那一段
- 回执骨架 = 计划行数钉进 S3 收步与 S4 哨兵;重做分支不许删计划凑数
- 阶段刻度对齐文档 7 步;起单样例预填满

基座侧:
- 两个后端连同一个库:task-claim 跨进程租约(迁移 0030)+ Postgres LISTEN/NOTIFY
  广播桥;对话区按任务内记忆序号排,不按墙上时钟;并卡「刚说过话」按记忆序列判紧邻
- 多行 write 整批先验后写(dryRun),被拒 = 一行都没落
- 决策卡意见与本单草稿字面比对,归属以观察进轨迹(note-anchors)
- 括号栈补「补闭括号」两形(少一个 } / 行对象没关直接跟下一行)
- 件上加行:空着的自增主键直进续号,不从别的行借号;未落下的行点名回给前端
- 人答复落库那一刻就把 runtime 翻 running(task.wake),两块同帧变脸
- 试跑单可落真库(land_master,迁移 0031,默认开);数据域按活动分组;
  JSON 列不再是 [object Object];按钮键感 + 在办进度条 + 防抖
- 报价链 A1–A7 从系统卸载(只卸不删源码),种子只装 E04/I01

契约变更(api-report 已刷新):FieldDeclaration.distinct / refersTo,
objectDeclaration.file,landMaster,unkeyed,assetFiles,ledgerByActivityRoute。
1700 测 / typecheck / lint / depcruise / api:check 绿。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EEJX8Z7CHejvwmDQyPQuBX

packages/contracts/src/api/governance.ts

@@ -606,6 +606,64 @@ export const listLedgerObjectsRoute = {
   }),
 } as const satisfies RouteContract;
 
+/**
+ * **按活动看数据域**(2026-08-24 用户定:「按活动数据来分类,要让每个活动执行完成后
+ * 台账在这里看到变化」)。
+ *
+ * 从前这一屏按**性质**(主数据/单据/派生)分组 —— 那是给「治理这张表」的人用的分法,
+ * 回答的是「这个对象定义全不全」。而人跑完一单来这儿,问的是另一件事:
+ * **我这个活动写了哪几张表,现在各有几行,刚才那一单落下了什么**。
+ * 按活动分组、带上行数,那个问题才答得了。
+ *
+ * 三个数各有各的意思,不能混:
+ *   · `rows` —— 正式表里现在有几行(过了放行门的事实);
+ *   · `drafts` —— 还在某一单草稿层的几行(**在办中,放行才进正式表**);
+ *   · `recent` —— 这个活动最近几单,让人认出「刚跑完的那一单」。
+ */
+export const ledgerByActivityRoute = {
+  method: 'GET',
+  path: '/api/gov/data/by-activity',
+  output: z.object({
+    activities: z.array(
+      z.object({
+        activityId: z.string(),
+        name: z.string(),
+        version: z.string().optional(),
+        tables: z.array(
+          z.object({
+            domain: z.string(),
+            object: z.string(),
+            label: z.string().optional(),
+            kind: z.string().optional(),
+            caseKey: z.string().optional(),
+            primaryKey: z.array(z.string()),
+            /** 正式表行数;表还没物化(活动声明了但一次都没写过)时缺席 */
+            rows: z.number().int().optional(),
+            /** 还在草稿层的行数(在办中的单写下的) */
+            drafts: z.number().int(),
+            /** 草稿层最近一次落笔的时刻 —— 在办中才有 */
+            draftAt: z.string().optional(),
+          }),
+        ),
+        /** 这个活动最近几单 —— 「刚跑完那一单」在这儿认得出来 */
+        recent: z.array(
+          z.object({
+            id: z.string(),
+            title: z.string(),
+            runtime: z.string(),
+            terminal: z.string().optional(),
+            at: z.string(),
+          }),
+        ),
+      }),
+    ),
+    /** 库里有表、却没有哪个在装的活动声明它 —— 多半是退役活动留下的空壳 */
+    unclaimed: z.array(
+      z.object({ domain: z.string(), object: z.string(), label: z.string().optional(), rows: z.number().int().optional() }),
+    ),
+  }),
+} as const satisfies RouteContract;
+
 export const browseLedgerRoute = {
   method: 'GET',
   path: '/api/gov/data/:domain/:object',
@@ -777,6 +835,20 @@ export const testRunActivityRoute = {
     message: z.string().default(''),
     /** 派给谁;留空 = 操作者自己(试跑不该派到别人工作台上) */
     ownerId: z.string().default(''),
+    /**
+     * **连主数据一起落真库** —— 默认 `true`(2026-08-24 用户定:「那你就默认给它打开」)。
+     *
+     * 从前主数据一律挡在活动缓存里,理由是保护样例:试跑往 `customer.profile` 建一位客户,
+     * 那位客户就永久留在库里,「新客户来函」那条样例第二次跑就成了老客户。
+     * 可实际用起来,这条保护挡住的恰恰是人要看的东西 —— E04 的台账更新明细白纸黑字写着
+     * 「亲密度 3 → 10」,而 `customer.contact` 里还是 3:**单据说改了、主数据没改**,
+     * 两份事实对不上,谁看谁糊涂。跑一遍活动就该看见数据真的变了,这是本分。
+     *
+     * 保护没有取消,只是**换了个落点**:要它的那个调用方自己关
+     * (`tools/e2e-a2.mjs` 显式传 `false` —— 只能测一次的样例归它管)。
+     * 默认值服务于人手点的那条路;脚本要什么,脚本自己说。
+     */
+    landMaster: z.boolean().default(true),
   }),
   output: z.object({ taskId: z.string(), title: z.string() }),
 } as const satisfies RouteContract;
@@ -1078,6 +1150,7 @@ export type GovActivitiesOutput = z.infer<typeof listActivitiesRoute.output>;
 export type GovToolsOutput = z.infer<typeof listToolsRoute.output>;
 export type GovObjectsOutput = z.infer<typeof listLedgerObjectsRoute.output>;
 export type GovLedgerPageOutput = z.infer<typeof browseLedgerRoute.output>;
+export type GovLedgerByActivityOutput = z.infer<typeof ledgerByActivityRoute.output>;
 export type GovMemoryOutput = z.infer<typeof listActivityMemoryRoute.output>;
 export type GovMetricsOutput = z.infer<typeof govMetricsRoute.output>;
 export type GovChannelsOutput = z.infer<typeof listChannelsRoute.output>;

packages/contracts/src/api/workbench.ts

@@ -317,7 +317,22 @@ export const saveTableRoute = {
      */
     drops: z.record(z.string(), z.array(z.record(z.string(), z.string()))).optional(),
   }),
-  output: z.object({ ok: z.boolean(), rows: z.number().int().min(0) }),
+  output: z.object({
+    ok: z.boolean(),
+    rows: z.number().int().min(0),
+    /**
+     * **认不出是哪一行、因而没落下的那几行**(2026-08-24 用户实测:
+     * 「用编辑新增了一个客户,推进到下一步直接就把我手动添加的这一行遗漏掉了」)。
+     *
+     * 主键那几格空着就凑不出钥匙,存不住。从前基座一句 `continue` 悄悄跳过、
+     * 接口照回 `{ok:true}` —— 人看到「保存成功」,东西却不在。
+     * 仍回 200(别的格子是真落下了),但把没落下的行摆回来:前端红字点名,
+     * 人补上钥匙再存一次。**保存说成功,就得真的都存下了。**
+     */
+    unkeyed: z
+      .array(z.object({ address: z.string(), keys: z.array(z.string()), hint: z.string() }))
+      .optional(),
+  }),
 } as const satisfies RouteContract;
 
 /**

packages/contracts/src/ledger.ts

@@ -139,6 +139,29 @@ export const fieldDeclarationSchema = z.object({
    * 提交闸 / 件上红带全部同源生效;`required` 不带它照旧整列必填。
    */
   requiredWhen: z.object({ column: z.string().min(1), value: z.string().min(1) }).optional(),
+  /**
+   * **这一列有几个不同的值,也让基座数** —— 出读数 `域_对象_distinct_<列>`
+   * (只数本单写下的行,空值不算一种)。
+   *
+   * 为什么要有这一维(2026-08-24 柴浩实测):覆盖范围确认那张卡上人加了一家客户,
+   * 行落进了台账,而 S3 的收步判据只数「计划有没有」(`plan_rows > 0`)——
+   * 计划盖住一家还是两家,没有任何一个基座数说得出来,模型照它记忆里的
+   * 「1 家候选」办完,引擎自动收步、放行门一路绿灯,**人加的那家从头到尾被无视**。
+   * 「每家候选客户都进了计划」要成为机检,就得有「计划里有几家客户」这个数,
+   * 而它必须由基座数(计划行数 ≠ 客户数:一家客户几位关键人就几行)。
+   */
+  distinct: z.boolean().optional(),
+  /**
+   * **这一列只许引用另一张表里已存在的值** —— `'域.对象.列'`(2026-08-24,E04 首用)。
+   *
+   * 起因:经营计划的 contact_code 本该指向真实联系人,而模型三次给缺口节点
+   * **自造顺延引用码 + 占位人名**(「关键人待识别」)—— 措辞写到头也拦不住
+   * (占位句式一入过提示词就会被泛化)。措辞治不了的结构治:声明引用关系,
+   * 基座在 `draftWrite` 那一刻查引用的表(正式 + 本单草稿叠加),查无此值当场拒,
+   * 拒回指路(要经营的人还不存在 → 先发数据录入卡收人)。
+   * 引用目标必须是本活动声明过的对象与列 —— 安装静态审拦住写错的地址。
+   */
+  refersTo: z.string().regex(/^[\w-]+\.[\w-]+\.[\w-]+$/).optional(),
 });
 export type FieldDeclaration = z.infer<typeof fieldDeclarationSchema>;
 

packages/contracts/src/manifest.ts

@@ -279,6 +279,8 @@ export const staticAuditFindingSchema = z.object({
     'acceptance-predicate-unbound',
     'deliverable-address-unbound',
     'ledger-kind-invalid',
+    // refersTo 指向没声明的表/列 —— 引用检查会成「永远查无此值」的死墙(2026-08-24)
+    'reference-target-unbound',
   ]),
   severity: z.enum(['error', 'warn']),
   message: z.string(),