@furongjun1999/dsh-memory 0.9.6 → 0.9.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (233) hide show
  1. package/README.md +150 -662
  2. package/codebuddy/CODEBUDDY.md +333 -204
  3. package/data/policy.json +38 -38
  4. package/docs/README.md +18 -0
  5. package/docs/discipline/harnesses.yaml +11 -3
  6. package/docs/discipline/templates/compact.txt.tmpl +20 -18
  7. package/docs/discipline/templates/full.md.tmpl +63 -61
  8. package/docs/discipline/templates/rules.mdc.tmpl +5 -3
  9. package/docs/discipline/templates/skill.md.tmpl +25 -23
  10. package/docs/discipline/templates/spec.txt.tmpl +2 -2
  11. package/docs/discipline/templates/zcode-user.md.tmpl +1 -1
  12. package/dsh/cordis.yml.example +139 -139
  13. package/lib/hooks.d.ts +19 -0
  14. package/lib/hooks.js +30 -7
  15. package/lib/index.js +18 -3
  16. package/lib/init.js +19 -4
  17. package/lib/lib/hook_audit.js +64 -2
  18. package/lib/lib/prompt_safety.js +14 -3
  19. package/lib/tools.d.ts +7 -0
  20. package/lib/tools.js +22 -1
  21. package/md_cg/_guard_kit.py +121 -121
  22. package/md_cg/anchor.py +114 -114
  23. package/md_cg/audit.py +15 -2
  24. package/md_cg/chain.py +3 -2
  25. package/md_cg/config_registry_guard.py +487 -487
  26. package/md_cg/conformance.py +747 -747
  27. package/md_cg/consolidate.py +1793 -1793
  28. package/md_cg/crypto.py +794 -794
  29. package/md_cg/hyperedge.py +262 -262
  30. package/md_cg/interface_schema.py +146 -146
  31. package/md_cg/lifecycle.py +426 -426
  32. package/md_cg/mdcos.py +12 -8
  33. package/md_cg/predict.py +1103 -1103
  34. package/md_cg/protect.py +654 -654
  35. package/md_cg/provenance.py +606 -606
  36. package/md_cg/queue_health.py +130 -130
  37. package/md_cg/refine.py +613 -613
  38. package/md_cg/retrieve.py +128 -128
  39. package/md_cg/revise.py +140 -140
  40. package/md_cg/rollback.py +657 -657
  41. package/md_cg/rollback_cli.py +124 -124
  42. package/md_cg/rotate.py +346 -346
  43. package/md_cg/routing.py +490 -490
  44. package/md_cg/self_surface.py +50 -50
  45. package/md_cg/semantic/canonical.py +144 -144
  46. package/md_cg/semantic/zh_en_atoms.py +141 -141
  47. package/md_cg/sources.py +1091 -1091
  48. package/md_cg/stg.py +3 -2
  49. package/md_cg/sustain.py +10 -1
  50. package/md_cg/test_audit_rotate_parity.py +279 -279
  51. package/md_cg/test_autonomy_modes.py +2013 -2013
  52. package/md_cg/test_cn_recall_grams.py +206 -206
  53. package/md_cg/test_code_kind_forbidden.py +101 -0
  54. package/md_cg/test_condaccept.py +156 -156
  55. package/md_cg/test_condgate.py +141 -141
  56. package/md_cg/test_heartbeat_ledger.py +9 -3
  57. package/md_cg/test_i50e_readside_protection.py +658 -658
  58. package/md_cg/test_issue111_gate_order.py +76 -76
  59. package/md_cg/test_issue111_scoring_contract.py +86 -86
  60. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  61. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  62. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  63. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  64. package/md_cg/test_issue149_accel_default_face.py +248 -248
  65. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  66. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  67. package/md_cg/test_issue152_sealed_postings.py +309 -309
  68. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  69. package/md_cg/test_issue157b_index_remainder.py +344 -344
  70. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  71. package/md_cg/test_issue191_import_trust.py +382 -382
  72. package/md_cg/test_issue193_write_scope.py +378 -378
  73. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  74. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  75. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  76. package/md_cg/test_issue216_clash_routes.py +214 -214
  77. package/md_cg/test_issue217_slot_routes.py +248 -248
  78. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  79. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  80. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  81. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  82. package/md_cg/test_issue275_layer_param.py +250 -250
  83. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  84. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  85. package/md_cg/test_issue278_neg_window.py +294 -294
  86. package/md_cg/test_issue278_negative_layering.py +83 -83
  87. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  88. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  89. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  90. package/md_cg/test_issue303_design_boundaries.py +262 -262
  91. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  92. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  93. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  94. package/md_cg/test_issue322_node_write_lock.py +727 -727
  95. package/md_cg/test_issue324_write_size_fields.py +214 -214
  96. package/md_cg/test_issue325_audit_poison.py +229 -229
  97. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  98. package/md_cg/test_issue326_key_perms.py +355 -355
  99. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  100. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  101. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  102. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  103. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  104. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  105. package/md_cg/test_issue350_casefold_collision.py +235 -235
  106. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  107. package/md_cg/test_issue352_imgaudit.py +418 -418
  108. package/md_cg/test_issue352_pathsjson.py +537 -537
  109. package/md_cg/test_issue352_refindex.py +412 -412
  110. package/md_cg/test_issue352_rollback.py +604 -604
  111. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  112. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  113. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  114. package/md_cg/test_issue358_truncation_observable.py +247 -247
  115. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  116. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  117. package/md_cg/test_issue362_neg_condition.py +468 -468
  118. package/md_cg/test_issue363_lexical_idf.py +275 -275
  119. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  120. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  121. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  122. package/md_cg/test_issue378_protected_floor.py +310 -310
  123. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  124. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  125. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  126. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  127. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  128. package/md_cg/test_issue404_heal_receipt.py +389 -389
  129. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  130. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  131. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  132. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  133. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  134. package/md_cg/test_issue413_preimage_twin.py +339 -339
  135. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  136. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  137. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  138. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  139. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  140. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  141. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  142. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  143. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  144. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  145. package/md_cg/test_issue434_435_float_gate.py +90 -90
  146. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  147. package/md_cg/test_issue43_default_policy.py +874 -874
  148. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  149. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  150. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  151. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  152. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  153. package/md_cg/test_issue451_audit_actor.py +313 -313
  154. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  155. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  156. package/md_cg/test_issue466_basis_registry.py +469 -469
  157. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  158. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  159. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  160. package/md_cg/test_issue471_identity_readable.py +136 -136
  161. package/md_cg/test_issue472_audit_chain.py +90 -90
  162. package/md_cg/test_issue472_prune_ledger.py +105 -105
  163. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  164. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  165. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  166. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  167. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  168. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  169. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  170. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  171. package/md_cg/test_issue547_audit_durable.py +96 -96
  172. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  173. package/md_cg/test_issue559_refine_prefix.py +69 -69
  174. package/md_cg/test_issue562_retired_faces.py +150 -0
  175. package/md_cg/test_issue71_queue_backlog.py +376 -376
  176. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  177. package/md_cg/test_issue82_credential_rules.py +271 -271
  178. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  179. package/md_cg/test_issue93_remember_redaction.py +282 -282
  180. package/md_cg/test_logref.py +1141 -1141
  181. package/md_cg/test_md_access_parity.py +330 -330
  182. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  183. package/md_cg/test_mutation_residue.py +119 -119
  184. package/md_cg/test_mutation_rollback.py +835 -835
  185. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  186. package/md_cg/test_n184_keys_concurrent_provision.py +1 -1
  187. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  188. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  189. package/md_cg/test_neg_tail_honesty.py +733 -733
  190. package/md_cg/test_p21_tokens.py +294 -294
  191. package/md_cg/test_p27_docindex.py +792 -792
  192. package/md_cg/test_p28_refcheck.py +1053 -1053
  193. package/md_cg/test_p2_six_elements.py +476 -476
  194. package/md_cg/test_p33_ccg_wiring.py +300 -300
  195. package/md_cg/test_p3_legacy_closure.py +438 -438
  196. package/md_cg/test_p40_refine_worklist.py +244 -244
  197. package/md_cg/test_p4_freshness.py +781 -781
  198. package/md_cg/test_p9c_dedup_hints.py +288 -288
  199. package/md_cg/test_policy_required_ccg.py +444 -444
  200. package/md_cg/test_read_scope_b27.py +2 -2
  201. package/md_cg/test_retr_s5.py +312 -312
  202. package/md_cg/test_s1_ast_judge.py +109 -109
  203. package/md_cg/test_security_audit_v21.py +249 -249
  204. package/md_cg/test_state_event_op.py +521 -521
  205. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  206. package/md_cg/test_sustain_bad_stamp.py +178 -0
  207. package/md_cg/test_sustain_bounded.py +652 -652
  208. package/md_cg/test_trust_edge_reachability.py +405 -405
  209. package/md_cg/test_w7_redlines.py +659 -659
  210. package/md_cg/test_write_return_shape.py +919 -919
  211. package/md_cg/test_writepipe.py +228 -228
  212. package/md_cg/trust.py +1114 -1114
  213. package/md_cg/twophase.py +303 -303
  214. package/md_cg/whitebox.py +536 -536
  215. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  216. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  217. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  218. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  219. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  220. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  221. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  222. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  223. package/md_cg/writepipe.py +1337 -1337
  224. package/package.json +3 -2
  225. package/scripts/workspace_index.py +328 -0
  226. package/src/hooks.ts +932 -908
  227. package/src/index.ts +21 -6
  228. package/src/init.ts +16 -4
  229. package/src/lib/hook_audit.ts +48 -2
  230. package/src/lib/mdcg_client.ts +469 -469
  231. package/src/lib/prompt_safety.ts +17 -3
  232. package/src/tools.ts +23 -1
  233. package/zcode/AGENTS.md +333 -204
