@furongjun1999/dsh-memory 0.4.7 → 0.4.9

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 (325) hide show
  1. package/README.md +130 -47
  2. package/codebuddy/CODEBUDDY.md +21 -10
  3. package/codebuddy/README.md +13 -1
  4. package/codebuddy/mcp.json +9 -0
  5. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +169 -0
  6. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +144 -0
  7. package/docs/README.md +111 -0
  8. package/docs/discipline/harnesses.yaml +226 -152
  9. package/docs/discipline/templates/full.md.tmpl +61 -58
  10. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.md +127 -0
  11. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  12. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +202 -0
  13. package/docs/experiments/linkref_backfill/candidates_20260917.json +726 -0
  14. package/docs/experiments/linkref_backfill/candidates_internal_20260917.json +602 -0
  15. package/docs/experiments/linkref_backfill/candidates_internal_v2.json +603 -0
  16. package/docs/experiments/linkref_backfill/candidates_secret_20260917.json +884 -0
  17. package/docs/experiments/linkref_backfill/candidates_secret_v2.json +789 -0
  18. package/docs/experiments/m4-role-probe/census.py +86 -0
  19. package/docs/experiments/m4-role-probe/probe.py +89 -0
  20. package/docs/experiments/mapped_confidence/bench_mapped_conf.py +216 -0
  21. package/docs/experiments/mapped_confidence/post_check.py +75 -0
  22. package/docs/experiments/mapped_confidence/repro_thirdparty_tol.py +83 -0
  23. package/docs/experiments/mapped_confidence/result_mapped_conf.json +215 -0
  24. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +42 -0
  25. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +43 -0
  26. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +102 -0
  27. package/docs/hive//347/234/237/345/256/236/345/272/223/347/253/257/345/210/260/347/253/257/345/256/236/346/265/213_S1b/344/270/216/345/217/254/345/233/236/346/235/203/350/241/241_v0.1.md +57 -0
  28. package/docs/hive//347/234/237/345/256/236/345/272/223/347/253/257/345/210/260/347/253/257/345/256/236/346/265/213_S7/345/200/222/346/216/222/345/200/231/351/200/211/345/261/202_v0.1.md +126 -0
  29. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +503 -0
  30. package/docs/{ → hive/}/350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +14 -2
  31. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +216 -0
  32. package/docs/{README → mdcg/README}/350/257/246/347/273/206/347/211/210_v0.4.5.md +631 -625
  33. package/docs/{ → mdcg/}/344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +1 -1
  34. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +82 -0
  35. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +600 -0
  36. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +263 -0
  37. package/docs/{ → mdcg/}/345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +1 -1
  38. package/docs/mdcg//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +236 -0
  39. package/docs/{ → mdcg/}/346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +2 -2
  40. package/docs/{ → mdcg/}/347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +181 -181
  41. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +172 -0
  42. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +31 -0
  43. package/docs/{ → mdcg/}/347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +2 -2
  44. package/docs/{ → mdcg/}/350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +1 -1
  45. package/docs/{ → mdcg/}/350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +4 -4
  46. package/docs/{ → mdcg/}/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +2 -2
  47. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +93 -0
  48. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +176 -0
  49. package/docs/{ → swarm/}/350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +3 -3
  50. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +242 -0
  51. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +129 -0
  52. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +134 -0
  53. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +145 -0
  54. package/docs/{ → theory/}/347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +6 -6
  55. package/docs/{ → theory/}/347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +1 -1
  56. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +221 -0
  57. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +237 -0
  58. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +98 -0
  59. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +109 -0
  60. package/docs//345/267/245/344/275/234/347/272/252/345/276/213_/350/256/244/347/237/245/345/233/276/346/235/241/347/233/256_v1.1.json +434 -405
  61. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +286 -0
  62. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +104 -0
  63. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +183 -0
  64. package/dsh/README.md +34 -1
  65. package/dsh/cordis.yml.example +13 -7
  66. package/dsh/hive-mcp-probe.mjs +94 -0
  67. package/dsh/hive-mcp.example.yml +62 -0
  68. package/dsh/update-lingshu.bat +11 -0
  69. package/dsh/update-lingshu.ps1 +337 -0
  70. package/lib/hooks.d.ts +8 -0
  71. package/lib/hooks.js +27 -24
  72. package/lib/index.d.ts +4 -2
  73. package/lib/index.js +29 -6
  74. package/lib/lib/datapath.d.ts +76 -1
  75. package/lib/lib/datapath.js +199 -13
  76. package/lib/lib/mdcg_client.d.ts +6 -3
  77. package/lib/lib/mdcg_client.js +6 -5
  78. package/lib/lib/mutual.js +4 -4
  79. package/lib/lib/prompt_safety.d.ts +48 -0
  80. package/lib/lib/prompt_safety.js +62 -0
  81. package/lib/lib/token_store.js +4 -5
  82. package/md_cg/audit.py +91 -2
  83. package/md_cg/autonomy.py +86 -15
  84. package/md_cg/backfill.py +36 -1
  85. package/md_cg/backfill_bigdomain.py +34 -0
  86. package/md_cg/bench6_arms.py +28 -1
  87. package/md_cg/bench6_common.py +10 -1
  88. package/md_cg/bench6_competitors.py +6 -1
  89. package/md_cg/bench_axis_domain.py +9 -1
  90. package/md_cg/bench_blind_comp.py +7 -1
  91. package/md_cg/bench_en_atoms_public.py +9 -0
  92. package/md_cg/bench_governance.py +348 -0
  93. package/md_cg/bench_lme_zh.py +16 -1
  94. package/md_cg/bench_locomo.py +2 -1
  95. package/md_cg/bench_locomo_zh.py +16 -1
  96. package/md_cg/bench_locomo_zh_public.py +4 -1
  97. package/md_cg/bench_longmem.py +2 -1
  98. package/md_cg/bench_membench.py +37 -6
  99. package/md_cg/bench_p0.py +4 -1
  100. package/md_cg/bench_progressive.py +61 -10
  101. package/md_cg/bench_role_views.py +238 -0
  102. package/md_cg/bench_task_ab.py +8 -1
  103. package/md_cg/bench_task_ab_llm.py +13 -1
  104. package/md_cg/bench_unified_en.py +6 -1
  105. package/md_cg/bench_zh_mad.py +20 -1
  106. package/md_cg/blindspot_tickets.py +123 -0
  107. package/md_cg/branches.py +286 -0
  108. package/md_cg/build_postings.py +73 -0
  109. package/md_cg/ccgc.py +949 -0
  110. package/md_cg/census.py +5 -1
  111. package/md_cg/chain.py +24 -3
  112. package/md_cg/codeindex.py +134 -17
  113. package/md_cg/coldverify.py +265 -0
  114. package/md_cg/comment_gate.py +338 -0
  115. package/md_cg/cond_compose.py +190 -0
  116. package/md_cg/cond_facts.py +155 -0
  117. package/md_cg/cond_template.json +107 -0
  118. package/md_cg/condition_anchor.py +143 -0
  119. package/md_cg/conformance.py +727 -0
  120. package/md_cg/consistency.py +25 -2
  121. package/md_cg/consolidate.py +53 -2
  122. package/md_cg/corpus.py +5 -1
  123. package/md_cg/crosscheck.py +42 -2
  124. package/md_cg/crypto.py +35 -1
  125. package/md_cg/d_meta.py +310 -0
  126. package/md_cg/datapath.py +201 -26
  127. package/md_cg/docindex.py +122 -1
  128. package/md_cg/eval_common.py +35 -6
  129. package/md_cg/evidence.py +27 -1
  130. package/md_cg/evolution.py +21 -1
  131. package/md_cg/export.py +11 -1
  132. package/md_cg/forgetting.py +34 -4
  133. package/md_cg/fsutil.py +81 -2
  134. package/md_cg/hotcache.py +214 -0
  135. package/md_cg/hyperedge.py +251 -0
  136. package/md_cg/identity.py +20 -3
  137. package/md_cg/insight.py +19 -3
  138. package/md_cg/lexicon/build_cedict_en_zh.py +9 -0
  139. package/md_cg/lexicon/build_standard_en.py +171 -168
  140. package/md_cg/lexicon/expand_en_zh.py +6 -0
  141. package/md_cg/lifecycle.py +273 -0
  142. package/md_cg/linkref.py +281 -0
  143. package/md_cg/links.py +29 -1
  144. package/md_cg/mcp_server.py +894 -168
  145. package/md_cg/md_whitebox.py +53 -1
  146. package/md_cg/mdcg.py +1205 -41
  147. package/md_cg/mdcos.py +1060 -76
  148. package/md_cg/metacognition.py +39 -4
  149. package/md_cg/migrate.py +4 -0
  150. package/md_cg/migrate_aeis.py +221 -213
  151. package/md_cg/migrate_roleplay.py +8 -0
  152. package/md_cg/migrate_wisdom_graph.py +14 -1
  153. package/md_cg/mreview/__init__.py +25 -0
  154. package/md_cg/mreview/__main__.py +110 -0
  155. package/md_cg/mreview/bundle.py +178 -0
  156. package/md_cg/mreview/candidates.py +262 -0
  157. package/md_cg/mreview/govern.py +694 -0
  158. package/md_cg/mreview/locate.py +939 -0
  159. package/md_cg/mreview/pipeline.py +729 -0
  160. package/md_cg/mreview/rules/duplication.json +21 -0
  161. package/md_cg/mreview/rules/field_coverage.json +54 -0
  162. package/md_cg/mreview/rules/source_license.json +21 -0
  163. package/md_cg/mreview/rules/template_flow.json +21 -0
  164. package/md_cg/mreview/ruleset.py +253 -0
  165. package/md_cg/nodefile.py +269 -1
  166. package/md_cg/pooling.py +23 -1
  167. package/md_cg/postings.py +298 -0
  168. package/md_cg/predict.py +113 -15
  169. package/md_cg/progressive.py +3 -0
  170. package/md_cg/protect.py +18 -5
  171. package/md_cg/protocol.py +372 -0
  172. package/md_cg/provenance.py +262 -0
  173. package/md_cg/reach.py +453 -0
  174. package/md_cg/refindex.py +88 -4
  175. package/md_cg/refine.py +20 -1
  176. package/md_cg/roleviews.py +89 -0
  177. package/md_cg/routing.py +76 -0
  178. package/md_cg/scrub.py +68 -3
  179. package/md_cg/security.py +26 -1
  180. package/md_cg/self_state.py +65 -2
  181. package/md_cg/selfreport.py +151 -0
  182. package/md_cg/semantic/canonical.py +5 -0
  183. package/md_cg/semantic/en_normalizer.py +364 -295
  184. package/md_cg/semantic/zh_en_atoms.py +139 -136
  185. package/md_cg/signer.py +41 -1
  186. package/md_cg/sources.py +583 -547
  187. package/md_cg/statushdr.py +179 -0
  188. package/md_cg/stg.py +59 -18
  189. package/md_cg/subgraph.py +23 -0
  190. package/md_cg/sustain.py +74 -1
  191. package/md_cg/tasks.py +471 -0
  192. package/md_cg/test_action_derive.py +203 -0
  193. package/md_cg/test_audit_rotate.py +270 -0
  194. package/md_cg/test_autonomy.py +26 -0
  195. package/md_cg/test_bench_governance.py +102 -0
  196. package/md_cg/test_blindspot_tickets.py +166 -0
  197. package/md_cg/test_branches.py +249 -0
  198. package/md_cg/test_ccg_perturb.py +1 -1
  199. package/md_cg/test_ccgc.py +433 -0
  200. package/md_cg/test_codeindex.py +338 -0
  201. package/md_cg/test_comment_gate.py +187 -0
  202. package/md_cg/test_cond_compose_anchors.py +76 -0
  203. package/md_cg/test_condition_anchor.py +82 -0
  204. package/md_cg/test_conformance.py +343 -0
  205. package/md_cg/test_d_meta.py +412 -0
  206. package/md_cg/test_datapath_root.py +188 -0
  207. package/md_cg/test_en_pipeline.py +24 -0
  208. package/md_cg/test_gain_gate.py +47 -1
  209. package/md_cg/test_health_scale.py +173 -0
  210. package/md_cg/test_hot_cold.py +187 -0
  211. package/md_cg/test_hyperedge.py +245 -0
  212. package/md_cg/test_identity_attribution.py +6 -0
  213. package/md_cg/test_index_durability.py +224 -0
  214. package/md_cg/test_lifecycle.py +309 -0
  215. package/md_cg/test_linkref.py +306 -0
  216. package/md_cg/test_md_access_parity.py +15 -3
  217. package/md_cg/test_mr_m1.py +769 -0
  218. package/md_cg/test_mr_m2.py +587 -0
  219. package/md_cg/test_mr_m3.py +710 -0
  220. package/md_cg/test_mr_m4.py +485 -0
  221. package/md_cg/test_p1.py +1 -1
  222. package/md_cg/test_p11_consistency.py +1 -1
  223. package/md_cg/test_p12_metacognition.py +2 -2
  224. package/md_cg/test_p16_self_state.py +1 -1
  225. package/md_cg/test_p26_refindex.py +50 -21
  226. package/md_cg/test_p27_docindex.py +258 -4
  227. package/md_cg/test_p28_refcheck.py +1 -1
  228. package/md_cg/test_p29_session_ingest_export.py +1 -1
  229. package/md_cg/test_p2_mcp.py +7 -1
  230. package/md_cg/test_p31_insight.py +24 -0
  231. package/md_cg/test_p38_contextualize.py +1 -1
  232. package/md_cg/test_p39_vision_evidence.py +1 -1
  233. package/md_cg/test_p40_refine_worklist.py +1 -1
  234. package/md_cg/test_p41_evolve_patrol.py +1 -1
  235. package/md_cg/test_p42_provenance.py +1 -1
  236. package/md_cg/test_p43_pooling.py +41 -13
  237. package/md_cg/test_p44_md_whitebox.py +14 -1
  238. package/md_cg/test_protocol.py +243 -0
  239. package/md_cg/test_reach.py +378 -0
  240. package/md_cg/test_reach_keys.py +201 -0
  241. package/md_cg/test_reach_meta_exits.py +145 -0
  242. package/md_cg/test_read_clip.py +141 -0
  243. package/md_cg/test_retr_s1.py +340 -0
  244. package/md_cg/test_retr_s1b.py +209 -0
  245. package/md_cg/test_retr_s3.py +194 -0
  246. package/md_cg/test_retr_s4.py +163 -0
  247. package/md_cg/test_retr_s5.py +200 -0
  248. package/md_cg/test_retr_s6.py +157 -0
  249. package/md_cg/test_retr_s7.py +385 -0
  250. package/md_cg/test_retr_s8_time.py +316 -0
  251. package/md_cg/test_retr_s9_edges.py +286 -0
  252. package/md_cg/test_retr_s9_entity_ctx.py +175 -0
  253. package/md_cg/test_review_conformance.py +367 -0
  254. package/md_cg/test_role_views.py +354 -0
  255. package/md_cg/test_tasks.py +409 -0
  256. package/md_cg/test_tool_face.py +189 -0
  257. package/md_cg/test_trust.py +361 -0
  258. package/md_cg/test_twophase.py +286 -0
  259. package/md_cg/test_units_poll.py +71 -0
  260. package/md_cg/test_v14_fixes.py +397 -0
  261. package/md_cg/test_validity_filter.py +280 -0
  262. package/md_cg/test_wisdom_md_store.py +7 -3
  263. package/md_cg/test_writepipe.py +214 -0
  264. package/md_cg/theory.py +17 -2
  265. package/md_cg/tokens.py +134 -12
  266. package/md_cg/tool_face.py +261 -0
  267. package/md_cg/trust.py +943 -0
  268. package/md_cg/twophase.py +232 -0
  269. package/md_cg/units.py +665 -0
  270. package/md_cg/vision_evidence.py +25 -2
  271. package/md_cg/weights.py +25 -2
  272. package/md_cg/whitebox.py +33 -2
  273. package/md_cg/whitebox_kb/data/verify_cache.json +21233 -360
  274. package/md_cg/whitebox_kb/data/verify_savings.jsonl +5124 -0
  275. package/md_cg/whitebox_kb/wisdom/audit_log/chain_heat.json +10 -10
  276. package/md_cg/whitebox_kb/wisdom/code_compose.py +113 -6
  277. package/md_cg/whitebox_kb/wisdom/code_solidified.json +1 -1
  278. package/md_cg/whitebox_kb/wisdom/verifier.py +340 -55
  279. package/md_cg/whitebox_kb/wisdom/wisdom-book-cloud.db +0 -0
  280. package/md_cg/writelimit.py +37 -7
  281. package/md_cg/writepipe.py +543 -0
  282. package/package.json +2 -2
  283. package/skills/skills/designer-perspective/scripts/__pycache__/designer.cpython-310.pyc +0 -0
  284. package/skills/skills/designer-perspective/scripts/designer.py +17 -1
  285. package/skills/skills/designer-perspective/tests/selftest.py +3 -1
  286. package/src/hooks.ts +27 -22
  287. package/src/index.ts +33 -6
  288. package/src/lib/datapath.ts +211 -13
  289. package/src/lib/mdcg_client.ts +12 -8
  290. package/src/lib/mutual.ts +411 -411
  291. package/src/lib/prompt_safety.ts +62 -0
  292. package/src/lib/token_store.ts +4 -5
  293. package/zcode/AGENTS.md +21 -10
  294. package/zcode/README.md +4 -0
  295. package/docs//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -221
  296. /package/docs/{AGI → eval/AGI}/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md" +0 -0
  297. /package/docs/{AGI → eval/AGI}/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md" +0 -0
  298. /package/docs/{ → eval/}/345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md" +0 -0
  299. /package/docs/{ → eval/}/346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md" +0 -0
  300. /package/docs/{guardrail-charter.md → mdcg/guardrail-charter.md} +0 -0
  301. /package/docs/{lingshu_tutorial.html → mdcg/lingshu_tutorial.html} +0 -0
  302. /package/docs/{memory-assessment.html → mdcg/memory-assessment.html} +0 -0
  303. /package/docs/{memory_score.html → mdcg/memory_score.html} +0 -0
  304. /package/docs/{memory_score.png → mdcg/memory_score.png} +0 -0
  305. /package/docs/{release_v0.3.0.md → mdcg/release_v0.3.0.md} +0 -0
  306. /package/docs/{release_v0.4.5.md → mdcg/release_v0.4.5.md} +0 -0
  307. /package/docs/{tool_table_v0.3.0.md → mdcg/tool_table_v0.3.0.md} +0 -0
  308. /package/docs/{ → mdcg/}/344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md" +0 -0
  309. /package/docs/{ → mdcg/}/347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md" +0 -0
  310. /package/docs/{ → mdcg/}/347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md" +0 -0
  311. /package/docs/{ → mdcg/}/347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md" +0 -0
  312. /package/docs/{ → mdcg/}/350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md" +0 -0
  313. /package/docs/{ → mdcg/}/350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md" +0 -0
  314. /package/docs/{ → mdcg/}/350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md" +0 -0
  315. /package/docs/{ → plans/}/345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md" +0 -0
  316. /package/docs/{ → plans/}/347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md" +0 -0
  317. /package/docs/{ → swarm/}/350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md" +0 -0
  318. /package/docs/{ → swarm/}/350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md" +0 -0
  319. /package/docs/{ → swarm/}/350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md" +0 -0
  320. /package/docs/{ → theory/}/344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md" +0 -0
  321. /package/docs/{ → theory/}/346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md" +0 -0
  322. /package/docs/{ → theory/}/346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md" +0 -0
  323. /package/docs/{ → theory/}/346/231/272/350/203/275/350/256/2723.4.md" +0 -0
  324. /package/docs/{ → theory/}/347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md" +0 -0
  325. /package/docs/{ → theory/}/347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md" +0 -0
