# 项目级声明式 Shared Content Publisher V1 实现交付

## 1. 事项与边界

- task：`TASK-AGRICULTURE-PESTICIDE-FERTILIZER-20260818-001`
- case / batch / run：`ANA-AGRICULTURE-PESTICIDE-FERTILIZER-20260818-001 / BATCH-004 / RUN-ANA-AGRICULTURE-PESTICIDE-FERTILIZER-20260818-001-BATCH-004-001`
- implementation authority：`HANDOFF-INFOADMIN-LAOYANCAI-AGRICULTURE-BATCH004-SHARED-PUBLISHER-CONSOLIDATED-SUCCESSOR-20260821-001`
- fixed review request：`HANDOFF-DEV-LAOYAN-LAOSHEN-AGRICULTURE-BATCH004-SHARED-PUBLISHER-CONSOLIDATED-IMPLEMENTATION-REVIEW-20260821-001`
- owner / reviewer：`dev.developer.ana.cai / dev.reviewer.ana.cai`

本交付只实现项目级、版本化、声明式共享 publisher 及其生产形态隔离测试；没有生成真实 BATCH-004 config，没有创建 attempt、lock、receipt 或 ledger row，也没有调用生产 publisher。农业内容、candidate、current、promotion ledger、Repair007/Repair008 和失败历史均保持不变。

## 2. 实现对象

| 对象 | bytes | SHA-256 |
|---|---:|---|
| `dev/ana-dev/shared_content_publisher/publisher.py` | 44329 | `99C90DC15603DCFA1CB695C3A573EE4AA88D9B2594E4FF46750D6E6503EEEC62` |
| `dev/ana-dev/shared_content_publisher/batch_config.schema.json` | 7078 | `73DECA1A7420E139692A2B0C91812C0CC90B78900816DCE36C6DD0B6DBBA0225` |
| `dev/ana-dev/shared_content_publisher/README.md` | 1382 | `8B0E525019E712A50CEE0698CA3F5AE371D3EAC1D6517D5E2EBE220300FBE701` |
| `dev/ana-dev/shared_content_publisher/__init__.py` | 168 | `9E83FAEF6958A15DE89A35691AEFA0860E881DAAB7E06378AABC0A693956CCFD` |
| `dev/ana-dev/shared_content_publisher/__main__.py` | 86 | `DC3EA832B1DE49CBBE2EF61241524DB0751C9AB48FA2D42A49D58E01DB80B773` |
| `dev/ana-dev/test/test_shared_content_publisher_v1.py` | 17414 | `3C56F448F22E4E6CB6FA7D22F866B14EB0603F16A6F5AF8BFFC9AA22E5A96E05` |

公共入口：

```text
python -m shared_content_publisher --config <batch-config.json> --validate-only
python -m shared_content_publisher --config <batch-config.json>
```

生产和测试使用相同 schema、相同 validator 和相同 publisher 入口；没有 batch-specific wrapper、私有 reader 或内存替身。

## 3. 声明式配置与三项 blocker 闭环

### 3.1 单一配置来源

严格配置仅有六个顶层字段：`schema_version / identity / roots / expected / commit / test_control`。所有 task、case、batch、run、attempt、release、candidate set、根、卷、路径、ledger、prior、history、current state、candidate rows、link/evidence anchor 和提交目标均来自这一配置。缺失、额外、重复 key、类型错误、路径逃逸、reparse、对象类型或 identity 漂移均在 exclusive lock 之前失败关闭。

### 3.2 Blocker 1：attempt2 runtime 未冻结

publisher 源码和 schema 不含 `ATTEMPT-B004-000001`、`ATTEMPT-B004-000002`、农业或 BATCH-004 字面量。attempt、reader checks、receipt、lock、snapshot、ledger/ref 和 target identity 都从 config 派生。因此下一真实 attempt 使用新的 config 即可，不再复制 batch-specific runtime。

### 3.3 Blocker 2：prior ledger 与 attempt sequence 不匹配

publisher 先校验 ledger 精确 bytes/SHA、固定 17 列表头、全局 event sequence 唯一性和 preserved prior terminal；再从真实 ledger 推导 `next_event_seq` 与同 task/case/batch/run 的 `next_attempt_seq`，并与 config 声明交叉验证。旧 `8EED...` ledger、sequence 1、bytes/SHA 漂移或 prior terminal 不一致均在首写前拒绝。

当前生产只读验证：`promotion_ledger.csv=12716/ED2A83E2E6D1A695CF4DD24A79118B4DC99DAD75028B321D289114942F16B8BD`；其 preserved attempt1 terminal 为 `ROLLED_BACK`。实际下一 event 从 16 开始，下一 attempt sequence 为 2；attempt ID 是独立声明字段，不从尾号猜测。

### 3.4 Blocker 3：AUDIT / HANDOFF binding 歧义

`canonical_audit_id` 和 `review_handoff_id` 是不同的必填字段、不同前缀域且禁止相等。release preimage 固定为 `industry/task_id/case_id/batch_id/run_id/canonical_audit_id` 六行 UTF-8 LF，只允许 canonical AUDIT 进入。review HANDOFF 只进入配置和 receipt 绑定，不进入 release hash。

