@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,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)}