@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,433 +1,438 @@
1
- # -*- coding: utf-8 -*-
2
- """P3 遗留四条闭环守卫(A 融合口径披露 / B S3 不变量读数 / C 缺省路集分叉 / D ④部分满足)。
3
-
4
- 来源:设计稿 §5.4 / §6.2 / §6.3 与交接单「P3 遗留四条·必须在本批闭环」。
5
- 四条各缺一条即不得收口,故**每条一个断言组**:
6
-
7
- A **默认 recall 的融合口径由 sum 变 max**(`use_causal` 缺省 True)——
8
- A1 判据单点 `mcp_server.recall_fusion_default` 的取值断言(缺省态 == "max",
9
- 显式关因果 == None;`use_temporal` **不入判据**);
10
- A2 同一确定性库上「默认 vs 显式 sum」的 top-k 读数**逐条不同**(分数与名次);
11
- A3 默认调用点确实走该单点(源码断言:`fusion = a.get("fusion") or
12
- recall_fusion_default(...)`)。
13
- B **S3 不变量 ① 与 ⑥ 的读数缺口**——
14
- B1 ①「种子取自过 S1/S2 门控的命中」:因果路**种子** ⊆ 已过门控的候选面
15
- (`entries`),且因果路**输出** ⊆ 候选面(两条断言,实跑)。
16
- B2 ⑥「不走全表」实测不成立 ⇒ 如实降级声明:`chain.adjacency` **不读正文**
17
- (读盘调用计数 == 0),但邻接构建为 **O(N) 索引条目级**——给代价读数
18
- (N 条目的冷建耗时),并断言文档/注释里**不再**把「不走全表」当作
19
- 对 `adjacency` 成立的表述。
20
- C **Rust 侧缺省路集分叉**(如实披露,**不得**声称对拍通过)——
21
- Rust `EngineConfig::default{paths:None}` 字面量 == 四路;
22
- Python `search_rrf` 缺省 == 六路;两者**不相等**(分叉登记)。
23
- D **S3 ④ 只部分满足**——类型集可配(`MDCG_CHAIN_TYPES`)、权重沿用唯一表
24
- `EDGE_WEIGHTS`、方向固定为依赖方向(出边)——逐条断言,并断言措辞已改准。
25
-
26
- 运行:
27
- python -X utf8 -m md_cg.test_p3_legacy_closure
28
- python -X utf8 -m md_cg.test_p3_legacy_closure --mutate
29
- python -X utf8 -m md_cg.test_p3_legacy_closure --mutate --list
30
-
31
- 退出码:0 全绿;1 有失败 / 变异未按预期转红;2 ANCHOR-MISS。
32
- """
33
- from __future__ import annotations
34
-
35
- import inspect
36
- import os
37
- import re
38
- import statistics
39
- import sys
40
- import tempfile
41
- import time
42
-
43
- _TMP0 = tempfile.mkdtemp(prefix="p3_legacy_")
44
- os.environ["MDCG_AUX_ROOT"] = os.path.join(_TMP0, "auxroot")
45
- os.environ["MDCG_MASTER_KEY"] = "34" * 32
46
- os.environ["MDCG_TOKEN_FILE"] = os.path.join(_TMP0, "tokens.json")
47
- os.environ["MDCG_ROOT"] = os.path.join(_TMP0, "cgroot")
48
- for _k in ("MDCG_TOKEN", "MDCG_TENANT", "MDCG_CLEARANCE", "MDCG_SESSION",
49
- "MDCG_RETRIEVAL_PIPELINE", "MDCG_POOLING", "MDCG_FRESHNESS",
50
- "MDCG_CHAIN_TYPES"):
51
- os.environ.pop(_k, None)
52
-
53
- _HERE = os.path.dirname(os.path.abspath(__file__))
54
- _REPO = os.path.dirname(_HERE)
55
- sys.path.insert(0, _REPO)
56
-
57
- try:
58
- sys.stdout.reconfigure(encoding="utf-8", errors="replace")
59
- except AttributeError:
60
- pass
61
-
62
- from md_cg import chain # noqa: E402
63
- from md_cg import mcp_server as MS # noqa: E402
64
- from md_cg import mdcg as M # noqa: E402
65
- from md_cg import subgraph as SG # noqa: E402
66
- from md_cg.mdcos import MdCGOS # noqa: E402
67
-
68
- PASS = 0
69
- FAIL = 0
70
- FAILS = []
71
-
72
-
73
- def check(name, cond, detail=""):
74
- global PASS, FAIL
75
- if cond:
76
- PASS += 1
77
- print(f" OK {name}")
78
- else:
79
- FAIL += 1
80
- FAILS.append(name)
81
- print(f" FAIL {name} {detail}")
82
- return bool(cond)
83
-
84
-
85
- def _src(rel):
86
- with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
87
- return f.read()
88
-
89
-
90
- _CCG = ("# 功能名:{n}\n# 生效条件:无条件\n# 子功能:无\n# 执行:占位\n"
91
- "# 验证方式:compiler 复现\n# 不适用条件:其它会话\n\n{t}\n")
92
-
93
-
94
- def _fusion_lib():
95
- """受控库:两路共识 vs 单路更好名次——sum 与 max 的 top-k 序列在此分开。"""
96
- root = tempfile.mkdtemp(prefix="p3_fuse_")
97
- cg = MdCGOS(root)
98
- cg.add("m_aa", _CCG.format(n="m_aa", t="苹果 别的内容 章节 分离"),
99
- layer="knowledge", tags=["苹果"], importance=0.5)
100
- cg.add("m_zz", _CCG.format(n="m_zz", t="苹果 别的内容 章节 分离"),
101
- layer="knowledge", tags=["苹果"], importance=0.9)
102
- cg.add("m_lex", _CCG.format(n="m_lex", t="苹果章节 同构"),
103
- layer="knowledge", importance=0.5)
104
- cg.add("m_other", _CCG.format(n="m_other", t="苹果 别的内容 章节 分离 更多"),
105
- layer="knowledge", importance=0.5)
106
- cg.flush()
107
- return root, cg
108
-
109
-
110
- def _chain_lib(n_seed=3, n_other=6):
111
- root = tempfile.mkdtemp(prefix="p3_chain_")
112
- cg = MdCGOS(root)
113
- for i in range(n_seed):
114
- cg.add(f"s{i}", _CCG.format(n=f"s{i}", t="苹果 章节 种子"),
115
- layer="knowledge", importance=0.5,
116
- edges=[{"target": f"t{i}", "relation_type": "causal",
117
- "confidence": 0.9}])
118
- cg.add(f"t{i}", _CCG.format(n=f"t{i}", t="下游 结论"),
119
- layer="knowledge", importance=0.5)
120
- for i in range(n_other):
121
- cg.add(f"o{i}", _CCG.format(n=f"o{i}", t="无关 其它"),
122
- layer="knowledge", importance=0.5)
123
- # 负记忆层节点:**不在** `_candidates` 的候选面(NEG_ROUTE_LAYERS)——
124
- # 有它,不变量①「种子 ⊆ 已过门控的候选面」才有判别力
125
- cg.add("rj1", _CCG.format(n="rj1", t="苹果 章节 被否决的假设"),
126
- layer="rejected", importance=0.0)
127
- cg.flush()
128
- return root, cg
129
-
130
-
131
- def ga_fusion():
132
- print("== A 默认 recall 融合口径 sum→max(披露 + 判据 + 读数)==")
133
- check("A1 判据单点:缺省(use_causal=True)→ max",
134
- MS.recall_fusion_default(False, False, False, True) == "max",
135
- str(MS.recall_fusion_default(False, False, False, True)))
136
- check("A1 显式关因果且其余全关 → None(回到 search_rrf 的 sum 缺省)",
137
- MS.recall_fusion_default(False, False, False, False) is None)
138
- check("A1 use_temporal 不入判据(时间路是排名项,非单路独有召回型)",
139
- MS.recall_fusion_default(False, False, False, False, True) is None
140
- and MS.recall_fusion_default(False, False, False, True, True) == "max")
141
- src = _src(os.path.join("md_cg", "mcp_server.py"))
142
- check("A3 默认调用点走判据单点",
143
- "fusion = a.get(\"fusion\") or recall_fusion_default(" in src)
144
- check("A3 use_causal 缺省 True(披露的根因)",
145
- "use_causal = True if use_causal is None else bool(use_causal)" in src)
146
- root, cg = _fusion_lib()
147
- try:
148
- def top(**kw):
149
- pack = MS._dispatch(cg, "mdcg_recall",
150
- dict({"query": "苹果 章节", "k": 5}, **kw))
151
- return [[it.get("id"), it.get("score")]
152
- for it in (pack.get("pack") or [])]
153
- d = top()
154
- s = top(fusion="sum")
155
- mx = top(fusion="max")
156
- print(f" default={d}")
157
- print(f" sum ={s}")
158
- print(f" max ={mx}")
159
- check("A2 默认口径 == max(逐条相同)", d == mx, f"{d} vs {mx}")
160
- check("A2 默认口径 ≠ sum(逐条不同:分数或名次)", d != s, f"{d} vs {s}")
161
- check("A2 top-1 名次在 sum/max 下不同(口径差可观测)",
162
- bool(d) and bool(s) and d[0][0] != s[0][0],
163
- f"{d[:1]} vs {s[:1]}")
164
- finally:
165
- cg.close()
166
-
167
-
168
- def gb_s3_invariants():
169
- print("== B S3 不变量 ①⑥ 读数(种子 ⊆ 门控面 / 邻接代价)==")
170
- root, cg = _chain_lib()
171
- try:
172
- # ① 因果路种子 ⊆ 已过 S1/S2 门控的候选面(entries)
173
- seen = {}
174
- orig = chain.expand_from_seeds
175
-
176
- def spy(cg_, seeds, **kw):
177
- seen["seeds"] = list(seeds.items()) if isinstance(seeds, dict) \
178
- else list(seeds or [])
179
- return orig(cg_, seeds, **kw)
180
-
181
- chain.expand_from_seeds = spy
182
- try:
183
- res, meta = cg.search_rrf("苹果 章节", k=8, record=False,
184
- paths=("lexical", "chain"))
185
- finally:
186
- chain.expand_from_seeds = orig
187
- ent_ids = {e["path"].split("/")[-1][:-3] for e in cg._candidates()}
188
- seed_ids = {nid for nid, _s in (seen.get("seeds") or [])}
189
- check("① 因果路种子非空(夹具前提)", bool(seed_ids), str(seen))
190
- check("① 种子 ⊆ 已过门控的候选面(entries)",
191
- seed_ids <= ent_ids, f"{seed_ids - ent_ids}")
192
- out_ids = {r[0]["id"] for r in res}
193
- check("① 因果路输出 ⊆ 候选面(不得引入未过门控的节点)",
194
- out_ids <= ent_ids, f"{out_ids - ent_ids}")
195
- check("① 因果路确实产出(下游 t* 被召回)",
196
- any(i.startswith("t") for i in out_ids), str(sorted(out_ids)))
197
-
198
- # ⑥ 邻接:不读正文(读盘计数 == 0)+ O(N) 索引条目级代价读数
199
- calls = {"n": 0}
200
- orig_read, orig_get = M.MdCG._read, M.MdCG.get
201
-
202
- def rd(self, *a, **kw):
203
- calls["n"] += 1
204
- return orig_read(self, *a, **kw)
205
-
206
- def gt(self, *a, **kw):
207
- calls["n"] += 1
208
- return orig_get(self, *a, **kw)
209
-
210
- M.MdCG._read, M.MdCG.get = rd, gt
211
- try:
212
- cg._chain_adj = None
213
- adj = chain.adjacency(cg)
214
- finally:
215
- M.MdCG._read, M.MdCG.get = orig_read, orig_get
216
- check("⑥ 邻接构建不读正文/不读盘(读盘调用计数 == 0)",
217
- calls["n"] == 0, f"reads={calls['n']}")
218
- # 代价读数:N 条目冷建耗时(夹具 N=9;再取一个 400 条目的规模读)
219
- big = tempfile.mkdtemp(prefix="p3_adj_")
220
- cg2 = MdCGOS(big)
221
- N = 400
222
- for i in range(N):
223
- cg2.add(f"n{i:04d}", _CCG.format(n=f"n{i:04d}", t="苹果 章节"),
224
- layer="knowledge", importance=0.5,
225
- edges=[{"target": f"n{(i + 1) % N:04d}",
226
- "relation_type": "causal"}])
227
- cg2.flush()
228
- cg2._chain_adj = None
229
- t0 = time.perf_counter()
230
- adj2 = chain.adjacency(cg2)
231
- dt = time.perf_counter() - t0
232
- print(f" 代价读数:N={N} 条目,cold adjacency = {dt * 1000:.3f} ms"
233
- f"(邻接源数 {len(adj2)})")
234
- check("⑥ O(N) 条目级代价(400 条目冷建 < 200ms,宽松上界)",
235
- dt < 0.2, f"{dt:.4f}s")
236
- cg2.close()
237
- # 文档/注释措辞:不得把「不走全表」当作对 adjacency 成立的表述
238
- ch = _src(os.path.join("md_cg", "chain.py"))
239
- check("⑥ chain.adjacency 注释已改为「不读正文;O(N) 索引条目级」",
240
- "邻接构建为 O(N) 索引条目级" in ch)
241
- ct = _src(os.path.join("docs", "hive", "检索路径与认知结构契约_v0.1.md"))
242
- check("⑥ 契约文档已改正(含代价读数与可选硬化路径)",
243
- "不读正文;\n 邻接构建为 O(N) 索引条目级" in ct
244
- or "邻接构建为 O(N) 索引条目级" in ct)
245
- check("⑥ 契约文档不再出现无条件的「不走全表」断言",
246
- "扩散 N 跳、按跳数衰减;不走全表" not in ct)
247
- finally:
248
- cg.close()
249
-
250
-
251
- def gc_lang_divergence():
252
- print("== C 缺省路集分叉:Rust 四路 vs Python 六路(登记,非对拍通过)==")
253
- eng = _src(os.path.join("rust", "src", "engine.rs"))
254
- m = re.search(r"cfg\.paths\.clone\(\)\.unwrap_or_else\(\|\|\s*\{(.*?)\}\)",
255
- eng, re.S)
256
- check("C Rust 缺省 paths 字面量可解析", m is not None)
257
- rust_paths = re.findall(r'"([a-z_]+)"\.to_string\(\)', m.group(1)) if m else []
258
- check("C Rust 缺省 == 四路(lexical/bucket/entity/graph)",
259
- rust_paths == ["lexical", "bucket", "entity", "graph"],
260
- str(rust_paths))
261
- py_default = inspect.signature(MdCGOS.search_rrf).parameters["paths"].default
262
- check("C Python search_rrf 缺省 == 六路",
263
- tuple(py_default) == ("lexical", "bucket", "entity", "graph",
264
- "chain", "temporal"), str(py_default))
265
- check("C 两侧缺省**不相等**(分叉为已知边界,不得声称对拍通过)",
266
- set(rust_paths) != set(py_default), f"{rust_paths} vs {list(py_default)}")
267
- check("C 契约文档已登记该分叉(§4.2)",
268
- "读侧**语言面**分叉" in _src(os.path.join(
269
- "docs", "hive", "检索路径与认知结构契约_v0.1.md")))
270
- # mdcg_recall 缺省构造:paths=None(交给 mdcos 六路缺省)
271
- ms = _src(os.path.join("md_cg", "mcp_server.py"))
272
- check("C mdcg_recall 缺省把 paths 交给 mdcos(paths = None)",
273
- "paths = None # 缺省六路" in ms)
274
-
275
-
276
- def gd_s3_partial():
277
- print("== D S3 ④ 部分满足:类型集可配 / 权重唯一表 / 方向固定 ==")
278
- ch = _src(os.path.join("md_cg", "chain.py"))
279
- check("D 类型集可配(env MDCG_CHAIN_TYPES)",
280
- 'CHAIN_TYPES_ENV = "MDCG_CHAIN_TYPES"' in ch
281
- and callable(chain.chain_types_from_env))
282
- os.environ["MDCG_CHAIN_TYPES"] = "reference,causal"
283
- try:
284
- check("D 类型集生效且只含已登记类型",
285
- chain.chain_types_from_env() == ("reference", "causal"),
286
- str(chain.chain_types_from_env()))
287
- finally:
288
- os.environ.pop("MDCG_CHAIN_TYPES", None)
289
- os.environ["MDCG_CHAIN_TYPES"] = "不存在的类型"
290
- try:
291
- check("D 非法类型集回落缺省(剔除即回落,不静默走未知边)",
292
- chain.chain_types_from_env() == chain.CHAIN_TYPES_DEFAULT)
293
- finally:
294
- os.environ.pop("MDCG_CHAIN_TYPES", None)
295
- check("D 权重沿用**唯一表** EDGE_WEIGHTS(无第二份边权表)",
296
- "EDGE_WEIGHTS = {" in ch
297
- and ch.count("EDGE_WEIGHTS.get(") >= 1
298
- and "def edge_weight(edge)" in ch)
299
- check("D 类型集只从 EDGE_WEIGHTS 里挑子集(t in EDGE_WEIGHTS)",
300
- "if t in EDGE_WEIGHTS" in ch)
301
- sig = inspect.signature(chain.walk).parameters
302
- check("D 方向固定为依赖方向(出边):walk 缺省 direction == 'out'",
303
- sig["direction"].default == "out", str(sig["direction"].default))
304
- check("D 措辞已改准(docstring 写明「部分满足」与三件口径)",
305
- "可配面边界" in ch and "**部分满足**" in ch
306
- and "**方向**:固定为**依赖方向(出边)**" in ch
307
- and "沿用**唯一表** `EDGE_WEIGHTS`" in ch)
308
- ct = _src(os.path.join("docs", "hive", "检索路径与认知结构契约_v0.1.md"))
309
- check("D 契约文档已把 S3 ④ 标为部分满足",
310
- "**部分满足**" in ct and "边权数值" in ct)
311
-
312
-
313
- # --------------------------------------------------------------------------
314
- # 定点变异(只改本进程内存对象/临时输入,绝不改仓库文件)
315
- # --------------------------------------------------------------------------
316
-
317
- def _mut_fusion_causal_dropped():
318
- orig = MS.recall_fusion_default
319
-
320
- def no_causal(use_fuzzy, use_semantic, use_goal, use_causal,
321
- use_temporal=False):
322
- return "max" if (use_fuzzy or use_semantic or use_goal) else None
323
- MS.recall_fusion_default = no_causal
324
-
325
- def restore():
326
- MS.recall_fusion_default = orig
327
- return restore
328
-
329
-
330
- def _mut_chain_seed_all():
331
- """把因果路种子改成「全库节点」——不变量 ① 应当立刻变红。"""
332
- orig = MdCGOS._path_chain
333
-
334
- def polluted(self, query, entries, seeds, context=None, **kw):
335
- # 未过门控的节点**排在前 8**(`_path_chain` 只取 seeds[:8])——
336
- # 这正是「种子引入了未过 S1/S2 门控的节点」这一违规形态
337
- ent = {id(e) for e in entries}
338
- nodes = list((self.index.get("nodes") or {}).items())
339
- allseeds = [({"id": nid}, 1.0) for nid, e in nodes
340
- if id(e) not in ent]
341
- allseeds += [({"id": nid}, 1.0) for nid, e in nodes if id(e) in ent]
342
- return orig(self, query, entries, allseeds, context, **kw)
343
- MdCGOS._path_chain = polluted
344
-
345
- def restore():
346
- MdCGOS._path_chain = orig
347
- return restore
348
-
349
-
350
- def _mut_adjacency_reads():
351
- """让邻接构建读正文(走 cg.get)——「不读正文」断言应当变红。"""
352
- orig = SG._fm
353
-
354
- def slow(cg_, nid):
355
- node = cg_.get(nid)
356
- return (node or {}).get("frontmatter") or {}
357
- SG._fm = slow
358
-
359
- def restore():
360
- SG._fm = orig
361
- return restore
362
-
363
-
364
- def _mut_py_default_paths():
365
- """把 mdcos.search_rrf 的 paths 缺省改成四路(源码复制体上验证)。"""
366
- orig = MdCGOS.search_rrf.__defaults__
367
-
368
- def restore():
369
- MdCGOS.search_rrf.__defaults__ = orig
370
- args = list(orig)
371
- for i, a in enumerate(args):
372
- if isinstance(a, tuple) and "chain" in a:
373
- args[i] = ("lexical", "bucket", "entity", "graph")
374
- MdCGOS.search_rrf.__defaults__ = tuple(args)
375
- return restore
376
-
377
-
378
- _MUTATIONS = [
379
- ("fusion_drop_causal", "融合判据丢掉 use_causal(缺省退化为 sum)",
380
- _mut_fusion_causal_dropped),
381
- ("chain_seeds_all", "因果路种子改成全库节点且未过门控者排前(不变量①应红)",
382
- _mut_chain_seed_all),
383
- ("adjacency_reads_body", "邻接构建改成读正文(不变量⑥应红)",
384
- _mut_adjacency_reads),
385
- ("py_default_four_paths", "Python 缺省路集改成四路(分叉登记应红)",
386
- _mut_py_default_paths),
387
- ]
388
-
389
-
390
- def _collect():
391
- global PASS, FAIL, FAILS
392
- PASS, FAIL, FAILS = 0, 0, []
393
- ga_fusion()
394
- gb_s3_invariants()
395
- gc_lang_divergence()
396
- gd_s3_partial()
397
- return list(FAILS)
398
-
399
-
400
- def main(argv):
401
- if "--mutate" in argv:
402
- if "--list" in argv:
403
- for name, desc, _fn in _MUTATIONS:
404
- print(f" {name:24s} {desc}")
405
- return 0
406
- base = _collect()
407
- if base:
408
- print(f"\n!! 基线不绿({len(base)} 条):{base}")
409
- return 1
410
- bad = []
411
- for name, desc, fn in _MUTATIONS:
412
- try:
413
- restore = fn()
414
- except (AttributeError, StopIteration) as exc:
415
- print(f" ANCHOR-MISS {name}: {exc}")
416
- return 2
417
- got = _collect()
418
- restore()
419
- if got:
420
- print(f" MUTATE-OK {name}({desc})→ 转红 {len(got)} 条:{got[:3]}")
421
- else:
422
- bad.append(name)
423
- print(f" MUTATE-FAIL {name}({desc})→ 仍全绿")
424
- print(f"\ntest_p3_legacy_closure --mutate: "
425
- f"{len(_MUTATIONS) - len(bad)}/{len(_MUTATIONS)} 变异按预期转红")
426
- return 0 if not bad else 1
427
- fails = _collect()
428
- print(f"\ntest_p3_legacy_closure: {PASS} 通过 / {FAIL} 失败")
429
- return 0 if not fails else 1
430
-
431
-
432
- if __name__ == "__main__":
433
- sys.exit(main(sys.argv[1:]))
1
+ # -*- coding: utf-8 -*-
2
+ """P3 遗留四条闭环守卫(A 融合口径披露 / B S3 不变量读数 / C 缺省路集分叉 / D ④部分满足)。
3
+
4
+ 来源:设计稿 §5.4 / §6.2 / §6.3 与交接单「P3 遗留四条·必须在本批闭环」。
5
+ 四条各缺一条即不得收口,故**每条一个断言组**:
6
+
7
+ A **默认 recall 的融合口径由 sum 变 max**(`use_causal` 缺省 True)——
8
+ A1 判据单点 `mcp_server.recall_fusion_default` 的取值断言(缺省态 == "max",
9
+ 显式关因果 == None;`use_temporal` **不入判据**);
10
+ A2 同一确定性库上「默认 vs 显式 sum」的 top-k 读数**逐条不同**(分数与名次);
11
+ A3 默认调用点确实走该单点(源码断言:`fusion = a.get("fusion") or
12
+ recall_fusion_default(...)`)。
13
+ B **S3 不变量 ① 与 ⑥ 的读数缺口**——
14
+ B1 ①「种子取自过 S1/S2 门控的命中」:因果路**种子** ⊆ 已过门控的候选面
15
+ (`entries`),且因果路**输出** ⊆ 候选面(两条断言,实跑)。
16
+ B2 ⑥「不走全表」实测不成立 ⇒ 如实降级声明:`chain.adjacency` **不读正文**
17
+ (读盘调用计数 == 0),但邻接构建为 **O(N) 索引条目级**——给代价读数
18
+ (N 条目的冷建耗时),并断言文档/注释里**不再**把「不走全表」当作
19
+ 对 `adjacency` 成立的表述。
20
+ C **Rust 侧缺省路集分叉**(如实披露,**不得**声称对拍通过)——
21
+ Rust `EngineConfig::default{paths:None}` 字面量 == 四路;
22
+ Python `search_rrf` 缺省 == 六路;两者**不相等**(分叉登记)。
23
+ D **S3 ④ 只部分满足**——类型集可配(`MDCG_CHAIN_TYPES`)、权重沿用唯一表
24
+ `EDGE_WEIGHTS`、方向固定为依赖方向(出边)——逐条断言,并断言措辞已改准。
25
+
26
+ 运行:
27
+ python -X utf8 -m md_cg.test_p3_legacy_closure
28
+ python -X utf8 -m md_cg.test_p3_legacy_closure --mutate
29
+ python -X utf8 -m md_cg.test_p3_legacy_closure --mutate --list
30
+
31
+ 退出码:0 全绿;1 有失败 / 变异未按预期转红;2 ANCHOR-MISS。
32
+ """
33
+ from __future__ import annotations
34
+
35
+ import inspect
36
+ import os
37
+ import re
38
+ import statistics
39
+ import sys
40
+ import tempfile
41
+ import time
42
+
43
+ _TMP0 = tempfile.mkdtemp(prefix="p3_legacy_")
44
+ os.environ["MDCG_AUX_ROOT"] = os.path.join(_TMP0, "auxroot")
45
+ os.environ["MDCG_MASTER_KEY"] = "34" * 32
46
+ os.environ["MDCG_TOKEN_FILE"] = os.path.join(_TMP0, "tokens.json")
47
+ os.environ["MDCG_ROOT"] = os.path.join(_TMP0, "cgroot")
48
+ for _k in ("MDCG_TOKEN", "MDCG_TENANT", "MDCG_CLEARANCE", "MDCG_SESSION",
49
+ "MDCG_RETRIEVAL_PIPELINE", "MDCG_POOLING", "MDCG_FRESHNESS",
50
+ "MDCG_CHAIN_TYPES"):
51
+ os.environ.pop(_k, None)
52
+
53
+ _HERE = os.path.dirname(os.path.abspath(__file__))
54
+ _REPO = os.path.dirname(_HERE)
55
+ sys.path.insert(0, _REPO)
56
+
57
+ try:
58
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
59
+ except AttributeError:
60
+ pass
61
+
62
+ from md_cg import chain # noqa: E402
63
+ from md_cg import mcp_server as MS # noqa: E402
64
+ from md_cg import mdcg as M # noqa: E402
65
+ from md_cg import subgraph as SG # noqa: E402
66
+ from md_cg.mdcos import MdCGOS # noqa: E402
67
+
68
+ PASS = 0
69
+ FAIL = 0
70
+ FAILS = []
71
+
72
+
73
+ def check(name, cond, detail=""):
74
+ global PASS, FAIL
75
+ if cond:
76
+ PASS += 1
77
+ print(f" OK {name}")
78
+ else:
79
+ FAIL += 1
80
+ FAILS.append(name)
81
+ print(f" FAIL {name} {detail}")
82
+ return bool(cond)
83
+
84
+
85
+ def _src(rel):
86
+ with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
87
+ return f.read()
88
+
89
+
90
+ _CCG = ("# 功能名:{n}\n# 生效条件:无条件\n# 子功能:无\n# 执行:占位\n"
91
+ "# 验证方式:compiler 复现\n# 不适用条件:其它会话\n\n{t}\n")
92
+
93
+
94
+ def _fusion_lib():
95
+ """受控库:两路共识 vs 单路更好名次——sum 与 max 的 top-k 序列在此分开。"""
96
+ root = tempfile.mkdtemp(prefix="p3_fuse_")
97
+ cg = MdCGOS(root)
98
+ cg.add("m_aa", _CCG.format(n="m_aa", t="苹果 别的内容 章节 分离"),
99
+ layer="knowledge", tags=["苹果"], importance=0.5)
100
+ cg.add("m_zz", _CCG.format(n="m_zz", t="苹果 别的内容 章节 分离"),
101
+ # 2026-10-12(#130 名次可信度契约):本夹具原用「entity 路对 m_aa/m_zz 给同一个常量分、
102
+ # 交由 importance 兜底分先后」来制造两路共识——而该形态正是 #130 判定为「名次不可信」
103
+ # 因而不投票的形态;契约生效后 sum/max 退化为同序 ⇒ A2「逐条不同」失去可观测性
104
+ # (CI 实测 29 通过 / 2 失败)。改法:让 m_zz 的 tag 成为**真分数**(aff 1.0,m_aa 为 0.7)
105
+ # 而非常量 ⇒ entity 路重新携带名次信息,A2 恢复可观测。契约本身不动,本改动=夹具前提修复。
106
+ layer="knowledge", tags=["苹果 章节"], importance=0.9)
107
+ cg.add("m_lex", _CCG.format(n="m_lex", t="苹果章节 同构"),
108
+ layer="knowledge", importance=0.5)
109
+ cg.add("m_other", _CCG.format(n="m_other", t="苹果 别的内容 章节 分离 更多"),
110
+ layer="knowledge", importance=0.5)
111
+ cg.flush()
112
+ return root, cg
113
+
114
+
115
+ def _chain_lib(n_seed=3, n_other=6):
116
+ root = tempfile.mkdtemp(prefix="p3_chain_")
117
+ cg = MdCGOS(root)
118
+ for i in range(n_seed):
119
+ cg.add(f"s{i}", _CCG.format(n=f"s{i}", t="苹果 章节 种子"),
120
+ layer="knowledge", importance=0.5,
121
+ edges=[{"target": f"t{i}", "relation_type": "causal",
122
+ "confidence": 0.9}])
123
+ cg.add(f"t{i}", _CCG.format(n=f"t{i}", t="下游 结论"),
124
+ layer="knowledge", importance=0.5)
125
+ for i in range(n_other):
126
+ cg.add(f"o{i}", _CCG.format(n=f"o{i}", t="无关 其它"),
127
+ layer="knowledge", importance=0.5)
128
+ # 负记忆层节点:**不在** `_candidates` 的候选面(NEG_ROUTE_LAYERS)——
129
+ # 有它,不变量①「种子 ⊆ 已过门控的候选面」才有判别力
130
+ cg.add("rj1", _CCG.format(n="rj1", t="苹果 章节 被否决的假设"),
131
+ layer="rejected", importance=0.0)
132
+ cg.flush()
133
+ return root, cg
134
+
135
+
136
+ def ga_fusion():
137
+ print("== A 默认 recall 融合口径 sum→max(披露 + 判据 + 读数)==")
138
+ check("A1 判据单点:缺省(use_causal=True)→ max",
139
+ MS.recall_fusion_default(False, False, False, True) == "max",
140
+ str(MS.recall_fusion_default(False, False, False, True)))
141
+ check("A1 显式关因果且其余全关 → None(回到 search_rrf 的 sum 缺省)",
142
+ MS.recall_fusion_default(False, False, False, False) is None)
143
+ check("A1 use_temporal 不入判据(时间路是排名项,非单路独有召回型)",
144
+ MS.recall_fusion_default(False, False, False, False, True) is None
145
+ and MS.recall_fusion_default(False, False, False, True, True) == "max")
146
+ src = _src(os.path.join("md_cg", "mcp_server.py"))
147
+ check("A3 默认调用点走判据单点",
148
+ "fusion = a.get(\"fusion\") or recall_fusion_default(" in src)
149
+ check("A3 use_causal 缺省 True(披露的根因)",
150
+ "use_causal = True if use_causal is None else bool(use_causal)" in src)
151
+ root, cg = _fusion_lib()
152
+ try:
153
+ def top(**kw):
154
+ pack = MS._dispatch(cg, "mdcg_recall",
155
+ dict({"query": "苹果 章节", "k": 5}, **kw))
156
+ return [[it.get("id"), it.get("score")]
157
+ for it in (pack.get("pack") or [])]
158
+ d = top()
159
+ s = top(fusion="sum")
160
+ mx = top(fusion="max")
161
+ print(f" default={d}")
162
+ print(f" sum ={s}")
163
+ print(f" max ={mx}")
164
+ check("A2 默认口径 == max(逐条相同)", d == mx, f"{d} vs {mx}")
165
+ check("A2 默认口径 ≠ sum(逐条不同:分数或名次)", d != s, f"{d} vs {s}")
166
+ check("A2 top-1 名次在 sum/max 下不同(口径差可观测)",
167
+ bool(d) and bool(s) and d[0][0] != s[0][0],
168
+ f"{d[:1]} vs {s[:1]}")
169
+ finally:
170
+ cg.close()
171
+
172
+
173
+ def gb_s3_invariants():
174
+ print("== B S3 不变量 ①⑥ 读数(种子 ⊆ 门控面 / 邻接代价)==")
175
+ root, cg = _chain_lib()
176
+ try:
177
+ # ① 因果路种子 ⊆ 已过 S1/S2 门控的候选面(entries)
178
+ seen = {}
179
+ orig = chain.expand_from_seeds
180
+
181
+ def spy(cg_, seeds, **kw):
182
+ seen["seeds"] = list(seeds.items()) if isinstance(seeds, dict) \
183
+ else list(seeds or [])
184
+ return orig(cg_, seeds, **kw)
185
+
186
+ chain.expand_from_seeds = spy
187
+ try:
188
+ res, meta = cg.search_rrf("苹果 章节", k=8, record=False,
189
+ paths=("lexical", "chain"))
190
+ finally:
191
+ chain.expand_from_seeds = orig
192
+ ent_ids = {e["path"].split("/")[-1][:-3] for e in cg._candidates()}
193
+ seed_ids = {nid for nid, _s in (seen.get("seeds") or [])}
194
+ check("① 因果路种子非空(夹具前提)", bool(seed_ids), str(seen))
195
+ check("① 种子 ⊆ 已过门控的候选面(entries)",
196
+ seed_ids <= ent_ids, f"{seed_ids - ent_ids}")
197
+ out_ids = {r[0]["id"] for r in res}
198
+ check("① 因果路输出 ⊆ 候选面(不得引入未过门控的节点)",
199
+ out_ids <= ent_ids, f"{out_ids - ent_ids}")
200
+ check("① 因果路确实产出(下游 t* 被召回)",
201
+ any(i.startswith("t") for i in out_ids), str(sorted(out_ids)))
202
+
203
+ # ⑥ 邻接:不读正文(读盘计数 == 0)+ O(N) 索引条目级代价读数
204
+ calls = {"n": 0}
205
+ orig_read, orig_get = M.MdCG._read, M.MdCG.get
206
+
207
+ def rd(self, *a, **kw):
208
+ calls["n"] += 1
209
+ return orig_read(self, *a, **kw)
210
+
211
+ def gt(self, *a, **kw):
212
+ calls["n"] += 1
213
+ return orig_get(self, *a, **kw)
214
+
215
+ M.MdCG._read, M.MdCG.get = rd, gt
216
+ try:
217
+ cg._chain_adj = None
218
+ adj = chain.adjacency(cg)
219
+ finally:
220
+ M.MdCG._read, M.MdCG.get = orig_read, orig_get
221
+ check("⑥ 邻接构建不读正文/不读盘(读盘调用计数 == 0)",
222
+ calls["n"] == 0, f"reads={calls['n']}")
223
+ # 代价读数:N 条目冷建耗时(夹具 N=9;再取一个 400 条目的规模读)
224
+ big = tempfile.mkdtemp(prefix="p3_adj_")
225
+ cg2 = MdCGOS(big)
226
+ N = 400
227
+ for i in range(N):
228
+ cg2.add(f"n{i:04d}", _CCG.format(n=f"n{i:04d}", t="苹果 章节"),
229
+ layer="knowledge", importance=0.5,
230
+ edges=[{"target": f"n{(i + 1) % N:04d}",
231
+ "relation_type": "causal"}])
232
+ cg2.flush()
233
+ cg2._chain_adj = None
234
+ t0 = time.perf_counter()
235
+ adj2 = chain.adjacency(cg2)
236
+ dt = time.perf_counter() - t0
237
+ print(f" 代价读数:N={N} 条目,cold adjacency = {dt * 1000:.3f} ms"
238
+ f"(邻接源数 {len(adj2)})")
239
+ check("⑥ O(N) 条目级代价(400 条目冷建 < 200ms,宽松上界)",
240
+ dt < 0.2, f"{dt:.4f}s")
241
+ cg2.close()
242
+ # 文档/注释措辞:不得把「不走全表」当作对 adjacency 成立的表述
243
+ ch = _src(os.path.join("md_cg", "chain.py"))
244
+ check("⑥ chain.adjacency 注释已改为「不读正文;O(N) 索引条目级」",
245
+ "邻接构建为 O(N) 索引条目级" in ch)
246
+ ct = _src(os.path.join("docs", "hive", "检索路径与认知结构契约_v0.1.md"))
247
+ check("⑥ 契约文档已改正(含代价读数与可选硬化路径)",
248
+ "不读正文;\n 邻接构建为 O(N) 索引条目级" in ct
249
+ or "邻接构建为 O(N) 索引条目级" in ct)
250
+ check("⑥ 契约文档不再出现无条件的「不走全表」断言",
251
+ "扩散 N 跳、按跳数衰减;不走全表" not in ct)
252
+ finally:
253
+ cg.close()
254
+
255
+
256
+ def gc_lang_divergence():
257
+ print("== C 缺省路集分叉:Rust 四路 vs Python 六路(登记,非对拍通过)==")
258
+ eng = _src(os.path.join("rust", "src", "engine.rs"))
259
+ m = re.search(r"cfg\.paths\.clone\(\)\.unwrap_or_else\(\|\|\s*\{(.*?)\}\)",
260
+ eng, re.S)
261
+ check("C Rust 缺省 paths 字面量可解析", m is not None)
262
+ rust_paths = re.findall(r'"([a-z_]+)"\.to_string\(\)', m.group(1)) if m else []
263
+ check("C Rust 缺省 == 四路(lexical/bucket/entity/graph)",
264
+ rust_paths == ["lexical", "bucket", "entity", "graph"],
265
+ str(rust_paths))
266
+ py_default = inspect.signature(MdCGOS.search_rrf).parameters["paths"].default
267
+ check("C Python search_rrf 缺省 == 六路",
268
+ tuple(py_default) == ("lexical", "bucket", "entity", "graph",
269
+ "chain", "temporal"), str(py_default))
270
+ check("C 两侧缺省**不相等**(分叉为已知边界,不得声称对拍通过)",
271
+ set(rust_paths) != set(py_default), f"{rust_paths} vs {list(py_default)}")
272
+ check("C 契约文档已登记该分叉(§4.2)",
273
+ "读侧**语言面**分叉" in _src(os.path.join(
274
+ "docs", "hive", "检索路径与认知结构契约_v0.1.md")))
275
+ # mdcg_recall 缺省构造:paths=None(交给 mdcos 六路缺省)
276
+ ms = _src(os.path.join("md_cg", "mcp_server.py"))
277
+ check("C mdcg_recall 缺省把 paths 交给 mdcos(paths = None)",
278
+ "paths = None # 缺省六路" in ms)
279
+
280
+
281
+ def gd_s3_partial():
282
+ print("== D S3 ④ 部分满足:类型集可配 / 权重唯一表 / 方向固定 ==")
283
+ ch = _src(os.path.join("md_cg", "chain.py"))
284
+ check("D 类型集可配(env MDCG_CHAIN_TYPES)",
285
+ 'CHAIN_TYPES_ENV = "MDCG_CHAIN_TYPES"' in ch
286
+ and callable(chain.chain_types_from_env))
287
+ os.environ["MDCG_CHAIN_TYPES"] = "reference,causal"
288
+ try:
289
+ check("D 类型集生效且只含已登记类型",
290
+ chain.chain_types_from_env() == ("reference", "causal"),
291
+ str(chain.chain_types_from_env()))
292
+ finally:
293
+ os.environ.pop("MDCG_CHAIN_TYPES", None)
294
+ os.environ["MDCG_CHAIN_TYPES"] = "不存在的类型"
295
+ try:
296
+ check("D 非法类型集回落缺省(剔除即回落,不静默走未知边)",
297
+ chain.chain_types_from_env() == chain.CHAIN_TYPES_DEFAULT)
298
+ finally:
299
+ os.environ.pop("MDCG_CHAIN_TYPES", None)
300
+ check("D 权重沿用**唯一表** EDGE_WEIGHTS(无第二份边权表)",
301
+ "EDGE_WEIGHTS = {" in ch
302
+ and ch.count("EDGE_WEIGHTS.get(") >= 1
303
+ and "def edge_weight(edge)" in ch)
304
+ check("D 类型集只从 EDGE_WEIGHTS 里挑子集(t in EDGE_WEIGHTS)",
305
+ "if t in EDGE_WEIGHTS" in ch)
306
+ sig = inspect.signature(chain.walk).parameters
307
+ check("D 方向固定为依赖方向(出边):walk 缺省 direction == 'out'",
308
+ sig["direction"].default == "out", str(sig["direction"].default))
309
+ check("D 措辞已改准(docstring 写明「部分满足」与三件口径)",
310
+ "可配面边界" in ch and "**部分满足**" in ch
311
+ and "**方向**:固定为**依赖方向(出边)**" in ch
312
+ and "沿用**唯一表** `EDGE_WEIGHTS`" in ch)
313
+ ct = _src(os.path.join("docs", "hive", "检索路径与认知结构契约_v0.1.md"))
314
+ check("D 契约文档已把 S3 ④ 标为部分满足",
315
+ "**部分满足**" in ct and "边权数值" in ct)
316
+
317
+
318
+ # --------------------------------------------------------------------------
319
+ # 定点变异(只改本进程内存对象/临时输入,绝不改仓库文件)
320
+ # --------------------------------------------------------------------------
321
+
322
+ def _mut_fusion_causal_dropped():
323
+ orig = MS.recall_fusion_default
324
+
325
+ def no_causal(use_fuzzy, use_semantic, use_goal, use_causal,
326
+ use_temporal=False):
327
+ return "max" if (use_fuzzy or use_semantic or use_goal) else None
328
+ MS.recall_fusion_default = no_causal
329
+
330
+ def restore():
331
+ MS.recall_fusion_default = orig
332
+ return restore
333
+
334
+
335
+ def _mut_chain_seed_all():
336
+ """把因果路种子改成「全库节点」——不变量 ① 应当立刻变红。"""
337
+ orig = MdCGOS._path_chain
338
+
339
+ def polluted(self, query, entries, seeds, context=None, **kw):
340
+ # 未过门控的节点**排在前 8**(`_path_chain` 只取 seeds[:8])——
341
+ # 这正是「种子引入了未过 S1/S2 门控的节点」这一违规形态
342
+ ent = {id(e) for e in entries}
343
+ nodes = list((self.index.get("nodes") or {}).items())
344
+ allseeds = [({"id": nid}, 1.0) for nid, e in nodes
345
+ if id(e) not in ent]
346
+ allseeds += [({"id": nid}, 1.0) for nid, e in nodes if id(e) in ent]
347
+ return orig(self, query, entries, allseeds, context, **kw)
348
+ MdCGOS._path_chain = polluted
349
+
350
+ def restore():
351
+ MdCGOS._path_chain = orig
352
+ return restore
353
+
354
+
355
+ def _mut_adjacency_reads():
356
+ """让邻接构建读正文(走 cg.get)——「不读正文」断言应当变红。"""
357
+ orig = SG._fm
358
+
359
+ def slow(cg_, nid):
360
+ node = cg_.get(nid)
361
+ return (node or {}).get("frontmatter") or {}
362
+ SG._fm = slow
363
+
364
+ def restore():
365
+ SG._fm = orig
366
+ return restore
367
+
368
+
369
+ def _mut_py_default_paths():
370
+ """把 mdcos.search_rrf 的 paths 缺省改成四路(源码复制体上验证)。"""
371
+ orig = MdCGOS.search_rrf.__defaults__
372
+
373
+ def restore():
374
+ MdCGOS.search_rrf.__defaults__ = orig
375
+ args = list(orig)
376
+ for i, a in enumerate(args):
377
+ if isinstance(a, tuple) and "chain" in a:
378
+ args[i] = ("lexical", "bucket", "entity", "graph")
379
+ MdCGOS.search_rrf.__defaults__ = tuple(args)
380
+ return restore
381
+
382
+
383
+ _MUTATIONS = [
384
+ ("fusion_drop_causal", "融合判据丢掉 use_causal(缺省退化为 sum)",
385
+ _mut_fusion_causal_dropped),
386
+ ("chain_seeds_all", "因果路种子改成全库节点且未过门控者排前(不变量①应红)",
387
+ _mut_chain_seed_all),
388
+ ("adjacency_reads_body", "邻接构建改成读正文(不变量⑥应红)",
389
+ _mut_adjacency_reads),
390
+ ("py_default_four_paths", "Python 缺省路集改成四路(分叉登记应红)",
391
+ _mut_py_default_paths),
392
+ ]
393
+
394
+
395
+ def _collect():
396
+ global PASS, FAIL, FAILS
397
+ PASS, FAIL, FAILS = 0, 0, []
398
+ ga_fusion()
399
+ gb_s3_invariants()
400
+ gc_lang_divergence()
401
+ gd_s3_partial()
402
+ return list(FAILS)
403
+
404
+
405
+ def main(argv):
406
+ if "--mutate" in argv:
407
+ if "--list" in argv:
408
+ for name, desc, _fn in _MUTATIONS:
409
+ print(f" {name:24s} {desc}")
410
+ return 0
411
+ base = _collect()
412
+ if base:
413
+ print(f"\n!! 基线不绿({len(base)} 条):{base}")
414
+ return 1
415
+ bad = []
416
+ for name, desc, fn in _MUTATIONS:
417
+ try:
418
+ restore = fn()
419
+ except (AttributeError, StopIteration) as exc:
420
+ print(f" ANCHOR-MISS {name}: {exc}")
421
+ return 2
422
+ got = _collect()
423
+ restore()
424
+ if got:
425
+ print(f" MUTATE-OK {name}({desc})→ 转红 {len(got)} 条:{got[:3]}")
426
+ else:
427
+ bad.append(name)
428
+ print(f" MUTATE-FAIL {name}({desc})→ 仍全绿")
429
+ print(f"\ntest_p3_legacy_closure --mutate: "
430
+ f"{len(_MUTATIONS) - len(bad)}/{len(_MUTATIONS)} 变异按预期转红")
431
+ return 0 if not bad else 1
432
+ fails = _collect()
433
+ print(f"\ntest_p3_legacy_closure: {PASS} 通过 / {FAIL} 失败")
434
+ return 0 if not fails else 1
435
+
436
+
437
+ if __name__ == "__main__":
438
+ sys.exit(main(sys.argv[1:]))