生产冻结值按此公式独立得到 `357 bytes/f39db200057f733df3d34ebc0387000d6af4a29d2a3e3ed787c20268b5fcace7`；HANDOFF 替换会被 ID 域或 release preimage 门禁拒绝。

## 4. 发布与恢复合同

1. 首写前完整验证 operation root/resolved root/volume、全部相对路径、普通非 reparse 目录和文件、lock/attempt/target/staging absence、ledger、prior exact-set、history exact-set、current state、candidate exact-set、candidate manifest、current manifest、链接/证据锚和 manifest-self candidate-set。
2. Windows 文件由普通完整读取与独立流式 SHA-256 双实现复核；空文件、不可读、missing/extra/duplicate/reparse 或 hash 漂移失败关闭。Repair008 的 63/63、12 条 `>=260` 路径合同被同一实现复用。
3. 首个正式写是 exclusive lock。随后形成完整 prior snapshot，把 candidate 全量复制并 readback 到同卷 staging release。
4. staging 通过后只执行一次目录 rename，再原子 replace 唯一 current pointer；提交前 prior 始终可读，提交后 target exact-set 与 pointer 全量复算。
5. postcommit 失败时只允许一次 pointer 回退并复核 prior pointer；不逐文件修补。已回滚 terminal 的重复调用失败关闭。
6. 已提交且 terminal、pointer、target exact-set、lock absence 全部一致时，exact repeat 返回 `IDEMPOTENT_COMMITTED` 且 ledger 不变；任何 published drift 都拒绝。

实现没有 maintenance/no-current、lease、逐状态 fault matrix、batch-specific reader 或多审核阶段。

## 5. 生产形态隔离测试

- Windows CPython compileall：PASS。
- JSON schema strict parse：PASS。
- `unittest`：`9/9 PASS`，约 12 秒；累计 23 次同一 CLI 调用。
- 正向：首写前 validate、完整 commit/readback、exact repeat 幂等。
- rollback：注入 postcommit readback failure，只切回 prior 一次；rolled-back repeat mutation0。
- ledger：bytes/SHA 漂移与 next event sequence 漂移。
- identity：AUDIT/HANDOFF 互换、candidate-set 漂移、release preimage。
- candidate：payload 漂移、current/candidate manifest binding、链接/证据锚缺失、attempt target 已存在。
- history：63 个普通文件、其中 12 条绝对路径 `>=260`；长路径内容漂移被独立读取命中。
- filesystem：root、volume、relative path、target exists、junction/reparse。
- schema：missing、extra、type error。
- terminal：published target 漂移时拒绝假幂等。

## 6. 正式现场只读证明

- Repair008 R06 evidence：`152316/8736ACD79B53F62CC6CFBC5CFAEBBB7BF0DF94D933A8E515C4482B0DC86E6315`。
- CPython 对真实 failed attempt 独立逐文件流式复算：`file_count=63`、`long_path_count=12`、`mismatch_count=0`、positive bytes `63/63`、uppercase SHA-256 `63/63`。
- failed attempt manifest 仍为 Windows PowerShell 5.1 目标身份：`7480/F66093023D91793AF8C03A72F4CE001F915EA7E986AAD788FDB61F922946E767`。
- canonical reader receipt：`2874/9C4BBC12B5DCC6BB700DE98D4CDD3E91B2170CF4DD6DD1D4B9ACBD0342155202`，仍为 `RECOVERY_REQUIRED/BLOCKED/30`，ledger latest=`ROLLED_BACK`，committed=`0`。
- 正式 current frozen identities仍为：cases `2701/B9B02A...36A4`；core `51587/6EDC2D...EEE7`；manifest `588/CAE3F8...D558`；result current `459/3671D3...594E5`；case result `3051/31CBD0...15B`。
- `ATTEMPT-B004-000002` 与 `ATTEMPT-B004-000003` 均不存在；active BATCH-004 lock 不存在；production publisher invocation=`0`；production mutation=`0`。

## 7. 审核请求

请既有 `dev.reviewer.ana.cai` 在同一 consolidated review 中只判断：

1. 三个 BLOCKED/3 是否由通用 config/ledger/audit contracts 一次关闭；
2. publisher 是否不含行业/批次/attempt 硬编码；
3. exact-set、manifest/link/evidence、同卷 atomic pointer、readback、一次 rollback 和 idempotence 是否非空；
4. 长路径与生产只读 mutation0 证据是否成立。

请求一个正式 `PASS/0` 或一次列全的 `HOLD/N`。本交付不是 production invocation 或 promotion authority；审核 PASS 后由 project.admin 另行创建唯一真实 config 与新 attempt。

## 8. HOLD/3 聚焦 successor（2026-08-21）

### 8.1 唯一续派与复审拓扑

