资料文件真产出来了;E04/I01 补到验收线,顺手填了几个「墙拦住却不给路」的坑

**资料文件全链**(用户:审核资料这一步要真产出 word/excel/md/html,前端能渲、点资料名能开)
接手时这一步一个文件都产不出来 —— S3 剧本白纸黑字写着「file_ref 本 MVP 阶段可留空」。
文件是台账那一行的投影,不另存一份:
· 声明 `file:{titleColumn,bodyColumn,formatColumn}`,它同时是授权面(没声明就点不开)
· 现造真字节 —— docx/xlsx 是自己打的 OOXML 包(zip-write:store+CRC32,零依赖)
· 读回来渲 —— 解的就是造出来那份字节,渲得出来才证明文件是真的
· 件上 `data-file-of` → 工作区二级界面(Word 纸面/Excel 网格/渲好的 md/沙箱 html)+ 下载原件
放行落地前把每一份冻进 `sys.task_asset_file`(迁移 0029):归档件点开的必须是签字那一刻
那一份,而资料落在主数据上、试跑单不落正式表 —— 不存这一份,收工后一个都点不开。
工作成果里「产出的资料」自成一摞。Markdown 富文本渲染顺带销账(仍零依赖)。

**Harness**
· 画面按「这一拍办完之后」在办的那一步挑 —— 从前拿拍首的局面决定拍尾的事:
  收掉 S4、发出 S5 的卡,而屏上还摆着 S4 的只读件,人无处可填(墙要配路第四次现形)
· 验收「重做」真能退回重做,且打回后台账没动就不许再提交(软硬两段,不锁死单子)
· 立监听的授权面是清单声明;发卡的授权面是调人预算,不是计划项
· 读工具同参重调有兜底;空转写身后还有行动就不废串;finish 的 doneWhen 按写完后的草稿算

**界面**
· 翻件与翻页各归各位(从前二选一,多卡多页时页翻不动);没得翻写「—」不写 0/0
· 工作成果详情能翻份;表宽超出能横滑(E04/I01 抄版式时把 overflow-x 抄丢了)
· 查看面灰底滚过一屏变白 —— 两条独立的路都治了(沙箱内不同色 / 弹性子项不长个)
· 测试台「取不到」不再当成「还活着」

**活动**
E04 关系覆盖、I01 品牌内容各自补到验收线:判据全读基座数、判据指向的东西摆上卡面、
样例满载且名字 ≤14 字;提交前要裁的判据搬进说明书(模型会压拍,压过之后只有说明书还在)。

验收:e2e i01 4/4、e04 3/3 全部 released,资料在办中渲得出、放行后存了档点得开;
门禁 typecheck/lint/depcruise/1628 测全绿。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EEJX8Z7CHejvwmDQyPQuBX

api-report/apps/api/src/modules/loop-engine/port.d.ts

@@ -154,11 +154,18 @@ export type ToolGateway = {
 };
 /**
  * 在途验收(提交放行的持久痕):卡发出即记,裁决到达再记 verdict ——
- * 判齐重入不再发第二张卡;恢复的那一拍据 verdict 定终局(released 与否)。
+ * 判齐重入不再发第二张卡。恢复的那一拍按 verdict 分岔:
+ * `pass` 才是终局(released);**非 pass = 打回重做,不是终局** ——
+ * 意见(comment)用人话进轨迹、在途验收清掉,同一拍照常问模型,
+ * 模型改完重新提交,新发的验收卡才是下一次裁决的对象(2026-08-22,
+ * 从前非 pass 只把任务重新挂成 awaiting-human,人说了「重做」却再没有
+ * 任何事件叫醒它,一单就此卡死 —— 柴浩实测)。
  */
 export type PendingAcceptance = {
     readonly acceptanceCardId: string;
     readonly verdict?: 'pass' | 'reject';
+    /** 打回重做时人写的意见 —— 空着就是点了固定按钮没写话 */
+    readonly comment?: string;
     readonly selectedPorts?: Record<string, string>;
 };
 export type CardGateway = {
@@ -264,6 +271,18 @@ export type ListenerRegistrar = {
     }): Promise<{
         id: string;
     }>;
+    /**
+     * **这个活动声明过哪几种监听** —— 立监听的授权面(2026-08-23 加)。
+     *
+     * 与「写的授权面是台账声明」「调工具的授权面是白名单」同一条:没声明过的监听立不得。
+     * 起因是实测的一次永久挂起(E04):模型在依赖断点上临场立了个 data 监听等回执,
+     * 而那个活动 `declarations.listeners` 是空的、这一单也不会有任何 data 事件进来 ——
+     * 单子就此挂在 `awaiting-event` 一动不动。**立了没人叫醒的监听不是等待,是失联。**
+     */
+    declared(taskId: TaskId): Promise<ReadonlyArray<{
+        eventType: string;
+        keyFilter: Record<string, string>;
+    }>>;
 };
 /**
  * 视图流控 —— app 注入 `interaction`(L3)。