@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. 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 +0 -169
  532. 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 +0 -144
  533. 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 +0 -299
  534. 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 +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. 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 +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. 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 +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. 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 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. 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 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. 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 +0 -100
  584. 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 +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. 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
  587. 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 +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. 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 +0 -156
  590. 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 +0 -210
  591. 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 +0 -227
  592. 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 +0 -203
  593. 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 +0 -233
  594. 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 +0 -191
  595. 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 +0 -213
  596. 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 +0 -214
  597. 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 +0 -199
  598. 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_v18.md +0 -183
  599. 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_v19.md +0 -207
  600. 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 +0 -156
  601. 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_v20.md +0 -283
  602. 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_v21.md +0 -224
  603. 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_v22.md +0 -223
  604. 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_v23.md +0 -293
  605. 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_v24.md +0 -303
  606. 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_v25.md +0 -230
  607. 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_v26.md +0 -196
  608. 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_v27.md +0 -259
  609. 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_v28.md +0 -217
  610. 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_v29.md +0 -270
  611. 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 +0 -152
  612. 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_v30.md +0 -231
  613. 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_v31.md +0 -281
  614. 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 +0 -128
  615. 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 +0 -114
  616. 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 +0 -192
  617. 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 +0 -187
  618. 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 +0 -207
  619. 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 +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/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 -385
  623. package/docs/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 +0 -165
  624. 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 +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/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 +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. 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 +0 -43
  629. 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 +0 -210
  630. 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 +0 -152
  631. 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 +0 -47
  632. 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 +0 -519
  633. 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 +0 -85
  634. 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 +0 -191
  635. 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 +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. 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 +0 -82
  651. 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 +0 -600
  652. 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 +0 -266
  653. 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 +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. 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 +0 -130
  656. 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 -278
  657. 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 -164
  658. 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 -43
  659. 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 +0 -181
  660. 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 +0 -177
  661. 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 +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. 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 +0 -491
  665. 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 -552
  666. 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 -340
  667. 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 +0 -624
  668. 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 -94
  669. 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 +0 -281
  670. 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 +0 -93
  671. 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 +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. 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 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. 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 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. 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 +0 -242
  691. 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 -68
  692. 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 -130
  693. 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 -89
  694. 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 +0 -365
  695. 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 -239
  696. 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 +0 -129
  697. 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 +0 -134
  698. 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 -789
  699. 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 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. 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 +0 -145
  702. 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 +0 -144
  703. 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 +0 -198
  704. 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 -812
  705. 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 -421
  706. 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 +0 -221
  707. 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 +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. 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 +0 -82
  710. 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 +0 -98
  711. 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 +0 -109
  712. 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 +0 -286
  713. 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 +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. 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 +0 -183
