@furongjun1999/dsh-memory 0.8.0 → 0.9.6

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 (714) hide show
  1. package/README.md +662 -632
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  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 +1 -1
  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 +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  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 +13 -1
  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 +16 -1
  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 +8 -2
  34. package/lib/tools.js +22 -3
  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 +22 -5
  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 +572 -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 +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  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 +14 -3
  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 +86 -5
  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 +7104 -5417
  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 +4 -1
  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 +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  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 +12 -3
  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 +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  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 +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  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 +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  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 +43 -3
  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_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. 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
  531. 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
  532. 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
  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_v2.0.md +0 -239
  534. 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
  535. 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
  536. 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
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. 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
  539. 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
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. 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
  543. 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
  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.1.md +0 -340
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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 -152
  573. 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
  574. 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
  575. 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
  576. 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
  577. 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
  578. 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
  579. 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
  580. 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
  581. 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
  582. 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
  583. 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
  584. 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
  585. 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
  586. 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
  587. 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
  588. 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
  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_v12.md +0 -203
  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_v13.md +0 -233
  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_v14.md +0 -191
  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_v15.md +0 -213
  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_v16.md +0 -214
  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_v17.md +0 -199
  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_v18.md +0 -183
  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_v19.md +0 -207
  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_v2.md +0 -156
  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_v20.md +0 -283
  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_v21.md +0 -224
  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_v22.md +0 -223
  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_v23.md +0 -293
  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_v24.md +0 -303
  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_v25.md +0 -230
  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_v26.md +0 -196
  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_v27.md +0 -259
  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_v28.md +0 -217
  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_v29.md +0 -270
  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_v3.md +0 -152
  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_v30.md +0 -231
  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_v31.md +0 -281
  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_v4.md +0 -128
  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_v5.md +0 -114
  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_v6.md +0 -192
  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_v7.md +0 -187
  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_v8.md +0 -207
  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_v9.md +0 -203
  617. 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
  618. 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
  619. 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
  620. 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
  621. 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
  622. 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
  623. 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
  624. 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
  625. 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
  626. 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
  627. 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
  628. 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
  629. 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
  630. 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
  631. 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
  632. 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
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. 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
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. 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
  647. 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
  648. 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
  649. 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
  650. 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
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. 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
  653. 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
  654. 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
  655. 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
  656. 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
  657. 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
  658. 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
  659. 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
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. 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
  662. 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
  663. 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
  664. 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
  665. 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
  666. 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
  667. 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
  668. 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
  669. 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
  670. 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
  671. 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
  672. 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
  673. 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
  674. 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
  675. 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
  676. 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
  677. 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
  678. 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
  679. 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
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. 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
  688. 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
  689. 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
  690. 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
  691. 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
  692. 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
  693. 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
  694. 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
  695. 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
  696. 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
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. 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
  699. 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
  700. 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
  701. 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
  702. 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
  703. 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
  704. 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
  705. 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
  706. 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
  707. 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
  708. 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
  709. 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
  710. 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
  711. 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
  712. 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
  713. 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
  714. 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
