@furongjun1999/dsh-memory 0.8.1 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -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 +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p47_session_view.py +25 -9
  437. package/md_cg/test_p4_freshness.py +8 -1
  438. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  439. package/md_cg/test_p9c_dedup_hints.py +7 -2
  440. package/md_cg/test_policy_required_ccg.py +12 -0
  441. package/md_cg/test_postings_digest_memo.py +139 -0
  442. package/md_cg/test_predict_beta.py +138 -135
  443. package/md_cg/test_qmd.py +500 -0
  444. package/md_cg/test_query_excerpt.py +209 -0
  445. package/md_cg/test_reach.py +456 -378
  446. package/md_cg/test_reach_snapshot_admission.py +218 -0
  447. package/md_cg/test_readcache_prodpath.py +4 -0
  448. package/md_cg/test_recall_face_guards.py +854 -812
  449. package/md_cg/test_recall_metadata.py +422 -0
  450. package/md_cg/test_retr_s5.py +104 -5
  451. package/md_cg/test_retr_score_once.py +14 -2
  452. package/md_cg/test_review_cli_attribution.py +11 -7
  453. package/md_cg/test_review_queue_batch.py +123 -0
  454. package/md_cg/test_review_queue_index.py +130 -0
  455. package/md_cg/test_rrf_candidates.py +292 -0
  456. package/md_cg/test_rrf_qualified_topk.py +214 -0
  457. package/md_cg/test_rrf_unique_votes.py +218 -0
  458. package/md_cg/test_s1_ast_judge.py +110 -0
  459. package/md_cg/test_scrub_ledger.py +413 -0
  460. package/md_cg/test_security_audit_b26.py +34 -3
  461. package/md_cg/test_security_audit_v21.py +1 -2
  462. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  463. package/md_cg/test_session5_identity.py +93 -0
  464. package/md_cg/test_session_attribution_consistency.py +813 -0
  465. package/md_cg/test_session_identity_tristate.py +486 -0
  466. package/md_cg/test_sleep_p1.py +35 -3
  467. package/md_cg/test_state_event_op.py +8 -1
  468. package/md_cg/test_state_projection_streaming.py +136 -0
  469. package/md_cg/test_stg_interval_candidates.py +280 -0
  470. package/md_cg/test_stg_time_blocks.py +239 -0
  471. package/md_cg/test_stgidx_index_parity.py +16 -12
  472. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  473. package/md_cg/test_sustain_bounded.py +30 -2
  474. package/md_cg/test_task_memory.py +394 -0
  475. package/md_cg/test_text_projection_mutations.py +101 -0
  476. package/md_cg/test_time_anchor.py +421 -0
  477. package/md_cg/test_time_core_lint.py +1024 -975
  478. package/md_cg/test_tool_face.py +200 -189
  479. package/md_cg/test_trust_bounded_frontier.py +248 -0
  480. package/md_cg/test_trust_edge_reachability.py +405 -0
  481. package/md_cg/test_w5_path_fingerprint.py +381 -0
  482. package/md_cg/test_w7_redlines.py +659 -0
  483. package/md_cg/test_write_return_shape.py +919 -0
  484. package/md_cg/test_writepipe.py +5 -3
  485. package/md_cg/timeanchor.py +534 -0
  486. package/md_cg/tokens.py +68 -5
  487. package/md_cg/tool_face.py +273 -260
  488. package/md_cg/trust.py +110 -26
  489. package/md_cg/twophase.py +74 -2
  490. package/md_cg/weights.py +642 -638
  491. package/md_cg/whitebox.py +9 -0
  492. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  493. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  494. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  495. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  496. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  497. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  498. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  499. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  500. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  501. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  502. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  503. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  504. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  505. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  506. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  507. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  508. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  509. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  510. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  511. package/md_cg/writelimit.py +584 -390
  512. package/md_cg/writepipe.py +587 -76
  513. package/package.json +13 -9
  514. package/src/bridge.ts +34 -11
  515. package/src/cli.ts +75 -65
  516. package/src/hooks.ts +908 -776
  517. package/src/index.ts +19 -5
  518. package/src/init.ts +362 -361
  519. package/src/lib/datapath.ts +419 -326
  520. package/src/lib/hook_audit.ts +256 -243
  521. package/src/lib/mdcg_client.ts +10 -2
  522. package/src/lib/mutual.ts +481 -432
  523. package/src/lib/prompt_safety.ts +164 -149
  524. package/src/lib/roleplay_web.ts +30 -2
  525. package/src/lib/token_store.ts +274 -52
  526. package/src/tools.ts +249 -223
  527. package/zcode/README.md +1 -1
  528. 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
  529. 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
  530. 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
  531. 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
  532. 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
  533. 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
  534. 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
  535. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  536. 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
  537. 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
  538. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  539. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  540. 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
  541. 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
  542. 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
  543. 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
  544. 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
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,548 +1,601 @@
1
- # -*- coding: utf-8 -*-
2
- """权重刷新与衰减(设计稿 §七 · P4)——**进主分数**的刷新/衰减乘子。
3
-
4
- 形态(§7.1 已裁)
5
- -----------------
6
- score ← score × cred_factor(γ, Δt) × refresh(access_count, last_access)
7
-
8
- 落位(§7.2 已裁):与「分池权重乘数」**同一乘子位**(`MdCG._score` 里
9
- `raw = clamp(raw * pooling.weight_of(...))` 那一行)——**不新开乘子链**。
10
- 本模块只提供**乘子本体与读点**,接线在 `mdcg._score`。
11
-
12
- **这条乘子影响哪些检索路**(读现场确认,2026-10-01):唯一生效点是
13
- `MdCG._score` ⇒ 走它的路全部受影响:
14
- · `MdCG.search` 的 T0–T3 各腿(桶内 LIKE / 全局 LIKE / 全局扫描);
15
- · `MdCos._lexical`(`search_rrf` 的 **lexical** 路)与 `_path_bucket`
16
- (bucket 路)。
17
- **不经** `_score` 的路因此**不受**本乘子影响:`entity`(恒 1.0)、`graph`
18
- (种子分 × 0.5)、`chain`、`temporal`、`fuzzy`、`semantic`、`goal`。
19
- Rust 侧同款:乘子只在 `sort_path(..., apply_freshness=true)` 生效,
20
- 而 `fuse` **只对 lexical 路**传 true(见 `rust/src/freshness.rs` 头注)。
21
-
22
- 核的唯一权威(硬约束)
23
- ----------------------
24
- `md_cg/whitebox_kb/aeis_core/time_core.py` 的 `cred_factor` ——该模块 docstring
25
- 逐字点名「任何在本模块之外出现的衰减核实现(`exp(-t/τ)`、`×(1-factor)`、
26
- EMA 保持率)都是 bug」。本模块**不写任何指数核**(`math.exp` 一次都不出现)。
27
-
28
- γ 与 Δt 口径(§〇.3-12 已裁)
29
- -----------------------------
30
- · γ 缺省 = `ln2 / 30 天`(半衰期 30 天,与 `links.DECAY_DAYS` 同刻度);
31
- **唯一读取点**是 `mdcos.temporal_gamma()`(P3-temporal 已落),本模块复用
32
- **不新建第二个 γ 读取点**(env `MDCG_TEMPORAL_GAMMA` 同时覆盖两条路)。
33
- · Δt 取 `created_at`(写入时刻,主链必有)。
34
- · **单位必须是「天」**:γ 是「每天」的速率,Δt 先 /86400 再喂;喂秒会让衰减
35
- 快 86400 倍。单位常量与断言面见 `DT_UNIT` 与 `md_cg/test_p4_freshness.py`。
36
-
37
- 刷新参数**照抄**(不自行发明)
38
- ------------------------------
39
- AEIS `consolidate_cycle(rehearsal_threshold=0.7, degrade_threshold=0.2,
40
- gain=0.01)`(`md_cg/whitebox_kb/aeis_core/core.py:4801-4831`,docstring 逐字
41
- 「P1-4 巩固周期:高重要度演练(刷新访问)+ 低重要度降权 + 压缩候选标记」):
42
-
43
- · 刷新:`importance ≥ 0.7` → 计入演练;且 `access_count % 10 == 0` → +gain;
44
- · 降权:`importance < 0.2` 且 `access_count ≤ 2` → −gain;
45
- · 跳过:`anchor`/`structure` 层、`protected`/`no_forget`(本模块同款跳过——
46
- 受保护节点不因衰减穿越保护线,见 §7.3)。
47
-
48
- floor(§7.3 · 移植隐患的第二道闸)
49
- ----------------------------------
50
- AEIS 的 `decay_cycle` **无 floor**,而 md_cg 的保护判定是**即时读
51
- `importance ≥ 0.70`**(`md_cg/protect.py:135-151`、`weights.IMPORTANCE_PROTECT`)
52
- ⇒ 衰减穿过 0.70 会让节点**自动失去保护**。故:
53
-
54
- · 衰减项带 floor(`SCORE_FLOOR`,与 P3-temporal 同值同源理由);
55
- · **受保护节点**的衰减乘子另有下界 `IMPORTANCE_PROTECT / importance`,
56
- 保证 `importance × 乘子 ≥ IMPORTANCE_PROTECT` **恒成立**——保护判定不可能
57
- 被衰减翻转(推导见 `protected_floor`);
58
- · 保留 `weights.recalc` 既有的「`after ≥ 0.70` 自动补写 `protected`」行为
59
- (本模块**不改** `weights.recalc`,只在守卫里断言其仍在位)。
60
-
61
- 语义边界(§7.3 末条,记忆里那条裁定)
62
- -------------------------------------
63
- **不可遗忘 ≠ 不可覆盖**。衰减属「降级/搬迁」族:
64
- · 降级**不得实现为删除记录**——`recalc(apply=True)` 只写
65
- `frontmatter.freshness_weight` 与 `freshness_state`,**从不删节点**;
66
- · 需要跨层降级时走既有 `_move_layer`(其内已调 `protect.guard_move`),
67
- **不新写搬迁路径**;受保护节点被移出保护层仍需显式 `override=True`
68
- (`guard_move` 原样语义)。
69
-
70
- 三件套(§7.4,与 `weights.recalc` 同款)
71
- ----------------------------------------
72
- 预演(`recalc(apply=False)`)→ 逐节点留痕(`_maintain.jsonl`,
73
- `action="freshness"`,与 `weights` 的 `action="importance"` 同族)→ 反向
74
- apply(`rollback`,读回 `before` 并再记一条 `freshness_rollback`)。
75
- AEIS 侧**没有**预演与回滚(`consolidate_cycle`/`decay_cycle` 均无)——
76
- 这是移植时的**净增工作量**,不省。
77
-
78
- 零第三方依赖。
79
- """
80
- from __future__ import annotations
81
-
82
- import os
83
- import time
84
-
85
- from .fsutil import append_jsonl, read_jsonl
86
- # `_maintain.jsonl` 与保护下限的**单一真源**在 weights(同族留痕共用一份文件名)
87
- from .weights import (APPLY_DELTA, IMPORTANCE_PROTECT, MAINTAIN_LOG,
88
- node_importance)
89
- from .whitebox_kb.aeis_core import time_core as _tc
90
-
91
- # --------------------------------------------------------------------------
92
- # 参数(照抄 AEIS consolidate_cycle;出处见模块 docstring)
93
- # --------------------------------------------------------------------------
94
-
95
- #: AEIS `consolidate_cycle` 的三个既有取值 + 两个结构常数(逐字照抄,不发明)。
96
- REFRESH_PARAMS = {
97
- "rehearsal_threshold": 0.7, # importance ≥ 此值 → 高重要度演练(刷新)
98
- "degrade_threshold": 0.2, # importance < 此值 且 access_count ≤ 2 → 降权
99
- "gain": 0.01, # 每档步长(AEIS 原有)
100
- "cycle": 10, # access_count % 10 == 0 才 +gain(AEIS 原有)
101
- "degrade_max_access": 2, # 低重要度降权的访问数上限(AEIS 原有)
102
- "source": ("md_cg/whitebox_kb/aeis_core/core.py:4801-4831 "
103
- "consolidate_cycle(rehearsal_threshold=0.7, "
104
- "degrade_threshold=0.2, gain=0.01)"),
105
- }
106
-
107
- #: Δt 的单位(**最易错处**):γ 是「每天」的速率,Δt 必须按天喂。
108
- DT_UNIT = "day"
109
- SECONDS_PER_DAY = 86400.0
110
-
111
- #: Δt 的**粒度**:整日(向下取整)。为什么量化(本批的一处设计取舍,如实登记):
112
- #: ① γ 的单位本来就是「天」(半衰期 30 天档),亚日精度对结果无信息量;
113
- #: ② 仓内有「同查询两轮结果逐位一致 / 可复算」的硬纪律
114
- #: (`md_cg/test_retr_score_once.py` D1b 就是这条断言)——不量化则分数随
115
- #: `time.time()` 逐轮微变,两轮比较恒不等;
116
- #: ③ 两侧(Python / Rust)各自取时钟,量化到同一「天」桶后跨语言同值,
117
- #: 消除 ms 级时钟差带来的 6 位小数抖动风险。
118
- #: 量化损失上界 = γ × 1 天 = ln2/30 ≈ 2.3%(即「同一天内不再区分」)。
119
- DT_QUANTUM_DAYS = 1.0
120
-
121
- #: 衰减项 floor:`cred_factor(gamma, dt, floor, ceil)` 的 floor。
122
- #: 取值理由与 P3-temporal 同源(0.5**10 ≈ 9.77e-4 < 1e-3 —— 30 天半衰期下
123
- #: 300 天 = 10 个半衰期后继续区分已无信息量);floor 让**老节点/缺 created_at
124
- #: 的节点**仍带非零分参与排序,而不是被乘成 0 后不可召回。
125
- SCORE_FLOOR = 0.001
126
-
127
- #: 衰减乘子上限(乘子恒 ≤ 1.0:衰减只能降权,刷新项负责 > 1 的那半边)。
128
- SCORE_CEIL = 1.0
129
-
130
- #: 总开关(缺省开;=0 时乘子恒为 1.0 ⇒ 与改动前逐位一致,是「可回退」的
131
- #: 第一道闸——第二道是三件套的 rollback)。
132
- FRESHNESS_ENV = "MDCG_FRESHNESS"
133
-
134
- #: 观测时刻的可复算冻结口(**只为守卫/探针的确定性**;未设 = `time.time()`)。
135
- #: 有了它,两侧探针能在同一 `now` 上逐位比对乘子。
136
- NOW_ENV = "MDCG_FRESHNESS_NOW"
137
-
138
- #: 降级判定面(`recalc` 用):乘子低于此值的节点标记 `freshness_state`
139
- #: = "degraded"(**只标记,不删除**——见模块 docstring 的语义边界)。
140
- DEMOTE_BELOW = 0.5
141
-
142
-
143
- # 生效条件:environ(缺省 os.environ)里 FRESHNESS_ENV 为真值且归一后属 {"0","false","no","off"} 之外的值时返回 True;变量缺失/空串/命中关闭词表时返回 False;
144
- def enabled(environ=None) -> bool:
145
- """刷新/衰减乘子是否生效(缺省**开**:§7.2「进主分数」)。"""
146
- raw = (environ or os.environ).get(FRESHNESS_ENV)
147
- if raw is None or str(raw).strip() == "":
148
- return True
149
- return str(raw).strip().lower() not in ("0", "false", "no", "off")
150
-
151
-
152
- # 生效条件:environ(缺省 os.environ)里 NOW_ENV 可 float() 解析时返回该浮点值;缺失/空串/不可解析时返回 time.time();
153
- def freshness_now(environ=None) -> float:
154
- """乘子用的「当前时刻」(unix 秒)。**单一读取点**(守卫与探针共用)。"""
155
- raw = (environ or os.environ).get(NOW_ENV)
156
- if raw:
157
- try:
158
- return float(raw)
159
- except (TypeError, ValueError):
160
- return time.time()
161
- return time.time()
162
-
163
-
164
- # 生效条件:gamma 非正或不可转 float 时回落 `mdcos.temporal_gamma()`;否则返回 float(gamma);无 IO、无副作用;
165
- def resolve_gamma(gamma=None) -> float:
166
- """γ 的解析(缺省回落 **P3 的同一读取点** `mdcos.temporal_gamma()`)。"""
167
- if gamma is not None:
168
- try:
169
- g = float(gamma)
170
- if g > 0:
171
- return g
172
- except (TypeError, ValueError):
173
- pass
174
- from .mdcos import temporal_gamma # 懒导入:避免模块级循环依赖
175
- return temporal_gamma()
176
-
177
-
178
- # --------------------------------------------------------------------------
179
- # 核(一律经 time_core;本模块不写指数核)
180
- # --------------------------------------------------------------------------
181
-
182
- # 生效条件:gamma 与 dt_days(单位=天)任意可转 float 时,返回 time_core.cred_factor(gamma, dt_days, floor, ceil);dt 非有限值(inf/nan)时同样交给 cred_factor(inf → 取 floor);enabled 为 None(缺省)时自算(模块级 enabled()),显式传 bool 时按传入值——两者皆假值即恒返回 1.0;
183
- def decay_factor(gamma: float, dt_days: float, floor: float = SCORE_FLOOR,
184
- ceil: float = SCORE_CEIL, enabled=None) -> float:
185
- """时间衰减乘子 `e^(-γ·Δt)`(**核来自唯一权威** `time_core.cred_factor`)。
186
-
187
- ⚠ `dt_days` 的单位**必须**是「天」(`DT_UNIT`);调用方负责换算,
188
- 换算单点是 `entry_weight`(`(now - created_at) / SECONDS_PER_DAY`)。
189
-
190
- `enabled`(N274):None=自算(默认,行为与改动前逐位一致);显式传
191
- bool 时不再自算——供 `entry_weight`/`_score` 把开关**循环外解析一次**
192
- 后透传,消掉逐节点 env 读取。自算分支写 `globals()["enabled"]()` 而非
193
- 直接 `enabled()`:形参同名会遮蔽模块函数,而 `globals()` 的解析语义与
194
- 改前那句 `enabled()` 逐位一致(含测试对模块函数的打桩/替换面)。
195
- """
196
- if enabled is None:
197
- enabled = globals()["enabled"]()
198
- if not enabled:
199
- return 1.0
200
- return _tc.cred_factor(float(gamma), float(dt_days), float(floor),
201
- float(ceil))
202
-
203
-
204
- # 生效条件:access_count 与 last_access 任意(不可转数值按 0 处理)、importance 任意可转 float;enabled 为 None(缺省)时自算(模块级 enabled()),显式传 bool 时按传入值——两者皆假值即恒返回 1.0;否则按 REFRESH_PARAMS 的三档判定返回 1.0+gain / 1.0−gain / 1.0;
205
- def refresh_factor(access_count=0, last_access=0, importance=0.0,
206
- enabled=None) -> float:
207
- """访问刷新/降权乘子(**门槛与步长照抄 AEIS** `consolidate_cycle`)。
208
-
209
- 判定序(与 AEIS 同序同门):
210
-
211
- 1. **刷新**:`importance ≥ rehearsal_threshold` 且 `access_count % 10 == 0`
212
- 且 `last_access > 0`(真的被访问过)→ `1 + gain`;
213
- 2. **降权**:`importance < degrade_threshold` 且
214
- `access_count ≤ degrade_max_access` → `1 − gain`;
215
- 3. 其余 → `1.0`。
216
-
217
- `last_access > 0` 这一条是本模块对 AEIS 的唯一补足:AEIS 的 `% 10 == 0`
218
- 在**从未被访问**(`access_count == 0`)时也为真——照抄原样会让「刚写、
219
- 从未调用的高重要度节点」白拿一次刷新。加此闸后「未被调用」只能不刷新,
220
- 不会反被奖励(语义仍与 §7.1「被经常调用的记忆其权重被刷新」一致)。
221
-
222
- `enabled`(N274):None=自算(默认,行为与改动前逐位一致);显式传
223
- bool 时不再自算——与 `decay_factor` 同一透传口径(见其 docstring)。
224
- """
225
- if enabled is None:
226
- enabled = globals()["enabled"]()
227
- if not enabled:
228
- return 1.0
229
- p = REFRESH_PARAMS
230
- try:
231
- ac = int(float(access_count or 0))
232
- la = float(last_access or 0)
233
- imp = float(importance or 0.0)
234
- except (TypeError, ValueError):
235
- return 1.0
236
- if imp >= p["rehearsal_threshold"] and la > 0 and ac % p["cycle"] == 0:
237
- return 1.0 + p["gain"]
238
- if imp < p["degrade_threshold"] and ac <= p["degrade_max_access"]:
239
- return 1.0 - p["gain"]
240
- return 1.0
241
-
242
-
243
- # 生效条件:entry 为可取 protected / importance 的映射;protected 为假值时返回 SCORE_FLOOR;为真值时返回 max(SCORE_FLOOR, min(1.0, IMPORTANCE_PROTECT / importance))(importance 不可转数值或 ≤0 时按 1.0 处理);
244
- def protected_floor(entry) -> float:
245
- """受保护节点的**衰减乘子下界**(§7.3 的第二道闸)。
246
-
247
- 推导(为什么是 `IMPORTANCE_PROTECT / importance`):
248
- md_cg 的保护判定是**即时读** `importance ≥ IMPortANCE_PROTECT(0.70)`
249
- (`protect.py` / `weights.py`)。衰减乘子 `m ≤ 1` 会让
250
- `importance × m < 0.70` ⇒ 节点**自动失去保护**(AEIS 移植的隐患)。
251
- 取 `m ≥ 0.70 / importance`,则 `importance × m ≥ 0.70` **恒成立**——
252
- 保护判定不可能被衰减翻转。
253
- 下界被夹到 ≤ 1.0:`importance < 0.70` 的受保护节点(人工 `protect.mark`)
254
- 乘子取 1.0(不衰减),同样不损失保护。
255
- """
256
- e = entry or {}
257
- if not e.get("protected"):
258
- return SCORE_FLOOR
259
- try:
260
- imp = float(e.get("importance") or 0.0)
261
- except (TypeError, ValueError):
262
- imp = 0.0
263
- if imp <= 0:
264
- imp = 1.0
265
- return max(SCORE_FLOOR, min(1.0, IMPORTANCE_PROTECT / imp))
266
-
267
-
268
- # 生效条件:entry 为可取 created_at / access_count / last_access / importance / protected 的映射;fm 为真值时上述五个键优先取自 fm(缺键回落 entry);now 为假值(None)时取 freshness_now();enabled 为 None(缺省)时自算(模块级 enabled()),显式传 bool 时按传入值——两者皆假值即早退返回 (1.0, {"disabled": True})(早退先于 now/γ 解析,与改前同序);否则无条件返回 (乘子, 依据 dict)——乘子 = decay_factor(gamma, |now-created_at|/86400, protected_floor(取数后的映射), SCORE_CEIL, enabled=…) × refresh_factor(..., enabled=…);created_at 缺失/不可转数值/≤0 时 dt_days 取 inf(判「距参照无穷远」,由 floor 兜住);
269
- def entry_weight(entry, now=None, gamma=None, fm=None, enabled=None) -> tuple:
270
- """索引条目 → 分数乘子 `(乘子, 依据)`(**检索期唯一取数点**,免读文件)。
271
-
272
- `entry` 直接来自索引快照(`_node_entry` 已落 `created_at` /
273
- `access_count` / `last_access`)——**不读盘**(§7.2 卡点一)。
274
-
275
- `fm` 为可选覆盖源(写面刚落的 frontmatter 可能比索引条目新):只为
276
- 避免在热路径上拷贝 dict 而设,取数优先级 `fm > entry > 缺省`。
277
-
278
- `enabled`(N274):None=自算(默认,行为与改动前逐位一致);显式传
279
- bool 时不再自算,且向下透传给 `decay_factor`/`refresh_factor`——它们
280
- 同样不再各自读 env。自算分支经 `globals()["enabled"]()`(形参遮蔽,
281
- 解析语义同改前的 `enabled()`,见 `decay_factor` 同注)。
282
- """
283
- e = entry or {}
284
- keys = ("created_at", "access_count", "last_access", "importance",
285
- "protected")
286
- if fm is not None:
287
- src = {k: (fm.get(k) if fm.get(k) is not None else e.get(k))
288
- for k in keys}
289
- else:
290
- src = {k: e.get(k) for k in keys}
291
- if enabled is None:
292
- enabled = globals()["enabled"]()
293
- if not enabled:
294
- return 1.0, {"disabled": True}
295
- g = resolve_gamma(gamma)
296
- ref = freshness_now() if now is None else float(now)
297
- try:
298
- created = float(src.get("created_at") or 0.0)
299
- except (TypeError, ValueError):
300
- created = 0.0
301
- if created <= 0:
302
- dt_days = float("inf") # 无写入时刻:不猜测,判无穷远
303
- else:
304
- # **单位=天**:86400 秒/天,显式换算(γ 是每天速率)
305
- dt_days = abs(ref - created) / SECONDS_PER_DAY
306
- # **粒度=整日**(向下取整):保证「同查询两轮逐位一致」(不随 wall clock
307
- # 微变)且两侧跨语言同值。详见 DT_QUANTUM_DAYS 的说明。
308
- dt_days = float(int(dt_days / DT_QUANTUM_DAYS)) * DT_QUANTUM_DAYS
309
- floor = protected_floor(src)
310
- d = decay_factor(g, dt_days, floor, SCORE_CEIL, enabled=enabled)
311
- r = refresh_factor(src.get("access_count"), src.get("last_access"),
312
- src.get("importance"), enabled=enabled)
313
- return d * r, {"gamma": g, "dt_days": dt_days, "unit": DT_UNIT,
314
- "decay": d, "refresh": r, "floor": floor,
315
- "protected": bool(src.get("protected"))}
316
-
317
-
318
- # --------------------------------------------------------------------------
319
- # 三件套:预演 / 逐节点留痕 / 反向 apply(与 weights.recalc 同款)
320
- # --------------------------------------------------------------------------
321
-
322
- # 生效条件:cg.index["nodes"] 为 dict 时按 layer 过滤、limit 为真值才截断;dry-run 只出报表(**不接档位闸**——零写盘面照旧);apply=True 时先经 autonomy_modes.e_gate() 档位判定(补强批次 v1.2·E 面接线,位置=任何盘面写入之前):非 ALLOW(plan 档无计划)即经 forbidden_result() fail-closed 早退(零写盘、零审计行、带 hint),ALLOW(confirm/full)则逐节点把乘子(round 6)写入 frontmatter.freshness_weight 与 freshness_components,乘子 < DEMOTE_BELOW 时另写 freshness_state="degraded"(**只标记,不删记录**),乘子下降且 demote_layer 给定时经 cg._move_layer(内含 protect.guard_move)搬迁;每条 append_jsonl(action="freshness") 后 rebuild_index;返回报表 dict;
323
- def recalc(cg, layer=None, limit=None, apply=False, min_delta=APPLY_DELTA,
324
- actor="maintain", dry_run_samples=10, now=None, demote_layer=None):
325
- """刷新/衰减权重的重算(**可预演 + 逐节点留痕 + 可回滚**)。
326
-
327
- apply=False(默认)只出报表,**零写盘**。
328
- apply=True 逐节点改写 `frontmatter.freshness_weight`;每节点一条
329
- `_maintain.jsonl`(`action="freshness"`,与 `weights` 的 `importance`
330
- 同族),并提供 `rollback` 反向应用。
331
-
332
- ⚠ 本函数**从不删除节点**(§7.3「降级不得实现为删除记录」):降级只落
333
- `freshness_state="degraded"` 标记;要搬迁层位时给出 `demote_layer`,
334
- 走既有 `_move_layer`(其内已调 `protect.guard_move`,受保护节点需显式
335
- `override`)——不新写第二条搬迁路径。
336
-
337
- **档位闸(补强批次 v1.2·E 面接线)**:`apply=True` 的**写盘前**先经
338
- `autonomy_modes.e_gate()`(设计 §三 plan 档 E「须命中计划步骤」)——
339
- plan 档无计划 ⇒ `forbidden_result()` fail-closed 早退(零写盘、零审计行);
340
- confirm/full ⇒ ALLOW,**原链原样**(逐位不变)。`apply=False`(预演)
341
- 不接闸:零写盘面不属「变更」。
342
- """
343
- nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
344
- ids = [nid for nid, e in list(nodes.items())
345
- if not layer or e.get("layer") == layer]
346
- ids.sort()
347
- if limit:
348
- ids = ids[:int(limit)]
349
- ref = freshness_now() if now is None else float(now)
350
- batch = time.strftime("%Y%m%d-%H%M%S")
351
- planned, samples = [], []
352
- before_sum = after_sum = 0.0
353
- changed = unchanged = skipped = 0
354
- by_layer = {}
355
- for nid in ids:
356
- e = nodes.get(nid) or {}
357
- w, why = entry_weight(e, now=ref)
358
- before = float(e.get("freshness_weight") or 1.0)
359
- before_sum += before
360
- after_sum += w
361
- lay = e.get("layer") or "?"
362
- bl = by_layer.setdefault(lay, {"nodes": 0, "changed": 0})
363
- bl["nodes"] += 1
364
- if abs(w - before) < float(min_delta):
365
- unchanged += 1
366
- continue
367
- changed += 1
368
- bl["changed"] += 1
369
- plan = {"node_id": nid, "layer": lay, "batch": batch,
370
- "before": round(before, 6), "after": round(w, 6),
371
- "delta": round(w - before, 6), "why": why,
372
- "protected": bool(e.get("protected")),
373
- # 降级判定(只标记):低于阈值即为 degraded 候选
374
- "degrade": bool(w < DEMOTE_BELOW)}
375
- planned.append(plan)
376
- if len(samples) < int(dry_run_samples):
377
- samples.append(plan)
378
- written, degraded = 0, 0
379
- if apply:
380
- # 三档自治(补强批次 v1.2·E 面接线,设计 §三 plan 档 E「须命中计划步骤」):
381
- # E 类动作**写盘前**的档位判定单点。本函数无独立资格闸(逐节点取数在下方
382
- # 循环里、取不到即 skip),故闸口取「进入写盘支路的第一行」=任何盘面写入
383
- # 之前;放行分支即原链原样(confirm/full 逐位不变),plan 档无计划
384
- # ⇒ fail-closed 早退,**零写盘、零 _maintain.jsonl 行**。
385
- from . import autonomy_modes as _am
386
- _dec = _am.e_gate()
387
- if _dec["decision"] != _am.ALLOW:
388
- return _am.forbidden_result(_dec, action="freshness", dry_run=False,
389
- written=0, batch=batch)
390
- if demote_layer:
391
- bind_move_layer(cg) # 跨层降级走既有 _move_layer(现绑)
392
- for plan in planned:
393
- nid = plan["node_id"]
394
- node = cg.get(nid)
395
- if not node:
396
- skipped += 1
397
- continue
398
- fm = node.get("frontmatter") or {}
399
- fm["freshness_weight"] = plan["after"]
400
- fm["freshness_source"] = "freshness_recalc"
401
- fm["freshness_components"] = plan["why"]
402
- if plan["degrade"]:
403
- # **降级 = 标记**(不是删除记录):节点与正文原样保留
404
- fm["freshness_state"] = "degraded"
405
- degraded += 1
406
- path = os.path.join(cg.root, (nodes.get(nid) or {}).get("path")
407
- or node.get("path") or f"{nid}.md")
408
- cg._write_node(nid, path, fm, node.get("content") or "")
409
- e = nodes.get(nid)
410
- if e is not None:
411
- e["freshness_weight"] = plan["after"]
412
- e["freshness_state"] = fm.get("freshness_state")
413
- rec = {"t": time.time(), "action": "freshness", "batch": batch,
414
- "id": nid, "layer": plan["layer"],
415
- "before": plan["before"], "after": plan["after"],
416
- "delta": plan["delta"], "degrade": plan["degrade"],
417
- "why": plan["why"], "actor": actor}
418
- append_jsonl(os.path.join(cg.root, MAINTAIN_LOG), rec)
419
- written += 1
420
- # 跨层降级:走后缀既有 `_move_layer`(内含 protect.guard_move)
421
- if demote_layer and plan["degrade"] and _move_layer is not None:
422
- try:
423
- _move_layer(nid, demote_layer,
424
- reason=f"freshness degraded (w={plan['after']})")
425
- except Exception as exc: # noqa: BLE001
426
- plan["move_error"] = f"{type(exc).__name__}: {exc}"
427
- if written and hasattr(cg, "rebuild_index"):
428
- cg.rebuild_index()
429
- n = max(1, len(ids))
430
- return {
431
- "ok": True, "action": "freshness", "dry_run": not apply, "batch": batch,
432
- "nodes_scanned": len(ids), "changed": changed, "unchanged": unchanged,
433
- "skipped": skipped, "written": written, "degraded": degraded,
434
- "min_delta": float(min_delta), "now": ref,
435
- "gamma": resolve_gamma(), "unit": DT_UNIT,
436
- "avg_before": round(before_sum / n, 4),
437
- "avg_after": round(after_sum / n, 4),
438
- "by_layer": dict(by_layer), "samples": samples, "log": MAINTAIN_LOG,
439
- "note": ("dry-run:未写盘;apply=True 才写 freshness_weight"
440
- if not apply else
441
- f"已写 {written} 个节点(降级标记 {degraded});"
442
- f"回滚见 rollback(batch={batch})"),
443
- }
444
-
445
-
446
- #: 惰性持有的跨层降级入口(`MdCG._move_layer` 是实例方法:`recalc` 里现取)。
447
- #: 这里保留模块级名字只为**可读性**(下方 `_bind_move_layer` 现绑)。
448
- _move_layer = None
449
-
450
-
451
- # 生效条件:cg 具备可调用的 _move_layer 时把 recalc 用的跨层降级入口绑定为该实例方法,返回 True;否则返回 False(降级只标记、不搬迁);
452
- def bind_move_layer(cg) -> bool:
453
- """把 `recalc(..., demote_layer=...)` 用的搬迁入口绑到实例方法上。
454
-
455
- 为什么需要它:`recalc` 是**模块级函数**(与 `weights.recalc` 同构),而
456
- `_move_layer` 是实例方法。不新写第二条搬迁路径 ⇒ 只能绑既有那一条。
457
- """
458
- global _move_layer
459
- fn = getattr(cg, "_move_layer", None)
460
- _move_layer = fn if callable(fn) else None
461
- return _move_layer is not None
462
-
463
-
464
- # 生效条件:cg.root/MAINTAIN_LOG 可读出 action=="freshness" 记录后,entry_ids 为真值时按记录 id 过滤;否则 batch 为真值时按 r.get("batch")==batch 过滤;否则取最后一条记录的 batch 再按其过滤;无记录返回 {"ok":False,"error":"no_records","reverted":0},过滤后无记录返回 {"ok":False,"error":"batch_not_found",...};对命中且 cg.get(nid) 为真的记录写回 rec.get("before") 到 frontmatter.freshness_weight(**只改这一列,不删节点**),若 reverted 且 cg 有 rebuild_index 则调用,最后 append_jsonl 写 action="freshness_rollback" 并返回 {"ok":True,"batch":batch,"reverted":reverted,"ids":ids};
465
- def rollback(cg, batch=None, entry_ids=None, actor="maintain"):
466
- """把刷新/衰减反向应用(三件套的第三件;AEIS 侧没有,属净增)。"""
467
- log_path = os.path.join(cg.root, MAINTAIN_LOG)
468
- records = [r for r in read_jsonl(log_path)
469
- if r.get("action") == "freshness"]
470
- if not records:
471
- return {"ok": False, "error": "no_records", "reverted": 0}
472
- if entry_ids:
473
- want = {str(x) for x in entry_ids}
474
- records = [r for r in records if str(r.get("id")) in want]
475
- elif batch:
476
- records = [r for r in records if r.get("batch") == batch]
477
- else:
478
- batch = records[-1].get("batch")
479
- records = [r for r in records if r.get("batch") == batch]
480
- if not records:
481
- return {"ok": False, "error": "batch_not_found", "batch": batch,
482
- "reverted": 0}
483
- nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
484
- reverted, ids = 0, []
485
- for rec in records:
486
- nid = rec.get("id")
487
- node = cg.get(nid)
488
- if not node:
489
- continue
490
- fm = node.get("frontmatter") or {}
491
- fm["freshness_weight"] = rec.get("before")
492
- fm["freshness_source"] = "freshness_rollback"
493
- # 降级标记随回滚撤销(回到降级前状态);**节点与正文一字不动**
494
- if not rec.get("degrade"):
495
- fm.pop("freshness_state", None)
496
- path = os.path.join(cg.root, (nodes.get(nid) or {}).get("path")
497
- or node.get("path") or f"{nid}.md")
498
- cg._write_node(nid, path, fm, node.get("content") or "")
499
- e = nodes.get(nid)
500
- if e is not None:
501
- e["freshness_weight"] = rec.get("before")
502
- reverted += 1
503
- ids.append(nid)
504
- if reverted and hasattr(cg, "rebuild_index"):
505
- cg.rebuild_index()
506
- append_jsonl(log_path, {"t": time.time(), "action": "freshness_rollback",
507
- "batch": batch, "reverted": reverted,
508
- "actor": actor})
509
- return {"ok": True, "batch": batch, "reverted": reverted, "ids": ids}
510
-
511
-
512
- # 生效条件:cg.root/MAINTAIN_LOG 可读出 JSONL 记录后,仅取 action=="freshness" 的记录并返回其尾部 int(limit) 条(limit 为 0 时返回全部);
513
- def history(cg, limit=100) -> list:
514
- """刷新/衰减留痕(最近 limit 条)。"""
515
- recs = [r for r in read_jsonl(os.path.join(cg.root, MAINTAIN_LOG))
516
- if r.get("action") == "freshness"]
517
- return recs[-int(limit):]
518
-
519
-
520
- # 生效条件:无条件返回模块自描述 dict(公式 / 核出处 / γ 口径 / 单位 / floor / 参数出处 / 开关 / 三件套名),供守卫与文档对拍;
521
- def catalog() -> dict:
522
- return {"formula": "score ← score × cred_factor(γ, Δt) × refresh(ac, la)",
523
- "core": "md_cg/whitebox_kb/aeis_core/time_core.py::cred_factor",
524
- "gamma_default": "ln2 / links.DECAY_DAYS(=30 天)",
525
- "dt_unit": DT_UNIT, "dt_source": "created_at",
526
- "score_floor": SCORE_FLOOR, "score_ceil": SCORE_CEIL,
527
- "refresh_params": dict(REFRESH_PARAMS),
528
- "protect_floor": "IMPORTANCE_PROTECT/importance(受保护节点)",
529
- "enabled_env": FRESHNESS_ENV, "now_env": NOW_ENV,
530
- "triplet": ["recalc(apply=False)", "_maintain.jsonl",
531
- "rollback()"]}
532
-
533
-
534
- # 生效条件:无条件返回模块自检 dict——核来自 time_core(本模块源码不含指数核调用)、单位常量为天、参数出处非空、weights 侧的保护下限可读;
535
- def selfcheck() -> dict:
536
- """模块自检(守卫的第一条断言面)。"""
537
- src = open(os.path.abspath(__file__), encoding="utf-8").read()
538
- # 探针串拼接(不写字面量):否则「检查用的字面量」本身会把检查判红
539
- needle = "math." + "exp("
540
- return {"core_is_time_core": "from .whitebox_kb.aeis_core import time_core"
541
- in src,
542
- "no_local_exp_core": needle not in src,
543
- "uses_cred_factor": "cred_factor" in src,
544
- "dt_unit": DT_UNIT,
545
- "params_source_set": bool(REFRESH_PARAMS.get("source")),
546
- "gain": REFRESH_PARAMS["gain"],
547
- "protect_floor": IMPORTANCE_PROTECT,
548
- "node_importance_available": callable(node_importance)}
1
+ # -*- coding: utf-8 -*-
2
+ """权重刷新与衰减(设计稿 §七 · P4)——**进主分数**的刷新/衰减乘子。
3
+
4
+ 形态(§7.1 已裁)
5
+ -----------------
6
+ score ← score × cred_factor(γ, Δt) × refresh(access_count, last_access)
7
+
8
+ 落位(§7.2 已裁):与「分池权重乘数」**同一乘子位**(`MdCG._score` 里
9
+ `raw = clamp(raw * pooling.weight_of(...))` 那一行)——**不新开乘子链**。
10
+ 本模块只提供**乘子本体与读点**,接线在 `mdcg._score`。
11
+
12
+ **这条乘子影响哪些检索路**(读现场确认,2026-10-01):唯一生效点是
13
+ `MdCG._score` ⇒ 走它的路全部受影响:
14
+ · `MdCG.search` 的 T0–T3 各腿(桶内 LIKE / 全局 LIKE / 全局扫描);
15
+ · `MdCos._lexical`(`search_rrf` 的 **lexical** 路)与 `_path_bucket`
16
+ (bucket 路)。
17
+ **不经** `_score` 的路因此**不受**本乘子影响:`entity`(恒 1.0)、`graph`
18
+ (种子分 × 0.5)、`chain`、`temporal`、`fuzzy`、`semantic`、`goal`。
19
+ Rust 侧同款:乘子只在 `sort_path(..., apply_freshness=true)` 生效,
20
+ 而 `fuse` **只对 lexical 路**传 true(见 `rust/src/freshness.rs` 头注)。
21
+
22
+ 核的唯一权威(硬约束)
23
+ ----------------------
24
+ `md_cg/whitebox_kb/aeis_core/time_core.py` 的 `cred_factor` ——该模块 docstring
25
+ 逐字点名「任何在本模块之外出现的衰减核实现(`exp(-t/τ)`、`×(1-factor)`、
26
+ EMA 保持率)都是 bug」。本模块**不写任何指数核**(`math.exp` 一次都不出现)。
27
+
28
+ γ 与 Δt 口径(§〇.3-12 已裁)
29
+ -----------------------------
30
+ · γ 缺省 = `ln2 / 30 天`(半衰期 30 天,与 `links.DECAY_DAYS` 同刻度);
31
+ **唯一读取点**是 `mdcos.temporal_gamma()`(P3-temporal 已落),本模块复用
32
+ **不新建第二个 γ 读取点**(env `MDCG_TEMPORAL_GAMMA` 同时覆盖两条路)。
33
+ · Δt 取 `created_at`(写入时刻,主链必有)。
34
+ · **单位必须是「天」**:γ 是「每天」的速率,Δt 先 /86400 再喂;喂秒会让衰减
35
+ 快 86400 倍。单位常量与断言面见 `DT_UNIT` 与 `md_cg/test_p4_freshness.py`。
36
+
37
+ 刷新参数**照抄**(不自行发明)
38
+ ------------------------------
39
+ AEIS `consolidate_cycle(rehearsal_threshold=0.7, degrade_threshold=0.2,
40
+ gain=0.01)`(`md_cg/whitebox_kb/aeis_core/core.py:4801-4831`,docstring 逐字
41
+ 「P1-4 巩固周期:高重要度演练(刷新访问)+ 低重要度降权 + 压缩候选标记」):
42
+
43
+ · 刷新:`importance ≥ 0.7` → 计入演练;且 `access_count % 10 == 0` → +gain;
44
+ · 降权:`importance < 0.2` 且 `access_count ≤ 2` → −gain;
45
+ · 跳过:`anchor`/`structure` 层、`protected`/`no_forget`(本模块同款跳过——
46
+ 受保护节点不因衰减穿越保护线,见 §7.3)。
47
+
48
+ floor(§7.3 · 移植隐患的第二道闸)
49
+ ----------------------------------
50
+ AEIS 的 `decay_cycle` **无 floor**,而 md_cg 的保护判定是**即时读
51
+ `importance ≥ 0.70`**(`md_cg/protect.py:135-151`、`weights.IMPORTANCE_PROTECT`)
52
+ ⇒ 衰减穿过 0.70 会让节点**自动失去保护**。故:
53
+
54
+ · 衰减项带 floor(`SCORE_FLOOR`,与 P3-temporal 同值同源理由);
55
+ · **受保护节点**的衰减乘子另有下界 `IMPORTANCE_PROTECT / importance`,
56
+ 保证 `importance × 乘子 ≥ IMPORTANCE_PROTECT` **恒成立**——保护判定不可能
57
+ 被衰减翻转(推导见 `protected_floor`);
58
+ · 保留 `weights.recalc` 既有的「`after ≥ 0.70` 自动补写 `protected`」行为
59
+ (本模块**不改** `weights.recalc`,只在守卫里断言其仍在位)。
60
+
61
+ 语义边界(§7.3 末条,记忆里那条裁定)
62
+ -------------------------------------
63
+ **不可遗忘 ≠ 不可覆盖**。衰减属「降级/搬迁」族:
64
+ · 降级**不得实现为删除记录**——`recalc(apply=True)` 只写
65
+ `frontmatter.freshness_weight` 与 `freshness_state`,**从不删节点**;
66
+ · 需要跨层降级时走既有 `_move_layer`(其内已调 `protect.guard_move`),
67
+ **不新写搬迁路径**;受保护节点被移出保护层仍需显式 `override=True`
68
+ (`guard_move` 原样语义)。
69
+
70
+ 三件套(§7.4,与 `weights.recalc` 同款)
71
+ ----------------------------------------
72
+ 预演(`recalc(apply=False)`)→ 逐节点留痕(`_maintain.jsonl`,
73
+ `action="freshness"`,与 `weights` 的 `action="importance"` 同族)→ 反向
74
+ apply(`rollback`,读回 `before` 并再记一条 `freshness_rollback`)。
75
+ AEIS 侧**没有**预演与回滚(`consolidate_cycle`/`decay_cycle` 均无)——
76
+ 这是移植时的**净增工作量**,不省。
77
+
78
+ 零第三方依赖。
79
+ """
80
+ from __future__ import annotations
81
+
82
+ import os
83
+ import time
84
+
85
+ from .fsutil import append_jsonl, read_jsonl
86
+ from . import protect
87
+ # `_maintain.jsonl` 与保护下限的**单一真源**在 weights(同族留痕共用一份文件名)
88
+ from .weights import (APPLY_DELTA, IMPORTANCE_PROTECT, MAINTAIN_LOG,
89
+ node_importance)
90
+ from .whitebox_kb.aeis_core import time_core as _tc
91
+
92
+ # --------------------------------------------------------------------------
93
+ # 参数(照抄 AEIS consolidate_cycle;出处见模块 docstring)
94
+ # --------------------------------------------------------------------------
95
+
96
+ #: AEIS `consolidate_cycle` 的三个既有取值 + 两个结构常数(逐字照抄,不发明)。
97
+ REFRESH_PARAMS = {
98
+ "rehearsal_threshold": 0.7, # importance ≥ 此值 → 高重要度演练(刷新)
99
+ "degrade_threshold": 0.2, # importance < 此值 且 access_count ≤ 2 → 降权
100
+ "gain": 0.01, # 每档步长(AEIS 原有)
101
+ "cycle": 10, # access_count % 10 == 0 才 +gain(AEIS 原有)
102
+ "degrade_max_access": 2, # 低重要度降权的访问数上限(AEIS 原有)
103
+ "source": ("md_cg/whitebox_kb/aeis_core/core.py:4801-4831 "
104
+ "consolidate_cycle(rehearsal_threshold=0.7, "
105
+ "degrade_threshold=0.2, gain=0.01)"),
106
+ }
107
+
108
+ #: Δt 的单位(**最易错处**):γ 是「每天」的速率,Δt 必须按天喂。
109
+ DT_UNIT = "day"
110
+ SECONDS_PER_DAY = 86400.0
111
+
112
+ #: Δt 的**粒度**:整日(向下取整)。为什么量化(本批的一处设计取舍,如实登记):
113
+ #: ① γ 的单位本来就是「天」(半衰期 30 天档),亚日精度对结果无信息量;
114
+ #: ② 仓内有「同查询两轮结果逐位一致 / 可复算」的硬纪律
115
+ #: (`md_cg/test_retr_score_once.py` D1b 就是这条断言)——不量化则分数随
116
+ #: `time.time()` 逐轮微变,两轮比较恒不等;
117
+ #: ③ 两侧(Python / Rust)各自取时钟,量化到同一「天」桶后跨语言同值,
118
+ #: 消除 ms 级时钟差带来的 6 位小数抖动风险。
119
+ #: 量化损失上界 = γ × 1 天 = ln2/30 ≈ 2.3%(即「同一天内不再区分」)。
120
+ DT_QUANTUM_DAYS = 1.0
121
+
122
+ #: 衰减项 floor:`cred_factor(gamma, dt, floor, ceil)` 的 floor。
123
+ #: 取值理由与 P3-temporal 同源(0.5**10 ≈ 9.77e-4 < 1e-3 —— 30 天半衰期下
124
+ #: 300 天 = 10 个半衰期后继续区分已无信息量);floor 让**老节点/缺 created_at
125
+ #: 的节点**仍带非零分参与排序,而不是被乘成 0 后不可召回。
126
+ SCORE_FLOOR = 0.001
127
+
128
+ #: 衰减乘子上限(乘子恒 ≤ 1.0:衰减只能降权,刷新项负责 > 1 的那半边)。
129
+ SCORE_CEIL = 1.0
130
+
131
+ #: 总开关(缺省开;=0 时乘子恒为 1.0 ⇒ 与改动前逐位一致,是「可回退」的
132
+ #: 第一道闸——第二道是三件套的 rollback)。
133
+ FRESHNESS_ENV = "MDCG_FRESHNESS"
134
+
135
+ #: 观测时刻的可复算冻结口(**只为守卫/探针的确定性**;未设 = `time.time()`)。
136
+ #: 有了它,两侧探针能在同一 `now` 上逐位比对乘子。
137
+ NOW_ENV = "MDCG_FRESHNESS_NOW"
138
+
139
+ #: 降级判定面(`recalc` 用):乘子低于此值的节点标记 `freshness_state`
140
+ #: = "degraded"(**只标记,不删除**——见模块 docstring 的语义边界)。
141
+ DEMOTE_BELOW = 0.5
142
+
143
+
144
+ # 生效条件:environ(缺省 os.environ)里 FRESHNESS_ENV 为真值且归一后属 {"0","false","no","off"} 之外的值时返回 True;变量缺失/空串/命中关闭词表时返回 False;
145
+ def enabled(environ=None) -> bool:
146
+ """刷新/衰减乘子是否生效(缺省**开**:§7.2「进主分数」)。"""
147
+ raw = (environ or os.environ).get(FRESHNESS_ENV)
148
+ if raw is None or str(raw).strip() == "":
149
+ return True
150
+ return str(raw).strip().lower() not in ("0", "false", "no", "off")
151
+
152
+
153
+ # 生效条件:environ(缺省 os.environ)里 NOW_ENV 可 float() 解析时返回该浮点值;缺失/空串/不可解析时返回 time.time();
154
+ def freshness_now(environ=None) -> float:
155
+ """乘子用的「当前时刻」(unix 秒)。**单一读取点**(守卫与探针共用)。"""
156
+ raw = (environ or os.environ).get(NOW_ENV)
157
+ if raw:
158
+ try:
159
+ return float(raw)
160
+ except (TypeError, ValueError):
161
+ return time.time()
162
+ return time.time()
163
+
164
+
165
+ # 生效条件:gamma 非正或不可转 float 时回落 `mdcos.temporal_gamma()`;否则返回 float(gamma);无 IO、无副作用;
166
+ def resolve_gamma(gamma=None) -> float:
167
+ """γ 的解析(缺省回落 **P3 的同一读取点** `mdcos.temporal_gamma()`)。"""
168
+ if gamma is not None:
169
+ try:
170
+ g = float(gamma)
171
+ if g > 0:
172
+ return g
173
+ except (TypeError, ValueError):
174
+ pass
175
+ from .mdcos import temporal_gamma # 懒导入:避免模块级循环依赖
176
+ return temporal_gamma()
177
+
178
+
179
+ # --------------------------------------------------------------------------
180
+ # 核(一律经 time_core;本模块不写指数核)
181
+ # --------------------------------------------------------------------------
182
+
183
+ # 生效条件:gamma 与 dt_days(单位=天)任意可转 float 时,返回 time_core.cred_factor(gamma, dt_days, floor, ceil);dt 非有限值(inf/nan)时同样交给 cred_factor(inf → 取 floor);enabled 为 None(缺省)时自算(模块级 enabled()),显式传 bool 时按传入值——两者皆假值即恒返回 1.0;
184
+ def decay_factor(gamma: float, dt_days: float, floor: float = SCORE_FLOOR,
185
+ ceil: float = SCORE_CEIL, enabled=None) -> float:
186
+ """时间衰减乘子 `e^(-γ·Δt)`(**核来自唯一权威** `time_core.cred_factor`)。
187
+
188
+ ⚠ `dt_days` 的单位**必须**是「天」(`DT_UNIT`);调用方负责换算,
189
+ 换算单点是 `entry_weight`(`(now - created_at) / SECONDS_PER_DAY`)。
190
+
191
+ `enabled`(N274):None=自算(默认,行为与改动前逐位一致);显式传
192
+ bool 时不再自算——供 `entry_weight`/`_score` 把开关**循环外解析一次**
193
+ 后透传,消掉逐节点 env 读取。自算分支写 `globals()["enabled"]()` 而非
194
+ 直接 `enabled()`:形参同名会遮蔽模块函数,而 `globals()` 的解析语义与
195
+ 改前那句 `enabled()` 逐位一致(含测试对模块函数的打桩/替换面)。
196
+ """
197
+ if enabled is None:
198
+ enabled = globals()["enabled"]()
199
+ if not enabled:
200
+ return 1.0
201
+ return _tc.cred_factor(float(gamma), float(dt_days), float(floor),
202
+ float(ceil))
203
+
204
+
205
+ # 生效条件:access_count 与 last_access 任意(不可转数值按 0 处理)、importance 任意可转 float;enabled 为 None(缺省)时自算(模块级 enabled()),显式传 bool 时按传入值——两者皆假值即恒返回 1.0;否则按 REFRESH_PARAMS 的三档判定返回 1.0+gain / 1.0−gain / 1.0;
206
+ def refresh_factor(access_count=0, last_access=0, importance=0.0,
207
+ enabled=None) -> float:
208
+ """访问刷新/降权乘子(**门槛与步长照抄 AEIS** `consolidate_cycle`)。
209
+
210
+ 判定序(与 AEIS 同序同门):
211
+
212
+ 1. **刷新**:`importance ≥ rehearsal_threshold` 且 `access_count % 10 == 0`
213
+ 且 `last_access > 0`(真的被访问过)→ `1 + gain`;
214
+ 2. **降权**:`importance < degrade_threshold` 且
215
+ `access_count ≤ degrade_max_access` → `1 − gain`;
216
+ 3. 其余 → `1.0`。
217
+
218
+ `last_access > 0` 这一条是本模块对 AEIS 的唯一补足:AEIS 的 `% 10 == 0`
219
+ 在**从未被访问**(`access_count == 0`)时也为真——照抄原样会让「刚写、
220
+ 从未调用的高重要度节点」白拿一次刷新。加此闸后「未被调用」只能不刷新,
221
+ 不会反被奖励(语义仍与 §7.1「被经常调用的记忆其权重被刷新」一致)。
222
+
223
+ `enabled`(N274):None=自算(默认,行为与改动前逐位一致);显式传
224
+ bool 时不再自算——与 `decay_factor` 同一透传口径(见其 docstring)。
225
+ """
226
+ if enabled is None:
227
+ enabled = globals()["enabled"]()
228
+ if not enabled:
229
+ return 1.0
230
+ p = REFRESH_PARAMS
231
+ try:
232
+ ac = int(float(access_count or 0))
233
+ la = float(last_access or 0)
234
+ imp = float(importance or 0.0)
235
+ except (TypeError, ValueError):
236
+ return 1.0
237
+ if imp >= p["rehearsal_threshold"] and la > 0 and ac % p["cycle"] == 0:
238
+ return 1.0 + p["gain"]
239
+ if imp < p["degrade_threshold"] and ac <= p["degrade_max_access"]:
240
+ return 1.0 - p["gain"]
241
+ return 1.0
242
+
243
+
244
+ #: 裸 entry 探针的假 node_id(`protect.is_protected` 的 `(cg, node_id)` 形态所需;
245
+ #: 真实节点 id 来自文件名/显式声明,不含 NUL ⇒ 与既有索引键不可能相撞)。
246
+ _ENTRY_PROBE_ID = "\x00entry-probe"
247
+
248
+
249
+ class _EntryProbe:
250
+ """裸索引条目 → `protect.is_protected` 所需的 `(cg, node_id)` 形态(**零规则载体**)。
251
+
252
+ #378(2026-10-14):衰减下界此前只读 `entry["protected"]` 一位,漏了
253
+ `protect.is_protected` 的**层保护**(layer ∈ {self, anchor})与**按分保护**
254
+ ——layer=anchor 或按分受保护的节点会一路衰减穿过保护线(「自动失去保护」,
255
+ 正是本模块 §7.3 要挡住的移植隐患)。本类**不复制任何判据**——规则单点仍是
256
+ `protect.is_protected`——只把调用方手里已有的条目摆成该判据所需的索引快照
257
+ 形态。刻意**不提供** `_maybe_reload_index`(探活分支取不到即跳过)且
258
+ `get()` 恒返回 None(门控字段回退读文件的分支在此无文件可读、**不抛异常**)
259
+ ⇒ 判定 100% 基于传入映射:零 IO(`entry_weight` 是**检索期取数点**,
260
+ 热路径上**不得读盘**,否则 §7.2 卡点一破)。
261
+ """
262
+
263
+ __slots__ = ("index",)
264
+
265
+ def __init__(self, entry):
266
+ self.index = {"nodes": {_ENTRY_PROBE_ID: entry if isinstance(entry, dict)
267
+ else {}}}
268
+
269
+ def get(self, node_id=None): # protect._fm 的回退分支:探针无文件可读
270
+ return None
271
+
272
+
273
+ def _is_protected_entry(entry) -> tuple:
274
+ """裸索引条目的「不可遗忘」判定 → `(是否受保护, 原因)`。
275
+
276
+ 判据单点=**`protect.is_protected`**(层保护 self/anchor ∪ 显式 protected 位 ∪
277
+ 按分保护 ≥0.70 且来源缺省/hint);本函数只负责把它喂给判据,不自带任何规则。
278
+ """
279
+ return protect.is_protected(_EntryProbe(entry), _ENTRY_PROBE_ID)
280
+
281
+
282
+ # 生效条件:entry 为可取 protected / layer / importance / importance_source 的映射;经 protect.is_protected(∪ 原显式 protected 位)判为**未受保护**时返回 SCORE_FLOOR;受保护时返回 max(SCORE_FLOOR, min(1.0, IMPORTANCE_PROTECT / importance))(importance 不可转数值或 ≤0 时按 1.0 处理);
283
+ def protected_floor(entry) -> float:
284
+ """受保护节点的**衰减乘子下界**(§7.3 的第二道闸)。
285
+
286
+ 推导(为什么是 `IMPORTANCE_PROTECT / importance`):
287
+ md_cg 的保护判定是**即时读** `importance ≥ IMPortANCE_PROTECT(0.70)`
288
+ (`protect.py` / `weights.py`)。衰减乘子 `m ≤ 1` 会让
289
+ `importance × m < 0.70` ⇒ 节点**自动失去保护**(AEIS 移植的隐患)。
290
+ 取 `m ≥ 0.70 / importance`,则 `importance × m ≥ 0.70` **恒成立**——
291
+ 保护判定不可能被衰减翻转。
292
+ 下界被夹到 ≤ 1.0:`importance < 0.70` 的受保护节点(人工 `protect.mark`)
293
+ 乘子取 1.0(不衰减),同样不损失保护。
294
+ """
295
+ e = entry or {}
296
+ # #378(2026-10-14):判据改为**共用** `protect.is_protected`(∪ 原显式
297
+ # protected 位——超集,那位照旧短路,既有判定一字不变):层保护(anchor/self)
298
+ # 与按分保护(≥0.70 且来源缺省/hint)同样享有下界,衰减不可能把它们
299
+ # 推过保护线。`importance_source` 必须已在取数面(`entry_weight`)里带上,
300
+ # 否则「机器推断分」会被误当存量缺省而认回保护(issue50-e 的反向)。
301
+ if not (e.get("protected") or _is_protected_entry(e)[0]):
302
+ return SCORE_FLOOR
303
+ try:
304
+ imp = float(e.get("importance") or 0.0)
305
+ except (TypeError, ValueError):
306
+ imp = 0.0
307
+ if imp <= 0:
308
+ imp = 1.0
309
+ return max(SCORE_FLOOR, min(1.0, IMPORTANCE_PROTECT / imp))
310
+
311
+
312
+ # 生效条件:entry 为可取 created_at / access_count / last_access / importance / protected / layer / importance_source 的映射;fm 为真值时上述七个键优先取自 fm(缺键回落 entry);now 为假值(None)时取 freshness_now();enabled 为 None(缺省)时自算(模块级 enabled()),显式传 bool 时按传入值——两者皆假值即早退返回 (1.0, {"disabled": True})(早退先于 now/γ 解析,与改前同序);否则无条件返回 (乘子, 依据 dict)——乘子 = decay_factor(gamma, |now-created_at|/86400, protected_floor(取数后的映射), SCORE_CEIL, enabled=…) × refresh_factor(..., enabled=…);created_at 缺失/不可转数值/≤0 时 dt_days 取 inf(判「距参照无穷远」,由 floor 兜住);
313
+ def entry_weight(entry, now=None, gamma=None, fm=None, enabled=None) -> tuple:
314
+ """索引条目 → 分数乘子 `(乘子, 依据)`(**检索期唯一取数点**,免读文件)。
315
+
316
+ `entry` 直接来自索引快照(`_node_entry` 已落 `created_at` /
317
+ `access_count` / `last_access`)——**不读盘**(§7.2 卡点一)。
318
+
319
+ `fm` 为可选覆盖源(写面刚落的 frontmatter 可能比索引条目新):只为
320
+ 避免在热路径上拷贝 dict 而设,取数优先级 `fm > entry > 缺省`。
321
+
322
+ `enabled`(N274):None=自算(默认,行为与改动前逐位一致);显式传
323
+ bool 时不再自算,且向下透传给 `decay_factor`/`refresh_factor`——它们
324
+ 同样不再各自读 env。自算分支经 `globals()["enabled"]()`(形参遮蔽,
325
+ 解析语义同改前的 `enabled()`,见 `decay_factor` 同注)。
326
+ """
327
+ e = entry or {}
328
+ # #378:取数面必须把 `layer` 与 `importance_source` 带上——`protected_floor`
329
+ # 消费的是本函数的 `src`,漏了这两键就等于给下界判据喂了一份**残件**
330
+ # (层保护无 layer 可判;按分保护把 heuristic 误当缺省来源)。键集只增不改,
331
+ # 其余四键的取值口径与优先级(fm > entry > 缺省)逐位不变。
332
+ keys = ("created_at", "access_count", "last_access", "importance",
333
+ "protected", "layer", "importance_source")
334
+ if fm is not None:
335
+ src = {k: (fm.get(k) if fm.get(k) is not None else e.get(k))
336
+ for k in keys}
337
+ else:
338
+ src = {k: e.get(k) for k in keys}
339
+ if enabled is None:
340
+ enabled = globals()["enabled"]()
341
+ if not enabled:
342
+ return 1.0, {"disabled": True}
343
+ g = resolve_gamma(gamma)
344
+ ref = freshness_now() if now is None else float(now)
345
+ try:
346
+ created = float(src.get("created_at") or 0.0)
347
+ except (TypeError, ValueError):
348
+ created = 0.0
349
+ if created <= 0:
350
+ dt_days = float("inf") # 无写入时刻:不猜测,判无穷远
351
+ else:
352
+ # **单位=天**:86400 秒/天,显式换算(γ 是每天速率)
353
+ dt_days = abs(ref - created) / SECONDS_PER_DAY
354
+ # **粒度=整日**(向下取整):保证「同查询两轮逐位一致」(不随 wall clock
355
+ # 微变)且两侧跨语言同值。详见 DT_QUANTUM_DAYS 的说明。
356
+ dt_days = float(int(dt_days / DT_QUANTUM_DAYS)) * DT_QUANTUM_DAYS
357
+ floor = protected_floor(src)
358
+ d = decay_factor(g, dt_days, floor, SCORE_CEIL, enabled=enabled)
359
+ r = refresh_factor(src.get("access_count"), src.get("last_access"),
360
+ src.get("importance"), enabled=enabled)
361
+ # issue #379-A(G1e):`protected` 必须与 `protected_floor` **同源**——
362
+ # 修前这里只读 `src["protected"]` 位,于是 layer=anchor / importance≥0.70 的
363
+ # 受保护条目在下界判据里算「受保护」(floor 抬高)而在依据里报 protected=False,
364
+ # 同一份 dict 给出两个相反读数。现两处都走 protect 的单点(∪ 显式位)。
365
+ _prot = bool(src.get("protected") or _is_protected_entry(src)[0])
366
+ return d * r, {"gamma": g, "dt_days": dt_days, "unit": DT_UNIT,
367
+ "decay": d, "refresh": r, "floor": floor,
368
+ "protected": _prot}
369
+
370
+
371
+ # --------------------------------------------------------------------------
372
+ # 三件套:预演 / 逐节点留痕 / 反向 apply(与 weights.recalc 同款)
373
+ # --------------------------------------------------------------------------
374
+
375
+ # 生效条件:cg.index["nodes"] 为 dict 时按 layer 过滤、limit 为真值才截断;dry-run 只出报表(**不接档位闸**——零写盘面照旧);apply=True 时先经 autonomy_modes.e_gate() 档位判定(补强批次 v1.2·E 面接线,位置=任何盘面写入之前):非 ALLOW(plan 档无计划)即经 forbidden_result() fail-closed 早退(零写盘、零审计行、带 hint),ALLOW(confirm/full)则逐节点把乘子(round 6)写入 frontmatter.freshness_weight 与 freshness_components,乘子 < DEMOTE_BELOW 时另写 freshness_state="degraded"(**只标记,不删记录**),乘子下降且 demote_layer 给定时经 cg._move_layer(内含 protect.guard_move)搬迁;每条 append_jsonl(action="freshness") 后 rebuild_index;返回报表 dict;
376
+ def recalc(cg, layer=None, limit=None, apply=False, min_delta=APPLY_DELTA,
377
+ actor="maintain", dry_run_samples=10, now=None, demote_layer=None):
378
+ """刷新/衰减权重的重算(**可预演 + 逐节点留痕 + 可回滚**)。
379
+
380
+ apply=False(默认)只出报表,**零写盘**。
381
+ apply=True 逐节点改写 `frontmatter.freshness_weight`;每节点一条
382
+ `_maintain.jsonl`(`action="freshness"`,与 `weights` 的 `importance`
383
+ 同族),并提供 `rollback` 反向应用。
384
+
385
+ ⚠ 本函数**从不删除节点**(§7.3「降级不得实现为删除记录」):降级只落
386
+ `freshness_state="degraded"` 标记;要搬迁层位时给出 `demote_layer`,
387
+ 走既有 `_move_layer`(其内已调 `protect.guard_move`,受保护节点需显式
388
+ `override`)——不新写第二条搬迁路径。
389
+
390
+ **档位闸(补强批次 v1.2·E 面接线)**:`apply=True` 的**写盘前**先经
391
+ `autonomy_modes.e_gate()`(设计 §三 plan 档 E「须命中计划步骤」)——
392
+ plan 档无计划 ⇒ `forbidden_result()` fail-closed 早退(零写盘、零审计行);
393
+ confirm/full ⇒ ALLOW,**原链原样**(逐位不变)。`apply=False`(预演)
394
+ 不接闸:零写盘面不属「变更」。
395
+ """
396
+ nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
397
+ ids = [nid for nid, e in list(nodes.items())
398
+ if not layer or e.get("layer") == layer]
399
+ ids.sort()
400
+ if limit:
401
+ ids = ids[:int(limit)]
402
+ ref = freshness_now() if now is None else float(now)
403
+ batch = time.strftime("%Y%m%d-%H%M%S")
404
+ planned, samples = [], []
405
+ before_sum = after_sum = 0.0
406
+ changed = unchanged = skipped = 0
407
+ by_layer = {}
408
+ for nid in ids:
409
+ e = nodes.get(nid) or {}
410
+ w, why = entry_weight(e, now=ref)
411
+ before = float(e.get("freshness_weight") or 1.0)
412
+ before_sum += before
413
+ after_sum += w
414
+ lay = e.get("layer") or "?"
415
+ bl = by_layer.setdefault(lay, {"nodes": 0, "changed": 0})
416
+ bl["nodes"] += 1
417
+ if abs(w - before) < float(min_delta):
418
+ unchanged += 1
419
+ continue
420
+ changed += 1
421
+ bl["changed"] += 1
422
+ plan = {"node_id": nid, "layer": lay, "batch": batch,
423
+ "before": round(before, 6), "after": round(w, 6),
424
+ "delta": round(w - before, 6), "why": why,
425
+ "protected": bool(e.get("protected")),
426
+ # 降级判定(只标记):低于阈值即为 degraded 候选
427
+ "degrade": bool(w < DEMOTE_BELOW)}
428
+ planned.append(plan)
429
+ if len(samples) < int(dry_run_samples):
430
+ samples.append(plan)
431
+ written, degraded = 0, 0
432
+ if apply:
433
+ # 三档自治(补强批次 v1.2·E 面接线,设计 §三 plan 档 E「须命中计划步骤」):
434
+ # E 类动作**写盘前**的档位判定单点。本函数无独立资格闸(逐节点取数在下方
435
+ # 循环里、取不到即 skip),故闸口取「进入写盘支路的第一行」=任何盘面写入
436
+ # 之前;放行分支即原链原样(confirm/full 逐位不变),plan 档无计划
437
+ # ⇒ fail-closed 早退,**零写盘、零 _maintain.jsonl 行**。
438
+ from . import autonomy_modes as _am
439
+ _dec = _am.e_gate()
440
+ if _dec["decision"] != _am.ALLOW:
441
+ return _am.forbidden_result(_dec, action="freshness", dry_run=False,
442
+ written=0, batch=batch)
443
+ if demote_layer:
444
+ bind_move_layer(cg) # 跨层降级走既有 _move_layer(现绑)
445
+ for plan in planned:
446
+ nid = plan["node_id"]
447
+ node = cg.get(nid)
448
+ if not node:
449
+ skipped += 1
450
+ continue
451
+ fm = node.get("frontmatter") or {}
452
+ fm["freshness_weight"] = plan["after"]
453
+ fm["freshness_source"] = "freshness_recalc"
454
+ fm["freshness_components"] = plan["why"]
455
+ if plan["degrade"]:
456
+ # **降级 = 标记**(不是删除记录):节点与正文原样保留
457
+ fm["freshness_state"] = "degraded"
458
+ degraded += 1
459
+ path = os.path.join(cg.root, (nodes.get(nid) or {}).get("path")
460
+ or node.get("path") or f"{nid}.md")
461
+ cg._write_node(nid, path, fm, node.get("content") or "")
462
+ e = nodes.get(nid)
463
+ if e is not None:
464
+ e["freshness_weight"] = plan["after"]
465
+ e["freshness_state"] = fm.get("freshness_state")
466
+ rec = {"t": time.time(), "action": "freshness", "batch": batch,
467
+ "id": nid, "layer": plan["layer"],
468
+ "before": plan["before"], "after": plan["after"],
469
+ "delta": plan["delta"], "degrade": plan["degrade"],
470
+ "why": plan["why"], "actor": actor}
471
+ append_jsonl(os.path.join(cg.root, MAINTAIN_LOG), rec)
472
+ written += 1
473
+ # 跨层降级:走后缀既有 `_move_layer`(内含 protect.guard_move)
474
+ if demote_layer and plan["degrade"] and _move_layer is not None:
475
+ try:
476
+ _move_layer(nid, demote_layer,
477
+ reason=f"freshness degraded (w={plan['after']})")
478
+ except Exception as exc: # noqa: BLE001
479
+ plan["move_error"] = f"{type(exc).__name__}: {exc}"
480
+ if written and hasattr(cg, "rebuild_index"):
481
+ cg.rebuild_index()
482
+ n = max(1, len(ids))
483
+ return {
484
+ "ok": True, "action": "freshness", "dry_run": not apply, "batch": batch,
485
+ "nodes_scanned": len(ids), "changed": changed, "unchanged": unchanged,
486
+ "skipped": skipped, "written": written, "degraded": degraded,
487
+ "min_delta": float(min_delta), "now": ref,
488
+ "gamma": resolve_gamma(), "unit": DT_UNIT,
489
+ "avg_before": round(before_sum / n, 4),
490
+ "avg_after": round(after_sum / n, 4),
491
+ "by_layer": dict(by_layer), "samples": samples, "log": MAINTAIN_LOG,
492
+ "note": ("dry-run:未写盘;apply=True 才写 freshness_weight"
493
+ if not apply else
494
+ f"已写 {written} 个节点(降级标记 {degraded});"
495
+ f"回滚见 rollback(batch={batch})"),
496
+ }
497
+
498
+
499
+ #: 惰性持有的跨层降级入口(`MdCG._move_layer` 是实例方法:`recalc` 里现取)。
500
+ #: 这里保留模块级名字只为**可读性**(下方 `_bind_move_layer` 现绑)。
501
+ _move_layer = None
502
+
503
+
504
+ # 生效条件:cg 具备可调用的 _move_layer 时把 recalc 用的跨层降级入口绑定为该实例方法,返回 True;否则返回 False(降级只标记、不搬迁);
505
+ def bind_move_layer(cg) -> bool:
506
+ """把 `recalc(..., demote_layer=...)` 用的搬迁入口绑到实例方法上。
507
+
508
+ 为什么需要它:`recalc` 是**模块级函数**(与 `weights.recalc` 同构),而
509
+ `_move_layer` 是实例方法。不新写第二条搬迁路径 ⇒ 只能绑既有那一条。
510
+ """
511
+ global _move_layer
512
+ fn = getattr(cg, "_move_layer", None)
513
+ _move_layer = fn if callable(fn) else None
514
+ return _move_layer is not None
515
+
516
+
517
+ # 生效条件:cg.root/MAINTAIN_LOG 可读出 action=="freshness" 记录后,entry_ids 为真值时按记录 id 过滤;否则 batch 为真值时按 r.get("batch")==batch 过滤;否则取最后一条记录的 batch 再按其过滤;无记录返回 {"ok":False,"error":"no_records","reverted":0},过滤后无记录返回 {"ok":False,"error":"batch_not_found",...};对命中且 cg.get(nid) 为真的记录写回 rec.get("before") 到 frontmatter.freshness_weight(**只改这一列,不删节点**),若 reverted 且 cg 有 rebuild_index 则调用,最后 append_jsonl 写 action="freshness_rollback" 并返回 {"ok":True,"batch":batch,"reverted":reverted,"ids":ids};
518
+ def rollback(cg, batch=None, entry_ids=None, actor="maintain"):
519
+ """把刷新/衰减反向应用(三件套的第三件;AEIS 侧没有,属净增)。"""
520
+ log_path = os.path.join(cg.root, MAINTAIN_LOG)
521
+ records = [r for r in read_jsonl(log_path)
522
+ if r.get("action") == "freshness"]
523
+ if not records:
524
+ return {"ok": False, "error": "no_records", "reverted": 0}
525
+ if entry_ids:
526
+ want = {str(x) for x in entry_ids}
527
+ records = [r for r in records if str(r.get("id")) in want]
528
+ elif batch:
529
+ records = [r for r in records if r.get("batch") == batch]
530
+ else:
531
+ batch = records[-1].get("batch")
532
+ records = [r for r in records if r.get("batch") == batch]
533
+ if not records:
534
+ return {"ok": False, "error": "batch_not_found", "batch": batch,
535
+ "reverted": 0}
536
+ nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
537
+ reverted, ids = 0, []
538
+ for rec in records:
539
+ nid = rec.get("id")
540
+ node = cg.get(nid)
541
+ if not node:
542
+ continue
543
+ fm = node.get("frontmatter") or {}
544
+ fm["freshness_weight"] = rec.get("before")
545
+ fm["freshness_source"] = "freshness_rollback"
546
+ # 降级标记随回滚撤销(回到降级前状态);**节点与正文一字不动**
547
+ if not rec.get("degrade"):
548
+ fm.pop("freshness_state", None)
549
+ path = os.path.join(cg.root, (nodes.get(nid) or {}).get("path")
550
+ or node.get("path") or f"{nid}.md")
551
+ cg._write_node(nid, path, fm, node.get("content") or "")
552
+ e = nodes.get(nid)
553
+ if e is not None:
554
+ e["freshness_weight"] = rec.get("before")
555
+ reverted += 1
556
+ ids.append(nid)
557
+ if reverted and hasattr(cg, "rebuild_index"):
558
+ cg.rebuild_index()
559
+ append_jsonl(log_path, {"t": time.time(), "action": "freshness_rollback",
560
+ "batch": batch, "reverted": reverted,
561
+ "actor": actor})
562
+ return {"ok": True, "batch": batch, "reverted": reverted, "ids": ids}
563
+
564
+
565
+ # 生效条件:cg.root/MAINTAIN_LOG 可读出 JSONL 记录后,仅取 action=="freshness" 的记录并返回其尾部 int(limit) 条(limit 为 0 时返回全部);
566
+ def history(cg, limit=100) -> list:
567
+ """刷新/衰减留痕(最近 limit 条)。"""
568
+ recs = [r for r in read_jsonl(os.path.join(cg.root, MAINTAIN_LOG))
569
+ if r.get("action") == "freshness"]
570
+ return recs[-int(limit):]
571
+
572
+
573
+ # 生效条件:无条件返回模块自描述 dict(公式 / 核出处 / γ 口径 / 单位 / floor / 参数出处 / 开关 / 三件套名),供守卫与文档对拍;
574
+ def catalog() -> dict:
575
+ return {"formula": "score ← score × cred_factor(γ, Δt) × refresh(ac, la)",
576
+ "core": "md_cg/whitebox_kb/aeis_core/time_core.py::cred_factor",
577
+ "gamma_default": "ln2 / links.DECAY_DAYS(=30 天)",
578
+ "dt_unit": DT_UNIT, "dt_source": "created_at",
579
+ "score_floor": SCORE_FLOOR, "score_ceil": SCORE_CEIL,
580
+ "refresh_params": dict(REFRESH_PARAMS),
581
+ "protect_floor": "IMPORTANCE_PROTECT/importance(受保护节点)",
582
+ "enabled_env": FRESHNESS_ENV, "now_env": NOW_ENV,
583
+ "triplet": ["recalc(apply=False)", "_maintain.jsonl",
584
+ "rollback()"]}
585
+
586
+
587
+ # 生效条件:无条件返回模块自检 dict——核来自 time_core(本模块源码不含指数核调用)、单位常量为天、参数出处非空、weights 侧的保护下限可读;
588
+ def selfcheck() -> dict:
589
+ """模块自检(守卫的第一条断言面)。"""
590
+ src = open(os.path.abspath(__file__), encoding="utf-8").read()
591
+ # 探针串拼接(不写字面量):否则「检查用的字面量」本身会把检查判红
592
+ needle = "math." + "exp("
593
+ return {"core_is_time_core": "from .whitebox_kb.aeis_core import time_core"
594
+ in src,
595
+ "no_local_exp_core": needle not in src,
596
+ "uses_cred_factor": "cred_factor" in src,
597
+ "dt_unit": DT_UNIT,
598
+ "params_source_set": bool(REFRESH_PARAMS.get("source")),
599
+ "gain": REFRESH_PARAMS["gain"],
600
+ "protect_floor": IMPORTANCE_PROTECT,
601
+ "node_importance_available": callable(node_importance)}