@@ -1,378 +1,456 @@
1
- # -*- coding: utf-8 -*-
2
- """test_reach.py · 检索候选收敛层(reach)验收。
3
-
4
- 覆盖(对应 A2/A3 判据的可证形式):
5
- (1) 包含性:收敛集 ⊇ 全量 LIKE 命中集,且 ⊇ 词法打分>0 集合(A2「不丢召回」的可证形式)
6
- (2) 条件门控:收敛集 ⊆ 调用方候选集(层/角色/会话/分支由 _candidates 承载);不可读节点不越权
7
- (3) 图扩散:edges 邻居被吸收补召回;扩散受 DIFFUSE_MAX_FACTOR 上限约束
8
- (4) 回退:MDCG_REACH=0 / 单字符 term / 索引不可用 → 不收敛(返回 None),旧行为不变
9
- (5) 端到端:search 开关两态结果集为包含关系、meta 带 reach*、scanned 下降
10
- (6) 缓存失效:新增节点后重建,新节点可被收敛召回(防陈旧缓存丢召回)
11
-
12
- 运行:python -m md_cg.test_reach
13
- """
14
- from __future__ import annotations
15
-
16
- import json
17
- import os
18
- import tempfile
19
- import time
20
-
21
- from .mdcos import MdCGOS
22
- from .mdcg import bigrams, expand_query_terms, normalize_en
23
- from . import reach
24
-
25
- PASS = FAIL = 0
26
- FAILS = []
27
-
28
-
29
- def ok(cond, label, detail=""):
30
- global PASS, FAIL
31
- if cond:
32
- PASS += 1
33
- print(f" [PASS] {label}" + (f" · {detail}" if detail else ""))
34
- else:
35
- FAIL += 1
36
- FAILS.append(label)
37
- print(f" [FAIL] {label}" + (f" · {detail}" if detail else ""))
38
-
39
-
40
- QUERY = "召回截断 分池"
41
- BODY = "召回截断 索引 分池 内容"
42
-
43
-
44
- def _mk(root):
45
- cg = MdCGOS(root, actor="test_reach")
46
- for i in range(3):
47
- cg.add(f"code_{i}", f"# 功能名:索引条目 {i}\n# 生效条件:条件 I\n\n{BODY} {i}\n",
48
- layer="knowledge", tags=["index"])
49
- for i in range(3):
50
- cg.add(f"kp_{i}", f"# 功能名:知识 {i}\n# 生效条件:条件 K\n\n召回截断 索引 内容 {i}\n",
51
- layer="knowledge")
52
- cg.add("other_1", "# 功能名:无关\n# 生效条件:条件 O\n\n完全无关的另一段文本。\n",
53
- layer="knowledge")
54
- # 组扩散:other_2 不含查询词,但被 code_0 通过 edges 指向(图扩散应把它补进收敛集)
55
- cg.add("other_2", "# 功能名:邻居\n# 生效条件:条件 N\n\n也不含查询词的邻居正文。\n",
56
- layer="knowledge")
57
- cg.add("code_0b", f"# 功能名:索引条目 0b\n# 生效条件:条件 I\n\n{BODY} 0b\n",
58
- layer="knowledge", edges=[{"target": "other_2", "type": "similar", "confidence": 0.9}])
59
- cg.add("n_rej", f"# 功能名:被否决\n# 生效条件:条件 R\n\n{BODY} 否\n", layer="rejected")
60
- cg.flush()
61
- return cg
62
-
63
-
64
- def _env(on):
65
- os.environ["MDCG_REACH"] = "1" if on else "0"
66
- reach._CACHE.clear()
67
-
68
-
69
- def _search_both(cg, query, k, on):
70
- """在指定开关下跑一次 search(供两态对比)。"""
71
- _env(on)
72
- if on:
73
- reach._CACHE.clear()
74
- return cg.search(query, k=k)
75
-
76
-
77
- def _like_ids(cg, entries, terms):
78
- stat = {"scanned": 0}
79
- docs = cg._read_many(entries, stat)
80
- return {e["path"] for e, fm, c in docs if cg._like(c, fm, terms)}, docs
81
-
82
-
83
- def main():
84
- print("md_cg 收敛层 reach 验收 · 大域收敛 / 条件门控 / 图扩散 / 回退")
85
- print("=" * 70)
86
- root = tempfile.mkdtemp(prefix="mdcg_reach_")
87
- try:
88
- os.environ["MDCG_REACH_INDEX"] = os.path.join(root, "_idx_measure.json")
89
- cg = _mk(root)
90
- entries = cg._candidates()
91
- terms = expand_query_terms(QUERY)
92
- qb = bigrams(normalize_en(QUERY))
93
-
94
- # ---------------- (1) 包含性 ----------------
95
- print("\n(1) 大域收敛包含性(A2 可证形式)")
96
- _env(True)
97
- full_like, docs = _like_ids(cg, entries, terms)
98
- narrow, meta = reach.narrow(cg, entries, terms, qb, None, q=QUERY)
99
- nset = {e["path"] for e in (narrow or [])}
100
- ok(full_like and full_like <= nset,
101
- "(1) 收敛集 ⊇ 全量 LIKE 命中集", f"like={len(full_like)} narrow={len(nset)} miss={len(full_like - nset)}")
102
- scored = cg._score(docs, QUERY, qb, None)
103
- pos = {d[0]["path"] for d in scored if d[1] > 0}
104
- ok(pos <= nset, "(1) 收敛集 ⊇ 词法打分>0 集合",
105
- f"score>0={len(pos)} miss={len(pos - nset)}")
106
- ok(meta.get("reach") == "converged" and meta.get("reach_seed", 0) > 0,
107
- "(1) meta 如实报收敛状态", str(meta))
108
-
109
- # ---------------- (2) 条件门控 ----------------
110
- print("\n(2) 条件门控(收敛集 ⊆ 候选集)")
111
- epaths = {e["path"] for e in entries}
112
- ok(nset <= epaths, "(2) 收敛集不越出调用方候选集")
113
- ok(all(e.get("layer") != "rejected" for e in narrow), "(2) 负记忆层不因收敛回流")
114
-
115
- # ---------------- (3) 图扩散 ----------------
116
- print("\n(3) 图扩散")
117
- idx = reach._index(cg)
118
- ids = {e["path"].split("/")[-1][:-3] for e in narrow}
119
- os.environ["MDCG_REACH_DIFFUSE"] = "1" # 扩散默认关(保 A2 精确),此处置开验证能力
120
- narrow_d, meta_d = reach.narrow(cg, entries, terms, qb, None, q=QUERY)
121
- os.environ["MDCG_REACH_DIFFUSE"] = "0"
122
- ids_d = {e["path"].split("/")[-1][:-3] for e in (narrow_d or [])}
123
- ok("other_2" in ids_d and meta_d.get("reach_diffused") == 1,
124
- "(3) 扩散开关开启时 edges 邻居被吸收",
125
- f"other_2 in narrow_d={'other_2' in ids_d} diffused={meta_d.get('reach_diffused')} (默认关时 ids={len(ids)})")
126
- fake = reach.ReachIndex(root)
127
- fake.adj = {"a": ["b", "c"], "b": ["d"], "d": ["e"]}
128
- one = fake.diffuse({"a"}, hops=1)
129
- two = fake.diffuse({"a"}, hops=2)
130
- ok(one == {"a", "b", "c"}, "(3) 1 跳邻居集合正确", str(sorted(one)))
131
- ok(two >= {"a", "b", "c", "d"}, "(3) 2 跳可达", str(sorted(two)))
132
- big = {"s0"}
133
- fake.adj = {"s0": [f"n{i}" for i in range(100)]}
134
- lim = fake.diffuse({"s0"}, hops=1, limit=3)
135
- ok(len(lim) <= 3, "(3) 扩散受上限约束", f"|out|={len(lim)}")
136
-
137
- # ---------------- (4) 回退 ----------------
138
- print("\n(4) 回退(不适用条件 → 不收敛)")
139
- _env(False)
140
- got, meta = reach.narrow(cg, entries, terms, qb, None, q=QUERY)
141
- ok(got is None and meta.get("reach") == "off", "(4) MDCG_REACH=0 → 不收敛", str(meta))
142
- _env(True)
143
- got, meta = reach.narrow(cg, entries, ["白"], bigrams("白"), None, q="白")
144
- ok(got is None and meta.get("reach") == "short_term", "(4) 单字符 term → 不收敛", str(meta))
145
- saved = reach._index
146
- reach._index = lambda *a, **k: None
147
- try:
148
- got, meta = reach.narrow(cg, entries, terms, qb, None, q=QUERY)
149
- ok(got is None and meta.get("reach") == "index_unavailable",
150
- "(4) 索引不可用 → 不收敛", str(meta))
151
- finally:
152
- reach._index = saved
153
-
154
- # ---------------- (5) 端到端 ----------------
155
- print("\n(5) 端到端(search 两态)")
156
- _env(False)
157
- res_off, m_off = cg.search(QUERY, k=10)
158
- off_ids = [r[0]["id"] for r in res_off]
159
- _env(True)
160
- reach._CACHE.clear()
161
- res_on, m_on = cg.search(QUERY, k=10)
162
- on_ids = [r[0]["id"] for r in res_on]
163
- ok(set(on_ids) >= set(off_ids), "(5) 开态结果集 ⊇ 关态(不丢召回)",
164
- f"off={off_ids[:3]} on={on_ids[:3]}")
165
- ok(m_on.get("reach") == "converged" and m_on.get("reach_seed"),
166
- "(5) meta 透出 reach* 审计字段", f"reach={m_on.get('reach')} seed={m_on.get('reach_seed')}")
167
- ok(m_on.get("scanned", 0) <= m_off.get("scanned", 0),
168
- "(5) 开态读盘数不增(收敛生效)",
169
- f"off={m_off.get('scanned')} on={m_on.get('scanned')}")
170
- ok(m_on.get("pre_cap", 0) >= m_off.get("pre_cap", 0),
171
- "(5) 截断前候选数不少于关态(图扩散可补召回)",
172
- f"off={m_off.get('pre_cap')} on={m_on.get('pre_cap')}")
173
- # 图扩散必须真的落到**结果层**(T3-r3 复核:只并入收敛集、随后被 _like 过滤掉等于没做)
174
- os.environ["MDCG_REACH_DIFFUSE"] = "1" # 结果层放行扩散节点需显式开关
175
- res_big_off, _ = _search_both(cg, QUERY, 50, False)
176
- res_big_on, _ = _search_both(cg, QUERY, 50, True)
177
- os.environ["MDCG_REACH_DIFFUSE"] = "0"
178
- ids_on = {r[0]["id"] for r in res_big_on}
179
- ids_off = {r[0]["id"] for r in res_big_off}
180
- ok("other_2" in ids_on and "other_2" not in ids_off,
181
- "(5) 图扩散邻居进入 search 结果(补召回落地)",
182
- f"other_2 on={'other_2' in ids_on} off={'other_2' in ids_off}")
183
-
184
- # r14 复核:收敛集非空但 LIKE 命中为空 → 回退全量,且 meta.reach 必须改写为 reverted(不得谎报 converged)
185
- _env(True)
186
- _saved_like = cg._like
187
- cg._like = staticmethod(lambda *a, **k: False) # 模拟「bigram 有交集但无 LIKE 命中」
188
- try:
189
- res_rv, m_rv = cg.search(QUERY, k=5)
190
- finally:
191
- cg._like = _saved_like
192
- ok(m_rv.get("reach") == "reverted",
193
- "(5b) 回退全量时 reach 改写为 reverted(不谎报 converged)", str(m_rv.get("reach")))
194
- ok(bool(res_rv), "(5b) 回退后仍能出结果(全量路径)", f"n={len(res_rv)}")
195
- ok(m_rv.get("reach_reverted") is True, "(5b) 回退标记 reach_reverted=True")
196
- ok(isinstance(m_rv.get("reach_reverted_docs"), int) and m_rv["reach_reverted_docs"] >= 0,
197
- "(5b) 回退时暴露收敛阶段读盘量(A3 可扣减)", f"docs={m_rv.get('reach_reverted_docs')}")
198
- # 让该次调用确实发生重建:清缓存并把磁盘缓存改旧,再令 _like 恒假 → 回退且首建成本必须保留
199
- reach._CACHE.clear()
200
- live2 = reach._index(cg)
201
- live2.built_at = time.time() - 4000
202
- try:
203
- d4 = json.load(open(live2.path, encoding="utf-8"))
204
- d4["built_at"] = time.time() - 4000
205
- json.dump(d4, open(live2.path, "w", encoding="utf-8"))
206
- except OSError:
207
- pass
208
- cg._like = staticmethod(lambda *a, **k: False)
209
- try:
210
- res_rv2, m_rv2 = cg.search(QUERY, k=5)
211
- finally:
212
- cg._like = _saved_like
213
- ok(m_rv2.get("reach") == "reverted" and m_rv2.get("reach_build_docs") is not None,
214
- "(5b) 回退时若发生重建,首建成本字段必须保留",
215
- f"reach={m_rv2.get(chr(39)+chr(39)) if False else m_rv2.get('reach')} build={m_rv2.get('reach_build_docs')}")
216
-
217
- # ---------------- (6) 缓存失效 ----------------
218
- print("\n(6) 缓存失效(新增节点后仍可召回)")
219
- cg.add("code_new", f"# 功能名:新增索引条目\n# 生效条件:条件 I\n\n{BODY} new\n",
220
- layer="knowledge", tags=["index"])
221
- cg.flush()
222
- res2, m2 = cg.search(QUERY, k=20)
223
- ok(any(r[0]["id"] == "code_new" for r in res2),
224
- "(6) 新增节点进入收敛集(指纹失效触发重建)",
225
- f"reach={m2.get('reach')} ids={[r[0]['id'] for r in res2][:4]}")
226
- # 指纹必须含 path(r6 复核:路径交换/重命名而 content_hash 未变时不得复用缓存)
227
- class _FakeCG:
228
- def __init__(self, path):
229
- self.root = root
230
- self.index = {"nodes": {"n1": {"path": path, "content_hash": "H1"}}}
231
- fp_a = reach._fingerprint(_FakeCG("knowledge/a.md"))
232
- fp_b = reach._fingerprint(_FakeCG("knowledge/b.md"))
233
- ok(fp_a != fp_b, "(7) 指纹含 path(路径变更即判不新鲜)", "%s vs %s" % (fp_a[:8], fp_b[:8]))
234
- # r7 复核:仅改 edges 也必须判不新鲜(否则 MDCG_REACH_DIFFUSE=1 时扩散复用旧邻接表)
235
- class _FakeCG2:
236
- def __init__(self, edges):
237
- self.root = root
238
- self.index = {"nodes": {"n1": {"path": "knowledge/a.md",
239
- "content_hash": "H1", "edges": edges}}}
240
- e0 = _FakeCG2([])
241
- e1 = _FakeCG2([{"target": "knowledge/b.md", "type": "similar"}])
242
- ok(reach._fingerprint(e0) != reach._fingerprint(e1),
243
- "(7) 指纹含 edges(仅改边即判不新鲜)")
244
- ok(reach._node_key(e0.index["nodes"]["n1"]) != reach._node_key(e1.index["nodes"]["n1"]),
245
- "(7) 新鲜度键含 edges 签名")
246
- # r9 复核:tags 变更也必须判不新鲜(倒排含标签 bigram)
247
- class _FakeCG3:
248
- def __init__(self, tags):
249
- self.root = root
250
- self.index = {"nodes": {"n1": {"path": "knowledge/a.md",
251
- "content_hash": "H1", "tags": tags, "edges": []}}}
252
-
253
- ok(reach._node_key(_FakeCG3(["x"]).index["nodes"]["n1"])
254
- != reach._node_key(_FakeCG3(["y"]).index["nodes"]["n1"]),
255
- "(7) 新鲜度键含 tags(仅改标签即判不新鲜)")
256
- # r10 复核:真实 cg.add 后的索引条目必须带 tags(否则 tags 新鲜度不可用)
257
- cg.add("tag_probe", "# 功能名:标签探针\n# 生效条件:条件 T\n\n标签探针正文。\n",
258
- layer="knowledge", tags=["alpha"])
259
- cg.flush()
260
- ent = cg.index["nodes"].get("tag_probe")
261
- ok(bool(ent) and "alpha" in (ent.get("tags") or []),
262
- "(7) 真实索引含 tags(新鲜度键可依赖)", str((ent or {}).get("tags"))[:60])
263
- import copy as _copy
264
- e_mod = _copy.deepcopy(ent or {})
265
- e_mod["tags"] = ["beta"]
266
- ok(reach._node_key(ent or {}) != reach._node_key(e_mod),
267
- "(7) 真实条目改标签即改新鲜度键")
268
- # r10 复核:hash_complete 必须看原始 content_hash(缺则判不完整 → 不复用)
269
- class _FakeCG4:
270
- def __init__(self, with_hash):
271
- self.root = root
272
- n = {"path": "knowledge/a.md", "tags": [], "edges": []}
273
- if with_hash:
274
- n["content_hash"] = "H1"
275
- self.index = {"nodes": {"n1": n}}
276
- def _read(self, e):
277
- return {}, ""
278
- def _open_content(self, node_id, fm, content):
279
- return content
280
- idx_fresh = reach.ReachIndex(root)
281
- idx_fresh.build(_FakeCG4(True))
282
- idx_miss = reach.ReachIndex(root)
283
- idx_miss.build(_FakeCG4(False))
284
- ok(idx_fresh.hash_complete is True and idx_miss.hash_complete is False,
285
- "(7) hash_complete 按原始 content_hash 判定",
286
- "fresh=%s miss=%s" % (idx_fresh.hash_complete, idx_miss.hash_complete))
287
- # ---------------- (7) 落盘/新鲜度/首建成本 ----------------
288
- print(chr(10) + "(7) 落盘分隔符 / 新鲜度 / 首建成本")
289
- cg.add("comma,node", f"# 功能名:含逗号\n# 生效条件:条件 C\n\n{BODY} 逗号\n",
290
- layer="knowledge")
291
- cg.flush()
292
- saved = reach._index(cg)
293
- saved.save()
294
- reloaded = reach.ReachIndex(root); reloaded.load()
295
- pth = [e["path"] for e in cg._candidates() if e["path"].endswith("comma,node.md")]
296
- ok(bool(pth) and pth[0] in reloaded.post.get("召回", []) + reloaded.post.get("召", []),
297
- "(7) 含逗号路径经落盘/重载仍在倒排中(_SEP 而非逗号)", f"path={pth}")
298
- fake_cg = type("X", (), {"index": {"nodes": {"n1": {"path": "knowledge/n1.md"}}}})()
299
- ok(reach._disk_fresh(saved, fake_cg) is False,
300
- "(7) content_hash 缺失 → 判不新鲜(触发重建)")
301
- os.environ["MDCG_REACH_TTL"] = "1"
302
- d = json.load(open(saved.path, encoding="utf-8"))
303
- d["built_at"] = time.time() - 30 # 让**磁盘缓存**过期(改内存对象无效)
304
- json.dump(d, open(saved.path, "w", encoding="utf-8"))
305
- reach._CACHE.clear()
306
- again = reach._index(cg)
307
- ok(getattr(again, "built_now", False) is True,
308
- "(7) 磁盘缓存超 TTL → 重建")
309
- os.environ["MDCG_REACH_TTL"] = "0"
310
- # ---------------- (8) 新节点并入(陈旧索引不漏召回) ----------------
311
- # 复用缓存时不得残留上一轮的首建标记
312
- again.built_now = True
313
- reach._CACHE[again.path] = (again, reach._fingerprint(cg))
314
- _, m_reuse = reach.narrow(cg, cg._candidates(), terms, qb, None, q=QUERY)
315
- ok("reach_build_docs" not in m_reuse, "(7) 复用缓存时不残留首建标记")
316
-
317
- # 未索引节点并入(path 不在 idx.hashes)
318
- cg.add("unindexed_node", "# 功能名:未索引\n# 生效条件:条件 U\n\n与查询无关。\n",
319
- layer="knowledge")
320
- cg.flush()
321
- reach._CACHE.clear()
322
- stale2 = reach.ReachIndex(root); stale2.load()
323
- ok(not any(p.endswith("unindexed_node.md") for p in stale2.hashes),
324
- "(8b) 前置:磁盘缓存里确无该节点")
325
- reach._CACHE[stale2.path] = (stale2, reach._fingerprint(cg))
326
- got3, meta3 = reach.narrow(cg, cg._candidates(), terms, qb, None, q=QUERY)
327
- # r8 复核:未索引节点超过上限时必须整段回退(不得静默截断后仍提前返回)
328
- saved_max = reach._FRESH_MAX
329
- reach._FRESH_MAX = 1
330
- cg.add("unindexed2", "# 功能名:未索引2\n# 生效条件:条件 U2\n\n与查询无关。\n", layer="knowledge")
331
- cg.flush()
332
- reach._CACHE.clear()
333
- st3 = reach.ReachIndex(root); st3.load()
334
- reach._CACHE[st3.path] = (st3, reach._fingerprint(cg))
335
- got4, meta4 = reach.narrow(cg, cg._candidates(), terms, qb, None, q=QUERY)
336
- reach._FRESH_MAX = saved_max
337
- ok(got4 is None and meta4.get("reach") == "fresh_overflow",
338
- "(8c) 未索引节点超过上限 → 整段回退(不静默截断)", str(meta4)[:80])
339
-
340
- # r8 复核:进程内缓存 TTL 过期也要重建(不清 _CACHE,改内存实例的 built_at)
341
- os.environ["MDCG_REACH_TTL"] = "1"
342
- live = reach._index(cg)
343
- live.built_at = time.time() - 30
344
- try:
345
- d2 = json.load(open(live.path, encoding="utf-8"))
346
- d2["built_at"] = time.time() - 30 # 磁盘缓存也过期 → 必须真重建
347
- json.dump(d2, open(live.path, "w", encoding="utf-8"))
348
- except OSError:
349
- pass
350
- got5, meta5 = reach.narrow(cg, cg._candidates(), terms, qb, None, q=QUERY)
351
- os.environ["MDCG_REACH_TTL"] = "0"
352
- ok(meta5.get("reach_build_docs") is not None,
353
- "(8d) 内存+磁盘缓存均超 TTL → 真重建(以 reach_build_docs 出现为准)", str(meta5)[:110])
354
- ok(meta3.get("reach_fresh_nodes", 0) >= 1,
355
- "(8b) 未索引节点被并入候选", f"fresh={meta3.get('reach_fresh_nodes')}")
356
- print(chr(10) + "(8) 新节点并入")
357
- cg.add("late_node", "# 功能名:后写节点\n# 生效条件:条件 L\n\n与查询无关的后写正文。\n",
358
- layer="knowledge")
359
- cg.flush()
360
- _env(True)
361
- # 强制「指纹比对通过但缓存里没有后写节点」的陈旧场景,验证并入机制
362
- stale = reach.ReachIndex(root); stale.load()
363
- reach._CACHE[stale.path] = (stale, reach._fingerprint(cg))
364
- got2, meta2 = reach.narrow(cg, cg._candidates(), terms, qb, None, q=QUERY)
365
- ids2 = {e["path"].split("/")[-1][:-3] for e in (got2 or [])}
366
- ok("late_node" in ids2 or meta2.get("reach_fresh_nodes", 0) > 0,
367
- "(8) 索引建成后写入的节点被并入候选", f"fresh={meta2.get('reach_fresh_nodes')}")
368
- print(f"\n===== reach 验收:{PASS}/{PASS + FAIL} 通过 =====")
369
- if FAILS:
370
- print("失败项:" + ";".join(FAILS))
371
- return 0 if FAIL == 0 else 1
372
- finally:
373
- _env(True)
374
- return 0
375
-
376
-
377
- if __name__ == "__main__":
378
- raise SystemExit(main())
1
+ # -*- coding: utf-8 -*-
2
+ """test_reach.py · 检索候选收敛层(reach)验收。
3
+
4
+ 覆盖(对应 A2/A3 判据的可证形式):
5
+ (1) 包含性:收敛集 ⊇ 全量 LIKE 命中集,且 ⊇ 词法打分>0 集合(A2「不丢召回」的可证形式)
6
+ (2) 条件门控:收敛集 ⊆ 调用方候选集(层/角色/会话/分支由 _candidates 承载);不可读节点不越权
7
+ (3) 图扩散:edges 邻居被吸收补召回;扩散受 DIFFUSE_MAX_FACTOR 上限约束
8
+ (4) 回退:MDCG_REACH=0 / 单字符 term / 索引不可用 → 不收敛(返回 None),旧行为不变
9
+ (5) 端到端:search 开关两态结果集为包含关系、meta 带 reach*、scanned 下降
10
+ (6) 缓存失效:新增节点后重建,新节点可被收敛召回(防陈旧缓存丢召回)
11
+
12
+ 运行:python -m md_cg.test_reach
13
+ """
14
+ from __future__ import annotations
15
+
16
+ import contextlib
17
+ import io
18
+ import json
19
+ import os
20
+ import sys
21
+ import tempfile
22
+ import time
23
+
24
+ from .mdcos import MdCGOS
25
+ from .mdcg import bigrams, expand_query_terms, normalize_en
26
+ from . import reach
27
+
28
+ PASS = FAIL = 0
29
+ FAILS = []
30
+
31
+
32
+ def ok(cond, label, detail=""):
33
+ global PASS, FAIL
34
+ if cond:
35
+ PASS += 1
36
+ print(f" [PASS] {label}" + (f" · {detail}" if detail else ""))
37
+ else:
38
+ FAIL += 1
39
+ FAILS.append(label)
40
+ print(f" [FAIL] {label}" + (f" · {detail}" if detail else ""))
41
+
42
+
43
+ QUERY = "召回截断 分池"
44
+ BODY = "召回截断 索引 分池 内容"
45
+
46
+
47
+ def _mk(root):
48
+ cg = MdCGOS(root, actor="test_reach")
49
+ for i in range(3):
50
+ cg.add(f"code_{i}", f"# 功能名:索引条目 {i}\n# 生效条件:条件 I\n\n{BODY} {i}\n",
51
+ layer="knowledge", tags=["index"])
52
+ for i in range(3):
53
+ cg.add(f"kp_{i}", f"# 功能名:知识 {i}\n# 生效条件:条件 K\n\n召回截断 索引 内容 {i}\n",
54
+ layer="knowledge")
55
+ cg.add("other_1", "# 功能名:无关\n# 生效条件:条件 O\n\n完全无关的另一段文本。\n",
56
+ layer="knowledge")
57
+ # 组扩散:other_2 不含查询词,但被 code_0 通过 edges 指向(图扩散应把它补进收敛集)
58
+ cg.add("other_2", "# 功能名:邻居\n# 生效条件:条件 N\n\n也不含查询词的邻居正文。\n",
59
+ layer="knowledge")
60
+ cg.add("code_0b", f"# 功能名:索引条目 0b\n# 生效条件:条件 I\n\n{BODY} 0b\n",
61
+ layer="knowledge", edges=[{"target": "other_2", "type": "similar", "confidence": 0.9}])
62
+ cg.add("n_rej", f"# 功能名:被否决\n# 生效条件:条件 R\n\n{BODY} 否\n", layer="rejected")
63
+ cg.flush()
64
+ return cg
65
+
66
+
67
+ def _env(on):
68
+ os.environ["MDCG_REACH"] = "1" if on else "0"
69
+ reach._CACHE.clear()
70
+
71
+
72
+ def _search_both(cg, query, k, on):
73
+ """在指定开关下跑一次 search(供两态对比)。"""
74
+ _env(on)
75
+ if on:
76
+ reach._CACHE.clear()
77
+ return cg.search(query, k=k)
78
+
79
+
80
+ def _like_ids(cg, entries, terms):
81
+ stat = {"scanned": 0}
82
+ docs = cg._read_many(entries, stat)
83
+ return {e["path"] for e, fm, c in docs if cg._like(c, fm, terms)}, docs
84
+
85
+
86
+ def main():
87
+ print("md_cg 收敛层 reach 验收 · 大域收敛 / 条件门控 / 图扩散 / 回退")
88
+ print("=" * 70)
89
+ root = tempfile.mkdtemp(prefix="mdcg_reach_")
90
+ try:
91
+ os.environ["MDCG_REACH_INDEX"] = os.path.join(root, "_idx_measure.json")
92
+ cg = _mk(root)
93
+ entries = cg._candidates()
94
+ terms = expand_query_terms(QUERY)
95
+ qb = bigrams(normalize_en(QUERY))
96
+
97
+ # ---------------- (1) 包含性 ----------------
98
+ print("\n(1) 大域收敛包含性(A2 可证形式)")
99
+ _env(True)
100
+ full_like, docs = _like_ids(cg, entries, terms)
101
+ narrow, meta = reach.narrow(cg, entries, terms, qb, None, q=QUERY)
102
+ nset = {e["path"] for e in (narrow or [])}
103
+ ok(full_like and full_like <= nset,
104
+ "(1) 收敛集 ⊇ 全量 LIKE 命中集", f"like={len(full_like)} narrow={len(nset)} miss={len(full_like - nset)}")
105
+ scored = cg._score(docs, QUERY, qb, None)
106
+ pos = {d[0]["path"] for d in scored if d[1] > 0}
107
+ ok(pos <= nset, "(1) 收敛集 ⊇ 词法打分>0 集合",
108
+ f"score>0={len(pos)} miss={len(pos - nset)}")
109
+ ok(meta.get("reach") == "converged" and meta.get("reach_seed", 0) > 0,
110
+ "(1) meta 如实报收敛状态", str(meta))
111
+
112
+ # ---------------- (2) 条件门控 ----------------
113
+ print("\n(2) 条件门控(收敛集 ⊆ 候选集)")
114
+ epaths = {e["path"] for e in entries}
115
+ ok(nset <= epaths, "(2) 收敛集不越出调用方候选集")
116
+ ok(all(e.get("layer") != "rejected" for e in narrow), "(2) 负记忆层不因收敛回流")
117
+
118
+ # ---------------- (3) 图扩散 ----------------
119
+ print("\n(3) 图扩散")
120
+ idx = reach._index(cg)
121
+ ids = {e["path"].split("/")[-1][:-3] for e in narrow}
122
+ os.environ["MDCG_REACH_DIFFUSE"] = "1" # 扩散默认关(保 A2 精确),此处置开验证能力
123
+ narrow_d, meta_d = reach.narrow(cg, entries, terms, qb, None, q=QUERY)
124
+ os.environ["MDCG_REACH_DIFFUSE"] = "0"
125
+ ids_d = {e["path"].split("/")[-1][:-3] for e in (narrow_d or [])}
126
+ ok("other_2" in ids_d and meta_d.get("reach_diffused") == 1,
127
+ "(3) 扩散开关开启时 edges 邻居被吸收",
128
+ f"other_2 in narrow_d={'other_2' in ids_d} diffused={meta_d.get('reach_diffused')} (默认关时 ids={len(ids)})")
129
+ fake = reach.ReachIndex(root)
130
+ fake.adj = {"a": ["b", "c"], "b": ["d"], "d": ["e"]}
131
+ one = fake.diffuse({"a"}, hops=1)
132
+ two = fake.diffuse({"a"}, hops=2)
133
+ ok(one == {"a", "b", "c"}, "(3) 1 跳邻居集合正确", str(sorted(one)))
134
+ ok(two >= {"a", "b", "c", "d"}, "(3) 2 跳可达", str(sorted(two)))
135
+ big = {"s0"}
136
+ fake.adj = {"s0": [f"n{i}" for i in range(100)]}
137
+ lim = fake.diffuse({"s0"}, hops=1, limit=3)
138
+ ok(len(lim) <= 3, "(3) 扩散受上限约束", f"|out|={len(lim)}")
139
+
140
+ # ---------------- (4) 回退 ----------------
141
+ print("\n(4) 回退(不适用条件 → 不收敛)")
142
+ _env(False)
143
+ got, meta = reach.narrow(cg, entries, terms, qb, None, q=QUERY)
144
+ ok(got is None and meta.get("reach") == "off", "(4) MDCG_REACH=0 → 不收敛", str(meta))
145
+ _env(True)
146
+ got, meta = reach.narrow(cg, entries, ["白"], bigrams("白"), None, q="白")
147
+ ok(got is None and meta.get("reach") == "short_term", "(4) 单字符 term → 不收敛", str(meta))
148
+ saved = reach._index
149
+ reach._index = lambda *a, **k: None
150
+ try:
151
+ got, meta = reach.narrow(cg, entries, terms, qb, None, q=QUERY)
152
+ ok(got is None and meta.get("reach") == "index_unavailable",
153
+ "(4) 索引不可用 → 不收敛", str(meta))
154
+ finally:
155
+ reach._index = saved
156
+
157
+ # ---------------- (5) 端到端 ----------------
158
+ print("\n(5) 端到端(search 两态)")
159
+ _env(False)
160
+ res_off, m_off = cg.search(QUERY, k=10)
161
+ off_ids = [r[0]["id"] for r in res_off]
162
+ _env(True)
163
+ reach._CACHE.clear()
164
+ res_on, m_on = cg.search(QUERY, k=10)
165
+ on_ids = [r[0]["id"] for r in res_on]
166
+ ok(set(on_ids) >= set(off_ids), "(5) 开态结果集 ⊇ 关态(不丢召回)",
167
+ f"off={off_ids[:3]} on={on_ids[:3]}")
168
+ ok(m_on.get("reach") == "converged" and m_on.get("reach_seed"),
169
+ "(5) meta 透出 reach* 审计字段", f"reach={m_on.get('reach')} seed={m_on.get('reach_seed')}")
170
+ ok(m_on.get("scanned", 0) <= m_off.get("scanned", 0),
171
+ "(5) 开态读盘数不增(收敛生效)",
172
+ f"off={m_off.get('scanned')} on={m_on.get('scanned')}")
173
+ ok(m_on.get("pre_cap", 0) >= m_off.get("pre_cap", 0),
174
+ "(5) 截断前候选数不少于关态(图扩散可补召回)",
175
+ f"off={m_off.get('pre_cap')} on={m_on.get('pre_cap')}")
176
+ # 图扩散必须真的落到**结果层**(T3-r3 复核:只并入收敛集、随后被 _like 过滤掉等于没做)
177
+ os.environ["MDCG_REACH_DIFFUSE"] = "1" # 结果层放行扩散节点需显式开关
178
+ res_big_off, _ = _search_both(cg, QUERY, 50, False)
179
+ res_big_on, _ = _search_both(cg, QUERY, 50, True)
180
+ os.environ["MDCG_REACH_DIFFUSE"] = "0"
181
+ ids_on = {r[0]["id"] for r in res_big_on}
182
+ ids_off = {r[0]["id"] for r in res_big_off}
183
+ ok("other_2" in ids_on and "other_2" not in ids_off,
184
+ "(5) 图扩散邻居进入 search 结果(补召回落地)",
185
+ f"other_2 on={'other_2' in ids_on} off={'other_2' in ids_off}")
186
+
187
+ # r14 复核:收敛集非空但 LIKE 命中为空 → 回退全量,且 meta.reach 必须改写为 reverted(不得谎报 converged)
188
+ _env(True)
189
+ _saved_like = cg._like
190
+ cg._like = staticmethod(lambda *a, **k: False) # 模拟「bigram 有交集但无 LIKE 命中」
191
+ try:
192
+ res_rv, m_rv = cg.search(QUERY, k=5)
193
+ finally:
194
+ cg._like = _saved_like
195
+ ok(m_rv.get("reach") == "reverted",
196
+ "(5b) 回退全量时 reach 改写为 reverted(不谎报 converged)", str(m_rv.get("reach")))
197
+ ok(bool(res_rv), "(5b) 回退后仍能出结果(全量路径)", f"n={len(res_rv)}")
198
+ ok(m_rv.get("reach_reverted") is True, "(5b) 回退标记 reach_reverted=True")
199
+ ok(isinstance(m_rv.get("reach_reverted_docs"), int) and m_rv["reach_reverted_docs"] >= 0,
200
+ "(5b) 回退时暴露收敛阶段读盘量(A3 可扣减)", f"docs={m_rv.get('reach_reverted_docs')}")
201
+ # 让该次调用确实发生重建:清缓存并把磁盘缓存改旧,再令 _like 恒假 → 回退且首建成本必须保留
202
+ reach._CACHE.clear()
203
+ live2 = reach._index(cg)
204
+ live2.built_at = time.time() - 4000
205
+ try:
206
+ d4 = json.load(open(live2.path, encoding="utf-8"))
207
+ d4["built_at"] = time.time() - 4000
208
+ json.dump(d4, open(live2.path, "w", encoding="utf-8"))
209
+ except OSError:
210
+ pass
211
+ cg._like = staticmethod(lambda *a, **k: False)
212
+ try:
213
+ res_rv2, m_rv2 = cg.search(QUERY, k=5)
214
+ finally:
215
+ cg._like = _saved_like
216
+ ok(m_rv2.get("reach") == "reverted" and m_rv2.get("reach_build_docs") is not None,
217
+ "(5b) 回退时若发生重建,首建成本字段必须保留",
218
+ f"reach={m_rv2.get('reach')} build={m_rv2.get('reach_build_docs')}")
219
+
220
+ # ---------------- (6) 缓存失效 ----------------
221
+ print("\n(6) 缓存失效(新增节点后仍可召回)")
222
+ cg.add("code_new", f"# 功能名:新增索引条目\n# 生效条件:条件 I\n\n{BODY} new\n",
223
+ layer="knowledge", tags=["index"])
224
+ cg.flush()
225
+ res2, m2 = cg.search(QUERY, k=20)
226
+ ok(any(r[0]["id"] == "code_new" for r in res2),
227
+ "(6) 新增节点进入收敛集(指纹失效触发重建)",
228
+ f"reach={m2.get('reach')} ids={[r[0]['id'] for r in res2][:4]}")
229
+ # 指纹必须含 path(r6 复核:路径交换/重命名而 content_hash 未变时不得复用缓存)
230
+ class _FakeCG:
231
+ def __init__(self, path):
232
+ self.root = root
233
+ self.index = {"nodes": {"n1": {"path": path, "content_hash": "H1"}}}
234
+ fp_a = reach._fingerprint(_FakeCG("knowledge/a.md"))
235
+ fp_b = reach._fingerprint(_FakeCG("knowledge/b.md"))
236
+ ok(fp_a != fp_b, "(7) 指纹含 path(路径变更即判不新鲜)", "%s vs %s" % (fp_a[:8], fp_b[:8]))
237
+ # r7 复核:仅改 edges 也必须判不新鲜(否则 MDCG_REACH_DIFFUSE=1 时扩散复用旧邻接表)
238
+ class _FakeCG2:
239
+ def __init__(self, edges):
240
+ self.root = root
241
+ self.index = {"nodes": {"n1": {"path": "knowledge/a.md",
242
+ "content_hash": "H1", "edges": edges}}}
243
+ e0 = _FakeCG2([])
244
+ e1 = _FakeCG2([{"target": "knowledge/b.md", "type": "similar"}])
245
+ ok(reach._fingerprint(e0) != reach._fingerprint(e1),
246
+ "(7) 指纹含 edges(仅改边即判不新鲜)")
247
+ ok(reach._node_key(e0.index["nodes"]["n1"]) != reach._node_key(e1.index["nodes"]["n1"]),
248
+ "(7) 新鲜度键含 edges 签名")
249
+ # r9 复核:tags 变更也必须判不新鲜(倒排含标签 bigram)
250
+ class _FakeCG3:
251
+ def __init__(self, tags):
252
+ self.root = root
253
+ self.index = {"nodes": {"n1": {"path": "knowledge/a.md",
254
+ "content_hash": "H1", "tags": tags, "edges": []}}}
255
+
256
+ ok(reach._node_key(_FakeCG3(["x"]).index["nodes"]["n1"])
257
+ != reach._node_key(_FakeCG3(["y"]).index["nodes"]["n1"]),
258
+ "(7) 新鲜度键含 tags(仅改标签即判不新鲜)")
259
+ # r10 复核:真实 cg.add 后的索引条目必须带 tags(否则 tags 新鲜度不可用)
260
+ cg.add("tag_probe", "# 功能名:标签探针\n# 生效条件:条件 T\n\n标签探针正文。\n",
261
+ layer="knowledge", tags=["alpha"])
262
+ cg.flush()
263
+ ent = cg.index["nodes"].get("tag_probe")
264
+ ok(bool(ent) and "alpha" in (ent.get("tags") or []),
265
+ "(7) 真实索引含 tags(新鲜度键可依赖)", str((ent or {}).get("tags"))[:60])
266
+ import copy as _copy
267
+ e_mod = _copy.deepcopy(ent or {})
268
+ e_mod["tags"] = ["beta"]
269
+ ok(reach._node_key(ent or {}) != reach._node_key(e_mod),
270
+ "(7) 真实条目改标签即改新鲜度键")
271
+ # r10 复核:hash_complete 必须看原始 content_hash(缺则判不完整 → 不复用)
272
+ class _FakeCG4:
273
+ def __init__(self, with_hash):
274
+ self.root = root
275
+ n = {"path": "knowledge/a.md", "tags": [], "edges": []}
276
+ if with_hash:
277
+ n["content_hash"] = "H1"
278
+ self.index = {"nodes": {"n1": n}}
279
+ def _read(self, e):
280
+ return {}, ""
281
+ def _open_content(self, node_id, fm, content):
282
+ return content
283
+ idx_fresh = reach.ReachIndex(root)
284
+ idx_fresh.build(_FakeCG4(True))
285
+ idx_miss = reach.ReachIndex(root)
286
+ idx_miss.build(_FakeCG4(False))
287
+ ok(idx_fresh.hash_complete is True and idx_miss.hash_complete is False,
288
+ "(7) hash_complete 按原始 content_hash 判定",
289
+ "fresh=%s miss=%s" % (idx_fresh.hash_complete, idx_miss.hash_complete))
290
+ # ---------------- (7) 落盘/新鲜度/首建成本 ----------------
291
+ print(chr(10) + "(7) 落盘分隔符 / 新鲜度 / 首建成本")
292
+ cg.add("comma,node", f"# 功能名:含逗号\n# 生效条件:条件 C\n\n{BODY} 逗号\n",
293
+ layer="knowledge")
294
+ cg.flush()
295
+ saved = reach._index(cg)
296
+ saved.save()
297
+ reloaded = reach.ReachIndex(root); reloaded.load()
298
+ pth = [e["path"] for e in cg._candidates() if e["path"].endswith("comma,node.md")]
299
+ ok(bool(pth) and pth[0] in reloaded.post.get("召回", []) + reloaded.post.get("召", []),
300
+ "(7) 含逗号路径经落盘/重载仍在倒排中(_SEP 而非逗号)", f"path={pth}")
301
+ fake_cg = type("X", (), {"index": {"nodes": {"n1": {"path": "knowledge/n1.md"}}}})()
302
+ ok(reach._disk_fresh(saved, fake_cg) is False,
303
+ "(7) content_hash 缺失 → 判不新鲜(触发重建)")
304
+ os.environ["MDCG_REACH_TTL"] = "1"
305
+ d = json.load(open(saved.path, encoding="utf-8"))
306
+ d["built_at"] = time.time() - 30 # 让**磁盘缓存**过期(改内存对象无效)
307
+ json.dump(d, open(saved.path, "w", encoding="utf-8"))
308
+ reach._CACHE.clear()
309
+ again = reach._index(cg)
310
+ ok(getattr(again, "built_now", False) is True,
311
+ "(7) 磁盘缓存超 TTL → 重建")
312
+ os.environ["MDCG_REACH_TTL"] = "0"
313
+ # ---------------- (8) 新节点并入(陈旧索引不漏召回) ----------------
314
+ # 复用缓存时不得残留上一轮的首建标记
315
+ again.built_now = True
316
+ reach._CACHE[again.path] = (again, reach._fingerprint(cg))
317
+ _, m_reuse = reach.narrow(cg, cg._candidates(), terms, qb, None, q=QUERY)
318
+ ok("reach_build_docs" not in m_reuse, "(7) 复用缓存时不残留首建标记")
319
+
320
+ # 未索引节点并入(path 不在 idx.hashes)
321
+ cg.add("unindexed_node", "# 功能名:未索引\n# 生效条件:条件 U\n\n与查询无关。\n",
322
+ layer="knowledge")
323
+ cg.flush()
324
+ reach._CACHE.clear()
325
+ stale2 = reach.ReachIndex(root); stale2.load()
326
+ ok(not any(p.endswith("unindexed_node.md") for p in stale2.hashes),
327
+ "(8b) 前置:磁盘缓存里确无该节点")
328
+ reach._CACHE[stale2.path] = (stale2, reach._fingerprint(cg))
329
+ got3, meta3 = reach.narrow(cg, cg._candidates(), terms, qb, None, q=QUERY)
330
+ # r8 复核:未索引节点超过上限时必须整段回退(不得静默截断后仍提前返回)
331
+ saved_max = reach._FRESH_MAX
332
+ reach._FRESH_MAX = 1
333
+ cg.add("unindexed2", "# 功能名:未索引2\n# 生效条件:条件 U2\n\n与查询无关。\n", layer="knowledge")
334
+ cg.flush()
335
+ reach._CACHE.clear()
336
+ st3 = reach.ReachIndex(root); st3.load()
337
+ reach._CACHE[st3.path] = (st3, reach._fingerprint(cg))
338
+ got4, meta4 = reach.narrow(cg, cg._candidates(), terms, qb, None, q=QUERY)
339
+ reach._FRESH_MAX = saved_max
340
+ ok(got4 is None and meta4.get("reach") == "fresh_overflow",
341
+ "(8c) 未索引节点超过上限 → 整段回退(不静默截断)", str(meta4)[:80])
342
+
343
+ # r8 复核:进程内缓存 TTL 过期也要重建(不清 _CACHE,改内存实例的 built_at)
344
+ os.environ["MDCG_REACH_TTL"] = "1"
345
+ live = reach._index(cg)
346
+ live.built_at = time.time() - 30
347
+ try:
348
+ d2 = json.load(open(live.path, encoding="utf-8"))
349
+ d2["built_at"] = time.time() - 30 # 磁盘缓存也过期 → 必须真重建
350
+ json.dump(d2, open(live.path, "w", encoding="utf-8"))
351
+ except OSError:
352
+ pass
353
+ got5, meta5 = reach.narrow(cg, cg._candidates(), terms, qb, None, q=QUERY)
354
+ os.environ["MDCG_REACH_TTL"] = "0"
355
+ ok(meta5.get("reach_build_docs") is not None,
356
+ "(8d) 内存+磁盘缓存均超 TTL → 真重建(以 reach_build_docs 出现为准)", str(meta5)[:110])
357
+ ok(meta3.get("reach_fresh_nodes", 0) >= 1,
358
+ "(8b) 未索引节点被并入候选", f"fresh={meta3.get('reach_fresh_nodes')}")
359
+ print(chr(10) + "(8) 新节点并入")
360
+ cg.add("late_node", "# 功能名:后写节点\n# 生效条件:条件 L\n\n与查询无关的后写正文。\n",
361
+ layer="knowledge")
362
+ cg.flush()
363
+ _env(True)
364
+ # 强制「指纹比对通过但缓存里没有后写节点」的陈旧场景,验证并入机制
365
+ stale = reach.ReachIndex(root); stale.load()
366
+ reach._CACHE[stale.path] = (stale, reach._fingerprint(cg))
367
+ got2, meta2 = reach.narrow(cg, cg._candidates(), terms, qb, None, q=QUERY)
368
+ ids2 = {e["path"].split("/")[-1][:-3] for e in (got2 or [])}
369
+ ok("late_node" in ids2 or meta2.get("reach_fresh_nodes", 0) > 0,
370
+ "(8) 索引建成后写入的节点被并入候选", f"fresh={meta2.get('reach_fresh_nodes')}")
371
+ print(f"\n===== reach 验收:{PASS}/{PASS + FAIL} 通过 =====")
372
+ if FAILS:
373
+ print("失败项:" + ";".join(FAILS))
374
+ return 0 if FAIL == 0 else 1
375
+ finally:
376
+ _env(True)
377
+ return 0
378
+
379
+
380
+ # ---------------------------------------------- 定点变异(反面探针,自证判别力)
381
+ # 本组钉的「图扩散邻居进结果」是 reach 补召回**唯一的结果层出口**(`mdcg.search` 的
382
+ # reach 分支 `or d[0].get("path") in _dif` 显式放行的 0 分行)。#89② 把主结果裁到
383
+ # `_n_real`(真命中数)时它会被裁掉——故下面注入**旧口径**(`min(_primary_slots,
384
+ # _n_real)`)应使 (5) 那条断言转红并点名。范式照 `md_cg/test_w7_redlines.py`:
385
+ # python -X utf8 -m md_cg.test_reach --mutate old-cut
386
+ def _set_primary_bound(fn):
387
+ """把 `MdCG._primary_bound` 换成 fn(纯内存),返回恢复函数(`__dict__` 快照还原)。"""
388
+ from .mdcg import MdCG
389
+ orig = MdCG.__dict__["_primary_bound"]
390
+ MdCG._primary_bound = fn
391
+
392
+ def _restore():
393
+ MdCG._primary_bound = orig
394
+ return _restore
395
+
396
+
397
+ _MUTATIONS = {
398
+ # 名字 → (说明, 应用函数→恢复函数, 期望转红的断言标签集合)
399
+ "old-cut": (
400
+ "主结果裁到真命中数(c82e4255 旧口径 min(_primary_slots, _n_real))",
401
+ lambda: _set_primary_bound(
402
+ lambda self, k, n_neg, tier, n_real:
403
+ min(self._primary_slots(k, n_neg), n_real)),
404
+ {"(5) 图扩散邻居进入 search 结果(补召回落地)"}),
405
+ }
406
+
407
+
408
+ def _reds():
409
+ """跑一遍 main()(新建 temp 语料,幂等);返回 (转红断言标签集合, 异常名或 None)。"""
410
+ global PASS, FAIL
411
+ PASS = FAIL = 0
412
+ del FAILS[:]
413
+ with contextlib.redirect_stdout(io.StringIO()):
414
+ try:
415
+ main()
416
+ except Exception as exc: # noqa: BLE001
417
+ return set(), type(exc).__name__
418
+ return set(FAILS), None
419
+
420
+
421
+ def _mutate(name):
422
+ if name not in _MUTATIONS:
423
+ print(f"未知变异名 {name!r}(可选 {sorted(_MUTATIONS)})")
424
+ return 1
425
+ mname, apply, expect = _MUTATIONS[name]
426
+ print("!! reach 定点变异自证:内存注入退化,要求**恰好**命中期望红项\n")
427
+ bad = []
428
+ base_red, base_exc = _reds()
429
+ if base_exc:
430
+ bad.append("基线异常:%s" % base_exc)
431
+ if base_red:
432
+ bad.append("基线即转红:%s" % sorted(base_red))
433
+ print(" 未变异基线:红项 %d %s" % (len(base_red), sorted(base_red)))
434
+ restore = apply()
435
+ try:
436
+ red, exc = _reds()
437
+ finally:
438
+ restore()
439
+ if exc:
440
+ red = {"<变异体异常:%s>" % exc}
441
+ hit = red == expect
442
+ if not hit:
443
+ bad.append("变异 %s:红项 %s ≠ 期望 %s" % (name, sorted(red), sorted(expect)))
444
+ print(" 变异 {:<8} 红项 {}(期望 {}){}".format(
445
+ name, len(red), len(expect), "PASS" if hit else "**FAIL**"))
446
+ if not hit:
447
+ print(" 实=%s 期=%s" % (sorted(red), sorted(expect)))
448
+ print("\n变异自证:" + ("PASS(恰好命中期望红项)" if not bad else "FAIL —— " + ";".join(bad)))
449
+ return 0 if not bad else 1
450
+
451
+
452
+ if __name__ == "__main__":
453
+ if "--mutate" in sys.argv:
454
+ _i = sys.argv.index("--mutate")
455
+ raise SystemExit(_mutate(sys.argv[_i + 1] if _i + 1 < len(sys.argv) else ""))
456
+ raise SystemExit(main())