@@ -0,0 +1,500 @@
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:k 预算分配守卫(H10 修订)——负覆盖提示条**永不得挤占真实命中**
3
+ # 生效条件:md_cg/mdcg.py 的 `_emit` 里「真实命中数 n_real = min(max(0,k), scored 中
4
+ # s>0 的条数) → 提示条数 = min(NEG_COVERAGE_MAX, max(0, k − n_real)) →
5
+ # 主结果 = scored[:max(0, k − 提示数)]」三者按此口径配对时成立;
6
+ # 沙箱条件:所有库根一律 tempfile.mkdtemp,绝不触在役库/在役服务。
7
+ # 子功能:
8
+ # A 缺陷复现与修复((a) 判据):负覆盖在场且 k=1/2/3 时,最高分真实命中必须出现在
9
+ # 返回里且在首位(改前 k ≤ 提示数 → 主结果配额被算成 0,一条真命中都不返回——
10
+ # 把「读不到」读成「不存在」)
11
+ # B k 预算((b)(c) 判据):真命中已用满 k(真实命中数 ≥ k)时不发提示条;
12
+ # 任何 k(含 0/1 边界)下 len(返回条目) ≤ k(H10② 的成果不回退)
13
+ # C 信号不丢((d) 判据):无真实命中时提示条仍出现并填满 min(NEG_COVERAGE_MAX, k);
14
+ # 提示条为 0 时该信号仍可从**既有**统计/审计面读到(meta["covered_neg"] 恒为
15
+ # 全部被覆盖路径、门控开启时 stat["gates"]["s5"]["neg"] 同值)——不新增协议字段
16
+ # D 单点与既有属性:`_neg_tail`/`_primary_slots` 在 mdcg.py 内各恰一处调用(都在
17
+ # `_emit` 内)、生产路径 MdCGOS 不覆写 `_emit`(route/read/search 三处 result 面
18
+ # 共用这一处)、提示三项既有属性(哨兵分 0.0 / 尾部 / 独立字段 negative_coverage)
19
+ # 与 NEG_COVERAGE_MAX=3 一字不动
20
+ # 执行:python -X utf8 -m md_cg.test_neg_coverage_budget
21
+ # python -X utf8 -m md_cg.test_neg_coverage_budget --mutate=all
22
+ # python -X utf8 -m md_cg.test_neg_coverage_budget --mutate=neg-budget-revert
23
+ # 验证方式:本文件自跑(自带断言计数与退出码 rc=0/1);`--mutate` = **定点变异自证**
24
+ # ——把待验修复**在临时副本的源码文本上**逐点抽回改前语义(在役工作树只读、
25
+ # 字节不变,变异结束用 md5 复核「复原后哈希一致」),再以子进程实跑本守卫:
26
+ # 必须 rc=1 且打红**预期断言集合**;随后在役树原样复跑必须转绿(无残余)。
27
+ # 不适用条件:情感交互|闲聊|纯查询无改动;负覆盖条目在 MCP 结果面的**渲染**
28
+ # (`_node_view` 只透 id/path/frontmatter/content)不属本文件面内;
29
+ # search_rrf 路径不产负覆盖尾条目(无 negative_coverage 面),不在本文件面内。
30
+ import hashlib
31
+ import os
32
+ import re
33
+ import shutil
34
+ import subprocess
35
+ import sys
36
+ import tempfile
37
+
38
+ sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
39
+
40
+ from md_cg import mdcg as _mdcg # noqa: E402
41
+ from md_cg.mdcg import MdCG # noqa: E402
42
+ from md_cg.mdcos import MdCGOS # noqa: E402
43
+
44
+ PASS = 0
45
+ FAIL = 0
46
+ FAILS = []
47
+ _RUN = [0]
48
+ _SANDBOX = tempfile.mkdtemp(prefix="mdcg_neg_budget_")
49
+ _HERE = os.path.dirname(os.path.abspath(__file__))
50
+ _REPO = os.path.dirname(_HERE)
51
+
52
+ #: 复现用查询(题面现场:真实命中 2 条 + 负覆盖 3 条)
53
+ Q = "理论推理层 激活协议 四条规则 状态暴露 边界声明"
54
+ REAL_A = ("# 功能名:理论推理层激活协议\n"
55
+ "# 生效条件:理论推理层\n# 子功能:四条规则 状态暴露\n"
56
+ "# 执行:按四条规则暴露状态\n# 验证方式:test\n"
57
+ "# 不适用条件:无\n\n"
58
+ "理论推理层 激活协议 四条规则 状态暴露 边界声明\n")
59
+ REAL_B = ("# 功能名:推理层边界声明\n"
60
+ "# 生效条件:理论推理层\n# 子功能:激活协议 状态暴露\n"
61
+ "# 执行:核对边界声明\n# 验证方式:test\n"
62
+ "# 不适用条件:无\n\n"
63
+ "理论推理层 激活协议 四条规则 状态暴露\n")
64
+ #: 与本查询无词面/索引键交集的样本(T3 全量兜底里 score == 0 的候选)
65
+ FILLER = "# 功能名:无关样本%d\n# 正文:蜂群调度 节点 %d\n"
66
+
67
+
68
+ def check(name, cond, detail=""):
69
+ global PASS, FAIL
70
+ if cond:
71
+ PASS += 1
72
+ print(" OK %s" % name)
73
+ else:
74
+ FAIL += 1
75
+ FAILS.append(name)
76
+ print(" FAIL %s %s" % (name, detail))
77
+
78
+
79
+ def check_exc(name, fn):
80
+ """fn() → (cond, detail)。抛异常记为该断言失败(变异运行不得因崩溃丢红项读数)。"""
81
+ try:
82
+ cond, detail = fn()
83
+ except Exception as e: # noqa: BLE001
84
+ cond, detail = False, "EXC %s: %s" % (type(e).__name__, e)
85
+ check(name, cond, detail)
86
+
87
+
88
+ def _mk(tag, cls=MdCG):
89
+ return cls(os.path.join(_SANDBOX, "lib_%s_r%d" % (tag, _RUN[0])), autoflush=0)
90
+
91
+
92
+ def _neg_tail(res):
93
+ return [r for r in res if (r[2] or {}).get("negative_coverage")]
94
+
95
+
96
+ def _prim(res):
97
+ return [r for r in res if not (r[2] or {}).get("negative_coverage")]
98
+
99
+
100
+ def _repro_lib(tag):
101
+ """题面复现现场:2 条真实命中(含查询词)+ 3 条负覆盖(含查询词)。"""
102
+ cg = _mk(tag)
103
+ cg.add("real_a", REAL_A, layer="knowledge", verification_basis="test")
104
+ cg.add("real_b", REAL_B, layer="knowledge", verification_basis="test")
105
+ for j in range(3):
106
+ cg.add("rej_%d" % j,
107
+ "# 假设:%s 第 %d 号\n# 否决原因:与既有验证结论冲突\n" % (Q, j),
108
+ layer="rejected", verification_basis="test")
109
+ cg.flush()
110
+ return cg
111
+
112
+
113
+ def _empty_lib(tag, n=8):
114
+ """T3 全量兜底现场:正层全是**零分**候选(词面与查询无交集)+ 3 条负覆盖。
115
+
116
+ `len(scored) = n ≥ k` 而真实命中数 = 0——「提示填满 min(3,k)」与「len ≤ k」
117
+ 两条判据的判别力都在这个形态上(T2 LIKE 阶段无命中 → 走 T3 全量兜底)。
118
+ """
119
+ cg = _mk(tag)
120
+ for i in range(n):
121
+ cg.add("mem_%03d" % i, FILLER % (i, i), layer="knowledge")
122
+ for j in range(3):
123
+ cg.add("rej_%d" % j,
124
+ "# 假设:%s 第 %d 号\n# 否决原因:与既有验证结论冲突\n" % (Q, j),
125
+ layer="rejected", verification_basis="test")
126
+ cg.flush()
127
+ return cg
128
+
129
+
130
+ # ------------------------------------------------------------------ A 组((a))
131
+ def group_a():
132
+ print("\n[A] 缺陷复现与修复:k=1/2/3 时最高分真实命中必在返回里((a) 判据)")
133
+ cg = _repro_lib("repro")
134
+ # 对照基准:走**无负覆盖**的路径(include_neg=False → 不产提示条)取最高分真命中
135
+ ref, _mr = cg.search(Q, k=20, include_neg=False, record=False)
136
+ top_real = ref[0][0].get("id") if ref else None
137
+ real_ids = [r[0].get("id") for r in ref]
138
+ res8, meta8 = cg.search(Q, k=8, record=False)
139
+ check_exc("A1 前置复现:库内 ≥2 条真命中且负覆盖恰 3 条(题面现场)",
140
+ lambda: (len(real_ids) >= 2 and top_real
141
+ and len(meta8.get("covered_neg") or []) == 3,
142
+ "real=%s top=%s covered_neg=%s"
143
+ % (real_ids, top_real, meta8.get("covered_neg"))))
144
+ rows = {}
145
+ for k in (1, 2, 3):
146
+ rows[k] = cg.search(Q, k=k, record=False)
147
+ check_exc("A2 (a) k=1/2/3 时最高分真实命中必出现在返回里**且在首位**"
148
+ "(改前 k ≤ 提示数 → 主结果配额 0:k=2/3 全是 rej_*,读成「库里没有」)",
149
+ lambda: (all(rows[k][0] and rows[k][0][0][0].get("id") == top_real
150
+ for k in (1, 2, 3)),
151
+ "; ".join("k=%d → %s" % (k, [x[0].get("id")
152
+ for x in rows[k][0]])
153
+ for k in (1, 2, 3))))
154
+ check_exc("A2b (a) k=2/3 时**全部**真命中都在返回里(真命中数 2 ≤ k)",
155
+ lambda: (all(set(real_ids) <= {x[0].get("id") for x in rows[k][0]}
156
+ for k in (2, 3)),
157
+ "; ".join("k=%d → %s" % (k, [x[0].get("id")
158
+ for x in rows[k][0]])
159
+ for k in (2, 3))))
160
+ cg.close()
161
+
162
+
163
+ # ------------------------------------------------------------------ B 组((b)(c))
164
+ def group_b():
165
+ print("\n[B] k 预算:(b) 真命中用满 k 时不发提示、(c) 任何 k 下 len ≤ k")
166
+ cg = _repro_lib("budget")
167
+ ref, _mr = cg.search(Q, k=20, include_neg=False, record=False)
168
+ n_real = len(ref) # 该库真实命中数(题面:2)
169
+ check_exc("B0 前置:真实命中数 2(< k 时才有尾条目,= k 时提示必须让位)",
170
+ lambda: (n_real == 2, "n_real=%d" % n_real))
171
+
172
+ def _no_tail_when_full():
173
+ detail = []
174
+ ok = True
175
+ for k in range(1, n_real + 1):
176
+ r, m = cg.search(Q, k=k, record=False)
177
+ nt = len(_neg_tail(r))
178
+ b = m.get("k_budget")
179
+ detail.append("k=%d len=%d neg=%d k_budget=%s" % (k, len(r), nt, b))
180
+ if nt != 0 or b is not None:
181
+ ok = False
182
+ if len(_prim(r)) != min(k, n_real):
183
+ ok = False
184
+ return ok, "; ".join(detail)
185
+
186
+ check_exc("B1 (b) 真实命中数 ≥ k ⇒ 不发提示条(k=1/2 尾条为 0、"
187
+ "meta.k_budget 不落键——「产生信息才落键」),且主结果恰 min(k, 真命中数) 条",
188
+ _no_tail_when_full)
189
+
190
+ def _tail_budget():
191
+ detail = []
192
+ ok = True
193
+ # 真命中用满 k 后,余下的位子才给提示,且不超过 NEG_COVERAGE_MAX
194
+ for k in range(n_real, 9):
195
+ r, m = cg.search(Q, k=k, record=False)
196
+ nt = len(_neg_tail(r))
197
+ want = min(_mdcg.NEG_COVERAGE_MAX, max(0, k - n_real))
198
+ detail.append("k=%d neg=%d want=%d" % (k, nt, want))
199
+ if nt != want:
200
+ ok = False
201
+ return ok, "; ".join(detail)
202
+
203
+ check_exc("B2 k ≥ 真命中数时提示条数 = min(NEG_COVERAGE_MAX, k − 真命中数)"
204
+ "(k=2 → 0、k=3 → 1、k=5 → 3)", _tail_budget)
205
+
206
+ def _le_k():
207
+ detail = []
208
+ ok = True
209
+ for k in range(0, 9):
210
+ r, _m = cg.search(Q, k=k, record=False)
211
+ detail.append("k=%d len=%d" % (k, len(r)))
212
+ if len(r) > k:
213
+ ok = False
214
+ return ok, "; ".join(detail)
215
+
216
+ check_exc("B3 (c) 复现库:任何 k(含 k=0/1 边界)下 len(返回条目) ≤ k"
217
+ "(H10② 消除 k+3 超发的成果不回退)", _le_k)
218
+
219
+ def _le_k_scan():
220
+ e = _empty_lib("le_k")
221
+ detail = []
222
+ ok = True
223
+ for k in range(0, 9):
224
+ r, _m = e.search(Q, k=k, record=False)
225
+ detail.append("k=%d len=%d" % (k, len(r)))
226
+ if len(r) > k:
227
+ ok = False
228
+ e.close()
229
+ return ok, "; ".join(detail)
230
+
231
+ check_exc("B3b (c) T3 全量兜底现场(len(scored)=8 ≥ k 而真命中 0):"
232
+ "任何 k 下 len ≤ k(提示只能填 k 以内的位子)", _le_k_scan)
233
+ cg.close()
234
+
235
+
236
+ # ------------------------------------------------------------------ C 组((d))
237
+ def group_c():
238
+ print("\n[C] 信号不丢:(d) 无真命中时提示仍出现;提示为 0 时信号仍在统计/审计面")
239
+ e = _empty_lib("d_signal")
240
+
241
+ def _fill():
242
+ detail = []
243
+ ok = True
244
+ for k in (1, 2, 3, 5):
245
+ r, m = e.search(Q, k=k, record=False)
246
+ nt = len(_neg_tail(r))
247
+ want = min(_mdcg.NEG_COVERAGE_MAX, k)
248
+ detail.append("k=%d neg=%d want=%d len=%d" % (k, nt, want, len(r)))
249
+ # 提示条恰填 min(3,k);且主结果里**没有**真命中(本库真命中数为 0,
250
+ # 主结果里的零分候选(若有)不冒充命中——按分数如实为 0.0)
251
+ if nt != want or any(x[1] > 0 for x in _prim(r)):
252
+ ok = False
253
+ if nt and (m.get("k_budget") or {}).get("neg_tail") != nt:
254
+ ok = False
255
+ return ok, "; ".join(detail)
256
+
257
+ check_exc("C1 (d) 无真实命中 ⇒ 提示条填满 min(NEG_COVERAGE_MAX, k) 条"
258
+ "(k=1/2/3 → 1/2/3;k=5 → 3,不超发)", _fill)
259
+
260
+ def _tail_shape():
261
+ r, _m = e.search(Q, k=3, record=False)
262
+ nt = _neg_tail(r)
263
+ # 位置=尾部:提示全在末尾(最后一条是提示,且前面没有任何提示)
264
+ tail_only = bool(r) and bool((r[-1][2] or {}).get("negative_coverage")) \
265
+ and _neg_tail(r[:len(r) - len(nt)]) == []
266
+ # 只钉三项属性(哨兵分/位置/独立字段);总数由 B 组钉(避免同一条口径
267
+ # 在两个断言里重复,使定点变异的红项集合不可分辨)
268
+ return (len(nt) == 3
269
+ and all(x[1] == _mdcg.NEG_COVERAGE_SCORE == 0.0 for x in nt)
270
+ and all((x[0].get("negative_coverage") is True
271
+ and (x[2] or {}).get("negative_coverage") is True
272
+ and x[0].get("neg_layer") in ("rejected", "unresolved"))
273
+ for x in nt)
274
+ and tail_only,
275
+ "nt=%d r=%d scores=%s" % (len(nt), len(r), [x[1] for x in nt]))
276
+
277
+ check_exc("C2 提示三项既有属性不动:哨兵分 0.0 / 位置在尾部 / 负性走独立字段"
278
+ "negative_coverage(+ neg_layer)", _tail_shape)
279
+ e.close()
280
+
281
+ cg = _repro_lib("signal_audit")
282
+ r2, m2 = cg.search(Q, k=2, record=False) # 真命中用满 k → 零提示条
283
+ check_exc("C3 提示条为 0 时负覆盖信号仍从**既有**统计面读到:"
284
+ "meta.covered_neg 恒为全部被覆盖路径(无需新协议字段)",
285
+ lambda: (not _neg_tail(r2)
286
+ and len(m2.get("covered_neg") or []) == 3,
287
+ "neg=%d covered_neg=%s"
288
+ % (len(_neg_tail(r2)), m2.get("covered_neg"))))
289
+ os.environ["MDCG_RETRIEVAL_PIPELINE"] = "1"
290
+ os.environ["MDCG_GATE_S5_NEG"] = "1"
291
+ try:
292
+ _r3, m3 = cg.search(Q, k=2, record=False)
293
+ s5 = (m3.get("gates") or {}).get("s5") or {}
294
+ finally:
295
+ os.environ.pop("MDCG_RETRIEVAL_PIPELINE", None)
296
+ os.environ.pop("MDCG_GATE_S5_NEG", None)
297
+
298
+ def _s5():
299
+ return (int(s5.get("neg") or 0) == 3,
300
+ "gates.s5=%s" % s5)
301
+
302
+ check_exc("C4 门控开启时同一计数在既有审计面可达(gates.s5.neg == 覆盖数 3)"
303
+ "——两处既有面皆非本次新增", _s5)
304
+ cg.close()
305
+
306
+
307
+ # ------------------------------------------------------------------ D 组(单点)
308
+ def group_d():
309
+ print("\n[D] 单点与调用方:三处 result 面共用 `_emit` 内的这一处裁决")
310
+ src = open(os.path.join(_HERE, "mdcg.py"), encoding="utf-8").read()
311
+ check_exc("D1 `_neg_tail`/`_primary_slots` 在 mdcg.py 内各**恰 1 处**调用"
312
+ "(都在 `_emit` 内)——k 预算的裁决单点",
313
+ lambda: (src.count("self._neg_tail(") == 1
314
+ and src.count("self._primary_slots(") == 1,
315
+ "neg_tail=%d primary_slots=%d"
316
+ % (src.count("self._neg_tail("),
317
+ src.count("self._primary_slots("))))
318
+ check_exc("D2 生产路径(MdCGOS)不覆写 `_emit`/`_neg_tail`/`_primary_slots`"
319
+ "——基类与生产路径同口径,非各写一份",
320
+ lambda: (not any(n in MdCGOS.__dict__
321
+ for n in ("_emit", "_neg_tail", "_primary_slots")),
322
+ "os_dict=%s" % [n for n in ("_emit", "_neg_tail",
323
+ "_primary_slots")
324
+ if n in MdCGOS.__dict__]))
325
+
326
+ def _mcp_ops():
327
+ p = os.path.join(_HERE, "mcp_server.py")
328
+ s = open(p, encoding="utf-8").read()
329
+ out = {}
330
+ for op in ("route", "read"):
331
+ i = s.find('if op == "%s":' % op)
332
+ if i < 0:
333
+ out[op] = None
334
+ continue
335
+ j = s.find('\n if op == "', i + 1)
336
+ seg = s[i:j if j > 0 else len(s)]
337
+ out[op] = ("cg.search(" in seg)
338
+ return (out.get("route") is True and out.get("read") is True, str(out))
339
+
340
+ check_exc("D3 MCP 的 route/read 两处 result 面都经 `cg.search`(+ MCP search 同库层出口)"
341
+ "——故本次修复三处同时受益", _mcp_ops)
342
+
343
+
344
+ _GROUPS = (group_a, group_b, group_c, group_d)
345
+
346
+
347
+ def _run_all():
348
+ global PASS, FAIL, FAILS
349
+ _RUN[0] += 1
350
+ PASS, FAIL, FAILS = 0, 0, []
351
+ for g in _GROUPS:
352
+ g()
353
+ return PASS, list(FAILS)
354
+
355
+
356
+ # ------------------------------------------------------------- 定点变异(自证)
357
+ #: 每项 = (文件, 正则, 替换, 期望转红的断言 id, 说明)。正则在**临时副本**的源码文本上
358
+ #: 命中恰好 1 处(命中数 ≠1 视为变异未生效,直接判红),把该处修复抽回改前语义。
359
+ _MUTATIONS = {
360
+ "neg-budget-revert": (
361
+ "mdcg.py",
362
+ r"(?m)^\s*_neg_tail = self\._neg_tail\(neg_coverage, max\(0, int\(k\) - _n_real\)\)\s*$",
363
+ " _neg_tail = self._neg_tail(neg_coverage, k)",
364
+ ["A2", "A2b", "B1", "B2", "C3"],
365
+ "提示条数上界退回 min(NEG_COVERAGE_MAX, k)(改前:提示先占满 k,真命中归零)"),
366
+ "primary-slots-no-budget": (
367
+ "mdcg.py",
368
+ r"(?m)^\s*return max\(0, int\(k\) - int\(n_tail\)\)\s*$",
369
+ " return max(0, int(k))",
370
+ ["B3b"],
371
+ "主结果退回 scored[:k](尾巴在 k 之外 → len > k)"),
372
+ "neg-tail-never": (
373
+ "mdcg.py",
374
+ r"(?m)^\s*_n_real = min\(max\(0, int\(k\)\), sum\(1 for _, s in scored if s > 0\)\)\s*$",
375
+ " _n_real = max(0, int(k))",
376
+ ["B2", "C1", "C2"],
377
+ "真实命中数恒取 k(提示条恒不出现——负覆盖信号静默失传)"),
378
+ }
379
+
380
+ _ASSERT_RE = re.compile(r"^\s*(?:\[FAIL\]|FAIL)\s+(\S+)")
381
+
382
+
383
+ def _reds(stdout):
384
+ out = []
385
+ for line in (stdout or "").splitlines():
386
+ m = _ASSERT_RE.match(line)
387
+ if m:
388
+ out.append(m.group(1))
389
+ return out
390
+
391
+
392
+ def _md5(path):
393
+ with open(path, "rb") as f:
394
+ return hashlib.md5(f.read()).hexdigest()
395
+
396
+
397
+ def _run_guard(cwd):
398
+ env = dict(os.environ)
399
+ env["PYTHONUTF8"] = "1"
400
+ env["PYTHONPATH"] = cwd
401
+ return subprocess.run(
402
+ [sys.executable, "-X", "utf8", "-m", "md_cg.test_neg_coverage_budget"],
403
+ cwd=cwd, env=env, capture_output=True, text=True,
404
+ encoding="utf-8", errors="replace")
405
+
406
+
407
+ def _mutate_mode(which):
408
+ names = list(_MUTATIONS) if which == "all" else [which]
409
+ for n in names:
410
+ if n not in _MUTATIONS:
411
+ print("未知变异 %r(可选:%s)" % (n, sorted(_MUTATIONS)))
412
+ return 2
413
+ files = sorted({_MUTATIONS[n][0] for n in names})
414
+ before = {f: _md5(os.path.join(_HERE, f)) for f in files}
415
+ rc = 0
416
+ print("\n=== 定点变异自证(在**临时副本**源码上抽掉修复 → 本守卫必红 → "
417
+ "在役树复跑必绿)===")
418
+ print(" 基准在役树:%s" % ", ".join("%s=%s" % (f, before[f]) for f in files))
419
+ for name in names:
420
+ fname, pat, sub, want, note = _MUTATIONS[name]
421
+ tmp = tempfile.mkdtemp(prefix="neg_budget_mut_")
422
+ try:
423
+ shutil.copytree(_HERE, os.path.join(tmp, "md_cg"),
424
+ ignore=shutil.ignore_patterns("__pycache__"))
425
+ path = os.path.join(tmp, "md_cg", fname)
426
+ with open(path, encoding="utf-8") as f:
427
+ src = f.read()
428
+ hits = len(re.findall(pat, src))
429
+ if hits != 1:
430
+ print(" FAIL 变异 %s 未生效:源码命中 %d 处(期望 1)" % (name, hits))
431
+ rc = 1
432
+ continue
433
+ with open(path, "w", encoding="utf-8", newline="") as f:
434
+ f.write(re.sub(pat, sub, src, count=1))
435
+ r = _run_guard(tmp)
436
+ reds = _reds(r.stdout)
437
+ missed = [w for w in want if w not in reds]
438
+ extra = [x for x in reds if x not in want]
439
+ summary = [l for l in (r.stdout or "").splitlines()
440
+ if l.startswith("====")]
441
+ print(" [%s] %s" % (name, note))
442
+ print(" 基准副本 %s(抽掉修复的那份)" % path)
443
+ print(" rc=%d 红项 %d 个:%s" % (r.returncode, len(reds),
444
+ " ".join(reds) or "(无)"))
445
+ print(" %s" % (summary[-1] if summary else "(无汇总行)"))
446
+ if r.returncode != 1 or not reds:
447
+ print(" FAIL 变异 %s 未打红(rc=%d,红项 0)——守卫对该修复无判别力"
448
+ % (name, r.returncode))
449
+ print(" stderr: %s" % (r.stderr or "")[-400:])
450
+ rc = 1
451
+ elif missed or extra:
452
+ print(" FAIL 变异 %s 命中集合不符:未打中 %s;连带红项 %s"
453
+ % (name, missed or "(无)", extra or "(无)"))
454
+ rc = 1
455
+ else:
456
+ print(" ok 变异 %s 恰好打中预期断言 %d 项、零连带" % (name, len(want)))
457
+ finally:
458
+ shutil.rmtree(tmp, ignore_errors=True)
459
+ after = {f: _md5(os.path.join(_HERE, f)) for f in files}
460
+ if before != after:
461
+ print(" FAIL 在役源码 md5 与基准不同——本驱动不写在役树,"
462
+ "若确有差异即为**并发改动**落在同一工作树。")
463
+ rc = 1
464
+ else:
465
+ print(" ok 复原核对:变异只在临时副本内(已 rmtree),在役树字节不变、"
466
+ "哈希一致:%s" % ", ".join("%s=%s" % (f, after[f]) for f in files))
467
+ r0 = _run_guard(_REPO)
468
+ reds0 = _reds(r0.stdout)
469
+ tail0 = [l for l in (r0.stdout or "").splitlines() if l.startswith("====")]
470
+ print(" [恢复] 在役树原样复跑:rc=%d 红项=%d %s"
471
+ % (r0.returncode, len(reds0), tail0[-1] if tail0 else ""))
472
+ if r0.returncode != 0 or reds0:
473
+ print(" FAIL 恢复后未转绿,残余红项:%s" % (reds0 or "rc≠0"))
474
+ rc = 1
475
+ else:
476
+ print(" ok 无残余红项")
477
+ return rc
478
+
479
+
480
+ def main(argv):
481
+ which = None
482
+ for a in argv:
483
+ if a.startswith("--mutate"):
484
+ which = a.split("=", 1)[1] if "=" in a else "all"
485
+ if which is not None:
486
+ return _mutate_mode(which)
487
+ ok, bad = _run_all()
488
+ print("\n==== k 预算分配守卫(H10 修订):%d 通过 / %d 失败%s ===="
489
+ % (ok, len(bad), (":" + "; ".join(bad)) if bad else ""))
490
+ return 1 if bad else 0
491
+
492
+
493
+ if __name__ == "__main__":
494
+ if hasattr(sys.stdout, "reconfigure"):
495
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
496
+ try:
497
+ _rc = main(sys.argv[1:])
498
+ finally:
499
+ shutil.rmtree(_SANDBOX, ignore_errors=True)
500
+ sys.exit(_rc)
@@ -14,6 +14,11 @@
14
14
  # A 负覆盖尾诚实化:①分数=哨兵 0.0 + 负性走独立字段(不再冒充 1.0 候选)