@@ -1,262 +1,262 @@
1
- # -*- coding: utf-8 -*-
2
- """超边(hyperedge):跨端验证回执的认知图形式化投影。
3
-
4
- 上游真源 = 互验协议运行时文件(hive/interop/_receipts_ledger.tsv,六列);
5
- 超边节点是历史回执在认知图中的**形式化镜像**(一行 = 一条超边,回执粒度),
6
- 单向投影:超边不反向覆写台账,协议运行时逻辑零改动。
7
-
8
- 六列 → fm + 正文完整自包含回执卡,机械映射零编造:
9
- received_at / verify_id / commit / verdict / receipt_job / iter_id
10
- - participants 定长二元 [verify_id, receipt_job](六列机械可得的全部参与者
11
- 信息;role/harness/unit/session 归因字段台账无载,不编造)
12
- - evidence [{verify_id, commit, verdict, received_at}]
13
- - corrections [](迁移期恒空;后续跨端修正经修正面回填)
14
- - ledger_row 六列整行锚(与结构键互为回放校验)
15
-
16
- 幂等键:he_<sha1(六列值 join)[:12]>——同一台账行重复迁移得到同一节点 id。
17
- (#157:原为 [:10](40 bit),与同仓 codeindex / docindex 的 [:12](48 bit)不
18
- 对齐;生日界下 ~1e6 条即约 39% 碰撞概率,一旦撞上就是同 id 幂等 upsert ⇒ 回执
19
- 静默丢失(实测 1,464,937 条内即撞出一条同 id,见守卫)。[:12] 是 [:10] 的
20
- **前缀扩展**:新 id = 旧 id + hexdigest 的第 11–12 位。)
21
-
22
- 验证器 verify_payload 做「结构键反解 ↔ ledger_row 锚」逐字段回放比对 + 正文
23
- 四段标记检查,经 register_verifier("hyperedge", …) 注入(或 MDCG_VERIFIER_MODULES
24
- 外部注入;未注入时 audit DEFER——诚实不假装通过)。
25
-
26
- 本模块不含写库逻辑;写入由调用方走 cg(op=write, content_kind="hyperedge", …)
27
- 经 writepipe 既有审核链(五动词纪律:不重复造写入通道)。
28
- """
29
- from __future__ import annotations
30
-
31
- import hashlib
32
-
33
- CONTENT_KIND = "hyperedge"
34
- EDGE_TYPE = "cross_verify" # 唯一类型,留扩展位
35
- SOURCE_NAME = "receipts_ledger" # 溯源锚(协议真源 TSV)
36
- LEDGER_COLUMNS = ("received_at", "verify_id", "commit", "verdict",
37
- "receipt_job", "iter_id")
38
-
39
- # 写入面透传给 cg.add(**extra) 的 fm 键集合(writepipe._hyperedge_extra 按此
40
- # 收集非 None 键)。落盘面丢字段 = 上游声明静默失效(比报错更难发现)。
41
- EXTRA_FM_KEYS = ("content_kind", "edge_type", "participants", "evidence",
42
- "corrections", "iter_id", "source", "received_at",
43
- "verdict", "ledger_row")
44
-
45
- # 正文四段标记(build_content 段落标题词;验证器检查齐备——无 fm 解析能力
46
- # 的外部工具直读正文即可取数,这是「可被外部理解的正式结构」的最低保障)。
47
- CONTENT_MARKERS = ("参与者", "证据", "修正", "时间")
48
-
49
- _EMPTY_NOTE = "(台账原始行无此字段)" # 空字段的事实陈述(非编造占位)
50
-
51
-
52
- # 生效条件:v 传入即归一为去空格字符串(None 得空串),无条件分支;
53
- def _clean(v):
54
- return "" if v is None else str(v).strip()
55
-
56
-
57
- # 生效条件:row 为含六列键的 dict 时返回六列清洗副本;缺列或非 dict 即抛
58
- # ValueError(fail-closed,不猜测补值);
59
- def _norm_row(row):
60
- if not isinstance(row, dict):
61
- raise ValueError("台账行须为 dict(六列键),得到 %s" % type(row).__name__)
62
- missing = [c for c in LEDGER_COLUMNS if c not in row]
63
- if missing:
64
- raise ValueError("台账行缺列:%s(fail-closed,不猜测补值)" % missing)
65
- return {c: _clean(row.get(c)) for c in LEDGER_COLUMNS}
66
-
67
-
68
- # 生效条件:row 经 _norm_row 校验即返回固定键集 fm(content_kind/edge_type/
69
- # participants/evidence/corrections/iter_id/source/received_at/verdict/ledger_row);
70
- def fm_from_row(row):
71
- """台账行 → 超边 fm(schema v0.1,协议冻结前允许破坏性调整)。"""
72
- r = _norm_row(row)
73
- return {
74
- "content_kind": CONTENT_KIND,
75
- "edge_type": EDGE_TYPE,
76
- # 定长二元:空串占位保证反解对称([0]→verify_id、[1]→receipt_job)。
77
- "participants": [r["verify_id"], r["receipt_job"]],
78
- "evidence": [{"verify_id": r["verify_id"], "commit": r["commit"],
79
- "verdict": r["verdict"], "received_at": r["received_at"]}],
80
- "corrections": [],
81
- "iter_id": r["iter_id"],
82
- "source": SOURCE_NAME,
83
- "received_at": r["received_at"],
84
- "verdict": r["verdict"],
85
- "ledger_row": dict(r),
86
- }
87
-
88
-
89
- # 生效条件:fm 的 participants 为定长二元、evidence 为单项列表时返回六列重建
90
- # 行(回放方向 H1:反解六列);形态不符即抛 ValueError;
91
- def rows_from_fm(fm):
92
- """fm 结构键 → 台账行(反解方向,不依赖 ledger_row 锚)。"""
93
- parts = fm.get("participants")
94
- if not isinstance(parts, list) or len(parts) != 2:
95
- raise ValueError("participants 须为定长二元 [verify_id, receipt_job]")
96
- ev = fm.get("evidence")
97
- if not isinstance(ev, list) or len(ev) != 1 or not isinstance(ev[0], dict):
98
- raise ValueError("evidence 须为单项列表"
99
- "({verify_id, commit, verdict, received_at})")
100
- e = ev[0]
101
- return {
102
- "received_at": _clean(e.get("received_at")),
103
- "verify_id": _clean(parts[0]),
104
- "commit": _clean(e.get("commit")),
105
- "verdict": _clean(e.get("verdict")),
106
- "receipt_job": _clean(parts[1]),
107
- "iter_id": _clean(fm.get("iter_id")),
108
- }
109
-
110
-
111
- # 生效条件:fm 含六列信息(ledger_row 锚优先,缺锚走结构键反解)时返回六列行;
112
- # 两者皆不可解析即抛 ValueError;
113
- def _row_of_fm(fm):
114
- anchored = fm.get("ledger_row")
115
- if isinstance(anchored, dict):
116
- return {c: _clean(anchored.get(c)) for c in LEDGER_COLUMNS}
117
- return rows_from_fm(fm)
118
-
119
-
120
- # 生效条件:fm 经 _row_of_fm 可解析即返回含四段标记(参与者/证据/修正/时间)
121
- # 的正文,空字段以「台账原始行无此字段」事实陈述呈现;
122
- def build_content(fm):
123
- """超边 fm → 四段正文(参与者/证据/修正/时间)。"""
124
- r = _row_of_fm(fm)
125
-
126
- def v(col):
127
- return r[col] if r[col] else _EMPTY_NOTE
128
-
129
- corr = fm.get("corrections") or []
130
- lines = [
131
- "# 跨端验证超边(%s / %s)" % (CONTENT_KIND, EDGE_TYPE),
132
- "",
133
- "## 参与者",
134
- "- verify_id: %s" % v("verify_id"),
135
- "- receipt_job: %s" % v("receipt_job"),
136
- "",
137
- "## 证据",
138
- "- commit: %s" % v("commit"),
139
- "- verdict: %s" % v("verdict"),
140
- "- received_at: %s" % v("received_at"),
141
- "",
142
- "## 修正",
143
- ]
144
- lines.extend(("- %s" % _clean(c) for c in corr if _clean(c)) if corr
145
- else ["无(迁移期恒空;后续跨端修正经修正面回填)"])
146
- lines.extend([
147
- "",
148
- "## 时间",
149
- "- received_at: %s" % v("received_at"),
150
- "- iter_id: %s" % v("iter_id"),
151
- "",
152
- "溯源:%s(TSV 真源单向投影,超边不反向覆写台账)" % SOURCE_NAME,
153
- ])
154
- return "\n".join(lines)
155
-
156
-
157
- # 生效条件:row 经 _norm_row 校验即返回载荷 {ledger_row, frontmatter, content}
158
- # (写入面读向齐备,幂等 id 另经 node_id_for 取);
159
- def row_from_ledger(row):
160
- """台账行 → 超边载荷({ledger_row, frontmatter, content})。"""
161
- r = _norm_row(row)
162
- fm = fm_from_row(r)
163
- return {"ledger_row": dict(r), "frontmatter": fm,
164
- "content": build_content(fm)}
165
-
166
-
167
- # 生效条件:node 为 dict(frontmatter 嵌套或 fm 键平铺两形态)且结构键可反解
168
- # 时返回载荷(ledger_row 优先取节点锚,缺锚用结构重建行);结构不可反解即抛
169
- # ValueError;
170
- def payload_from_node(node):
171
- """节点 → 载荷(回放重建读向 H1)。"""
172
- if not isinstance(node, dict):
173
- raise ValueError("节点须为 dict")
174
- fm = node.get("frontmatter") if isinstance(node.get("frontmatter"), dict) \
175
- else node
176
- anchored = fm.get("ledger_row")
177
- rebuilt = rows_from_fm(fm)
178
- row = ({c: _clean(anchored.get(c)) for c in LEDGER_COLUMNS}
179
- if isinstance(anchored, dict) else rebuilt)
180
- return {"ledger_row": row, "frontmatter": fm,
181
- "content": node.get("content") or ""}
182
-
183
-
184
- # 生效条件:a(writepipe 写入请求,fm 键平铺顶层)传入即返回验证器三键载荷
185
- # {ledger_row, frontmatter, content}——frontmatter 收集 a 中非 None 的
186
- # EXTRA_FM_KEYS 键;ledger_row 非 dict 时为 None(由验证器 fail-closed 裁决);
187
- def audit_payload(a):
188
- """writepipe audit 闸的超边载荷装配(fm 键平铺 → 三键载荷)。"""
189
- row = a.get("ledger_row")
190
- return {"ledger_row": row if isinstance(row, dict) else None,
191
- "frontmatter": {k: a.get(k) for k in EXTRA_FM_KEYS
192
- if a.get(k) is not None},
193
- "content": a.get("content") or ""}
194
-
195
-
196
- # 生效条件:row 经 _norm_row 校验即返回 he_<sha1(逐列「len:val」拼接)[:12]>
197
- # (同一台账行恒同 id,重复迁移幂等;任意列内容不可伪造边界);
198
- def node_id_for(row):
199
- """幂等键:同一台账行重复迁移得到同一节点 id。
200
-
201
- **无歧义规范化**(2026-09-20 v14 缺陷 G 修复):逐列 `<len>:<val>` 前缀
202
- 拼接——长度前缀由本函数计算、不可被列内容伪造,故任意两列之间搬移含任意
203
- 字符的文本都得不同 canon。旧实现直接 `"\\x1f".join(...)`:`verify_id="a"`
204
- + `commit="b\\x1fc"` 与 `verify_id="a\\x1fb"` + `commit="c"` 撞同一 id
205
- (不是 SHA-1 碰撞,是规范化没做转义/长度前缀)。
206
-
207
- id 口径变更说明:canon 输入形态改变 → id 取值随之改变。属 schema v0.1
208
- 内的破坏性调整(该 schema 明示允许);实测库内 `he_` 节点为 0,无历史
209
- 迁移数据需兼容。
210
-
211
- #157(2026-10-12)截断位宽变更:[:10] → [:12](对齐 codeindex:270 /
212
- docindex 的同类幂等键口径)。id 取值随之改变,但两者是**前缀关系**
213
- ——新 id 的前 10 位恒等于旧 id,故即便库内确有 `he_` 节点,迁移口径 =
214
- 按节点自身 ledger_row 重算 id 后改名/改键(前缀可直接互校,不存在无法
215
- 反解的旧 id);本仓追踪面复核(grep `he_<hex>`)命中 0 处,与上段
216
- 「库内 he_ 节点为 0」一致,故**无需迁移**。
217
- """
218
- r = _norm_row(row)
219
- canon = "".join("%d:%s" % (len(r[c]), r[c]) for c in LEDGER_COLUMNS)
220
- return "he_" + hashlib.sha1(canon.encode("utf-8")).hexdigest()[:12]
221
-
222
-
223
- # 生效条件:payload 缺 ledger_row/frontmatter、结构键不可反解、反解与锚不一致
224
- # 或正文缺四段标记即 REJECT;逐字段一致且标记齐备即 ACCEPT(detail 带幂等 id);
225
- # 其它异常照抛(由 audit 包为 DEFER);
226
- def verify_payload(payload, ctx=None):
227
- """audit 验证器签名:回放比对(fm/content 反解 ↔ ledger_row 锚)。"""
228
- if not isinstance(payload, dict):
229
- return {"state": "REJECT", "evidence": "payload 须为 dict,得到 %s"
230
- % type(payload).__name__}
231
- row = payload.get("ledger_row")
232
- fm = payload.get("frontmatter")
233
- if not isinstance(fm, dict):
234
- fm = payload # 平铺形态:载荷自身承载 fm 键(writepipe 闸外直调)
235
- if not isinstance(row, dict):
236
- return {"state": "REJECT",
237
- "evidence": "payload 缺 ledger_row 锚(回执卡不自包含)"}
238
- try:
239
- anchored = {c: _clean(row.get(c)) for c in LEDGER_COLUMNS}
240
- rebuilt = rows_from_fm(fm) # 形态坏 → ValueError → REJECT
241
- except ValueError as exc:
242
- return {"state": "REJECT", "evidence": str(exc)}
243
- diffs = ["%s: %r != %r" % (c, anchored[c], rebuilt[c])
244
- for c in LEDGER_COLUMNS if anchored[c] != rebuilt[c]]
245
- if diffs:
246
- return {"state": "REJECT", "evidence": "回放比对不一致:%s" % "; ".join(diffs),
247
- "detail": {"field_diffs": diffs}}
248
- ctext = payload.get("content") if isinstance(payload.get("content"), str) else ""
249
- miss = [m for m in CONTENT_MARKERS if m not in ctext]
250
- if miss:
251
- return {"state": "REJECT", "evidence": "正文缺四段标记:%s(不自包含)" % miss}
252
- return {"state": "ACCEPT",
253
- "evidence": "回放重建六列逐字段一致(verify_id=%r)"
254
- % anchored["verify_id"],
255
- "detail": {"node_id": node_id_for(anchored)}}
256
-
257
-
258
- # 生效条件:audit_mod 提供 register_verifier 即把 verify_payload 以 override=True
259
- # 注入(重复加载幂等);
260
- def register(audit_mod):
261
- """MDCG_VERIFIER_MODULES 入口:把回放比对验证器注入 audit。"""
262
- audit_mod.register_verifier(CONTENT_KIND, verify_payload, override=True)
1
+ # -*- coding: utf-8 -*-
2
+ """超边(hyperedge):跨端验证回执的认知图形式化投影。
3
+
4
+ 上游真源 = 互验协议运行时文件(hive/interop/_receipts_ledger.tsv,六列);
5
+ 超边节点是历史回执在认知图中的**形式化镜像**(一行 = 一条超边,回执粒度),
6
+ 单向投影:超边不反向覆写台账,协议运行时逻辑零改动。
7
+
8
+ 六列 → fm + 正文完整自包含回执卡,机械映射零编造:
9
+ received_at / verify_id / commit / verdict / receipt_job / iter_id
10
+ - participants 定长二元 [verify_id, receipt_job](六列机械可得的全部参与者
11
+ 信息;role/harness/unit/session 归因字段台账无载,不编造)
12
+ - evidence [{verify_id, commit, verdict, received_at}]
13
+ - corrections [](迁移期恒空;后续跨端修正经修正面回填)
14
+ - ledger_row 六列整行锚(与结构键互为回放校验)
15
+
16
+ 幂等键:he_<sha1(六列值 join)[:12]>——同一台账行重复迁移得到同一节点 id。
17
+ (#157:原为 [:10](40 bit),与同仓 codeindex / docindex 的 [:12](48 bit)不
18
+ 对齐;生日界下 ~1e6 条即约 39% 碰撞概率,一旦撞上就是同 id 幂等 upsert ⇒ 回执
19
+ 静默丢失(实测 1,464,937 条内即撞出一条同 id,见守卫)。[:12] 是 [:10] 的
20
+ **前缀扩展**:新 id = 旧 id + hexdigest 的第 11–12 位。)
21
+
22
+ 验证器 verify_payload 做「结构键反解 ↔ ledger_row 锚」逐字段回放比对 + 正文
23
+ 四段标记检查,经 register_verifier("hyperedge", …) 注入(或 MDCG_VERIFIER_MODULES
24
+ 外部注入;未注入时 audit DEFER——诚实不假装通过)。
25
+
26
+ 本模块不含写库逻辑;写入由调用方走 cg(op=write, content_kind="hyperedge", …)
27
+ 经 writepipe 既有审核链(五动词纪律:不重复造写入通道)。
28
+ """
29
+ from __future__ import annotations
30
+
31
+ import hashlib
32
+
33
+ CONTENT_KIND = "hyperedge"
34
+ EDGE_TYPE = "cross_verify" # 唯一类型,留扩展位
35
+ SOURCE_NAME = "receipts_ledger" # 溯源锚(协议真源 TSV)
36
+ LEDGER_COLUMNS = ("received_at", "verify_id", "commit", "verdict",
37
+ "receipt_job", "iter_id")
38
+
39
+ # 写入面透传给 cg.add(**extra) 的 fm 键集合(writepipe._hyperedge_extra 按此
40
+ # 收集非 None 键)。落盘面丢字段 = 上游声明静默失效(比报错更难发现)。
41
+ EXTRA_FM_KEYS = ("content_kind", "edge_type", "participants", "evidence",
42
+ "corrections", "iter_id", "source", "received_at",
43
+ "verdict", "ledger_row")
44
+
45
+ # 正文四段标记(build_content 段落标题词;验证器检查齐备——无 fm 解析能力
46
+ # 的外部工具直读正文即可取数,这是「可被外部理解的正式结构」的最低保障)。
47
+ CONTENT_MARKERS = ("参与者", "证据", "修正", "时间")
48
+
49
+ _EMPTY_NOTE = "(台账原始行无此字段)" # 空字段的事实陈述(非编造占位)
50
+
51
+
52
+ # 生效条件:v 传入即归一为去空格字符串(None 得空串),无条件分支;
53
+ def _clean(v):
54
+ return "" if v is None else str(v).strip()
55
+
56
+
57
+ # 生效条件:row 为含六列键的 dict 时返回六列清洗副本;缺列或非 dict 即抛
58
+ # ValueError(fail-closed,不猜测补值);
59
+ def _norm_row(row):
60
+ if not isinstance(row, dict):
61
+ raise ValueError("台账行须为 dict(六列键),得到 %s" % type(row).__name__)
62
+ missing = [c for c in LEDGER_COLUMNS if c not in row]
63
+ if missing:
64
+ raise ValueError("台账行缺列:%s(fail-closed,不猜测补值)" % missing)
65
+ return {c: _clean(row.get(c)) for c in LEDGER_COLUMNS}
66
+
67
+
68
+ # 生效条件:row 经 _norm_row 校验即返回固定键集 fm(content_kind/edge_type/
69
+ # participants/evidence/corrections/iter_id/source/received_at/verdict/ledger_row);
70
+ def fm_from_row(row):
71
+ """台账行 → 超边 fm(schema v0.1,协议冻结前允许破坏性调整)。"""
72
+ r = _norm_row(row)
73
+ return {
74
+ "content_kind": CONTENT_KIND,
75
+ "edge_type": EDGE_TYPE,
76
+ # 定长二元:空串占位保证反解对称([0]→verify_id、[1]→receipt_job)。
77
+ "participants": [r["verify_id"], r["receipt_job"]],
78
+ "evidence": [{"verify_id": r["verify_id"], "commit": r["commit"],
79
+ "verdict": r["verdict"], "received_at": r["received_at"]}],
80
+ "corrections": [],
81
+ "iter_id": r["iter_id"],
82
+ "source": SOURCE_NAME,
83
+ "received_at": r["received_at"],
84
+ "verdict": r["verdict"],
85
+ "ledger_row": dict(r),
86
+ }
87
+
88
+
89
+ # 生效条件:fm 的 participants 为定长二元、evidence 为单项列表时返回六列重建
90
+ # 行(回放方向 H1:反解六列);形态不符即抛 ValueError;
91
+ def rows_from_fm(fm):
92
+ """fm 结构键 → 台账行(反解方向,不依赖 ledger_row 锚)。"""
93
+ parts = fm.get("participants")
94
+ if not isinstance(parts, list) or len(parts) != 2:
95
+ raise ValueError("participants 须为定长二元 [verify_id, receipt_job]")
96
+ ev = fm.get("evidence")
97
+ if not isinstance(ev, list) or len(ev) != 1 or not isinstance(ev[0], dict):
98
+ raise ValueError("evidence 须为单项列表"
99
+ "({verify_id, commit, verdict, received_at})")
100
+ e = ev[0]
101
+ return {
102
+ "received_at": _clean(e.get("received_at")),
103
+ "verify_id": _clean(parts[0]),
104
+ "commit": _clean(e.get("commit")),
105
+ "verdict": _clean(e.get("verdict")),
106
+ "receipt_job": _clean(parts[1]),
107
+ "iter_id": _clean(fm.get("iter_id")),
108
+ }
109
+
110
+
111
+ # 生效条件:fm 含六列信息(ledger_row 锚优先,缺锚走结构键反解)时返回六列行;
112
+ # 两者皆不可解析即抛 ValueError;
113
+ def _row_of_fm(fm):
114
+ anchored = fm.get("ledger_row")
115
+ if isinstance(anchored, dict):
116
+ return {c: _clean(anchored.get(c)) for c in LEDGER_COLUMNS}
117
+ return rows_from_fm(fm)
118
+
119
+
120
+ # 生效条件:fm 经 _row_of_fm 可解析即返回含四段标记(参与者/证据/修正/时间)
121
+ # 的正文,空字段以「台账原始行无此字段」事实陈述呈现;
122
+ def build_content(fm):
123
+ """超边 fm → 四段正文(参与者/证据/修正/时间)。"""
124
+ r = _row_of_fm(fm)
125
+
126
+ def v(col):
127
+ return r[col] if r[col] else _EMPTY_NOTE
128
+
129
+ corr = fm.get("corrections") or []
130
+ lines = [
131
+ "# 跨端验证超边(%s / %s)" % (CONTENT_KIND, EDGE_TYPE),
132
+ "",
133
+ "## 参与者",
134
+ "- verify_id: %s" % v("verify_id"),
135
+ "- receipt_job: %s" % v("receipt_job"),
136
+ "",
137
+ "## 证据",
138
+ "- commit: %s" % v("commit"),
139
+ "- verdict: %s" % v("verdict"),
140
+ "- received_at: %s" % v("received_at"),
141
+ "",
142
+ "## 修正",
143
+ ]
144
+ lines.extend(("- %s" % _clean(c) for c in corr if _clean(c)) if corr
145
+ else ["无(迁移期恒空;后续跨端修正经修正面回填)"])
146
+ lines.extend([
147
+ "",
148
+ "## 时间",
149
+ "- received_at: %s" % v("received_at"),
150
+ "- iter_id: %s" % v("iter_id"),
151
+ "",
152
+ "溯源:%s(TSV 真源单向投影,超边不反向覆写台账)" % SOURCE_NAME,
153
+ ])
154
+ return "\n".join(lines)
155
+
156
+
157
+ # 生效条件:row 经 _norm_row 校验即返回载荷 {ledger_row, frontmatter, content}
158
+ # (写入面读向齐备,幂等 id 另经 node_id_for 取);
159
+ def row_from_ledger(row):
160
+ """台账行 → 超边载荷({ledger_row, frontmatter, content})。"""
161
+ r = _norm_row(row)
162
+ fm = fm_from_row(r)
163
+ return {"ledger_row": dict(r), "frontmatter": fm,
164
+ "content": build_content(fm)}
165
+
166
+
167
+ # 生效条件:node 为 dict(frontmatter 嵌套或 fm 键平铺两形态)且结构键可反解
168
+ # 时返回载荷(ledger_row 优先取节点锚,缺锚用结构重建行);结构不可反解即抛
169
+ # ValueError;
170
+ def payload_from_node(node):
171
+ """节点 → 载荷(回放重建读向 H1)。"""
172
+ if not isinstance(node, dict):
173
+ raise ValueError("节点须为 dict")
174
+ fm = node.get("frontmatter") if isinstance(node.get("frontmatter"), dict) \
175
+ else node
176
+ anchored = fm.get("ledger_row")
177
+ rebuilt = rows_from_fm(fm)
178
+ row = ({c: _clean(anchored.get(c)) for c in LEDGER_COLUMNS}
179
+ if isinstance(anchored, dict) else rebuilt)
180
+ return {"ledger_row": row, "frontmatter": fm,
181
+ "content": node.get("content") or ""}
182
+
183
+
184
+ # 生效条件:a(writepipe 写入请求,fm 键平铺顶层)传入即返回验证器三键载荷
185
+ # {ledger_row, frontmatter, content}——frontmatter 收集 a 中非 None 的
186
+ # EXTRA_FM_KEYS 键;ledger_row 非 dict 时为 None(由验证器 fail-closed 裁决);
187
+ def audit_payload(a):
188
+ """writepipe audit 闸的超边载荷装配(fm 键平铺 → 三键载荷)。"""
189
+ row = a.get("ledger_row")
190
+ return {"ledger_row": row if isinstance(row, dict) else None,
191
+ "frontmatter": {k: a.get(k) for k in EXTRA_FM_KEYS
192
+ if a.get(k) is not None},
193
+ "content": a.get("content") or ""}
194
+
195
+
196
+ # 生效条件:row 经 _norm_row 校验即返回 he_<sha1(逐列「len:val」拼接)[:12]>
197
+ # (同一台账行恒同 id,重复迁移幂等;任意列内容不可伪造边界);
198
+ def node_id_for(row):
199
+ """幂等键:同一台账行重复迁移得到同一节点 id。
200
+
201
+ **无歧义规范化**(2026-09-20 v14 缺陷 G 修复):逐列 `<len>:<val>` 前缀
202
+ 拼接——长度前缀由本函数计算、不可被列内容伪造,故任意两列之间搬移含任意
203
+ 字符的文本都得不同 canon。旧实现直接 `"\\x1f".join(...)`:`verify_id="a"`
204
+ + `commit="b\\x1fc"` 与 `verify_id="a\\x1fb"` + `commit="c"` 撞同一 id
205
+ (不是 SHA-1 碰撞,是规范化没做转义/长度前缀)。
206
+
207
+ id 口径变更说明:canon 输入形态改变 → id 取值随之改变。属 schema v0.1
208
+ 内的破坏性调整(该 schema 明示允许);实测库内 `he_` 节点为 0,无历史
209
+ 迁移数据需兼容。
210
+
211
+ #157(2026-10-12)截断位宽变更:[:10] → [:12](对齐 codeindex:270 /
212
+ docindex 的同类幂等键口径)。id 取值随之改变,但两者是**前缀关系**
213
+ ——新 id 的前 10 位恒等于旧 id,故即便库内确有 `he_` 节点,迁移口径 =
214
+ 按节点自身 ledger_row 重算 id 后改名/改键(前缀可直接互校,不存在无法
215
+ 反解的旧 id);本仓追踪面复核(grep `he_<hex>`)命中 0 处,与上段
216
+ 「库内 he_ 节点为 0」一致,故**无需迁移**。
217
+ """
218
+ r = _norm_row(row)
219
+ canon = "".join("%d:%s" % (len(r[c]), r[c]) for c in LEDGER_COLUMNS)
220
+ return "he_" + hashlib.sha1(canon.encode("utf-8")).hexdigest()[:12]
221
+
222
+
223
+ # 生效条件:payload 缺 ledger_row/frontmatter、结构键不可反解、反解与锚不一致
224
+ # 或正文缺四段标记即 REJECT;逐字段一致且标记齐备即 ACCEPT(detail 带幂等 id);
225
+ # 其它异常照抛(由 audit 包为 DEFER);
226
+ def verify_payload(payload, ctx=None):
227
+ """audit 验证器签名:回放比对(fm/content 反解 ↔ ledger_row 锚)。"""
228
+ if not isinstance(payload, dict):
229
+ return {"state": "REJECT", "evidence": "payload 须为 dict,得到 %s"
230
+ % type(payload).__name__}
231
+ row = payload.get("ledger_row")
232
+ fm = payload.get("frontmatter")
233
+ if not isinstance(fm, dict):
234
+ fm = payload # 平铺形态:载荷自身承载 fm 键(writepipe 闸外直调)
235
+ if not isinstance(row, dict):
236
+ return {"state": "REJECT",
237
+ "evidence": "payload 缺 ledger_row 锚(回执卡不自包含)"}
238
+ try:
239
+ anchored = {c: _clean(row.get(c)) for c in LEDGER_COLUMNS}
240
+ rebuilt = rows_from_fm(fm) # 形态坏 → ValueError → REJECT
241
+ except ValueError as exc:
242
+ return {"state": "REJECT", "evidence": str(exc)}
243
+ diffs = ["%s: %r != %r" % (c, anchored[c], rebuilt[c])
244
+ for c in LEDGER_COLUMNS if anchored[c] != rebuilt[c]]
245
+ if diffs:
246
+ return {"state": "REJECT", "evidence": "回放比对不一致:%s" % "; ".join(diffs),
247
+ "detail": {"field_diffs": diffs}}
248
+ ctext = payload.get("content") if isinstance(payload.get("content"), str) else ""
249
+ miss = [m for m in CONTENT_MARKERS if m not in ctext]
250
+ if miss:
251
+ return {"state": "REJECT", "evidence": "正文缺四段标记:%s(不自包含)" % miss}
252
+ return {"state": "ACCEPT",
253
+ "evidence": "回放重建六列逐字段一致(verify_id=%r)"
254
+ % anchored["verify_id"],
255
+ "detail": {"node_id": node_id_for(anchored)}}
256
+
257
+
258
+ # 生效条件:audit_mod 提供 register_verifier 即把 verify_payload 以 override=True
259
+ # 注入(重复加载幂等);
260
+ def register(audit_mod):
261
+ """MDCG_VERIFIER_MODULES 入口:把回放比对验证器注入 audit。"""
262
+ audit_mod.register_verifier(CONTENT_KIND, verify_payload, override=True)