@furongjun1999/dsh-memory 0.4.11 → 0.5.1

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 (580) hide show
  1. package/README.md +552 -465
  2. package/codebuddy/CODEBUDDY.md +11 -3
  3. package/codebuddy/README.md +92 -90
  4. package/codebuddy/mcp.json +27 -27
  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 -169
  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 -144
  7. package/docs/README.md +143 -111
  8. package/docs/discipline/harnesses.yaml +244 -226
  9. package/docs/discipline/templates/full.md.tmpl +61 -61
  10. package/docs/discipline/templates/rules.mdc.tmpl +68 -0
  11. package/docs/discipline/templates/skill.md.tmpl +23 -23
  12. package/docs/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 +299 -299
  13. package/docs/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 +239 -239
  14. package/docs/eval/bench_lingshu_self/bench_self.py +140 -0
  15. package/docs/eval/bench_lingshu_self/self_bench_result.json +404 -0
  16. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +38 -0
  17. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +185 -0
  18. 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 +174 -174
  19. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +422 -0
  20. 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 +223 -223
  21. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +100 -0
  22. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +197 -0
  23. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +156 -0
  24. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +210 -0
  25. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +227 -0
  26. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +203 -0
  27. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +233 -0
  28. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +191 -0
  29. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +213 -0
  30. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +214 -0
  31. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +199 -0
  32. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +156 -0
  33. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +152 -0
  34. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +128 -0
  35. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +114 -0
  36. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +192 -0
  37. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +187 -0
  38. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +207 -0
  39. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +203 -0
  40. package/docs/{mdcg → hive}//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 +165 -160
  41. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +76 -0
  42. package/docs/{mdcg → hive}//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 -236
  43. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +202 -0
  44. 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 -43
  45. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +85 -0
  46. 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 -102
  47. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +47 -0
  48. 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 +519 -503
  49. 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 +85 -85
  50. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +191 -0
  51. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +90 -0
  52. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  53. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  54. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +216 -216
  55. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +646 -646
  56. package/docs/mdcg/lingshu_tutorial.html +14449 -14449
  57. package/docs/mdcg/release_v0.4.11.md +49 -0
  58. package/docs/mdcg/release_v0.4.5.md +55 -55
  59. package/docs/mdcg/tool_table_v0.3.0.md +117 -117
  60. 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 -600
  61. 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 +40 -40
  62. 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 +275 -275
  63. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +54 -0
  64. 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 +130 -130
  65. 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 +278 -278
  66. 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 -172
  67. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +270 -270
  68. 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 +491 -491
  69. 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 +340 -340
  70. 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 +588 -588
  71. 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 -176
  72. 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 +81 -81
  73. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +704 -704
  74. 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 -242
  75. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +365 -0
  76. 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 -129
  77. 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 -134
  78. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +5260 -5260
  79. 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 -145
  80. 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 +144 -144
  81. 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 +198 -198
  82. 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 -221
  83. 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 -237
  84. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +343 -0
  85. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +82 -82
  86. 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 +28 -2
  87. package/dsh/README.md +82 -82
  88. package/dsh/cordis.yml.example +139 -139
  89. package/dsh/update-lingshu.bat +11 -11
  90. package/lib/bridge.d.ts +9 -0
  91. package/lib/bridge.js +35 -0
  92. package/lib/hooks.js +36 -2
  93. package/lib/index.js +7 -1
  94. package/lib/lib/roleplay_web.js +116 -29
  95. package/lib/lib/token_store.d.ts +7 -1
  96. package/lib/lib/token_store.js +12 -3
  97. package/md_cg/__init__.py +7 -7
  98. package/md_cg/audit.py +379 -368
  99. package/md_cg/autonomy.py +287 -287
  100. package/md_cg/backfill.py +1328 -1327
  101. package/md_cg/backfill_bigdomain.py +34 -34
  102. package/md_cg/backfill_bucket_zh.py +35 -0
  103. package/md_cg/bench6_arms.py +410 -410
  104. package/md_cg/bench6_common.py +230 -230
  105. package/md_cg/bench6_competitors.py +212 -212
  106. package/md_cg/bench_axis_domain.py +257 -257
  107. package/md_cg/bench_blind_comp.py +308 -308
  108. package/md_cg/bench_e2e_judge.py +532 -0
  109. package/md_cg/bench_e2e_locomo_qa.py +368 -0
  110. package/md_cg/bench_e2e_qa.py +256 -0
  111. package/md_cg/bench_en_atoms_public.py +230 -230
  112. package/md_cg/bench_governance.py +348 -348
  113. package/md_cg/bench_lme_zh.py +410 -410
  114. package/md_cg/bench_locomo.py +121 -121
  115. package/md_cg/bench_locomo_zh.py +450 -450
  116. package/md_cg/bench_locomo_zh_public.py +147 -147
  117. package/md_cg/bench_longmem.py +112 -112
  118. package/md_cg/bench_membench.py +632 -632
  119. package/md_cg/bench_p0.py +149 -149
  120. package/md_cg/bench_progressive.py +287 -287
  121. package/md_cg/bench_role_views.py +238 -238
  122. package/md_cg/bench_task_ab.py +243 -243
  123. package/md_cg/bench_task_ab_llm.py +408 -408
  124. package/md_cg/bench_unified_en.py +204 -204
  125. package/md_cg/bench_zh_mad.py +601 -601
  126. package/md_cg/blindspot_tickets.py +123 -123
  127. package/md_cg/branches.py +301 -285
  128. package/md_cg/build_postings.py +73 -73
  129. package/md_cg/ccgc.py +1006 -948
  130. package/md_cg/census.py +132 -132
  131. package/md_cg/chain.py +315 -300
  132. package/md_cg/codeindex.py +531 -531
  133. package/md_cg/coldverify.py +292 -292
  134. package/md_cg/comment_gate.py +337 -337
  135. package/md_cg/cond_compose.py +190 -190
  136. package/md_cg/cond_facts.py +154 -154
  137. package/md_cg/cond_template.json +106 -106
  138. package/md_cg/condition_anchor.py +142 -142
  139. package/md_cg/conformance.py +726 -726
  140. package/md_cg/consistency.py +717 -717
  141. package/md_cg/consolidate.py +1537 -1439
  142. package/md_cg/corpus.py +110 -110
  143. package/md_cg/crosscheck.py +1098 -1097
  144. package/md_cg/crypto.py +3 -1
  145. package/md_cg/d_meta.py +310 -310
  146. package/md_cg/datapath.py +78 -18
  147. package/md_cg/docindex.py +473 -473
  148. package/md_cg/eval_common.py +575 -575
  149. package/md_cg/evidence.py +4 -2
  150. package/md_cg/evolution.py +477 -477
  151. package/md_cg/export.py +222 -220
  152. package/md_cg/forgetting.py +581 -581
  153. package/md_cg/fsutil.py +377 -329
  154. package/md_cg/hotcache.py +48 -7
  155. package/md_cg/hyperedge.py +251 -251
  156. package/md_cg/identity.py +390 -390
  157. package/md_cg/insight.py +500 -500
  158. package/md_cg/interop.py +338 -0
  159. package/md_cg/judgment_manifest.py +177 -0
  160. package/md_cg/lexicon/build_cedict_en_zh.py +329 -329
  161. package/md_cg/lexicon/build_standard_en.py +171 -171
  162. package/md_cg/lexicon/expand_en_zh.py +211 -211
  163. package/md_cg/lifecycle.py +272 -272
  164. package/md_cg/linkref.py +280 -280
  165. package/md_cg/links.py +140 -107
  166. package/md_cg/mcp_server.py +403 -55
  167. package/md_cg/md_whitebox.py +345 -345
  168. package/md_cg/mdcg.py +783 -233
  169. package/md_cg/mdcos.py +500 -70
  170. package/md_cg/metacognition.py +591 -591
  171. package/md_cg/migrate.py +119 -119
  172. package/md_cg/migrate_aeis.py +221 -221
  173. package/md_cg/migrate_roleplay.py +293 -293
  174. package/md_cg/migrate_wisdom_graph.py +360 -360
  175. package/md_cg/mreview/__init__.py +25 -25
  176. package/md_cg/mreview/__main__.py +110 -110
  177. package/md_cg/mreview/bundle.py +178 -178
  178. package/md_cg/mreview/candidates.py +262 -262
  179. package/md_cg/mreview/govern.py +694 -693
  180. package/md_cg/mreview/locate.py +939 -939
  181. package/md_cg/mreview/pipeline.py +728 -728
  182. package/md_cg/mreview/rules/duplication.json +21 -21
  183. package/md_cg/mreview/rules/field_coverage.json +54 -54
  184. package/md_cg/mreview/rules/source_license.json +21 -21
  185. package/md_cg/mreview/rules/template_flow.json +21 -21
  186. package/md_cg/mreview/ruleset.py +252 -252
  187. package/md_cg/nodefile.py +575 -575
  188. package/md_cg/pooling.py +484 -472
  189. package/md_cg/postings.py +300 -298
  190. package/md_cg/predict.py +1100 -1100
  191. package/md_cg/progressive.py +123 -123
  192. package/md_cg/protect.py +272 -272
  193. package/md_cg/protocol/md_cg_gate.proto +33 -33
  194. package/md_cg/protocol.py +372 -372
  195. package/md_cg/provenance.py +582 -582
  196. package/md_cg/reach.py +453 -453
  197. package/md_cg/readcache.py +143 -0
  198. package/md_cg/reconcile.py +228 -0
  199. package/md_cg/refindex.py +833 -833
  200. package/md_cg/refine.py +604 -604
  201. package/md_cg/review_cli.py +170 -0
  202. package/md_cg/roleviews.py +89 -89
  203. package/md_cg/routing.py +393 -365
  204. package/md_cg/run_tests.py +211 -0
  205. package/md_cg/scrub.py +13 -3
  206. package/md_cg/security.py +128 -18
  207. package/md_cg/self_state.py +1029 -1029
  208. package/md_cg/selfreport.py +152 -151
  209. package/md_cg/semantic/__init__.py +10 -10
  210. package/md_cg/semantic/canonical.py +122 -122
  211. package/md_cg/semantic/en_normalizer.py +364 -364
  212. package/md_cg/semantic/en_zh_map.json +28694 -0
  213. package/md_cg/semantic/export_en_zh_map.py +64 -0
  214. package/md_cg/semantic/unify.py +45 -0
  215. package/md_cg/semantic/zh_en_atoms.py +139 -139
  216. package/md_cg/signer.py +7 -4
  217. package/md_cg/sources.py +816 -582
  218. package/md_cg/statushdr.py +179 -179
  219. package/md_cg/stg.py +54 -37
  220. package/md_cg/subgraph.py +729 -729
  221. package/md_cg/sustain.py +35 -5
  222. package/md_cg/tasks.py +470 -470
  223. package/md_cg/test_access_hints.py +147 -0
  224. package/md_cg/test_action_derive.py +203 -203
  225. package/md_cg/test_audit_rotate.py +270 -270
  226. package/md_cg/test_autonomy.py +143 -143
  227. package/md_cg/test_bench_governance.py +102 -102
  228. package/md_cg/test_blindspot_tickets.py +166 -166
  229. package/md_cg/test_branch_discard_tombstone.py +136 -0
  230. package/md_cg/test_branches.py +13 -3
  231. package/md_cg/test_ccg_perturb.py +184 -184
  232. package/md_cg/test_ccgc.py +433 -433
  233. package/md_cg/test_census_prune.py +81 -81
  234. package/md_cg/test_chain_read_isolate.py +168 -0
  235. package/md_cg/test_cond_compose_anchors.py +76 -76
  236. package/md_cg/test_cond_match.py +165 -165
  237. package/md_cg/test_condition_anchor.py +81 -81
  238. package/md_cg/test_d_meta.py +412 -412
  239. package/md_cg/test_datapath_device_name.py +203 -0
  240. package/md_cg/test_datapath_root.py +199 -199
  241. package/md_cg/test_emit_negtail_cache.py +156 -0
  242. package/md_cg/test_en_pipeline.py +22 -2
  243. package/md_cg/test_gain_gate.py +212 -212
  244. package/md_cg/test_govern_directread.py +421 -0
  245. package/md_cg/test_health_scale.py +173 -173
  246. package/md_cg/test_hive_ingest.py +285 -0
  247. package/md_cg/test_hot_cold.py +215 -215
  248. package/md_cg/test_hyperedge.py +245 -245
  249. package/md_cg/test_i26_empty_first_write.py +116 -0
  250. package/md_cg/test_i27_e041_identity.py +128 -0
  251. package/md_cg/test_i28_hotcache_prodpath.py +122 -0
  252. package/md_cg/test_i32_hotcache_env_key.py +218 -0
  253. package/md_cg/test_identity_attribution.py +96 -15
  254. package/md_cg/test_index_durability.py +17 -3
  255. package/md_cg/test_interop.py +95 -0
  256. package/md_cg/test_interop_judgment.py +228 -0
  257. package/md_cg/test_issue39_utf8_stdio.py +273 -0
  258. package/md_cg/test_lifecycle.py +309 -309
  259. package/md_cg/test_linkref.py +306 -306
  260. package/md_cg/test_links_concurrent_write.py +188 -0
  261. package/md_cg/test_lock.py +43 -43
  262. package/md_cg/test_md_access_parity.py +255 -255
  263. package/md_cg/test_md_writepath.py +345 -345
  264. package/md_cg/test_mdstore_search_parity.py +160 -0
  265. package/md_cg/test_merge_upsert.py +168 -0
  266. package/md_cg/test_mr_m2.py +587 -587
  267. package/md_cg/test_mr_m3.py +710 -710
  268. package/md_cg/test_mr_m4.py +485 -485
  269. package/md_cg/test_n123_derive_expiry_chain.py +205 -0
  270. package/md_cg/test_n130_verify_falsified_protect.py +185 -0
  271. package/md_cg/test_n131_merge_gate.py +205 -0
  272. package/md_cg/test_p0.py +250 -250
  273. package/md_cg/test_p1.py +316 -316
  274. package/md_cg/test_p10_identity.py +173 -173
  275. package/md_cg/test_p11_consistency.py +233 -233
  276. package/md_cg/test_p12_metacognition.py +212 -212
  277. package/md_cg/test_p13_encryption.py +241 -241
  278. package/md_cg/test_p14_sustain.py +249 -249
  279. package/md_cg/test_p15_scrub.py +280 -280
  280. package/md_cg/test_p16_self_state.py +301 -301
  281. package/md_cg/test_p17_predict.py +354 -354
  282. package/md_cg/test_p18_whitebox.py +171 -171
  283. package/md_cg/test_p19_migrate_roleplay.py +149 -149
  284. package/md_cg/test_p1x_ref_root.py +160 -0
  285. package/md_cg/test_p20_evolution.py +315 -315
  286. package/md_cg/test_p21_tokens.py +293 -270
  287. package/md_cg/test_p22_theory.py +175 -175
  288. package/md_cg/test_p23_links.py +311 -311
  289. package/md_cg/test_p24_evidence.py +227 -227
  290. package/md_cg/test_p25_weights.py +156 -156
  291. package/md_cg/test_p26_refindex.py +416 -416
  292. package/md_cg/test_p27_docindex.py +16 -7
  293. package/md_cg/test_p28_refcheck.py +305 -305
  294. package/md_cg/test_p29_session_ingest_export.py +354 -333
  295. package/md_cg/test_p2_mcp.py +3 -0
  296. package/md_cg/test_p3.py +11 -2
  297. package/md_cg/test_p30_maintain.py +330 -330
  298. package/md_cg/test_p31_insight.py +534 -534
  299. package/md_cg/test_p32_backfill.py +7 -1
  300. package/md_cg/test_p33_ccg_wiring.py +293 -293
  301. package/md_cg/test_p34_crosscheck.py +331 -331
  302. package/md_cg/test_p35_conditioned_claim.py +252 -252
  303. package/md_cg/test_p36_kp_align.py +230 -230
  304. package/md_cg/test_p37_condition_space.py +248 -248
  305. package/md_cg/test_p38_concurrent_flush.py +102 -0
  306. package/md_cg/test_p38_contextualize.py +273 -273
  307. package/md_cg/test_p39_verify_flow.py +153 -0
  308. package/md_cg/test_p39_vision_evidence.py +369 -369
  309. package/md_cg/test_p40_refine_worklist.py +241 -241
  310. package/md_cg/test_p41_evolve_patrol.py +224 -224
  311. package/md_cg/test_p42_provenance.py +269 -269
  312. package/md_cg/test_p43_pooling.py +412 -398
  313. package/md_cg/test_p44_md_whitebox.py +231 -231
  314. package/md_cg/test_p45_session_identity.py +219 -219
  315. package/md_cg/test_p46_unit_scope.py +272 -272
  316. package/md_cg/test_p47_session_view.py +316 -0
  317. package/md_cg/test_p4_fuzzy.py +223 -223
  318. package/md_cg/test_p5_semantic.py +226 -226
  319. package/md_cg/test_p6_consolidate.py +440 -387
  320. package/md_cg/test_p7_goals_recent.py +202 -202
  321. package/md_cg/test_p8_subgraph_chain.py +200 -200
  322. package/md_cg/test_p9_forget_protect.py +231 -231
  323. package/md_cg/test_predict_beta.py +135 -135
  324. package/md_cg/test_preflight_failclosed.py +100 -100
  325. package/md_cg/test_progressive.py +146 -146
  326. package/md_cg/test_propose_tail_index.py +157 -0
  327. package/md_cg/test_protocol.py +243 -243
  328. package/md_cg/test_reach.py +378 -378
  329. package/md_cg/test_reach_keys.py +201 -201
  330. package/md_cg/test_read_clip.py +141 -141
  331. package/md_cg/test_read_scope_b27.py +277 -0
  332. package/md_cg/test_readcache_default_on.py +168 -0
  333. package/md_cg/test_readcache_precise_inval.py +270 -0
  334. package/md_cg/test_readcache_prodpath.py +203 -0
  335. package/md_cg/test_reconcile_v0.py +294 -0
  336. package/md_cg/test_retr_gates_prodpath.py +140 -0
  337. package/md_cg/test_retr_s1.py +344 -340
  338. package/md_cg/test_retr_s1b.py +276 -209
  339. package/md_cg/test_retr_s3.py +194 -194
  340. package/md_cg/test_retr_s4.py +163 -163
  341. package/md_cg/test_retr_s5.py +200 -200
  342. package/md_cg/test_retr_s6.py +157 -157
  343. package/md_cg/test_retr_s7.py +392 -384
  344. package/md_cg/test_retr_s8_time.py +369 -316
  345. package/md_cg/test_retr_s9_edges.py +286 -286
  346. package/md_cg/test_retr_s9_entity_ctx.py +9 -3
  347. package/md_cg/test_retr_score_once.py +208 -0
  348. package/md_cg/test_review_conformance.py +367 -367
  349. package/md_cg/test_review_onepass.py +170 -0
  350. package/md_cg/test_role_views.py +354 -354
  351. package/md_cg/test_rrf_graph_seed_cache.py +154 -0
  352. package/md_cg/test_security_audit.py +155 -0
  353. package/md_cg/test_security_audit_b26.py +161 -0
  354. package/md_cg/test_security_audit_v21.py +250 -0
  355. package/md_cg/test_sem_noise.py +242 -242
  356. package/md_cg/test_semantic_canonical.py +16 -2
  357. package/md_cg/test_session_isolation.py +168 -0
  358. package/md_cg/test_snapshot_autoclose.py +187 -0
  359. package/md_cg/test_subproc_encoding.py +192 -192
  360. package/md_cg/test_sustain_mutual.py +153 -153
  361. package/md_cg/test_tail_watermark_race.py +208 -0
  362. package/md_cg/test_tasks.py +409 -409
  363. package/md_cg/test_tenant_env_override_warn.py +139 -0
  364. package/md_cg/test_tenant_registry_corrupt_warn.py +151 -0
  365. package/md_cg/test_tool_face.py +189 -189
  366. package/md_cg/test_transfer.py +180 -180
  367. package/md_cg/test_trust.py +361 -361
  368. package/md_cg/test_twophase.py +286 -286
  369. package/md_cg/test_v14_fixes.py +38 -20
  370. package/md_cg/test_validity_filter.py +280 -280
  371. package/md_cg/test_verify_answer.py +138 -138
  372. package/md_cg/test_verify_dirty_reconcile.py +157 -0
  373. package/md_cg/test_wisdom_md_store.py +292 -292
  374. package/md_cg/test_writelimit.py +197 -197
  375. package/md_cg/test_writepipe.py +214 -214
  376. package/md_cg/theory.py +6 -3
  377. package/md_cg/tokens.py +85 -14
  378. package/md_cg/tool_face.py +260 -260
  379. package/md_cg/trust.py +986 -950
  380. package/md_cg/twophase.py +231 -231
  381. package/md_cg/units.py +668 -667
  382. package/md_cg/vision_evidence.py +667 -666
  383. package/md_cg/weights.py +624 -624
  384. package/md_cg/whitebox.py +527 -527
  385. package/md_cg/whitebox_kb/__init__.py +37 -37
  386. package/md_cg/whitebox_kb/aeis_core/__init__.py +42 -42
  387. package/md_cg/whitebox_kb/aeis_core/semantic.py +280 -280
  388. package/md_cg/whitebox_kb/aeis_core/textutil.py +13 -13
  389. package/md_cg/whitebox_kb/engine.py +310 -310
  390. package/md_cg/whitebox_kb/seed_knowledge//346/231/272/350/203/275/350/256/2723.4.md +5260 -5260
  391. package/md_cg/whitebox_kb/wisdom/browser_units.py +2631 -2631
  392. package/md_cg/whitebox_kb/wisdom/causal_discover.py +432 -432
  393. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1506 -1506
  394. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3033 -3033
  395. package/md_cg/whitebox_kb/wisdom/condition_algebra.py +112 -112
  396. package/md_cg/whitebox_kb/wisdom/condition_frame.py +315 -315
  397. package/md_cg/whitebox_kb/wisdom/condition_kb.py +108 -108
  398. package/md_cg/whitebox_kb/wisdom/conflict_map.json +4445 -4445
  399. package/md_cg/whitebox_kb/wisdom/core/lexer.py +512 -512
  400. package/md_cg/whitebox_kb/wisdom/core/name_checker.py +1023 -1023
  401. package/md_cg/whitebox_kb/wisdom/cspmn.py +258 -258
  402. package/md_cg/whitebox_kb/wisdom/csre.py +264 -264
  403. package/md_cg/whitebox_kb/wisdom/danmaku_audit.py +252 -252
  404. package/md_cg/whitebox_kb/wisdom/distilled_condition_units.json +6417 -6417
  405. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902b.json +1950 -1950
  406. package/md_cg/whitebox_kb/wisdom/docs/WB-EVAL-20260902c.json +1296 -1296
  407. package/md_cg/whitebox_kb/wisdom/docs/whitebox_capability_graph_demo.json +59 -59
  408. package/md_cg/whitebox_kb/wisdom/graph_db_units.py +3089 -3089
  409. package/md_cg/whitebox_kb/wisdom/knowledge_points.py +318 -318
  410. package/md_cg/whitebox_kb/wisdom/md_access.py +470 -470
  411. package/md_cg/whitebox_kb/wisdom/md_store.py +276 -251
  412. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +476 -476
  413. package/md_cg/whitebox_kb/wisdom/multilang_ir.py +128 -124
  414. package/md_cg/whitebox_kb/wisdom/navigate.py +248 -248
  415. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +224 -224
  416. package/md_cg/whitebox_kb/wisdom/os_units.py +2735 -2735
  417. package/md_cg/whitebox_kb/wisdom/pattern_separation.py +376 -376
  418. package/md_cg/whitebox_kb/wisdom/prereq_map.json +364 -364
  419. package/md_cg/whitebox_kb/wisdom/python_code_units.py +2766 -2766
  420. package/md_cg/whitebox_kb/wisdom/role_solidified.json +7 -7
  421. package/md_cg/whitebox_kb/wisdom/route_memory.py +244 -244
  422. package/md_cg/whitebox_kb/wisdom/scene_reconstruction.py +148 -148
  423. package/md_cg/whitebox_kb/wisdom/snr_report.json +40 -40
  424. package/md_cg/whitebox_kb/wisdom/test_code_compose_domains.py +7541 -7541
  425. package/md_cg/whitebox_kb/wisdom/test_compiler_self_bootstrap.py +354 -354
  426. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  427. package/md_cg/whitebox_kb/wisdom/test_ecosystem_demos.py +193 -193
  428. package/md_cg/whitebox_kb/wisdom/test_graph_db.py +292 -292
  429. package/md_cg/whitebox_kb/wisdom/test_python_self_bootstrap.py +160 -160
  430. package/md_cg/whitebox_kb/wisdom/trigger_words_index.json +4366 -4366
  431. package/md_cg/whitebox_kb/wisdom/verifier.py +1297 -1297
  432. package/md_cg/writelimit.py +356 -356
  433. package/md_cg/writepipe.py +20 -8
  434. package/package.json +101 -96
  435. package/skills/plugin.json +54 -54
  436. package/skills/skills/designer-perspective/SKILL.md +158 -158
  437. package/skills/skills/designer-perspective/references/01-observation-position.md +66 -66
  438. package/skills/skills/designer-perspective/references/02-structure-recognition.md +62 -62
  439. package/skills/skills/designer-perspective/references/03-direction-judgment.md +55 -55
  440. package/skills/skills/designer-perspective/references/04-qualification-verdict.md +72 -72
  441. package/skills/skills/designer-perspective/references/05-condition-attribution.md +74 -74
  442. package/skills/skills/designer-perspective/scripts/designer.py +545 -545
  443. package/skills/skills/designer-perspective/tests/cases.jsonl +17 -17
  444. package/skills/skills/designer-perspective/tests/selftest.py +61 -61
  445. package/skills/skills/lingshu-browser/SKILL.md +60 -60
  446. package/skills/skills/lingshu-compiler/SKILL.md +56 -56
  447. package/skills/skills/lingshu-compiler/units/analyze-type-infer/SKILL.md +45 -45
  448. package/skills/skills/lingshu-compiler/units/check-name-real/SKILL.md +45 -45
  449. package/skills/skills/lingshu-compiler/units/compile-assign/SKILL.md +45 -45
  450. package/skills/skills/lingshu-compiler/units/compile-expr-tree/SKILL.md +45 -45
  451. package/skills/skills/lingshu-compiler/units/compile-full-pipeline/SKILL.md +45 -45
  452. package/skills/skills/lingshu-compiler/units/compile-func-def/SKILL.md +45 -45
  453. package/skills/skills/lingshu-compiler/units/compile-if-then/SKILL.md +45 -45
  454. package/skills/skills/lingshu-compiler/units/compile-logic-expr/SKILL.md +45 -45
  455. package/skills/skills/lingshu-compiler/units/compile-recursive/SKILL.md +45 -45
  456. package/skills/skills/lingshu-compiler/units/compile-scope/SKILL.md +45 -45
  457. package/skills/skills/lingshu-compiler/units/compile-type-check/SKILL.md +45 -45
  458. package/skills/skills/lingshu-compiler/units/compile-while/SKILL.md +45 -45
  459. package/skills/skills/lingshu-compiler/units/compiler-0010c4bf/SKILL.md +45 -45
  460. package/skills/skills/lingshu-compiler/units/compiler-0355bffb/SKILL.md +45 -45
  461. package/skills/skills/lingshu-compiler/units/compiler-0361708a/SKILL.md +45 -45
  462. package/skills/skills/lingshu-compiler/units/compiler-054a0414/SKILL.md +45 -45
  463. package/skills/skills/lingshu-compiler/units/compiler-05a1691a/SKILL.md +45 -45
  464. package/skills/skills/lingshu-compiler/units/compiler-05eeed1e/SKILL.md +45 -45
  465. package/skills/skills/lingshu-compiler/units/compiler-0622a1f6/SKILL.md +45 -45
  466. package/skills/skills/lingshu-compiler/units/compiler-08b54217/SKILL.md +45 -45
  467. package/skills/skills/lingshu-compiler/units/compiler-0a62b70c/SKILL.md +45 -45
  468. package/skills/skills/lingshu-compiler/units/compiler-0ab24d00/SKILL.md +45 -45
  469. package/skills/skills/lingshu-compiler/units/compiler-0e093688/SKILL.md +45 -45
  470. package/skills/skills/lingshu-compiler/units/compiler-0e82b966/SKILL.md +45 -45
  471. package/skills/skills/lingshu-compiler/units/compiler-0ee9b9b9/SKILL.md +45 -45
  472. package/skills/skills/lingshu-compiler/units/compiler-0f3787e6/SKILL.md +45 -45
  473. package/skills/skills/lingshu-compiler/units/compiler-1028685f/SKILL.md +45 -45
  474. package/skills/skills/lingshu-compiler/units/compiler-11897630/SKILL.md +45 -45
  475. package/skills/skills/lingshu-compiler/units/compiler-16661b9b/SKILL.md +45 -45
  476. package/skills/skills/lingshu-compiler/units/compiler-1f722303/SKILL.md +45 -45
  477. package/skills/skills/lingshu-compiler/units/compiler-25be1262/SKILL.md +45 -45
  478. package/skills/skills/lingshu-compiler/units/compiler-2a76ba07/SKILL.md +45 -45
  479. package/skills/skills/lingshu-compiler/units/compiler-2dbea54a/SKILL.md +45 -45
  480. package/skills/skills/lingshu-compiler/units/compiler-2df52f16/SKILL.md +45 -45
  481. package/skills/skills/lingshu-compiler/units/compiler-2ec2c9d2/SKILL.md +45 -45
  482. package/skills/skills/lingshu-compiler/units/compiler-2f8c8f39/SKILL.md +45 -45
  483. package/skills/skills/lingshu-compiler/units/compiler-38378ac7/SKILL.md +45 -45
  484. package/skills/skills/lingshu-compiler/units/compiler-39457d2e/SKILL.md +45 -45
  485. package/skills/skills/lingshu-compiler/units/compiler-39fb5926/SKILL.md +45 -45
  486. package/skills/skills/lingshu-compiler/units/compiler-47f4fbfa/SKILL.md +45 -45
  487. package/skills/skills/lingshu-compiler/units/compiler-4a8cd1f1/SKILL.md +45 -45
  488. package/skills/skills/lingshu-compiler/units/compiler-4b230b6b/SKILL.md +45 -45
  489. package/skills/skills/lingshu-compiler/units/compiler-4cbbda95/SKILL.md +45 -45
  490. package/skills/skills/lingshu-compiler/units/compiler-4d5a68ff/SKILL.md +45 -45
  491. package/skills/skills/lingshu-compiler/units/compiler-56dc9bdd/SKILL.md +45 -45
  492. package/skills/skills/lingshu-compiler/units/compiler-57e76ebe/SKILL.md +45 -45
  493. package/skills/skills/lingshu-compiler/units/compiler-61ff016b/SKILL.md +45 -45
  494. package/skills/skills/lingshu-compiler/units/compiler-63eae588/SKILL.md +45 -45
  495. package/skills/skills/lingshu-compiler/units/compiler-64c4224b/SKILL.md +45 -45
  496. package/skills/skills/lingshu-compiler/units/compiler-66377955/SKILL.md +45 -45
  497. package/skills/skills/lingshu-compiler/units/compiler-674ab4f6/SKILL.md +45 -45
  498. package/skills/skills/lingshu-compiler/units/compiler-6af76fd6/SKILL.md +45 -45
  499. package/skills/skills/lingshu-compiler/units/compiler-6d979db2/SKILL.md +45 -45
  500. package/skills/skills/lingshu-compiler/units/compiler-6de326c0/SKILL.md +45 -45
  501. package/skills/skills/lingshu-compiler/units/compiler-6f1c0eea/SKILL.md +45 -45
  502. package/skills/skills/lingshu-compiler/units/compiler-724d6c9b/SKILL.md +45 -45
  503. package/skills/skills/lingshu-compiler/units/compiler-7690177f/SKILL.md +45 -45
  504. package/skills/skills/lingshu-compiler/units/compiler-7b229a7d/SKILL.md +45 -45
  505. package/skills/skills/lingshu-compiler/units/compiler-7f471b3a/SKILL.md +45 -45
  506. package/skills/skills/lingshu-compiler/units/compiler-815cad08/SKILL.md +45 -45
  507. package/skills/skills/lingshu-compiler/units/compiler-83c61634/SKILL.md +45 -45
  508. package/skills/skills/lingshu-compiler/units/compiler-8c798c81/SKILL.md +45 -45
  509. package/skills/skills/lingshu-compiler/units/compiler-8dd747ac/SKILL.md +45 -45
  510. package/skills/skills/lingshu-compiler/units/compiler-90324d0a/SKILL.md +45 -45
  511. package/skills/skills/lingshu-compiler/units/compiler-94b8d72d/SKILL.md +45 -45
  512. package/skills/skills/lingshu-compiler/units/compiler-94f12231/SKILL.md +45 -45
  513. package/skills/skills/lingshu-compiler/units/compiler-95937c16/SKILL.md +45 -45
  514. package/skills/skills/lingshu-compiler/units/compiler-98a5625b/SKILL.md +45 -45
  515. package/skills/skills/lingshu-compiler/units/compiler-98b4c42f/SKILL.md +45 -45
  516. package/skills/skills/lingshu-compiler/units/compiler-98e3894a/SKILL.md +45 -45
  517. package/skills/skills/lingshu-compiler/units/compiler-9bdfe4b8/SKILL.md +45 -45
  518. package/skills/skills/lingshu-compiler/units/compiler-9d9b4e83/SKILL.md +45 -45
  519. package/skills/skills/lingshu-compiler/units/compiler-9f7be5ad/SKILL.md +45 -45
  520. package/skills/skills/lingshu-compiler/units/compiler-a6daf076/SKILL.md +45 -45
  521. package/skills/skills/lingshu-compiler/units/compiler-a7995a0c/SKILL.md +45 -45
  522. package/skills/skills/lingshu-compiler/units/compiler-a8399248/SKILL.md +45 -45
  523. package/skills/skills/lingshu-compiler/units/compiler-aabbd099/SKILL.md +45 -45
  524. package/skills/skills/lingshu-compiler/units/compiler-afe169d8/SKILL.md +45 -45
  525. package/skills/skills/lingshu-compiler/units/compiler-b0678bda/SKILL.md +45 -45
  526. package/skills/skills/lingshu-compiler/units/compiler-b09bd196/SKILL.md +45 -45
  527. package/skills/skills/lingshu-compiler/units/compiler-b1396e23/SKILL.md +45 -45
  528. package/skills/skills/lingshu-compiler/units/compiler-b9b31ce0/SKILL.md +45 -45
  529. package/skills/skills/lingshu-compiler/units/compiler-c10264a7/SKILL.md +45 -45
  530. package/skills/skills/lingshu-compiler/units/compiler-cb1e8e4b/SKILL.md +45 -45
  531. package/skills/skills/lingshu-compiler/units/compiler-ccafd438/SKILL.md +45 -45
  532. package/skills/skills/lingshu-compiler/units/compiler-cda9c262/SKILL.md +45 -45
  533. package/skills/skills/lingshu-compiler/units/compiler-ce648068/SKILL.md +45 -45
  534. package/skills/skills/lingshu-compiler/units/compiler-cf5776a4/SKILL.md +45 -45
  535. package/skills/skills/lingshu-compiler/units/compiler-d974e5d3/SKILL.md +45 -45
  536. package/skills/skills/lingshu-compiler/units/compiler-e3979fd3/SKILL.md +45 -45
  537. package/skills/skills/lingshu-compiler/units/compiler-eb1cf2b5/SKILL.md +45 -45
  538. package/skills/skills/lingshu-compiler/units/compiler-ecb30d5b/SKILL.md +45 -45
  539. package/skills/skills/lingshu-compiler/units/compiler-f8c8b24b/SKILL.md +45 -45
  540. package/skills/skills/lingshu-compiler/units/compiler-f99fedbe/SKILL.md +45 -45
  541. package/skills/skills/lingshu-compiler/units/compiler-fa8ff5f7/SKILL.md +45 -45
  542. package/skills/skills/lingshu-compiler/units/compiler-fe1b058d/SKILL.md +45 -45
  543. package/skills/skills/lingshu-compiler/units/lex-chinese-program/SKILL.md +45 -45
  544. package/skills/skills/lingshu-compiler/units/lex-dao-de-jing/SKILL.md +45 -45
  545. package/skills/skills/lingshu-compiler/units/lex-nine-chapters/SKILL.md +45 -45
  546. package/skills/skills/lingshu-compiler/units/vm-arithmetic/SKILL.md +45 -45
  547. package/skills/skills/lingshu-compiler/units/vm-array-ops/SKILL.md +45 -45
  548. package/skills/skills/lingshu-compiler/units/vm-closure-call/SKILL.md +45 -45
  549. package/skills/skills/lingshu-compiler/units/vm-closure-create/SKILL.md +45 -45
  550. package/skills/skills/lingshu-compiler/units/vm-compare/SKILL.md +45 -45
  551. package/skills/skills/lingshu-compiler/units/vm-cond-jump/SKILL.md +45 -45
  552. package/skills/skills/lingshu-compiler/units/vm-cond-space/SKILL.md +45 -45
  553. package/skills/skills/lingshu-compiler/units/vm-exception/SKILL.md +45 -45
  554. package/skills/skills/lingshu-compiler/units/vm-func-call/SKILL.md +45 -45
  555. package/skills/skills/lingshu-compiler/units/vm-loop-run/SKILL.md +45 -45
  556. package/skills/skills/lingshu-compiler/units/vm-profiling/SKILL.md +45 -45
  557. package/skills/skills/lingshu-compiler/units/vm-refcount/SKILL.md +45 -45
  558. package/skills/skills/lingshu-compiler/units/vm-run-loop/SKILL.md +45 -45
  559. package/skills/skills/lingshu-compiler/units/vm-short-circuit/SKILL.md +45 -45
  560. package/skills/skills/lingshu-compiler/units/vm-stack-guard/SKILL.md +45 -45
  561. package/skills/skills/lingshu-compiler/units/vm-stack-ops/SKILL.md +45 -45
  562. package/skills/skills/lingshu-compiler/units/vm-trust-accum/SKILL.md +45 -45
  563. package/skills/skills/lingshu-graph/SKILL.md +63 -63
  564. package/skills/skills/lingshu-net/SKILL.md +48 -48
  565. package/skills/skills/lingshu-os/SKILL.md +64 -64
  566. package/skills/skills/lingshu-pylang/SKILL.md +71 -71
  567. package/src/bridge.ts +33 -0
  568. package/src/hooks.ts +38 -2
  569. package/src/index.ts +526 -518
  570. package/src/lib/datapath.ts +326 -326
  571. package/src/lib/mdcg_client.ts +413 -413
  572. package/src/lib/mutual.ts +428 -428
  573. package/src/lib/prompt_safety.ts +62 -62
  574. package/src/lib/python_path.ts +71 -71
  575. package/src/lib/roleplay_web.ts +116 -29
  576. package/src/lib/token_store.ts +13 -3
  577. package/src/tools.ts +212 -212
  578. package/zcode/AGENTS.md +11 -3
  579. package/zcode/README.md +41 -41
  580. /package/docs/{mdcg → hive}//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" +0 -0