15
15
  # ②条数计入 k 预算(len(results) ≤ k,含 k=0/1 边界)④位置在尾部、真 id 走
16
16
  # `node_id` 字段(`id` 仍是落盘路径——既有消费者口径一字不动)
17
+ # + H10 修订(2026-10-07,缺陷:k ≤ 提示数时真实命中归零):**真实命中优先**
18
+ # ——提示条数=min(NEG_COVERAGE_MAX, max(0, k − 真实命中数)),不是 min(3, k)。
19
+ # 故 A 组的尾断言改在 **k=5**(3 真命中 + 2 尾条正好用满 k)取样;A5 除
20
+ # 「总数 ≤ k / k_budget 逐位一致」外,钉住「主结果条数=min(k, 真实命中数)」
21
+ # (改前 k=2/3 时为 0——本组对旧口径的判别力所在)。
17
22
  # B `_compute_d` 分母只数真实候选(提示条目不进分母,D 不再被虚高)
18
23
  # C 基类与生产路径同口径:负记忆/目标槽不进正排,同一负节点不再双列
19
24
  # (负层元组真源单点:mdcos 直接导入 mdcg.NEG_ROUTE_LAYERS,不留同值副本)
@@ -34,6 +39,7 @@
34
39
  # FixReport 的 gaps);负覆盖条目在 MCP 结果面的呈现(`_node_view` 只透
