@furongjun1999/dsh-memory 0.8.1 → 0.9.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +662 -659
- package/codebuddy/README.md +1 -1
- package/data/policy.json +17 -6
- 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 +1 -1
- 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 +18 -3
- package/lib/hooks.js +147 -18
- package/lib/index.d.ts +2 -2
- package/lib/index.js +18 -4
- 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 +13 -1
- 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 +16 -1
- 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 +8 -2
- package/lib/tools.js +22 -3
- 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 +22 -5
- 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 +572 -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 +21 -0
- package/md_cg/conformance_core.py +753 -0
- package/md_cg/consistency.py +1278 -955
- package/md_cg/consolidate.py +180 -20
- package/md_cg/crypto.py +794 -472
- 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 +14 -3
- 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 +86 -5
- 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 +7104 -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 +4 -1
- package/md_cg/probe_memory_rsi.py +95 -0
- package/md_cg/probe_memory_rsi_mcp.py +66 -0
- package/md_cg/protect.py +188 -28
- package/md_cg/protocol.py +492 -411
- package/md_cg/provenance.py +7 -1
- 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 +12 -3
- 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 +256 -19
- package/md_cg/rollback_cli.py +21 -1
- package/md_cg/rotate.py +347 -0
- package/md_cg/routing.py +62 -1
- 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 +1 -1
- package/md_cg/semantic/export_en_zh_map.py +2 -2
- package/md_cg/semantic/zh_en_atoms.py +2 -0
- 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 +273 -15
- package/md_cg/state_events.py +75 -10
- package/md_cg/state_slots.py +312 -221
- package/md_cg/stg.py +82 -16
- 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 +43 -3
- 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_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 +6 -4
- 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 +13 -4
- 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_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 +32 -0
- package/md_cg/test_mcp_call_argument_types.py +99 -0
- package/md_cg/test_md_access_parity.py +80 -5
- 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 +62 -32
- package/md_cg/test_n123_derive_expiry_chain.py +10 -5
- package/md_cg/test_n130_verify_falsified_protect.py +185 -185
- package/md_cg/test_n209_verify_write_face_gates.py +7 -2
- package/md_cg/test_n230_dirty_replay.py +52 -9
- package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
- package/md_cg/test_neg_coverage_budget.py +500 -0
- package/md_cg/test_neg_tail_honesty.py +79 -9
- 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 +2 -1
- 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 +16 -1
- package/md_cg/test_p28_refcheck.py +45 -24
- 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 +14 -1
- package/md_cg/test_p3.py +370 -261
- package/md_cg/test_p33_ccg_wiring.py +9 -2
- package/md_cg/test_p3_legacy_closure.py +6 -1
- package/md_cg/test_p40_refine_worklist.py +5 -2
- package/md_cg/test_p47_session_view.py +25 -9
- package/md_cg/test_p4_freshness.py +8 -1
- package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
- package/md_cg/test_p9c_dedup_hints.py +7 -2
- package/md_cg/test_policy_required_ccg.py +12 -0
- 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 +104 -5
- 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 +8 -1
- 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 +16 -12
- package/md_cg/test_subgraph_bounded_bfs.py +227 -0
- package/md_cg/test_sustain_bounded.py +30 -2
- 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 +5 -3
- 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 +110 -26
- package/md_cg/twophase.py +74 -2
- package/md_cg/weights.py +642 -638
- package/md_cg/whitebox.py +9 -0
- 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 +3 -2
- package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
- package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
- 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 +23 -3
- package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
- package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
- package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
- package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
- package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
- package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
- 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 +587 -76
- package/package.json +13 -9
- package/src/bridge.ts +34 -11
- package/src/cli.ts +75 -65
- package/src/hooks.ts +908 -776
- package/src/index.ts +19 -5
- package/src/init.ts +362 -361
- package/src/lib/datapath.ts +419 -326
- package/src/lib/hook_audit.ts +256 -243
- package/src/lib/mdcg_client.ts +10 -2
- package/src/lib/mutual.ts +481 -432
- package/src/lib/prompt_safety.ts +164 -149
- package/src/lib/roleplay_web.ts +30 -2
- package/src/lib/token_store.ts +274 -52
- package/src/tools.ts +249 -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/sustain.py
CHANGED
|
@@ -58,7 +58,8 @@ import time
|
|
|
58
58
|
|
|
59
59
|
from . import crypto
|
|
60
60
|
from .datapath import aux_root
|
|
61
|
-
from .fsutil import append_jsonl, atomic_write,
|
|
61
|
+
from .fsutil import (FileLock, append_jsonl, atomic_write, count_jsonl,
|
|
62
|
+
ends_mid_line, publish, read_jsonl)
|
|
62
63
|
from .mdcg import LAYERS
|
|
63
64
|
|
|
64
65
|
STAMP_VERSION = 1
|
|
@@ -241,6 +242,354 @@ def peers(d: str = None):
|
|
|
241
242
|
return out
|
|
242
243
|
|
|
243
244
|
|
|
245
|
+
# --------------------------------------------------------------------------
|
|
246
|
+
# 心跳台账(append-only · 有界分片轮转)—— 让「连续 N 周期无断」可严格测得
|
|
247
|
+
#
|
|
248
|
+
# 缺口(答卷 `docs/plans/灵枢1.0_最小智能系统实存答卷_v1.1.md` §八 分诊第 4 项 ·
|
|
249
|
+
# **甲类能力缺口**):`_sustain.jsonl` 是 heal **动作**台账(有动作才写,平静期与
|
|
250
|
+
# 停摆期不可区分),心跳戳是**覆盖式单点**(无历史序列)——故「连续 N 周期无断」
|
|
251
|
+
# 在现数据结构下**不可严格测得**(取证见 `docs/eval/W7v11_结构面局限取证_v0.1.md`
|
|
252
|
+
# §丁)。
|
|
253
|
+
#
|
|
254
|
+
# 本台账补此缺口:**每个心跳周期追加一行**(append-only、只追加不改写历史行),
|
|
255
|
+
# 配合 **分片轮转 + 保留片数上限**(有界,形态照抄 `_audit.jsonl` 轮转)与
|
|
256
|
+
# **节流探测**(把 stat 写入税摊到 1/N),并由只读统计
|
|
257
|
+
# `heartbeat_ledger_stats()` 直接算出「最长连续无断区间 / 断点数 / 最近一次周期
|
|
258
|
+
# 时刻」。位置与 `_sustain.jsonl` **同域**(库根 `<root>/_heartbeat.jsonl`)。
|
|
259
|
+
#
|
|
260
|
+
# **零判定变更**(硬边界):本台账只新增写入与只读统计,不改变任何既有读面——
|
|
261
|
+
# `beat()` 的返回、心跳戳字段、`_sustain.jsonl` 既有记录、`judge()`/`heal()` 的
|
|
262
|
+
# 返回均逐位不变(守卫 `md_cg/test_heartbeat_ledger.py` L1 钉死)。
|
|
263
|
+
#
|
|
264
|
+
# **写点边界**:只有**常驻循环**的 `SustainLoop.beat()` 记台账(那才是「心跳
|
|
265
|
+
# 周期」);`write_stamp` 的其它调用点不记——进度面刷新 `_flush_progress` 非心跳
|
|
266
|
+
# 周期(进/出六档各刷一次,会把「停摆」稀释),MCP 手动 `action=beat` 非循环
|
|
267
|
+
# 自证(人可手动补戳,不能当「循环活着」的证据)。故台账是**循环自证面**。
|
|
268
|
+
# --------------------------------------------------------------------------
|
|
269
|
+
|
|
270
|
+
HEARTBEAT_LOG = "_heartbeat.jsonl" # 活动台账(与 _sustain.jsonl 同域:库根)
|
|
271
|
+
HEARTBEAT_ARCHIVE = "_heartbeat_archive" # 分片归档目录(不在 LAYERS,不参与节点索引)
|
|
272
|
+
HEARTBEAT_INDEX = "_index.json" # 归档索引:分片 bytes/events 缓存(稳态 O(1))
|
|
273
|
+
HEARTBEAT_ROTATE_BYTES = 4 << 20 # 活动台账轮转阈值(≤0 关闭轮转=退回无上界)
|
|
274
|
+
HEARTBEAT_KEEP_SHARDS = 4 # 归档分片保留数(≤0 不淘汰;淘汰必留痕)
|
|
275
|
+
HEARTBEAT_PROBE_EVERY = 8 # 每 N 次写入探测一次大小(把写入税摊到 1/N)
|
|
276
|
+
HEARTBEAT_ENV = "MDCG_HEARTBEAT_LEDGER" # 开关(缺省开;"0"/"false"/"False" 关)
|
|
277
|
+
#: 相邻心跳周期间隔 ≤ 该阈值即视为「连续」;缺省 2× 心跳间隔(600s)= 1200s。
|
|
278
|
+
HEARTBEAT_GAP_THRESHOLD = 2.0 * DEFAULT_BEAT_INTERVAL
|
|
279
|
+
#: 轮转自述行与心跳周期行的区分标记(统计只取 kind=="beat",轮转痕不进时间序列)。
|
|
280
|
+
HB_KIND_BEAT = "beat"
|
|
281
|
+
HB_KIND_ROTATE = "rotate"
|
|
282
|
+
#: D2:非 beat 业务档的台账行 kind——失败档**必须在台账可见**(不被
|
|
283
|
+
#: `heartbeat_ledger_stats` 按 kind==HB_KIND_BEAT 的过滤吞掉)。
|
|
284
|
+
#: #376(2026-10-14)已接线:beat 与 tick 两档的失败行(ok 为假)统一进
|
|
285
|
+
#: `heartbeat_ledger_stats` 的 failed/failures 失败读数。
|
|
286
|
+
HB_KIND_TICK = "tick"
|
|
287
|
+
#: #376:失败明细保留条数(`failures` 只带**最近**这几条——读数有界)。
|
|
288
|
+
FAILURES_KEEP = 5
|
|
289
|
+
|
|
290
|
+
#: root → 已写次数(进程内;仅用于节流探测步长。跨进程各自计数,不影响正确性
|
|
291
|
+
#: ——多写者共享同一活动文件时,任一方到点都会做一次 stat,只是探测得更密)。
|
|
292
|
+
_HB_WRITES: dict = {}
|
|
293
|
+
|
|
294
|
+
|
|
295
|
+
# 生效条件:environ 缺省取 os.environ,读 HEARTBEAT_ENV 键,其 str() 值不在 AUTO_OFF_VALUES 中即返回 True(缺键回落 "1"=开);否则 False。
|
|
296
|
+
def heartbeat_ledger_enabled(environ=None) -> bool:
|
|
297
|
+
"""心跳台账开关(缺省**开**):`MDCG_HEARTBEAT_LEDGER` ∈ 关断字面量即关。"""
|
|
298
|
+
env = os.environ if environ is None else environ
|
|
299
|
+
return str(env.get(HEARTBEAT_ENV, "1")) not in AUTO_OFF_VALUES
|
|
300
|
+
|
|
301
|
+
|
|
302
|
+
#: D1 解耦开关:**缺省关**("0")——既有单线程基线(六档顺序)逐位不变。
|
|
303
|
+
BEAT_THREAD_ENV = "MDCG_SUSTAIN_BEAT_THREAD"
|
|
304
|
+
|
|
305
|
+
|
|
306
|
+
# 生效条件:environ 缺省取 os.environ,读 BEAT_THREAD_ENV 键,其 str() 值不在 AUTO_OFF_VALUES 中即返回 True(缺键回落 "0"=关);否则 False。
|
|
307
|
+
def beat_thread_enabled(environ=None) -> bool:
|
|
308
|
+
"""心跳独立线程开关(缺省**关**):`MDCG_SUSTAIN_BEAT_THREAD` ∈ 关断字面量即关。
|
|
309
|
+
|
|
310
|
+
开启后 `start()` 额外起一条 daemon 线程专用 beat:业务档阻塞时心跳仍推进
|
|
311
|
+
(判活面与被判活对象不再共用执行体,D1)。缺省关 ⇒ 既有行为逐位不变。
|
|
312
|
+
"""
|
|
313
|
+
env = os.environ if environ is None else environ
|
|
314
|
+
return str(env.get(BEAT_THREAD_ENV, "0")) not in AUTO_OFF_VALUES
|
|
315
|
+
|
|
316
|
+
|
|
317
|
+
# 生效条件:给定库根 root,返回 root/HEARTBEAT_LOG 的拼接路径。
|
|
318
|
+
def heartbeat_path(root: str) -> str:
|
|
319
|
+
return os.path.join(root, HEARTBEAT_LOG)
|
|
320
|
+
|
|
321
|
+
|
|
322
|
+
# 生效条件:给定库根 root,返回 root/HEARTBEAT_ARCHIVE 的拼接路径。
|
|
323
|
+
# 生效条件:root 给定时返回 root/SUSTAIN_LOG 的绝对路径(与 heartbeat_path 同形)。
|
|
324
|
+
# issue #547:落点路径的**单点 getter** —— 此前 sustain.py 内有两处直接拼
|
|
325
|
+
# os.path.join(root, SUSTAIN_LOG);与 heartbeat_path 对齐后产品代码只经 getter 取路径。
|
|
326
|
+
def sustain_log_path(root: str) -> str:
|
|
327
|
+
"""sustain 台账路径(单点)。"""
|
|
328
|
+
return os.path.join(root, SUSTAIN_LOG)
|
|
329
|
+
|
|
330
|
+
|
|
331
|
+
def heartbeat_archive_dir(root: str) -> str:
|
|
332
|
+
return os.path.join(root, HEARTBEAT_ARCHIVE)
|
|
333
|
+
|
|
334
|
+
|
|
335
|
+
# 生效条件:t 为数值时间戳时返回 "%Y-%m-%dT%H:%M:%S" 本地时间字符串。
|
|
336
|
+
def _iso(t) -> str:
|
|
337
|
+
return time.strftime("%Y-%m-%dT%H:%M:%S", time.localtime(float(t)))
|
|
338
|
+
|
|
339
|
+
|
|
340
|
+
# 生效条件:root/HEARTBEAT_ARCHIVE 可列目录时返回其中以 "_heartbeat." 开头、".jsonl" 结尾的名字升序列表(序号零填充 ⇒ 字典序==时间序);listdir 抛 OSError 时返回 []。
|
|
341
|
+
def _hb_shards(root: str):
|
|
342
|
+
try:
|
|
343
|
+
names = os.listdir(heartbeat_archive_dir(root))
|
|
344
|
+
except OSError:
|
|
345
|
+
return []
|
|
346
|
+
return sorted(n for n in names
|
|
347
|
+
if n.startswith("_heartbeat.") and n.endswith(".jsonl"))
|
|
348
|
+
|
|
349
|
+
|
|
350
|
+
# 生效条件:遍历 _hb_shards(root) 中 "_heartbeat.<n>.jsonl" 形式取 int(n) 最大值 top(解析失败 continue、无可解析项 top=0),返回 top+1。
|
|
351
|
+
def _hb_next_seq(root: str) -> int:
|
|
352
|
+
top = 0
|
|
353
|
+
for n in _hb_shards(root):
|
|
354
|
+
try:
|
|
355
|
+
top = max(top, int(n[len("_heartbeat."):-len(".jsonl")]))
|
|
356
|
+
except ValueError:
|
|
357
|
+
continue
|
|
358
|
+
return top + 1
|
|
359
|
+
|
|
360
|
+
|
|
361
|
+
# 生效条件:读 root/HEARTBEAT_ARCHIVE/HEARTBEAT_INDEX(json);不可读/损坏/非 dict 时回落 {},只保留 value 为 dict 的项。
|
|
362
|
+
def _hb_load_index(root: str) -> dict:
|
|
363
|
+
try:
|
|
364
|
+
with open(os.path.join(heartbeat_archive_dir(root), HEARTBEAT_INDEX),
|
|
365
|
+
"r", encoding="utf-8") as f:
|
|
366
|
+
data = json.load(f)
|
|
367
|
+
if isinstance(data, dict):
|
|
368
|
+
return {k: v for k, v in data.items() if isinstance(v, dict)}
|
|
369
|
+
except (OSError, ValueError):
|
|
370
|
+
pass
|
|
371
|
+
return {}
|
|
372
|
+
|
|
373
|
+
|
|
374
|
+
# 生效条件:把 idx 以 JSON(ensure_ascii=False, indent=1, sort_keys=True)原子写入 root/HEARTBEAT_ARCHIVE/HEARTBEAT_INDEX;OSError 被吞掉。
|
|
375
|
+
def _hb_save_index(root: str, idx: dict):
|
|
376
|
+
try:
|
|
377
|
+
os.makedirs(heartbeat_archive_dir(root), exist_ok=True)
|
|
378
|
+
atomic_write(os.path.join(heartbeat_archive_dir(root), HEARTBEAT_INDEX),
|
|
379
|
+
json.dumps(idx, ensure_ascii=False, indent=1, sort_keys=True))
|
|
380
|
+
except OSError:
|
|
381
|
+
pass
|
|
382
|
+
|
|
383
|
+
|
|
384
|
+
# 生效条件:HEARTBEAT_ROTATE_BYTES <= 0 时直接返回(轮转关闭);否则 root 写计数自增,未到 HEARTBEAT_PROBE_EVERY 倍数即返回;到倍数且活动台账 size ≥ 阈值时调用 rotate_heartbeat(root)。
|
|
385
|
+
def _hb_rotate_if_needed(root: str):
|
|
386
|
+
"""写前闸门:活动台账达阈值即切分(把 stat 摊到 1/HEARTBEAT_PROBE_EVERY)。"""
|
|
387
|
+
limit = HEARTBEAT_ROTATE_BYTES
|
|
388
|
+
if limit <= 0:
|
|
389
|
+
return
|
|
390
|
+
n = _HB_WRITES.get(root, 0) + 1
|
|
391
|
+
_HB_WRITES[root] = n
|
|
392
|
+
if n % HEARTBEAT_PROBE_EVERY:
|
|
393
|
+
return
|
|
394
|
+
try:
|
|
395
|
+
if os.path.getsize(heartbeat_path(root)) < limit:
|
|
396
|
+
return
|
|
397
|
+
except OSError:
|
|
398
|
+
return
|
|
399
|
+
rotate_heartbeat(root)
|
|
400
|
+
|
|
401
|
+
|
|
402
|
+
# 生效条件:在 FileLock(root/_heartbeat.rotate.lock) 下,若活动台账 size ≥ HEARTBEAT_ROTATE_BYTES 则 publish 为 HEARTBEAT_ARCHIVE/_heartbeat.%06d.jsonl,登记索引、淘汰越限分片,并在新活动台账追加一条 kind="rotate" 自述行后返回 {"shard","bytes","events","pruned"};size 不足、getsize OSError 或 rename 失败时返回 None。
|
|
403
|
+
def rotate_heartbeat(root: str, reason: str = "size"):
|
|
404
|
+
"""把活动心跳台账切分为归档分片(publish 原子 rename,不重写一个字节)。
|
|
405
|
+
|
|
406
|
+
语义边界(诚实面):
|
|
407
|
+
· 分片内容与轮转前**逐行一致**(rename 不动字节);轮转前记录序列是轮转后
|
|
408
|
+
(跨分片按时间序合并)序列的**前缀**——append-only 指「分片内只追加」,
|
|
409
|
+
分片封存后不再改写;
|
|
410
|
+
· 并发由 FileLock + 「rename 前复检大小 / 失败即返回 None」兜住;
|
|
411
|
+
· 保留策略只淘汰**分片**,且淘汰名单写进新台账的 rotate 自述行(不静默丢证据)。
|
|
412
|
+
"""
|
|
413
|
+
path = heartbeat_path(root)
|
|
414
|
+
with FileLock(os.path.join(root, "_heartbeat.rotate.lock"), timeout=5.0):
|
|
415
|
+
try:
|
|
416
|
+
size = os.path.getsize(path)
|
|
417
|
+
except OSError:
|
|
418
|
+
return None
|
|
419
|
+
if size < HEARTBEAT_ROTATE_BYTES:
|
|
420
|
+
return None # 已被并发写者轮转
|
|
421
|
+
arc = heartbeat_archive_dir(root)
|
|
422
|
+
os.makedirs(arc, exist_ok=True)
|
|
423
|
+
name = "_heartbeat.%06d.jsonl" % _hb_next_seq(root)
|
|
424
|
+
try:
|
|
425
|
+
publish(path, os.path.join(arc, name))
|
|
426
|
+
except OSError:
|
|
427
|
+
return None # 抢输(文件已被移走)→ 让位,不报错
|
|
428
|
+
events = count_jsonl(os.path.join(arc, name))
|
|
429
|
+
idx = _hb_load_index(root)
|
|
430
|
+
idx[name] = {"bytes": size, "events": events,
|
|
431
|
+
"t": round(time.time(), 3), "reason": reason}
|
|
432
|
+
_hb_save_index(root, idx)
|
|
433
|
+
pruned = _hb_prune_shards(root)
|
|
434
|
+
_HB_WRITES[root] = 0
|
|
435
|
+
row = {"t": time.time(), "name": "_rotate", "pid": os.getpid(),
|
|
436
|
+
"kind": HB_KIND_ROTATE, "ok": True, "shard": name,
|
|
437
|
+
"bytes": size, "events": events, "pruned": pruned, "reason": reason}
|
|
438
|
+
try: # 自述留痕:轮转本身可审计
|
|
439
|
+
# #326-④:append_jsonl 不再上抛、以 False 报写失败——本处**仍容忍**(best-effort
|
|
440
|
+
# 簿记),但失败不再静默:源头已记 fsutil.APPEND_FAILURES + 有界 stderr 告警
|
|
441
|
+
# (B 面单点)。显式消费返回值:不留裸调用(守卫 AST 钉子会抓)。
|
|
442
|
+
_ok = append_jsonl(path, row)
|
|
443
|
+
except OSError:
|
|
444
|
+
pass
|
|
445
|
+
return {"shard": name, "bytes": size, "events": events, "pruned": pruned}
|
|
446
|
+
|
|
447
|
+
|
|
448
|
+
# 生效条件:HEARTBEAT_KEEP_SHARDS <= 0 时返回 [](不淘汰);否则保留最近 keep 个分片,越限的逐个 os.remove 并从索引 pop(OSError 则 continue),最后保存索引并返回被淘汰分片名列表。
|
|
449
|
+
def _hb_prune_shards(root: str):
|
|
450
|
+
"""保留最近 HEARTBEAT_KEEP_SHARDS 个分片、淘汰更旧的(≤0 表示不淘汰)。"""
|
|
451
|
+
keep = HEARTBEAT_KEEP_SHARDS
|
|
452
|
+
if keep <= 0:
|
|
453
|
+
return []
|
|
454
|
+
shards = _hb_shards(root)
|
|
455
|
+
gone = shards[:-keep] if len(shards) > keep else []
|
|
456
|
+
if not gone:
|
|
457
|
+
return []
|
|
458
|
+
idx = _hb_load_index(root)
|
|
459
|
+
for n in gone:
|
|
460
|
+
try:
|
|
461
|
+
os.remove(os.path.join(heartbeat_archive_dir(root), n))
|
|
462
|
+
except OSError:
|
|
463
|
+
continue # 删不掉就留着:不假装已淘汰
|
|
464
|
+
idx.pop(n, None)
|
|
465
|
+
_hb_save_index(root, idx)
|
|
466
|
+
return gone
|
|
467
|
+
|
|
468
|
+
|
|
469
|
+
# 生效条件:开关关(heartbeat_ledger_enabled() 为假)时返回 None 且不写盘;否则先经 _hb_rotate_if_needed(root) 有界闸门,再向 root/HEARTBEAT_LOG 追加一行 {"t","name","pid","kind":"beat","ok"(,"error")},返回该行;任何写入异常被吞掉并返回 None(心跳不可因台账而中断)。
|
|
470
|
+
def record_heartbeat(root: str, name: str, *, ok: bool = True, error=None,
|
|
471
|
+
t=None, pid=None, extra=None,
|
|
472
|
+
kind: str = HB_KIND_BEAT) -> dict:
|
|
473
|
+
"""追加一条**心跳周期**记录(append-only)——「连续 N 周期无断」的原始证据。
|
|
474
|
+
|
|
475
|
+
字段(至少):`t`(时间戳)+`name`(周期名)+`pid`+`ok`(该周期结果);
|
|
476
|
+
失败时附 `error`(摘要,截 200)。写路径 best-effort:开关关 / 任何异常都
|
|
477
|
+
返回 None 且不外溢(与心跳写戳同纪律)。
|
|
478
|
+
"""
|
|
479
|
+
if not heartbeat_ledger_enabled():
|
|
480
|
+
return None
|
|
481
|
+
row = {"t": float(t) if t is not None else time.time(),
|
|
482
|
+
"name": name, "pid": os.getpid() if pid is None else pid,
|
|
483
|
+
"kind": kind, "ok": bool(ok)}
|
|
484
|
+
if error is not None:
|
|
485
|
+
row["error"] = str(error)[:200]
|
|
486
|
+
if extra:
|
|
487
|
+
row.update(extra)
|
|
488
|
+
try:
|
|
489
|
+
_hb_rotate_if_needed(root)
|
|
490
|
+
append_jsonl(heartbeat_path(root), row)
|
|
491
|
+
except Exception: # noqa: BLE001 —— 台账永不拖垮心跳
|
|
492
|
+
return None
|
|
493
|
+
return row
|
|
494
|
+
|
|
495
|
+
|
|
496
|
+
# 生效条件:按 _hb_shards(root)(时间序,旧片在前)再活动台账的顺序流式产出各 JSONL 记录(read_jsonl 自动跳过坏行);文件/目录缺失即跳过。
|
|
497
|
+
def _hb_records(root: str):
|
|
498
|
+
arc = heartbeat_archive_dir(root)
|
|
499
|
+
for n in _hb_shards(root):
|
|
500
|
+
for r in read_jsonl(os.path.join(arc, n)):
|
|
501
|
+
yield r
|
|
502
|
+
for r in read_jsonl(heartbeat_path(root)):
|
|
503
|
+
yield r
|
|
504
|
+
|
|
505
|
+
|
|
506
|
+
# 生效条件:只读统计 root 下 kind∈{beat,tick} 的记录(name 非 None 时按周期名过滤)——成功 beat 的 t 序列以相邻 t 间隔 > threshold_s 为断点;失败行(beat/tick 的 ok 为假)只进失败读数、不进时间序列;返回 {n, threshold_s, shards, file, failed, failures, absent, span_s, span_iso, last_iso, last_age_s, segments, longest_s, longest_iso, count_in_longest, breaks, breaks_top};该过滤名下一条记录都没有时 absent=True 且各时序读数 None(只有失败行时 absent=False、n=0、failed=该档失败行数、failures=最近 FAILURES_KEEP 条明细)。
|
|
507
|
+
def heartbeat_ledger_stats(root: str, *, name: str = None,
|
|
508
|
+
threshold_s: float = HEARTBEAT_GAP_THRESHOLD) -> dict:
|
|
509
|
+
"""只读统计:**最长连续无断区间 / 断点数 / 最近一次周期时刻**(+失败读数)。
|
|
510
|
+
|
|
511
|
+
用途=闭合答卷 §八 分诊第 4 项的「不可严格测得」——`_sustain.jsonl`(heal 动作
|
|
512
|
+
台账)与心跳戳(覆盖式单点)都答不了,本台账答得了。**只读**:不写、不轮转。
|
|
513
|
+
有界台账(分片 ≤ 保留片数 × 轮转阈值)使该读数代价有界。
|
|
514
|
+
|
|
515
|
+
#376(2026-10-14):时间序列**只纳入成功的 beat**——原实现按 `kind=="beat"`
|
|
516
|
+
取数,把 `ok=False` 的心跳也折成时间戳计入,于是「连续 N 周期无断」被失败行
|
|
517
|
+
刷长、业务档失败行则被 kind 过滤**整个丢弃**(两类表现同一根因)。修后:失败
|
|
518
|
+
的 beat 与业务档 tick 进**独立失败读数** `failed`(失败行数)与 `failures`
|
|
519
|
+
(最近 `FAILURES_KEEP` 条明细,落账序)。**不改写入路径 / 调度 / 配置 / 告警**
|
|
520
|
+
(本函数只读);**全成功台账的原有读数逐位不变**(n/threshold_s/shards/file/
|
|
521
|
+
absent/span_*/last_*/segments/longest_*/count_in_longest/breaks* 一律照旧,
|
|
522
|
+
两个失败字段是纯增量)。`absent` 口径随之钉为「该过滤名下**一条记录都没有**」:
|
|
523
|
+
只有失败行的档位是 absent=False + n=0 + failed=k(那正是必须可见的形态),
|
|
524
|
+
空台账仍 absent=True。
|
|
525
|
+
"""
|
|
526
|
+
def _num(x): # t 可取数判据(bool 不算数,沿用原口径)
|
|
527
|
+
return isinstance(x, (int, float)) and not isinstance(x, bool)
|
|
528
|
+
|
|
529
|
+
ts, failed, failures = [], 0, []
|
|
530
|
+
for r in _hb_records(root):
|
|
531
|
+
if not isinstance(r, dict):
|
|
532
|
+
continue
|
|
533
|
+
_kind = r.get("kind")
|
|
534
|
+
if _kind not in (HB_KIND_BEAT, HB_KIND_TICK):
|
|
535
|
+
continue # 轮转自述行等非周期行不进统计(原口径)
|
|
536
|
+
if name is not None and r.get("name") != name:
|
|
537
|
+
continue
|
|
538
|
+
if not r.get("ok", True):
|
|
539
|
+
# #376:失败行(beat 与 tick 同列)——契约见 HB_KIND_TICK 注释。
|
|
540
|
+
# **不进**时间序列:失败周期不是「无断」的证据。
|
|
541
|
+
failed += 1
|
|
542
|
+
_t = r.get("t")
|
|
543
|
+
failures.append({"t": float(_t) if _num(_t) else None,
|
|
544
|
+
"iso": _iso(_t) if _num(_t) else None,
|
|
545
|
+
"name": r.get("name"), "kind": _kind,
|
|
546
|
+
"error": r.get("error")})
|
|
547
|
+
continue
|
|
548
|
+
if _kind != HB_KIND_BEAT:
|
|
549
|
+
continue # 成功业务档不进心跳时间序列(原口径)
|
|
550
|
+
v = r.get("t")
|
|
551
|
+
if _num(v):
|
|
552
|
+
ts.append(float(v))
|
|
553
|
+
ts.sort()
|
|
554
|
+
# 失败明细按**落账序**取最近 FAILURES_KEEP 条(_hb_records 恒为时间序流)。
|
|
555
|
+
out = {"n": len(ts), "threshold_s": float(threshold_s),
|
|
556
|
+
"shards": len(_hb_shards(root)), "file": HEARTBEAT_LOG,
|
|
557
|
+
"failed": failed, "failures": failures[-FAILURES_KEEP:]}
|
|
558
|
+
if not ts:
|
|
559
|
+
# absent=该过滤名下**一条记录都没有**(既无成功 beat 也无失败行)。
|
|
560
|
+
# 只有失败行时 absent=False:那种台账恰恰是必须看得见的一种形态。
|
|
561
|
+
out.update({"absent": failed == 0, "segments": 0, "longest_s": None,
|
|
562
|
+
"longest_iso": None, "count_in_longest": 0,
|
|
563
|
+
"breaks": 0, "breaks_top": [], "span_s": None,
|
|
564
|
+
"span_iso": None, "last_iso": None, "last_age_s": None})
|
|
565
|
+
return out
|
|
566
|
+
runs, breaks = [], []
|
|
567
|
+
start = prev = ts[0]
|
|
568
|
+
for t in ts[1:]:
|
|
569
|
+
if t - prev > threshold_s:
|
|
570
|
+
runs.append((start, prev))
|
|
571
|
+
breaks.append({"at_iso": _iso(prev), "next_iso": _iso(t),
|
|
572
|
+
"gap_s": round(t - prev, 1)})
|
|
573
|
+
start = t
|
|
574
|
+
prev = t
|
|
575
|
+
runs.append((start, prev))
|
|
576
|
+
best = max(runs, key=lambda r: r[1] - r[0])
|
|
577
|
+
out.update({
|
|
578
|
+
"absent": False,
|
|
579
|
+
"span_s": round(ts[-1] - ts[0], 1),
|
|
580
|
+
"span_iso": "%s → %s" % (_iso(ts[0]), _iso(ts[-1])),
|
|
581
|
+
"last_iso": _iso(ts[-1]),
|
|
582
|
+
"last_age_s": round(max(0.0, time.time() - ts[-1]), 1),
|
|
583
|
+
"segments": len(runs),
|
|
584
|
+
"longest_s": round(best[1] - best[0], 1),
|
|
585
|
+
"longest_iso": "%s → %s" % (_iso(best[0]), _iso(best[1])),
|
|
586
|
+
"count_in_longest": sum(1 for t in ts if best[0] <= t <= best[1]),
|
|
587
|
+
"breaks": len(breaks),
|
|
588
|
+
"breaks_top": sorted(breaks, key=lambda b: -b["gap_s"])[:5],
|
|
589
|
+
})
|
|
590
|
+
return out
|
|
591
|
+
|
|
592
|
+
|
|
244
593
|
# --------------------------------------------------------------------------
|
|
245
594
|
# 互维闭环(P-T-110 最小投影 · #30)
|
|
246
595
|
# --------------------------------------------------------------------------
|
|
@@ -294,7 +643,7 @@ def _last_mutual_restart(root: str, peer: str) -> float:
|
|
|
294
643
|
"""_sustain.jsonl 里该对端最近一次互维拉起时间(无 → 0.0,审计即状态)。"""
|
|
295
644
|
last = 0.0
|
|
296
645
|
try:
|
|
297
|
-
with open(
|
|
646
|
+
with open(sustain_log_path(root), encoding="utf-8") as f:
|
|
298
647
|
for line in f:
|
|
299
648
|
try:
|
|
300
649
|
r = json.loads(line)
|
|
@@ -451,7 +800,7 @@ def _index_log_shards(root: str):
|
|
|
451
800
|
return [f for f in os.listdir(d) if f.endswith(".log")]
|
|
452
801
|
|
|
453
802
|
|
|
454
|
-
# 生效条件:cg 具备 crypto_status 且其返回 unlocked 为假时,返回 cg.index['nodes'] 中 sensitivity
|
|
803
|
+
# 生效条件:cg 具备 crypto_status 且其返回 unlocked 为假时,返回 cg.index['nodes'] 中 sensitivity 经 crypto.is_encrypted_level 判为加密档的条目数;属性缺失、调用异常或已解锁时返回 0。
|
|
455
804
|
def _locked_nodes(cg) -> int:
|
|
456
805
|
"""加密引擎在「未解锁」状态下被隔离的私有节点数(缺密钥 = 权限事实)。"""
|
|
457
806
|
if not hasattr(cg, "crypto_status"):
|
|
@@ -468,7 +817,7 @@ def _locked_nodes(cg) -> int:
|
|
|
468
817
|
# during iteration')(N138,FI-M04)。list() 拷贝在 C 层一次完成(迭代期间
|
|
469
818
|
# 不释放 GIL),故快照自身原子;判据与结果逐位不变(只换取用方式)。
|
|
470
819
|
return sum(1 for e in list(nodes.values())
|
|
471
|
-
if (e.get("sensitivity")
|
|
820
|
+
if crypto.is_encrypted_level(e.get("sensitivity")))
|
|
472
821
|
|
|
473
822
|
|
|
474
823
|
# --------------------------------------------------------------------------
|
|
@@ -707,7 +1056,7 @@ def _seal_half_line(path: str):
|
|
|
707
1056
|
|
|
708
1057
|
# 生效条件:root/op/action 必填,向 root/SUSTAIN_LOG(模块常量)追加一行含 t/op/action/detail(截断 200)/pid 的 JSONL,无返回值。
|
|
709
1058
|
def _audit(root: str, op: str, action: str, detail: str = ""):
|
|
710
|
-
append_jsonl(
|
|
1059
|
+
append_jsonl(sustain_log_path(root),
|
|
711
1060
|
{"t": time.time(), "op": op, "action": action,
|
|
712
1061
|
"detail": str(detail)[:200], "pid": os.getpid()})
|
|
713
1062
|
|
|
@@ -822,14 +1171,21 @@ def heal(cg, *, name: str = "md_cg", dry_run: bool = False,
|
|
|
822
1171
|
except Exception as e: # 自愈失败不能拖垮进程
|
|
823
1172
|
actions.append({"code": code, "detail": detail, "applied": True,
|
|
824
1173
|
"ok": False, "error": f"{type(e).__name__}: {e}"})
|
|
1174
|
+
# #404:台账是**外部可见读数**,必须与事实一致——失败时把「清理 N 个…」改写成
|
|
1175
|
+
# 带结果的形态再落账,否则 `_audit` 会照写一行「已清理 N 个」的假账(issue 期望 #2)。
|
|
1176
|
+
# 只改 detail(不动 applied/ok 语义)。
|
|
1177
|
+
detail = "%s → 失败:%s: %s" % (detail, type(e).__name__, e)
|
|
825
1178
|
else:
|
|
826
1179
|
# `fn()` 跑完 ≠ 修好:返回 dict 且 ok is False(或 truncated)时
|
|
827
1180
|
# 如实记 ok=False——「重建失败」绝不能被记成 ok=True。
|
|
828
1181
|
bad = _bad_result(res)
|
|
829
1182
|
row = {"code": code, "detail": detail, "applied": True, "ok": not bad}
|
|
830
1183
|
if isinstance(res, dict):
|
|
1184
|
+
# #404:白名单是**回执的判据面**——诚实计数(removed/planned)必须进得来,
|
|
1185
|
+
# 否则「删了几个」到不了外部读数(本件首版就被自己的守卫抓到这一点)。
|
|
831
1186
|
brief = {k: res[k] for k in ("ok", "indexed", "files", "truncated",
|
|
832
|
-
"roots_missing", "errors"
|
|
1187
|
+
"roots_missing", "errors",
|
|
1188
|
+
"removed", "planned")
|
|
833
1189
|
if k in res}
|
|
834
1190
|
if isinstance(brief.get("errors"), list):
|
|
835
1191
|
brief["errors"] = brief["errors"][:1]
|
|
@@ -870,13 +1226,27 @@ def heal(cg, *, name: str = "md_cg", dry_run: bool = False,
|
|
|
870
1226
|
if "stale_temps" in codes:
|
|
871
1227
|
paths = _list_stale_temps(root, stale_temp_age)
|
|
872
1228
|
|
|
873
|
-
# 生效条件:对闭包变量 paths
|
|
1229
|
+
# 生效条件:对闭包变量 paths 逐个 os.remove 并按**实际结果**返回 {"ok","removed","planned","errors"}——单条失败记入 errors 后继续;paths 非空而**一个都没删掉**时抛 OSError(让 act 如实记 ok=False,不假装成功);paths 为空时返回 ok=True/removed=0(无事可做不是失败)。
|
|
874
1230
|
def _sweep():
|
|
1231
|
+
# #404(2026-10-16)根因:原实现 `except OSError: pass` 吞掉失败、且返回 None ⇒
|
|
1232
|
+
# act 的 `_bad_result(None)` 为假 ⇒ 回执 `applied=True/ok=True`,`_audit` 同时照写
|
|
1233
|
+
# 「清理 N 个陈旧临时文件」——**回执与台账都与事实相反**(同函数内 seal_half_lines
|
|
1234
|
+
# 不吞异常,本处是唯一把失败吞成成功的动作,与「绝不假装成功」正面对撞)。
|
|
1235
|
+
# 修法:按实际结果回报 + 全失败即抛(fail-loud);**不改 act 的 applied 语义**——
|
|
1236
|
+
# 沿用仓内既有口径(scrub.py 的 #411 修法:applied=动作跑过、ok=按事实判)。
|
|
1237
|
+
done, failed = 0, []
|
|
875
1238
|
for p in paths:
|
|
876
1239
|
try:
|
|
877
1240
|
os.remove(p)
|
|
878
|
-
except OSError:
|
|
879
|
-
|
|
1241
|
+
except OSError as e:
|
|
1242
|
+
failed.append("%s: %s" % (os.path.basename(p), e))
|
|
1243
|
+
else:
|
|
1244
|
+
done += 1
|
|
1245
|
+
if paths and done == 0:
|
|
1246
|
+
raise OSError("陈旧临时件一个都没删掉(%d/%d):%s"
|
|
1247
|
+
% (done, len(paths), ";".join(failed[:3])))
|
|
1248
|
+
return {"ok": not failed, "removed": done, "planned": len(paths),
|
|
1249
|
+
"errors": failed[:3]}
|
|
880
1250
|
act("sweep_temps", f"清理 {len(paths)} 个陈旧临时文件", _sweep)
|
|
881
1251
|
if "half_line_logs" in codes:
|
|
882
1252
|
paths = _half_line_logs(root)
|
|
@@ -1082,6 +1452,9 @@ class SustainLoop:
|
|
|
1082
1452
|
self.heals = []
|
|
1083
1453
|
self.last_scrub = None
|
|
1084
1454
|
self.scrubs = []
|
|
1455
|
+
# 自净轮次(issue #66):`_tick_scrub` 每轮自增,用作抽样 seed 的
|
|
1456
|
+
# 轮次分量——固定 seed 会让每轮样本逐字相同(抽样面冻结)。
|
|
1457
|
+
self.scrub_round = 0
|
|
1085
1458
|
self.last_evolve = None
|
|
1086
1459
|
self.evolves = []
|
|
1087
1460
|
self.last_tidy = None
|
|
@@ -1097,22 +1470,33 @@ class SustainLoop:
|
|
|
1097
1470
|
self._ticks_wrapped = False # 六档进度面包装的幂等标记
|
|
1098
1471
|
self._started_at = None
|
|
1099
1472
|
self._th = None
|
|
1473
|
+
self._beat_th = None # D1:独立心跳线程(缺省关)
|
|
1100
1474
|
self._stop = threading.Event()
|
|
1101
1475
|
self._lock = threading.Lock()
|
|
1102
1476
|
|
|
1103
1477
|
# ---- 心跳 ----
|
|
1104
1478
|
|
|
1105
|
-
# 生效条件:task_running 非 None 时先置 self.task_running=bool(task_running),再 write_stamp(self.name, self.d, task_running=self.task_running, root=self.cg.root, uptime=... if self._started_at else 0.0, **进度三字段)
|
|
1479
|
+
# 生效条件:task_running 非 None 时先置 self.task_running=bool(task_running),再 write_stamp(self.name, self.d, task_running=self.task_running, root=self.cg.root, uptime=... if self._started_at else 0.0, **进度三字段);写戳抛异常时先 record_heartbeat(ok=False, error=摘要) 再原样抛出;写戳成功则 beats 自增、记 last_beat=rec["ts"]、record_heartbeat(ok=True, t=rec["ts"]),返回该 rec;
|
|
1106
1480
|
def beat(self, task_running: bool = None) -> dict:
|
|
1107
1481
|
if task_running is not None:
|
|
1108
1482
|
self.task_running = bool(task_running)
|
|
1109
|
-
|
|
1110
|
-
|
|
1111
|
-
|
|
1112
|
-
|
|
1113
|
-
|
|
1483
|
+
try:
|
|
1484
|
+
rec = write_stamp(
|
|
1485
|
+
self.name, self.d, task_running=self.task_running, root=self.cg.root,
|
|
1486
|
+
uptime=round(time.time() - self._started_at, 3)
|
|
1487
|
+
if self._started_at else 0.0,
|
|
1488
|
+
**self._progress_fields()) # 进度面随心跳同落(单点状态面)
|
|
1489
|
+
except Exception as e: # noqa: BLE001
|
|
1490
|
+
# 写戳失败:台账如实记 error 摘要(「容忍≠静默」),随后**原样抛出**
|
|
1491
|
+
# ——既有行为不变(写戳失败 beat 亦失败,只是现在多一条错误留痕)。
|
|
1492
|
+
record_heartbeat(self.cg.root, self.name, ok=False,
|
|
1493
|
+
error="%s: %s" % (type(e).__name__, e))
|
|
1494
|
+
raise
|
|
1114
1495
|
self.beats += 1
|
|
1115
1496
|
self.last_beat = rec["ts"]
|
|
1497
|
+
# 心跳周期台账(append-only,缺省开):写戳成功后再追加一行。**不改返回、
|
|
1498
|
+
# 不改戳**(零判定变更,守卫 L1)——t 取戳的 ts,使台账与戳同源。
|
|
1499
|
+
record_heartbeat(self.cg.root, self.name, ok=True, t=rec["ts"])
|
|
1116
1500
|
return rec
|
|
1117
1501
|
|
|
1118
1502
|
# ---- 活体进度面(issue #63)----
|
|
@@ -1187,6 +1571,13 @@ class SustainLoop:
|
|
|
1187
1571
|
fn(*a, **kw)
|
|
1188
1572
|
except Exception as e: # noqa: BLE001
|
|
1189
1573
|
ok_ = False
|
|
1574
|
+
if name != "beat":
|
|
1575
|
+
# D2:失败档**必须在台账可见**——非 beat 业务档每轮失败追加
|
|
1576
|
+
# 一条 kind="tick" 行(beat 自身失败已由 beat() 记 ok=False)。
|
|
1577
|
+
record_heartbeat(self.cg.root, name, ok=False,
|
|
1578
|
+
error="%s: %s" % (type(e).__name__,
|
|
1579
|
+
str(e)[:200]),
|
|
1580
|
+
kind=HB_KIND_TICK)
|
|
1190
1581
|
self.last_tick_error = {"name": name, "t": time.time(),
|
|
1191
1582
|
"error": "%s: %s" % (type(e).__name__,
|
|
1192
1583
|
str(e)[:200])}
|
|
@@ -1234,6 +1625,12 @@ class SustainLoop:
|
|
|
1234
1625
|
self._th = threading.Thread(target=self._run, name="mdcg-sustain",
|
|
1235
1626
|
daemon=True)
|
|
1236
1627
|
self._th.start()
|
|
1628
|
+
if beat_thread_enabled():
|
|
1629
|
+
# D1:心跳独立线程(缺省关)——业务档阻塞时心跳仍推进。
|
|
1630
|
+
self._beat_th = threading.Thread(target=self._beat_loop,
|
|
1631
|
+
name="mdcg-sustain-beat",
|
|
1632
|
+
daemon=True)
|
|
1633
|
+
self._beat_th.start()
|
|
1237
1634
|
return self
|
|
1238
1635
|
|
|
1239
1636
|
# 生效条件:调用时置 _stop 事件,self._th 非 None 时 join(timeout)(默认 3.0)后置为 None,随后 clear_stamp(self.name, self.d),返回 self;
|
|
@@ -1242,12 +1639,24 @@ class SustainLoop:
|
|
|
1242
1639
|
if self._th is not None:
|
|
1243
1640
|
self._th.join(timeout)
|
|
1244
1641
|
self._th = None
|
|
1642
|
+
bt = getattr(self, "_beat_th", None)
|
|
1643
|
+
if bt is not None:
|
|
1644
|
+
bt.join(timeout) # _stop 已置位 ⇒ 心跳线程即刻退出
|
|
1645
|
+
self._beat_th = None
|
|
1245
1646
|
clear_stamp(self.name, self.d)
|
|
1246
1647
|
return self
|
|
1247
1648
|
|
|
1248
1649
|
# 生效条件:self._stop 未置位期间轮询(**先调 _wrap_ticks 给六档包上进度面,幂等**),按 beat_interval/heal_interval/scrub_interval/evolve_interval/tidy_interval/**sleep_interval(第六档)** 到期分别执行 beat 与 _tick_heal/_tick_scrub/_tick_evolve/_tick_tidy/_tick_sleep(六档调用形态与既有五档逐字同构:try/except 吞异常 + `_stop.wait(_POLL)` 收尾;进/出读数与异常记录由包装单点提供——issue #63);
|
|
1249
1650
|
def _run(self):
|
|
1250
1651
|
self._wrap_ticks() # issue #63:六档包上进度面(幂等,形态不变)
|
|
1652
|
+
# issue #207 T1(2026-10-13 DSH 端):beat 的**调度源**在开启独立心跳线程后
|
|
1653
|
+
# 应当**转移**而不是**叠加**。原实现下 start() 起了 _beat_loop 线程,
|
|
1654
|
+
# 而本循环仍在按 beat_interval 调 beat() —— 两路叠加,心跳与台账行数按
|
|
1655
|
+
# 倍率翻倍(实测 OFF=30 / ON=59 @0.2s),且 status()["beats"] 这一对外
|
|
1656
|
+
# 读数随之失真(uptime/beats 被外部用来推「转过多少轮」)。
|
|
1657
|
+
# 本函数自己的 docstring 写的就是「唯一改动的是 beat 的**调度源**」——
|
|
1658
|
+
# 是转移语义。缺省关时本标志恒为 True,既有单线程基线逐位不变。
|
|
1659
|
+
own_beat = not beat_thread_enabled()
|
|
1251
1660
|
next_beat = time.time() + self.beat_interval
|
|
1252
1661
|
next_heal = time.time() + self.heal_interval
|
|
1253
1662
|
next_scrub = time.time() + self.scrub_interval
|
|
@@ -1256,7 +1665,7 @@ class SustainLoop:
|
|
|
1256
1665
|
next_sleep = time.time() + self.sleep_interval
|
|
1257
1666
|
while not self._stop.is_set():
|
|
1258
1667
|
now = time.time()
|
|
1259
|
-
if now >= next_beat:
|
|
1668
|
+
if own_beat and now >= next_beat:
|
|
1260
1669
|
try:
|
|
1261
1670
|
self.beat()
|
|
1262
1671
|
except Exception:
|
|
@@ -1294,6 +1703,22 @@ class SustainLoop:
|
|
|
1294
1703
|
next_sleep = now + self.sleep_interval
|
|
1295
1704
|
self._stop.wait(_POLL)
|
|
1296
1705
|
|
|
1706
|
+
# ---- D1:心跳独立线程(缺省关)----
|
|
1707
|
+
|
|
1708
|
+
# 生效条件:由 start() 在 beat_thread_enabled() 为真时起一条 daemon 线程执行;循环里每 beat_interval 调一次 self.beat(),异常吞掉(心跳失败不拖垮常驻),_stop 置位即退出。
|
|
1709
|
+
def _beat_loop(self):
|
|
1710
|
+
"""独立心跳线程体(D1):与业务档**不共用执行体**——业务档阻塞时心跳仍推进。
|
|
1711
|
+
|
|
1712
|
+
唯一改动的是 beat 的**调度源**(多一条线程),复用既有 `beat()`(写戳 +
|
|
1713
|
+
台账,纯追加、无共享可变状态);缺省关时本线程不启动,既有单线程基线
|
|
1714
|
+
逐位不变。线程退出由 `_stop` 事件驱动(`stop()` 置位后 wait 立即返回)。
|
|
1715
|
+
"""
|
|
1716
|
+
while not self._stop.wait(self.beat_interval):
|
|
1717
|
+
try:
|
|
1718
|
+
self.beat()
|
|
1719
|
+
except Exception: # noqa: BLE001
|
|
1720
|
+
pass # 心跳失败不中断常驻
|
|
1721
|
+
|
|
1297
1722
|
# 生效条件:以 apply=self.auto_tidy 调 writelimit.tidy_contextual(self.cg, actor="sustain_tidy"),把 t/scanned/groups/members/applied_count/auto_tidy 记入 self.last_tidy 与 tidys(仅保留最近 20 条),随后调 _tick_conformance();auto_tidy 为假时只盘点不落盘;
|
|
1298
1723
|
def _tick_tidy(self):
|
|
1299
1724
|
"""整理巡检(contextual 流水治理·读侧):同构组聚合 + 成员降权。
|
|
@@ -1393,19 +1818,33 @@ class SustainLoop:
|
|
|
1393
1818
|
self.evolves.append(rec)
|
|
1394
1819
|
self.evolves = self.evolves[-20:]
|
|
1395
1820
|
|
|
1396
|
-
#
|
|
1821
|
+
# 生效条件:self.scrub_round 自增后以 seed=f"sustain:{self.scrub_round}"、dry_run=not self.auto_scrub 调 scrub.sweep(self.cg),把 t/ok/n_issues/n_high_medium/applied/already_handled/planned_dry_run/checked_breakdown/seed/dry_run 记入 last_scrub 与 scrubs(保留最近 20 条);auto_scrub=False(默认)时 dry_run=True 只读巡检;
|
|
1397
1822
|
def _tick_scrub(self):
|
|
1398
1823
|
"""记忆自净:抽查 → 联想 → 去污染 → 校准偏差。
|
|
1399
1824
|
|
|
1400
1825
|
`auto_scrub=False`(默认)时只做只读巡检并记账,不动任何节点;
|
|
1401
1826
|
开启后才执行去污染(仍只做可逆动作、永不删节点)。
|
|
1827
|
+
|
|
1828
|
+
抽样轮转(issue #66):seed 按**轮次**派生(`scrub_round` 每 tick
|
|
1829
|
+
自增)——固定 seed=0 会让每轮样本逐字相同(抽样面冻结,「老面孔」
|
|
1830
|
+
长期占用名额);库层 `scrub.sample` 的缺省 seed=0 不变(显式调用的
|
|
1831
|
+
可复现性不受影响)。
|
|
1402
1832
|
"""
|
|
1403
1833
|
from . import scrub
|
|
1404
|
-
|
|
1834
|
+
self.scrub_round += 1
|
|
1835
|
+
seed = f"sustain:{self.scrub_round}"
|
|
1836
|
+
rep = scrub.sweep(self.cg, dry_run=not self.auto_scrub, seed=seed)
|
|
1837
|
+
dec = rep["decontaminate"]
|
|
1405
1838
|
rec = {"t": rep["t"], "ok": rep["ok"],
|
|
1406
1839
|
"n_issues": rep["audit"]["n_issues"],
|
|
1407
1840
|
"n_high_medium": rep["n_high_medium"],
|
|
1408
|
-
"applied":
|
|
1841
|
+
"applied": dec["applied"],
|
|
1842
|
+
# 覆盖账(issue #66):轮读数可区分「旧面孔(名单命中跳过)」
|
|
1843
|
+
# 与「本轮检查」(dry_run 轮是常驻默认下唯一的账)。
|
|
1844
|
+
"already_handled": dec["already_handled"],
|
|
1845
|
+
"planned_dry_run": dec["planned_dry_run"],
|
|
1846
|
+
"checked_breakdown": dec["checked_breakdown"],
|
|
1847
|
+
"seed": seed,
|
|
1409
1848
|
"dry_run": rep["dry_run"]}
|
|
1410
1849
|
self.last_scrub = rec
|
|
1411
1850
|
with self._lock:
|