@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.
- package/README.md +662 -659
- package/codebuddy/README.md +1 -1
- package/data/policy.json +38 -27
- package/docs/README.md +18 -2
- package/docs/discipline/harnesses.yaml +1 -1
- package/docs/discipline/templates/spec.txt.tmpl +23 -0
- 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
- 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
- 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
- package/dsh/README.md +1 -1
- package/dsh/cordis.yml.example +139 -139
- package/hive/README.md +705 -0
- package/hive/id_charset_blocks.txt +147 -0
- package/lib/bridge.d.ts +3 -0
- package/lib/bridge.js +32 -11
- package/lib/cli.js +14 -17
- package/lib/hooks.d.ts +37 -3
- package/lib/hooks.js +176 -24
- package/lib/index.d.ts +2 -2
- package/lib/index.js +29 -6
- package/lib/init.js +21 -21
- package/lib/lib/datapath.d.ts +56 -0
- package/lib/lib/datapath.js +102 -9
- package/lib/lib/hook_audit.d.ts +0 -1
- package/lib/lib/hook_audit.js +51 -3
- package/lib/lib/mdcg_client.d.ts +4 -1
- package/lib/lib/mdcg_client.js +10 -2
- package/lib/lib/mutual.js +61 -15
- package/lib/lib/prompt_safety.js +28 -2
- package/lib/lib/roleplay_web.js +30 -2
- package/lib/lib/token_store.d.ts +25 -6
- package/lib/lib/token_store.js +224 -33
- package/lib/tools.d.ts +15 -2
- package/lib/tools.js +44 -4
- package/md_cg/_guard_kit.py +121 -0
- package/md_cg/admission.py +718 -718
- package/md_cg/anchor.py +114 -0
- package/md_cg/audit.py +37 -7
- package/md_cg/autonomy.py +433 -288
- package/md_cg/autonomy_modes.py +781 -642
- package/md_cg/bench_beir_bm25.py +154 -0
- package/md_cg/bench_beir_scifact.py +170 -0
- package/md_cg/bench_bm25_blockmax.py +134 -0
- package/md_cg/bench_bm25_incremental.py +246 -0
- package/md_cg/bench_ccg_heading.py +118 -0
- package/md_cg/bench_csre_correctness.py +145 -0
- package/md_cg/bench_excerpt_budget.py +94 -0
- package/md_cg/bench_fuzzy_substrings.py +299 -0
- package/md_cg/bench_memory_rsi.py +358 -0
- package/md_cg/bench_memory_rsi_latency.py +82 -0
- package/md_cg/bench_memory_rsi_public.py +116 -0
- package/md_cg/bench_memory_rsi_tools.py +229 -0
- package/md_cg/bench_rrf_candidates.py +212 -0
- package/md_cg/bench_rrf_public.py +100 -0
- package/md_cg/bench_text_projections.py +221 -0
- package/md_cg/bench_timeanchor.py +357 -0
- package/md_cg/bm25.py +601 -0
- package/md_cg/branches.py +404 -327
- package/md_cg/build_postings.py +74 -73
- package/md_cg/ccgc.py +4 -2
- package/md_cg/chain.py +573 -379
- package/md_cg/coldverify.py +531 -292
- package/md_cg/condaccept.py +263 -0
- package/md_cg/condgate.py +308 -0
- package/md_cg/config_registry.py +329 -0
- package/md_cg/config_registry_bulk.py +482 -0
- package/md_cg/config_registry_guard.py +487 -0
- package/md_cg/config_render.py +354 -0
- package/md_cg/config_validate.py +455 -0
- package/md_cg/conformance.py +747 -726
- package/md_cg/conformance_core.py +753 -0
- package/md_cg/consistency.py +1278 -955
- package/md_cg/consolidate.py +1793 -1633
- package/md_cg/crypto.py +346 -24
- package/md_cg/datapath.py +137 -12
- package/md_cg/eval_common.py +522 -575
- package/md_cg/evidence.py +946 -585
- package/md_cg/evidence_delivery.py +101 -0
- package/md_cg/experience_consolidation.py +317 -0
- package/md_cg/export.py +329 -222
- package/md_cg/forgetting.py +1050 -922
- package/md_cg/freshness.py +601 -548
- package/md_cg/fsutil.py +1120 -824
- package/md_cg/goal_gen.py +458 -0
- package/md_cg/hotcache.py +107 -9
- package/md_cg/hyperedge.py +262 -251
- package/md_cg/identity.py +573 -391
- package/md_cg/imgskill.py +1712 -0
- package/md_cg/insight.py +540 -521
- package/md_cg/interface_schema.py +146 -0
- package/md_cg/interop.py +20 -0
- package/md_cg/judgment_manifest.py +24 -1
- package/md_cg/lifecycle.py +426 -345
- package/md_cg/links.py +27 -6
- package/md_cg/logref.py +332 -327
- package/md_cg/mcp_server.py +5227 -4449
- package/md_cg/mdcg.py +1301 -203
- package/md_cg/mdcos.py +7108 -5440
- package/md_cg/memory_rsi.py +308 -0
- package/md_cg/metacognition.py +726 -591
- package/md_cg/nodefile.py +151 -3
- package/md_cg/op_table.py +1128 -0
- package/md_cg/postings.py +524 -300
- package/md_cg/predict.py +1103 -1100
- package/md_cg/probe_memory_rsi.py +95 -0
- package/md_cg/probe_memory_rsi_mcp.py +66 -0
- package/md_cg/protect.py +654 -494
- package/md_cg/protocol.py +492 -411
- package/md_cg/provenance.py +606 -600
- package/md_cg/qmd.py +477 -0
- package/md_cg/qmd_llm.py +334 -0
- package/md_cg/query_excerpt.py +171 -0
- package/md_cg/queue_health.py +130 -0
- package/md_cg/reach.py +470 -453
- package/md_cg/readcache.py +115 -3
- package/md_cg/reconcile.py +239 -228
- package/md_cg/refindex.py +1191 -1042
- package/md_cg/refine.py +613 -604
- package/md_cg/retrieve.py +128 -0
- package/md_cg/review_cli.py +204 -26
- package/md_cg/revise.py +140 -0
- package/md_cg/rollback.py +657 -420
- package/md_cg/rollback_cli.py +124 -104
- package/md_cg/rotate.py +347 -0
- package/md_cg/routing.py +490 -429
- package/md_cg/rrf_candidates.py +204 -0
- package/md_cg/run_tests.py +19 -1
- package/md_cg/scrub.py +177 -23
- package/md_cg/security.py +269 -17
- package/md_cg/self_state.py +1053 -1029
- package/md_cg/self_surface.py +50 -0
- package/md_cg/semantic/canonical.py +144 -144
- package/md_cg/semantic/export_en_zh_map.py +2 -2
- package/md_cg/semantic/zh_en_atoms.py +141 -139
- package/md_cg/session5.py +106 -0
- package/md_cg/signer.py +76 -2
- package/md_cg/sleep.py +1779 -1583
- package/md_cg/sources.py +1091 -833
- package/md_cg/state_events.py +75 -10
- package/md_cg/state_slots.py +312 -221
- package/md_cg/stg.py +85 -18
- package/md_cg/stgidx.py +537 -281
- package/md_cg/subgraph.py +851 -729
- package/md_cg/sustain.py +458 -19
- package/md_cg/task_memory.py +367 -0
- package/md_cg/test_action_derive.py +210 -203
- package/md_cg/test_audit_heartbeat_20261015.py +417 -0
- package/md_cg/test_audit_protection_20261015.py +483 -0
- package/md_cg/test_audit_rotate_parity.py +280 -0
- package/md_cg/test_audit_state_20261015.py +253 -0
- package/md_cg/test_audit_write_20261015.py +161 -0
- package/md_cg/test_auto_defaults.py +43 -4
- package/md_cg/test_autonomy_emotion.py +328 -0
- package/md_cg/test_autonomy_modes.py +2013 -1973
- package/md_cg/test_b1_foreign_read.py +245 -0
- package/md_cg/test_bm25.py +438 -0
- package/md_cg/test_bm25_hydration_refill.py +265 -0
- package/md_cg/test_bm25_incremental.py +241 -0
- package/md_cg/test_bm25_incremental_mutations.py +160 -0
- package/md_cg/test_bm25_mutations.py +205 -0
- package/md_cg/test_bm25_pool_view.py +196 -0
- package/md_cg/test_boot_openblas_guard.py +218 -197
- package/md_cg/test_boundary_hit.py +1 -1
- package/md_cg/test_branches_sensitivity.py +375 -0
- package/md_cg/test_c8_search_rrf_gates.py +1 -1
- package/md_cg/test_canonical_timezones.py +211 -0
- package/md_cg/test_ccg_heading_parser.py +73 -0
- package/md_cg/test_chain_best_first.py +403 -0
- package/md_cg/test_chain_candidate_scope.py +227 -0
- package/md_cg/test_cn_recall_grams.py +206 -0
- package/md_cg/test_code_kind_forbidden.py +101 -0
- package/md_cg/test_coldverify_drain.py +127 -0
- package/md_cg/test_condaccept.py +156 -0
- package/md_cg/test_condgate.py +141 -0
- package/md_cg/test_config_registry.py +55 -0
- package/md_cg/test_crypto_rotate.py +257 -0
- package/md_cg/test_csre_correctness.py +297 -0
- package/md_cg/test_csre_index_import_guard.py +161 -0
- package/md_cg/test_csre_mutations.py +34 -0
- package/md_cg/test_csre_session.py +69 -0
- package/md_cg/test_curiosity_budget.py +468 -0
- package/md_cg/test_d17_autostart_toolface.py +453 -0
- package/md_cg/test_datapath_tilde_home.py +271 -0
- package/md_cg/test_derived_cache_generations.py +256 -0
- package/md_cg/test_evidence_delivery_compact.py +54 -0
- package/md_cg/test_exact_text_cache.py +191 -0
- package/md_cg/test_excerpt_budget.py +188 -0
- package/md_cg/test_experience_consolidation.py +112 -0
- package/md_cg/test_export_default_collision.py +138 -0
- package/md_cg/test_export_snapshots.py +322 -0
- package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
- package/md_cg/test_gain_gate.py +16 -5
- package/md_cg/test_goal_gen.py +355 -0
- package/md_cg/test_h2_session_view_norm.py +251 -233
- package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
- package/md_cg/test_heartbeat_ledger.py +557 -0
- package/md_cg/test_hierarchy_audit_graph.py +237 -0
- package/md_cg/test_i50c_meta_passthrough.py +628 -608
- package/md_cg/test_i50e_readside_protection.py +658 -656
- package/md_cg/test_identity_attribution.py +96 -2
- package/md_cg/test_identity_contract.py +329 -0
- package/md_cg/test_imgskill.py +1444 -0
- package/md_cg/test_index_snapshot_shape.py +240 -0
- package/md_cg/test_interop_judgment.py +258 -228
- package/md_cg/test_issue111_gate_order.py +77 -0
- package/md_cg/test_issue111_scoring_contract.py +87 -0
- package/md_cg/test_issue121_calibration_bounds.py +293 -0
- package/md_cg/test_issue128_session_env_authority.py +246 -0
- package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
- package/md_cg/test_issue131_postings_content_staleness.py +424 -0
- package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
- package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
- package/md_cg/test_issue147_pack_id_escape.py +378 -0
- package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
- package/md_cg/test_issue149_accel_default_face.py +249 -0
- package/md_cg/test_issue150_empty_query_terms.py +328 -0
- package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
- package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
- package/md_cg/test_issue152_sealed_postings.py +309 -0
- package/md_cg/test_issue152b_decrypt_cache.py +218 -0
- package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
- package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
- package/md_cg/test_issue157b_index_remainder.py +344 -0
- package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
- package/md_cg/test_issue190_tidy_idempotent.py +806 -0
- package/md_cg/test_issue191_import_trust.py +382 -0
- package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
- package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
- package/md_cg/test_issue193_write_scope.py +378 -0
- package/md_cg/test_issue197_rank_credibility_property.py +201 -0
- package/md_cg/test_issue211_export_target.py +325 -0
- package/md_cg/test_issue212_writeface_gaps.py +349 -0
- package/md_cg/test_issue214_reject_sensitivity.py +267 -0
- package/md_cg/test_issue215_condition_source_gap.py +272 -0
- package/md_cg/test_issue216_clash_routes.py +214 -0
- package/md_cg/test_issue217_slot_routes.py +248 -0
- package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
- package/md_cg/test_issue225_consistency_torn_log.py +433 -0
- package/md_cg/test_issue245_swarm_traversal.py +366 -0
- package/md_cg/test_issue258_pack_sensitivity.py +468 -0
- package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
- package/md_cg/test_issue274_read_node_id_none.py +341 -0
- package/md_cg/test_issue275_layer_param.py +250 -0
- package/md_cg/test_issue277_node_id_traversal.py +384 -0
- package/md_cg/test_issue278_neg_separated_tension.py +271 -0
- package/md_cg/test_issue278_neg_window.py +294 -0
- package/md_cg/test_issue278_negative_layering.py +83 -0
- package/md_cg/test_issue279_signers_path_guard.py +652 -0
- package/md_cg/test_issue284_skip_not_pass.py +291 -0
- package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
- package/md_cg/test_issue295_sleep_root_binding.py +589 -0
- package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
- package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
- package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
- package/md_cg/test_issue303_design_boundaries.py +262 -0
- package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
- package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
- package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
- package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
- package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
- package/md_cg/test_issue321_mcp_deep_json.py +305 -0
- package/md_cg/test_issue322_node_write_lock.py +727 -0
- package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
- package/md_cg/test_issue324_write_size_fields.py +215 -0
- package/md_cg/test_issue325_audit_poison.py +230 -0
- package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
- package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
- package/md_cg/test_issue326_key_perms.py +355 -0
- package/md_cg/test_issue326_twin_parser_parity.py +323 -0
- package/md_cg/test_issue326_vm_call_frame.py +569 -0
- package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
- package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
- package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
- package/md_cg/test_issue348_insight_verify_op.py +200 -0
- package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
- package/md_cg/test_issue350_casefold_collision.py +236 -0
- package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
- package/md_cg/test_issue352_imgaudit.py +418 -0
- package/md_cg/test_issue352_pathsjson.py +537 -0
- package/md_cg/test_issue352_refindex.py +412 -0
- package/md_cg/test_issue352_rollback.py +604 -0
- package/md_cg/test_issue352_vstateinherit.py +196 -0
- package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
- package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
- package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
- package/md_cg/test_issue354_rust_index_containment.py +571 -0
- package/md_cg/test_issue354_rust_wal_containment.py +606 -0
- package/md_cg/test_issue358_truncation_observable.py +247 -0
- package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
- package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
- package/md_cg/test_issue362_neg_condition.py +468 -0
- package/md_cg/test_issue363_lexical_idf.py +275 -0
- package/md_cg/test_issue370_readcache_assembly.py +488 -0
- package/md_cg/test_issue375_state_slot_retire.py +325 -0
- package/md_cg/test_issue376_heartbeat_failed.py +293 -0
- package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
- package/md_cg/test_issue378_protected_floor.py +310 -0
- package/md_cg/test_issue383_state_event_write_gate.py +462 -0
- package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
- package/md_cg/test_issue398_toolface_op_parity.py +511 -0
- package/md_cg/test_issue399_hive_json_shape.py +317 -0
- package/md_cg/test_issue400_hive_dirty_args.py +450 -0
- package/md_cg/test_issue401_wisdom_codegen.py +295 -0
- package/md_cg/test_issue404_heal_receipt.py +390 -0
- package/md_cg/test_issue405_git_pathspec.py +333 -0
- package/md_cg/test_issue408_eface_registry.py +291 -0
- package/md_cg/test_issue409_compact_index_completeness.py +509 -0
- package/md_cg/test_issue410_verify_demote_write.py +366 -0
- package/md_cg/test_issue411_scrub_idempotence.py +575 -0
- package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
- package/md_cg/test_issue413_preimage_failclosed.py +239 -0
- package/md_cg/test_issue413_preimage_twin.py +340 -0
- package/md_cg/test_issue414_write_args_parity.py +613 -0
- package/md_cg/test_issue415_deps_gate_probe.py +358 -0
- package/md_cg/test_issue416_entry_key_subset.py +525 -0
- package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
- package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
- package/md_cg/test_issue418_role_type_gate.py +265 -0
- package/md_cg/test_issue419_pii_redaction.py +642 -0
- package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
- package/md_cg/test_issue425_ingest_library_path.py +331 -0
- package/md_cg/test_issue426a_dedup_receipt.py +242 -0
- package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
- package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
- package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
- package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
- package/md_cg/test_issue427_serve_status_shape.py +191 -0
- package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
- package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
- package/md_cg/test_issue434_435_float_gate.py +90 -0
- package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
- package/md_cg/test_issue43_default_policy.py +874 -865
- package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
- package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
- package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
- package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
- package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
- package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
- package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
- package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
- package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
- package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
- package/md_cg/test_issue451_audit_actor.py +313 -0
- package/md_cg/test_issue452_ingest_root_hint.py +238 -0
- package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
- package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
- package/md_cg/test_issue466_basis_registry.py +469 -0
- package/md_cg/test_issue467_identity_sensitivity.py +204 -0
- package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
- package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
- package/md_cg/test_issue470_wal_event_durable.py +427 -0
- package/md_cg/test_issue471_identity_readable.py +137 -0
- package/md_cg/test_issue472_audit_chain.py +91 -0
- package/md_cg/test_issue472_prune_ledger.py +106 -0
- package/md_cg/test_issue472_rollback_degraded.py +82 -0
- package/md_cg/test_issue491_compose_sandbox.py +460 -0
- package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
- package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
- package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
- package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
- package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
- package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
- package/md_cg/test_issue525_read_null_semantics.py +52 -0
- package/md_cg/test_issue538_hook_condition_space.py +97 -0
- package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
- package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
- package/md_cg/test_issue542_tenant_root_same.py +153 -0
- package/md_cg/test_issue543_issue_authorization.py +147 -0
- package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
- package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
- package/md_cg/test_issue546_ledger_concurrency.py +81 -0
- package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
- package/md_cg/test_issue547_audit_durable.py +96 -0
- package/md_cg/test_issue549_durable_append.py +143 -0
- package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
- package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
- package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
- package/md_cg/test_issue559_refine_prefix.py +70 -0
- package/md_cg/test_issue561_pending_review.py +109 -0
- package/md_cg/test_issue562_retired_faces.py +150 -0
- package/md_cg/test_issue66_scrub_semantics.py +107 -0
- package/md_cg/test_issue67_scrub_control_pool.py +233 -0
- package/md_cg/test_issue69_audit_boundary.py +129 -0
- package/md_cg/test_issue71_queue_backlog.py +377 -0
- package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
- package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
- package/md_cg/test_issue75_neural_failure.py +582 -0
- package/md_cg/test_issue78_export_concurrency.py +334 -0
- package/md_cg/test_issue80_residual_flush.py +169 -0
- package/md_cg/test_issue82_credential_rules.py +271 -0
- package/md_cg/test_issue82_layer_and_size.py +120 -0
- package/md_cg/test_issue84_portability.py +95 -0
- package/md_cg/test_issue85_export_overwrite.py +113 -0
- package/md_cg/test_issue86_runtime_revoke.py +110 -0
- package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
- package/md_cg/test_issue88_conclusion_face.py +280 -0
- package/md_cg/test_issue88_execution_conflicts.py +87 -0
- package/md_cg/test_issue89_zero_score.py +169 -0
- package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
- package/md_cg/test_issue91_verifier_sandbox.py +314 -0
- package/md_cg/test_issue91_verifier_timeout.py +528 -0
- package/md_cg/test_issue93_remember_redaction.py +282 -0
- package/md_cg/test_issue96_key_fallback.py +102 -0
- package/md_cg/test_issue98_tenant_root.py +104 -0
- package/md_cg/test_jsonl_commit_watermark.py +221 -0
- package/md_cg/test_live_validity_cache.py +256 -0
- package/md_cg/test_logref.py +1141 -1109
- package/md_cg/test_mcp_call_argument_types.py +99 -0
- package/md_cg/test_md_access_parity.py +330 -255
- package/md_cg/test_md_cg_no_hive_dep.py +140 -0
- package/md_cg/test_memory_rsi.py +215 -0
- package/md_cg/test_memory_rsi_adversarial.py +91 -0
- package/md_cg/test_mode_parity.py +1413 -1393
- package/md_cg/test_mutation_residue.py +120 -0
- package/md_cg/test_mutation_rollback.py +835 -805
- package/md_cg/test_n123_derive_expiry_chain.py +210 -205
- package/md_cg/test_n130_verify_falsified_protect.py +185 -185
- package/md_cg/test_n209_verify_write_face_gates.py +466 -461
- package/md_cg/test_n230_dirty_replay.py +52 -9
- package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
- package/md_cg/test_neg_coverage_budget.py +500 -0
- package/md_cg/test_neg_tail_honesty.py +733 -663
- package/md_cg/test_p0.py +16 -2
- package/md_cg/test_p14_root_fallback.py +373 -0
- package/md_cg/test_p1x_ref_root.py +47 -10
- package/md_cg/test_p21_tokens.py +294 -293
- package/md_cg/test_p24_evidence.py +232 -227
- package/md_cg/test_p26_refindex.py +20 -3
- package/md_cg/test_p27_docindex.py +792 -777
- package/md_cg/test_p28_refcheck.py +1053 -1032
- package/md_cg/test_p29_session_ingest_export.py +6 -0
- package/md_cg/test_p2_mcp.py +474 -453
- package/md_cg/test_p2_six_elements.py +476 -463
- package/md_cg/test_p3.py +370 -261
- package/md_cg/test_p33_ccg_wiring.py +300 -293
- package/md_cg/test_p3_legacy_closure.py +438 -433
- package/md_cg/test_p40_refine_worklist.py +244 -241
- package/md_cg/test_p47_session_view.py +25 -9
- package/md_cg/test_p4_freshness.py +781 -774
- package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
- package/md_cg/test_p9c_dedup_hints.py +288 -283
- package/md_cg/test_policy_required_ccg.py +444 -432
- package/md_cg/test_postings_digest_memo.py +139 -0
- package/md_cg/test_predict_beta.py +138 -135
- package/md_cg/test_qmd.py +500 -0
- package/md_cg/test_query_excerpt.py +209 -0
- package/md_cg/test_reach.py +456 -378
- package/md_cg/test_reach_snapshot_admission.py +218 -0
- package/md_cg/test_readcache_prodpath.py +4 -0
- package/md_cg/test_recall_face_guards.py +854 -812
- package/md_cg/test_recall_metadata.py +422 -0
- package/md_cg/test_retr_s5.py +312 -213
- package/md_cg/test_retr_score_once.py +14 -2
- package/md_cg/test_review_cli_attribution.py +11 -7
- package/md_cg/test_review_queue_batch.py +123 -0
- package/md_cg/test_review_queue_index.py +130 -0
- package/md_cg/test_rrf_candidates.py +292 -0
- package/md_cg/test_rrf_qualified_topk.py +214 -0
- package/md_cg/test_rrf_unique_votes.py +218 -0
- package/md_cg/test_s1_ast_judge.py +110 -0
- package/md_cg/test_scrub_ledger.py +413 -0
- package/md_cg/test_security_audit_b26.py +34 -3
- package/md_cg/test_security_audit_v21.py +1 -2
- package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
- package/md_cg/test_session5_identity.py +93 -0
- package/md_cg/test_session_attribution_consistency.py +813 -0
- package/md_cg/test_session_identity_tristate.py +486 -0
- package/md_cg/test_sleep_p1.py +35 -3
- package/md_cg/test_state_event_op.py +521 -514
- package/md_cg/test_state_projection_streaming.py +136 -0
- package/md_cg/test_stg_interval_candidates.py +280 -0
- package/md_cg/test_stg_time_blocks.py +239 -0
- package/md_cg/test_stgidx_index_parity.py +1024 -1020
- package/md_cg/test_subgraph_bounded_bfs.py +227 -0
- package/md_cg/test_sustain_bounded.py +652 -624
- package/md_cg/test_task_memory.py +394 -0
- package/md_cg/test_text_projection_mutations.py +101 -0
- package/md_cg/test_time_anchor.py +421 -0
- package/md_cg/test_time_core_lint.py +1024 -975
- package/md_cg/test_tool_face.py +200 -189
- package/md_cg/test_trust_bounded_frontier.py +248 -0
- package/md_cg/test_trust_edge_reachability.py +405 -0
- package/md_cg/test_w5_path_fingerprint.py +381 -0
- package/md_cg/test_w7_redlines.py +659 -0
- package/md_cg/test_write_return_shape.py +919 -0
- package/md_cg/test_writepipe.py +228 -226
- package/md_cg/timeanchor.py +534 -0
- package/md_cg/tokens.py +68 -5
- package/md_cg/tool_face.py +273 -260
- package/md_cg/trust.py +1114 -1030
- package/md_cg/twophase.py +303 -231
- package/md_cg/weights.py +642 -638
- package/md_cg/whitebox.py +536 -527
- package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
- package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
- package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
- package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
- package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
- package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
- package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
- package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
- package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
- package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
- package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
- package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
- package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
- package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
- package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
- package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
- package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
- package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
- package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
- package/md_cg/writelimit.py +584 -390
- package/md_cg/writepipe.py +1337 -826
- package/package.json +14 -9
- package/scripts/workspace_index.py +328 -0
- package/src/bridge.ts +34 -11
- package/src/cli.ts +75 -65
- package/src/hooks.ts +932 -776
- package/src/index.ts +30 -7
- package/src/init.ts +362 -361
- package/src/lib/datapath.ts +419 -326
- package/src/lib/hook_audit.ts +42 -3
- package/src/lib/mdcg_client.ts +469 -461
- package/src/lib/mutual.ts +481 -432
- package/src/lib/prompt_safety.ts +178 -149
- package/src/lib/roleplay_web.ts +30 -2
- package/src/lib/token_store.ts +274 -52
- package/src/tools.ts +271 -223
- package/zcode/README.md +1 -1
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
- 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
- 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
- package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
- package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
- package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
- 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
- package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
- package/docs/mdcg/guardrail-charter.md +0 -164
- package/docs/mdcg/lingshu_tutorial.html +0 -14956
- package/docs/mdcg/memory-assessment.html +0 -923
- package/docs/mdcg/memory_score.html +0 -213
- package/docs/mdcg/memory_score.png +0 -0
- package/docs/mdcg/release_v0.3.0.md +0 -36
- package/docs/mdcg/release_v0.4.11.md +0 -49
- package/docs/mdcg/release_v0.4.5.md +0 -55
- package/docs/mdcg/tool_table_v0.3.0.md +0 -117
- 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
- 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
- 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
- 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
- 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
- package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/docs/promo/bilibili-cover.jpg +0 -0
- package/docs/promo/promo-visual-1.png +0 -0
- package/docs/promo/promo-visual-2.png +0 -0
- package/docs/promo/promo-visual-3.png +0 -0
- package/docs/promo/promo-visual-4.png +0 -0
- package/docs/promo/promo-visual-5.png +0 -0
- package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
- 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
package/md_cg/freshness.py
CHANGED
|
@@ -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
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
#
|
|
93
|
-
#
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
"
|
|
99
|
-
"
|
|
100
|
-
"
|
|
101
|
-
"
|
|
102
|
-
"
|
|
103
|
-
|
|
104
|
-
"
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
#:
|
|
113
|
-
#:
|
|
114
|
-
#:
|
|
115
|
-
#:
|
|
116
|
-
#:
|
|
117
|
-
#:
|
|
118
|
-
#:
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
#:
|
|
123
|
-
#:
|
|
124
|
-
#:
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
#:
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
#:
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
#:
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
#
|
|
180
|
-
#
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
def
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
if
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
|
|
521
|
-
|
|
522
|
-
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
|
|
532
|
-
|
|
533
|
-
|
|
534
|
-
|
|
535
|
-
|
|
536
|
-
"""
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
|
|
540
|
-
|
|
541
|
-
|
|
542
|
-
|
|
543
|
-
|
|
544
|
-
|
|
545
|
-
|
|
546
|
-
|
|
547
|
-
|
|
548
|
-
"
|
|
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)}
|