35
40
  # id/path/frontmatter/content)不在本文件面内,属调用方渲染层。
36
41
  import hashlib
42
+ import ast
37
43
  import inspect
38
44
  import os
39
45
  import re
@@ -136,7 +142,9 @@ def _count_calls(obj, name, fn):
136
142
  def group_a():
137
143
  print("\n[A] 负覆盖尾诚实化:分数哨兵 / 独立字段 / k 预算 / 位置")
138
144
  cg = _neg_lib("tail")
139
- res, meta = cg.search(QUERY, k=3, record=False)
145
+ # k=5:本库 3 条真实命中(_neg_lib 的 mem_*)< 5 → 尾条按 k 预算出现
146
+ # (H10 修订后 k=3 时 3 条真命中已用满 k,尾条为 0——见 A5 的新契约断言)。
147
+ res, meta = cg.search(QUERY, k=5, record=False)
140
148
  tail = [r for r in res if (r[2] or {}).get("negative_coverage")]
141
149
  prim = [r for r in res if not (r[2] or {}).get("negative_coverage")]
142
150
  check("A1 负覆盖条目不冒充候选:分数恒字面量 0.0(哨兵常量本身也是 0.0),"
@@ -167,7 +175,11 @@ def group_a():
167
175
  str([(r[0].get("id"), (r[2] or {}).get("negative_coverage"))
168
176
  for r in res]))