- authority：`HANDOFF-INFOADMIN-LAOYANCAI-AGRICULTURE-BATCH004-SHARED-PUBLISHER-HOLD3-FOCUSED-SUCCESSOR-20260821-001`
- predecessor audit：`AUDIT-DEV-ANA-SHARED-CONTENT-PUBLISHER-V001-CONSOLIDATED-IMPLEMENTATION-001 / HOLD/3`
- fixed focused rereview：`HANDOFF-DEV-LAOYAN-LAOSHEN-AGRICULTURE-BATCH004-SHARED-PUBLISHER-HOLD3-FOCUSED-REREVIEW-20260821-001`
- owner/reviewer tasks 保持原值；没有第二个修复事项、第二条 review chain 或新 authority。

### 8.2 三项 blocker 的单补丁闭环

1. `BLOCK-SHARED-PUBLISHER-IMPL-01`：删除不可执行的 JSON pointer 合同。`SHARED_CONTENT_PUBLISHER_CONFIG_V2` 的唯一用户入口提交点固定为既有 cases Markdown `当前成果索引.md`；候选 release 目录先完成，最后使用同卷原子 replace 切换 cases Markdown。result Markdown 只读校验为指向 cases 的薄入口，不迁移消费者。
2. `BLOCK-SHARED-PUBLISHER-IMPL-02`：从卷根到 operation root 逐组件验证普通、非 reparse、非 alias；managed path graph 除 release-store/target、receipt/snapshot 两个明确父子关系外全部 case-insensitive disjoint。exclusive lock 成功后、任何 ledger append 前完整重读 config、ledger/current、prior manifest+self、candidate manifest/exact-set、link/evidence、history/current-state，并重新推导 event/attempt sequence。新事件使用真实 UTC 和 `PID+UUID` 进程实例身份；prior release-set 固定为 current-manifest bytes + canonical self descriptor 算法。
3. `BLOCK-SHARED-PUBLISHER-IMPL-03`：candidate current manifest 必须精确覆盖全部发布成员和 invariant result entry，manifest self formal path 必须等于实际 release member；link/evidence checks 均非空。首次 postcommit 和 replay 都验证 target exact-set、拒绝 extra。幂等成功绑定 config bytes/hash、root/volume、完整 terminal、完整 event chain、Markdown current/result、prior snapshot、target exact-set 和 lock absence；已切换但闭环漂移时先恢复 prior Markdown，再写独立 recovery terminal，保留原 terminal 不删除。

### 8.3 successor 精确对象

| 对象 | bytes | SHA-256 |
|---|---:|---|
| `dev/ana-dev/shared_content_publisher/publisher.py` | 73014 | `EC5C6F547AEEEC8AF4D3B84B831FBDE8E379603AFD1129FBA592937C91B58907` |
| `dev/ana-dev/shared_content_publisher/batch_config.schema.json` | 10430 | `9B027ED5AE2BF2B9FC50D491FA4AA3FEFA787DE80C3A6F0236555D3BC3266198` |
| `dev/ana-dev/shared_content_publisher/README.md` | 1889 | `CCA9F7B87E369227C7BD6E4624C06E6B1022F94EF6F609B75FC67E3AF201BCAD` |
| `dev/ana-dev/shared_content_publisher/__init__.py` | 168 | `CAEAB945F11B8C5DA0520C5132C37F013EA5F9EFB4A20655083B956E340B376B` |
| `dev/ana-dev/shared_content_publisher/__main__.py` | 86 | `DC3EA832B1DE49CBBE2EF61241524DB0751C9AB48FA2D42A49D58E01DB80B773` |
| `dev/ana-dev/test/test_shared_content_publisher_v1.py` | 28616 | `6ADAADF06E60D20DFA590461EEE73316A85525726A4A898740CAB3EDF6142077` |
| `dev-doc/ana-doc/开发方案/SHARED-CONTENT-PUBLISHER-PRODUCTION-GUARD-V001.json` | 2212 | `DEFB9E6987A73AFD918C7F4A40C5FD08920B3478788F7A276BF9DE20F46F17A0` |

### 8.4 最终生产形态矩阵

- bundled CPython compileall=`PASS`；schema/guard strict JSON=`PASS`；UTF-8 no BOM/NUL/CR=`PASS`。
- 同一公共 CLI、同一 V2 config schema 的 unittest=`14/14 PASS`，最终耗时约 17.8 秒。
- 正向覆盖：实际相对目录拓扑、Markdown prior/current、invariant result thin entry、validate、单次 commit、完整 readback、strict idempotent replay。
- 负向覆盖：一次 rollback、junction ancestor、path overlap、持锁 ledger race、duplicate event sequence、prior release-set、manifest member omission、empty link/evidence、首次 extra target、replay extra target、invalid config replay、terminal parse/field drift、candidate/history/long-path/root/schema/AUDIT-HANDOFF 漂移。
- reviewer 复现的四个攻击全部成为固定回归：manifest omission、empty checks、extra target file、invalid config replay；均不能返回假 `COMMITTED/IDEMPOTENT_COMMITTED`。

### 8.5 正式现场 mutation0 守卫

测试 `test_00_production_guard_precedes_isolated_mutation` 在任何临时 fixture 创建之前核对 7 个冻结正式对象和 3 个 absent path。最终复核：`file_mismatch=0`、`unexpected_present=0`、production publisher invocation=`0`、formal mutation=`0`。

