@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/trust.py
CHANGED
|
@@ -1,1030 +1,1114 @@
|
|
|
1
|
-
# -*- coding: utf-8 -*-
|
|
2
|
-
"""md_cg · 可验证记忆单元(验证态状态机 + 依赖图 + 双时间轴)
|
|
3
|
-
|
|
4
|
-
把「可信度」从散文式描述,变成**显式、可查询、可传播、可输出**的结构化状态。
|
|
5
|
-
三件事:
|
|
6
|
-
|
|
7
|
-
1. **验证态持续化**——`verification_state` ∈ (unverified / verified /
|
|
8
|
-
expired / doubted / rechecking),随验证动作与依赖变动**流转**,不是一次性
|
|
9
|
-
布尔开关;状态落 `frontmatter.verification_state`(节点 md 是唯一真源),
|
|
10
|
-
索引快照同名透出(免读文件可查)。
|
|
11
|
-
2. **依赖声明与失效传播**——单元显式声明它依赖谁(`depends_on`);被依赖单元
|
|
12
|
-
被修改/证伪时,**直接下游立即同步标为 doubted**(一跳,低成本);**多跳**
|
|
13
|
-
交由 `propagate()` 后台巡检重算,不阻塞写入与查询。
|
|
14
|
-
3. **双时间轴**——既有「何时不再成立」(`valid_until`)之外补「何时开始成立」
|
|
15
|
-
(`valid_from`),使时效区间可判定:未生效 / 生效中 / 已过期。
|
|
16
|
-
|
|
17
|
-
与 `lifecycle.py` 刻意分层(同构实现、**正交语义**,禁跨套复用常量):
|
|
18
|
-
· `lifecycle.py` = 节点**生命周期**(active/converged/demoted/archived);
|
|
19
|
-
· 本模块 = 节点**验证态**(unverified/verified/expired/doubted/rechecking)。
|
|
20
|
-
两者都是「单点裁决 + 单点推进 + 硬拒入口」,但状态集不共享、`_RANK` 不共享。
|
|
21
|
-
|
|
22
|
-
与 `provenance.py` 刻意分层:
|
|
23
|
-
· `provenance.py` = 节点**派生血缘**(「它由谁派生」,`_link.jsonl`);
|
|
24
|
-
· 本模块 = 节点**依赖与证据强度**(「它靠谁成立、现在还成不成立」,
|
|
25
|
-
`_trust.jsonl`)。血缘是既成事实,依赖是可失效假设——不可混用。
|
|
26
|
-
|
|
27
|
-
三条纪律(对齐 G8 裁定与 lifecycle 口径):
|
|
28
|
-
1. **台账失败降级不阻断写**——`mark_dependents()` 永不抛,写不进只留痕告警;
|
|
29
|
-
2. **历史不回填**——存量缺 `verification_state` 视为 `unverified`,`backfill()`
|
|
30
|
-
只在显式调用时把「缺省」变「显式」;
|
|
31
|
-
3. **巡检只读**——`patrol()` 检出悬空依赖/过期节点但**不自动改状态、不删节点**。
|
|
32
|
-
|
|
33
|
-
命名避让(既有先例):字段**不叫 `state`**——该名已被裁决四态
|
|
34
|
-
(ACCEPT/REJECT/DEFER/BLINDSPOT)占用,`lifecycle_state` 的先例同此动机。
|
|
35
|
-
|
|
36
|
-
零第三方依赖(D-005)。
|
|
37
|
-
"""
|
|
38
|
-
from __future__ import annotations
|
|
39
|
-
|
|
40
|
-
import os
|
|
41
|
-
import time
|
|
42
|
-
|
|
43
|
-
from
|
|
44
|
-
|
|
45
|
-
from .
|
|
46
|
-
from .
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
#:
|
|
51
|
-
#:
|
|
52
|
-
#:
|
|
53
|
-
#:
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
#:
|
|
59
|
-
|
|
60
|
-
HISTORY_KEEP
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
#:
|
|
64
|
-
|
|
65
|
-
#:
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
#:
|
|
74
|
-
|
|
75
|
-
#:
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
#:
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
#:
|
|
93
|
-
#:
|
|
94
|
-
#:
|
|
95
|
-
#:
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
("unverified", "
|
|
100
|
-
("unverified", "
|
|
101
|
-
("
|
|
102
|
-
("
|
|
103
|
-
("verified", "
|
|
104
|
-
("
|
|
105
|
-
("
|
|
106
|
-
("
|
|
107
|
-
("
|
|
108
|
-
("rechecking", "
|
|
109
|
-
("rechecking", "
|
|
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
|
-
if
|
|
149
|
-
return
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
if
|
|
163
|
-
return
|
|
164
|
-
if
|
|
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
|
-
|
|
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
|
-
return
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
def
|
|
299
|
-
"""
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
`
|
|
308
|
-
|
|
309
|
-
"""
|
|
310
|
-
if
|
|
311
|
-
return
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
return
|
|
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
|
-
if
|
|
445
|
-
return
|
|
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
|
-
if
|
|
504
|
-
return
|
|
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
|
-
|
|
549
|
-
|
|
550
|
-
|
|
551
|
-
|
|
552
|
-
|
|
553
|
-
|
|
554
|
-
|
|
555
|
-
|
|
556
|
-
|
|
557
|
-
|
|
558
|
-
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
|
|
574
|
-
|
|
575
|
-
|
|
576
|
-
|
|
577
|
-
|
|
578
|
-
|
|
579
|
-
|
|
580
|
-
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
584
|
-
|
|
585
|
-
|
|
586
|
-
|
|
587
|
-
|
|
588
|
-
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
"""
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
|
|
618
|
-
|
|
619
|
-
|
|
620
|
-
|
|
621
|
-
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
625
|
-
|
|
626
|
-
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
|
|
631
|
-
|
|
632
|
-
|
|
633
|
-
|
|
634
|
-
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
643
|
-
|
|
644
|
-
|
|
645
|
-
|
|
646
|
-
|
|
647
|
-
|
|
648
|
-
|
|
649
|
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
658
|
-
|
|
659
|
-
|
|
660
|
-
|
|
661
|
-
|
|
662
|
-
|
|
663
|
-
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
667
|
-
|
|
668
|
-
|
|
669
|
-
|
|
670
|
-
|
|
671
|
-
|
|
672
|
-
|
|
673
|
-
|
|
674
|
-
|
|
675
|
-
|
|
676
|
-
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
|
|
680
|
-
|
|
681
|
-
|
|
682
|
-
|
|
683
|
-
|
|
684
|
-
"""
|
|
685
|
-
|
|
686
|
-
|
|
687
|
-
|
|
688
|
-
|
|
689
|
-
|
|
690
|
-
|
|
691
|
-
|
|
692
|
-
|
|
693
|
-
|
|
694
|
-
|
|
695
|
-
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
|
|
701
|
-
|
|
702
|
-
|
|
703
|
-
|
|
704
|
-
|
|
705
|
-
|
|
706
|
-
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
|
|
759
|
-
|
|
760
|
-
|
|
761
|
-
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
|
|
772
|
-
|
|
773
|
-
|
|
774
|
-
|
|
775
|
-
"
|
|
776
|
-
"actor": actor})
|
|
777
|
-
return {"
|
|
778
|
-
"error":
|
|
779
|
-
|
|
780
|
-
|
|
781
|
-
|
|
782
|
-
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
786
|
-
|
|
787
|
-
|
|
788
|
-
|
|
789
|
-
|
|
790
|
-
|
|
791
|
-
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
795
|
-
|
|
796
|
-
|
|
797
|
-
|
|
798
|
-
|
|
799
|
-
|
|
800
|
-
|
|
801
|
-
|
|
802
|
-
|
|
803
|
-
"""
|
|
804
|
-
|
|
805
|
-
|
|
806
|
-
|
|
807
|
-
|
|
808
|
-
|
|
809
|
-
|
|
810
|
-
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
|
|
817
|
-
|
|
818
|
-
|
|
819
|
-
|
|
820
|
-
|
|
821
|
-
|
|
822
|
-
|
|
823
|
-
|
|
824
|
-
|
|
825
|
-
|
|
826
|
-
|
|
827
|
-
|
|
828
|
-
|
|
829
|
-
|
|
830
|
-
|
|
831
|
-
|
|
832
|
-
|
|
833
|
-
|
|
834
|
-
|
|
835
|
-
|
|
836
|
-
|
|
837
|
-
"
|
|
838
|
-
"
|
|
839
|
-
|
|
840
|
-
|
|
841
|
-
|
|
842
|
-
|
|
843
|
-
|
|
844
|
-
|
|
845
|
-
|
|
846
|
-
|
|
847
|
-
|
|
848
|
-
|
|
849
|
-
|
|
850
|
-
|
|
851
|
-
|
|
852
|
-
|
|
853
|
-
|
|
854
|
-
|
|
855
|
-
|
|
856
|
-
|
|
857
|
-
|
|
858
|
-
|
|
859
|
-
|
|
860
|
-
|
|
861
|
-
|
|
862
|
-
|
|
863
|
-
`
|
|
864
|
-
|
|
865
|
-
|
|
866
|
-
|
|
867
|
-
|
|
868
|
-
|
|
869
|
-
|
|
870
|
-
|
|
871
|
-
|
|
872
|
-
|
|
873
|
-
|
|
874
|
-
|
|
875
|
-
|
|
876
|
-
|
|
877
|
-
|
|
878
|
-
|
|
879
|
-
|
|
880
|
-
|
|
881
|
-
|
|
882
|
-
|
|
883
|
-
|
|
884
|
-
|
|
885
|
-
|
|
886
|
-
|
|
887
|
-
|
|
888
|
-
|
|
889
|
-
|
|
890
|
-
|
|
891
|
-
|
|
892
|
-
|
|
893
|
-
|
|
894
|
-
|
|
895
|
-
|
|
896
|
-
|
|
897
|
-
|
|
898
|
-
|
|
899
|
-
|
|
900
|
-
|
|
901
|
-
|
|
902
|
-
|
|
903
|
-
|
|
904
|
-
|
|
905
|
-
|
|
906
|
-
|
|
907
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
911
|
-
|
|
912
|
-
|
|
913
|
-
|
|
914
|
-
|
|
915
|
-
|
|
916
|
-
|
|
917
|
-
|
|
918
|
-
|
|
919
|
-
|
|
920
|
-
|
|
921
|
-
|
|
922
|
-
|
|
923
|
-
|
|
924
|
-
|
|
925
|
-
|
|
926
|
-
|
|
927
|
-
|
|
928
|
-
|
|
929
|
-
|
|
930
|
-
|
|
931
|
-
|
|
932
|
-
"
|
|
933
|
-
|
|
934
|
-
|
|
935
|
-
|
|
936
|
-
|
|
937
|
-
|
|
938
|
-
|
|
939
|
-
|
|
940
|
-
|
|
941
|
-
|
|
942
|
-
|
|
943
|
-
|
|
944
|
-
|
|
945
|
-
|
|
946
|
-
|
|
947
|
-
|
|
948
|
-
|
|
949
|
-
|
|
950
|
-
|
|
951
|
-
|
|
952
|
-
|
|
953
|
-
|
|
954
|
-
|
|
955
|
-
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
|
|
959
|
-
|
|
960
|
-
|
|
961
|
-
|
|
962
|
-
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
|
|
966
|
-
|
|
967
|
-
|
|
968
|
-
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
|
|
974
|
-
|
|
975
|
-
|
|
976
|
-
|
|
977
|
-
|
|
978
|
-
|
|
979
|
-
|
|
980
|
-
|
|
981
|
-
|
|
982
|
-
|
|
983
|
-
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
987
|
-
|
|
988
|
-
|
|
989
|
-
|
|
990
|
-
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
1001
|
-
|
|
1002
|
-
|
|
1003
|
-
|
|
1004
|
-
|
|
1005
|
-
|
|
1006
|
-
|
|
1007
|
-
|
|
1008
|
-
|
|
1009
|
-
|
|
1010
|
-
|
|
1011
|
-
|
|
1012
|
-
|
|
1013
|
-
|
|
1014
|
-
|
|
1015
|
-
|
|
1016
|
-
|
|
1017
|
-
|
|
1018
|
-
|
|
1019
|
-
|
|
1020
|
-
|
|
1021
|
-
|
|
1022
|
-
|
|
1023
|
-
|
|
1024
|
-
|
|
1025
|
-
|
|
1026
|
-
|
|
1027
|
-
|
|
1028
|
-
|
|
1029
|
-
|
|
1030
|
-
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""md_cg · 可验证记忆单元(验证态状态机 + 依赖图 + 双时间轴)
|
|
3
|
+
|
|
4
|
+
把「可信度」从散文式描述,变成**显式、可查询、可传播、可输出**的结构化状态。
|
|
5
|
+
三件事:
|
|
6
|
+
|
|
7
|
+
1. **验证态持续化**——`verification_state` ∈ (unverified / verified /
|
|
8
|
+
expired / doubted / rechecking),随验证动作与依赖变动**流转**,不是一次性
|
|
9
|
+
布尔开关;状态落 `frontmatter.verification_state`(节点 md 是唯一真源),
|
|
10
|
+
索引快照同名透出(免读文件可查)。
|
|
11
|
+
2. **依赖声明与失效传播**——单元显式声明它依赖谁(`depends_on`);被依赖单元
|
|
12
|
+
被修改/证伪时,**直接下游立即同步标为 doubted**(一跳,低成本);**多跳**
|
|
13
|
+
交由 `propagate()` 后台巡检重算,不阻塞写入与查询。
|
|
14
|
+
3. **双时间轴**——既有「何时不再成立」(`valid_until`)之外补「何时开始成立」
|
|
15
|
+
(`valid_from`),使时效区间可判定:未生效 / 生效中 / 已过期。
|
|
16
|
+
|
|
17
|
+
与 `lifecycle.py` 刻意分层(同构实现、**正交语义**,禁跨套复用常量):
|
|
18
|
+
· `lifecycle.py` = 节点**生命周期**(active/converged/demoted/archived);
|
|
19
|
+
· 本模块 = 节点**验证态**(unverified/verified/expired/doubted/rechecking)。
|
|
20
|
+
两者都是「单点裁决 + 单点推进 + 硬拒入口」,但状态集不共享、`_RANK` 不共享。
|
|
21
|
+
|
|
22
|
+
与 `provenance.py` 刻意分层:
|
|
23
|
+
· `provenance.py` = 节点**派生血缘**(「它由谁派生」,`_link.jsonl`);
|
|
24
|
+
· 本模块 = 节点**依赖与证据强度**(「它靠谁成立、现在还成不成立」,
|
|
25
|
+
`_trust.jsonl`)。血缘是既成事实,依赖是可失效假设——不可混用。
|
|
26
|
+
|
|
27
|
+
三条纪律(对齐 G8 裁定与 lifecycle 口径):
|
|
28
|
+
1. **台账失败降级不阻断写**——`mark_dependents()` 永不抛,写不进只留痕告警;
|
|
29
|
+
2. **历史不回填**——存量缺 `verification_state` 视为 `unverified`,`backfill()`
|
|
30
|
+
只在显式调用时把「缺省」变「显式」;
|
|
31
|
+
3. **巡检只读**——`patrol()` 检出悬空依赖/过期节点但**不自动改状态、不删节点**。
|
|
32
|
+
|
|
33
|
+
命名避让(既有先例):字段**不叫 `state`**——该名已被裁决四态
|
|
34
|
+
(ACCEPT/REJECT/DEFER/BLINDSPOT)占用,`lifecycle_state` 的先例同此动机。
|
|
35
|
+
|
|
36
|
+
零第三方依赖(D-005)。
|
|
37
|
+
"""
|
|
38
|
+
from __future__ import annotations
|
|
39
|
+
|
|
40
|
+
import os
|
|
41
|
+
import time
|
|
42
|
+
import math
|
|
43
|
+
from datetime import datetime
|
|
44
|
+
|
|
45
|
+
from . import protect
|
|
46
|
+
from . import security as _security
|
|
47
|
+
from .fsutil import append_jsonl, read_jsonl
|
|
48
|
+
from .security import AccessDenied
|
|
49
|
+
|
|
50
|
+
#: 验证态全集。语义:
|
|
51
|
+
#: unverified 未验证(默认;存量缺字段即视为它)
|
|
52
|
+
#: verified 已验证(有验证方式与证据,且依赖未动)
|
|
53
|
+
#: doubted 存疑(**依赖的地基动了**——异常的新定义)
|
|
54
|
+
#: rechecking 重新验证中(复核进行态)
|
|
55
|
+
#: expired 已过期(超出时效区间,或证据整体失效)
|
|
56
|
+
STATES = ("unverified", "verified", "doubted", "rechecking", "expired")
|
|
57
|
+
|
|
58
|
+
#: frontmatter 字段名(索引快照同名透出)。刻意避开 `state`——与 lifecycle 同动机。
|
|
59
|
+
STATE_FIELD = "verification_state"
|
|
60
|
+
#: 验证履历字段(frontmatter 侧历史,滚动保留最近 HISTORY_KEEP 条)
|
|
61
|
+
HISTORY_FIELD = "verification_history"
|
|
62
|
+
HISTORY_KEEP = 20
|
|
63
|
+
#: 依赖声明字段(CCG「子功能」槽的落字段)
|
|
64
|
+
DEPS_FIELD = "depends_on"
|
|
65
|
+
#: 双时间轴(**效力时间**)字段。2026-09-19 阶段一:规范名迁移到
|
|
66
|
+
#: `effective_from` / `effective_until`(**新写入落规范键**),历史名
|
|
67
|
+
#: `valid_from` / `valid_until` 保留为**读取侧回落别名**(存量不迁移、零破坏)。
|
|
68
|
+
FROM_FIELD = "valid_from"
|
|
69
|
+
UNTIL_FIELD = "valid_until"
|
|
70
|
+
#: 规范名(新写入落此;读取时优先于同名族旧键)
|
|
71
|
+
EFFECTIVE_FROM_FIELD = "effective_from"
|
|
72
|
+
EFFECTIVE_UNTIL_FIELD = "effective_until"
|
|
73
|
+
#: 信念时间(体系**何时确认此条**):取代/审核的锚。
|
|
74
|
+
#: **不是效力语义**——它既不是「已结束」也不是「尚未开始」,
|
|
75
|
+
#: 故绝不并入 `scrub._EXPIRY_KEYS`(已结束族)或 `scrub._NOT_YET_KEYS`(未生效族)。
|
|
76
|
+
BELIEVED_FIELD = "believed_at"
|
|
77
|
+
#: 过期时刻(写盘冗余:由 `effective_until` 派生落盘,供审计/对账直读)。
|
|
78
|
+
EXPIRED_FIELD = "expired_at"
|
|
79
|
+
|
|
80
|
+
#: 端点取值优先级(**规范键优先、别名回落**,2026-09-19 阶段一)。
|
|
81
|
+
#: 与 `scrub._NOT_YET_KEYS` / `scrub._EXPIRY_KEYS` 同键族——两处共用同一套别名,
|
|
82
|
+
#: 任一侧新增键须同步另一侧(交叉守卫测试 test_validity_filter 守住)。
|
|
83
|
+
FROM_ALIASES = (EFFECTIVE_FROM_FIELD, FROM_FIELD, "valid_since", "starts_at")
|
|
84
|
+
UNTIL_ALIASES = (EFFECTIVE_UNTIL_FIELD, UNTIL_FIELD,
|
|
85
|
+
"expires_at", "expire_at", "expiry", "deadline")
|
|
86
|
+
#: 验证态迁移审计(append-only,与 _lifecycle.jsonl / _maintain.jsonl 同风格)
|
|
87
|
+
AUDIT_FILE = "_trust.jsonl"
|
|
88
|
+
|
|
89
|
+
#: 降级序位(用于「受保护豁免降级」判定)。verified 最高,doubted/expired 更低。
|
|
90
|
+
_RANK = {"verified": 0, "rechecking": 1, "unverified": 1, "doubted": 2, "expired": 3}
|
|
91
|
+
|
|
92
|
+
#: 合法迁移表。刻意不收录的(即拒绝的):
|
|
93
|
+
#: verified → unverified(回落未验证:证据已存在,只应「存疑」而非「清零」)
|
|
94
|
+
#: doubted → expired(跳级:存疑未经复核不得直接判过期)
|
|
95
|
+
#: 注:`unverified → doubted` **收录**——两条路都真实到达这里:①上游变动波及一个
|
|
96
|
+
#: 从未验证过的下游(「地基动了」对未验证者同样成立);②未验证节点收到**负证据**
|
|
97
|
+
#: (证据削弱本身就是存疑的依据,比停在「未验证」更准确)。
|
|
98
|
+
TRANSITIONS = frozenset({
|
|
99
|
+
("unverified", "verified"),
|
|
100
|
+
("unverified", "doubted"),
|
|
101
|
+
("unverified", "rechecking"),
|
|
102
|
+
("unverified", "expired"),
|
|
103
|
+
("verified", "doubted"),
|
|
104
|
+
("verified", "rechecking"),
|
|
105
|
+
("verified", "expired"),
|
|
106
|
+
("doubted", "rechecking"),
|
|
107
|
+
("doubted", "verified"),
|
|
108
|
+
("rechecking", "verified"),
|
|
109
|
+
("rechecking", "doubted"),
|
|
110
|
+
("rechecking", "unverified"),
|
|
111
|
+
("rechecking", "expired"),
|
|
112
|
+
("expired", "rechecking"),
|
|
113
|
+
("expired", "verified"),
|
|
114
|
+
})
|
|
115
|
+
|
|
116
|
+
#: 依赖边上限(单节点直接下游数);超出即拒收,防「依赖声明写成噪声」。
|
|
117
|
+
MAX_DEPS = 32
|
|
118
|
+
#: 多跳传播的节点上限(对齐 subgraph.MAX_NODES_DEFAULT 的量级)
|
|
119
|
+
MAX_NODES_DEFAULT = 500
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
class TrustError(Exception):
|
|
123
|
+
"""非法验证态迁移 / 依赖声明非法(写路径用 `require_transition` 直接抛)。"""
|
|
124
|
+
|
|
125
|
+
def __init__(self, src, dst, code, reason):
|
|
126
|
+
super().__init__(f"非法验证态迁移 {src}→{dst}({code}):{reason}")
|
|
127
|
+
self.src, self.dst, self.code, self.reason = src, dst, code, reason
|
|
128
|
+
|
|
129
|
+
|
|
130
|
+
# ---------------------------------------------------------------- 纯函数裁决
|
|
131
|
+
|
|
132
|
+
def state_of(fm) -> str:
|
|
133
|
+
"""frontmatter → 验证态;缺字段或未知值 → "unverified"(存量兼容,不猜测)。"""
|
|
134
|
+
if not isinstance(fm, dict):
|
|
135
|
+
return "unverified"
|
|
136
|
+
s = fm.get(STATE_FIELD)
|
|
137
|
+
return s if s in STATES else "unverified"
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
def is_downgrade(src: str, dst: str) -> bool:
|
|
141
|
+
"""是否向「更低可信度」迁移(verified < unverified/rechecking < doubted < expired)。"""
|
|
142
|
+
return _RANK.get(dst, 0) > _RANK.get(src, 0)
|
|
143
|
+
|
|
144
|
+
|
|
145
|
+
def can_transition(src, dst) -> bool:
|
|
146
|
+
"""迁移是否合法(含幂等;未知 src 按 unverified 处理)。"""
|
|
147
|
+
src = src if src in STATES else "unverified"
|
|
148
|
+
if dst not in STATES:
|
|
149
|
+
return False
|
|
150
|
+
if src == dst:
|
|
151
|
+
return True # 幂等:同状态是 no-op
|
|
152
|
+
return (src, dst) in TRANSITIONS
|
|
153
|
+
|
|
154
|
+
|
|
155
|
+
def check(src, dst, protected: bool = False, override: bool = False):
|
|
156
|
+
"""迁移合法性裁决 → `(ok, code, reason)`。**唯一裁决点**(纯函数,无 IO)。
|
|
157
|
+
|
|
158
|
+
code 取值:`ok` / `noop`(同状态,不写盘)/ `unknown_state` /
|
|
159
|
+
`illegal_transition` / `protected`。
|
|
160
|
+
"""
|
|
161
|
+
src = src if src in STATES else "unverified"
|
|
162
|
+
if dst not in STATES:
|
|
163
|
+
return False, "unknown_state", f"未知验证态 {dst!r}(允许:{STATES})"
|
|
164
|
+
if src == dst:
|
|
165
|
+
return True, "noop", "验证态未变(幂等,不写盘)"
|
|
166
|
+
if (src, dst) not in TRANSITIONS:
|
|
167
|
+
legal = "、".join(f"{a}→{b}" for a, b in sorted(TRANSITIONS))
|
|
168
|
+
return False, "illegal_transition", (
|
|
169
|
+
f"{src}→{dst} 不在合法迁移表内(允许:{legal})——"
|
|
170
|
+
"验证态只沿「验证/存疑/复核/过期」四条路径流转,跨级迁移一律拒绝")
|
|
171
|
+
if is_downgrade(src, dst) and protected and not override:
|
|
172
|
+
return False, "protected", (
|
|
173
|
+
f"受保护节点不接受降级迁移 {src}→{dst}(保护 = 不可轻弃);"
|
|
174
|
+
"确需降级请显式 override=True")
|
|
175
|
+
return True, "ok", f"{src}→{dst} 合法"
|
|
176
|
+
|
|
177
|
+
|
|
178
|
+
def require_transition(src, dst, protected: bool = False, override: bool = False):
|
|
179
|
+
"""合法则返回 code,非法则抛 `TrustError`(写路径的硬拒入口)。"""
|
|
180
|
+
ok, code, why = check(src, dst, protected=protected, override=override)
|
|
181
|
+
if not ok:
|
|
182
|
+
raise TrustError(src if src in STATES else "unverified", dst, code, why)
|
|
183
|
+
return code
|
|
184
|
+
|
|
185
|
+
|
|
186
|
+
#: 裸 frontmatter 探针的假 node_id(`protect.is_protected` 的 `(cg, node_id)` 形态所需;
|
|
187
|
+
#: 真实节点 id 来自文件名/显式声明,不含 NUL ⇒ 与既有索引键不可能相撞)。
|
|
188
|
+
_FM_PROBE_ID = "\x00fm-probe"
|
|
189
|
+
|
|
190
|
+
|
|
191
|
+
class _FmProbe:
|
|
192
|
+
"""裸 frontmatter → `protect.is_protected` 所需的 `(cg, node_id)` 形态(**零规则载体**)。
|
|
193
|
+
|
|
194
|
+
#377(2026-10-14):本模块的降级判据此前只读 `fm["protected"]` / `fm["immutable"]`
|
|
195
|
+
两位,漏了 `protect.is_protected` 的**层保护**(layer ∈ {self, anchor})与**按分保护**。
|
|
196
|
+
本类**不复制任何判据**——规则单点仍是 `protect.is_protected`——只把调用方手里
|
|
197
|
+
已有的 frontmatter 摆成该判据所需的索引快照形态(唯一索引条目=该映射本身)。
|
|
198
|
+
刻意**不提供** `_maybe_reload_index`(`protect._fm` 的探活分支取不到即跳过)且
|
|
199
|
+
`get()` 恒返回 None(门控字段回退读文件的分支在此无文件可读、**不抛异常**)⇒
|
|
200
|
+
判定 100% 基于传入映射:零 IO、零副作用(`stamp` 是就地改 fm 的纯函数面)。
|
|
201
|
+
"""
|
|
202
|
+
|
|
203
|
+
__slots__ = ("index",)
|
|
204
|
+
|
|
205
|
+
def __init__(self, fm):
|
|
206
|
+
self.index = {"nodes": {_FM_PROBE_ID: fm if isinstance(fm, dict) else {}}}
|
|
207
|
+
|
|
208
|
+
def get(self, node_id=None): # protect._fm 的回退分支:探针无文件可读
|
|
209
|
+
return None
|
|
210
|
+
|
|
211
|
+
|
|
212
|
+
def _is_protected_fm(fm) -> tuple:
|
|
213
|
+
"""裸 frontmatter 的「不可遗忘」判定 → `(是否受保护, 原因)`。
|
|
214
|
+
|
|
215
|
+
判据单点=**`protect.is_protected`**(层保护 self/anchor ∪ 显式 protected 位 ∪
|
|
216
|
+
按分保护 ≥0.70 且来源缺省/hint);本函数只负责把它喂给判据,不自带任何规则。
|
|
217
|
+
"""
|
|
218
|
+
return protect.is_protected_entry(fm) # #431 批:_FmProbe 副本收口到条目口径单点
|
|
219
|
+
|
|
220
|
+
|
|
221
|
+
def stamp(fm: dict, dst: str, reason: str = None, actor: str = None,
|
|
222
|
+
evidence: str = None, method: str = None, trigger: str = None,
|
|
223
|
+
override: bool = False):
|
|
224
|
+
"""在给定 frontmatter 上**就地**推进验证态(无 IO)→ `(ok, code, why)`。
|
|
225
|
+
|
|
226
|
+
与 `set_state()` 共用同一裁决点(`check`),供**需与其他字段同批落盘**的
|
|
227
|
+
收口点使用(写入时一次写盘改依赖/时间轴/验证态)。
|
|
228
|
+
"""
|
|
229
|
+
src = state_of(fm)
|
|
230
|
+
# #377(2026-10-14):原判据只读 fm 的**显式两位**(protected / immutable),
|
|
231
|
+
# 漏了 `protect.is_protected` 的**层保护**(layer ∈ {self, anchor})与**按分保护**
|
|
232
|
+
# ——anchor/self 层节点可被无痕降级。改为「显式两位 ∪ is_protected」:
|
|
233
|
+
# **超集**,原判据一字不减(immutable 位照旧、override=True 照旧短路到 check 的
|
|
234
|
+
# override 分支)⇒ 既有判定与 override 通路逐位不变;判据本体仍是 protect 的单点,
|
|
235
|
+
# 不在本模块复制一份。
|
|
236
|
+
prot = bool(fm.get("protected") or fm.get("immutable")) \
|
|
237
|
+
or _is_protected_fm(fm)[0]
|
|
238
|
+
ok, code, why = check(src, dst, protected=prot, override=override)
|
|
239
|
+
if not ok or code == "noop":
|
|
240
|
+
return ok, code, why
|
|
241
|
+
fm[STATE_FIELD] = dst
|
|
242
|
+
rec = {"at": time.time(), "from": src, "to": dst, "reason": reason,
|
|
243
|
+
"actor": actor, "trigger": trigger}
|
|
244
|
+
if method:
|
|
245
|
+
rec["method"] = str(method)[:120]
|
|
246
|
+
if evidence:
|
|
247
|
+
rec["evidence"] = str(evidence)[:300]
|
|
248
|
+
hist = list(fm.get(HISTORY_FIELD) or [])
|
|
249
|
+
hist.append(rec)
|
|
250
|
+
fm[HISTORY_FIELD] = hist[-HISTORY_KEEP:]
|
|
251
|
+
if method:
|
|
252
|
+
fm["verification_method"] = str(method)[:120]
|
|
253
|
+
if evidence:
|
|
254
|
+
fm["verification_evidence"] = str(evidence)[:300]
|
|
255
|
+
fm["verified_at"] = rec["at"]
|
|
256
|
+
return True, code, why
|
|
257
|
+
|
|
258
|
+
|
|
259
|
+
# ---------------------------------------------------------------- 双时间轴
|
|
260
|
+
|
|
261
|
+
#: 单位归一判据:epoch **秒**到公元 5138 年仍 < 1e11,而 epoch **毫秒**自 1973-03
|
|
262
|
+
#: 起已 > 1e11 —— 量级差 3 个数量级,故「>= 1e11」判为毫秒。
|
|
263
|
+
#: 受保护的既有值:全时窗哨兵 `9999999999.0`(nodefile.FULL_TIME_WINDOW_MAX)
|
|
264
|
+
#: 与秒级 `created_at` 一律**不受影响**(test_trust 的「数字直通」断言同此)。
|
|
265
|
+
_MS_EPOCH_THRESHOLD = 1e11
|
|
266
|
+
|
|
267
|
+
|
|
268
|
+
def epoch_seconds(value, *, _allow_nonfinite=False):
|
|
269
|
+
"""时间**数值** → epoch 秒(单位归一的**唯一实现点**);非数值 → None。
|
|
270
|
+
|
|
271
|
+
为什么需要它(issue #23 根因):图内规范单位是**秒**——`created_at`、
|
|
272
|
+
`mdcg._write` 的默认观测窗、全时窗哨兵、`parse_time` 全是秒;但摄取链
|
|
273
|
+
(`sources.DSHSessionSource` / `JsonlSource`)历史上产出**毫秒**。毫秒值一旦
|
|
274
|
+
进入 `condition_space.time_window`,`stg(op=timeline)` 的倒序排序被 1e3 倍放大
|
|
275
|
+
顶到最前,摄取节点**永久占据头部**(auto-recall 取到的「最新 N 条」全是它们);
|
|
276
|
+
同一根因还让 S2 时间门控把秒节点的区间判成不相交而误剔除。
|
|
277
|
+
|
|
278
|
+
口径(不猜测):有限数值 `>= _MS_EPOCH_THRESHOLD` → `/1000.0`;其余原样 float。
|
|
279
|
+
NaN / Infinity / 超出 float 范围的数值返回 None,不得遮蔽合法别名。
|
|
280
|
+
于是「已落库的历史毫秒数据」**无需改盘**即可参与排序与区间比较
|
|
281
|
+
(读取侧归一,零迁移)。
|
|
282
|
+
|
|
283
|
+
不适用条件:日期/日期时间**字符串**(走 `parse_time`);`spatial.bbox` 等
|
|
284
|
+
非时间的数值;全时窗哨兵判定(`nodefile.is_full_time_window` 按「两侧极值
|
|
285
|
+
恰好覆盖」判,不做单位换算)。
|
|
286
|
+
"""
|
|
287
|
+
if not isinstance(value, (int, float)):
|
|
288
|
+
return None
|
|
289
|
+
try:
|
|
290
|
+
v = float(value)
|
|
291
|
+
except (ValueError, OverflowError):
|
|
292
|
+
return None
|
|
293
|
+
if not _allow_nonfinite and not math.isfinite(v):
|
|
294
|
+
return None
|
|
295
|
+
return v / 1000.0 if v >= _MS_EPOCH_THRESHOLD else v
|
|
296
|
+
|
|
297
|
+
|
|
298
|
+
def parse_time(value, *, _allow_nonfinite=False):
|
|
299
|
+
"""时间值 → epoch 秒;不可解析返回 None(**不猜测**)。
|
|
300
|
+
|
|
301
|
+
接受:数字(epoch 秒;**毫秒自动归一**,见 `epoch_seconds`)/ 数字串
|
|
302
|
+
(同左)/ 日期或日期时间字符串(ISO 8601,宽松:空格分隔、`Z` 后缀、
|
|
303
|
+
日期精度都容忍)。显式 Z / UTC offset 按绝对时刻解析;无时区日期保留
|
|
304
|
+
既有本地时间语义。纯标准库实现。
|
|
305
|
+
|
|
306
|
+
单位归一单点落在此处:它是全系统时间数值的**唯一读入口**
|
|
307
|
+
(时间算子 / `validity` / `provenance` 边 / 效力轴端点 / `stg._interval`),
|
|
308
|
+
故历史毫秒数据在**所有**读取面上一次生效,不再逐调用点打补丁。
|
|
309
|
+
"""
|
|
310
|
+
if value is None or value == "":
|
|
311
|
+
return None
|
|
312
|
+
if isinstance(value, (int, float)):
|
|
313
|
+
return epoch_seconds(value, _allow_nonfinite=_allow_nonfinite)
|
|
314
|
+
s = str(value).strip()
|
|
315
|
+
if not s:
|
|
316
|
+
return None
|
|
317
|
+
try:
|
|
318
|
+
return epoch_seconds(float(s), _allow_nonfinite=_allow_nonfinite)
|
|
319
|
+
except ValueError:
|
|
320
|
+
pass
|
|
321
|
+
# Explicit offsets denote an instant, independent of the host timezone.
|
|
322
|
+
# Naive dates below deliberately retain the existing local-time contract.
|
|
323
|
+
t = s.replace("/", "-")
|
|
324
|
+
try:
|
|
325
|
+
aware = datetime.fromisoformat(t)
|
|
326
|
+
if aware.tzinfo is not None:
|
|
327
|
+
ts = aware.timestamp()
|
|
328
|
+
return ts if math.isfinite(ts) else None
|
|
329
|
+
except (ValueError, OverflowError, OSError):
|
|
330
|
+
pass
|
|
331
|
+
t = t.replace("T", " ")
|
|
332
|
+
fmts = ("%Y-%m-%d %H:%M:%S", "%Y-%m-%d %H:%M", "%Y-%m-%d")
|
|
333
|
+
for f in fmts:
|
|
334
|
+
try:
|
|
335
|
+
return time.mktime(time.strptime(t, f))
|
|
336
|
+
except ValueError:
|
|
337
|
+
continue
|
|
338
|
+
return None
|
|
339
|
+
|
|
340
|
+
|
|
341
|
+
def first_endpoint(fm, keys):
|
|
342
|
+
"""按 `keys` 优先级取首个**可解析**端点 → `(epoch, key)`;全链无值 → `(None, None)`。
|
|
343
|
+
|
|
344
|
+
单点定义「规范键优先、别名回落」的取值口径:某键**存在但不可解析**时继续回落
|
|
345
|
+
(而非按 None 定案)——「写坏了的时间值」不得遮蔽同族另一个合法键。
|
|
346
|
+
"""
|
|
347
|
+
if not isinstance(fm, dict):
|
|
348
|
+
return None, None
|
|
349
|
+
for k in keys:
|
|
350
|
+
if k in fm:
|
|
351
|
+
ts = parse_time(fm.get(k))
|
|
352
|
+
if ts is not None:
|
|
353
|
+
return ts, k
|
|
354
|
+
return None, None
|
|
355
|
+
|
|
356
|
+
|
|
357
|
+
def validity(fm, now: float = None):
|
|
358
|
+
"""双时间轴判定 → `(kind, start, end)`。
|
|
359
|
+
|
|
360
|
+
kind ∈ `unknown`(无时间轴约束)/ `not_yet`(未生效)/ `active`(生效中)/
|
|
361
|
+
`expired`(已过期)。任一端点不可解析 → 该端点按 None 处理(不猜测、不误判)。
|
|
362
|
+
|
|
363
|
+
端点取值(2026-09-19 阶段一):**规范键优先、别名回落**——
|
|
364
|
+
起点 `effective_from` > `valid_from` > `valid_since` > `starts_at`;
|
|
365
|
+
终点 `effective_until` > `valid_until` > `expires_at` > `expire_at` > `expiry` > `deadline`。
|
|
366
|
+
`believed_at`(信念时间)**不参与**本判定:它是「体系何时确认此条」(取代/审核的锚),
|
|
367
|
+
不是效力端点——并入任一方向都会把「已确认」误判成「已生效/已失效」。
|
|
368
|
+
"""
|
|
369
|
+
if not isinstance(fm, dict):
|
|
370
|
+
return "unknown", None, None
|
|
371
|
+
start, _sk = first_endpoint(fm, FROM_ALIASES)
|
|
372
|
+
end, _ek = first_endpoint(fm, UNTIL_ALIASES)
|
|
373
|
+
if start is None and end is None:
|
|
374
|
+
return "unknown", None, None
|
|
375
|
+
t = time.time() if now is None else float(now)
|
|
376
|
+
if start is not None and t < start:
|
|
377
|
+
return "not_yet", start, end
|
|
378
|
+
if end is not None and t > end:
|
|
379
|
+
return "expired", start, end
|
|
380
|
+
return "active", start, end
|
|
381
|
+
|
|
382
|
+
|
|
383
|
+
def believed_at(fm) -> float:
|
|
384
|
+
"""信念时间(体系**何时确认此条**)→ epoch 秒;缺字段/不可解析 → None(不猜测)。
|
|
385
|
+
|
|
386
|
+
用途:取代(supersede)/ 审核的排序锚——「谁更晚被确认」是判定新旧的正路;
|
|
387
|
+
**不得**拿 `valid_from`/`valid_until` 代替(那是事实在任务世界里何时有效,
|
|
388
|
+
与体系何时知道它无关)。
|
|
389
|
+
"""
|
|
390
|
+
if not isinstance(fm, dict):
|
|
391
|
+
return None
|
|
392
|
+
return parse_time(fm.get(BELIEVED_FIELD))
|
|
393
|
+
|
|
394
|
+
|
|
395
|
+
def is_expired(fm, now: float = None) -> bool:
|
|
396
|
+
"""`validity` 的布尔快捷:是否「**已过期**」。
|
|
397
|
+
|
|
398
|
+
只判 `expired`——`not_yet`(尚未生效)**不算**:两者语义相反
|
|
399
|
+
(见 `scrub._NOT_YET_KEYS` 纪律「`valid_from` 绝不并入 `_EXPIRY_KEYS`」),
|
|
400
|
+
「尚未开始」不等于「已失效」。无时间轴 / 端点不可解析 → False(不猜测、不误杀)。
|
|
401
|
+
"""
|
|
402
|
+
return validity(fm, now=now)[0] == "expired"
|
|
403
|
+
|
|
404
|
+
|
|
405
|
+
def time_window_msg(fm, now: float = None) -> str:
|
|
406
|
+
"""时效判定的一句话(空串表示无时间轴约束)。**点名实际命中的键**(含别名)。"""
|
|
407
|
+
kind, start, end = validity(fm, now=now)
|
|
408
|
+
if kind == "unknown":
|
|
409
|
+
return ""
|
|
410
|
+
if kind == "not_yet":
|
|
411
|
+
_ts, k = first_endpoint(fm, FROM_ALIASES)
|
|
412
|
+
return f"未生效({k or FROM_FIELD} 未到)"
|
|
413
|
+
if kind == "expired":
|
|
414
|
+
_ts, k = first_endpoint(fm, UNTIL_ALIASES)
|
|
415
|
+
return f"已过期({k or UNTIL_FIELD} 已过)"
|
|
416
|
+
return "时效内"
|
|
417
|
+
|
|
418
|
+
|
|
419
|
+
# ---------------------------------------------------------------- 时间算子(阶段二 4.1)
|
|
420
|
+
|
|
421
|
+
#: 时间轴(**封闭枚举**)。两条轴物理隔离、语义不可互换(同 `believed_at` 的隔离纪律):
|
|
422
|
+
#: effective 效力轴——这条事实**何时开始/不再成立**(`effective_from/until` 及别名)
|
|
423
|
+
#: observed 观察轴——这条记忆**何时被观测/事件何时发生**(`temporal` / `time_window`)
|
|
424
|
+
#: 不设**隐式**默认轴:入口在「启用时间算子但未指定轴」时回落 `effective`
|
|
425
|
+
#: (与既有 `validity=` 语义连续),但轴本身永远由调用方显式决定。
|
|
426
|
+
TIME_AXES = ("effective", "observed")
|
|
427
|
+
|
|
428
|
+
#: 时间算子(**封闭枚举**,拒收未知名):候选轴端点 与 查询端点 的比较关系。
|
|
429
|
+
#: 缺省(不给 operator)= **区间重叠**语义,见 `window_match`。
|
|
430
|
+
TIME_OPERATORS = ("gt", "gte", "eq", "lte", "lt")
|
|
431
|
+
|
|
432
|
+
#: 观察轴字段名(与 `stg._interval` 同源口径,**不新增第二套解析**)。
|
|
433
|
+
OBSERVED_TIME_FIELD = "temporal"
|
|
434
|
+
OBSERVED_WINDOW_FIELD = "time_window"
|
|
435
|
+
|
|
436
|
+
|
|
437
|
+
def time_axis_of(axis) -> str:
|
|
438
|
+
"""轴名归一 → `"effective"` / `"observed"`;`None` → `"effective"`;
|
|
439
|
+
其余(含 `"believed"`)→ `ValueError`(**fail-closed,不静默降级**)。
|
|
440
|
+
|
|
441
|
+
与 `_stg_call`「不做签名推导——猜错会静默返回错误视图,比报错更贵」同风格:
|
|
442
|
+
轴写错时必须报错,因为静默按另一条轴过滤会产出**无法复算**的结果集。
|
|
443
|
+
"""
|
|
444
|
+
if axis is None:
|
|
445
|
+
return "effective"
|
|
446
|
+
a = str(axis).strip().lower()
|
|
447
|
+
if a in TIME_AXES:
|
|
448
|
+
return a
|
|
449
|
+
raise ValueError(f"未知 time_axis {axis!r}(允许:{TIME_AXES})")
|
|
450
|
+
|
|
451
|
+
|
|
452
|
+
def time_window_of(fm, axis: str = "effective", *, _allow_nonfinite=False):
|
|
453
|
+
"""按轴取候选时间窗口 → `(start, end)`;不可判定 → `(None, None)`(不猜测)。
|
|
454
|
+
|
|
455
|
+
· `effective`:效力轴,走 `first_endpoint(FROM_ALIASES/UNTIL_ALIASES)`
|
|
456
|
+
(规范键优先、别名回落,与 `validity` **同源**);
|
|
457
|
+
缺字段/不可解析 → 该侧 `None`(= 无界,与 `validity` 的「不误判」口径一致)。
|
|
458
|
+
· `observed`:观察轴,与 `stg._interval` **同源口径**——`temporal`(事件时刻)优先,
|
|
459
|
+
缺失才回退 `condition_space.time_window`(观测窗);任一端不可解析 → `(None, None)`
|
|
460
|
+
(与 `_interval` 的「整体不可用」语义一致)。
|
|
461
|
+
|
|
462
|
+
`believed_at` **永不参与**(`BELIEVED_FIELD` 不出现于任何轴)。
|
|
463
|
+
内部 `_allow_nonfinite=True` 仅供派生 STG 索引维持异常时间的保守候选桶;
|
|
464
|
+
查询入参、效力轴别名与正常消费者均使用有限端点规则。
|
|
465
|
+
"""
|
|
466
|
+
if not isinstance(fm, dict):
|
|
467
|
+
return None, None
|
|
468
|
+
if time_axis_of(axis) == "observed":
|
|
469
|
+
t = fm.get(OBSERVED_TIME_FIELD)
|
|
470
|
+
if t is not None:
|
|
471
|
+
ts = parse_time(t, _allow_nonfinite=_allow_nonfinite)
|
|
472
|
+
if ts is not None:
|
|
473
|
+
return ts, ts
|
|
474
|
+
# 兼容两种载体形态:**fm**(`condition_space.time_window`)与**索引扁平快照**
|
|
475
|
+
# (`time_window` 平铺在 entry 上,见 `mdcg._scan_nodes`/`_stage`)。
|
|
476
|
+
# 只读嵌套会让「按 entry 过滤」的路径永不命中(同类坑:S2 时间门控,
|
|
477
|
+
# mdcg.py L639 已记「直接读 cs 会让门控永不生效」)。
|
|
478
|
+
cs = fm.get("condition_space") or {}
|
|
479
|
+
tw = fm.get(OBSERVED_WINDOW_FIELD)
|
|
480
|
+
if tw is None and isinstance(cs, dict):
|
|
481
|
+
tw = cs.get(OBSERVED_WINDOW_FIELD)
|
|
482
|
+
if isinstance(tw, (list, tuple)) and len(tw) == 2:
|
|
483
|
+
s, e = (parse_time(v, _allow_nonfinite=_allow_nonfinite) for v in tw)
|
|
484
|
+
if s is None or e is None:
|
|
485
|
+
return None, None
|
|
486
|
+
return s, e
|
|
487
|
+
return None, None
|
|
488
|
+
start, _sk = first_endpoint(fm, FROM_ALIASES)
|
|
489
|
+
end, _ek = first_endpoint(fm, UNTIL_ALIASES)
|
|
490
|
+
return start, end
|
|
491
|
+
|
|
492
|
+
|
|
493
|
+
def _op_ok(cand, q, op) -> bool:
|
|
494
|
+
"""单个端点比较;任一端不可解析 → False(缺字段的处置归**轴策略**,此处不猜测)。"""
|
|
495
|
+
if cand is None or q is None:
|
|
496
|
+
return False
|
|
497
|
+
if op == "gt":
|
|
498
|
+
return cand > q
|
|
499
|
+
if op == "gte":
|
|
500
|
+
return cand >= q
|
|
501
|
+
if op == "eq":
|
|
502
|
+
return cand == q
|
|
503
|
+
if op == "lte":
|
|
504
|
+
return cand <= q
|
|
505
|
+
if op == "lt":
|
|
506
|
+
return cand < q
|
|
507
|
+
return False # 未知算子:入口已 fail-closed,此处保守拒
|
|
508
|
+
|
|
509
|
+
|
|
510
|
+
def window_match(cand_start, cand_end, q_start=None, q_end=None,
|
|
511
|
+
start_op: str = None, end_op: str = None) -> bool:
|
|
512
|
+
"""候选窗口与查询窗口是否匹配(§1.2 B1/B2 的**唯一实现点**,纯函数)。
|
|
513
|
+
|
|
514
|
+
两种模式由「是否给 operator」**显式分叉**(不允许隐式混用——混用会产出
|
|
515
|
+
「无法复算」的过滤,违反白箱):
|
|
516
|
+
|
|
517
|
+
· **重叠模式**(`start_op`/`end_op` 均为 `None`):候选窗口与查询窗口有交集
|
|
518
|
+
即命中(记忆窗口是**区间**不是点)。查询端点缺省 = 该侧**无界**(不隐含 now)。
|
|
519
|
+
· **端点模式**(至少给一个 operator):对**显式启用的侧**做 `op(cand端, q端)`;
|
|
520
|
+
一侧未给 operator 但**给了该侧查询端点**时,用 B1 缺省(起点 `gte` / 终点 `lte`);
|
|
521
|
+
该侧查询端点也没有 → **不约束该侧**。
|
|
522
|
+
|
|
523
|
+
「未给 operator 且未给查询端点 → 不约束」是刻意的:若一律回落到 B1 缺省再比较,
|
|
524
|
+
`_op_ok(cand, None, op)` 恒伪,于是 `start_operator="gte" + start_time=T`
|
|
525
|
+
(单端算子,合法调用)会静默返回**空集**——把「只筛起点」误答成「没有匹配」。
|
|
526
|
+
端点模式下候选的该侧端点不可解析 → `False`(该侧无法比较,不猜)。
|
|
527
|
+
|
|
528
|
+
候选窗口两端皆不可解析 → `False`(该节点「无时间轴可判」)——是否因此剔除
|
|
529
|
+
由**轴的策略**决定(效力轴 fail-open / 观察轴 fail-closed,见候选过滤处)。
|
|
530
|
+
"""
|
|
531
|
+
cs, ce = parse_time(cand_start), parse_time(cand_end)
|
|
532
|
+
if cs is None and ce is None:
|
|
533
|
+
return False
|
|
534
|
+
qs, qe = parse_time(q_start), parse_time(q_end)
|
|
535
|
+
if start_op is None and end_op is None:
|
|
536
|
+
if qs is not None and ce is not None and ce < qs:
|
|
537
|
+
return False
|
|
538
|
+
if qe is not None and cs is not None and cs > qe:
|
|
539
|
+
return False
|
|
540
|
+
return True
|
|
541
|
+
if start_op is not None or qs is not None:
|
|
542
|
+
if not _op_ok(cs, qs, start_op or "gte"):
|
|
543
|
+
return False
|
|
544
|
+
if end_op is not None or qe is not None:
|
|
545
|
+
if not _op_ok(ce, qe, end_op or "lte"):
|
|
546
|
+
return False
|
|
547
|
+
return True
|
|
548
|
+
|
|
549
|
+
|
|
550
|
+
def check_time_args(start_time=None, end_time=None, start_operator=None,
|
|
551
|
+
end_operator=None, time_axis=None):
|
|
552
|
+
"""时间算子入参 fail-closed 校验 → `(enabled, axis, why)`。
|
|
553
|
+
|
|
554
|
+
**入口(`mdcg.search` / `entity_contexts`)与库层共用的唯一校验点**
|
|
555
|
+
(避免两处各写一套、口径漂移)。三则误用一律拒(`why` 非空即应抛
|
|
556
|
+
`ValueError`,不静默忽略——与 `_stg_call` 同风格):
|
|
557
|
+
|
|
558
|
+
1. 只给 operator 而不给对应的 `start_time`/`end_time`;
|
|
559
|
+
2. `time_axis` 非 `{"effective","observed"}`(含 `"believed"`);
|
|
560
|
+
3. `start_time > end_time`。
|
|
561
|
+
|
|
562
|
+
未启用(五参全 `None`)→ `(False, None, "")`(默认路径零变更)。
|
|
563
|
+
"""
|
|
564
|
+
if time_axis is not None and str(time_axis).strip().lower() not in TIME_AXES:
|
|
565
|
+
return False, None, (f"未知 time_axis {time_axis!r}(允许:{TIME_AXES})——"
|
|
566
|
+
"轴必须显式且合法,静默按另一条轴过滤会产出无法复算的结果")
|
|
567
|
+
for op, val, nm in ((start_operator, start_time, "start_operator/start_time"),
|
|
568
|
+
(end_operator, end_time, "end_operator/end_time")):
|
|
569
|
+
if op is None:
|
|
570
|
+
continue
|
|
571
|
+
if str(op).strip().lower() not in TIME_OPERATORS:
|
|
572
|
+
return False, None, (f"未知算子 {op!r}(允许:{TIME_OPERATORS})")
|
|
573
|
+
if val is None:
|
|
574
|
+
return False, None, f"给了 {nm.split('/')[0]} 但缺 {nm.split('/')[1]}(不猜默认值)"
|
|
575
|
+
s, e = parse_time(start_time), parse_time(end_time)
|
|
576
|
+
if start_time is not None and s is None:
|
|
577
|
+
return False, None, f"start_time 不可解析:{start_time!r}"
|
|
578
|
+
if end_time is not None and e is None:
|
|
579
|
+
return False, None, f"end_time 不可解析:{end_time!r}"
|
|
580
|
+
if s is not None and e is not None and s > e:
|
|
581
|
+
return False, None, f"start_time({s}) > end_time({e}):空窗口,拒绝"
|
|
582
|
+
enabled = any(x is not None for x in (start_time, end_time,
|
|
583
|
+
start_operator, end_operator))
|
|
584
|
+
if not enabled:
|
|
585
|
+
return False, None, ""
|
|
586
|
+
return True, time_axis_of(time_axis), ""
|
|
587
|
+
|
|
588
|
+
|
|
589
|
+
def window_matches_node(fm, axis, q_start, q_end, start_op=None, end_op=None):
|
|
590
|
+
"""候选节点按轴取窗后做 `window_match` → `(matched, missing)`。
|
|
591
|
+
|
|
592
|
+
`missing=True` 表示该节点在**该轴上不可判定**(窗口两端皆 `None`)——
|
|
593
|
+
调用方据此执行轴策略:效力轴 fail-open(保留)、观察轴 fail-closed
|
|
594
|
+
(剔除并计入 `axis_missing`)。策略按**保证强度**定,不按「一致好看」定:
|
|
595
|
+
效力轴字段是可选声明,观察轴字段由写入侧保证存在。
|
|
596
|
+
"""
|
|
597
|
+
cs, ce = time_window_of(fm, axis)
|
|
598
|
+
if cs is None and ce is None:
|
|
599
|
+
return False, True
|
|
600
|
+
return window_match(cs, ce, q_start, q_end, start_op, end_op), False
|
|
601
|
+
|
|
602
|
+
|
|
603
|
+
def time_filter_meta(axis=None, mode="overlap", start=None, end=None,
|
|
604
|
+
start_operator=None, end_operator=None, dropped=0,
|
|
605
|
+
axis_missing=0, applied=False) -> dict:
|
|
606
|
+
"""`meta["time_filter"]` 审计块(**五键齐备**,可复算):
|
|
607
|
+
|
|
608
|
+
`dropped + 存活数 == 候选数` 由调用方保证;`axis_missing` 单独记账,
|
|
609
|
+
使「观察轴缺字段被剔除」的条数可查(静默放行会把数据异常藏起来)。
|
|
610
|
+
"""
|
|
611
|
+
return {"axis": axis, "mode": mode, "start": start, "end": end,
|
|
612
|
+
"start_operator": start_operator, "end_operator": end_operator,
|
|
613
|
+
"dropped": int(dropped), "axis_missing": int(axis_missing),
|
|
614
|
+
"applied": bool(applied)}
|
|
615
|
+
|
|
616
|
+
|
|
617
|
+
def filter_by_time(entries, axis, q_start, q_end, start_op=None, end_op=None):
|
|
618
|
+
"""按轴过滤候选 → `(kept, dropped, axis_missing)`。**候选层唯一过滤点**。
|
|
619
|
+
|
|
620
|
+
轴策略按**字段保证强度**定(不按「行为一致好看」定):
|
|
621
|
+
· `effective` 效力轴:`effective_from/until` 是**可选声明**(多数节点没有)
|
|
622
|
+
→ 不可判定一律 fail-open(保留)——否则「没写时效 = 被过滤掉」,
|
|
623
|
+
会把沉默当否认;
|
|
624
|
+
· `observed` 观察轴:`temporal` / `time_window` 由**写入侧保证**存在
|
|
625
|
+
(add 缺省填观测窗)→ 不可判定一律 fail-closed(剔除并计入
|
|
626
|
+
`axis_missing`,使数据异常可查而非静默放行)。
|
|
627
|
+
"""
|
|
628
|
+
kept, dropped, missing = [], 0, 0
|
|
629
|
+
for e in entries:
|
|
630
|
+
m, miss = window_matches_node(e, axis, q_start, q_end, start_op, end_op)
|
|
631
|
+
if miss:
|
|
632
|
+
if axis == "observed":
|
|
633
|
+
dropped += 1
|
|
634
|
+
missing += 1
|
|
635
|
+
else:
|
|
636
|
+
kept.append(e)
|
|
637
|
+
continue
|
|
638
|
+
if m:
|
|
639
|
+
kept.append(e)
|
|
640
|
+
else:
|
|
641
|
+
dropped += 1
|
|
642
|
+
return kept, dropped, missing
|
|
643
|
+
|
|
644
|
+
|
|
645
|
+
# ---------------------------------------------------------------- 依赖声明
|
|
646
|
+
|
|
647
|
+
def as_deps(value) -> list:
|
|
648
|
+
"""把单值 / 序列 / 逗号串统一成**去重、排序**的节点 id 列表(上限 MAX_DEPS)。
|
|
649
|
+
|
|
650
|
+
容错口径(写路径的入参形态不由本模块决定,收窄会误伤):
|
|
651
|
+
· `None` / 空串 / 纯空白项 → 丢弃(不是目标,也不是「声明了依赖」);
|
|
652
|
+
· 半角/全角逗号串 → 切分(`"a, b"` 与 `["a", "b"]` 等价);
|
|
653
|
+
· 排序的动机:依赖是**集合语义**(声明顺序不承载信息),排序让 fm 与
|
|
654
|
+
索引快照对同一组依赖恒等——比较/去重/审计不再依赖声明顺序。
|
|
655
|
+
"""
|
|
656
|
+
if value is None:
|
|
657
|
+
return []
|
|
658
|
+
items = list(value) if isinstance(value, (list, tuple, set)) else [value]
|
|
659
|
+
out = []
|
|
660
|
+
for x in items:
|
|
661
|
+
if x is None:
|
|
662
|
+
continue
|
|
663
|
+
for s in str(x).replace(",", ",").split(","):
|
|
664
|
+
s = s.strip()
|
|
665
|
+
if s and s not in out:
|
|
666
|
+
out.append(s)
|
|
667
|
+
out.sort()
|
|
668
|
+
return out[:MAX_DEPS]
|
|
669
|
+
|
|
670
|
+
|
|
671
|
+
def deps_of(cg, nid: str) -> list:
|
|
672
|
+
"""读某节点声明的依赖(**零读文件**:索引快照缺失才回读节点)。"""
|
|
673
|
+
e = ((getattr(cg, "index", None) or {}).get("nodes") or {}).get(nid) or {}
|
|
674
|
+
deps = as_deps(e.get(DEPS_FIELD))
|
|
675
|
+
if deps:
|
|
676
|
+
return deps
|
|
677
|
+
node = cg.get(nid)
|
|
678
|
+
if not node:
|
|
679
|
+
return []
|
|
680
|
+
return as_deps((node.get("frontmatter") or {}).get(DEPS_FIELD))
|
|
681
|
+
|
|
682
|
+
|
|
683
|
+
def invalidate_cache(cg) -> None:
|
|
684
|
+
"""作废反查缓存(写/删节点后调用;下次读时增量重建)。"""
|
|
685
|
+
try:
|
|
686
|
+
cg.__dict__.pop("_trust_dependents", None)
|
|
687
|
+
except Exception: # noqa: BLE001
|
|
688
|
+
pass
|
|
689
|
+
|
|
690
|
+
|
|
691
|
+
def dependents_index(cg, refresh: bool = False) -> dict:
|
|
692
|
+
"""反查索引:`{被依赖节点: [依赖它的节点…]}`(「谁依赖我」)。
|
|
693
|
+
|
|
694
|
+
缓存挂在 cg 实例上(与 `subgraph` 的缓存化做法同构);`refresh=True` 强制重建。
|
|
695
|
+
"""
|
|
696
|
+
generation = getattr(cg, "_cache_generation", None)
|
|
697
|
+
generation = generation() if callable(generation) else None
|
|
698
|
+
if not refresh and getattr(cg, "_trust_generation", None) == generation:
|
|
699
|
+
cached = getattr(cg, "_trust_dependents", None)
|
|
700
|
+
if isinstance(cached, dict):
|
|
701
|
+
return cached
|
|
702
|
+
nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
|
|
703
|
+
idx = {}
|
|
704
|
+
for nid, e in list(nodes.items()):
|
|
705
|
+
for p in as_deps((e or {}).get(DEPS_FIELD)):
|
|
706
|
+
idx.setdefault(p, []).append(nid)
|
|
707
|
+
for k in idx:
|
|
708
|
+
idx[k].sort()
|
|
709
|
+
try:
|
|
710
|
+
cg._trust_dependents = idx
|
|
711
|
+
cg._trust_generation = generation
|
|
712
|
+
except Exception: # noqa: BLE001
|
|
713
|
+
pass
|
|
714
|
+
return idx
|
|
715
|
+
|
|
716
|
+
|
|
717
|
+
def _record(cg, rec: dict) -> None:
|
|
718
|
+
"""台账追加(best-effort:失败静默,**绝不阻断写路径**)。"""
|
|
719
|
+
try:
|
|
720
|
+
# issue #547:本模块的审计台账(`_trust.jsonl`)此前声明「失败静默」;按 #549
|
|
721
|
+
# 对审计账本的口径(不能丢 ⇒ durable=True)统一,丢行不再静默。
|
|
722
|
+
append_jsonl(os.path.join(cg.root, AUDIT_FILE), rec, durable=True)
|
|
723
|
+
except Exception: # noqa: BLE001
|
|
724
|
+
pass
|
|
725
|
+
|
|
726
|
+
|
|
727
|
+
# ---------------------------------------------------------------- 推进
|
|
728
|
+
|
|
729
|
+
def _sync_index(cg, node_id, fm) -> None:
|
|
730
|
+
"""把验证态同步进索引快照(免读文件可查);无索引实现时静默跳过。"""
|
|
731
|
+
idx = getattr(cg, "index", None)
|
|
732
|
+
if not isinstance(idx, dict):
|
|
733
|
+
return
|
|
734
|
+
e = (idx.get("nodes") or {}).get(node_id)
|
|
735
|
+
if e is None:
|
|
736
|
+
return
|
|
737
|
+
e[STATE_FIELD] = fm.get(STATE_FIELD)
|
|
738
|
+
dirty = getattr(cg, "_dirty", None)
|
|
739
|
+
if isinstance(dirty, dict):
|
|
740
|
+
dirty[node_id] = e
|
|
741
|
+
flush = getattr(cg, "flush", None)
|
|
742
|
+
if callable(flush):
|
|
743
|
+
flush()
|
|
744
|
+
|
|
745
|
+
|
|
746
|
+
# 生效条件:cg.get(node_id) 为假值(节点不存在)时返回 {"ok": False, "error": "node_not_found", "node_id": node_id};否则先过层写闸 protect.require_layer(cg, node_id, layer=fm.layer, sensitivity=fm.sensitivity)(N209:越权身份抛 AccessDenied → 转成 {"ok": False, "error": "layer_denied", "changed": False} 负路由,记 set_state_denied 台账,**不写盘**),再经 stamp 裁决:code 为 noop 或非法迁移时返回 ok=False 或 changed=False 不写盘,成功时把 fm 经 cg._write_node 落盘、_sync_index 同步验证态快照、_record 追加台账,fm 含 depends_on 时再 invalidate_cache,返回 {node_id, from, to, code, ok, changed, reason, at}。
|
|
747
|
+
def set_state(cg, node_id: str, dst: str, reason: str = None, actor: str = None,
|
|
748
|
+
evidence: str = None, method: str = None, trigger: str = None,
|
|
749
|
+
override: bool = False) -> dict:
|
|
750
|
+
"""推进一个节点的验证态(**唯一推进入口**)。
|
|
751
|
+
|
|
752
|
+
非法迁移不走异常而是返回 `{"ok": False, "error": <code>, ...}`(负路由)。
|
|
753
|
+
幂等迁移返回 `changed=False` 且不写盘。**写盘前另过 principal 层写闸**
|
|
754
|
+
(N209:无权写该层 → `error="layer_denied"` 负路由,零写盘 + 台账留痕)。
|
|
755
|
+
"""
|
|
756
|
+
node = cg.get(node_id)
|
|
757
|
+
if not node:
|
|
758
|
+
return {"ok": False, "error": "node_not_found", "node_id": node_id}
|
|
759
|
+
fm = dict(node.get("frontmatter") or {})
|
|
760
|
+
src = state_of(fm)
|
|
761
|
+
# N209(同族未接线的相邻写面):验证态推进 = 对节点本体 frontmatter 的一次
|
|
762
|
+
# **覆写**(`cg._write_node` 全量重写 fm + 正文),与 add / 覆写写面同一层闸。
|
|
763
|
+
# 此前该路径零层闸(MdCGSecure 对 set_state/set_verification/mark_dependents
|
|
764
|
+
# 无任何覆盖)⇒ 持 verify 令牌者经 verify→mark_dependents → 把**任意层**
|
|
765
|
+
# 依赖者(实测 self 层)置 doubted。拒绝走**负路由**而非 raise:本函数契约是
|
|
766
|
+
# 「非法迁移不抛异常(ok=False + 机器码)」,且 mark_dependents 契约是
|
|
767
|
+
# 「永不抛、不阻断本次裁决」——但**绝不写盘**,并把拒绝记进 `_trust.jsonl`
|
|
768
|
+
#(不静默:与 `mark_dependents_degraded` 同一「留痕降级」口径)。
|
|
769
|
+
try:
|
|
770
|
+
protect.require_layer(cg, node_id, layer=fm.get("layer"),
|
|
771
|
+
sensitivity=fm.get("sensitivity"))
|
|
772
|
+
except AccessDenied as exc:
|
|
773
|
+
_record(cg, {"t": time.time(), "action": "set_state_denied",
|
|
774
|
+
"node_id": node_id, "from": src, "to": dst,
|
|
775
|
+
"error": f"{type(exc).__name__}: {exc}",
|
|
776
|
+
"actor": actor, "trigger": trigger})
|
|
777
|
+
return {"node_id": node_id, "from": src, "to": dst, "ok": False,
|
|
778
|
+
"error": "layer_denied", "reason": str(exc), "changed": False}
|
|
779
|
+
ok, code, why = stamp(fm, dst, reason=reason, actor=actor, evidence=evidence,
|
|
780
|
+
method=method, trigger=trigger, override=override)
|
|
781
|
+
base = {"node_id": node_id, "from": src, "to": dst, "code": code}
|
|
782
|
+
if not ok:
|
|
783
|
+
return {**base, "ok": False, "error": code, "reason": why}
|
|
784
|
+
if code == "noop":
|
|
785
|
+
return {**base, "ok": True, "changed": False, "reason": why}
|
|
786
|
+
at = fm[HISTORY_FIELD][-1]["at"]
|
|
787
|
+
cg._write_node(node_id, os.path.join(cg.root, node["path"]), fm,
|
|
788
|
+
node.get("content") or "")
|
|
789
|
+
_sync_index(cg, node_id, fm)
|
|
790
|
+
_record(cg, {"t": at, "action": "set_state", "node_id": node_id,
|
|
791
|
+
"from": src, "to": dst, "reason": reason, "actor": actor,
|
|
792
|
+
"method": method, "trigger": trigger, "override": bool(override)})
|
|
793
|
+
if fm.get(DEPS_FIELD):
|
|
794
|
+
invalidate_cache(cg)
|
|
795
|
+
return {**base, "ok": True, "changed": True, "reason": why, "at": at}
|
|
796
|
+
|
|
797
|
+
|
|
798
|
+
# ---------------------------------------------------------------- 失效传播
|
|
799
|
+
|
|
800
|
+
def mark_dependents(cg, node_id: str, reason: str = None, *, apply: bool = True,
|
|
801
|
+
actor: str = "system", trigger: str = None,
|
|
802
|
+
depth: int = 1, override: bool = False) -> dict:
|
|
803
|
+
"""**一跳同步传播**:把直接下游标为 `doubted`(异常的新定义)。
|
|
804
|
+
|
|
805
|
+
根因口径:异常不再仅是「内容错」,而是「**它所依赖的地基动了**」——被依赖
|
|
806
|
+
单元被修改/证伪时,直接下游立刻产生存疑标记,无需等全库巡检。
|
|
807
|
+
|
|
808
|
+
**永不抛**(对齐 provenance G8 纪律:传播失败不得阻断写入)。`apply=False`
|
|
809
|
+
只预演;同状态下游是 no-op(幂等,不写盘、不留痕)。
|
|
810
|
+
"""
|
|
811
|
+
try:
|
|
812
|
+
dep_map = dependents_index(cg)
|
|
813
|
+
kids = list(dep_map.get(node_id, []))
|
|
814
|
+
kids.sort()
|
|
815
|
+
if not kids:
|
|
816
|
+
return {"ok": True, "changed": 0, "dependents": [], "apply": bool(apply),
|
|
817
|
+
"reason": "no_dependents"}
|
|
818
|
+
reason = reason or f"上游 {node_id} 变动"
|
|
819
|
+
planned = [k for k in kids
|
|
820
|
+
if state_of((cg.index or {}).get("nodes", {}).get(k) or {})
|
|
821
|
+
!= "doubted"]
|
|
822
|
+
if not apply:
|
|
823
|
+
return {"ok": True, "dry_run": True, "changed": 0,
|
|
824
|
+
"dependents": kids, "planned": len(planned)}
|
|
825
|
+
done, skipped = [], []
|
|
826
|
+
for k in kids:
|
|
827
|
+
r = set_state(cg, k, "doubted", reason=reason, actor=actor,
|
|
828
|
+
trigger=trigger or f"dep_changed:{node_id}",
|
|
829
|
+
override=override)
|
|
830
|
+
if r.get("ok") and r.get("changed"):
|
|
831
|
+
done.append(k)
|
|
832
|
+
elif r.get("ok"):
|
|
833
|
+
skipped.append(k) # 已是 doubted:幂等
|
|
834
|
+
else:
|
|
835
|
+
skipped.append(f"{k}({r.get('error')})")
|
|
836
|
+
return {"ok": True, "changed": len(done), "dependents": kids,
|
|
837
|
+
"updated": done, "skipped": skipped, "apply": True,
|
|
838
|
+
"reason": reason}
|
|
839
|
+
except Exception as exc: # noqa: BLE001
|
|
840
|
+
_record(cg, {"t": time.time(), "action": "mark_dependents_degraded",
|
|
841
|
+
"node_id": node_id, "error": f"{type(exc).__name__}: {exc}",
|
|
842
|
+
"actor": actor})
|
|
843
|
+
return {"ok": False, "degraded": True, "changed": 0,
|
|
844
|
+
"error": f"{type(exc).__name__}: {exc}"}
|
|
845
|
+
|
|
846
|
+
|
|
847
|
+
def propagate(cg, *, apply: bool = False, max_nodes: int = MAX_NODES_DEFAULT,
|
|
848
|
+
actor: str = "patrol") -> dict:
|
|
849
|
+
"""**多跳异步重算**(巡检面,不阻塞写入/查询)。
|
|
850
|
+
|
|
851
|
+
BFS 从所有 `expired` / `rechecking` / 显式根源节点出发,把可达下游标
|
|
852
|
+
`doubted`(**只降不升**:复核通过须由人显式 `set_state(verified)`)。
|
|
853
|
+
默认 `apply=False` 只出报表;`max_nodes` 封顶防大库爆炸。
|
|
854
|
+
|
|
855
|
+
`doubted` 中间节点的语义(2026-09-20 v14 缺陷 B 修复):**穿过,但不重复
|
|
856
|
+
标记**。已 doubted 说明它已被标记,无需再标(幂等);但它**不是传播终点**
|
|
857
|
+
——「地基动了」的波及范围必须继续往其下游走。旧实现把 doubted 直接
|
|
858
|
+
`continue`(当作终点),于是「先 `mark_dependents` 预演直接下游、再
|
|
859
|
+
`propagate` 正式传播」这一最常见序列会使多跳传播**整体失效**
|
|
860
|
+
(`reachable`/`updated` 全 0)且**无任何报错**。穿过的节点在
|
|
861
|
+
`passed_doubted` 中如实透出(可审计)。
|
|
862
|
+
|
|
863
|
+
**`reachable` / `updated` 的口径**(2026-09-20 v15-4 澄清,勿读成「波及集
|
|
864
|
+
大小」):两者计的是「本次**需要新标记**的节点数」——`apply=False` 时 =
|
|
865
|
+
计划标记数(`planned` 的长度),`apply=True` 时 = 实际标记成功数(`done` 的
|
|
866
|
+
长度)。**穿过的 `doubted` 中继不计入**(它早已被标记,本次幂等跳过)。故
|
|
867
|
+
「本次的完整波及集」= `reachable`(或 `updated`)+ `passed_doubted`,只读
|
|
868
|
+
前者会低估。`roots` 是传播起点(`expired`/`rechecking`),不属于波及集。
|
|
869
|
+
"""
|
|
870
|
+
nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
|
|
871
|
+
dep_map = dependents_index(cg)
|
|
872
|
+
roots = []
|
|
873
|
+
for nid, e in list(nodes.items()):
|
|
874
|
+
st = (e or {}).get(STATE_FIELD)
|
|
875
|
+
if st in ("expired", "rechecking"):
|
|
876
|
+
roots.append(nid)
|
|
877
|
+
roots.sort()
|
|
878
|
+
cap = max(0, int(max_nodes))
|
|
879
|
+
admitted_roots = roots[:cap]
|
|
880
|
+
seen, waves, passed = set(admitted_roots), [], set()
|
|
881
|
+
root_set = set(roots)
|
|
882
|
+
frontier, depth = list(admitted_roots), 0
|
|
883
|
+
truncated = len(admitted_roots) < len(roots)
|
|
884
|
+
while frontier and len(seen) < cap:
|
|
885
|
+
depth += 1
|
|
886
|
+
nxt = []
|
|
887
|
+
for nid in frontier:
|
|
888
|
+
for k in dep_map.get(nid, []):
|
|
889
|
+
if k in seen or k in root_set:
|
|
890
|
+
continue
|
|
891
|
+
# The cap applies across the whole wave, not once per parent.
|
|
892
|
+
if len(seen) >= cap:
|
|
893
|
+
truncated = True
|
|
894
|
+
break
|
|
895
|
+
seen.add(k)
|
|
896
|
+
if state_of(nodes.get(k) or {}) == "doubted":
|
|
897
|
+
passed.add(k) # 穿过但不重复标记(不是终点)
|
|
898
|
+
nxt.append(k)
|
|
899
|
+
if truncated:
|
|
900
|
+
break
|
|
901
|
+
for k in nxt:
|
|
902
|
+
if k in passed:
|
|
903
|
+
continue # 已 doubted:无需再标(幂等)
|
|
904
|
+
waves.append({"node_id": k, "depth": depth,
|
|
905
|
+
# Incoming dependencies are already on this entry.
|
|
906
|
+
# Scanning every parent's child list per result was
|
|
907
|
+
# quadratic even for a sparse star/chain graph.
|
|
908
|
+
"via": sorted(n for n in as_deps((nodes.get(k) or {}).get(DEPS_FIELD))
|
|
909
|
+
if n in seen)})
|
|
910
|
+
if truncated:
|
|
911
|
+
break
|
|
912
|
+
frontier = nxt
|
|
913
|
+
if frontier and len(seen) >= cap and not truncated:
|
|
914
|
+
truncated = any(k not in seen and k not in root_set
|
|
915
|
+
for nid in frontier for k in dep_map.get(nid, ()))
|
|
916
|
+
bounds = {"visited": len(seen), "truncated": truncated,
|
|
917
|
+
"roots_admitted": len(admitted_roots)}
|
|
918
|
+
if not apply:
|
|
919
|
+
return {"ok": True, "dry_run": True, "roots": roots[:50],
|
|
920
|
+
"roots_count": len(roots), "reachable": len(waves),
|
|
921
|
+
"planned": waves[:50], "passed_doubted": sorted(passed)[:20],
|
|
922
|
+
"max_nodes": cap, **bounds,
|
|
923
|
+
"note": "预演:未改盘;只降不升(复核须显式)"}
|
|
924
|
+
done, skipped = [], []
|
|
925
|
+
for w in waves:
|
|
926
|
+
r = set_state(cg, w["node_id"], "doubted",
|
|
927
|
+
reason="多跳失效传播(上游时间轴/证据失效)",
|
|
928
|
+
actor=actor, trigger=f"propagate:d{w['depth']}")
|
|
929
|
+
if r.get("ok") and r.get("changed"):
|
|
930
|
+
done.append(w["node_id"])
|
|
931
|
+
elif not r.get("ok"):
|
|
932
|
+
skipped.append(f"{w['node_id']}({r.get('error')})")
|
|
933
|
+
return {"ok": True, "dry_run": False, "roots": roots[:50],
|
|
934
|
+
"roots_count": len(roots), "updated": done, "updated_count": len(done),
|
|
935
|
+
"passed_doubted": sorted(passed)[:20],
|
|
936
|
+
"skipped": skipped[:20], "max_nodes": cap, **bounds}
|
|
937
|
+
|
|
938
|
+
|
|
939
|
+
# ---------------------------------------------------------------- 巡检 / 回填
|
|
940
|
+
|
|
941
|
+
# 生效条件:cg 传入即只读遍历 index 快照并返回悬空/未生效/已过期/存疑四类计数与样本,不写盘、不改状态、不抛(index 缺失按空库处理);
|
|
942
|
+
def patrol(cg, *, limit: int = 20, now: float = None) -> dict:
|
|
943
|
+
"""只读巡检:悬空依赖 / 时间轴失效 / 存疑积压。**不改状态、不删节点**。
|
|
944
|
+
|
|
945
|
+
命名纪律(负记忆,2026-09-19 实测):本函数**不得叫 `check`**——裁决层已有
|
|
946
|
+
`check(src, dst, ...)`(唯一裁决点)。同模块内同名二次定义会**静默遮蔽**前者,
|
|
947
|
+
`stamp()` 随即调到巡检版并抛 `TypeError`(现场:`set_verification` 整条链断)。
|
|
948
|
+
两者语义分属不同层次(纯函数裁决 vs 全库只读巡检),名字必须分开。
|
|
949
|
+
"""
|
|
950
|
+
nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
|
|
951
|
+
known = set(nodes)
|
|
952
|
+
dangling, expired, not_yet, doubted = [], [], [], []
|
|
953
|
+
for nid, e in sorted(nodes.items()):
|
|
954
|
+
for p in as_deps((e or {}).get(DEPS_FIELD)):
|
|
955
|
+
if p not in known:
|
|
956
|
+
dangling.append({"node_id": nid, "missing": p})
|
|
957
|
+
st = (e or {}).get(STATE_FIELD)
|
|
958
|
+
if st == "doubted":
|
|
959
|
+
doubted.append(nid)
|
|
960
|
+
# 时间轴按索引可判定字段粗判(精确判定需 fm,巡检读面只给候选)
|
|
961
|
+
kind = _index_validity(e, now=now)
|
|
962
|
+
if kind == "expired":
|
|
963
|
+
expired.append(nid)
|
|
964
|
+
elif kind == "not_yet":
|
|
965
|
+
not_yet.append(nid)
|
|
966
|
+
return {
|
|
967
|
+
"ok": not dangling,
|
|
968
|
+
"checked": True, "root": cg.root, "nodes": len(known),
|
|
969
|
+
"dangling": dangling[:int(limit)], "dangling_count": len(dangling),
|
|
970
|
+
"expired": expired[:int(limit)], "expired_count": len(expired),
|
|
971
|
+
"not_yet": not_yet[:int(limit)], "not_yet_count": len(not_yet),
|
|
972
|
+
"doubted": doubted[:int(limit)], "doubted_count": len(doubted),
|
|
973
|
+
"readonly": True,
|
|
974
|
+
"note": "只读巡检:悬空依赖/时效仅检出并报告,不自动改状态(处置由人/巡检动作发起)"}
|
|
975
|
+
|
|
976
|
+
|
|
977
|
+
def _index_validity(e, now: float = None) -> str:
|
|
978
|
+
"""索引快照口径的时效粗判(索引缺时间字段时返回 unknown,零读文件)。"""
|
|
979
|
+
if not isinstance(e, dict):
|
|
980
|
+
return "unknown"
|
|
981
|
+
return validity(e, now=now)[0]
|
|
982
|
+
|
|
983
|
+
|
|
984
|
+
def backfill(cg, apply: bool = False, limit: int = 5000) -> dict:
|
|
985
|
+
"""存量回填:把缺 `verification_state` 的节点显式补成 `unverified`(幂等)。
|
|
986
|
+
|
|
987
|
+
缺字段本就按 unverified 解释(`state_of`),故回填**不是让功能工作的前提**,
|
|
988
|
+
而是把「缺省」变成「显式」——索引/审计里从此可直接读到验证态。默认只盘点。
|
|
989
|
+
"""
|
|
990
|
+
nodes = (getattr(cg, "index", None) or {}).get("nodes") or {}
|
|
991
|
+
missing = []
|
|
992
|
+
for nid, e in list(nodes.items()):
|
|
993
|
+
if len(missing) >= limit:
|
|
994
|
+
break
|
|
995
|
+
if (e or {}).get(STATE_FIELD) in STATES:
|
|
996
|
+
continue
|
|
997
|
+
missing.append(nid)
|
|
998
|
+
missing.sort()
|
|
999
|
+
if not apply:
|
|
1000
|
+
return {"ok": True, "dry_run": True, "scanned": len(nodes),
|
|
1001
|
+
"missing": len(missing), "planned": missing[:50]}
|
|
1002
|
+
done, failed = [], []
|
|
1003
|
+
for nid in missing:
|
|
1004
|
+
node = cg.get(nid)
|
|
1005
|
+
if not node:
|
|
1006
|
+
failed.append(nid)
|
|
1007
|
+
continue
|
|
1008
|
+
fm = dict(node.get("frontmatter") or {})
|
|
1009
|
+
fm[STATE_FIELD] = state_of(fm)
|
|
1010
|
+
cg._write_node(nid, os.path.join(cg.root, node["path"]), fm,
|
|
1011
|
+
node.get("content") or "")
|
|
1012
|
+
_sync_index(cg, nid, fm)
|
|
1013
|
+
done.append(nid)
|
|
1014
|
+
return {"ok": True, "dry_run": False, "scanned": len(nodes),
|
|
1015
|
+
"missing": len(missing), "backfilled": len(done),
|
|
1016
|
+
"planned": done[:50], "failed": failed[:20]}
|
|
1017
|
+
|
|
1018
|
+
|
|
1019
|
+
def describe(cg, node_id: str, now: float = None) -> dict:
|
|
1020
|
+
"""单节点验证态全貌(供 op=status / 状态头渲染)。只读、失败不抛。
|
|
1021
|
+
|
|
1022
|
+
N205(2026-09-28):`cg.get` 被读闸拒后**不得**回落索引条目仍报 ok=True——
|
|
1023
|
+
索引条目本身就是密级/会话/验证态元数据(layer/tags/session/verification_state),
|
|
1024
|
+
回落等于把「不可读」当「可见」返回(实测:guest 对 private 节点 get→None,
|
|
1025
|
+
而 status 仍回 ok=True + verification_state='verified' + depends_on +
|
|
1026
|
+
状态头「✓ 已验证」)。口径改为与 get/search/recall 一致的「不可见即不存在」:
|
|
1027
|
+
判定走跨层单点 `security.node_visible`(纯 MdCGOS 无身份模型 → 不受影响;
|
|
1028
|
+
设计者 can_admin 豁免不变)。
|
|
1029
|
+
"""
|
|
1030
|
+
try:
|
|
1031
|
+
node = cg.get(node_id)
|
|
1032
|
+
except Exception: # noqa: BLE001
|
|
1033
|
+
node = None
|
|
1034
|
+
e = ((getattr(cg, "index", None) or {}).get("nodes") or {}).get(node_id)
|
|
1035
|
+
if not node and not e:
|
|
1036
|
+
return {"ok": False, "error": "node_not_found", "node_id": node_id}
|
|
1037
|
+
if not node and not _security.node_visible(cg, node_id):
|
|
1038
|
+
return {"ok": False, "error": "node_not_found", "node_id": node_id}
|
|
1039
|
+
fm = (node or {}).get("frontmatter") or {}
|
|
1040
|
+
deps = as_deps(fm.get(DEPS_FIELD)) or as_deps((e or {}).get(DEPS_FIELD))
|
|
1041
|
+
kind, start, end = validity(fm if fm else (e or {}), now=now)
|
|
1042
|
+
dep_map = dependents_index(cg)
|
|
1043
|
+
hist = list(fm.get(HISTORY_FIELD) or [])[-5:]
|
|
1044
|
+
return {"ok": True, "node_id": node_id,
|
|
1045
|
+
"verification_state": state_of(fm if fm else (e or {})),
|
|
1046
|
+
"verification_basis": fm.get("verification_basis"),
|
|
1047
|
+
"verification_method": fm.get("verification_method"),
|
|
1048
|
+
"verified_at": fm.get("verified_at"),
|
|
1049
|
+
"depends_on": deps,
|
|
1050
|
+
"depended_by": dep_map.get(node_id, []),
|
|
1051
|
+
"validity": {"kind": kind, "valid_from": fm.get(FROM_FIELD),
|
|
1052
|
+
"valid_until": fm.get(UNTIL_FIELD),
|
|
1053
|
+
"start": start, "end": end},
|
|
1054
|
+
"history": hist,
|
|
1055
|
+
"lifecycle_state": fm.get("lifecycle_state"),
|
|
1056
|
+
"protected": bool(fm.get("protected") or fm.get("immutable"))}
|
|
1057
|
+
|
|
1058
|
+
|
|
1059
|
+
def summary(cg) -> dict:
|
|
1060
|
+
"""轻量摘要(只读;失败不抛,避免拖垮 health / 常驻循环)。"""
|
|
1061
|
+
try:
|
|
1062
|
+
rep = patrol(cg, limit=3)
|
|
1063
|
+
return {"dangling": rep["dangling_count"], "expired": rep["expired_count"],
|
|
1064
|
+
"not_yet": rep["not_yet_count"], "doubted": rep["doubted_count"],
|
|
1065
|
+
"nodes": rep["nodes"], "sample": [
|
|
1066
|
+
f"{r['node_id']}->?{r['missing']}" for r in rep["dangling"]]}
|
|
1067
|
+
except Exception: # noqa: BLE001
|
|
1068
|
+
return {}
|
|
1069
|
+
|
|
1070
|
+
|
|
1071
|
+
def load_ledger(cg, *, node_id: str = None, limit: int = None) -> list:
|
|
1072
|
+
"""读验证态台账(跳过坏行;可按节点过滤)。
|
|
1073
|
+
|
|
1074
|
+
N205(2026-09-28):行内 `reason` 含**明文证据串**(外部裁决理由),此前
|
|
1075
|
+
只按 node_id 等值过滤、零可见性判定 ⇒ 任何持 read op 的身份(含无令牌
|
|
1076
|
+
guest,`cg(op="status", action="ledger")` 在 guest 的 ops_allow 内)可读走
|
|
1077
|
+
他人私密节点的裁决证据与验证态。口径与库读面统一:逐行按
|
|
1078
|
+
`security.node_visible`(跨层单点)判定行所属节点对本身份是否可见,
|
|
1079
|
+
不可见/不可证(已 forget、索引无条目)→ 该行整条不出;设计者豁免。
|
|
1080
|
+
"""
|
|
1081
|
+
path = os.path.join(cg.root, AUDIT_FILE)
|
|
1082
|
+
out = []
|
|
1083
|
+
for r in read_jsonl(path):
|
|
1084
|
+
if not isinstance(r, dict):
|
|
1085
|
+
continue
|
|
1086
|
+
if node_id and r.get("node_id") != node_id:
|
|
1087
|
+
continue
|
|
1088
|
+
if not _security.node_visible(cg, r.get("node_id")):
|
|
1089
|
+
continue
|
|
1090
|
+
out.append(r)
|
|
1091
|
+
return out[:int(limit)] if limit else out
|
|
1092
|
+
|
|
1093
|
+
|
|
1094
|
+
def catalog(root: str = None) -> dict:
|
|
1095
|
+
"""自描述(供 MCP catalog / 人工核对)。"""
|
|
1096
|
+
return {
|
|
1097
|
+
"layer": "可验证记忆单元",
|
|
1098
|
+
"question": "它还成不成立(验证态 + 依赖 + 时效)",
|
|
1099
|
+
"ledger": os.path.join(root, AUDIT_FILE) if root else AUDIT_FILE,
|
|
1100
|
+
"states": list(STATES),
|
|
1101
|
+
"state_field": STATE_FIELD,
|
|
1102
|
+
"history_field": HISTORY_FIELD,
|
|
1103
|
+
"deps_field": DEPS_FIELD,
|
|
1104
|
+
"time_fields": [FROM_FIELD, UNTIL_FIELD],
|
|
1105
|
+
"transitions": sorted(f"{a}→{b}" for a, b in TRANSITIONS),
|
|
1106
|
+
"max_deps": MAX_DEPS,
|
|
1107
|
+
"max_nodes_default": MAX_NODES_DEFAULT,
|
|
1108
|
+
"discipline": {"never_block_write": True, "no_backfill": True,
|
|
1109
|
+
"patrol_readonly": True, "one_hop_sync": True,
|
|
1110
|
+
"multi_hop_async": True, "only_downgrade": True},
|
|
1111
|
+
"distinct_from": ("lifecycle.py = 节点生命周期(lifecycle_state);"
|
|
1112
|
+
"provenance.py = 派生血缘(_link.jsonl);"
|
|
1113
|
+
"本层 = 验证态与依赖(verification_state/_trust.jsonl)"),
|
|
1114
|
+
}
|