@furongjun1999/dsh-memory 0.9.6 → 0.9.7

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 (216) hide show
  1. package/data/policy.json +38 -38
  2. package/docs/discipline/templates/spec.txt.tmpl +1 -1
  3. package/dsh/cordis.yml.example +139 -139
  4. package/lib/hooks.d.ts +19 -0
  5. package/lib/hooks.js +29 -6
  6. package/lib/index.js +11 -2
  7. package/lib/lib/hook_audit.js +38 -2
  8. package/lib/lib/prompt_safety.js +14 -3
  9. package/lib/tools.d.ts +7 -0
  10. package/lib/tools.js +22 -1
  11. package/md_cg/_guard_kit.py +121 -121
  12. package/md_cg/anchor.py +114 -114
  13. package/md_cg/audit.py +15 -2
  14. package/md_cg/chain.py +3 -2
  15. package/md_cg/config_registry_guard.py +487 -487
  16. package/md_cg/conformance.py +747 -747
  17. package/md_cg/consolidate.py +1793 -1793
  18. package/md_cg/crypto.py +794 -794
  19. package/md_cg/hyperedge.py +262 -262
  20. package/md_cg/interface_schema.py +146 -146
  21. package/md_cg/lifecycle.py +426 -426
  22. package/md_cg/mdcos.py +12 -8
  23. package/md_cg/predict.py +1103 -1103
  24. package/md_cg/protect.py +654 -654
  25. package/md_cg/provenance.py +606 -606
  26. package/md_cg/queue_health.py +130 -130
  27. package/md_cg/refine.py +613 -613
  28. package/md_cg/retrieve.py +128 -128
  29. package/md_cg/revise.py +140 -140
  30. package/md_cg/rollback.py +657 -657
  31. package/md_cg/rollback_cli.py +124 -124
  32. package/md_cg/rotate.py +346 -346
  33. package/md_cg/routing.py +490 -490
  34. package/md_cg/self_surface.py +50 -50
  35. package/md_cg/semantic/canonical.py +144 -144
  36. package/md_cg/semantic/zh_en_atoms.py +141 -141
  37. package/md_cg/sources.py +1091 -1091
  38. package/md_cg/stg.py +3 -2
  39. package/md_cg/test_audit_rotate_parity.py +279 -279
  40. package/md_cg/test_autonomy_modes.py +2013 -2013
  41. package/md_cg/test_cn_recall_grams.py +206 -206
  42. package/md_cg/test_code_kind_forbidden.py +101 -0
  43. package/md_cg/test_condaccept.py +156 -156
  44. package/md_cg/test_condgate.py +141 -141
  45. package/md_cg/test_heartbeat_ledger.py +557 -557
  46. package/md_cg/test_i50e_readside_protection.py +658 -658
  47. package/md_cg/test_issue111_gate_order.py +76 -76
  48. package/md_cg/test_issue111_scoring_contract.py +86 -86
  49. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  50. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  51. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  52. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  53. package/md_cg/test_issue149_accel_default_face.py +248 -248
  54. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  55. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  56. package/md_cg/test_issue152_sealed_postings.py +309 -309
  57. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  58. package/md_cg/test_issue157b_index_remainder.py +344 -344
  59. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  60. package/md_cg/test_issue191_import_trust.py +382 -382
  61. package/md_cg/test_issue193_write_scope.py +378 -378
  62. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  63. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  64. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  65. package/md_cg/test_issue216_clash_routes.py +214 -214
  66. package/md_cg/test_issue217_slot_routes.py +248 -248
  67. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  68. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  69. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  70. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  71. package/md_cg/test_issue275_layer_param.py +250 -250
  72. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  73. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  74. package/md_cg/test_issue278_neg_window.py +294 -294
  75. package/md_cg/test_issue278_negative_layering.py +83 -83
  76. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  77. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  78. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  79. package/md_cg/test_issue303_design_boundaries.py +262 -262
  80. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  81. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  82. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  83. package/md_cg/test_issue322_node_write_lock.py +727 -727
  84. package/md_cg/test_issue324_write_size_fields.py +214 -214
  85. package/md_cg/test_issue325_audit_poison.py +229 -229
  86. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  87. package/md_cg/test_issue326_key_perms.py +355 -355
  88. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  89. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  90. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  91. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  92. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  93. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  94. package/md_cg/test_issue350_casefold_collision.py +235 -235
  95. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  96. package/md_cg/test_issue352_imgaudit.py +418 -418
  97. package/md_cg/test_issue352_pathsjson.py +537 -537
  98. package/md_cg/test_issue352_refindex.py +412 -412
  99. package/md_cg/test_issue352_rollback.py +604 -604
  100. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  101. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  102. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  103. package/md_cg/test_issue358_truncation_observable.py +247 -247
  104. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  105. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  106. package/md_cg/test_issue362_neg_condition.py +468 -468
  107. package/md_cg/test_issue363_lexical_idf.py +275 -275
  108. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  109. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  110. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  111. package/md_cg/test_issue378_protected_floor.py +310 -310
  112. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  113. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  114. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  115. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  116. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  117. package/md_cg/test_issue404_heal_receipt.py +389 -389
  118. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  119. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  120. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  121. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  122. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  123. package/md_cg/test_issue413_preimage_twin.py +339 -339
  124. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  125. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  126. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  127. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  128. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  129. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  130. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  131. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  132. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  133. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  134. package/md_cg/test_issue434_435_float_gate.py +90 -90
  135. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  136. package/md_cg/test_issue43_default_policy.py +874 -874
  137. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  138. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  139. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  140. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  141. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  142. package/md_cg/test_issue451_audit_actor.py +313 -313
  143. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  144. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  145. package/md_cg/test_issue466_basis_registry.py +469 -469
  146. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  147. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  148. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  149. package/md_cg/test_issue471_identity_readable.py +136 -136
  150. package/md_cg/test_issue472_audit_chain.py +90 -90
  151. package/md_cg/test_issue472_prune_ledger.py +105 -105
  152. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  153. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  154. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  155. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  156. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  157. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  158. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  159. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  160. package/md_cg/test_issue547_audit_durable.py +96 -96
  161. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  162. package/md_cg/test_issue559_refine_prefix.py +69 -69
  163. package/md_cg/test_issue562_retired_faces.py +150 -0
  164. package/md_cg/test_issue71_queue_backlog.py +376 -376
  165. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  166. package/md_cg/test_issue82_credential_rules.py +271 -271
  167. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  168. package/md_cg/test_issue93_remember_redaction.py +282 -282
  169. package/md_cg/test_logref.py +1141 -1141
  170. package/md_cg/test_md_access_parity.py +330 -330
  171. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  172. package/md_cg/test_mutation_residue.py +119 -119
  173. package/md_cg/test_mutation_rollback.py +835 -835
  174. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  175. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  176. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  177. package/md_cg/test_neg_tail_honesty.py +733 -733
  178. package/md_cg/test_p21_tokens.py +294 -294
  179. package/md_cg/test_p27_docindex.py +792 -792
  180. package/md_cg/test_p28_refcheck.py +1053 -1053
  181. package/md_cg/test_p2_six_elements.py +476 -476
  182. package/md_cg/test_p33_ccg_wiring.py +300 -300
  183. package/md_cg/test_p3_legacy_closure.py +438 -438
  184. package/md_cg/test_p40_refine_worklist.py +244 -244
  185. package/md_cg/test_p4_freshness.py +781 -781
  186. package/md_cg/test_p9c_dedup_hints.py +288 -288
  187. package/md_cg/test_policy_required_ccg.py +444 -444
  188. package/md_cg/test_retr_s5.py +312 -312
  189. package/md_cg/test_s1_ast_judge.py +109 -109
  190. package/md_cg/test_state_event_op.py +521 -521
  191. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  192. package/md_cg/test_sustain_bounded.py +652 -652
  193. package/md_cg/test_trust_edge_reachability.py +405 -405
  194. package/md_cg/test_w7_redlines.py +659 -659
  195. package/md_cg/test_write_return_shape.py +919 -919
  196. package/md_cg/test_writepipe.py +228 -228
  197. package/md_cg/trust.py +1114 -1114
  198. package/md_cg/twophase.py +303 -303
  199. package/md_cg/whitebox.py +536 -536
  200. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  201. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  202. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  203. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  204. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  205. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  206. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  207. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  208. package/md_cg/writepipe.py +1337 -1337
  209. package/package.json +3 -2
  210. package/scripts/workspace_index.py +328 -0
  211. package/src/hooks.ts +30 -6
  212. package/src/index.ts +14 -5
  213. package/src/lib/hook_audit.ts +282 -256
  214. package/src/lib/mdcg_client.ts +469 -469
  215. package/src/lib/prompt_safety.ts +17 -3
  216. package/src/tools.ts +23 -1
@@ -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)