- cases current=`2701/B9B02AF2F8899A3670CF4C6A463374A7A556E7FA26E3E953468B2129B20636A4`
- core=`51587/6EDC2D5FF6140C9CAC572D249C5CDFDCBD3C7C2FBED91BAB459DD27A406EEEE7`
- current manifest=`588/CAE3F83F1591F4D8D0ECD7E452DFDE1977958C1B1C4633E4225396615DD7D558`
- ledger=`12716/ED2A83E2E6D1A695CF4DD24A79118B4DC99DAD75028B321D289114942F16B8BD`
- result current=`459/3671D3BD13D1AD84E046895E5C3DAE2D43D491472B747A16FD24A9E2270594E5`
- case result=`3051/31CBD04BAB1AF28020E836347342FE3281EBE8C24CB8E7C362F12E70772B015B`
- canonical current state=`2874/9C4BBC12B5DCC6BB700DE98D4CDD3E91B2170CF4DD6DD1D4B9ACBD0342155202`，仍为 `RECOVERY_REQUIRED/BLOCKED/30`
- active lock、`ATTEMPT-B004-000002`、`ATTEMPT-B004-000003` 均 absent。

### 8.6 聚焦复审请求

请原 `dev.reviewer.ana.cai` 只复审上述 HOLD/3 successor，并返回唯一 `PASS/0` 或完整 `HOLD/N`。本 successor 没有生成真实 batch config，没有调用 production publisher，不是 promotion authority。只有正式 reviewer `PASS/0` 后，project.admin 才可机械生成全新的 `ATTEMPT-B004-000003` config 并另行执行。

## 9. 事件链治理 successor（2026-08-21）

### 9.1 授权与唯一范围

- authority：`HANDOFF-INFOADMIN-LAOYANCAI-AGRICULTURE-BATCH004-SHARED-PUBLISHER-EVENT-CHAIN-GOVERNANCE-SUCCESSOR-20260821-001`
- predecessor：`AUDIT-DEV-ANA-SHARED-CONTENT-PUBLISHER-V001-HOLD3-FOCUSED-REREVIEW-001 / HOLD/1`
- fixed consolidated review：`HANDOFF-DEV-LAOYAN-LAOSHEN-AGRICULTURE-BATCH004-SHARED-PUBLISHER-EVENT-CHAIN-CONSOLIDATED-IMPLEMENTATION-REVIEW-20260821-001`
- 本 successor 只关闭 `BLOCK-SHARED-PUBLISHER-IMPL-03` 剩余的事件链真值缺口；不重开已关闭的 Markdown consumer、prewrite root/path/lock/snapshot、manifest/link/evidence/postcommit 或 Repair008 长路径范围。

### 9.2 单一完整验证器

1. 新增唯一 `_validate_attempt_event_chain`，按 ledger 原始追加后缀顺序逐行绑定全部 17 列，而非按 attempt 过滤后遗漏被篡改行。
2. 每一状态的 receipt 是确定函数：`PREPARED/VERIFIED -> prior_snapshot.json`，`COMMITTING/COMMITTED -> terminal.json`，`ROLLING_BACK/ROLLED_BACK -> 当前 rollback/recovery terminal`。
3. `event_time` 只接受 canonical UTC microseconds+`Z`，并严格递增；写入端在时钟分辨率不足时单调推进 1 微秒。
4. `SHARED_CONTENT_PUBLISHER_ATTEMPT_EVENT_CHAIN_V1` 对 `columns + 逐行17列` 的 canonical JSON 计算 SHA-256。终态 V3 持久化 digest、row count、起止 UTC 和逐状态 process identity。
5. 正常 COMMITTED、正常 rollback、replay/idempotent 与 invalid-replay recovery 均调用同一个完整验证器。恢复链允许原提交进程与恢复进程不同，但逐状态进程身份精确持久化；无法验证完整链时 exit 27 fail closed，不返回幂等成功或猜测回滚。

### 9.3 生产形态篡改矩阵

- 最终 unittest=`16/16 PASS`；其中 17 个 ledger 字段逐列篡改=`17/17` 全部失败关闭，`IDEMPOTENT_COMMITTED=0`。
- 四个成功状态的 receipt 逐状态篡改=`4/4` 失败关闭；四个成功状态的 UTC 逐状态篡改=`4/4` 失败关闭。
- 正常提交的 event-chain digest 由测试独立 canonical 实现复算一致；普通 rollback 5 行、recovery rollback 6 行的 digest、row count 与逐阶段 process identity 均独立复算一致。
- 原 14 项生产形态矩阵全部保留：Markdown commit/replay、一次 rollback、锁后 ledger race、junction/path overlap、manifest/link/evidence/target、terminal、config、history 63/63 与 long-path 12/12、AUDIT/HANDOFF 域无回退。

### 9.4 精确实现对象