@@ -1,587 +1,587 @@
1
- # -*- coding: utf-8 -*-
2
- """M2 蜂巢并发自测:级 4 spec 构造/投递/收卷 + 级 5 意见落库(零直写 / 自验禁止)。
3
-
4
- 真源:docs/记忆评审系统_立项设计与施工交接_20260915.md §5(spec/result 契约)
5
- §7(反面清单:评审不改知识层 / 意见必过 verify 令牌 / 不确定 DEFER)。
6
-
7
- 纪律(同 test_mr_m1.py):
8
- · **自备数据源**——主测面 = tempfile 合成库 + 仓内 hive release 二进制;
9
- hive 不存在即 SKIP(外部 clone 下同样全绿),不依赖真源库。
10
- · **零 LLM**——用确定性假执行器占位 HIVE_EXEC_PY,验证的是并发/文件协议/
11
- 解析/落库全链路,不是模型质量(模型质量属 M3 定位与 M4 治理的评测面)。
12
- · **零直写实锤**——dry_run 批量跑后认知图指纹逐字节不变。
13
-
14
- 覆盖:A spec 构造 B 意见解析与格式校验(100% 口径) C 落库通道与结构性拒绝
15
- D 真蜂巢端到端(1 包 + 10 包×50 条) E 边界与负例
16
-
17
- 运行:python -m md_cg.test_mr_m2
18
- """
19
- from __future__ import annotations
20
-
21
- import hashlib
22
- import json
23
- import os
24
- import subprocess
25
- import sys
26
- import tempfile
27
- import time
28
-
29
- from . import conformance as CF
30
- from . import crosscheck as CC
31
- from . import mdcos
32
- from . import tokens as TK
33
- from .mreview import bundle as BD
34
- from .mreview import candidates as CD
35
- from .mreview import pipeline as PL
36
- from .mreview import ruleset as RS
37
-
38
- PASS = FAIL = SKIP = 0
39
- FAILS = []
40
-
41
-
42
- def ok(cond, label):
43
- global PASS, FAIL
44
- if cond:
45
- PASS += 1
46
- else:
47
- FAIL += 1
48
- FAILS.append(label)
49
- print(" FAIL %s" % label)
50
-
51
-
52
- def skip(label):
53
- global SKIP
54
- SKIP += 1
55
- print(" SKIP %s" % label)
56
-
57
-
58
- # ---------------------------- 合成库 ----------------------------
59
-
60
- def node(nid, layer="knowledge", **kw):
61
- rec = {"id": nid, "layer": layer, "path": "%s/%s.md" % (layer, nid),
62
- "content": "内容 %s" % nid, "content_hash": "hash_%s" % nid, "tags": []}
63
- rec.update(kw)
64
- return rec
65
-
66
-
67
- def mkroot(root, nodes, *, access=(), write_files=True):
68
- """合成认知图根:索引 + 闸门三日志 + 节点盘文件(M1 同构,独立实现)。"""
69
- os.makedirs(root, exist_ok=True)
70
- with open(os.path.join(root, "_index.json"), "w", encoding="utf-8") as f:
71
- json.dump({"nodes": nodes}, f, ensure_ascii=False)
72
- hp = os.path.join(root, "hippocampus")
73
- os.makedirs(hp, exist_ok=True)
74
- for name in ("inbox.jsonl", "decisions.jsonl"):
75
- with open(os.path.join(hp, name), "w", encoding="utf-8") as f:
76
- f.write("")
77
- with open(os.path.join(root, CF.ACCESS_LOG), "w", encoding="utf-8") as f:
78
- for r in access:
79
- f.write(json.dumps(r, ensure_ascii=False) + "\n")
80
- with open(os.path.join(root, CD.FORGET_LOG), "w", encoding="utf-8") as f:
81
- f.write("")
82
- if write_files:
83
- for r in nodes.values():
84
- if not r.get("path"):
85
- continue
86
- p = os.path.join(root, r["path"])
87
- os.makedirs(os.path.dirname(p), exist_ok=True)
88
- with open(p, "w", encoding="utf-8") as f:
89
- f.write(r.get("content", ""))
90
- return root
91
-
92
-
93
- VOLATILE_DIRS = ("_index_log",)
94
-
95
-
96
- def snapshot(root, *, exclude_dirs=()):
97
- ex = set(exclude_dirs)
98
- out = {}
99
- for dp, dns, fns in os.walk(root):
100
- dns[:] = [d for d in dns if d not in ex]
101
- for fn in fns:
102
- p = os.path.join(dp, fn)
103
- with open(p, "rb") as f:
104
- out[os.path.relpath(p, root)] = hashlib.md5(f.read()).hexdigest()
105
- return out
106
-
107
-
108
- def _diff(before, after):
109
- ch = sorted(k for k in set(before) & set(after) if before[k] != after[k])
110
- return "改=%s 增=%s 删=%s" % (ch[:5], sorted(set(after) - set(before))[:5],
111
- sorted(set(before) - set(after))[:5])
112
-
113
-
114
- # ---------------------------- 语料与包 ----------------------------
115
-
116
- def pkg_of(n, *, kind="batch", key="g", bid="bM2", layer="knowledge", kinds=()):
117
- """手工包(与 bundle 输出同形;M2 测的是 spec/收卷/落库,不走候选生成)。"""
118
- ents = []
119
- for i in range(n):
120
- nid = "n%02d" % i
121
- ents.append({"ref": nid, "node_id": nid, "proposal_id": None,
122
- "origin": "assertion", "layer": layer,
123
- "tags": ["doc:note"], "role": "knowledge-card",
124
- "importance": 0.5, "evidence_count": 1 + (i % 3),
125
- "verification_basis": "test" if i % 2 else "",
126
- "lifecycle_state": "active", "content_hash": "h_%s" % nid,
127
- "issue_kinds": list(kinds) if i % 3 == 0 else [],
128
- "evidence": [], "excerpt": "正文摘录 %s" % nid})
129
- return {"bundle_id": bid, "group_kind": kind, "group_key": key,
130
- "group_sig_kind": "tmpl", "size": n, "refs": [e["ref"] for e in ents],
131
- "entries": ents}
132
-
133
-
134
- def asm_of(pkg, *, mech=(), llm=()):
135
- return {"bundle_id": pkg["bundle_id"], "group_kind": pkg["group_kind"],
136
- "group_key": pkg["group_key"], "size": pkg["size"],
137
- "matched": [], "mechanical": list(mech), "llm": list(llm),
138
- "mechanical_by_kind": {}, "mechanical_flagged": 0}
139
-
140
-
141
- # ---------------------------- 假执行器 ----------------------------
142
-
143
- #: 确定性假执行器:读 spec.json/context → 写 result.json(零 LLM,零网络)。
144
- #: 三种模式(FAKE_MODE)全部用来打 M2 的判据,不掺模型质量。
145
- FAKE_EXEC = r'''# -*- coding: utf-8 -*-
146
- import json, os, sys
147
-
148
- job = sys.argv[1]
149
- with open(os.path.join(job, "spec.json"), encoding="utf-8") as f:
150
- spec = json.load(f)
151
- bundle = {}
152
- for p in (spec.get("context_files") or []):
153
- if str(p).endswith(".bundle.json"):
154
- with open(p, encoding="utf-8") as f:
155
- bundle = json.load(f)
156
- break
157
- ents = bundle.get("entries") or []
158
- mode = os.environ.get("FAKE_MODE", "ok")
159
- verdicts = []
160
- for e in ents:
161
- nid = e.get("node_id")
162
- kinds = e.get("issue_kinds") or []
163
- if mode == "bad":
164
- verdicts.append({"node_id": nid, "verdict": "MAYBE"})
165
- elif mode == "textform":
166
- verdicts.append({"node_id": nid, "verdict": "DEFER",
167
- "reason": "条件不足,无法确认"})
168
- elif kinds:
169
- verdicts.append({"node_id": nid, "verdict": "REJECT",
170
- "reason": "来源许可不足(机械层已标注)",
171
- "evidence": ",".join(kinds)})
172
- else:
173
- verdicts.append({"node_id": nid, "verdict": "ACCEPT",
174
- "reason": "机械层无命中,既有基底足以确认适用"})
175
- payload = {"verdicts": verdicts, "summary": "fake:" + mode}
176
- if mode == "textform":
177
- out = {"ok": True, "content": "```json\n" + json.dumps(payload) + "\n```"}
178
- else:
179
- out = {"ok": True, "verdicts": payload["verdicts"], "summary": payload["summary"]}
180
- with open(os.path.join(job, "result.json"), "w", encoding="utf-8") as f:
181
- json.dump(out, f, ensure_ascii=False)
182
- '''
183
-
184
-
185
- def write_fake(root):
186
- os.makedirs(root, exist_ok=True)
187
- p = os.path.join(root, "fake_exec.py")
188
- with open(p, "w", encoding="utf-8") as f:
189
- f.write(FAKE_EXEC)
190
- return p
191
-
192
-
193
- # 合规规则库(本测自备,与生产同形态——由部署侧经 MDCG_POLICY_FILE 配置)。
194
- # 根因(第4条取证):audit._verify_text → _rule_check 在**无规则**时返回 DEFER
195
- # (「无规则不能假装合规」),故规则库缺失会让**每一条**意见转审核队列而落不了盘。
196
- # 这里不是凑空规则(空规则 == 无规则 == 仍 DEFER),而是给出真实判据:
197
- # forbidden = 机密外泄形态(意见正文绝不应出现)
198
- # required = 四要素必须齐(意见正文的核心结构)
199
- POLICY = {"forbidden": [r"(?i)(password|secret|api[_-]?key)\s*[=:]"],
200
- "required": [r"【内容】", r"【原因】", r"【位置】", r"【验证】"]}
201
-
202
-
203
- def write_policy(root):
204
- os.makedirs(root, exist_ok=True)
205
- p = os.path.join(root, "policy.json")
206
- with open(p, "w", encoding="utf-8") as f:
207
- json.dump(POLICY, f, ensure_ascii=False)
208
- return p
209
-
210
-
211
- # ---------------------------- A 组:spec 构造 ----------------------------
212
-
213
- def phase_a(tmp):
214
- print("[A] spec 构造")
215
- pkg = pkg_of(6, kinds=("weak_source",))
216
- asm = asm_of(pkg, mech=[{"issue_kind": "weak_source", "ref": "n00",
217
- "detail": "verification_basis 为空"}],
218
- llm=[{"rule_id": "R-TEMPLATE-FLOW", "check": "template_flow_digits_only",
219
- "question": "正文是否只有编号差异?"}])
220
- ctx_dir = os.path.join(tmp, "ctx_a")
221
- files = PL.dump_context(pkg, asm, ctx_dir)
222
-
223
- ok(len(files) == 2 and all(os.path.isabs(p) for p in files),
224
- "A1 dump_context 产两文件且为绝对路径")
225
- ok(all(os.path.isfile(p) for p in files), "A2 context 文件已落盘")
226
- back = {}
227
- for p in files:
228
- with open(p, encoding="utf-8") as f:
229
- back[os.path.basename(p)] = json.load(f)
230
- b1 = [v for k, v in back.items() if k.endswith(".bundle.json")][0]
231
- r1 = [v for k, v in back.items() if k.endswith(".rules.json")][0]
232
- ok([e["node_id"] for e in b1["entries"]] == [e["node_id"] for e in pkg["entries"]],
233
- "A3 context 内节点清单与包一致")
234
- ok(r1.get("mechanical_by_kind") is not None or "mechanical" in r1,
235
- "A4 context 内含规则装配结果")
236
-
237
- spec = PL.build_spec(pkg, asm, context_files=files)
238
- need = {"model", "system_prompt", "user_prompt", "context_files", "timeout_s"}
239
- ok(need <= set(spec), "A5 spec 契约字段齐备(实得 %s)" % sorted(spec))
240
- ok(spec["context_files"] == files, "A6 spec.context_files 指向 context 文件")
241
- ok(all(e["node_id"] in spec["user_prompt"] for e in pkg["entries"]),
242
- "A7 user_prompt 含全部 node_id(工人不必猜)")
243
- ok("weak_source" in spec["user_prompt"], "A8 user_prompt 含机械命中")
244
- ok("R-TEMPLATE-FLOW" in spec["user_prompt"], "A9 user_prompt 含待检问题")
245
- ok(spec["meta"]["bundle_id"] == pkg["bundle_id"]
246
- and spec["meta"]["node_ids"] == [e["node_id"] for e in pkg["entries"]],
247
- "A10 meta 归因信息与包对齐(收卷配对用)")
248
- ok("不改写任何记忆" in spec["system_prompt"]
249
- and "DEFER" in spec["system_prompt"],
250
- "A11 系统提示显式声明零写纪律与不确定即 DEFER")
251
- ok(spec["temperature"] == 0.0, "A12 默认温度 0(评审要可复现)")
252
-
253
-
254
- # ---------------------------- B 组:解析与格式校验 ----------------------------
255
-
256
- def phase_b(tmp):
257
- print("[B] 意见解析与格式校验")
258
- nids = {"n%02d" % i for i in range(4)}
259
-
260
- direct = {"ok": True, "verdicts": [{"node_id": "n00", "verdict": "ACCEPT",
261
- "reason": "r"}], "summary": "s"}
262
- p1 = PL.parse_opinions(direct)
263
- ok(p1["ok"] and p1["verdicts"][0]["node_id"] == "n00", "B1 收直写形态 verdicts")
264
-
265
- txt = {"ok": True, "content": "前言\n```json\n%s\n```\n后记"
266
- % json.dumps({"verdicts": [{"node_id": "n01", "verdict": "DEFER",
267
- "reason": "r"}], "summary": "t"})}
268
- p2 = PL.parse_opinions(txt)
269
- ok(p2["ok"] and p2["verdicts"][0]["node_id"] == "n01",
270
- "B2 收 content 文本形态(```json 围栏)")
271
-
272
- p3 = PL.parse_opinions({"ok": True, "content": "模型啥也没说"})
273
- ok(not p3["ok"] and "解析" in p3["error"], "B3 垃圾文本 → ok=False 不炸")
274
- p4 = PL.parse_opinions({"ok": True, "error": "api 超时"})
275
- ok(not p4["ok"] and "超时" in p4["error"], "B4 工人报错原样透出")
276
-
277
- ok(PL.validate_opinion({"node_id": "n00", "verdict": "accept",
278
- "reason": "r"}, nids) is None, "B5 合法意见通过(含小写归一)")
279
- ok(PL.validate_opinion({"verdict": "ACCEPT", "reason": "r"}, nids) is not None,
280
- "B6 缺 node_id 被拒")
281
- ok(PL.validate_opinion({"node_id": "n00", "verdict": "MAYBE", "reason": "r"},
282
- nids) is not None, "B7 verdict 越界被拒")
283
- ok(PL.validate_opinion({"node_id": "n00", "verdict": "ACCEPT"}, nids) is not None,
284
- "B8 缺 reason 被拒")
285
- ok(PL.validate_opinion({"node_id": "n00", "verdict": "REJECT", "reason": "r"},
286
- nids) is not None, "B9 REJECT 缺 evidence 被拒")
287
- ok(PL.validate_opinion({"node_id": "zzz", "verdict": "ACCEPT", "reason": "r"},
288
- nids) is not None, "B10 node_id 越出本包被拒")
289
-
290
- good = {"node_id": "n00", "verdict": "ACCEPT", "reason": "r"}
291
- bad = {"node_id": "n01", "verdict": "??", "reason": "r"}
292
- v = PL.validate_opinions([good, bad, dict(good, node_id="n02")], nids)
293
- ok(v["total"] == 3 and len(v["valid"]) == 2 and len(v["invalid"]) == 1,
294
- "B11 混合批量 → valid/invalid 分流正确")
295
- ok(abs(v["pass_rate"] - 2.0 / 3) < 1e-9, "B12 pass_rate 口径 = valid/total")
296
- ok(not v["ok"], "B13 有非法即整体 ok=False(不确定即 DEFER,不静默放行)")
297
- ok(PL.validate_opinions([], nids)["pass_rate"] == 1.0,
298
- "B14 空集 pass_rate=1.0(分母零的显式约定)")
299
-
300
-
301
- # ---------------------------- C 组:落库通道 ----------------------------
302
-
303
- def _ops():
304
- return [{"node_id": "n00", "verdict": "ACCEPT", "reason": "机械层无命中"},
305
- {"node_id": "n01", "verdict": "REJECT", "reason": "来源许可不足",
306
- "evidence": "verification_basis 为空且无外部佐证"},
307
- {"node_id": "n02", "verdict": "DEFER", "reason": "条件不足,无法确认"}]
308
-
309
-
310
- def phase_c(tmp):
311
- print("[C] 落库通道(verify 令牌 + 结构性拒绝)")
312
- root = mkroot(os.path.join(tmp, "cgc"), {"k1": node("k1")})
313
- cg = mdcos.MdCGSecure(root, principal=PL.verifier_principal(actor="applier"))
314
- pkg = pkg_of(3)
315
-
316
- # C1-C3 自验违例:产出意见者 == 落库裁决者
317
- before = snapshot(root, exclude_dirs=VOLATILE_DIRS)
318
- r1 = PL.apply_opinions(cg, pkg, _ops(), reviewer="same-actor",
319
- applier="same-actor")
320
- ok(bool(r1.get("refused")) and r1.get("reason") == "self_verify_disallowed",
321
- "C1 评审者==落库者 → 自验违例拒绝(实得 %s)" % r1.get("reason"))
322
- ok(not r1.get("committed"), "C2 自验违例未落库")
323
- ok(snapshot(root, exclude_dirs=VOLATILE_DIRS) == before,
324
- "C3 自验违例零写入(认知图指纹不变)")
325
-
326
- # C4-C6 正常落库(verify 令牌 → writepipe 六道闸 → contextual)
327
- r2 = PL.apply_opinions(cg, pkg, _ops(), reviewer="mreview-worker",
328
- applier="mreview-applier", summary="整包结论:1 拒 1 缓")
329
- moved = (r2.get("response") or {}).get("moved_to")
330
- ok(r2.get("committed") is True,
331
- "C4 意见落库 committed=True(实得 committed=%s moved_to=%s detail=%s)"
332
- % (r2.get("committed"), moved, (r2.get("detail") or "")[:120]))
333
- ok(r2.get("layer") == PL.OPINION_LAYER == "contextual",
334
- "C5 落层 = contextual(非知识层)")
335
- p_node = os.path.join(root, "contextual", str(r2.get("node_id")) + ".md")
336
- ok(os.path.isfile(p_node), "C6 意见节点已落盘(%s)" % os.path.relpath(p_node, root))
337
- if os.path.isfile(p_node):
338
- with open(p_node, encoding="utf-8") as f:
339
- doc = f.read()
340
- ok("ACCEPT 1" in doc and "REJECT 1" in doc and "DEFER 1" in doc,
341
- "C7 正文含裁决分布(四态计数)")
342
- ok("verification_basis 为空且无外部佐证" in doc, "C8 正文含逐条理由与证据")
343
- ok("【内容】" in doc and "【位置】" in doc, "C9 正文含四要素")
344
-
345
- # C10 空意见 → 零噪声不落库
346
- r3 = PL.apply_opinions(cg, pkg, [], reviewer="w", applier="a")
347
- ok(r3.get("ok") and r3.get("skipped") and not r3.get("committed"),
348
- "C10 无有效意见 → skipped 不落库(零噪声)")
349
-
350
- # C4b 合规规则库缺失 → 合规闸 DEFER → 转审核队列(诚实降级,不假装落库)
351
- _saved = os.environ.pop("MDCG_POLICY_FILE", None)
352
- try:
353
- r3b = PL.apply_opinions(cg, pkg, _ops(), reviewer="w", applier="a",
354
- node_id="mr_opinion_nopolicy")
355
- ok(not r3b.get("committed") and r3b.get("moved_to") == "review_queue"
356
- and r3b.get("deferred") is True,
357
- "C4b 无规则库 → 转审核队列而非落盘(moved_to=%s deferred=%s)"
358
- % (r3b.get("moved_to"), r3b.get("deferred")))
359
- finally:
360
- if _saved is not None:
361
- os.environ["MDCG_POLICY_FILE"] = _saved
362
-
363
- # C11 越层写入:knowledge 被库层结构性拒绝(§7 反面清单第 1 条)
364
- r4 = PL.apply_opinions(cg, pkg, _ops(), reviewer="w", applier="a",
365
- layer="knowledge")
366
- ok(bool(r4.get("refused")) and r4.get("reason") == "layer_denied",
367
- "C11 写 knowledge 层被拒(实得 refused=%s reason=%s)"
368
- % (r4.get("refused"), r4.get("reason")))
369
- ok(not os.path.isfile(os.path.join(root, "knowledge", str(r4.get("node_id")) + ".md")),
370
- "C12 越层写入确未落盘")
371
-
372
- # C13 非法条目被剔除、合法条目照落(不因个别越界全盘丢弃)
373
- mixed = [{"node_id": "n00", "verdict": "ACCEPT", "reason": "r"},
374
- {"node_id": "ghost", "verdict": "ACCEPT", "reason": "越包"}]
375
- nids = {e["node_id"] for e in pkg["entries"]}
376
- val = PL.validate_opinions(mixed, nids)
377
- r5 = PL.apply_opinions(cg, pkg, val["valid"], reviewer="w", applier="a",
378
- node_id="mr_opinion_mixed", invalid=val["invalid"])
379
- ok(len(val["valid"]) == 1 and len(val["invalid"]) == 1,
380
- "C13 越包条目被剔除(1 留 1 剔)")
381
- ok(r5.get("committed"), "C14 剔除后合法条目照常落库")
382
- p5 = os.path.join(root, "contextual", "mr_opinion_mixed.md")
383
- if os.path.isfile(p5):
384
- with open(p5, encoding="utf-8") as f:
385
- ok("未落库条目" in f.read(), "C15 正文留痕被剔除条目(可审计)")
386
- else:
387
- ok(False, "C15 正文留痕被剔除条目(文件缺失)")
388
-
389
- # C16 dry_run 不写盘
390
- before2 = snapshot(root, exclude_dirs=VOLATILE_DIRS)
391
- r6 = PL.apply_opinions(cg, pkg, _ops(), reviewer="w", applier="a",
392
- dry_run=True)
393
- ok(r6.get("dry_run") and not r6.get("committed"), "C16 dry_run 返回标记")
394
- ok(snapshot(root, exclude_dirs=VOLATILE_DIRS) == before2, "C17 dry_run 零写入")
395
-
396
-
397
- # ---------------------------- D 组:真蜂巢端到端 ----------------------------
398
-
399
- def _start_serve(exe, jobs, fake, workers=2, timeout=25.0, env_extra=None):
400
- """拉起独立 serve(独立 jobs 目录 + 假执行器,隔离生产 serve)。
401
-
402
- env_extra:额外的 **serve 级**环境(如 FAKE_MODE)。执行器子进程继承 serve
403
- 环境(hive 以 Command::new 启动 exec.py,未 env_clear),故 serve 级注入对
404
- 工人可见;但也因此环境在 serve 启动时即固定——换模式须另起一个 serve。
405
- """
406
- env = dict(os.environ)
407
- env["PYTHONUTF8"] = "1"
408
- env["HIVE_EXEC_PY"] = fake
409
- for _k, _v in (env_extra or {}).items():
410
- env[str(_k)] = str(_v)
411
- p = subprocess.Popen([exe, "serve", "--jobs", jobs, "--workers", str(workers)],
412
- stdout=subprocess.PIPE, stderr=subprocess.STDOUT,
413
- text=True, encoding="utf-8", errors="replace", env=env)
414
- t0 = time.time()
415
- while time.time() - t0 < timeout:
416
- if os.path.isfile(os.path.join(jobs, "_serve.json")):
417
- time.sleep(0.4)
418
- return p, True
419
- if p.poll() is not None:
420
- return p, False
421
- time.sleep(0.3)
422
- return p, False
423
-
424
-
425
- def _stop_serve(p):
426
- try:
427
- p.terminate()
428
- p.wait(timeout=8)
429
- except Exception: # noqa: BLE001
430
- try:
431
- p.kill()
432
- except Exception: # noqa: BLE001
433
- pass
434
-
435
-
436
- def phase_d(tmp, exe):
437
- print("[D] 真蜂巢端到端")
438
- if not os.path.isfile(exe):
439
- skip("hive 二进制不存在(%s)→ D 组跳过(外部 clone 同此路径)" % exe)
440
- return
441
- base = os.path.join(tmp, "d")
442
- jobs = os.path.join(base, "jobs")
443
- ctx = os.path.join(base, "ctx")
444
- fake = write_fake(base)
445
- os.makedirs(base, exist_ok=True)
446
-
447
- nodes = {"n%02d" % i: node("n%02d" % i) for i in range(50)}
448
- root = mkroot(os.path.join(base, "cg"), nodes)
449
- cg = mdcos.MdCGSecure(root, principal=PL.verifier_principal(actor="applier"))
450
- pkg = pkg_of(50, kinds=("weak_source",))
451
- asm = asm_of(pkg, mech=[{"issue_kind": "weak_source", "ref": "n00",
452
- "detail": "verification_basis 为空"}])
453
-
454
- p, ready = _start_serve(exe, jobs, fake)
455
- ok(ready, "D0 独立 serve 就绪(jobs=%s)" % os.path.relpath(jobs, tmp))
456
- if not ready:
457
- _stop_serve(p)
458
- return
459
- try:
460
- # D1 单包全链路
461
- one = PL.run_package(pkg=pkg, asm=asm, cg=cg, exe=exe, jobs_dir=jobs,
462
- ctx_dir=ctx, reviewer="mreview-worker",
463
- applier="mreview-applier", timeout_s=120,
464
- interval_s=0.3)
465
- ok(one.get("ok"), "D1 单包 run_package 全链路 ok(stage=%s bundle=%s)"
466
- % (one.get("stage"), one.get("error") or "-"))
467
- ok(one.get("pass_rate") == 1.0, "D2 单包意见格式校验 100%%(实得 %s)"
468
- % one.get("pass_rate"))
469
- ok((one.get("apply") or {}).get("committed"), "D3 单包意见落库 committed")
470
-
471
- # D4 零直写实锤:dry_run 批量 10 包(50 条/包)→ 认知图指纹不变
472
- pairs = [(pkg_of(50, bid="b%02d" % i, key="g%02d" % i,
473
- kinds=("weak_source",)),
474
- asm_of(pkg_of(50, bid="b%02d" % i, key="g%02d" % i)))
475
- for i in range(10)]
476
- before = snapshot(root, exclude_dirs=VOLATILE_DIRS)
477
- rep = PL.run_batch(pairs=pairs, cg=cg, exe=exe, jobs_dir=jobs, ctx_dir=ctx,
478
- reviewer="mreview-worker", applier="mreview-applier",
479
- timeout_s=300, interval_s=0.3, dry_run=True)
480
- ok(rep["jobs"] == 10 and rep["done"] == 10,
481
- "D4 10 包并发投递全部 done(jobs=%s done=%s failed=%s)"
482
- % (rep["jobs"], rep["done"], rep["failed"]))
483
- ok(rep["pass_rate"] == 1.0,
484
- "D5 10 包×50 条意见格式校验 100%%(实得 %s,invalid=%s)"
485
- % (rep["pass_rate"], rep["invalid"]))
486
- ok(rep["opinions"] == 500,
487
- "D6 意见条数 == 10×50(实得 %s)" % rep["opinions"])
488
- ok(snapshot(root, exclude_dirs=VOLATILE_DIRS) == before,
489
- "D7 worker 零直写:dry_run 批量后认知图指纹逐字节不变")
490
-
491
- # D8 实际落库:仅新增意见节点
492
- _ctxdir = os.path.join(root, "contextual")
493
- n_before = (len([f for f in os.listdir(_ctxdir) if f.endswith(".md")])
494
- if os.path.isdir(_ctxdir) else 0)
495
- rep2 = PL.run_batch(pairs=pairs[:3], cg=cg, exe=exe, jobs_dir=jobs,
496
- ctx_dir=ctx, reviewer="mreview-worker",
497
- applier="mreview-applier", timeout_s=300,
498
- interval_s=0.3, dry_run=False)
499
- n_after = len([f for f in os.listdir(_ctxdir) if f.endswith(".md")])
500
- ok(rep2["committed"] == 3,
501
- "D8 3 包实际落库 committed==3(实得 %s)" % rep2["committed"])
502
- ok(n_after - n_before == 3,
503
- "D9 认知图仅新增 3 个意见节点(%s→%s)" % (n_before, n_after))
504
- ok(not os.path.isdir(os.path.join(root, "knowledge"))
505
- or len([f for f in os.listdir(os.path.join(root, "knowledge"))]) == 50,
506
- "D10 knowledge 层节点数不变(评审不改知识层)")
507
-
508
- # D11 非法意见(verdict 越界)→ 全数拦截,不落库。
509
- # 执行器模式是 **serve 级**配置(HIVE_EXEC_PY 与 FAKE_MODE 在 serve 启动
510
- # 时固定),故反例另起一个独立 serve(独立 jobs + FAKE_MODE=bad),
511
- # 用完即停——与主 serve 互不干扰,也不碰生产 serve。
512
- bad_pkg = pkg_of(4, bid="bbad", key="gb")
513
- bad_jobs = os.path.join(base, "jobs_bad")
514
- pb, rb = _start_serve(exe, bad_jobs, fake, workers=1,
515
- env_extra={"FAKE_MODE": "bad"})
516
- ok(rb, "D11a 反例 serve(FAKE_MODE=bad)就绪")
517
- if rb:
518
- try:
519
- rep3 = PL.run_batch(pairs=[(bad_pkg, asm_of(bad_pkg))], cg=cg,
520
- exe=exe, jobs_dir=bad_jobs, ctx_dir=ctx,
521
- reviewer="mreview-worker",
522
- applier="mreview-applier", timeout_s=120,
523
- interval_s=0.3, dry_run=False)
524
- ok(rep3["pass_rate"] == 0.0 and rep3["committed"] == 0,
525
- "D11 越界意见全数拦截(pass_rate=%s committed=%s)"
526
- % (rep3["pass_rate"], rep3["committed"]))
527
- finally:
528
- _stop_serve(pb)
529
- finally:
530
- _stop_serve(p)
531
-
532
-
533
- # ---------------------------- E 组:边界与负例 ----------------------------
534
-
535
- def phase_e(tmp):
536
- print("[E] 边界与负例")
537
- ok(not PL.read_result(os.path.join(tmp, "nope"), "j1")["ok"],
538
- "E1 read_result 对不存在 job 返回 ok=False(不炸)")
539
- if os.path.isfile(PL.hive_exe()):
540
- r2 = PL.poll(PL.hive_exe(), os.path.join(tmp, "nope"), timeout=20)
541
- ok(r2.get("ok") is True and int(r2.get("count") or 0) == 0,
542
- "E2 poll 对空 jobs 目录不炸(ok=True count=0,实得 %s)"
543
- % {k: r2.get(k) for k in ("ok", "count")})
544
- ok(PL.hive_exe("X:/custom/hive.exe") == "X:/custom/hive.exe",
545
- "E3 hive_exe 显式参数优先")
546
- ok(PL.parse_opinions({"ok": True, "verdicts": []})["ok"], "E4 空 verdicts 可解析")
547
- ok(not PL.parse_opinions({"ok": True, "verdicts": {}})["ok"],
548
- "E5 verdicts 非数组被拒(不静默)")
549
- r = PL.verifier_principal()
550
- ok("contextual" in (r.layers_allow or []) and "knowledge" not in (r.layers_allow or []),
551
- "E6 verify 令牌层权限取自 tokens 真源(不含 knowledge)")
552
- ok(CC.detect_self_verify([{"unit": CC.REFLECT_UNIT, "actor": "x"},
553
- {"unit": CC.VERIFY_UNIT, "actor": "y"}]) is False,
554
- "E7 不同执行者不判自验违例")
555
-
556
-
557
- # ---------------------------- main ----------------------------
558
-
559
- def main(argv=None):
560
- exe = PL.hive_exe()
561
- with tempfile.TemporaryDirectory(prefix="mrev_m2_") as tmp:
562
- # 合规规则库:写路径的 audit 闸要有规则才可能 ACCEPT(无规则恒 DEFER →
563
- # 意见只会进审核队列)。生产由私有运行时配 MDCG_POLICY_FILE,本测同样
564
- # 显式配置——否则测不到真实落库链路,只能测到「入队」。
565
- _saved_policy = os.environ.get("MDCG_POLICY_FILE")
566
- os.environ["MDCG_POLICY_FILE"] = write_policy(tmp)
567
- try:
568
- phase_a(tmp)
569
- phase_b(tmp)
570
- phase_c(tmp)
571
- phase_d(tmp, exe)
572
- phase_e(tmp)
573
- finally:
574
- if _saved_policy is None:
575
- os.environ.pop("MDCG_POLICY_FILE", None)
576
- else:
577
- os.environ["MDCG_POLICY_FILE"] = _saved_policy
578
- print("\nM2 自测:%d 通过 / %d 失败 / %d 跳过" % (PASS, FAIL, SKIP))
579
- if FAILS:
580
- print("失败项:")
581
- for f in FAILS:
582
- print(" - %s" % f)
583
- return 1 if FAIL else 0
584
-
585
-
586
- if __name__ == "__main__":
587
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """M2 蜂巢并发自测:级 4 spec 构造/投递/收卷 + 级 5 意见落库(零直写 / 自验禁止)。
3
+
4
+ 真源:docs/记忆评审系统_立项设计与施工交接_20260915.md §5(spec/result 契约)
5
+ §7(反面清单:评审不改知识层 / 意见必过 verify 令牌 / 不确定 DEFER)。
6
+
7
+ 纪律(同 test_mr_m1.py):
8
+ · **自备数据源**——主测面 = tempfile 合成库 + 仓内 hive release 二进制;
9
+ hive 不存在即 SKIP(外部 clone 下同样全绿),不依赖真源库。
10
+ · **零 LLM**——用确定性假执行器占位 HIVE_EXEC_PY,验证的是并发/文件协议/
11
+ 解析/落库全链路,不是模型质量(模型质量属 M3 定位与 M4 治理的评测面)。
12
+ · **零直写实锤**——dry_run 批量跑后认知图指纹逐字节不变。
13
+
14
+ 覆盖:A spec 构造 B 意见解析与格式校验(100% 口径) C 落库通道与结构性拒绝
15
+ D 真蜂巢端到端(1 包 + 10 包×50 条) E 边界与负例
16
+
17
+ 运行:python -m md_cg.test_mr_m2
18
+ """
19
+ from __future__ import annotations
20
+
21
+ import hashlib
22
+ import json
23
+ import os
24
+ import subprocess
25
+ import sys
26
+ import tempfile
27
+ import time
28
+
29
+ from . import conformance as CF
30
+ from . import crosscheck as CC
31
+ from . import mdcos
32
+ from . import tokens as TK
33
+ from .mreview import bundle as BD
34
+ from .mreview import candidates as CD
35
+ from .mreview import pipeline as PL
36
+ from .mreview import ruleset as RS
37
+
38
+ PASS = FAIL = SKIP = 0
39
+ FAILS = []
40
+
41
+
42
+ def ok(cond, label):
43
+ global PASS, FAIL
44
+ if cond:
45
+ PASS += 1
46
+ else:
47
+ FAIL += 1
48
+ FAILS.append(label)
49
+ print(" FAIL %s" % label)
50
+
51
+
52
+ def skip(label):
53
+ global SKIP
54
+ SKIP += 1
55
+ print(" SKIP %s" % label)
56
+
57
+
58
+ # ---------------------------- 合成库 ----------------------------
59
+
60
+ def node(nid, layer="knowledge", **kw):
61
+ rec = {"id": nid, "layer": layer, "path": "%s/%s.md" % (layer, nid),
62
+ "content": "内容 %s" % nid, "content_hash": "hash_%s" % nid, "tags": []}
63
+ rec.update(kw)
64
+ return rec
65
+
66
+
67
+ def mkroot(root, nodes, *, access=(), write_files=True):
68
+ """合成认知图根:索引 + 闸门三日志 + 节点盘文件(M1 同构,独立实现)。"""
69
+ os.makedirs(root, exist_ok=True)
70
+ with open(os.path.join(root, "_index.json"), "w", encoding="utf-8") as f:
71
+ json.dump({"nodes": nodes}, f, ensure_ascii=False)
72
+ hp = os.path.join(root, "hippocampus")
73
+ os.makedirs(hp, exist_ok=True)
74
+ for name in ("inbox.jsonl", "decisions.jsonl"):
75
+ with open(os.path.join(hp, name), "w", encoding="utf-8") as f:
76
+ f.write("")
77
+ with open(os.path.join(root, CF.ACCESS_LOG), "w", encoding="utf-8") as f:
78
+ for r in access:
79
+ f.write(json.dumps(r, ensure_ascii=False) + "\n")
80
+ with open(os.path.join(root, CD.FORGET_LOG), "w", encoding="utf-8") as f:
81
+ f.write("")
82
+ if write_files:
83
+ for r in nodes.values():
84
+ if not r.get("path"):
85
+ continue
86
+ p = os.path.join(root, r["path"])
87
+ os.makedirs(os.path.dirname(p), exist_ok=True)
88
+ with open(p, "w", encoding="utf-8") as f:
89
+ f.write(r.get("content", ""))
90
+ return root
91
+
92
+
93
+ VOLATILE_DIRS = ("_index_log",)
94
+
95
+
96
+ def snapshot(root, *, exclude_dirs=()):
97
+ ex = set(exclude_dirs)
98
+ out = {}
99
+ for dp, dns, fns in os.walk(root):
100
+ dns[:] = [d for d in dns if d not in ex]
101
+ for fn in fns:
102
+ p = os.path.join(dp, fn)
103
+ with open(p, "rb") as f:
104
+ out[os.path.relpath(p, root)] = hashlib.md5(f.read()).hexdigest()
105
+ return out
106
+
107
+
108
+ def _diff(before, after):
109
+ ch = sorted(k for k in set(before) & set(after) if before[k] != after[k])
110
+ return "改=%s 增=%s 删=%s" % (ch[:5], sorted(set(after) - set(before))[:5],
111
+ sorted(set(before) - set(after))[:5])
112
+
113
+
114
+ # ---------------------------- 语料与包 ----------------------------
115
+
116
+ def pkg_of(n, *, kind="batch", key="g", bid="bM2", layer="knowledge", kinds=()):
117
+ """手工包(与 bundle 输出同形;M2 测的是 spec/收卷/落库,不走候选生成)。"""
118
+ ents = []
119
+ for i in range(n):
120
+ nid = "n%02d" % i
121
+ ents.append({"ref": nid, "node_id": nid, "proposal_id": None,
122
+ "origin": "assertion", "layer": layer,
123
+ "tags": ["doc:note"], "role": "knowledge-card",
124
+ "importance": 0.5, "evidence_count": 1 + (i % 3),
125
+ "verification_basis": "test" if i % 2 else "",
126
+ "lifecycle_state": "active", "content_hash": "h_%s" % nid,
127
+ "issue_kinds": list(kinds) if i % 3 == 0 else [],
128
+ "evidence": [], "excerpt": "正文摘录 %s" % nid})
129
+ return {"bundle_id": bid, "group_kind": kind, "group_key": key,
130
+ "group_sig_kind": "tmpl", "size": n, "refs": [e["ref"] for e in ents],
131
+ "entries": ents}
132
+
133
+
134
+ def asm_of(pkg, *, mech=(), llm=()):
135
+ return {"bundle_id": pkg["bundle_id"], "group_kind": pkg["group_kind"],
136
+ "group_key": pkg["group_key"], "size": pkg["size"],
137
+ "matched": [], "mechanical": list(mech), "llm": list(llm),
138
+ "mechanical_by_kind": {}, "mechanical_flagged": 0}
139
+
140
+
141
+ # ---------------------------- 假执行器 ----------------------------
142
+
143
+ #: 确定性假执行器:读 spec.json/context → 写 result.json(零 LLM,零网络)。
144
+ #: 三种模式(FAKE_MODE)全部用来打 M2 的判据,不掺模型质量。
145
+ FAKE_EXEC = r'''# -*- coding: utf-8 -*-
146
+ import json, os, sys
147
+
148
+ job = sys.argv[1]
149
+ with open(os.path.join(job, "spec.json"), encoding="utf-8") as f:
150
+ spec = json.load(f)
151
+ bundle = {}
152
+ for p in (spec.get("context_files") or []):
153
+ if str(p).endswith(".bundle.json"):
154
+ with open(p, encoding="utf-8") as f:
155
+ bundle = json.load(f)
156
+ break
157
+ ents = bundle.get("entries") or []
158
+ mode = os.environ.get("FAKE_MODE", "ok")
159
+ verdicts = []
160
+ for e in ents:
161
+ nid = e.get("node_id")
162
+ kinds = e.get("issue_kinds") or []
163
+ if mode == "bad":
164
+ verdicts.append({"node_id": nid, "verdict": "MAYBE"})
165
+ elif mode == "textform":
166
+ verdicts.append({"node_id": nid, "verdict": "DEFER",
167
+ "reason": "条件不足,无法确认"})
168
+ elif kinds:
169
+ verdicts.append({"node_id": nid, "verdict": "REJECT",
170
+ "reason": "来源许可不足(机械层已标注)",
171
+ "evidence": ",".join(kinds)})
172
+ else:
173
+ verdicts.append({"node_id": nid, "verdict": "ACCEPT",
174
+ "reason": "机械层无命中,既有基底足以确认适用"})
175
+ payload = {"verdicts": verdicts, "summary": "fake:" + mode}
176
+ if mode == "textform":
177
+ out = {"ok": True, "content": "```json\n" + json.dumps(payload) + "\n```"}
178
+ else:
179
+ out = {"ok": True, "verdicts": payload["verdicts"], "summary": payload["summary"]}
180
+ with open(os.path.join(job, "result.json"), "w", encoding="utf-8") as f:
181
+ json.dump(out, f, ensure_ascii=False)
182
+ '''
183
+
184
+
185
+ def write_fake(root):
186
+ os.makedirs(root, exist_ok=True)
187
+ p = os.path.join(root, "fake_exec.py")
188
+ with open(p, "w", encoding="utf-8") as f:
189
+ f.write(FAKE_EXEC)
190
+ return p
191
+
192
+
193
+ # 合规规则库(本测自备,与生产同形态——由部署侧经 MDCG_POLICY_FILE 配置)。
194
+ # 根因(第4条取证):audit._verify_text → _rule_check 在**无规则**时返回 DEFER
195
+ # (「无规则不能假装合规」),故规则库缺失会让**每一条**意见转审核队列而落不了盘。
196
+ # 这里不是凑空规则(空规则 == 无规则 == 仍 DEFER),而是给出真实判据:
197
+ # forbidden = 机密外泄形态(意见正文绝不应出现)
198
+ # required = 四要素必须齐(意见正文的核心结构)
199
+ POLICY = {"forbidden": [r"(?i)(password|secret|api[_-]?key)\s*[=:]"],
200
+ "required": [r"【内容】", r"【原因】", r"【位置】", r"【验证】"]}
201
+
202
+
203
+ def write_policy(root):
204
+ os.makedirs(root, exist_ok=True)
205
+ p = os.path.join(root, "policy.json")
206
+ with open(p, "w", encoding="utf-8") as f:
207
+ json.dump(POLICY, f, ensure_ascii=False)
208
+ return p
209
+
210
+
211
+ # ---------------------------- A 组:spec 构造 ----------------------------
212
+
213
+ def phase_a(tmp):
214
+ print("[A] spec 构造")
215
+ pkg = pkg_of(6, kinds=("weak_source",))
216
+ asm = asm_of(pkg, mech=[{"issue_kind": "weak_source", "ref": "n00",
217
+ "detail": "verification_basis 为空"}],
218
+ llm=[{"rule_id": "R-TEMPLATE-FLOW", "check": "template_flow_digits_only",
219
+ "question": "正文是否只有编号差异?"}])
220
+ ctx_dir = os.path.join(tmp, "ctx_a")
221
+ files = PL.dump_context(pkg, asm, ctx_dir)
222
+
223
+ ok(len(files) == 2 and all(os.path.isabs(p) for p in files),
224
+ "A1 dump_context 产两文件且为绝对路径")
225
+ ok(all(os.path.isfile(p) for p in files), "A2 context 文件已落盘")
226
+ back = {}
227
+ for p in files:
228
+ with open(p, encoding="utf-8") as f:
229
+ back[os.path.basename(p)] = json.load(f)
230
+ b1 = [v for k, v in back.items() if k.endswith(".bundle.json")][0]
231
+ r1 = [v for k, v in back.items() if k.endswith(".rules.json")][0]
232
+ ok([e["node_id"] for e in b1["entries"]] == [e["node_id"] for e in pkg["entries"]],
233
+ "A3 context 内节点清单与包一致")
234
+ ok(r1.get("mechanical_by_kind") is not None or "mechanical" in r1,
235
+ "A4 context 内含规则装配结果")
236
+
237
+ spec = PL.build_spec(pkg, asm, context_files=files)
238
+ need = {"model", "system_prompt", "user_prompt", "context_files", "timeout_s"}
239
+ ok(need <= set(spec), "A5 spec 契约字段齐备(实得 %s)" % sorted(spec))
240
+ ok(spec["context_files"] == files, "A6 spec.context_files 指向 context 文件")
241
+ ok(all(e["node_id"] in spec["user_prompt"] for e in pkg["entries"]),
242
+ "A7 user_prompt 含全部 node_id(工人不必猜)")
243
+ ok("weak_source" in spec["user_prompt"], "A8 user_prompt 含机械命中")
244
+ ok("R-TEMPLATE-FLOW" in spec["user_prompt"], "A9 user_prompt 含待检问题")
245
+ ok(spec["meta"]["bundle_id"] == pkg["bundle_id"]
246
+ and spec["meta"]["node_ids"] == [e["node_id"] for e in pkg["entries"]],
247
+ "A10 meta 归因信息与包对齐(收卷配对用)")
248
+ ok("不改写任何记忆" in spec["system_prompt"]
249
+ and "DEFER" in spec["system_prompt"],
250
+ "A11 系统提示显式声明零写纪律与不确定即 DEFER")
251
+ ok(spec["temperature"] == 0.0, "A12 默认温度 0(评审要可复现)")
252
+
253
+
254
+ # ---------------------------- B 组:解析与格式校验 ----------------------------
255
+
256
+ def phase_b(tmp):
257
+ print("[B] 意见解析与格式校验")
258
+ nids = {"n%02d" % i for i in range(4)}
259
+
260
+ direct = {"ok": True, "verdicts": [{"node_id": "n00", "verdict": "ACCEPT",
261
+ "reason": "r"}], "summary": "s"}
262
+ p1 = PL.parse_opinions(direct)
263
+ ok(p1["ok"] and p1["verdicts"][0]["node_id"] == "n00", "B1 收直写形态 verdicts")
264
+
265
+ txt = {"ok": True, "content": "前言\n```json\n%s\n```\n后记"
266
+ % json.dumps({"verdicts": [{"node_id": "n01", "verdict": "DEFER",
267
+ "reason": "r"}], "summary": "t"})}
268
+ p2 = PL.parse_opinions(txt)
269
+ ok(p2["ok"] and p2["verdicts"][0]["node_id"] == "n01",
270
+ "B2 收 content 文本形态(```json 围栏)")
271
+
272
+ p3 = PL.parse_opinions({"ok": True, "content": "模型啥也没说"})
273
+ ok(not p3["ok"] and "解析" in p3["error"], "B3 垃圾文本 → ok=False 不炸")
274
+ p4 = PL.parse_opinions({"ok": True, "error": "api 超时"})
275
+ ok(not p4["ok"] and "超时" in p4["error"], "B4 工人报错原样透出")
276
+
277
+ ok(PL.validate_opinion({"node_id": "n00", "verdict": "accept",
278
+ "reason": "r"}, nids) is None, "B5 合法意见通过(含小写归一)")
279
+ ok(PL.validate_opinion({"verdict": "ACCEPT", "reason": "r"}, nids) is not None,
280
+ "B6 缺 node_id 被拒")
281
+ ok(PL.validate_opinion({"node_id": "n00", "verdict": "MAYBE", "reason": "r"},
282
+ nids) is not None, "B7 verdict 越界被拒")
283
+ ok(PL.validate_opinion({"node_id": "n00", "verdict": "ACCEPT"}, nids) is not None,
284
+ "B8 缺 reason 被拒")
285
+ ok(PL.validate_opinion({"node_id": "n00", "verdict": "REJECT", "reason": "r"},
286
+ nids) is not None, "B9 REJECT 缺 evidence 被拒")
287
+ ok(PL.validate_opinion({"node_id": "zzz", "verdict": "ACCEPT", "reason": "r"},
288
+ nids) is not None, "B10 node_id 越出本包被拒")
289
+
290
+ good = {"node_id": "n00", "verdict": "ACCEPT", "reason": "r"}
291
+ bad = {"node_id": "n01", "verdict": "??", "reason": "r"}
292
+ v = PL.validate_opinions([good, bad, dict(good, node_id="n02")], nids)
293
+ ok(v["total"] == 3 and len(v["valid"]) == 2 and len(v["invalid"]) == 1,
294
+ "B11 混合批量 → valid/invalid 分流正确")
295
+ ok(abs(v["pass_rate"] - 2.0 / 3) < 1e-9, "B12 pass_rate 口径 = valid/total")
296
+ ok(not v["ok"], "B13 有非法即整体 ok=False(不确定即 DEFER,不静默放行)")
297
+ ok(PL.validate_opinions([], nids)["pass_rate"] == 1.0,
298
+ "B14 空集 pass_rate=1.0(分母零的显式约定)")
299
+
300
+
301
+ # ---------------------------- C 组:落库通道 ----------------------------
302
+
303
+ def _ops():
304
+ return [{"node_id": "n00", "verdict": "ACCEPT", "reason": "机械层无命中"},
305
+ {"node_id": "n01", "verdict": "REJECT", "reason": "来源许可不足",
306
+ "evidence": "verification_basis 为空且无外部佐证"},
307
+ {"node_id": "n02", "verdict": "DEFER", "reason": "条件不足,无法确认"}]
308
+
309
+
310
+ def phase_c(tmp):
311
+ print("[C] 落库通道(verify 令牌 + 结构性拒绝)")
312
+ root = mkroot(os.path.join(tmp, "cgc"), {"k1": node("k1")})
313
+ cg = mdcos.MdCGSecure(root, principal=PL.verifier_principal(actor="applier"))
314
+ pkg = pkg_of(3)
315
+
316
+ # C1-C3 自验违例:产出意见者 == 落库裁决者
317
+ before = snapshot(root, exclude_dirs=VOLATILE_DIRS)
318
+ r1 = PL.apply_opinions(cg, pkg, _ops(), reviewer="same-actor",
319
+ applier="same-actor")
320
+ ok(bool(r1.get("refused")) and r1.get("reason") == "self_verify_disallowed",
321
+ "C1 评审者==落库者 → 自验违例拒绝(实得 %s)" % r1.get("reason"))
322
+ ok(not r1.get("committed"), "C2 自验违例未落库")
323
+ ok(snapshot(root, exclude_dirs=VOLATILE_DIRS) == before,
324
+ "C3 自验违例零写入(认知图指纹不变)")
325
+
326
+ # C4-C6 正常落库(verify 令牌 → writepipe 六道闸 → contextual)
327
+ r2 = PL.apply_opinions(cg, pkg, _ops(), reviewer="mreview-worker",
328
+ applier="mreview-applier", summary="整包结论:1 拒 1 缓")
329
+ moved = (r2.get("response") or {}).get("moved_to")
330
+ ok(r2.get("committed") is True,
331
+ "C4 意见落库 committed=True(实得 committed=%s moved_to=%s detail=%s)"
332
+ % (r2.get("committed"), moved, (r2.get("detail") or "")[:120]))
333
+ ok(r2.get("layer") == PL.OPINION_LAYER == "contextual",
334
+ "C5 落层 = contextual(非知识层)")
335
+ p_node = os.path.join(root, "contextual", str(r2.get("node_id")) + ".md")
336
+ ok(os.path.isfile(p_node), "C6 意见节点已落盘(%s)" % os.path.relpath(p_node, root))
337
+ if os.path.isfile(p_node):
338
+ with open(p_node, encoding="utf-8") as f:
339
+ doc = f.read()
340
+ ok("ACCEPT 1" in doc and "REJECT 1" in doc and "DEFER 1" in doc,
341
+ "C7 正文含裁决分布(四态计数)")
342
+ ok("verification_basis 为空且无外部佐证" in doc, "C8 正文含逐条理由与证据")
343
+ ok("【内容】" in doc and "【位置】" in doc, "C9 正文含四要素")
344
+
345
+ # C10 空意见 → 零噪声不落库
346
+ r3 = PL.apply_opinions(cg, pkg, [], reviewer="w", applier="a")
347
+ ok(r3.get("ok") and r3.get("skipped") and not r3.get("committed"),
348
+ "C10 无有效意见 → skipped 不落库(零噪声)")
349
+
350
+ # C4b 合规规则库缺失 → 合规闸 DEFER → 转审核队列(诚实降级,不假装落库)
351
+ _saved = os.environ.pop("MDCG_POLICY_FILE", None)
352
+ try:
353
+ r3b = PL.apply_opinions(cg, pkg, _ops(), reviewer="w", applier="a",
354
+ node_id="mr_opinion_nopolicy")
355
+ ok(not r3b.get("committed") and r3b.get("moved_to") == "review_queue"
356
+ and r3b.get("deferred") is True,
357
+ "C4b 无规则库 → 转审核队列而非落盘(moved_to=%s deferred=%s)"
358
+ % (r3b.get("moved_to"), r3b.get("deferred")))
359
+ finally:
360
+ if _saved is not None:
361
+ os.environ["MDCG_POLICY_FILE"] = _saved
362
+
363
+ # C11 越层写入:knowledge 被库层结构性拒绝(§7 反面清单第 1 条)
364
+ r4 = PL.apply_opinions(cg, pkg, _ops(), reviewer="w", applier="a",
365
+ layer="knowledge")
366
+ ok(bool(r4.get("refused")) and r4.get("reason") == "layer_denied",
367
+ "C11 写 knowledge 层被拒(实得 refused=%s reason=%s)"
368
+ % (r4.get("refused"), r4.get("reason")))
369
+ ok(not os.path.isfile(os.path.join(root, "knowledge", str(r4.get("node_id")) + ".md")),
370
+ "C12 越层写入确未落盘")
371
+
372
+ # C13 非法条目被剔除、合法条目照落(不因个别越界全盘丢弃)
373
+ mixed = [{"node_id": "n00", "verdict": "ACCEPT", "reason": "r"},
374
+ {"node_id": "ghost", "verdict": "ACCEPT", "reason": "越包"}]
375
+ nids = {e["node_id"] for e in pkg["entries"]}
376
+ val = PL.validate_opinions(mixed, nids)
377
+ r5 = PL.apply_opinions(cg, pkg, val["valid"], reviewer="w", applier="a",
378
+ node_id="mr_opinion_mixed", invalid=val["invalid"])
379
+ ok(len(val["valid"]) == 1 and len(val["invalid"]) == 1,
380
+ "C13 越包条目被剔除(1 留 1 剔)")
381
+ ok(r5.get("committed"), "C14 剔除后合法条目照常落库")
382
+ p5 = os.path.join(root, "contextual", "mr_opinion_mixed.md")
383
+ if os.path.isfile(p5):
384
+ with open(p5, encoding="utf-8") as f:
385
+ ok("未落库条目" in f.read(), "C15 正文留痕被剔除条目(可审计)")
386
+ else:
387
+ ok(False, "C15 正文留痕被剔除条目(文件缺失)")
388
+
389
+ # C16 dry_run 不写盘
390
+ before2 = snapshot(root, exclude_dirs=VOLATILE_DIRS)
391
+ r6 = PL.apply_opinions(cg, pkg, _ops(), reviewer="w", applier="a",
392
+ dry_run=True)
393
+ ok(r6.get("dry_run") and not r6.get("committed"), "C16 dry_run 返回标记")
394
+ ok(snapshot(root, exclude_dirs=VOLATILE_DIRS) == before2, "C17 dry_run 零写入")
395
+
396
+
397
+ # ---------------------------- D 组:真蜂巢端到端 ----------------------------
398
+
399
+ def _start_serve(exe, jobs, fake, workers=2, timeout=25.0, env_extra=None):
400
+ """拉起独立 serve(独立 jobs 目录 + 假执行器,隔离生产 serve)。
401
+
402
+ env_extra:额外的 **serve 级**环境(如 FAKE_MODE)。执行器子进程继承 serve
403
+ 环境(hive 以 Command::new 启动 exec.py,未 env_clear),故 serve 级注入对
404
+ 工人可见;但也因此环境在 serve 启动时即固定——换模式须另起一个 serve。
405
+ """
406
+ env = dict(os.environ)
407
+ env["PYTHONUTF8"] = "1"
408
+ env["HIVE_EXEC_PY"] = fake
409
+ for _k, _v in (env_extra or {}).items():
410
+ env[str(_k)] = str(_v)
411
+ p = subprocess.Popen([exe, "serve", "--jobs", jobs, "--workers", str(workers)],
412
+ stdout=subprocess.PIPE, stderr=subprocess.STDOUT,
413
+ text=True, encoding="utf-8", errors="replace", env=env)
414
+ t0 = time.time()
415
+ while time.time() - t0 < timeout:
416
+ if os.path.isfile(os.path.join(jobs, "_serve.json")):
417
+ time.sleep(0.4)
418
+ return p, True
419
+ if p.poll() is not None:
420
+ return p, False
421
+ time.sleep(0.3)
422
+ return p, False
423
+
424
+
425
+ def _stop_serve(p):
426
+ try:
427
+ p.terminate()
428
+ p.wait(timeout=8)
429
+ except Exception: # noqa: BLE001
430
+ try:
431
+ p.kill()
432
+ except Exception: # noqa: BLE001
433
+ pass
434
+
435
+
436
+ def phase_d(tmp, exe):
437
+ print("[D] 真蜂巢端到端")
438
+ if not os.path.isfile(exe):
439
+ skip("hive 二进制不存在(%s)→ D 组跳过(外部 clone 同此路径)" % exe)
440
+ return
441
+ base = os.path.join(tmp, "d")
442
+ jobs = os.path.join(base, "jobs")
443
+ ctx = os.path.join(base, "ctx")
444
+ fake = write_fake(base)
445
+ os.makedirs(base, exist_ok=True)
446
+
447
+ nodes = {"n%02d" % i: node("n%02d" % i) for i in range(50)}
448
+ root = mkroot(os.path.join(base, "cg"), nodes)
449
+ cg = mdcos.MdCGSecure(root, principal=PL.verifier_principal(actor="applier"))
450
+ pkg = pkg_of(50, kinds=("weak_source",))
451
+ asm = asm_of(pkg, mech=[{"issue_kind": "weak_source", "ref": "n00",
452
+ "detail": "verification_basis 为空"}])
453
+
454
+ p, ready = _start_serve(exe, jobs, fake)
455
+ ok(ready, "D0 独立 serve 就绪(jobs=%s)" % os.path.relpath(jobs, tmp))
456
+ if not ready:
457
+ _stop_serve(p)
458
+ return
459
+ try:
460
+ # D1 单包全链路
461
+ one = PL.run_package(pkg=pkg, asm=asm, cg=cg, exe=exe, jobs_dir=jobs,
462
+ ctx_dir=ctx, reviewer="mreview-worker",
463
+ applier="mreview-applier", timeout_s=120,
464
+ interval_s=0.3)
465
+ ok(one.get("ok"), "D1 单包 run_package 全链路 ok(stage=%s bundle=%s)"
466
+ % (one.get("stage"), one.get("error") or "-"))
467
+ ok(one.get("pass_rate") == 1.0, "D2 单包意见格式校验 100%%(实得 %s)"
468
+ % one.get("pass_rate"))
469
+ ok((one.get("apply") or {}).get("committed"), "D3 单包意见落库 committed")
470
+
471
+ # D4 零直写实锤:dry_run 批量 10 包(50 条/包)→ 认知图指纹不变
472
+ pairs = [(pkg_of(50, bid="b%02d" % i, key="g%02d" % i,
473
+ kinds=("weak_source",)),
474
+ asm_of(pkg_of(50, bid="b%02d" % i, key="g%02d" % i)))
475
+ for i in range(10)]
476
+ before = snapshot(root, exclude_dirs=VOLATILE_DIRS)
477
+ rep = PL.run_batch(pairs=pairs, cg=cg, exe=exe, jobs_dir=jobs, ctx_dir=ctx,
478
+ reviewer="mreview-worker", applier="mreview-applier",
479
+ timeout_s=300, interval_s=0.3, dry_run=True)
480
+ ok(rep["jobs"] == 10 and rep["done"] == 10,
481
+ "D4 10 包并发投递全部 done(jobs=%s done=%s failed=%s)"
482
+ % (rep["jobs"], rep["done"], rep["failed"]))
483
+ ok(rep["pass_rate"] == 1.0,
484
+ "D5 10 包×50 条意见格式校验 100%%(实得 %s,invalid=%s)"
485
+ % (rep["pass_rate"], rep["invalid"]))
486
+ ok(rep["opinions"] == 500,
487
+ "D6 意见条数 == 10×50(实得 %s)" % rep["opinions"])
488
+ ok(snapshot(root, exclude_dirs=VOLATILE_DIRS) == before,
489
+ "D7 worker 零直写:dry_run 批量后认知图指纹逐字节不变")
490
+
491
+ # D8 实际落库:仅新增意见节点
492
+ _ctxdir = os.path.join(root, "contextual")
493
+ n_before = (len([f for f in os.listdir(_ctxdir) if f.endswith(".md")])
494
+ if os.path.isdir(_ctxdir) else 0)
495
+ rep2 = PL.run_batch(pairs=pairs[:3], cg=cg, exe=exe, jobs_dir=jobs,
496
+ ctx_dir=ctx, reviewer="mreview-worker",
497
+ applier="mreview-applier", timeout_s=300,
498
+ interval_s=0.3, dry_run=False)
499
+ n_after = len([f for f in os.listdir(_ctxdir) if f.endswith(".md")])
500
+ ok(rep2["committed"] == 3,
501
+ "D8 3 包实际落库 committed==3(实得 %s)" % rep2["committed"])
502
+ ok(n_after - n_before == 3,
503
+ "D9 认知图仅新增 3 个意见节点(%s→%s)" % (n_before, n_after))
504
+ ok(not os.path.isdir(os.path.join(root, "knowledge"))
505
+ or len([f for f in os.listdir(os.path.join(root, "knowledge"))]) == 50,
506
+ "D10 knowledge 层节点数不变(评审不改知识层)")
507
+
508
+ # D11 非法意见(verdict 越界)→ 全数拦截,不落库。
509
+ # 执行器模式是 **serve 级**配置(HIVE_EXEC_PY 与 FAKE_MODE 在 serve 启动
510
+ # 时固定),故反例另起一个独立 serve(独立 jobs + FAKE_MODE=bad),
511
+ # 用完即停——与主 serve 互不干扰,也不碰生产 serve。
512
+ bad_pkg = pkg_of(4, bid="bbad", key="gb")
513
+ bad_jobs = os.path.join(base, "jobs_bad")
514
+ pb, rb = _start_serve(exe, bad_jobs, fake, workers=1,
515
+ env_extra={"FAKE_MODE": "bad"})
516
+ ok(rb, "D11a 反例 serve(FAKE_MODE=bad)就绪")
517
+ if rb:
518
+ try:
519
+ rep3 = PL.run_batch(pairs=[(bad_pkg, asm_of(bad_pkg))], cg=cg,
520
+ exe=exe, jobs_dir=bad_jobs, ctx_dir=ctx,
521
+ reviewer="mreview-worker",
522
+ applier="mreview-applier", timeout_s=120,
523
+ interval_s=0.3, dry_run=False)
524
+ ok(rep3["pass_rate"] == 0.0 and rep3["committed"] == 0,
525
+ "D11 越界意见全数拦截(pass_rate=%s committed=%s)"
526
+ % (rep3["pass_rate"], rep3["committed"]))
527
+ finally:
528
+ _stop_serve(pb)
529
+ finally:
530
+ _stop_serve(p)
531
+
532
+
533
+ # ---------------------------- E 组:边界与负例 ----------------------------
534
+
535
+ def phase_e(tmp):
536
+ print("[E] 边界与负例")
537
+ ok(not PL.read_result(os.path.join(tmp, "nope"), "j1")["ok"],
538
+ "E1 read_result 对不存在 job 返回 ok=False(不炸)")
539
+ if os.path.isfile(PL.hive_exe()):
540
+ r2 = PL.poll(PL.hive_exe(), os.path.join(tmp, "nope"), timeout=20)
541
+ ok(r2.get("ok") is True and int(r2.get("count") or 0) == 0,
542
+ "E2 poll 对空 jobs 目录不炸(ok=True count=0,实得 %s)"
543
+ % {k: r2.get(k) for k in ("ok", "count")})
544
+ ok(PL.hive_exe("X:/custom/hive.exe") == "X:/custom/hive.exe",
545
+ "E3 hive_exe 显式参数优先")
546
+ ok(PL.parse_opinions({"ok": True, "verdicts": []})["ok"], "E4 空 verdicts 可解析")
547
+ ok(not PL.parse_opinions({"ok": True, "verdicts": {}})["ok"],
548
+ "E5 verdicts 非数组被拒(不静默)")
549
+ r = PL.verifier_principal()
550
+ ok("contextual" in (r.layers_allow or []) and "knowledge" not in (r.layers_allow or []),
551
+ "E6 verify 令牌层权限取自 tokens 真源(不含 knowledge)")
552
+ ok(CC.detect_self_verify([{"unit": CC.REFLECT_UNIT, "actor": "x"},
553
+ {"unit": CC.VERIFY_UNIT, "actor": "y"}]) is False,
554
+ "E7 不同执行者不判自验违例")
555
+
556
+
557
+ # ---------------------------- main ----------------------------
558
+
559
+ def main(argv=None):
560
+ exe = PL.hive_exe()
561
+ with tempfile.TemporaryDirectory(prefix="mrev_m2_") as tmp:
562
+ # 合规规则库:写路径的 audit 闸要有规则才可能 ACCEPT(无规则恒 DEFER →
563
+ # 意见只会进审核队列)。生产由私有运行时配 MDCG_POLICY_FILE,本测同样
564
+ # 显式配置——否则测不到真实落库链路,只能测到「入队」。
565
+ _saved_policy = os.environ.get("MDCG_POLICY_FILE")
566
+ os.environ["MDCG_POLICY_FILE"] = write_policy(tmp)
567
+ try:
568
+ phase_a(tmp)
569
+ phase_b(tmp)
570
+ phase_c(tmp)
571
+ phase_d(tmp, exe)
572
+ phase_e(tmp)
573
+ finally:
574
+ if _saved_policy is None:
575
+ os.environ.pop("MDCG_POLICY_FILE", None)
576
+ else:
577
+ os.environ["MDCG_POLICY_FILE"] = _saved_policy
578
+ print("\nM2 自测:%d 通过 / %d 失败 / %d 跳过" % (PASS, FAIL, SKIP))
579
+ if FAILS:
580
+ print("失败项:")
581
+ for f in FAILS:
582
+ print(" - %s" % f)
583
+ return 1 if FAIL else 0
584
+
585
+
586
+ if __name__ == "__main__":
587
+ sys.exit(main())