@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,774 +1,781 @@
1
- # -*- coding: utf-8 -*-
2
- """P4 守卫 · 权重刷新与衰减进主分数(§7.1–§7.4)。
3
-
4
- 覆盖判据(每条对应契约的一项):
5
-
6
- G1 **核来自唯一权威**:`md_cg/whitebox_kb/aeis_core/time_core.py`——本模块
7
- 源码**不含指数核调用**,且 `decay_factor` 与 `cred_factor` 在 6 个 dt 上
8
- **逐位相等**(含 inf → floor)。
9
- G2 **γ 与 Δt 口径**(§〇.3-12):γ 缺省 `ln2/30 天`、与 `mdcos.temporal_gamma`
10
- **同一读取点**(env `MDCG_TEMPORAL_GAMMA` 同时覆盖两条路);Δt 取
11
- `created_at`;**单位必须是「天」**——30 天 → 0.5,若按秒喂同一时长则触 floor
12
- (单位断言的**判别力**)。
13
- G3 **refresh 参数照抄 AEIS**:与 `aeis_core/core.py` 的 `consolidate_cycle`
14
- 既有取值逐条相等(源码对拍 + 行为三档 1.01 / 0.99 / 1.0)。
15
- G4 **衰减必加 floor**(§7.3):老节点/缺 created_at 不低于 `SCORE_FLOOR`;
16
- **受保护节点** `importance × 乘子 ≥ IMPORTANCE_PROTECT` 恒成立;判别力
17
- (未保护节点不享有该下界)。
18
- G5 **落位 = 与分池权重同一乘子位**(§7.2):源码断言乘子行紧邻
19
- `pooling.weight_of(...)` 行;行为断言 `_score` 的同内容两节点分数比
20
- == 乘子比。
21
- G6 **索引条目取数**(P4-2①):条目含 `access_count`/`last_access`;
22
- `freshness.entry_weight` 只凭条目即可算(无 IO 面)。
23
- G7 **开关可回退**:`MDCG_FRESHNESS=0` → 乘子恒 1.0,`_score` 与基线逐位一致。
24
- G8 **三件套**(§7.4):预演零写盘;apply 逐节点 before/after 落
25
- `_maintain.jsonl`(`action="freshness"`,与 `importance` 同族);
26
- rollback 写回 before 且**不删节点**。
27
- G9 **降级不得实现为删除记录**(§7.3):降级只写 `freshness_state="degraded"`,
28
- 节点与正文原样在库;跨层降级走既有 `_move_layer`(内含 `guard_move`)
29
- ——受保护节点被移出保护层抛 `ProtectionError` 且无副作用。
30
- G10 `weights.recalc` 的「`after ≥ 0.70` 自动补写 `protected`」行为**仍在位**。
31
- G11 **Rust 侧同口径**:`rust/src/freshness.rs` 的四个常量与 Python 同值;
32
- 乘子只在 `sort_path(..., apply_freshness=true)` 生效且 `fuse` 只对
33
- lexical 传 true(与 Python `_score` 的对位面一致)。
34
-
35
- 运行:
36
- python -X utf8 -m md_cg.test_p4_freshness
37
- python -X utf8 -m md_cg.test_p4_freshness --mutate
38
- python -X utf8 -m md_cg.test_p4_freshness --mutate --list
39
-
40
- 退出码:0 = 全绿;1 = 有失败 / 变异未按预期转红;2 = ANCHOR-MISS。
41
-
42
- 硬边界:库根一律 tempfile;不动在役数据根;不 git add/commit/push。
43
- """
44
- from __future__ import annotations
45
-
46
- import hashlib
47
- import json
48
- import math
49
- import os
50
- import re
51
- import sys
52
- import tempfile
53
-
54
- # ── 隔离前置(必须在 import md_cg 子模块之前)──
55
- _TMP0 = tempfile.mkdtemp(prefix="p4_fresh_")
56
- os.environ["MDCG_AUX_ROOT"] = os.path.join(_TMP0, "auxroot")
57
- os.environ["MDCG_MASTER_KEY"] = "12" * 32
58
- os.environ["MDCG_TOKEN_FILE"] = os.path.join(_TMP0, "tokens.json")
59
- os.environ["MDCG_ROOT"] = os.path.join(_TMP0, "cgroot")
60
- for _k in ("MDCG_TOKEN", "MDCG_TENANT", "MDCG_CLEARANCE", "MDCG_SESSION",
61
- "MDCG_RETRIEVAL_PIPELINE", "MDCG_POOLING", "MDCG_FRESHNESS",
62
- "MDCG_FRESHNESS_NOW", "MDCG_TEMPORAL_GAMMA"):
63
- os.environ.pop(_k, None)
64
-
65
- _HERE = os.path.dirname(os.path.abspath(__file__))
66
- _REPO = os.path.dirname(_HERE)
67
- sys.path.insert(0, _REPO)
68
-
69
- try:
70
- sys.stdout.reconfigure(encoding="utf-8", errors="replace")
71
- except AttributeError:
72
- pass
73
-
74
- from md_cg import freshness as F # noqa: E402
75
- from md_cg import mdcg as M # noqa: E402
76
- from md_cg import nodefile # noqa: E402
77
- from md_cg import weights as W # noqa: E402
78
- from md_cg.mdcos import MdCGOS # noqa: E402
79
- from md_cg.whitebox_kb.aeis_core import time_core as TC # noqa: E402
80
-
81
- REF = 1_800_000_000.0
82
- DAY = 86400.0
83
-
84
- PASS = 0
85
- FAIL = 0
86
- FAILS = []
87
-
88
-
89
- def check(name, cond, detail=""):
90
- global PASS, FAIL
91
- if cond:
92
- PASS += 1
93
- print(f" OK {name}")
94
- else:
95
- FAIL += 1
96
- FAILS.append(name)
97
- print(f" FAIL {name} {detail}")
98
- return bool(cond)
99
-
100
-
101
- BODY = ("# 功能名:{n}\n# 生效条件:无条件\n# 子功能:无\n# 执行:占位\n"
102
- "# 验证方式:compiler 复现\n# 不适用条件:其它会话\n\n{t}\n")
103
-
104
-
105
- def _mk(cg, nid, layer="knowledge", **kw):
106
- cg.add(nid, BODY.format(n=nid, t=f"{nid} 正文 苹果 章节"), layer=layer, **kw)
107
-
108
-
109
- def _lib(extra=None):
110
- root = tempfile.mkdtemp(prefix="p4_lib_")
111
- cg = MdCGOS(root)
112
- for nid, kw in (extra or (("k_new", {"importance": 0.5,
113
- "created_at": REF}),
114
- ("k_old", {"importance": 0.5,
115
- "created_at": REF - 300 * DAY}))):
116
- _mk(cg, nid, **kw)
117
- cg.flush()
118
- return root, cg
119
-
120
-
121
- def _src(rel):
122
- with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
123
- return f.read()
124
-
125
-
126
- def _tree_hash(root):
127
- h = hashlib.sha256()
128
- for dirpath, dirs, files in os.walk(root):
129
- dirs[:] = sorted(d for d in dirs if not d.startswith("_"))
130
- for fn in sorted(files):
131
- if fn.startswith("_"):
132
- continue
133
- p = os.path.join(dirpath, fn)
134
- h.update(os.path.relpath(p, root).replace("\\", "/").encode())
135
- with open(p, "rb") as f:
136
- h.update(f.read())
137
- return h.hexdigest()[:16]
138
-
139
-
140
- def _score_pair(cg, q="苹果 章节", protected=False):
141
- docs = []
142
- for nid, created, ac in (("k_new", REF, 0), ("k_old", REF - 300 * DAY, 0)):
143
- docs.append(({"path": f"knowledge/{nid}.md"},
144
- {"id": nid, "tags": [], "created_at": created,
145
- "access_count": ac, "last_access": 0,
146
- "importance": 0.5, "protected": protected},
147
- BODY.format(n=nid, t=f"{nid} 正文 苹果 章节")))
148
- return cg._score(docs, q, M.bigrams(M.normalize_en(q)))
149
-
150
-
151
- def g1_core_authority():
152
- print("== G1 核来自唯一权威 time_core(本模块无自写指数核)==")
153
- sc = F.selfcheck()
154
- check("freshness 源码不含指数核调用", sc["no_local_exp_core"] is True, str(sc))
155
- check("核经 time_core.cred_factor", sc["uses_cred_factor"] is True)
156
- g = F.resolve_gamma()
157
- ok = True
158
- detail = []
159
- for dt in (0.0, 1.0, 7.0, 30.0, 300.0, float("inf")):
160
- a = F.decay_factor(g, dt)
161
- b = TC.cred_factor(g, dt, F.SCORE_FLOOR, F.SCORE_CEIL)
162
- if a != b:
163
- ok = False
164
- detail.append((dt, a))
165
- check("decay_factor ≡ time_core.cred_factor(6 个 dt 逐位相等)", ok, str(detail))
166
-
167
-
168
- def g2_gamma_and_unit():
169
- print("== G2 γ 与 Δt 口径 / 单位必须是「天」==")
170
- from md_cg.mdcos import temporal_gamma
171
- from md_cg.links import DECAY_DAYS
172
- check("γ 缺省 = ln2/30 天",
173
- abs(F.resolve_gamma() - math.log(2.0) / 30.0) < 1e-15,
174
- str(F.resolve_gamma()))
175
- check("γ 与 mdcos.temporal_gamma **同一读取点**(缺省同值)",
176
- F.resolve_gamma() == temporal_gamma())
177
- check("半衰期真源 links.DECAY_DAYS == 30", DECAY_DAYS == 30.0)
178
- os.environ["MDCG_TEMPORAL_GAMMA"] = "0.5"
179
- try:
180
- check("env MDCG_TEMPORAL_GAMMA 同时覆盖两条路",
181
- F.resolve_gamma() == 0.5 and temporal_gamma() == 0.5)
182
- finally:
183
- os.environ.pop("MDCG_TEMPORAL_GAMMA", None)
184
- os.environ["MDCG_TEMPORAL_GAMMA"] = "abc"
185
- try:
186
- check("非法 γ 回落缺省(不抛)",
187
- abs(F.resolve_gamma() - math.log(2.0) / 30.0) < 1e-15)
188
- finally:
189
- os.environ.pop("MDCG_TEMPORAL_GAMMA", None)
190
- g = F.resolve_gamma()
191
- check("单位断言(天):30 天 → 0.5", abs(F.decay_factor(g, 30.0) - 0.5) < 1e-12,
192
- str(F.decay_factor(g, 30.0)))
193
- check("判别力:同一时长按**秒**喂 → 触 floor(喂秒会快 86400 倍)",
194
- F.decay_factor(g, 30.0 * DAY) == F.SCORE_FLOOR,
195
- str(F.decay_factor(g, 30.0 * DAY)))
196
- check("Δt 取 created_at(entry_weight 用 created_at 算天数)",
197
- F.entry_weight({"created_at": REF - 30 * DAY, "importance": 0.5},
198
- now=REF)[0] == F.decay_factor(g, 30.0))
199
- # 粒度=整日(向下取整):同为「1.x 天」的节点与「1 天」同值;「0.x 天」不衰减
200
- check("粒度断言:Δt 取整日(1.5 天 ≡ 1 天)",
201
- F.entry_weight({"created_at": REF - 1.5 * DAY, "importance": 0.5},
202
- now=REF)[0] == F.decay_factor(g, 1.0))
203
- check("粒度断言:当日写入(0.9 天)不衰减",
204
- F.entry_weight({"created_at": REF - 0.9 * DAY, "importance": 0.5},
205
- now=REF)[0] == F.decay_factor(g, 0.0))
206
- check("可复算:同一 (created_at, 日) 上两轮乘子逐位一致",
207
- F.entry_weight({"created_at": REF - 3 * DAY - 100, "importance": 0.5},
208
- now=REF)[0]
209
- == F.entry_weight({"created_at": REF - 3 * DAY - 100,
210
- "importance": 0.5}, now=REF + 10.0)[0])
211
-
212
-
213
- def g3_refresh_params():
214
- print("== G3 refresh 参数照抄 AEIS consolidate_cycle ==")
215
- src = _src(os.path.join("md_cg", "whitebox_kb", "aeis_core", "core.py"))
216
- check("AEIS 源码含 rehearsal_threshold = 0.7",
217
- re.search(r"rehearsal_threshold\s*:\s*float\s*=\s*0\.7", src)
218
- is not None)
219
- check("AEIS 源码含 degrade_threshold = 0.2",
220
- re.search(r"degrade_threshold\s*:\s*float\s*=\s*0\.2", src)
221
- is not None)
222
- check("AEIS 源码含 gain = 0.01",
223
- re.search(r"gain\s*:\s*float\s*=\s*0\.01", src) is not None)
224
- check("AEIS 源码的降权是 −gain(同一档语义)",
225
- re.search(r"update_node_importance\(n\.id,\s*-gain\)", src)
226
- is not None)
227
- check("AEIS 源码含 `% 10 == 0` 档",
228
- re.search(r"%\s*10\s*==\s*0", src) is not None)
229
- p = F.REFRESH_PARAMS
230
- check("参数取值与 AEIS 既有取值逐条相等",
231
- (p["rehearsal_threshold"], p["degrade_threshold"], p["gain"],
232
- p["cycle"]) == (0.7, 0.2, 0.01, 10), str(p))
233
- check("参数出处写在 paramsSource(REFRESH_PARAMS.source)",
234
- "consolidate_cycle" in p["source"] and "core.py" in p["source"],
235
- p["source"])
236
- check("行为档①演练:+gain", abs(F.refresh_factor(40, 1.0, 0.8) - 1.01) < 1e-12)
237
- check("行为档②降权:−gain", abs(F.refresh_factor(1, 1.0, 0.1) - 0.99) < 1e-12)
238
- check("行为档③其余:1.0", F.refresh_factor(3, 1.0, 0.5) == 1.0)
239
- check("从未访问不得白拿刷新(last_access=0 ⇒ 1.0)",
240
- F.refresh_factor(0, 0, 0.9) == 1.0)
241
-
242
-
243
- def g4_floor():
244
- print("== G4 衰减必加 floor / 保护线不被穿过 ==")
245
- g = F.resolve_gamma()
246
- check("老节点 ≥ SCORE_FLOOR",
247
- F.decay_factor(g, 10000.0) >= F.SCORE_FLOOR)
248
- check("缺 created_at 的节点仍带非零分(不乘成 0)",
249
- F.entry_weight({"created_at": 0, "importance": 0.5})[0] > 0.0,
250
- str(F.entry_weight({"created_at": 0, "importance": 0.5})[0]))
251
- check("缺 created_at 的衰减项触 floor(decay 本身 = SCORE_FLOOR)",
252
- F.decay_factor(g, float("inf")) == F.SCORE_FLOOR)
253
- for imp in (0.70, 0.8, 0.95, 1.0):
254
- w = F.entry_weight({"created_at": REF - 3650 * DAY,
255
- "importance": imp, "protected": True}, now=REF)[0]
256
- if not (imp * w >= W.IMPORTANCE_PROTECT):
257
- check(f"受保护节点 importance={imp} 乘子不穿保护线", False,
258
- f"imp*w={imp * w}")
259
- return
260
- check("受保护节点:importance × 乘子 ≥ IMPORTANCE_PROTECT(跨越 1/10/100 个半衰期)",
261
- True)
262
- w_free = F.entry_weight({"created_at": REF - 3650 * DAY,
263
- "importance": 0.8}, now=REF)[0]
264
- check("判别力:未保护节点不享有该下界(乘子触 floor)",
265
- abs(w_free - F.SCORE_FLOOR) < 1e-12, str(w_free))
266
- check("保护下限口径取自 weights.IMPORTANCE_PROTECT(单一真源)",
267
- F.IMPORTANCE_PROTECT == W.IMPORTANCE_PROTECT == 0.70)
268
-
269
-
270
- def g5_same_multiplier_slot():
271
- print("== G5 落位:与分池权重同一乘子位 ==")
272
- root, cg = _lib()
273
- try:
274
- os.environ["MDCG_FRESHNESS_NOW"] = repr(REF)
275
- src = _src(os.path.join("md_cg", "mdcg.py"))
276
- lines = src.splitlines()
277
- i = next(n for n, l in enumerate(lines)
278
- if l.startswith(" def _score(self, docs, q, qb"))
279
- seg = lines[i:i + 120]
280
- jd = next(n for n, l in enumerate(seg)
281
- if "raw * pooling.weight_of(" in l)
282
- kd = next(n for n, l in enumerate(seg)
283
- if "raw * freshness.entry_weight(" in l)
284
- check("乘子行与分池权重行同处一个语句块(中间只有注释、无空行)",
285
- 0 < kd - jd <= 12
286
- and all(l.strip() for l in seg[jd + 1:kd]),
287
- f"pooling 行={jd} 乘子行={kd}")
288
- # N274:乘子行改为「调用跨两行」形态(循环外提升后追加
289
- # now/gamma/enabled 关键字透传)——判据性质不变(仍要求乘子**直接
290
- # 乘在 raw 上**、同一乘子位、以 [0] 取乘子),仅匹配形态同步为
291
- # 跨行;并顺带收紧为「行首即 raw = raw * …」。
292
- check("乘子直接乘在 raw 上(同一乘子位,不新开乘子链)",
293
- seg[kd].strip().startswith("raw = raw * freshness.entry_weight(")
294
- and "[0]" in (seg[kd] + seg[kd + 1]), # 单行/跨行两形态皆可
295
- f"kd 行={seg[kd]!r} 次行={seg[kd + 1]!r}")
296
- # 行为:同内容两节点,仅 created_at 不同 → 分数比 == 乘子比
297
- scored = _score_pair(cg)
298
- m_new = F.entry_weight(cg.index["nodes"]["k_new"], now=REF)[0]
299
- m_old = F.entry_weight({"created_at": REF - 300 * DAY,
300
- "importance": 0.5}, now=REF)[0]
301
- got = scored[0][1] / scored[1][1]
302
- check("_score 的同内容两节点分数比 == 乘子比(乘子确实进了主分数)",
303
- abs(got - (1.0 * m_new) / (1.0 * m_old)) < 1e-9,
304
- f"got={got} want={m_new / m_old}")
305
- check("旧节点被衰减(ratio > 1 且旧节点分更低)",
306
- scored[0][1] > scored[1][1], str(scored))
307
- finally:
308
- os.environ.pop("MDCG_FRESHNESS_NOW", None)
309
- cg.close()
310
-
311
-
312
- def g6_index_entry_data():
313
- print("== G6 取数:access_count / last_access 进索引条目(检索期不读盘)==")
314
- root, cg = _lib()
315
- try:
316
- e = cg.index["nodes"]["k_new"]
317
- check("条目含 access_count", "access_count" in e, str(sorted(e)[:5]))
318
- check("条目含 last_access", "last_access" in e)
319
- check("条目含 created_at(Δt 的输入)", e.get("created_at") == REF,
320
- str(e.get("created_at")))
321
- w, why = F.entry_weight(e)
322
- check("只凭条目即可算乘子(entry_weight 无 IO)",
323
- isinstance(w, float) and why.get("unit") == F.DT_UNIT, str(why))
324
- check("单位依据如实标为 day", why.get("unit") == "day")
325
- finally:
326
- cg.close()
327
-
328
-
329
- def g7_switch():
330
- print("== G7 开关可回退(MDCG_FRESHNESS=0 与基线逐位一致)==")
331
- root, cg = _lib()
332
- try:
333
- os.environ["MDCG_FRESHNESS_NOW"] = repr(REF)
334
- on = [round(s, 12) for _d, s in _score_pair(cg)]
335
- os.environ["MDCG_FRESHNESS"] = "0"
336
- off = [round(s, 12) for _d, s in _score_pair(cg)]
337
- os.environ.pop("MDCG_FRESHNESS", None)
338
- check("关时乘子恒 1.0",
339
- F.entry_weight(cg.index["nodes"]["k_new"])[0] == 1.0
340
- if os.environ.get("MDCG_FRESHNESS") == "0" else True)
341
- check("开/关两态下分数不同(开关真的有作用)", on != off,
342
- f"{on} vs {off}")
343
- check("关态 = 无乘子基线(两节点分数相同)", abs(off[0] - off[1]) < 1e-12,
344
- str(off))
345
- finally:
346
- os.environ.pop("MDCG_FRESHNESS", None)
347
- os.environ.pop("MDCG_FRESHNESS_NOW", None)
348
- cg.close()
349
-
350
-
351
- def g8_triplet():
352
- print("== G8 三件套:预演 / 逐节点留痕 / 反向 apply ==")
353
- root, cg = _lib()
354
- try:
355
- os.environ["MDCG_FRESHNESS_NOW"] = repr(REF)
356
- src_a = _tree_hash(root)
357
- pre = F.recalc(cg, apply=False)
358
- check("预演:dry_run=True 且零写盘(源面逐字节不变)",
359
- pre["dry_run"] is True and _tree_hash(root) == src_a, str(pre["written"]))
360
- check("预演给出逐节点 before/after 样本", bool(pre["samples"]),
361
- str(pre["samples"][:1]))
362
- check("预演不改 frontmatter",
363
- (cg.get("k_old")["frontmatter"].get("freshness_weight") is None))
364
- res = F.recalc(cg, apply=True, min_delta=0.0)
365
- check("apply:written ≥ 1", res["written"] >= 1, str(res["written"]))
366
- fm = cg.get("k_old")["frontmatter"]
367
- check("apply 写入 freshness_weight(与乘子一致)",
368
- abs(float(fm.get("freshness_weight")) -
369
- F.entry_weight({"created_at": REF - 300 * DAY,
370
- "importance": 0.5}, now=REF)[0]) < 1e-9,
371
- str(fm.get("freshness_weight")))
372
- log = os.path.join(cg.root, W.MAINTAIN_LOG)
373
- recs = [json.loads(x) for x in
374
- open(log, encoding="utf-8").read().splitlines() if x.strip()]
375
- mine = [r for r in recs if r.get("action") == "freshness"]
376
- check("逐节点留痕:_maintain.jsonl 有 action=freshness 记录",
377
- bool(mine), str([r.get("action") for r in recs]))
378
- check("留痕含 before/after(逐节点)",
379
- all(("before" in r and "after" in r) for r in mine),
380
- json.dumps(mine[:1], ensure_ascii=False))
381
- check("与 weights 的 action=importance 同族(同一 log 文件)",
382
- W.MAINTAIN_LOG == F.MAINTAIN_LOG == "_maintain.jsonl")
383
- rb = F.rollback(cg)
384
- check("rollback:reverted ≥ 1 且写回 before", rb["reverted"] >= 1, str(rb))
385
- fm2 = cg.get("k_old")["frontmatter"]
386
- check("rollback 后 freshness_weight 回到 before",
387
- abs(float(fm2.get("freshness_weight") or 0.0) - 1.0) < 1e-9,
388
- str(fm2.get("freshness_weight")))
389
- _p = (cg.index["nodes"].get("k_old") or {}).get("path") or ""
390
- check("rollback 后节点仍在索引(不删记录)",
391
- "k_old" in cg.index["nodes"] and bool(_p)
392
- and os.path.exists(os.path.join(cg.root, _p)), _p)
393
- check("rollback 自身再记一条留痕",
394
- any(r.get("action") == "freshness_rollback"
395
- for r in [json.loads(x) for x in
396
- open(log, encoding="utf-8").read().splitlines()
397
- if x.strip()]))
398
- finally:
399
- os.environ.pop("MDCG_FRESHNESS_NOW", None)
400
- cg.close()
401
-
402
-
403
- def g9_degrade_not_delete():
404
- print("== G9 降级 = 标记(不是删除);跨层降级走 guard_move ==")
405
- root = tempfile.mkdtemp(prefix="p4_deg_")
406
- cg = MdCGOS(root)
407
- try:
408
- _mk(cg, "k_prot", importance=0.8) # ≥0.70 ⇒ 自动打保护
409
- _mk(cg, "k_plain", importance=0.5, created_at=REF - 300 * DAY)
410
- cg.flush()
411
- os.environ["MDCG_FRESHNESS_NOW"] = repr(REF)
412
- e0 = dict(cg.index["nodes"]["k_prot"])
413
- check("夹具前提:节点受保护", bool(e0.get("protected")),
414
- str(e0.get("protected")))
415
- check("bind_move_layer 现绑既有 `_move_layer`(不新写搬迁路径)",
416
- F.bind_move_layer(cg) is True)
417
- res = F.recalc(cg, apply=True, min_delta=0.0)
418
- fm_p = cg.get("k_plain")["frontmatter"]
419
- _pp = (cg.index["nodes"].get("k_plain") or {}).get("path") or ""
420
- check("衰减到阈值下的节点被标 degraded(**只标记**)",
421
- fm_p.get("freshness_state") == "degraded", str(fm_p.get(
422
- "freshness_state")))
423
- check("被标 degraded 的节点与正文原样在库(降级 ≠ 删除记录)",
424
- os.path.exists(os.path.join(cg.root, _pp))
425
- and "k_plain" in cg.index["nodes"], _pp)
426
- check("受保护节点**不被**降级(保护下界生效)",
427
- (cg.get("k_prot")["frontmatter"].get("freshness_state")
428
- in (None, "")), str(cg.get("k_prot")["frontmatter"].get(
429
- "freshness_state")))
430
- check("报表给出降级计数", "degraded" in res, str(sorted(res)))
431
- # 跨层降级:受保护节点被移出保护层 → guard_move 抛错且无副作用
432
- import md_cg.protect as P
433
- before = cg.get("k_prot")["frontmatter"].get("layer")
434
- try:
435
- cg._move_layer("k_prot", "contextual", reason="guard 试")
436
- moved = True
437
- except P.ProtectionError:
438
- moved = False
439
- check("受保护节点降级被 guard_move 拒绝(ProtectionError)", moved is False)
440
- check("拒绝后节点层位与记录未变(无副作用)",
441
- cg.get("k_prot")["frontmatter"].get("layer") == before
442
- and "k_prot" in cg.index["nodes"])
443
- check("fixture 未因降级被删除(降级 ≠ 删除记录)",
444
- "k_prot" in cg.index["nodes"] and "k_plain" in cg.index["nodes"])
445
- check("非保护节点可被搬迁(同一闸的两侧对照)",
446
- isinstance(cg._move_layer("k_plain", "contextual",
447
- reason="guard 对照"), dict))
448
- finally:
449
- os.environ.pop("MDCG_FRESHNESS_NOW", None)
450
- cg.close()
451
-
452
-
453
- def g10_weights_autoprotect_kept():
454
- print("== G10 weights.recalc 的 ≥0.70 自动补写 protected 仍在位 ==")
455
- src = _src(os.path.join("md_cg", "weights.py"))
456
- check("weights.py 仍含 IMPORTANCE_PROTECT 常量与自动补写分支",
457
- "IMPORTANCE_PROTECT = 0.70" in src
458
- and 'fm["protected"] = True' in src)
459
- root = tempfile.mkdtemp(prefix="p4_w_")
460
- cg = MdCGOS(root)
461
- try:
462
- _mk(cg, "hub", importance=0.2, verification_basis="formal_proof")
463
- for i in range(12):
464
- cg.add(f"leaf{i}", BODY.format(n=f"leaf{i}", t=f"leaf{i} 正文"),
465
- layer="knowledge", importance=0.1,
466
- edges=[{"target": "hub", "relation_type": "causal"}])
467
- cg.flush()
468
- rep = W.recalc(cg, apply=True, min_delta=0.0)
469
- fm = cg.get("hub")["frontmatter"]
470
- check("重算后 after ≥ 0.70 ⇒ 自动补写 protected",
471
- float(fm.get("importance") or 0) >= W.IMPORTANCE_PROTECT
472
- and fm.get("protected") is True,
473
- f"imp={fm.get('importance')} protected={fm.get('protected')}")
474
- check("recalc 报表结构未变(预演/留痕/回滚三件套仍在)",
475
- {"dry_run", "samples", "log"} <= set(rep), str(sorted(rep)))
476
- finally:
477
- cg.close()
478
-
479
-
480
- def g11_rust_parity():
481
- print("== G11 Rust 侧同口径(常量 + 生效面)==")
482
- rs = _src(os.path.join("rust", "src", "freshness.rs"))
483
- for name, val in (("SCORE_FLOOR", "0.001"), ("SECONDS_PER_DAY", "86400.0"),
484
- ("IMPORTANCE_PROTECT", "0.70"), ("DECAY_DAYS", "30.0")):
485
- check(f"rust 常量 {name} 与 Python 同值",
486
- f"pub const {name}: f64 = {val};" in rs, name)
487
- for name, val in (("REHEARSAL_THRESHOLD", "0.7"),
488
- ("DEGRADE_THRESHOLD", "0.2"), ("GAIN", "0.01")):
489
- check(f"rust 参数 {name} 照抄 AEIS({val})",
490
- f"const {name}: f64 = {val};" in rs, name)
491
- ret = _src(os.path.join("rust", "src", "retrieval.rs"))
492
- check("sort_path 带 apply_freshness 开关",
493
- "pub fn sort_path(hits: &mut [Hit], docs: &[Option<Doc>],"
494
- " apply_freshness: bool)" in ret)
495
- check("fuse 只对 lexical 路开乘子(与 Python `_score` 对位)",
496
- 'sort_path(&mut h, docs, *name == "lexical")' in ret)
497
- eng = _src(os.path.join("rust", "src", "engine.rs"))
498
- check("graph 种子排序带乘子(种子取自 lexical 路)",
499
- "retrieval::sort_path(&mut v, docs, true);" in eng)
500
- check("Rust 侧有核/参数的单测(半衰期、floor、保护线、演练闸)",
501
- rs.count("#[test]") >= 4, str(rs.count("#[test]")))
502
-
503
-
504
- # --------------------------------------------------------------------------
505
- # 定点变异(只改本进程内存对象/临时文件,绝不改仓库文件)
506
- # --------------------------------------------------------------------------
507
-
508
- def g12_rust_parity_e2e():
509
- """P4-2② 双侧同改的**端到端逐位对拍**(判别力夹具,非 rank_parity 现有语料)。
510
-
511
- 为什么必须另造夹具:`scripts/rank_parity.py` 的语料是**新建节点**(Δt=0 天
512
- ⇒ 乘子恒 1.0)、无 edges/无时间参数/无六要素后两行 ⇒ 对 P4 乘子**零判别力**
513
- (实测:改前 10/10、改后 10/10、改后 Python + 改前 Rust 二进制亦 10/10)。
514
- 只有把「同分不同龄」的节点放进去,乘子才改变路内名次,两侧才可能劈叉。
515
-
516
- 夹具:6 个**正文逐字相同**(词法分并列)的节点,created_at 跨度 0/30/300 天,
517
- importance 随年龄递增(未乘者按 (-score,-importance,id) 会「越老越靠前」);
518
- `MDCG_FRESHNESS_NOW` 钉死 → 两侧同一参照时刻。断言:
519
- ① 改后两侧 top-k **逐位一致**(Python `search_rrf` vs Rust `--serve`);
520
- ② 夹具**有判别力**:把 Python 侧乘子关掉,名次与 ① 不同(否则本对拍空转)。
521
- 二进制缺失 = fail-closed 红(「跑不起来」永不算通过)。
522
- """
523
- exe = os.path.join(_REPO, "rust", "target", "release",
524
- "mdcg-eval.exe" if os.name == "nt" else "mdcg-eval")
525
- if not os.path.isfile(exe):
526
- check("Rust 二进制在位(逐位对拍的另一侧)", False,
527
- f"{exe} 不存在——先 cd rust && cargo build --release")
528
- return
529
- sys.path.insert(0, os.path.join(_REPO, "scripts"))
530
- import rank_parity as RP # noqa: E402
531
- py_mode, conflict = RP.pin_python_score_mode()
532
- if py_mode != "jaccard" or conflict:
533
- check("Python 侧口径可钉住(eval_common.use_jaccard)", False,
534
- f"{py_mode} / {conflict}")
535
- return
536
- root = tempfile.mkdtemp(prefix="p4_parity_")
537
- cg = MdCGOS(root)
538
- ages = (0.0, 0.0, 30.0, 30.0, 300.0, 300.0)
539
- for i, age in enumerate(ages):
540
- # importance 全部 < 0.70(避开自动保护 → 不受保护下界豁免衰减)
541
- # 且全部 ≥ 0.20(避开 AEIS 降权档),年龄越大 importance 越高 ⇒
542
- # 「未乘者越老越靠前」,乘子一到即翻转
543
- _mk(cg, f"p{i}", created_at=REF - age * DAY,
544
- importance=0.20 + 0.04 * i, tags=[])
545
- cg.flush()
546
- q = "苹果 章节"
547
- os.environ["MDCG_FRESHNESS_NOW"] = repr(REF)
548
- try:
549
- py = [(x[0]["id"], round(float(x[1]), 6))
550
- for x in cg.search_rrf(q, k=6, record=False)[0]]
551
- os.environ["MDCG_FRESHNESS"] = "0"
552
- off = [(x[0]["id"], round(float(x[1]), 6))
553
- for x in cg.search_rrf(q, k=6, record=False)[0]]
554
- os.environ.pop("MDCG_FRESHNESS", None)
555
- try:
556
- proc, rs_mode = RP.rust_open(exe, root)
557
- except Exception as exc: # noqa: BLE001
558
- check("Rust serve 可拉起且自报口径", False, str(exc)[:200])
559
- cg.close()
560
- return
561
- try:
562
- rs = RP.rust_topk(proc, [q], k=6)[q]
563
- finally:
564
- pass
565
- rs2 = [(i, None if s is None else round(float(s), 6)) for i, s in rs]
566
- print(f" py(new)={py}")
567
- print(f" rust ={rs2}")
568
- print(f" py(off)={off}")
569
- check("① 两侧 top-k 逐位一致(同乘子、同口径)",
570
- [i for i, _s in py] == [i for i, _s in rs2],
571
- f"{[i for i, _s in py]} vs {[i for i, _s in rs2]}")
572
- check("② 夹具判别力:关掉乘子后名次不同(本对拍非空转)",
573
- [i for i, _s in py] != [i for i, _s in off],
574
- f"{[i for i, _s in py]} vs {[i for i, _s in off]}")
575
- check("② 乘子使「新节点靠前、旧节点靠后」",
576
- [i for i, _s in py][0] in ("p0", "p1")
577
- and [i for i, _s in py][-1] in ("p4", "p5"),
578
- f"{[i for i, _s in py]}")
579
- finally:
580
- os.environ.pop("MDCG_FRESHNESS_NOW", None)
581
- cg.close()
582
- import shutil
583
- shutil.rmtree(root, ignore_errors=True)
584
-
585
-
586
- def g13_hot_loop_reads():
587
- """N274:freshness 读取点全部提升到 `_score` 循环外(调用计数判据)。
588
-
589
- 判据=**与文档数无关**:同一 `_score` 调用于 2 节点与 20 节点两批文档
590
- 时,`enabled`/`freshness_now`/`resolve_gamma`/`temporal_gamma` 的调用
591
- 计数相同。修前(8000 池实测,2026-10-05)为每节点 7 次(enabled 4×N
592
- + now/γ/temporal 各 N);墙钟只作辅助,不作判据。
593
- """
594
- print("== G13 freshness 读取提升到 _score 循环外(N274)==")
595
- import md_cg.mdcos as MC
596
- root, cg = _lib()
597
- c = {"enabled": 0, "now": 0, "gamma": 0, "temporal": 0}
598
- orig = {n: getattr(F, n) for n in ("enabled", "freshness_now",
599
- "resolve_gamma")}
600
- orig_tg = MC.temporal_gamma
601
-
602
- def _wrap(fn, key):
603
- def _w(*a, **k):
604
- c[key] += 1
605
- return fn(*a, **k)
606
- return _w
607
-
608
- F.enabled = _wrap(orig["enabled"], "enabled")
609
- F.freshness_now = _wrap(orig["freshness_now"], "now")
610
- F.resolve_gamma = _wrap(orig["resolve_gamma"], "gamma")
611
- MC.temporal_gamma = _wrap(orig_tg, "temporal")
612
- try:
613
- def _mk_docs(n):
614
- return [({"path": "knowledge/k%d.md" % i},
615
- {"id": "k%d" % i, "tags": [],
616
- "created_at": REF - i * DAY, "access_count": 0,
617
- "last_access": 0, "importance": 0.5},
618
- BODY.format(n="k%d" % i, t="k%d 正文 苹果 章节" % i))
619
- for i in range(n)]
620
-
621
- def _count(docs):
622
- for k in c:
623
- c[k] = 0
624
- cg._score(docs, "苹果 章节",
625
- M.bigrams(M.normalize_en("苹果 章节")))
626
- return dict(c)
627
-
628
- c2 = _count(_mk_docs(2))
629
- c20 = _count(_mk_docs(20))
630
- # 判据面=**env 读取三面**(enabled / freshness_now / temporal_gamma
631
- # ——后者是 γ 的实际读取点:resolve_gamma 的 early-return 分支不碰
632
- # temporal_gamma,故「temporal_gamma 常数」即「γ 的 env 读取归零」)。
633
- # 诚实边界:resolve_gamma 的**函数调用**仍每节点一次(early-return
634
- # 直通已解析的 float,~0.15µs/节点、不读 env)——保留它是因为
635
- # resolve_gamma 还承担「非法 gamma 回落缺省」的单点边界语义,跳过
636
- # 调用会改变该边界。
637
- check("env 读取面与文档数无关(enabled/now/temporal;修前各 N×)",
638
- {k: c2[k] for k in ("enabled", "now", "temporal")}
639
- == {k: c20[k] for k in ("enabled", "now", "temporal")},
640
- f"c2={c2} c20={c20}")
641
- check("enabled() 常数级(修前 = 4×N)", c20["enabled"] <= 2, str(c20))
642
- check("freshness_now() 常数级(修前 = 1×N)", c20["now"] <= 1, str(c20))
643
- check("temporal_gamma() 常数级(修前 = 1×N;γ 的实际读取点)",
644
- c20["temporal"] <= 1, str(c20))
645
- # 自证腿(常驻):全缺省签名的旧路径仍自算,四个 spy 数得到——证明
646
- # 上面的「零/常数」不是 spy 失效造成的假绿(判别力在位)。
647
- for k in c:
648
- c[k] = 0
649
- F.entry_weight({"created_at": REF, "importance": 0.5})
650
- check("自证腿:全缺省签名仍自算(四路 spy 各 ≥1,判别力在位)",
651
- c["enabled"] >= 1 and c["now"] >= 1 and c["gamma"] >= 1
652
- and c["temporal"] >= 1, str(c))
653
- # 语义等价:显式透传与自算逐位同值;关闭恒 1.0(三面同口径)
654
- e0 = {"created_at": REF - 30 * DAY, "importance": 0.5}
655
- check("显式 enabled+now+γ 透传与自算同值(逐位一致)",
656
- F.entry_weight(e0, now=REF)[0]
657
- == F.entry_weight(e0, now=REF, gamma=F.resolve_gamma(None),
658
- enabled=True)[0])
659
- check("enabled=False 恒 1.0(entry/decay/refresh 三面同口径)",
660
- F.entry_weight(e0, now=REF, enabled=False)[0] == 1.0
661
- and F.decay_factor(0.023, 100.0, enabled=False) == 1.0
662
- and F.refresh_factor(0, 0, 0.9, enabled=False) == 1.0)
663
- finally:
664
- F.enabled = orig["enabled"]
665
- F.freshness_now = orig["freshness_now"]
666
- F.resolve_gamma = orig["resolve_gamma"]
667
- MC.temporal_gamma = orig_tg
668
- cg.close()
669
- import shutil
670
- shutil.rmtree(root, ignore_errors=True)
671
-
672
-
673
- def _mut_floor_zero():
674
- return _patch(F, "SCORE_FLOOR", 0.0)
675
-
676
-
677
- def _mut_gain_10x():
678
- orig = dict(F.REFRESH_PARAMS)
679
-
680
- def restore():
681
- F.REFRESH_PARAMS.clear()
682
- F.REFRESH_PARAMS.update(orig)
683
- F.REFRESH_PARAMS["gain"] = 0.1
684
- return restore
685
-
686
-
687
- def _mut_unit_seconds():
688
- return _patch(F, "SECONDS_PER_DAY", 1.0)
689
-
690
-
691
- def _mut_protect_floor_off():
692
- orig = F.protected_floor
693
- F.protected_floor = lambda entry: F.SCORE_FLOOR
694
-
695
- def restore():
696
- F.protected_floor = orig
697
- return restore
698
-
699
-
700
- def _mut_switch_off():
701
- return _patch(F, "enabled", lambda environ=None: False)
702
-
703
-
704
- def _patch(mod, name, value):
705
- orig = getattr(mod, name)
706
-
707
- def restore():
708
- setattr(mod, name, orig)
709
- setattr(mod, name, value)
710
- return restore
711
-
712
-
713
- _MUTATIONS = [
714
- ("floor_zero", "衰减 floor 归零", _mut_floor_zero),
715
- ("gain_10x", "刷新步长改成 0.1(脱离 AEIS 取值)", _mut_gain_10x),
716
- ("unit_seconds", "Δt 单位改成「秒」", _mut_unit_seconds),
717
- ("protect_floor_off", "去掉受保护节点的保护下界", _mut_protect_floor_off),
718
- ("switch_off", "乘子开关恒关", _mut_switch_off),
719
- ]
720
-
721
-
722
- def _collect():
723
- global PASS, FAIL, FAILS
724
- PASS, FAIL, FAILS = 0, 0, []
725
- g1_core_authority()
726
- g2_gamma_and_unit()
727
- g3_refresh_params()
728
- g4_floor()
729
- g5_same_multiplier_slot()
730
- g6_index_entry_data()
731
- g7_switch()
732
- g8_triplet()
733
- g9_degrade_not_delete()
734
- g10_weights_autoprotect_kept()
735
- g11_rust_parity()
736
- g12_rust_parity_e2e()
737
- g13_hot_loop_reads()
738
- return list(FAILS)
739
-
740
-
741
- def main(argv):
742
- if "--mutate" in argv:
743
- if "--list" in argv:
744
- for name, desc, _fn in _MUTATIONS:
745
- print(f" {name:20s} {desc}")
746
- return 0
747
- base = _collect()
748
- if base:
749
- print(f"\n!! 基线不绿({len(base)} 条):{base}")
750
- return 1
751
- bad = []
752
- for name, desc, fn in _MUTATIONS:
753
- try:
754
- restore = fn()
755
- except AttributeError as exc:
756
- print(f" ANCHOR-MISS {name}: {exc}")
757
- return 2
758
- got = _collect()
759
- restore()
760
- if got:
761
- print(f" MUTATE-OK {name}({desc})→ 转红 {len(got)} 条:{got[:3]}")
762
- else:
763
- bad.append(name)
764
- print(f" MUTATE-FAIL {name}({desc})→ 仍全绿")
765
- print(f"\ntest_p4_freshness --mutate: "
766
- f"{len(_MUTATIONS) - len(bad)}/{len(_MUTATIONS)} 变异按预期转红")
767
- return 0 if not bad else 1
768
- fails = _collect()
769
- print(f"\ntest_p4_freshness: {PASS} 通过 / {FAIL} 失败")
770
- return 0 if not fails else 1
771
-
772
-
773
- if __name__ == "__main__":
774
- sys.exit(main(sys.argv[1:]))
1
+ # -*- coding: utf-8 -*-
2
+ """P4 守卫 · 权重刷新与衰减进主分数(§7.1–§7.4)。
3
+
4
+ 覆盖判据(每条对应契约的一项):
5
+
6
+ G1 **核来自唯一权威**:`md_cg/whitebox_kb/aeis_core/time_core.py`——本模块
7
+ 源码**不含指数核调用**,且 `decay_factor` 与 `cred_factor` 在 6 个 dt 上
8
+ **逐位相等**(含 inf → floor)。
9
+ G2 **γ 与 Δt 口径**(§〇.3-12):γ 缺省 `ln2/30 天`、与 `mdcos.temporal_gamma`
10
+ **同一读取点**(env `MDCG_TEMPORAL_GAMMA` 同时覆盖两条路);Δt 取
11
+ `created_at`;**单位必须是「天」**——30 天 → 0.5,若按秒喂同一时长则触 floor
12
+ (单位断言的**判别力**)。
13
+ G3 **refresh 参数照抄 AEIS**:与 `aeis_core/core.py` 的 `consolidate_cycle`
14
+ 既有取值逐条相等(源码对拍 + 行为三档 1.01 / 0.99 / 1.0)。
15
+ G4 **衰减必加 floor**(§7.3):老节点/缺 created_at 不低于 `SCORE_FLOOR`;
16
+ **受保护节点** `importance × 乘子 ≥ IMPORTANCE_PROTECT` 恒成立;判别力
17
+ (未保护节点不享有该下界)。
18
+ G5 **落位 = 与分池权重同一乘子位**(§7.2):源码断言乘子行紧邻
19
+ `pooling.weight_of(...)` 行;行为断言 `_score` 的同内容两节点分数比
20
+ == 乘子比。
21
+ G6 **索引条目取数**(P4-2①):条目含 `access_count`/`last_access`;
22
+ `freshness.entry_weight` 只凭条目即可算(无 IO 面)。
23
+ G7 **开关可回退**:`MDCG_FRESHNESS=0` → 乘子恒 1.0,`_score` 与基线逐位一致。
24
+ G8 **三件套**(§7.4):预演零写盘;apply 逐节点 before/after 落
25
+ `_maintain.jsonl`(`action="freshness"`,与 `importance` 同族);
26
+ rollback 写回 before 且**不删节点**。
27
+ G9 **降级不得实现为删除记录**(§7.3):降级只写 `freshness_state="degraded"`,
28
+ 节点与正文原样在库;跨层降级走既有 `_move_layer`(内含 `guard_move`)
29
+ ——受保护节点被移出保护层抛 `ProtectionError` 且无副作用。
30
+ G10 `weights.recalc` 的「`after ≥ 0.70` 自动补写 `protected`」行为**仍在位**。
31
+ G11 **Rust 侧同口径**:`rust/src/freshness.rs` 的四个常量与 Python 同值;
32
+ 乘子只在 `sort_path(..., apply_freshness=true)` 生效且 `fuse` 只对
33
+ lexical 传 true(与 Python `_score` 的对位面一致)。
34
+
35
+ 运行:
36
+ python -X utf8 -m md_cg.test_p4_freshness
37
+ python -X utf8 -m md_cg.test_p4_freshness --mutate
38
+ python -X utf8 -m md_cg.test_p4_freshness --mutate --list
39
+
40
+ 退出码:0 = 全绿;1 = 有失败 / 变异未按预期转红;2 = ANCHOR-MISS。
41
+
42
+ 硬边界:库根一律 tempfile;不动在役数据根;不 git add/commit/push。
43
+ """
44
+ from __future__ import annotations
45
+
46
+ import hashlib
47
+ import json
48
+ import math
49
+ import os
50
+ import re
51
+ import sys
52
+ import tempfile
53
+
54
+ # ── 隔离前置(必须在 import md_cg 子模块之前)──
55
+ _TMP0 = tempfile.mkdtemp(prefix="p4_fresh_")
56
+ os.environ["MDCG_AUX_ROOT"] = os.path.join(_TMP0, "auxroot")
57
+ os.environ["MDCG_MASTER_KEY"] = "12" * 32
58
+ os.environ["MDCG_TOKEN_FILE"] = os.path.join(_TMP0, "tokens.json")
59
+ os.environ["MDCG_ROOT"] = os.path.join(_TMP0, "cgroot")
60
+ for _k in ("MDCG_TOKEN", "MDCG_TENANT", "MDCG_CLEARANCE", "MDCG_SESSION",
61
+ "MDCG_RETRIEVAL_PIPELINE", "MDCG_POOLING", "MDCG_FRESHNESS",
62
+ "MDCG_FRESHNESS_NOW", "MDCG_TEMPORAL_GAMMA"):
63
+ os.environ.pop(_k, None)
64
+
65
+ _HERE = os.path.dirname(os.path.abspath(__file__))
66
+ _REPO = os.path.dirname(_HERE)
67
+ sys.path.insert(0, _REPO)
68
+
69
+ try:
70
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
71
+ except AttributeError:
72
+ pass
73
+
74
+ from md_cg import freshness as F # noqa: E402
75
+ from md_cg import mdcg as M # noqa: E402
76
+ from md_cg import nodefile # noqa: E402
77
+ from md_cg import weights as W # noqa: E402
78
+ from md_cg.mdcos import MdCGOS # noqa: E402
79
+ from md_cg.whitebox_kb.aeis_core import time_core as TC # noqa: E402
80
+
81
+ REF = 1_800_000_000.0
82
+ DAY = 86400.0
83
+
84
+ PASS = 0
85
+ FAIL = 0
86
+ FAILS = []
87
+
88
+
89
+ def check(name, cond, detail=""):
90
+ global PASS, FAIL
91
+ if cond:
92
+ PASS += 1
93
+ print(f" OK {name}")
94
+ else:
95
+ FAIL += 1
96
+ FAILS.append(name)
97
+ print(f" FAIL {name} {detail}")
98
+ return bool(cond)
99
+
100
+
101
+ BODY = ("# 功能名:{n}\n# 生效条件:无条件\n# 子功能:无\n# 执行:占位\n"
102
+ "# 验证方式:compiler 复现\n# 不适用条件:其它会话\n\n{t}\n")
103
+
104
+
105
+ def _mk(cg, nid, layer="knowledge", **kw):
106
+ cg.add(nid, BODY.format(n=nid, t=f"{nid} 正文 苹果 章节"), layer=layer, **kw)
107
+
108
+
109
+ def _lib(extra=None):
110
+ root = tempfile.mkdtemp(prefix="p4_lib_")
111
+ cg = MdCGOS(root)
112
+ for nid, kw in (extra or (("k_new", {"importance": 0.5,
113
+ "created_at": REF}),
114
+ ("k_old", {"importance": 0.5,
115
+ "created_at": REF - 300 * DAY}))):
116
+ _mk(cg, nid, **kw)
117
+ cg.flush()
118
+ return root, cg
119
+
120
+
121
+ def _src(rel):
122
+ with open(os.path.join(_REPO, rel), encoding="utf-8") as f:
123
+ return f.read()
124
+
125
+
126
+ def _tree_hash(root):
127
+ h = hashlib.sha256()
128
+ for dirpath, dirs, files in os.walk(root):
129
+ dirs[:] = sorted(d for d in dirs if not d.startswith("_"))
130
+ for fn in sorted(files):
131
+ if fn.startswith("_"):
132
+ continue
133
+ p = os.path.join(dirpath, fn)
134
+ h.update(os.path.relpath(p, root).replace("\\", "/").encode())
135
+ with open(p, "rb") as f:
136
+ h.update(f.read())
137
+ return h.hexdigest()[:16]
138
+
139
+
140
+ def _score_pair(cg, q="苹果 章节", protected=False):
141
+ docs = []
142
+ for nid, created, ac in (("k_new", REF, 0), ("k_old", REF - 300 * DAY, 0)):
143
+ docs.append(({"path": f"knowledge/{nid}.md"},
144
+ {"id": nid, "tags": [], "created_at": created,
145
+ "access_count": ac, "last_access": 0,
146
+ "importance": 0.5, "protected": protected},
147
+ BODY.format(n=nid, t=f"{nid} 正文 苹果 章节")))
148
+ return cg._score(docs, q, M.bigrams(M.normalize_en(q)))
149
+
150
+
151
+ def g1_core_authority():
152
+ print("== G1 核来自唯一权威 time_core(本模块无自写指数核)==")
153
+ sc = F.selfcheck()
154
+ check("freshness 源码不含指数核调用", sc["no_local_exp_core"] is True, str(sc))
155
+ check("核经 time_core.cred_factor", sc["uses_cred_factor"] is True)
156
+ g = F.resolve_gamma()
157
+ ok = True
158
+ detail = []
159
+ for dt in (0.0, 1.0, 7.0, 30.0, 300.0, float("inf")):
160
+ a = F.decay_factor(g, dt)
161
+ b = TC.cred_factor(g, dt, F.SCORE_FLOOR, F.SCORE_CEIL)
162
+ if a != b:
163
+ ok = False
164
+ detail.append((dt, a))
165
+ check("decay_factor ≡ time_core.cred_factor(6 个 dt 逐位相等)", ok, str(detail))
166
+
167
+
168
+ def g2_gamma_and_unit():
169
+ print("== G2 γ 与 Δt 口径 / 单位必须是「天」==")
170
+ from md_cg.mdcos import temporal_gamma
171
+ from md_cg.links import DECAY_DAYS
172
+ check("γ 缺省 = ln2/30 天",
173
+ abs(F.resolve_gamma() - math.log(2.0) / 30.0) < 1e-15,
174
+ str(F.resolve_gamma()))
175
+ check("γ 与 mdcos.temporal_gamma **同一读取点**(缺省同值)",
176
+ F.resolve_gamma() == temporal_gamma())
177
+ check("半衰期真源 links.DECAY_DAYS == 30", DECAY_DAYS == 30.0)
178
+ os.environ["MDCG_TEMPORAL_GAMMA"] = "0.5"
179
+ try:
180
+ check("env MDCG_TEMPORAL_GAMMA 同时覆盖两条路",
181
+ F.resolve_gamma() == 0.5 and temporal_gamma() == 0.5)
182
+ finally:
183
+ os.environ.pop("MDCG_TEMPORAL_GAMMA", None)
184
+ os.environ["MDCG_TEMPORAL_GAMMA"] = "abc"
185
+ try:
186
+ check("非法 γ 回落缺省(不抛)",
187
+ abs(F.resolve_gamma() - math.log(2.0) / 30.0) < 1e-15)
188
+ finally:
189
+ os.environ.pop("MDCG_TEMPORAL_GAMMA", None)
190
+ g = F.resolve_gamma()
191
+ check("单位断言(天):30 天 → 0.5", abs(F.decay_factor(g, 30.0) - 0.5) < 1e-12,
192
+ str(F.decay_factor(g, 30.0)))
193
+ check("判别力:同一时长按**秒**喂 → 触 floor(喂秒会快 86400 倍)",
194
+ F.decay_factor(g, 30.0 * DAY) == F.SCORE_FLOOR,
195
+ str(F.decay_factor(g, 30.0 * DAY)))
196
+ check("Δt 取 created_at(entry_weight 用 created_at 算天数)",
197
+ F.entry_weight({"created_at": REF - 30 * DAY, "importance": 0.5},
198
+ now=REF)[0] == F.decay_factor(g, 30.0))
199
+ # 粒度=整日(向下取整):同为「1.x 天」的节点与「1 天」同值;「0.x 天」不衰减
200
+ check("粒度断言:Δt 取整日(1.5 天 ≡ 1 天)",
201
+ F.entry_weight({"created_at": REF - 1.5 * DAY, "importance": 0.5},
202
+ now=REF)[0] == F.decay_factor(g, 1.0))
203
+ check("粒度断言:当日写入(0.9 天)不衰减",
204
+ F.entry_weight({"created_at": REF - 0.9 * DAY, "importance": 0.5},
205
+ now=REF)[0] == F.decay_factor(g, 0.0))
206
+ check("可复算:同一 (created_at, 日) 上两轮乘子逐位一致",
207
+ F.entry_weight({"created_at": REF - 3 * DAY - 100, "importance": 0.5},
208
+ now=REF)[0]
209
+ == F.entry_weight({"created_at": REF - 3 * DAY - 100,
210
+ "importance": 0.5}, now=REF + 10.0)[0])
211
+
212
+
213
+ def g3_refresh_params():
214
+ print("== G3 refresh 参数照抄 AEIS consolidate_cycle ==")
215
+ src = _src(os.path.join("md_cg", "whitebox_kb", "aeis_core", "core.py"))
216
+ check("AEIS 源码含 rehearsal_threshold = 0.7",
217
+ re.search(r"rehearsal_threshold\s*:\s*float\s*=\s*0\.7", src)
218
+ is not None)
219
+ check("AEIS 源码含 degrade_threshold = 0.2",
220
+ re.search(r"degrade_threshold\s*:\s*float\s*=\s*0\.2", src)
221
+ is not None)
222
+ check("AEIS 源码含 gain = 0.01",
223
+ re.search(r"gain\s*:\s*float\s*=\s*0\.01", src) is not None)
224
+ check("AEIS 源码的降权是 −gain(同一档语义)",
225
+ re.search(r"update_node_importance\(n\.id,\s*-gain\)", src)
226
+ is not None)
227
+ check("AEIS 源码含 `% 10 == 0` 档",
228
+ re.search(r"%\s*10\s*==\s*0", src) is not None)
229
+ p = F.REFRESH_PARAMS
230
+ check("参数取值与 AEIS 既有取值逐条相等",
231
+ (p["rehearsal_threshold"], p["degrade_threshold"], p["gain"],
232
+ p["cycle"]) == (0.7, 0.2, 0.01, 10), str(p))
233
+ check("参数出处写在 paramsSource(REFRESH_PARAMS.source)",
234
+ "consolidate_cycle" in p["source"] and "core.py" in p["source"],
235
+ p["source"])
236
+ check("行为档①演练:+gain", abs(F.refresh_factor(40, 1.0, 0.8) - 1.01) < 1e-12)
237
+ check("行为档②降权:−gain", abs(F.refresh_factor(1, 1.0, 0.1) - 0.99) < 1e-12)
238
+ check("行为档③其余:1.0", F.refresh_factor(3, 1.0, 0.5) == 1.0)
239
+ check("从未访问不得白拿刷新(last_access=0 ⇒ 1.0)",
240
+ F.refresh_factor(0, 0, 0.9) == 1.0)
241
+
242
+
243
+ def g4_floor():
244
+ print("== G4 衰减必加 floor / 保护线不被穿过 ==")
245
+ g = F.resolve_gamma()
246
+ check("老节点 ≥ SCORE_FLOOR",
247
+ F.decay_factor(g, 10000.0) >= F.SCORE_FLOOR)
248
+ check("缺 created_at 的节点仍带非零分(不乘成 0)",
249
+ F.entry_weight({"created_at": 0, "importance": 0.5})[0] > 0.0,
250
+ str(F.entry_weight({"created_at": 0, "importance": 0.5})[0]))
251
+ check("缺 created_at 的衰减项触 floor(decay 本身 = SCORE_FLOOR)",
252
+ F.decay_factor(g, float("inf")) == F.SCORE_FLOOR)
253
+ for imp in (0.70, 0.8, 0.95, 1.0):
254
+ w = F.entry_weight({"created_at": REF - 3650 * DAY,
255
+ "importance": imp, "protected": True}, now=REF)[0]
256
+ if not (imp * w >= W.IMPORTANCE_PROTECT):
257
+ check(f"受保护节点 importance={imp} 乘子不穿保护线", False,
258
+ f"imp*w={imp * w}")
259
+ return
260
+ check("受保护节点:importance × 乘子 ≥ IMPORTANCE_PROTECT(跨越 1/10/100 个半衰期)",
261
+ True)
262
+ # #378(2026-10-14)夹具更正:原夹具只写 importance=0.8 而**不带来源标注**
263
+ # ——按本仓保护规则(protect.is_protected,AUTO_PROTECT_IMPORTANCE=0.70)
264
+ # 那是「**缺省来源**高分」=受保护节点,与「未保护节点」的断言前提冲突
265
+ # (且写侧对 importance≥0.70 本就会自动置保护位 ⇒ 该 dict 不对应任何真实
266
+ # 节点)。补上显式非 hint 来源后前提重新成立,断言一字未动(数值前提
267
+ # importance=0.8 亦保留)。
268
+ w_free = F.entry_weight({"created_at": REF - 3650 * DAY,
269
+ "importance": 0.8,
270
+ "importance_source": "heuristic"}, now=REF)[0]
271
+ check("判别力:未保护节点不享有该下界(乘子触 floor)",
272
+ abs(w_free - F.SCORE_FLOOR) < 1e-12, str(w_free))
273
+ check("保护下限口径取自 weights.IMPORTANCE_PROTECT(单一真源)",
274
+ F.IMPORTANCE_PROTECT == W.IMPORTANCE_PROTECT == 0.70)
275
+
276
+
277
+ def g5_same_multiplier_slot():
278
+ print("== G5 落位:与分池权重同一乘子位 ==")
279
+ root, cg = _lib()
280
+ try:
281
+ os.environ["MDCG_FRESHNESS_NOW"] = repr(REF)
282
+ src = _src(os.path.join("md_cg", "mdcg.py"))
283
+ lines = src.splitlines()
284
+ i = next(n for n, l in enumerate(lines)
285
+ if l.startswith(" def _score(self, docs, q, qb"))
286
+ seg = lines[i:i + 120]
287
+ jd = next(n for n, l in enumerate(seg)
288
+ if "raw * pooling.weight_of(" in l)
289
+ kd = next(n for n, l in enumerate(seg)
290
+ if "raw * freshness.entry_weight(" in l)
291
+ check("乘子行与分池权重行同处一个语句块(中间只有注释、无空行)",
292
+ 0 < kd - jd <= 12
293
+ and all(l.strip() for l in seg[jd + 1:kd]),
294
+ f"pooling 行={jd} 乘子行={kd}")
295
+ # N274:乘子行改为「调用跨两行」形态(循环外提升后追加
296
+ # now/gamma/enabled 关键字透传)——判据性质不变(仍要求乘子**直接
297
+ # 乘在 raw 上**、同一乘子位、以 [0] 取乘子),仅匹配形态同步为
298
+ # 跨行;并顺带收紧为「行首即 raw = raw * …」。
299
+ check("乘子直接乘在 raw 上(同一乘子位,不新开乘子链)",
300
+ seg[kd].strip().startswith("raw = raw * freshness.entry_weight(")
301
+ and "[0]" in (seg[kd] + seg[kd + 1]), # 单行/跨行两形态皆可
302
+ f"kd 行={seg[kd]!r} 次行={seg[kd + 1]!r}")
303
+ # 行为:同内容两节点,仅 created_at 不同 → 分数比 == 乘子比
304
+ scored = _score_pair(cg)
305
+ m_new = F.entry_weight(cg.index["nodes"]["k_new"], now=REF)[0]
306
+ m_old = F.entry_weight({"created_at": REF - 300 * DAY,
307
+ "importance": 0.5}, now=REF)[0]
308
+ got = scored[0][1] / scored[1][1]
309
+ check("_score 的同内容两节点分数比 == 乘子比(乘子确实进了主分数)",
310
+ abs(got - (1.0 * m_new) / (1.0 * m_old)) < 1e-9,
311
+ f"got={got} want={m_new / m_old}")
312
+ check("旧节点被衰减(ratio > 1 且旧节点分更低)",
313
+ scored[0][1] > scored[1][1], str(scored))
314
+ finally:
315
+ os.environ.pop("MDCG_FRESHNESS_NOW", None)
316
+ cg.close()
317
+
318
+
319
+ def g6_index_entry_data():
320
+ print("== G6 取数:access_count / last_access 进索引条目(检索期不读盘)==")
321
+ root, cg = _lib()
322
+ try:
323
+ e = cg.index["nodes"]["k_new"]
324
+ check("条目含 access_count", "access_count" in e, str(sorted(e)[:5]))
325
+ check("条目含 last_access", "last_access" in e)
326
+ check("条目含 created_at(Δt 的输入)", e.get("created_at") == REF,
327
+ str(e.get("created_at")))
328
+ w, why = F.entry_weight(e)
329
+ check("只凭条目即可算乘子(entry_weight 无 IO)",
330
+ isinstance(w, float) and why.get("unit") == F.DT_UNIT, str(why))
331
+ check("单位依据如实标为 day", why.get("unit") == "day")
332
+ finally:
333
+ cg.close()
334
+
335
+
336
+ def g7_switch():
337
+ print("== G7 开关可回退(MDCG_FRESHNESS=0 与基线逐位一致)==")
338
+ root, cg = _lib()
339
+ try:
340
+ os.environ["MDCG_FRESHNESS_NOW"] = repr(REF)
341
+ on = [round(s, 12) for _d, s in _score_pair(cg)]
342
+ os.environ["MDCG_FRESHNESS"] = "0"
343
+ off = [round(s, 12) for _d, s in _score_pair(cg)]
344
+ os.environ.pop("MDCG_FRESHNESS", None)
345
+ check("关时乘子恒 1.0",
346
+ F.entry_weight(cg.index["nodes"]["k_new"])[0] == 1.0
347
+ if os.environ.get("MDCG_FRESHNESS") == "0" else True)
348
+ check("开/关两态下分数不同(开关真的有作用)", on != off,
349
+ f"{on} vs {off}")
350
+ check("关态 = 无乘子基线(两节点分数相同)", abs(off[0] - off[1]) < 1e-12,
351
+ str(off))
352
+ finally:
353
+ os.environ.pop("MDCG_FRESHNESS", None)
354
+ os.environ.pop("MDCG_FRESHNESS_NOW", None)
355
+ cg.close()
356
+
357
+
358
+ def g8_triplet():
359
+ print("== G8 三件套:预演 / 逐节点留痕 / 反向 apply ==")
360
+ root, cg = _lib()
361
+ try:
362
+ os.environ["MDCG_FRESHNESS_NOW"] = repr(REF)
363
+ src_a = _tree_hash(root)
364
+ pre = F.recalc(cg, apply=False)
365
+ check("预演:dry_run=True 且零写盘(源面逐字节不变)",
366
+ pre["dry_run"] is True and _tree_hash(root) == src_a, str(pre["written"]))
367
+ check("预演给出逐节点 before/after 样本", bool(pre["samples"]),
368
+ str(pre["samples"][:1]))
369
+ check("预演不改 frontmatter",
370
+ (cg.get("k_old")["frontmatter"].get("freshness_weight") is None))
371
+ res = F.recalc(cg, apply=True, min_delta=0.0)
372
+ check("apply:written ≥ 1", res["written"] >= 1, str(res["written"]))
373
+ fm = cg.get("k_old")["frontmatter"]
374
+ check("apply 写入 freshness_weight(与乘子一致)",
375
+ abs(float(fm.get("freshness_weight")) -
376
+ F.entry_weight({"created_at": REF - 300 * DAY,
377
+ "importance": 0.5}, now=REF)[0]) < 1e-9,
378
+ str(fm.get("freshness_weight")))
379
+ log = os.path.join(cg.root, W.MAINTAIN_LOG)
380
+ recs = [json.loads(x) for x in
381
+ open(log, encoding="utf-8").read().splitlines() if x.strip()]
382
+ mine = [r for r in recs if r.get("action") == "freshness"]
383
+ check("逐节点留痕:_maintain.jsonl 有 action=freshness 记录",
384
+ bool(mine), str([r.get("action") for r in recs]))
385
+ check("留痕含 before/after(逐节点)",
386
+ all(("before" in r and "after" in r) for r in mine),
387
+ json.dumps(mine[:1], ensure_ascii=False))
388
+ check("与 weights 的 action=importance 同族(同一 log 文件)",
389
+ W.MAINTAIN_LOG == F.MAINTAIN_LOG == "_maintain.jsonl")
390
+ rb = F.rollback(cg)
391
+ check("rollback:reverted ≥ 1 且写回 before", rb["reverted"] >= 1, str(rb))
392
+ fm2 = cg.get("k_old")["frontmatter"]
393
+ check("rollback 后 freshness_weight 回到 before",
394
+ abs(float(fm2.get("freshness_weight") or 0.0) - 1.0) < 1e-9,
395
+ str(fm2.get("freshness_weight")))
396
+ _p = (cg.index["nodes"].get("k_old") or {}).get("path") or ""
397
+ check("rollback 后节点仍在索引(不删记录)",
398
+ "k_old" in cg.index["nodes"] and bool(_p)
399
+ and os.path.exists(os.path.join(cg.root, _p)), _p)
400
+ check("rollback 自身再记一条留痕",
401
+ any(r.get("action") == "freshness_rollback"
402
+ for r in [json.loads(x) for x in
403
+ open(log, encoding="utf-8").read().splitlines()
404
+ if x.strip()]))
405
+ finally:
406
+ os.environ.pop("MDCG_FRESHNESS_NOW", None)
407
+ cg.close()
408
+
409
+
410
+ def g9_degrade_not_delete():
411
+ print("== G9 降级 = 标记(不是删除);跨层降级走 guard_move ==")
412
+ root = tempfile.mkdtemp(prefix="p4_deg_")
413
+ cg = MdCGOS(root)
414
+ try:
415
+ _mk(cg, "k_prot", importance=0.8) # ≥0.70 ⇒ 自动打保护
416
+ _mk(cg, "k_plain", importance=0.5, created_at=REF - 300 * DAY)
417
+ cg.flush()
418
+ os.environ["MDCG_FRESHNESS_NOW"] = repr(REF)
419
+ e0 = dict(cg.index["nodes"]["k_prot"])
420
+ check("夹具前提:节点受保护", bool(e0.get("protected")),
421
+ str(e0.get("protected")))
422
+ check("bind_move_layer 现绑既有 `_move_layer`(不新写搬迁路径)",
423
+ F.bind_move_layer(cg) is True)
424
+ res = F.recalc(cg, apply=True, min_delta=0.0)
425
+ fm_p = cg.get("k_plain")["frontmatter"]
426
+ _pp = (cg.index["nodes"].get("k_plain") or {}).get("path") or ""
427
+ check("衰减到阈值下的节点被标 degraded(**只标记**)",
428
+ fm_p.get("freshness_state") == "degraded", str(fm_p.get(
429
+ "freshness_state")))
430
+ check("被标 degraded 的节点与正文原样在库(降级 ≠ 删除记录)",
431
+ os.path.exists(os.path.join(cg.root, _pp))
432
+ and "k_plain" in cg.index["nodes"], _pp)
433
+ check("受保护节点**不被**降级(保护下界生效)",
434
+ (cg.get("k_prot")["frontmatter"].get("freshness_state")
435
+ in (None, "")), str(cg.get("k_prot")["frontmatter"].get(
436
+ "freshness_state")))
437
+ check("报表给出降级计数", "degraded" in res, str(sorted(res)))
438
+ # 跨层降级:受保护节点被移出保护层 → guard_move 抛错且无副作用
439
+ import md_cg.protect as P
440
+ before = cg.get("k_prot")["frontmatter"].get("layer")
441
+ try:
442
+ cg._move_layer("k_prot", "contextual", reason="guard 试")
443
+ moved = True
444
+ except P.ProtectionError:
445
+ moved = False
446
+ check("受保护节点降级被 guard_move 拒绝(ProtectionError)", moved is False)
447
+ check("拒绝后节点层位与记录未变(无副作用)",
448
+ cg.get("k_prot")["frontmatter"].get("layer") == before
449
+ and "k_prot" in cg.index["nodes"])
450
+ check("fixture 未因降级被删除(降级 ≠ 删除记录)",
451
+ "k_prot" in cg.index["nodes"] and "k_plain" in cg.index["nodes"])
452
+ check("非保护节点可被搬迁(同一闸的两侧对照)",
453
+ isinstance(cg._move_layer("k_plain", "contextual",
454
+ reason="guard 对照"), dict))
455
+ finally:
456
+ os.environ.pop("MDCG_FRESHNESS_NOW", None)
457
+ cg.close()
458
+
459
+
460
+ def g10_weights_autoprotect_kept():
461
+ print("== G10 weights.recalc 的 ≥0.70 自动补写 protected 仍在位 ==")
462
+ src = _src(os.path.join("md_cg", "weights.py"))
463
+ check("weights.py 仍含 IMPORTANCE_PROTECT 常量与自动补写分支",
464
+ "IMPORTANCE_PROTECT = 0.70" in src
465
+ and 'fm["protected"] = True' in src)
466
+ root = tempfile.mkdtemp(prefix="p4_w_")
467
+ cg = MdCGOS(root)
468
+ try:
469
+ _mk(cg, "hub", importance=0.2, verification_basis="formal_proof")
470
+ for i in range(12):
471
+ cg.add(f"leaf{i}", BODY.format(n=f"leaf{i}", t=f"leaf{i} 正文"),
472
+ layer="knowledge", importance=0.1,
473
+ edges=[{"target": "hub", "relation_type": "causal"}])
474
+ cg.flush()
475
+ rep = W.recalc(cg, apply=True, min_delta=0.0)
476
+ fm = cg.get("hub")["frontmatter"]
477
+ check("重算后 after ≥ 0.70 ⇒ 自动补写 protected",
478
+ float(fm.get("importance") or 0) >= W.IMPORTANCE_PROTECT
479
+ and fm.get("protected") is True,
480
+ f"imp={fm.get('importance')} protected={fm.get('protected')}")
481
+ check("recalc 报表结构未变(预演/留痕/回滚三件套仍在)",
482
+ {"dry_run", "samples", "log"} <= set(rep), str(sorted(rep)))
483
+ finally:
484
+ cg.close()
485
+
486
+
487
+ def g11_rust_parity():
488
+ print("== G11 Rust 侧同口径(常量 + 生效面)==")
489
+ rs = _src(os.path.join("rust", "src", "freshness.rs"))
490
+ for name, val in (("SCORE_FLOOR", "0.001"), ("SECONDS_PER_DAY", "86400.0"),
491
+ ("IMPORTANCE_PROTECT", "0.70"), ("DECAY_DAYS", "30.0")):
492
+ check(f"rust 常量 {name} 与 Python 同值",
493
+ f"pub const {name}: f64 = {val};" in rs, name)
494
+ for name, val in (("REHEARSAL_THRESHOLD", "0.7"),
495
+ ("DEGRADE_THRESHOLD", "0.2"), ("GAIN", "0.01")):
496
+ check(f"rust 参数 {name} 照抄 AEIS({val})",
497
+ f"const {name}: f64 = {val};" in rs, name)
498
+ ret = _src(os.path.join("rust", "src", "retrieval.rs"))
499
+ check("sort_path 带 apply_freshness 开关",
500
+ "pub fn sort_path(hits: &mut [Hit], docs: &[Option<Doc>],"
501
+ " apply_freshness: bool)" in ret)
502
+ check("fuse 只对 lexical 路开乘子(与 Python `_score` 对位)",
503
+ 'sort_path(&mut h, docs, *name == "lexical")' in ret)
504
+ eng = _src(os.path.join("rust", "src", "engine.rs"))
505
+ check("graph 种子排序带乘子(种子取自 lexical 路)",
506
+ "retrieval::sort_path(&mut v, docs, true);" in eng)
507
+ check("Rust 侧有核/参数的单测(半衰期、floor、保护线、演练闸)",
508
+ rs.count("#[test]") >= 4, str(rs.count("#[test]")))
509
+
510
+
511
+ # --------------------------------------------------------------------------
512
+ # 定点变异(只改本进程内存对象/临时文件,绝不改仓库文件)
513
+ # --------------------------------------------------------------------------
514
+
515
+ def g12_rust_parity_e2e():
516
+ """P4-2② 双侧同改的**端到端逐位对拍**(判别力夹具,非 rank_parity 现有语料)。
517
+
518
+ 为什么必须另造夹具:`scripts/rank_parity.py` 的语料是**新建节点**(Δt=0 天
519
+ ⇒ 乘子恒 1.0)、无 edges/无时间参数/无六要素后两行 ⇒ 对 P4 乘子**零判别力**
520
+ (实测:改前 10/10、改后 10/10、改后 Python + 改前 Rust 二进制亦 10/10)。
521
+ 只有把「同分不同龄」的节点放进去,乘子才改变路内名次,两侧才可能劈叉。
522
+
523
+ 夹具:6 个**正文逐字相同**(词法分并列)的节点,created_at 跨度 0/30/300 天,
524
+ importance 随年龄递增(未乘者按 (-score,-importance,id) 会「越老越靠前」);
525
+ `MDCG_FRESHNESS_NOW` 钉死 → 两侧同一参照时刻。断言:
526
+ ① 改后两侧 top-k **逐位一致**(Python `search_rrf` vs Rust `--serve`);
527
+ ② 夹具**有判别力**:把 Python 侧乘子关掉,名次与 ① 不同(否则本对拍空转)。
528
+ 二进制缺失 = fail-closed 红(「跑不起来」永不算通过)。
529
+ """
530
+ exe = os.path.join(_REPO, "rust", "target", "release",
531
+ "mdcg-eval.exe" if os.name == "nt" else "mdcg-eval")
532
+ if not os.path.isfile(exe):
533
+ check("Rust 二进制在位(逐位对拍的另一侧)", False,
534
+ f"{exe} 不存在——先 cd rust && cargo build --release")
535
+ return
536
+ sys.path.insert(0, os.path.join(_REPO, "scripts"))
537
+ import rank_parity as RP # noqa: E402
538
+ py_mode, conflict = RP.pin_python_score_mode()
539
+ if py_mode != "jaccard" or conflict:
540
+ check("Python 侧口径可钉住(eval_common.use_jaccard)", False,
541
+ f"{py_mode} / {conflict}")
542
+ return
543
+ root = tempfile.mkdtemp(prefix="p4_parity_")
544
+ cg = MdCGOS(root)
545
+ ages = (0.0, 0.0, 30.0, 30.0, 300.0, 300.0)
546
+ for i, age in enumerate(ages):
547
+ # importance 全部 < 0.70(避开自动保护 → 不受保护下界豁免衰减)
548
+ # 且全部 ≥ 0.20(避开 AEIS 降权档),年龄越大 importance 越高 ⇒
549
+ # 「未乘者越老越靠前」,乘子一到即翻转
550
+ _mk(cg, f"p{i}", created_at=REF - age * DAY,
551
+ importance=0.20 + 0.04 * i, tags=[])
552
+ cg.flush()
553
+ q = "苹果 章节"
554
+ os.environ["MDCG_FRESHNESS_NOW"] = repr(REF)
555
+ try:
556
+ py = [(x[0]["id"], round(float(x[1]), 6))
557
+ for x in cg.search_rrf(q, k=6, record=False)[0]]
558
+ os.environ["MDCG_FRESHNESS"] = "0"
559
+ off = [(x[0]["id"], round(float(x[1]), 6))
560
+ for x in cg.search_rrf(q, k=6, record=False)[0]]
561
+ os.environ.pop("MDCG_FRESHNESS", None)
562
+ try:
563
+ proc, rs_mode = RP.rust_open(exe, root)
564
+ except Exception as exc: # noqa: BLE001
565
+ check("Rust serve 可拉起且自报口径", False, str(exc)[:200])
566
+ cg.close()
567
+ return
568
+ try:
569
+ rs = RP.rust_topk(proc, [q], k=6)[q]
570
+ finally:
571
+ pass
572
+ rs2 = [(i, None if s is None else round(float(s), 6)) for i, s in rs]
573
+ print(f" py(new)={py}")
574
+ print(f" rust ={rs2}")
575
+ print(f" py(off)={off}")
576
+ check("① 两侧 top-k 逐位一致(同乘子、同口径)",
577
+ [i for i, _s in py] == [i for i, _s in rs2],
578
+ f"{[i for i, _s in py]} vs {[i for i, _s in rs2]}")
579
+ check("② 夹具判别力:关掉乘子后名次不同(本对拍非空转)",
580
+ [i for i, _s in py] != [i for i, _s in off],
581
+ f"{[i for i, _s in py]} vs {[i for i, _s in off]}")
582
+ check("② 乘子使「新节点靠前、旧节点靠后」",
583
+ [i for i, _s in py][0] in ("p0", "p1")
584
+ and [i for i, _s in py][-1] in ("p4", "p5"),
585
+ f"{[i for i, _s in py]}")
586
+ finally:
587
+ os.environ.pop("MDCG_FRESHNESS_NOW", None)
588
+ cg.close()
589
+ import shutil
590
+ shutil.rmtree(root, ignore_errors=True)
591
+
592
+
593
+ def g13_hot_loop_reads():
594
+ """N274:freshness 读取点全部提升到 `_score` 循环外(调用计数判据)。
595
+
596
+ 判据=**与文档数无关**:同一 `_score` 调用于 2 节点与 20 节点两批文档
597
+ 时,`enabled`/`freshness_now`/`resolve_gamma`/`temporal_gamma` 的调用
598
+ 计数相同。修前(8000 池实测,2026-10-05)为每节点 7 次(enabled 4×N
599
+ + now/γ/temporal 各 N);墙钟只作辅助,不作判据。
600
+ """
601
+ print("== G13 freshness 读取提升到 _score 循环外(N274)==")
602
+ import md_cg.mdcos as MC
603
+ root, cg = _lib()
604
+ c = {"enabled": 0, "now": 0, "gamma": 0, "temporal": 0}
605
+ orig = {n: getattr(F, n) for n in ("enabled", "freshness_now",
606
+ "resolve_gamma")}
607
+ orig_tg = MC.temporal_gamma
608
+
609
+ def _wrap(fn, key):
610
+ def _w(*a, **k):
611
+ c[key] += 1
612
+ return fn(*a, **k)
613
+ return _w
614
+
615
+ F.enabled = _wrap(orig["enabled"], "enabled")
616
+ F.freshness_now = _wrap(orig["freshness_now"], "now")
617
+ F.resolve_gamma = _wrap(orig["resolve_gamma"], "gamma")
618
+ MC.temporal_gamma = _wrap(orig_tg, "temporal")
619
+ try:
620
+ def _mk_docs(n):
621
+ return [({"path": "knowledge/k%d.md" % i},
622
+ {"id": "k%d" % i, "tags": [],
623
+ "created_at": REF - i * DAY, "access_count": 0,
624
+ "last_access": 0, "importance": 0.5},
625
+ BODY.format(n="k%d" % i, t="k%d 正文 苹果 章节" % i))
626
+ for i in range(n)]
627
+
628
+ def _count(docs):
629
+ for k in c:
630
+ c[k] = 0
631
+ cg._score(docs, "苹果 章节",
632
+ M.bigrams(M.normalize_en("苹果 章节")))
633
+ return dict(c)
634
+
635
+ c2 = _count(_mk_docs(2))
636
+ c20 = _count(_mk_docs(20))
637
+ # 判据面=**env 读取三面**(enabled / freshness_now / temporal_gamma
638
+ # ——后者是 γ 的实际读取点:resolve_gamma 的 early-return 分支不碰
639
+ # temporal_gamma,故「temporal_gamma 常数」即「γ 的 env 读取归零」)。
640
+ # 诚实边界:resolve_gamma 的**函数调用**仍每节点一次(early-return
641
+ # 直通已解析的 float,~0.15µs/节点、不读 env)——保留它是因为
642
+ # resolve_gamma 还承担「非法 gamma 回落缺省」的单点边界语义,跳过
643
+ # 调用会改变该边界。
644
+ check("env 读取面与文档数无关(enabled/now/temporal;修前各 N×)",
645
+ {k: c2[k] for k in ("enabled", "now", "temporal")}
646
+ == {k: c20[k] for k in ("enabled", "now", "temporal")},
647
+ f"c2={c2} c20={c20}")
648
+ check("enabled() 常数级(修前 = 4×N)", c20["enabled"] <= 2, str(c20))
649
+ check("freshness_now() 常数级(修前 = 1×N)", c20["now"] <= 1, str(c20))
650
+ check("temporal_gamma() 常数级(修前 = 1×N;γ 的实际读取点)",
651
+ c20["temporal"] <= 1, str(c20))
652
+ # 自证腿(常驻):全缺省签名的旧路径仍自算,四个 spy 数得到——证明
653
+ # 上面的「零/常数」不是 spy 失效造成的假绿(判别力在位)。
654
+ for k in c:
655
+ c[k] = 0
656
+ F.entry_weight({"created_at": REF, "importance": 0.5})
657
+ check("自证腿:全缺省签名仍自算(四路 spy 各 ≥1,判别力在位)",
658
+ c["enabled"] >= 1 and c["now"] >= 1 and c["gamma"] >= 1
659
+ and c["temporal"] >= 1, str(c))
660
+ # 语义等价:显式透传与自算逐位同值;关闭恒 1.0(三面同口径)
661
+ e0 = {"created_at": REF - 30 * DAY, "importance": 0.5}
662
+ check("显式 enabled+now+γ 透传与自算同值(逐位一致)",
663
+ F.entry_weight(e0, now=REF)[0]
664
+ == F.entry_weight(e0, now=REF, gamma=F.resolve_gamma(None),
665
+ enabled=True)[0])
666
+ check("enabled=False 恒 1.0(entry/decay/refresh 三面同口径)",
667
+ F.entry_weight(e0, now=REF, enabled=False)[0] == 1.0
668
+ and F.decay_factor(0.023, 100.0, enabled=False) == 1.0
669
+ and F.refresh_factor(0, 0, 0.9, enabled=False) == 1.0)
670
+ finally:
671
+ F.enabled = orig["enabled"]
672
+ F.freshness_now = orig["freshness_now"]
673
+ F.resolve_gamma = orig["resolve_gamma"]
674
+ MC.temporal_gamma = orig_tg
675
+ cg.close()
676
+ import shutil
677
+ shutil.rmtree(root, ignore_errors=True)
678
+
679
+
680
+ def _mut_floor_zero():
681
+ return _patch(F, "SCORE_FLOOR", 0.0)
682
+
683
+
684
+ def _mut_gain_10x():
685
+ orig = dict(F.REFRESH_PARAMS)
686
+
687
+ def restore():
688
+ F.REFRESH_PARAMS.clear()
689
+ F.REFRESH_PARAMS.update(orig)
690
+ F.REFRESH_PARAMS["gain"] = 0.1
691
+ return restore
692
+
693
+
694
+ def _mut_unit_seconds():
695
+ return _patch(F, "SECONDS_PER_DAY", 1.0)
696
+
697
+
698
+ def _mut_protect_floor_off():
699
+ orig = F.protected_floor
700
+ F.protected_floor = lambda entry: F.SCORE_FLOOR
701
+
702
+ def restore():
703
+ F.protected_floor = orig
704
+ return restore
705
+
706
+
707
+ def _mut_switch_off():
708
+ return _patch(F, "enabled", lambda environ=None: False)
709
+
710
+
711
+ def _patch(mod, name, value):
712
+ orig = getattr(mod, name)
713
+
714
+ def restore():
715
+ setattr(mod, name, orig)
716
+ setattr(mod, name, value)
717
+ return restore
718
+
719
+
720
+ _MUTATIONS = [
721
+ ("floor_zero", "衰减 floor 归零", _mut_floor_zero),
722
+ ("gain_10x", "刷新步长改成 0.1(脱离 AEIS 取值)", _mut_gain_10x),
723
+ ("unit_seconds", "Δt 单位改成「秒」", _mut_unit_seconds),
724
+ ("protect_floor_off", "去掉受保护节点的保护下界", _mut_protect_floor_off),
725
+ ("switch_off", "乘子开关恒关", _mut_switch_off),
726
+ ]
727
+
728
+
729
+ def _collect():
730
+ global PASS, FAIL, FAILS
731
+ PASS, FAIL, FAILS = 0, 0, []
732
+ g1_core_authority()
733
+ g2_gamma_and_unit()
734
+ g3_refresh_params()
735
+ g4_floor()
736
+ g5_same_multiplier_slot()
737
+ g6_index_entry_data()
738
+ g7_switch()
739
+ g8_triplet()
740
+ g9_degrade_not_delete()
741
+ g10_weights_autoprotect_kept()
742
+ g11_rust_parity()
743
+ g12_rust_parity_e2e()
744
+ g13_hot_loop_reads()
745
+ return list(FAILS)
746
+
747
+
748
+ def main(argv):
749
+ if "--mutate" in argv:
750
+ if "--list" in argv:
751
+ for name, desc, _fn in _MUTATIONS:
752
+ print(f" {name:20s} {desc}")
753
+ return 0
754
+ base = _collect()
755
+ if base:
756
+ print(f"\n!! 基线不绿({len(base)} 条):{base}")
757
+ return 1
758
+ bad = []
759
+ for name, desc, fn in _MUTATIONS:
760
+ try:
761
+ restore = fn()
762
+ except AttributeError as exc:
763
+ print(f" ANCHOR-MISS {name}: {exc}")
764
+ return 2
765
+ got = _collect()
766
+ restore()
767
+ if got:
768
+ print(f" MUTATE-OK {name}({desc})→ 转红 {len(got)} 条:{got[:3]}")
769
+ else:
770
+ bad.append(name)
771
+ print(f" MUTATE-FAIL {name}({desc})→ 仍全绿")
772
+ print(f"\ntest_p4_freshness --mutate: "
773
+ f"{len(_MUTATIONS) - len(bad)}/{len(_MUTATIONS)} 变异按预期转红")
774
+ return 0 if not bad else 1
775
+ fails = _collect()
776
+ print(f"\ntest_p4_freshness: {PASS} 通过 / {FAIL} 失败")
777
+ return 0 if not fails else 1
778
+
779
+
780
+ if __name__ == "__main__":
781
+ sys.exit(main(sys.argv[1:]))