| 对象 | bytes | SHA-256 |
|---|---:|---|
| `dev/ana-dev/shared_content_publisher/publisher.py` | 81140 | `4027788031136F94D6D2E3B8FEE53D6A65E0C362BEF8CCC713C175FA615CCF2C` |
| `dev/ana-dev/shared_content_publisher/batch_config.schema.json` | 10430 | `9B027ED5AE2BF2B9FC50D491FA4AA3FEFA787DE80C3A6F0236555D3BC3266198` |
| `dev/ana-dev/shared_content_publisher/README.md` | 2252 | `F101EB043C566A0B76757543D4F96FE16E7E67834EDCFA636827223C6C3A32BF` |
| `dev/ana-dev/shared_content_publisher/__init__.py` | 168 | `FBA9552CBA028AD9B9212C7EFB701FE4E6CB5E31EBAA68AE23CF9E3156C4E7AC` |
| `dev/ana-dev/shared_content_publisher/__main__.py` | 86 | `DC3EA832B1DE49CBBE2EF61241524DB0751C9AB48FA2D42A49D58E01DB80B773` |
| `dev/ana-dev/test/test_shared_content_publisher_v1.py` | 33766 | `AC196135306F8AC67AF25CBF58D5D7E49AF2BE13269FE627F470E30D71842329` |
| `dev-doc/ana-doc/开发方案/SHARED-CONTENT-PUBLISHER-PRODUCTION-GUARD-V001.json` | 2212 | `DEFB9E6987A73AFD918C7F4A40C5FD08920B3478788F7A276BF9DE20F46F17A0` |

配置 schema 保持 V2 且无字段漂移；终态 schema 升级为 `SHARED_CONTENT_PUBLISHER_TERMINAL_V3`。管理员机械生成配方见 `SHARED-CONTENT-PUBLISHER-ATTEMPT-B004-000003-CONFIG-RECIPE-V001.md`；该文档不是生产 config。

### 9.5 生产零状态

production guard 最终仍要求 7 个冻结文件 exact、active lock/ATTEMPT-000002/ATTEMPT-000003 三路径 absent；实现和测试期间 production publisher invocation/mutation/config=`0/0/0`，canonical current 保持 `RECOVERY_REQUIRED/BLOCKED/30`。

## 10. DIRECT_STABLE_PATH_SET_V1 生产拓扑 successor（2026-08-21）

### 10.1 授权与兼容边界

- authority：`HANDOFF-INFOADMIN-LAOYANCAI-AGRICULTURE-BATCH004-SHARED-PUBLISHER-DIRECT-STABLE-PATH-SET-GOVERNANCE-SUCCESSOR-20260821-001`。
- fixed consolidated review：`HANDOFF-DEV-LAOYAN-LAOSHEN-AGRICULTURE-BATCH004-SHARED-PUBLISHER-DIRECT-STABLE-PATH-SET-CONSOLIDATED-IMPLEMENTATION-REVIEW-20260821-001`。
- 新增 `SHARED_CONTENT_PUBLISHER_CONFIG_V3 / DIRECT_STABLE_PATH_SET_V1`，与既有 V2 release-directory strategy 并列；`publisher.run_config` 仅按 schema+strategy 严格分派，V2 的 16 项回归不变。
- 不迁移或重写已接受 candidate manifest、10 个 `formal_relative_path`、current manifest、release-set、正文、证据或结论；新策略把 10 行 formal path 直接解释为稳定目的地。

### 10.2 事务实现

1. 只允许目的地位于 `ana-data/cases/<industry>/核心文档/`、`ana-data/cases/<industry>/manifest/` 或 `ana-data/result/<industry>/`；cases `当前成果索引.md` 是唯一 activation 例外且必须恰好一行。路径逃逸、duplicate/overlap/alias、reparse ancestor/target、卷漂移、受保护路径重叠与未声明目标均在首写前失败关闭。
2. candidate 10 行 exact-set、candidate/current manifests、manifest self、release-set、非空 link/evidence、prior current manifest、自包含 prior release-set、history/current state、ledger 及 destination prior present/absent 逐项绑定。
3. exclusive lock 后、首个 ledger append 前再次读取 config/candidate/prior/history/ledger/root/volume/完整 destination set，并重新推导唯一 event/attempt sequence。
4. 在同卷 fresh staging root 复制完整 candidate set并 readback；对全部 10 个目的地冻结 present/absent prior snapshot。提交顺序为 core payload，随后 manifests/thin results，最后 `CASES-CURRENT-INDEX`，从不撤下既有 current。
5. 任一提交边界失败最多一次逆序 rollback：恢复原有成员、删除本 attempt 新建成员、最后完整复核 prior set；未知真值返回 `RECOVERY_REQUIRED`。postcommit/replay/recovery 共用 accepted 17-column event-chain validator，并拒绝 destination extra 或终态/config/chain 漂移。
6. release 六行规范预像沿用正式历史标签 `accepted_audit_id=<identity.canonical_audit_id value>`；正式 B004 预像独立复算为 `357 bytes/f39db200057f733df3d34ebc0387000d6af4a29d2a3e3ed787c20268b5fcace7`。`review_handoff_id` 仍是独立 HANDOFF 域且不进入 release hash。

### 10.3 生产形态矩阵