@@ -0,0 +1,175 @@
1
+ # -*- coding: utf-8 -*-
2
+ """S9b 三元组反查 · 工具面集成探针(阶段二 4.2 T9,脚本式,exit code 定成败)。
3
+
4
+ 用法:python -X utf8 -m md_cg.test_retr_s9_entity_ctx
5
+ 库层原语语义归 `test_retr_s9_edges.py`,本件只测**工具面集成**:
6
+ - 分派全链路:`_cg_dispatch` / `_cg_call` → `_edges_call` → `provenance.find_edges`
7
+ - op 缺省推导防呆负例:`child=` 不构成 edges 签名,漏 op 走 read 不冒充反查
8
+ - 权限闸双面:`ops_allow` 含 edges 放行;不含 → AccessDenied(通配 "*" 不限)
9
+ - 渐进披露:slim 后 op=edges 段被投影、职责行 ≤160;`op=help,query=edges` 无损取回
10
+ - schema 一致性:扁平参数面与库层签名同形(含 expand_nodes);无 subject/predicate/object 第二套参数
11
+ - 协议对账:`protocol.audit` AST 自动发现 edges(extension_ops 报告项,ok=True)
12
+ - FUNC_DESC 覆盖守卫:cogmap_sync 功能描述表必须登记 ("cg", "edges")
13
+ """
14
+ import inspect
15
+ import json
16
+ import os
17
+ import sys
18
+ import tempfile
19
+
20
+ sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
21
+
22
+ from md_cg import provenance, protocol, tool_face as tf # noqa: E402
23
+ from md_cg.mdcg import MdCG # noqa: E402
24
+ from md_cg.mdcos import MdCGSecure # noqa: E402
25
+ from md_cg.security import AccessDenied, Principal # noqa: E402
26
+ from md_cg import mcp_server as ms # noqa: E402
27
+
28
+ passed = 0
29
+ failed = 0
30
+ T = "阿尔法 三元组 反查 探针"
31
+
32
+ # _edges_call 透传的扁平参数面(schema ↔ 实现同形守卫的期望集)
33
+ EDGE_ARGS = ("child", "parent", "relation", "batch",
34
+ "start_time", "end_time", "start_operator", "end_operator",
35
+ "time_axis", "ordering", "offset", "limit", "aggregation",
36
+ "expand_nodes")
37
+
38
+
39
+ def check(name, cond, detail=""):
40
+ global passed, failed
41
+ if cond:
42
+ passed += 1
43
+ print(" [PASS] " + name)
44
+ else:
45
+ failed += 1
46
+ print(" [FAIL] " + name + " " + detail)
47
+
48
+
49
+ def _build(root):
50
+ cg = MdCG(root)
51
+ for nid in ("p1", "p2"):
52
+ cg.add(nid, T, "knowledge")
53
+ cg.add("a1", T, "knowledge", derived_from=["p1"])
54
+ cg.add("a2", T, "knowledge", derived_from=["p1"], relation="extracted_from")
55
+ cg.flush()
56
+ return cg
57
+
58
+
59
+ def _raises(exc, fn):
60
+ try:
61
+ fn()
62
+ except exc:
63
+ return True
64
+ except Exception: # noqa: BLE001
65
+ return False
66
+ return False
67
+
68
+
69
+ def main():
70
+ root = tempfile.mkdtemp(prefix="retr_s9b_")
71
+ cg = _build(root)
72
+
73
+ # ================= 1) 分派全链路 =================
74
+ r = ms._cg_dispatch(cg, {"op": "edges", "child": "a1"})
75
+ check("dispatch 直调:op=edges → _edges_call → find_edges(ok/readonly/total)",
76
+ isinstance(r, dict) and r.get("ok") is True and r.get("readonly") is True
77
+ and r.get("op") == "edges" and r.get("total") == 1
78
+ and r["edges"][0]["child"] == "a1", str(r)[:200])
79
+
80
+ rc = ms._cg_call(cg, {"op": "edges", "child": "a2", "expand_nodes": True})
81
+ check("_cg_call 外层透传 expand_nodes:边附端点摘要(a2 在库 / p1 在库)",
82
+ rc.get("ok") is True and rc.get("total") == 1
83
+ and rc["edges"][0]["child_node"]["present"] is True
84
+ and rc["edges"][0]["parent_node"]["present"] is True,
85
+ str(rc.get("edges", [{}])[0].get("child_node")))
86
+
87
+ # ================= 2) op 缺省推导防呆(负例)=================
88
+ rd = ms._cg_call(cg, {"child": "a1"})
89
+ check("漏 op 不冒充反查:child= 不是 edges 签名 → 按既有规则推导为 read(op_derived 透出)",
90
+ rd.get("op") == "read" and rd.get("op_derived") is True,
91
+ str({k: rd.get(k) for k in ("op", "op_derived")}))
92
+ check("显式 op 优先:op=edges 时 op_derived 不出现(推导只兜底不覆盖)",
93
+ "op_derived" not in rc)
94
+
95
+ # ================= 3) 权限闸双面 =================
96
+ p_ok = Principal(actor="anon", role="anonymous", can_write=False,
97
+ ops_allow=("info", "route", "read", "edges"))
98
+ p_no = Principal(actor="narrow", role="reader", can_write=False,
99
+ ops_allow=("info", "route", "read"))
100
+ cg_ok = MdCGSecure(root, principal=p_ok)
101
+ cg_no = MdCGSecure(root, principal=p_no)
102
+ check("ops_allow 含 edges → 放行(只读结果正常返回)",
103
+ ms._cg_dispatch(cg_ok, {"op": "edges", "parent": "p1"}).get("total") == 2)
104
+ check("ops_allow 不含 edges → AccessDenied(角色作用域闸,不静默降级)",
105
+ _raises(AccessDenied, lambda: ms._cg_dispatch(cg_no, {"op": "edges"})),
106
+ "expected AccessDenied")
107
+ check("通配白名单不受新 op 影响:ops_allow=('*',) 放行(designer 形态)",
108
+ ms._cg_dispatch(
109
+ MdCGSecure(root, principal=Principal(
110
+ actor="boss", role="designer", can_write=True, can_admin=True,
111
+ ops_allow=("*",))),
112
+ {"op": "edges", "relation": "derived_from"})["total"] == 1)
113
+
114
+ # ================= 4) 渐进披露(投影 ↔ help 回取)=================
115
+ slim = {t["name"]: t for t in tf.slim_tools(ms.ALL_TOOLS)}
116
+ cg_slim_desc = slim["cg"].get("description") or ""
117
+ check("slim 后 op=edges 段被投影(常驻上下文不付费)",
118
+ "op=edges:" not in cg_slim_desc and "edges" not in tf.op_sections(cg_slim_desc),
119
+ cg_slim_desc[:120])
120
+ check("slim 后 cg 职责行仍 ≤160 字符(投影不破尺寸预算)",
121
+ len(cg_slim_desc) <= 160, str(len(cg_slim_desc)))
122
+ h = tf.help_text(ms.ALL_TOOLS, query="edges")
123
+ hit = next((x for x in h.get("hits", []) if x.get("op") == "edges"), None)
124
+ check("op=help,query=edges 无损取回:命中 op 段落与透传参数清单(expand_nodes 在列)",
125
+ h.get("ok") is True and hit is not None
126
+ and "expand_nodes" in json.dumps(hit.get("params") or []),
127
+ str(h)[:200])
128
+
129
+ # ================= 5) schema 一致性 =================
130
+ cg_tool = next(t for t in ms.ALL_TOOLS if t["name"] == "cg")
131
+ isch = cg_tool.get("inputSchema") or {}
132
+ props = isch.get("properties") or {}
133
+ req = set(isch.get("required") or [])
134
+ check("schema:edges 全部透传参数在列且均为可选(required 不含)",
135
+ all(k in props for k in EDGE_ARGS)
136
+ and not (req & set(EDGE_ARGS)),
137
+ str([k for k in EDGE_ARGS if k not in props]))
138
+ check("schema:predicate/object 不进参数面(subject 是 identity/self_state/link 既有主体参数,非 edges 引入)",
139
+ not ({"predicate", "object"} & set(props)))
140
+ _ec_src = inspect.getsource(ms._edges_call)
141
+ check("实现面:_edges_call 不读 subject/predicate/object 第二套参数键(术语映射只在 docstring)",
142
+ not any(('"%s"' % k) in _ec_src or ("'%s'" % k) in _ec_src
143
+ for k in ("subject", "predicate", "object")),
144
+ str([k for k in ("subject", "predicate", "object")
145
+ if k in _ec_src]))
146
+ check("实现签名:find_edges 用 expand_nodes(旧名 expand 已废除,防回潮)",
147
+ "expand_nodes" in inspect.signature(provenance.find_edges).parameters
148
+ and "expand" not in inspect.signature(provenance.find_edges).parameters,
149
+ str(list(inspect.signature(provenance.find_edges).parameters)))
150
+
151
+ # ================= 6) 协议对账(AST 自动发现)=================
152
+ au = protocol.audit()
153
+ check("protocol.audit:ok=True、shape_errors 空(edges 属扩展面不违例)",
154
+ au.get("ok") is True and not au.get("shape_errors")
155
+ and not au.get("errors"), str(au.get("errors")))
156
+ check("protocol.audit:AST 自动发现 edges 分支(extension_ops 报告项在列)",
157
+ "edges" in (au.get("actual") or [])
158
+ and "edges" in (au.get("extension_ops") or []),
159
+ str(au.get("actual")))
160
+
161
+ # ================= 7) FUNC_DESC 覆盖守卫 =================
162
+ sync_path = os.path.join(os.path.dirname(os.path.dirname(
163
+ os.path.abspath(__file__))), "scripts", "cogmap_sync.py")
164
+ sync_src = open(sync_path, encoding="utf-8").read()
165
+ check("cogmap_sync.FUNC_DESC 登记 (\"cg\", \"edges\")(功能调用映射表覆盖门禁的前置)",
166
+ '("cg", "edges")' in sync_src)
167
+
168
+ print("\ntest_retr_s9_entity_ctx: %d 通过 / %d 失败" % (passed, failed))
169
+ return 0 if failed == 0 else 1
170
+
171
+
172
+ if __name__ == "__main__":
173
+ if hasattr(sys.stdout, "reconfigure"):
174
+ sys.stdout.reconfigure(encoding="utf-8")
175
+ sys.exit(main())
@@ -0,0 +1,367 @@
1
+ # -*- coding: utf-8 -*-
2
+ """md_cg · 审核队列 conformance(数据健康不变量,pi storage conformance 口径)
3
+
4
+ 把存储承诺写成断言,防止未来改动静默破坏:
5
+ ① strict 锁语义:不能丢的写超时必须显式报错,而非静默放行退化为无锁并发
6
+ ② 幂等对账:同内容重试(超时重试/崩溃恢复)→ 幂等返回既有 pid,不重复入队
7
+ ③ 已裁决内容的对账:accepted/rejected 内容重提 → 返回原 pid + 终态
8
+ ④ 存量兼容:无 payload_hash 的旧格式记录参与对账(现算)
9
+ ⑤ 级联出清:主提案终态裁决后,同内容存量兄弟提案自动关闭
10
+ ⑥ close/reopen 状态保持:重开实例后队列视图一致
11
+ ⑦ 并发幂等(真多进程):N 进程同内容并发 propose → 恰好 1 条、pid 全同
12
+ ⑧ 并发不丢(真多进程):N 进程×M 条不同内容 → inbox 读回恰好 N×M 条
13
+ ⑨ decisions 并发不丢(真多进程):并发裁决 → 记录恰好 N 条且指纹完整
14
+ ⑩ 安全层转发:MdCGSecure.propose 的幂等/info 透传
15
+ ⑪ NOOP 裁决:只留痕(jsonl + 审计节点)不落业务节点、不写负记忆、终态关闭、
16
+ 统计可见,且与 reject 的留痕状态可区分
17
+
18
+ 运行:python -m md_cg.test_review_conformance
19
+ """
20
+ from __future__ import annotations
21
+
22
+ import hashlib
23
+ import json
24
+ import os
25
+ import shutil
26
+ import subprocess
27
+ import sys
28
+ import tempfile
29
+ import time
30
+
31
+ from .fsutil import FileLock, append_jsonl
32
+ from .mdcos import MdCGOS
33
+ from .security import Principal
34
+ from .mdcos import MdCGSecure
35
+
36
+ PASS = FAIL = 0
37
+ FAILS = []
38
+
39
+ REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
40
+
41
+ WORKER = '''# -*- coding: utf-8 -*-
42
+ """conformance worker:子进程内建 MdCGOS 执行单次 propose / review_decide。"""
43
+ import json
44
+ import sys
45
+
46
+ sys.path.insert(0, sys.argv[1])
47
+ from md_cg.mdcos import MdCGOS
48
+
49
+ root, mode = sys.argv[2], sys.argv[3]
50
+ arg = sys.argv[4] if len(sys.argv) > 4 else ""
51
+ cg = MdCGOS(root, actor="conf-worker")
52
+ if mode == "propose": # arg = content
53
+ print(json.dumps(cg.propose("w-node", arg, layer="knowledge", tags=["w"])))
54
+ elif mode == "propose_n": # arg = json list of contents
55
+ out = [cg.propose("w-node-%d" % i, c, layer="knowledge")
56
+ for i, c in enumerate(json.loads(arg))]
57
+ print(json.dumps(out))
58
+ elif mode == "decide": # arg = pid
59
+ print(json.dumps(cg.review_decide(arg, "reject", reason="conformance")))
60
+ '''
61
+
62
+
63
+ def check(name, cond, detail=""):
64
+ global PASS, FAIL
65
+ if cond:
66
+ PASS += 1
67
+ print(f" [PASS] {name}" + (f" · {detail}" if detail else ""))
68
+ else:
69
+ FAIL += 1
70
+ FAILS.append(name)
71
+ print(f" [FAIL] {name} · {detail}")
72
+
73
+
74
+ def _ensure_worker(workdir):
75
+ wk = os.path.join(workdir, "worker.py")
76
+ if not os.path.exists(wk):
77
+ with open(wk, "w", encoding="utf-8") as f:
78
+ f.write(WORKER)
79
+ return wk
80
+
81
+
82
+ def _run_worker(workdir, root, mode, arg="", timeout=120):
83
+ """子进程跑 worker(argv 列表 + UTF-8 + shell=False,纪律 15)。"""
84
+ wk = _ensure_worker(workdir)
85
+ env = dict(os.environ, PYTHONUTF8="1")
86
+ return subprocess.run(
87
+ [sys.executable, wk, REPO, root, mode, arg],
88
+ capture_output=True, text=True, encoding="utf-8", errors="replace",
89
+ timeout=timeout, env=env, shell=False)
90
+
91
+
92
+ def main():
93
+ workdir = tempfile.mkdtemp(prefix="mdcg_conf_wk_")
94
+ root = tempfile.mkdtemp(prefix="mdcg_conf_")
95
+ root2 = root2b = root3 = root4 = root5 = ""
96
+ _ensure_worker(workdir)
97
+ try:
98
+ cg = MdCGOS(root, actor="test")
99
+
100
+ # ---------------- ① strict 锁语义 ----------------
101
+ print("\n【1】strict 锁:不能丢的写超时报错,不放行")
102
+ lock_path = os.path.join(root, "hippocampus", "inbox.jsonl")
103
+ blocker = FileLock(lock_path, timeout=30.0)
104
+ blocker.__enter__()
105
+ t0 = time.time()
106
+ raised = None
107
+ try:
108
+ FileLock(lock_path, timeout=0.3, strict=True).__enter__()
109
+ except TimeoutError as e:
110
+ raised = e
111
+ check("strict 占锁下获锁超时抛 TimeoutError", raised is not None,
112
+ str(raised)[:60])
113
+ check("strict 超时不做长等待", time.time() - t0 < 5.0,
114
+ f"耗时={time.time()-t0:.2f}s")
115
+ soft = FileLock(lock_path, timeout=0.3).__enter__()
116
+ check("非 strict 维持放行语义(best-effort 簿记不受影响)",
117
+ soft.acquired is False, f"acquired={soft.acquired}")
118
+ blocker.__exit__()
119
+
120
+ # ---------------- ② 幂等对账:pending ----------------
121
+ print("\n【2】幂等对账:同内容重试返回既有 pid")
122
+ c_body = "# 功能名:conformance 幂等探针\n\n同内容重试不应重复入队。\n"
123
+ p1 = cg.propose("dup1", c_body, layer="knowledge")
124
+ p2 = cg.propose("dup1", c_body, layer="knowledge") # 模拟重试
125
+ p3 = cg.propose("dup2", c_body, layer="knowledge") # 换 node_id 同内容
126
+ check("三次 propose 返回同一 pid", p1 == p2 == p3,
127
+ f"{p1} / {p2} / {p3}")
128
+ pend = [r for r in cg.review_list() if r.get("id") in ("dup1", "dup2")]
129
+ check("inbox 恰好 1 条该内容提案", len(pend) == 1, f"pending={len(pend)}")
130
+ info = cg.propose("dup1", c_body, layer="knowledge", info=True)
131
+ check("info=True 透出去重信息",
132
+ info.get("dedup") is True and info.get("dup_of") == p1
133
+ and info.get("dup_status") == "pending", str(info))
134
+
135
+ # ---------------- ③ 幂等对账:已裁决内容 ----------------
136
+ print("\n【3】幂等对账:已裁决内容重提返回原 pid + 终态")
137
+ d = cg.review_decide(p1, "accept")
138
+ check("accept 落库", d.get("ok") is True, str(d.get("error") or "")[:60])
139
+ again = cg.propose("dup3", c_body, layer="knowledge", info=True)
140
+ check("accepted 内容重提幂等返回原 pid",
141
+ again.get("dedup") is True and again.get("dup_of") == p1
142
+ and again.get("dup_status") == "accepted", str(again))
143
+ check("重提未产生新队列条目",
144
+ not any(r.get("id") == "dup3" for r in cg.review_list()), "")
145
+
146
+ # ---------------- ④ 存量兼容:无 payload_hash 旧记录 ----------------
147
+ print("\n【4】存量兼容:旧格式记录(无 payload_hash)参与对账")
148
+ # 独立内容探针(c_body 在【3】已被 accept,会抢先命中终态分支)
149
+ leg_body = "# 功能名:存量兼容探针\n\n旧账无 hash 也要能对账。\n"
150
+ old = {"t": time.time(), "pid": "prop_legacy0001", "id": "legacy1",
151
+ "content": leg_body, "layer": "knowledge", "tags": [],
152
+ "condition_space": {}, "verify": {}, "verify_hash": "",
153
+ "extra": {}, "actor": "legacy"}
154
+ append_jsonl(cg.inbox_log, old)
155
+ leg = cg.propose("dup4", leg_body, layer="knowledge", info=True)
156
+ check("对账命中存量记录(现算 hash)",
157
+ leg.get("dedup") is True and leg.get("dup_of") == "prop_legacy0001"
158
+ and leg.get("dup_status") == "pending", str(leg))
159
+
160
+ # ---------------- ⑤ 级联出清:同 hash 存量兄弟 ----------------
161
+ print("\n【5】级联出清:主提案终态后兄弟自动关闭")
162
+ sib_body = "# 功能名:级联探针\n\n存量重复入队产物。\n"
163
+ main_pid = cg.propose("casc_main", sib_body, layer="knowledge")
164
+ # 手工构造存量兄弟(绕过 propose 的入队查重,模拟修复上线前的旧账)
165
+ for i, nid in enumerate(("casc_sib_a", "casc_sib_b")):
166
+ ph = hashlib.sha1(sib_body.strip().encode("utf-8")).hexdigest()[:12]
167
+ append_jsonl(cg.inbox_log, {
168
+ "t": time.time(), "pid": f"prop_sib{i}000000", "id": nid,
169
+ "content": sib_body, "layer": "knowledge", "tags": [],
170
+ "condition_space": {}, "payload_hash": ph,
171
+ "verify": {}, "verify_hash": "", "extra": {}, "actor": "legacy"})
172
+ sibs_before = [r for r in cg.review_list()
173
+ if r.get("id") in ("casc_main", "casc_sib_a", "casc_sib_b")]
174
+ check("裁决前 3 条同内容提案全部可见", len(sibs_before) == 3,
175
+ f"n={len(sibs_before)}")
176
+ dmain = cg.review_decide(main_pid, "accept")
177
+ check("accept 成功且级联出清 2 条兄弟",
178
+ dmain.get("ok") and len(dmain.get("cascade_closed") or []) == 2,
179
+ f"cascade={dmain.get('cascade_closed')}")
180
+ left = [r for r in cg.review_list()
181
+ if r.get("id") in ("casc_main", "casc_sib_a", "casc_sib_b")]
182
+ check("裁决后队列无同内容残留", len(left) == 0, f"left={len(left)}")
183
+ decs = [x for x in cg.decisions() if "cascade_dedup" in (x.get("reason") or "")]
184
+ check("级联裁决落 decisions 且带说明", len(decs) == 2
185
+ and all(x.get("status") == "rejected" for x in decs),
186
+ f"n={len(decs)}")
187
+
188
+ # ---------------- ⑥ close/reopen 状态保持 ----------------
189
+ print("\n【6】close/reopen:重开实例队列视图一致")
190
+ cg2 = MdCGOS(root, actor="test-reopen")
191
+ rl2 = cg2.review_list()
192
+ check("重开后 review_list 与原实例一致", rl2 == cg.review_list(),
193
+ f"n={len(rl2)}")
194
+
195
+ # ---------------- ⑦⑧⑨ 真多进程并发 ----------------
196
+ print("\n【7】并发幂等:4 进程同内容并发 propose")
197
+ root2 = tempfile.mkdtemp(prefix="mdcg_conf_p_")
198
+ content = "# 功能名:并发幂等探针\n\n四进程同时入队只应产生一条。\n"
199
+ procs = [subprocess.Popen(
200
+ [sys.executable, os.path.join(workdir, "worker.py"), REPO,
201
+ root2, "propose", content],
202
+ stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=False,
203
+ env=dict(os.environ, PYTHONUTF8="1")) for _ in range(4)]
204
+ pids = []
205
+ for p in procs:
206
+ out, _err = p.communicate(timeout=120)
207
+ pids.append(json.loads(out.strip()))
208
+ check("4 进程返回同一 pid", len(set(pids)) == 1, str(pids))
209
+ inbox2 = os.path.join(root2, "hippocampus", "inbox.jsonl")
210
+ with open(inbox2, encoding="utf-8") as f:
211
+ lines = [ln for ln in f if ln.strip()]
212
+ check("inbox 恰好 1 条(无重复入队)", len(lines) == 1,
213
+ f"lines={len(lines)}")
214
+ rec1 = json.loads(lines[0])
215
+ check("入队记录带 payload_hash", bool(rec1.get("payload_hash")), "")
216
+
217
+ print("\n【8】并发不丢:4 进程×5 条不同内容")
218
+ root2b = tempfile.mkdtemp(prefix="mdcg_conf_p2_")
219
+ contents = [json.dumps([
220
+ f"# 功能名:并发不丢 {i}-{j}\n\n第 {i} 进程第 {j} 条。\n"
221
+ for j in range(5)]) for i in range(4)]
222
+ procs = [subprocess.Popen(
223
+ [sys.executable, os.path.join(workdir, "worker.py"), REPO,
224
+ root2b, "propose_n", contents[i]],
225
+ stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=False,
226
+ env=dict(os.environ, PYTHONUTF8="1")) for i in range(4)]
227
+ for p in procs:
228
+ p.communicate(timeout=180)
229
+ with open(os.path.join(root2b, "hippocampus", "inbox.jsonl"),
230
+ encoding="utf-8") as f:
231
+ all_lines = [ln for ln in f if ln.strip()]
232
+ recs = []
233
+ bad = 0
234
+ for ln in all_lines:
235
+ try:
236
+ recs.append(json.loads(ln))
237
+ except ValueError:
238
+ bad += 1
239
+ check("4×5 并发后读回恰好 20 条(一条不丢)",
240
+ len(recs) == 20 and bad == 0, f"read={len(recs)} bad={bad}")
241
+ check("pid 互不重复", len({r.get("pid") for r in recs}) == 20, "")
242
+
243
+ # 【8c】pid 唯一性守卫(2026-09-16 取证修复):旧式
244
+ # "prop_" + _sig(node_id + time.time()) 无进程熵,同一时刻多 worker
245
+ # 用相同 node_id 入队会碰撞——本项在单进程内高频连续入队,把
246
+ # 「同一时刻多次 propose」这一碰撞条件压缩到必然暴露,防回归。
247
+ root2c = tempfile.mkdtemp(prefix="mdcg_conf_p3_")
248
+ cg2c = MdCGOS(root2c, actor="test")
249
+ pids2c = [cg2c.propose("same-node", f"# 功能名:唯一性 {i}\n\n内容 {i}。\n",
250
+ layer="knowledge") for i in range(20)]
251
+ check("同 node_id 高频连续 propose:20 pid 互不重复",
252
+ len(set(pids2c)) == 20, f"uniq={len(set(pids2c))}/20")
253
+ check("pid 复现格式(prop_ + 12 hex,调用方依赖)",
254
+ all(isinstance(p, str) and len(p) == 17 and p.startswith("prop_")
255
+ and all(ch in "0123456789abcdef" for ch in p[5:])
256
+ for p in pids2c), pids2c[0])
257
+
258
+
259
+ print("\n【9】decisions 并发:4 进程各裁决 1 个 pid")
260
+ root3 = tempfile.mkdtemp(prefix="mdcg_conf_d_")
261
+ cg3 = MdCGOS(root3, actor="test")
262
+ pids3 = [cg3.propose(f"cc{i}", f"# 功能名:并发裁决 {i}\n\n内容 {i}。\n",
263
+ layer="knowledge") for i in range(4)]
264
+ procs = [subprocess.Popen(
265
+ [sys.executable, os.path.join(workdir, "worker.py"), REPO,
266
+ root3, "decide", pids3[i]],
267
+ stdout=subprocess.PIPE, stderr=subprocess.PIPE, shell=False,
268
+ env=dict(os.environ, PYTHONUTF8="1")) for i in range(4)]
269
+ outs = []
270
+ for p in procs:
271
+ out, _err = p.communicate(timeout=180)
272
+ outs.append(out.strip())
273
+ check("4 项裁决全部成功", all(json.loads(o).get("ok") for o in outs),
274
+ str([o[:40] for o in outs]))
275
+ drecs = cg3.decisions()
276
+ check("decisions 读回恰好 4 条(无交错丢失)", len(drecs) == 4,
277
+ f"n={len(drecs)}")
278
+ check("每条裁决带 record_hash 指纹",
279
+ all(r.get("record_hash") for r in drecs), "")
280
+ check("重开后裁决状态保持",
281
+ len(MdCGOS(root3, actor="x")._closed_pids()) == 4, "")
282
+
283
+ # ---------------- ⑩ MdCGSecure.propose info 转发 ----------------
284
+ print("\n【10】安全层转发:MdCGSecure.propose 幂等透传")
285
+ root4 = tempfile.mkdtemp(prefix="mdcg_conf_s_")
286
+ sec = MdCGSecure(root4, principal=Principal(
287
+ actor="conf", clearance="private", can_write=True, can_admin=True))
288
+ sec_body = "# 功能名:安全层幂等\n\n转发链上的去重。\n"
289
+ sp1 = sec.propose("sec1", sec_body, layer="knowledge", info=True)
290
+ sp2 = sec.propose("sec1", sec_body, layer="knowledge", info=True)
291
+ check("安全层两次入队同一 pid 且 dedup 命中",
292
+ sp1.get("pid") == sp2.get("pid") and sp2.get("dedup") is True,
293
+ f"{sp1.get('pid')} / {sp2}")
294
+ with open(os.path.join(root4, "hippocampus", "inbox.jsonl"),
295
+ encoding="utf-8") as f:
296
+ sec_rec = json.loads(f.readline())
297
+ check("info 不泄漏进 extra",
298
+ "info" not in (sec_rec.get("extra") or {}),
299
+ str(sec_rec.get("extra")))
300
+
301
+ # ---------------- ⑪ NOOP 裁决(治理层动作) ----------------
302
+ print("\n【11】NOOP 裁决:只留痕、不落节点、不写负记忆、终态关闭")
303
+ root5 = tempfile.mkdtemp(prefix="mdcg_conf_noop_")
304
+ cg5 = MdCGOS(root5, actor="test-noop")
305
+
306
+ def _neg_n():
307
+ """负记忆条目数(rejected 层)——NOOP 不得增加它。"""
308
+ return sum(1 for e in cg5.index["nodes"].values()
309
+ if (e.get("layer") or "") == "rejected")
310
+
311
+ nb = _neg_n()
312
+ np1 = cg5.propose("noop1", "# 功能名:NOOP 探针\n\n已评估,判定无需改动。\n",
313
+ layer="knowledge")
314
+ dn = cg5.review_decide(np1, "noop", reason="评估过,无需改动")
315
+ check("noop 裁决成功且 decision=noop",
316
+ dn.get("ok") is True and dn.get("decision") == "noop", str(dn)[:80])
317
+ check("noop 不落业务节点", not cg5.get("noop1"), "")
318
+ nrecs = [r for r in cg5.decisions() if r.get("pid") == np1]
319
+ check("noop 进 decisions 留痕(status=noop + record_hash)",
320
+ len(nrecs) == 1 and nrecs[0].get("status") == "noop"
321
+ and bool(nrecs[0].get("record_hash")),
322
+ f"n={len(nrecs)} status={nrecs[0].get('status') if nrecs else '-'}")
323
+ check("noop 不写负记忆(rejected 条目数不增)", _neg_n() == nb,
324
+ f"{nb}→{_neg_n()}")
325
+ check("noop 后提案终态关闭(review_list 不再列出)",
326
+ not any(r.get("pid") == np1 for r in cg5.review_list()), "")
327
+ dn2 = cg5.review_decide(np1, "noop")
328
+ check("重复 noop 幂等拒绝(already_decided)",
329
+ dn2.get("ok") is False and dn2.get("error") == "already_decided",
330
+ str(dn2.get("error")))
331
+ audit = cg5.review_records(pid=np1)
332
+ check("noop 的 md 审计记录节点已落(外部来源可复核)",
333
+ len(audit) == 1, f"n={len(audit)}")
334
+ vrec = cg5.verify_review_record(audit[0]["id"]) if audit else {}
335
+ check("noop 审计记录指纹复核一致且状态为 noop",
336
+ vrec.get("ok") is True and vrec.get("status") == "noop",
337
+ str(vrec)[:90])
338
+ st5 = cg5.review_stats()
339
+ check("review_stats 统计到 noop(by_decision.noop=1)且队列已清",
340
+ st5.get("noop") == 1
341
+ and (st5.get("by_decision") or {}).get("noop") == 1
342
+ and st5.get("pending") == 0 and st5.get("closed") == 1,
343
+ str(st5))
344
+ # 语义分界:noop 与 reject 都终止提案,但留痕状态必须可区分
345
+ # (否则「评估过、无需改动」会被误读为「否掉了这条候选」)
346
+ rj1 = cg5.propose("rej1", "# 功能名:NOOP 对照探针\n\n对照用。\n",
347
+ layer="knowledge")
348
+ dr = cg5.review_decide(rj1, "reject", reason="对照")
349
+ rjrec = [r for r in cg5.decisions() if r.get("pid") == rj1]
350
+ check("noop 与 reject 留痕状态可区分(noop vs rejected)",
351
+ dr.get("ok") is True and bool(rjrec)
352
+ and rjrec[0].get("status") == "rejected",
353
+ f"reject_status={rjrec[0].get('status') if rjrec else '-'}")
354
+
355
+ print(f"\n===== conformance:PASS={PASS} FAIL={FAIL} =====")
356
+ if FAILS:
357
+ print("失败项:", ";".join(FAILS))
358
+ return 1 if FAIL else 0
359
+ finally:
360
+ shutil.rmtree(workdir, ignore_errors=True)
361
+ for r in (root, root2, root2b, root3, root4, root5):
362
+ if r:
363
+ shutil.rmtree(r, ignore_errors=True)
364
+
365
+
366
+ if __name__ == "__main__":
367
+ sys.exit(main())