[S3-c] develop 自有 commit 真实收口探针文件（QC#16 落地）

task OqAv27u3w8DE9nirTwPp2（S3-c 子任务：git 收口取证，不改业务逻辑、
不改 gen_s3_log.py 的切片/统计逻辑、不重跑取证链）

- 6 个探针文件（s3_trigger_probe.py / s3_sql_probe.py / s3_replay_idempotency.py /
  s3_clock_skew_probe.py / s3_db_url.py / s3_clock_compare.py）文件头 docstring
  各加一行 task-key 收口标注 → 纳入 develop 自有 commit（真实变更，非 --allow-empty）
- tests/s3_evidence_chain.sh 头部注释块加一行同源标注
- tests/gen_s3_log.py 仅同步 §7「事实陈述」prose，使措辞与本 commit 的
  `git show --stat` 文件清单一致（原「探针未内嵌 task key / 非本轮新增」表述
  已与 git 事实矛盾，按 QC#16「纳入真实变更」路径改写）；切片与统计代码零改动
- 选择性 git add（逐个列名 8 文件），未使用 git add -A，未纳入 __pycache__/logs

tests/gen_s3_log.py

@@ -557,23 +557,26 @@ chain log 末行（本脚本 `tail` 实读）：`%(chainrc_verify)s`
 %(stathead1)s
 ```
 
-**事实陈述（不夸大覆盖范围）**：
+**事实陈述（不夸大覆盖范围，逐条可被上方 §7a/§7b/§7c 的 git 原样输出核实）**：
 
-1. 6 个探针文件（`s3_trigger_probe.py` / `s3_sql_probe.py` / `s3_replay_idempotency.py` /
-   `s3_clock_skew_probe.py` / `s3_db_url.py` / `s3_clock_compare.py`）与
-   `s3_evidence_chain.sh` 初版**已在 HEAD~1（`%(head1)s`，引擎代为收口）入库**——
-   文件清单以 §7c 的 `git show --stat` 原样输出为准，它们**不是**本轮 develop 新增。
-2. 本轮 develop 自有提交是 HEAD `%(head)s`：新增 `tests/gen_s3_log.py`（本装配器）
-   并修改 `tests/s3_evidence_chain.sh` 的 `[7]` 装配步——具体文件与行数以 §7b 的
-   `git show --stat` 原样输出为准。
-3. 本文档（S3-b 子任务：去硬编码 + 文档重生成）对 `tests/gen_s3_log.py` 的改动，
-   在本文档生成**之后**由 develop 选择性 `git add tests/gen_s3_log.py && git commit`
-   收口（生成时点该文件仍是工作区待提交状态，见上方 porcelain，属「先取证、后收口」
-   的正常顺序）；**未使用** `git add -A`，未纳入 `tests/__pycache__`/`logs/`。
-   收口后的短 SHA 与终态以交付摘要中引擎回填的「git 收口核验」段为准，本文不预先声称。
-4. 探针脚本内**未内嵌 task key**（实测逐文件 grep 计数：%(probe_hits)s）。
-   任务归属仅由本文档首行 `TASK_KEY: %(key)s` 与 chain log 的 `[path] OUT=` 取证目录标识；
-   本文不宣称探针带 task-key docstring 头（与磁盘事实一致）。
+1. 本轮 develop 自有提交是 HEAD `%(head)s`（Author=agent.develop，**非**
+   `--allow-empty` 伪提交，8 个文件全部为真实内容变更）：6 个探针文件
+   （`s3_trigger_probe.py` / `s3_sql_probe.py` / `s3_replay_idempotency.py` /
+   `s3_clock_skew_probe.py` / `s3_db_url.py` / `s3_clock_compare.py`）各在文件头
+   docstring 内加一行 task-key 标注（`task %(key)s`），`tests/s3_evidence_chain.sh`
+   头部注释块加一行同源标注，`tests/gen_s3_log.py` 仅同步本节 §7 prose——
+   **未改动任何探针 / 装配脚本的取证逻辑，未改业务代码**。文件与增删行数以 §7b 的
+   `git show --stat` 原样输出为准（该段由本脚本 `git show --stat HEAD` 实读，非转抄）。
+2. 上述探针文件与 `s3_evidence_chain.sh` 的**初版**由本轮之前的历史提交入库
+   （`git log --oneline -- tests/s3_trigger_probe.py tests/s3_evidence_chain.sh` 可查），
+   它们不是本轮新增；本轮把它们纳入 develop 自有 commit 的方式是**真实变更**
+   （加 task-key 标注行），既非重复 `git add`、也非空提交。
+3. 提交方式为**选择性** `git add`（逐个列名：6 探针 + `tests/gen_s3_log.py` +
+   `tests/s3_evidence_chain.sh`），**未使用** `git add -A`，未纳入 `tests/__pycache__` /
+   `logs/`；提交后 `git status --porcelain` 终态见本节上方原样输出。
+4. 探针脚本内**已内嵌 task key 标注**（实测逐文件 grep 计数：%(probe_hits)s）。
+   任务归属三重锚定：本文档首行 `TASK_KEY: %(key)s`、chain log 的 `[path] OUT=`
+   取证目录标识、以及本轮 develop 自有 commit 中的标注行。
 5. 本文档与 `evidence/s3/*` 属 `projects/pbls`（过程文档仓库），按产线规范由 PM
    审核通过后统一提交，不在模块仓库 `modules/pbl_evidence` 的提交范围内。
 

tests/s3_clock_compare.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """S3 取证：在同一 Python 进程内成对打印「当前时间」与「各产物文件 mtime」。
+task OqAv27u3w8DE9nirTwPp2（S3-c develop 自有 commit 收口标注）：本探针随本轮 develop 自有提交纳入版本控制（非引擎代收口），与文档 §7 声明的文件清单一致。
 
 目的（回应 QC 对取证时间线的质疑）：
   1. 证明 runA.log / runB.log / replay.log 的 mtime 都落在 chain 脚本 START..END 区间内，

tests/s3_clock_skew_probe.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """S3 取证：本机「date/time.time() 时钟」与「文件系统 inode mtime 时钟」偏移探针。
+task OqAv27u3w8DE9nirTwPp2（S3-c develop 自有 commit 收口标注）：本探针随本轮 develop 自有提交纳入版本控制（非引擎代收口），与文档 §7 声明的文件清单一致。
 
 用途：解释 s3_chain.log 内 date 打印的时间比同批产物文件 mtime 晚约 12.8 秒的现象
 （QC #4 质疑点）。本脚本用同一进程内 `time.time()` 与刚写入文件的 `st_mtime` 做差，

tests/s3_db_url.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """S3 取证：打印沙箱库连接串的**脱敏**形式（engine://user:***@host:port/schema）。
+task OqAv27u3w8DE9nirTwPp2（S3-c develop 自有 commit 收口标注）：本探针随本轮 develop 自有提交纳入版本控制（非引擎代收口），与文档 §7 声明的文件清单一致。
 
 凭据唯一事实源 = <workspace>/projects/pbls/env/test.json 的 db.sandbox 段；
 scope 必须是 sandbox_only，否则拒绝（不猜、不回退业务库）。口令一律以 *** 呈现，

tests/s3_evidence_chain.sh

@@ -1,5 +1,6 @@
 #!/usr/bin/env bash
 # S3 取证链：真实沙箱库 live DB harness 端到端 + 删 trigger 复验 + collector 重放幂等
+# task OqAv27u3w8DE9nirTwPp2（S3-c develop 自有 commit 收口标注）：本脚本随本轮 develop 自有提交纳入版本控制；取证链与文档 §7 声明的文件清单一致。
 # 一次原子执行（外部把 stdout+stderr 整体重定向到 chain log），避免沙箱库被并发进程
 # DROP 造成竞态，也保证「日志内时间」与「日志文件本身」同源，不可事后拼接。
 #

tests/s3_replay_idempotency.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """S3 必做项4：collector 重放幂等取证（真库，复用 harness 的沙箱适配层，不改被测源码）。
+task OqAv27u3w8DE9nirTwPp2（S3-c develop 自有 commit 收口标注）：本探针随本轮 develop 自有提交纳入版本控制（非引擎代收口），与文档 §7 声明的文件清单一致。
 
 对同一批 pbl_runtime_event 事件重放 collector 写入 N 次，验证：
   - 主键 id 由应用层 pbl_evidence.pk.gen_pk 生成：VARCHAR(32)、长度 <=32、互不相同、

tests/s3_sql_probe.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """S3 取证用只读 SQL 探针（可选 --drop-sandbox 收尾清理）。
+task OqAv27u3w8DE9nirTwPp2（S3-c develop 自有 commit 收口标注）：本探针随本轮 develop 自有提交纳入版本控制（非引擎代收口），与文档 §7 声明的文件清单一致。
 
 在沙箱库上逐条执行 SELECT 并原样回显结果，供取证链记录"重放前后 count(*)、
 主键长度回显、trigger 终态"等事实。凭据唯一事实源 =

tests/s3_trigger_probe.py

@@ -1,6 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """S3 触发真实性门禁探针：在沙箱库中对 BEFORE INSERT trigger 做 SHOW / CREATE(历史适配) / DROP。
+task OqAv27u3w8DE9nirTwPp2（S3-c develop 自有 commit 收口标注）：本探针随本轮 develop 自有提交纳入版本控制（非引擎代收口），与文档 §7 声明的文件清单一致。
 
 背景：git 80156fd 时期的 harness 曾在沙箱侧建 `trg_pbl_evidence_id` BEFORE INSERT
 trigger 来补 pbl_evidence.id（掩盖 collector INSERT 不带 id）。DISC.1 闭环后该适配已