- direct strategy unittest=`12/12 PASS / 35.917s`；legacy V2 regression=`16/16 PASS / 52.622s`；compileall=`PASS`。
- exact accepted B004 topology=`10/10 rows`：core、manifest、result 分布于既有稳定根，5 present + 5 absent，单次提交、activation position 10 与 exact replay 全部通过。
- failure injection=`17/17`：通用 mixed fixture 7 个边界 + exact accepted topology 10 个边界；含 activation 前后，全部恢复 exact prior。
- 负例覆盖 traversal、duplicate/overlap、protected overlap、undeclared root、volume drift、junction ancestor、candidate/target/ledger race、staging extra、replay target/extra/terminal drift；均不能产生假 `COMMITTED/IDEMPOTENT_COMMITTED`。
- strict schema/guard JSON=`PASS`；`mbx validate --project project-info --governance=OK/projects1/warnings0`。

### 10.4 精确交付对象

| 对象 | bytes | SHA-256 |
|---|---:|---|
| `dev/ana-dev/shared_content_publisher/publisher.py` | 81967 | `8FD893395F37541BD5342AF8775009044AC69C34DD50EA66F3020BA836DF8899` |
| `dev/ana-dev/shared_content_publisher/direct_stable_path.py` | 64394 | `D6C6B25026F4F7352F002B79E5E6D575A9B2BDF5BF75388FADF375D702EBCED5` |
| `dev/ana-dev/shared_content_publisher/batch_config.direct_stable_path_set.schema.json` | 11484 | `36453344CEC226DCD2BF2A196CC8F053E01FF40E416B7CB25F9FE2FF1F86EFD0` |
| `dev/ana-dev/shared_content_publisher/README.md` | 3808 | `EB171255EC4E28967B5F42305EE4047F93477FC9467B20DD0072376704494F81` |
| `dev/ana-dev/test/test_shared_content_publisher_direct_stable_path_v1.py` | 41861 | `BEA0258F5B14203B8FF3F97DABAFCB88C7D8E9C78830F9E76969F6DAE7BB008B` |
| `dev-doc/ana-doc/开发方案/SHARED-CONTENT-PUBLISHER-ATTEMPT-B004-000003-DIRECT-STABLE-PATH-CONFIG-RECIPE-V002.md` | 9911 | `FC0B2EE3C0847F4A19ADA3778B4366C7497E731E8D37FC207F0BAA5A87C029B3` |
| `dev-doc/ana-doc/开发方案/SHARED-CONTENT-PUBLISHER-DIRECT-STABLE-PATH-PRODUCTION-GUARD-V001.json` | 2953 | `E42D377FF31AF146B248612DEFD24C4E9BDA1711D0200FBBF614323B0E6B7306` |
| `dev-doc/ana-doc/开发方案/SHARED-CONTENT-PUBLISHER-DIRECT-STABLE-PATH-TEST-EVIDENCE-V001.json` | 2755 | `7624D9CAB83571D74A712C3877CA3CB9B8E5274BD89F8B5E5D8D92E699964AB6` |

### 10.5 production-zero 与审核边界

最终 readback：正式 7 个冻结文件 `7/7 exact`；accepted candidate manifests `2/2 exact`；active lock 与 `ATTEMPT-B004-000003` `2/2 absent`；production config/publisher invocation/formal mutation=`0/0/0`；canonical current 保持 `RECOVERY_REQUIRED/BLOCKED/30`。本交付不创建真实 config、不执行 publisher 或 promotion。只有固定 reviewer 返回正式 `PASS/0` 后，project.admin 才可按 V002 配方机械生成唯一真实 config 并另行调用。

## 11. DIRECT stable HOLD/2 合并闭环 successor（2026-08-21）

### 11.1 唯一范围

- authority：`HANDOFF-INFOADMIN-LAOYANCAI-AGRICULTURE-BATCH004-DIRECT-STABLE-PATH-SET-HOLD2-CONSOLIDATED-CLOSURE-20260821-001`。
- fixed focused rereview：`HANDOFF-DEV-LAOYAN-LAOSHEN-AGRICULTURE-BATCH004-DIRECT-STABLE-PATH-SET-HOLD2-CONSOLIDATED-CLOSURE-FOCUSED-REREVIEW-20260821-001`。
- 一次关闭 `DIRECT-01` 混合 current 可见性与 `DIRECT-02` 前目的地失败/同 config 重跑两个 blocker；保留 V3 strategy、既有 candidate/formal path/release-set、事件链与 Repair008 合同。

### 11.2 Cooperative authoritative reader

1. 新增公共 `read_direct_current_snapshot()` 和 CLI `--read-direct-current`。读前要求 publisher lock absent，并冻结 cases current index/current manifest 两个身份；在同一观察窗口内读取并校验全部 10 个 stable target；读后再次要求 lock absent 且双身份不变。
2. lock present（包括 10 个逐文件提交边界）只返回 `RETRY_PUBLISH_IN_PROGRESS`；身份、exact-set 或 receipt 闭环漂移只返回 `STOP_NOT_CURRENT`。失败结果不携带 payload，也不设置 current announced/cache 标记。
3. Python helper 只在完整双读闭环成功后返回同一窗口内冻结的完整 bytes snapshot；CLI 只返回身份摘要。raw manual filesystem read 不具 authoritative current 语义。

