W3-F1: 飞书多维表格投影——factory-floor 每行一卡+同步器+调用账本

[randypanding]

父意图: #402 | Spec: specs/IR-0006/spec.md v1 | 波次: W3 | 依赖: W1 退出判据（与 W2 可并行）

任务

飞书多维表格投影：factory-floor 每行一卡（IFACE-04 字段：卡 ID/状态/AC 进度/关卡状态/认领者/停留时长/谓词状态）；同步器周期 ≤15min（BEH-06，同 butler-ledger 节奏）；飞书 API 调用账本。label 唯一真源（INV-05）。

AC（Given-When-Then）

• AC-7a (spec): Given label 为唯一真源，When 同步器周期运行（≤15min），Then 多维表格字段与 GitHub label 态一致（与 org Project factory-floor 字段同源，宪法 §12 投影一）；飞书 API 调用记录进账本。
• AC-7b (api): Given 投影为物化视图，When 投影故障，Then 不影响 GitHub 判定链（投影可整体停用降级回 GitHub dashboard，fail-open 仅投影面）。

blastRadius（预测）

CI-Workflows: pipeline/（飞书同步器）; 云内网: 飞书凭证（Vault 引用）

[randypanding]

/claim

[randypanding]

/claim

[randypanding]

W3-F1 实现落地（代码面完成；真实演练待凭据）

• PR feat: 飞书多维表格投影——同步器+演练面+统一账本第 6 源（IR-0006 W3-F1 / ADR-0103 决策 7） #447（已合并 67a0c2b）：feishu-sync.py（plan_sync 纯函数/幂等建表/批量写/AC-7a 调用计数/--verify/--drop/停用守卫）+ butler-ledger 15min 守卫（fail-open AC-7b）+ feishu-drill.yml 演练面 + evidence-query 第 6 源 + 离线测试 19 断言（双桩 e2e 含漂移纠正/孤儿删除/单轮重建）
• PR fix: feishu-drill 首建 feishu-ledger 前先建目录（W3-F1 实测缺陷） #448 / fix: feishu-drill 账本 add 加 -f（W3-F1 实测缺陷之二） #449（已合并）：首建 feishu-ledger 两处实测缺陷修复（目录创世/add -f）
• CI 演练 run 33253168482（sync 模式）：全绿——凭据缺席=skipped not-provisioned（过渡期合法），影子 relink 创世 feishu-ledger 分支（链验通过）
• 统一账本第 6 源实测：bash governance/evidence-query.sh 已返回 source:feishu 记录（subject=W3-F1: 飞书多维表格投影——factory-floor 每行一卡+同步器+调用账本 #416）

剩余（需 owner 人工）：创建飞书自建应用（多维表格读写权限）+ 新建 bitable 拿 app_token → org secrets 注入 FEISHU_APP_ID / FEISHU_APP_SECRET / FEISHU_BITABLE_APP_TOKEN（INV-04：key 只进 org secret，agent 零接触）。配齐后 15min 轮自动生效，届时手动 dispatch feishu-drill（rebuild 模式）补 AC-7 运行时证据（rebuild 演练日志+纠正实测+调用账本）即可 state:done。

[randypanding]

W3-F1 飞书投影 AC-7 运行时证据（全链真实实测）

owner 已配齐飞书自建应用凭据（org secrets：FEISHU_APP_ID/FEISHU_APP_SECRET/FEISHU_BITABLE_APP_TOKEN，INV-04——agent 上下文零持久凭据）。多维表格：https://acntugfsa2bn.feishu.cn/base/PZgSbjGECam5EusLIckcTBXUnTe

AC-7a 字段一致 + 调用账本

• 首轮全量投影 run 33253591320：30 张活跃卡 → 30 行（卡 ID/State/仓/认领者/卡号/停留天数/AC 进度/关卡状态/谓词状态=IFACE-04 全字段），api_calls=5 端点计数入 AUDIT 行
• --verify 收敛 run 33253879920 / 33254412984：只读对账 exit 0（投影与 label 态零差异）
• 调用账本可查：feishu-ledger 分支 9 条链式影子事件（payload 带 api_calls 明细）+ evidence-query 第 6 源实查

整表删除后单轮重建（字段一致）

• rebuild run 33253934780：--drop 删表→单轮重建 30 行（api_calls=6，含 DELETE tables）
• 重建后 --verify run 33253986814：exit 0——重建保真度实证

INV-05 漂移纠正（label 为准并告警）

• 人工篡改 W3-F1: 飞书多维表格投影——factory-floor 每行一卡+同步器+调用账本 #416 State→done（API 模拟人工改动）→ sync run 33254361404：WARN feishu-drift .github#416: State 表='done' label 期望='in-progress' + batch_update 纠正写回 + drift_alarms=1 入审计 → 飞书表实际值已被纠正回 in-progress（label 唯一真源实证）

AC-7b fail-open

• 过渡期 skipped（run 33253168482）/停用守卫/投影故障不阻塞（离线测试+butler-ledger 守卫形态）

过程实测缺陷（已修，PR #450/#451）

• 飞书 list records 数字字段以字符串回（"425"）→ _eq 数值归一
• batch_update/batch_delete 只认 POST（PUT 400 拒）→ 方法修正+测试桩对齐

W3-F1 全部完成，state:done。

[randypanding]

关闭（收尾清理）：本卡 state:done（T8 谓词由 conductor 机器判定：绑定 PR 已合并+标签生效），产物已落 main。按仓库惯例关闭已完结卡片（先例：#414 / #408 / #407 / #358 / #351 等）。