feat(contracts): PlanStep.humanWrites —— 人填的表模型不许写;还欠一张卡的那一步不摆 doneWhen

柴浩实测单 6ddcecf8(连撞五拍熔断):P-10 资料记录的标题 / 版本 / 链接与台账里 `LM2596S-5.0` 那一行
**逐字相同** —— 不是幻觉,是「手边有一行看着对的就拿来用」(那一步 reads 摊开了 `parts.document`,
视野里唯一一份真资料就是原 PN 的)。行找对了、料找错了,而这份假证据会直接喂进差异比对当「硬约束有证据支持」。
三层合谋:①把 P-08 的回卡认成 P-10 的(P-10 的卡从没发过);②08-27 给这一步加的 doneWhen 把
「资料必填不缺」摆成目标、后面还跟「成立了就 finish」,**与同一份提示词里「唯一合法的动作是先发那一张卡」
直接打架**;③它顺手把 `exists_status` 改成 created,按剧本发卡名单自己空了 —— 一个合法动作都不剩。

止血两刀:
①**`PlanStep.humanWrites`**(契约,可选字段、老活动一个字不用改):声明的台账 `write` 当场拒并指路
  「去发那张卡,值由人填」;`drop` 不拦(写错了得撤得掉)。判法认点名的项,点不出退回当下在办的那一步
  (压拍时骨架写在上一步名下正好放行)。**只声明「模型永远没有来源」的表** —— 有附件时该预填的
  (P-08 的参数值从 datasheet 抽)别声明,那是它的活。
②**还欠一张卡的那一步不摆 doneWhen** —— 判据同时是摆在模型眼前的目标,而它此刻只许发卡。

W05@1.6.5 声明 `humanWrites: ['parts.document']` 并从 writes 去掉。4 测(墙 / 放行 / drop / 声明)。
**一个闲着的模型 + 一个它够得着的判据 = 它一定会去凑那个判据。**
契约变更四步:depcruise 反查下游绿、loop-engine CONTRACT.md 同步、api-report 随本提交入库、
可选字段非破坏性。

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

activities/part-substitution-assessment/__tests__/steps.test.ts

@@ -260,6 +260,22 @@ describe('说明书与剧本的骨架', () => {
     for (const step of ASSESSMENT_STEPS) expect(step.guide, step.item).not.toMatch(disableCallPattern);
   });
 
+  /*
+   * 2026-08-28 用户实测:模型把台账里原 PN 那一行的规格书(标题/版本/链接逐字)抄到了候选料号头上。
+   * 那三格只可能从人那儿来 —— 声明归人填,模型 write 当场被拒。
+   */
+  it('P-10 的资料记录归人填:humanWrites 声明了 parts.document,writes 里不再有它,剧本也写明「你写不进去」', () => {
+    const p10 = ASSESSMENT_STEPS.find((s) => s.item === 'S0d_p10_document');
+    expect(p10?.humanWrites).toEqual(['parts.document']);
+    expect(p10?.writes).not.toContain('parts.document');
+    expect(p10?.guide).toMatch(/由人在件上填,你写不进去/);
+    expect(p10?.guide).toMatch(/别拿原 PN 或别的料号的规格书顶上/);
+    // 骨架仍由上一步铺(P-08 那步要写 parts.document)
+    const p08 = ASSESSMENT_STEPS.find((s) => s.item === 'S0d_p08_master');
+    expect(p08?.writes).toContain('parts.document');
+    expect(p08?.humanWrites ?? []).toEqual([]);
+  });
+
   it('S0d 拆成两项各自绑自己的 view(P-10 那份件不会永远推不出来)', () => {
     const p08 = ASSESSMENT_STEPS.find((s) => s.item === 'S0d_p08_master');
     const p10 = ASSESSMENT_STEPS.find((s) => s.item === 'S0d_p10_document');

activities/part-substitution-assessment/src/case-model.ts

@@ -436,15 +436,26 @@ current_stage = "assessing"。application_scenario / bom_position **这一步不
     /* 这一步派的是数据工单 —— 由剧本声明,模型抄不抄 variant 都一样(2026-08-27 实测它丢了) */
     cardVariant: 'data' as const,
     intent: '料号不在库:派 P-10 数据工单让人从零建原厂技术资料',
-    writes: ['parts.document', `${D}.pn_check`],
+    /* parts.document 归人填(见下面 humanWrites)—— 这一步只改核对表的旗 */
+    writes: [`${D}.pn_check`],
     reads: [`${D}.pn_check`, 'parts.profile', 'parts.document'],
     view: 'p10-document-create',
     tools: [],
+    /*
+     * **资料记录归人填**(2026-08-28 用户实测):标题 / 版本 / 链接只可能从人那儿来 ——
+     * 模型手边唯一「像样」的资料就是台账里原 PN 那一行,实测它逐字抄了过来安在候选头上,
+     * 而这份假证据会直接喂进差异比对当「硬约束有证据支持」。骨架(键 + 类型 + 状态)
+     * 上一步 S0d_p08_master 已经铺好,这一步不需要写它;写就当场拒,drop 仍可撤。
+     */
+    humanWrites: ['parts.document'],
     /* 人工激活:发卡就算启动。doneWhen 同 P-08 的道理:人答过卡之后,建过的每颗料都有一行资料记录且必填不缺 → 引擎自己收 */
     doneWhen: `parts_document_rows > 0 and parts_document_rows >= parts_profile_rows and parts_document_missing = 0`,
     guide: `这一项只在 \`${D}.pn_check\` 里有 absent 行时走(要走到这一步,S0d_p08_master 已经收完 —— 引擎按入库事实自己收);都在库时入场前提本就不成立,
 这一项与 S0d_p08_master 都不会进你的「当下可为」。
 
+**资料记录那三格(标题 / 版本 / 文件链接)由人在件上填,你写不进去**(写了当场拒)——
+别拿原 PN 或别的料号的规格书顶上:那是另一颗料的资料,后面会被当成这颗料的证据用。骨架上一步已经铺好了。
+
 【发 P-10 数据工单】「建」的名单就是 \`${D}.pn_check\` 里仍是 exists_status = "absent" 的那几行(候选总数 ≥2 时被放弃的那些,
 S0d_p08_master 那一步已经把它们改成 "abandoned",不在这份名单里)。同一拍照说明书④发那张 P-10 数据工单(title 里列全料号,只发一次),
 发完这一拍结束(挂起)。

activities/part-substitution-assessment/src/manifest.ts

@@ -90,7 +90,7 @@ export const manifest: ActivityManifest = {
   identity: {
     activityId: ACTIVITY_ID,
     name: 'ACT-WORK-05 · 差异评估',
-    packageVersion: '1.6.4',
+    packageVersion: '1.6.5',
     category: '需求分析与方案匹配',
     sdkVersion: '0.1.0-m5',
     checksum: 'dev-checksum-part-substitution-assessment',