### 11.3 Durable-prefix 恢复状态机

1. 完整 prior snapshot+receipt 后的空事件前缀、`PREPARED`、`VERIFIED`、`COMMITTING` 后首个目的地前，以及 10 个提交边界均进入同一恢复验证器。
2. 同 config 新进程先重验 config、commit plan、snapshot receipt、prior-state exact-set、staging subset/identity、全部目的地 prior/candidate truth 和已有 17 列 event chain；只有完整可判真前缀才执行一次逆序 prior 恢复。
3. 恢复终态严格保存完整事件链、进程身份和被取代 terminal 身份；下一次相同调用返回 `IDEMPOTENT_ROLLED_BACK`，不再因已有 receipt 返回 `TERMINAL_REPEAT_BLOCKED`。
4. snapshot、receipt、staging、ledger 或任一目的地被篡改时均 exit nonzero fail closed，既不返回 candidate current，也不猜测回滚。

### 11.4 最终矩阵与生产零状态

- direct suite=`16/16 PASS`；legacy V2=`16/16 PASS`；compileall=`PASS`。
- authoritative observer=`10/10` 提交边界只见 retry，mixed-current return=`0`；闭合后 full snapshot=`10/10 members`。
- process restart recovery=`14/14`（snapshot、PREPARED、VERIFIED、首写前、10 个 commit boundaries）；same-config recovery=`14/14`，strict idempotent rollback=`14/14`。
- boundary tamper=`14/14 fail closed`；原 root/path/reparse/volume/manifest/event-chain/Repair008 回归无退化。
- production guard=`7/7 formal exact + 2/2 candidate exact + 2/2 absent`；config/invocation/formal mutation=`0/0/0`；canonical current 仍为 `RECOVERY_REQUIRED/BLOCKED/30`。
- machine evidence：`SHARED-CONTENT-PUBLISHER-DIRECT-STABLE-PATH-HOLD2-CLOSURE-TEST-EVIDENCE-V002.json`。本节不创建真实 config、ATTEMPT-B004-000003 或 production invocation。

### 11.5 冻结实现身份

| 对象 | bytes | SHA-256 |
|---|---:|---|
| `dev/ana-dev/shared_content_publisher/publisher.py` | 82381 | `3E77BAB80424BC97787F43BD78F61A53DE9EAB1435D730AC4D3F9FCB866F219D` |
| `dev/ana-dev/shared_content_publisher/direct_stable_path.py` | 76097 | `170159962816EA012FA3913240A48B9ED759A0B7E5926DEE1D334434A08DFDF1` |
| `dev/ana-dev/shared_content_publisher/authoritative_reader.py` | 7021 | `98288BABB7F91832156BB8B2805D574E275C7C88A196398878D619D1BB7A9620` |
| `dev/ana-dev/shared_content_publisher/batch_config.direct_stable_path_set.schema.json` | 11696 | `6AD035F81F2F38FB2E818E72C48F51185842A030EEA841B5754A2002D98CBD80` |
| `dev/ana-dev/shared_content_publisher/README.md` | 4741 | `1DED1BDA09A2FC55E0E9816AC48DBF8FAB4F65DF354CB9A908DA3B912E0D06E0` |
| `dev/ana-dev/shared_content_publisher/__init__.py` | 307 | `A14DF6A6AEFAF65FDEC164888C513E5410C4550652F8104372089FEDAA81C39C` |
| `dev/ana-dev/shared_content_publisher/__main__.py` | 86 | `DC3EA832B1DE49CBBE2EF61241524DB0751C9AB48FA2D42A49D58E01DB80B773` |
| `dev/ana-dev/test/test_shared_content_publisher_direct_stable_path_v1.py` | 51117 | `8794F7AC4D048429A75FF4C8D144F2970E6D40EEF8DAE9C1F7F7412C6CDD9F8D` |
| `dev/ana-dev/test/test_shared_content_publisher_v1.py` | 33766 | `AC196135306F8AC67AF25CBF58D5D7E49AF2BE13269FE627F470E30D71842329` |
| `ana-doc/案例分析规范.md` | 78369 | `877A91F9E1B372E9058CAA3D67A1E9CD548BC3519F285061BF1C1D2A1BEEB78B` |
| `ana-doc/案例存储体系.md` | 40808 | `9A29ACB2867925D4938C6923E7EDEF3441B09349B06236B5976448B414651D1C` |
| `dev-doc/ana-doc/开发方案/SHARED-CONTENT-PUBLISHER-DIRECT-STABLE-PATH-HOLD2-CLOSURE-TEST-EVIDENCE-V002.json` | 1085 | `C5FFC2C2625CBC8FDB92AE104584E73D86DA8B9F44B04BA91023F49E6B98FF12` |

## 12. Pre-anchor recovery 单 blocker successor（2026-08-21）

### 12.1 范围与实现