169
177
 
170
- print("\n[A'] k 预算:总数恒 ≤ k(改前 k=3 → 5)")
178
+ print("\n[A'] k 预算:真实命中优先 + 总数恒 ≤ k"
179
+ "(H10 修订:改前 k=2/3 真实命中归零)")
180
+ #: 本库的真实命中数:`_neg_lib` 的 3 条 mem_*(含查询词)过质量闸(score > 0);
181
+ #: 负层节点不进正排(另 2 条)。改前提示按 min(3, k) 先占位 → k ≤ 3 时主结果为 0。
182
+ n_real = 3
171
183
  ok_len = True
172
184
  detail = []
173
185
  for k in (1, 2, 3, 5, 20):
@@ -176,9 +188,18 @@ def group_a():
176
188
  np = len(r) - nt
177
189
  b = m.get("k_budget") or {}
178
190
  detail.append("k=%d len=%d prim=%d neg=%d budget=%s" % (k, len(r), np, nt, b))
179
- if len(r) > k or b != {"k": k, "primary": np, "neg_tail": nt}:
191
+ if len(r) > k:
180
192
  ok_len = False
181
- check("A5 结果总数 ≤ k 且 meta.k_budget 与实取逐位一致(尾巴计入预算)",
193
+ # 真实命中永不被提示挤占:主结果恰为 min(k, 真实命中数) 条(改前 k≤3 → 0)
194
+ if np != min(k, n_real):
195
+ ok_len = False
196
+ # 「产生信息才落键」:有尾条时 k_budget 与实取逐位一致,无尾条时不落键
197
+ if nt and b != {"k": k, "primary": np, "neg_tail": nt}:
198
+ ok_len = False
199
+ if not nt and "k_budget" in m:
200
+ ok_len = False
201
+ check("A5 结果总数 ≤ k、主结果条数=min(k, 真实命中数)(真实命中不被提示挤占)、"
202
+ "且 meta.k_budget 与实取逐位一致(尾巴计入预算)",
182
203
  ok_len, "; ".join(detail))
183
204
  check("A6 主结果实取 = k − 提示条数(_primary_slots 单点)",
184
205
  _mdcg.MdCG._primary_slots(3, 2) == 1
@@ -192,7 +213,7 @@ def group_a():
192
213
  r0 == [] and "k_budget" not in m0, str(r0))
193
214
 
194
215
  print("\n[A''] 审计面与卡片同源")
195
- res3, meta3 = cg.search(QUERY, k=3, record=False)
216
+ res3, meta3 = cg.search(QUERY, k=5, record=False)
196
217
  rows = meta3.get("neg_coverage_tail") or []
197
218
  cards = [r for r in res3 if (r[2] or {}).get("negative_coverage")]
198
219
  check("A8 meta.neg_coverage_tail 与入榜条目逐条同源(含 node_id/score=0.0)",
@@ -276,9 +297,43 @@ def group_c():
276
297
  # ---- 真源单点(2026-09-30 补强):生产路径不留同值字面量副本 ----
277
298
  # mdcos._candidates 旧写作裸元组 ("rejected","unresolved","goals")——与 mdcg 的
278
299
  # NEG_ROUTE_LAYERS 同值异构:改一处漏一处,正是 C 组「同口径」要防的漂移。
279
- check("C6 生产路径(mdcos)不留负层元组字面量副本",
280
- '("rejected", "unresolved", "goals")' not in inspect.getsource(mdcos),
281
- "mdcos.py 仍有字面量副本")
300
+ #
301
+ # issue #213 Q4(2026-10-13 DSH 端):原 C6 是**否定**断言——「字面量不在
302
+ # 源码里」。该字面量在 HEAD 上**已不存在**(实测 0 处),故它**已恒真**:
303
+ # 无论后续怎么改都不会再转红,对未来的漂移**没有区分力**;且只认一种拼法,
304
+ # 换个引号 / 空白 / 换成 list 都能绕过。
305
+ # 按 Q4 的建议改建为**正向**断言:真源必须被**真的读到**——若有人把
306
+ # _candidates 里的 NEG_ROUTE_LAYERS 换回字面量,本断言立刻转红。
307
+ # 负向面同时**加宽**为跨引号/空白形态的正则(补回原断言的覆盖意图)。
308
+ # 判据走 **AST**,不用「源码里有这个字符串」——后者会被**注释**满足:
309
+ # _candidates 内本就有一条注释写着「真源 mdcg.NEG_ROUTE_LAYERS」(实测:
310
+ # 把代码里的引用换成字面量后,字符串判据仍为真 ⇒ 无判别力)。
311
+ # AST 只看**名字引用**,注释与字符串一律不计。
312
+ # 直接走源码文件里那个 ClassDef/FunctionDef 节点——不经 getsource + 反缩进,
313
+ # 免得为了去掉类内缩进引入文本处理(文本处理会把判据绑到缩进形态上)。
314
+ _cand_node = None
315
+ _mdcos_py = os.path.join(os.path.dirname(os.path.abspath(mdcos.__file__)),
316
+ "mdcos.py")
317
+ with open(_mdcos_py, encoding="utf-8") as _fh:
318
+ _tree = ast.parse(_fh.read())
319
+ for _c in _tree.body:
320
+ if isinstance(_c, ast.ClassDef) and _c.name == "MdCGOS":
321
+ for _f in _c.body:
322
+ if isinstance(_f, ast.FunctionDef) and _f.name == "_candidates":
323
+ _cand_node = _f
324
+ check("C6 前置:在 mdcos.py 的 MdCGOS 里找到 _candidates 定义",
325
+ _cand_node is not None)
326
+ _cand_names = ({n.id for n in ast.walk(_cand_node)
327
+ if isinstance(n, ast.Name)} if _cand_node else set())
328
+ check("C6 _candidates 真的读真源 NEG_ROUTE_LAYERS(AST 正向断言)",
329
+ "NEG_ROUTE_LAYERS" in _cand_names,
330
+ "mdcos.MdCGOS._candidates 未按名字引用 NEG_ROUTE_LAYERS(实际引用:%s)"
331
+ % sorted(_cand_names)[:8])
332
+ check("C6b mdcos 源码不留三名负层字面量(任何引号/空白形态)",
333
+ not re.search(r"""[([\s]*['"]rejected['"]\s*,\s*['"]unresolved['"]"""
334
+ r"""\s*,\s*['"]goals['"]\s*[)\]]""",
335
+ inspect.getsource(mdcos)),
336
+ "mdcos.py 仍有负层三元组字面量副本")
282
337
  check("C7 MdCGOS 与基类共用同一常量对象(导入非同值重写)",
283
338
  mdcos.NEG_ROUTE_LAYERS is _mdcg.NEG_ROUTE_LAYERS,
284
339
  "%r vs %r" % (mdcos.NEG_ROUTE_LAYERS, _mdcg.NEG_ROUTE_LAYERS))
@@ -528,6 +583,14 @@ def _pre_fix_k_budget():
528
583
  _mdcg.MdCG._primary_slots = staticmethod(lambda k, n_tail: int(k))
529
584
 
530
585
 
586
+ def _pre_fix_neg_budget():
587
+ """改前口径:提示条数上界恒为 min(NEG_COVERAGE_MAX, |覆盖|),不看 k 预算
588
+ (H10 修订前)——k ≤ 提示数时真实命中被挤成 0(本组 A5 的判别力所在)。"""
589
+ _orig = _mdcg.MdCG.__dict__["_neg_tail"]
590
+ _mdcg.MdCG._neg_tail = lambda self, neg_coverage, budget: _orig(
591
+ self, neg_coverage, _mdcg.NEG_COVERAGE_MAX)
592
+
593
+
531
594
  def _pre_fix_d_denom():
532
595
  _mdcg._is_neg_coverage = lambda card: False # 改动前:分母含提示条目
533
596
 
@@ -561,7 +624,12 @@ def _pre_fix_health_total():
561
624
 
562
625
  _MUTATIONS = {
563
626
  "neg_score": (_pre_fix_neg_score, ["A1", "A8"]),
564
- "k_budget": (_pre_fix_k_budget, ["A5", "A6"]),
627
+ # k_budget:主结果退回 scored[:k](尾巴在 k 之外)——A6 钉公式;本库 scored
628
+ # 短于 k(3 条真命中)故 A5 的「≤ k」不再被它打红,溢出判别力归新守卫
629
+ # md_cg/test_neg_coverage_budget.py 的 T3 全量兜底场景(scored ≥ k 且真命中 < k)。
630
+ "k_budget": (_pre_fix_k_budget, ["A6"]),
631
+ # neg_budget:把 H10 修订抽回改前口径(提示按 min(3,·) 先占位)——A5 必红
632
+ "neg_budget": (_pre_fix_neg_budget, ["A5"]),
565
633
  "d_denom": (_pre_fix_d_denom, ["B1"]),
566
634
  "base_dup": (_pre_fix_base_dup, ["C1", "C2", "C4", "C5"]),
567
635
  "sentinel": (_pre_fix_sentinel, ["E1", "E2"]),
@@ -578,6 +646,7 @@ def _snapshot():
578
646
  # 实测踩过(`_primary_slots() takes 2 positional arguments but 3 were given`)。
579
647
  return {"NEG_COVERAGE_SCORE": _mdcg.NEG_COVERAGE_SCORE,
580
648
  "_primary_slots": _mdcg.MdCG.__dict__["_primary_slots"],
649
+ "_neg_tail": _mdcg.MdCG.__dict__["_neg_tail"],
581
650
  "_is_neg_coverage": _mdcg._is_neg_coverage,
582
651
  "NEG_ROUTE_LAYERS": _mdcg.NEG_ROUTE_LAYERS,
583
652
  "_is_null_condition": mdcos._is_null_condition,
@@ -590,6 +659,7 @@ def _snapshot():
590
659
  def _restore(snap):
591
660
  _mdcg.NEG_COVERAGE_SCORE = snap["NEG_COVERAGE_SCORE"]
592
661
  _mdcg.MdCG._primary_slots = snap["_primary_slots"]
662
+ _mdcg.MdCG._neg_tail = snap["_neg_tail"]
593
663
  _mdcg._is_neg_coverage = snap["_is_neg_coverage"]
594
664
  _mdcg.NEG_ROUTE_LAYERS = snap["NEG_ROUTE_LAYERS"]
595
665
  mdcos._is_null_condition = snap["_is_null_condition"]