- authority：`HANDOFF-INFOADMIN-LAOYANCAI-AGRICULTURE-BATCH004-PREANCHOR-RECOVERY-SINGLE-BLOCKER-SUCCESSOR-20260821-001`；只关闭 `BLOCK-SHARED-PUBLISHER-DIRECT-02_PREDESTINATION_FAILURE_AND_RERUN_NOT_CLOSED`，不重开 cooperative reader、10/10 observer、已完成 14/14 recovery/idempotence/tamper、17 列事件链或 Repair008。
- `attempt_receipt_root` 不再作为逐文件构造目录。完整 prior snapshot、commit plan、确定性 attempt contract 与 canonical recovery-anchor manifest 先写入由 task/case/batch/run/config 身份唯一推导的同卷私有 preparation root。
- 每个 preparation member 使用私有临时文件 CreateNew，完成写入、`fsync`、close、完整回读后，再以 no-overwrite 原子改名成为 private member；全部成员和 manifest 复验成功后，紧邻原子发布再次重校验完整 locked preimage，整目录再以一次 no-overwrite 原子 rename 发布为 official recovery anchor。
- 原子目录发布前，ledger/event/formal destination 均不允许写入。相同 config 重启只在 official anchor 缺失、formal exact prior、scope/ledger/root 仍精确且 preparation 文件集可证明属于本 attempt 时退役残片并重建；finalized member、unexpected member、official+preparation 双重存在或 official anchor 漂移统一返回显式 `RECOVERY_REQUIRED`，不盲删。
- official anchor 成功发布后立即成为恢复所有权边界；其后的 interrupt/I/O 失败沿既有 durable state machine 精确 rollback 或同配置恢复。生产 fault 仍必须为 `NONE`。

### 12.2 生产形态验收

- pre-anchor 成员数=`9`，每成员覆盖写前、写中、flush/close 后、回读后、member rename 后五个边界；anchor publish 另覆盖 rename 前、系统调用中与成功后三个边界，合计每种 fault=`48`。
- `DIRECT_INTERRUPT_PREANCHOR` 与 `DIRECT_IO_ERROR_PREANCHOR` 两类故障共 `96/96`：原子发布前均保持 official anchor absent、formal mutation0，并由同配置重启确定性重建/提交；原子发布后则消费 exact official anchor 并精确 rollback/幂等。
- preparation finalized-member tamper、unexpected member 与 official anchor manifest tamper=`3/3 RECOVERY_REQUIRED`，formal destination 保持 prior、lock absent。
- 完整回归：direct=`18/18 PASS`、legacy V2=`16/16 PASS`，总计=`34/34 PASS / 364.337s`；compileall=`PASS`。旧 observer、event-chain、manifest/postcommit、root/path/reparse/volume、rollback 与 Repair008 无回退。
- production guard 仍为正式文件 exact、active lock/ATTEMPT-B004-000003 absent；生产 config/publisher/formal mutation=`0/0/0`；canonical current=`RECOVERY_REQUIRED/BLOCKED/30`。

### 12.3 冻结对象

| 对象 | bytes | SHA-256 |
|---|---:|---|
| `dev/ana-dev/shared_content_publisher/publisher.py` | 82381 | `3E77BAB80424BC97787F43BD78F61A53DE9EAB1435D730AC4D3F9FCB866F219D` |
| `dev/ana-dev/shared_content_publisher/direct_stable_path.py` | 91610 | `173760DDE8C5ABF8623014B5942A03293FAAD5F11CA8E00A7D2BA560BDEC0F14` |
| `dev/ana-dev/shared_content_publisher/authoritative_reader.py` | 7021 | `98288BABB7F91832156BB8B2805D574E275C7C88A196398878D619D1BB7A9620` |
| `dev/ana-dev/shared_content_publisher/batch_config.direct_stable_path_set.schema.json` | 11755 | `4BDAC4B5EE4D4777FC47DC9A386899B4AD6F73D1C52185AEB4CDBA48EF6FD739` |
| `dev/ana-dev/shared_content_publisher/README.md` | 5290 | `06C8C2FD676A1C979F47ABC7D686CFFDACCDBFFC8AB9BC1C84DF4317B55622AC` |
| `dev/ana-dev/test/test_shared_content_publisher_direct_stable_path_v1.py` | 56293 | `45B1F0CF76C169169900DC02167F95F653F7E8B0DF9276D72B955F7C6FD015C0` |
| `dev/ana-dev/test/test_shared_content_publisher_v1.py` | 33766 | `AC196135306F8AC67AF25CBF58D5D7E49AF2BE13269FE627F470E30D71842329` |
| `dev-doc/ana-doc/开发方案/SHARED-CONTENT-PUBLISHER-PREANCHOR-RECOVERY-TEST-EVIDENCE-V003.json` | 902 | `48629E9817831EC7E4D86BC812797DB30DAEB7492023B2C3262FBAFDFE733AAA` |

本实现未创建 production config、未调用 production publisher、未创建 `ATTEMPT-B004-000003`，也未修改农业 candidate、正文、结论、正式 current 或 ledger。只有固定 focused reviewer 的 `PASS/0` 才允许 project.admin 进入后续机械生产步骤。