@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/evidence.py
CHANGED
|
@@ -1,586 +1,947 @@
|
|
|
1
|
-
# -*- coding: utf-8 -*-
|
|
2
|
-
"""跨节点证据存储(蜂群互联 v0.3)。
|
|
3
|
-
|
|
4
|
-
攻 §9.1 盲区:`identity.infer_position` 只统计**本根**带 `subject:<id>` 标签的
|
|
5
|
-
证据节点,跨节点时对端观测对本节点不可见。本模块给出最小可测的交换机制:
|
|
6
|
-
|
|
7
|
-
① **节点名片**(card)——`node_id` / 根路径 / 版本状态 / 签名器公开信息;
|
|
8
|
-
② **证据包**(pack)——从本根导出「我对某主体的观测」,**由本节点签名**;
|
|
9
|
-
③ **导入**(import)——验签 → 落本根(带 `source:<node>` 标签)→ 可审计、可拒收。
|
|
10
|
-
|
|
11
|
-
设计边界(承 D-1 / D-4):
|
|
12
|
-
|
|
13
|
-
· 内核**不做密码学**:签名/验签一律经 `signer.sign_for / verify_for`,
|
|
14
|
-
跨节点证据要求子系统策略 `sign_on` 含 `evidence`(由智能体自决);
|
|
15
|
-
· 内核**不保证全局共识**(0.0.3 局部不可知):只保证「来源可溯 + 可拒收 + 留痕」;
|
|
16
|
-
· 证据是**他证**(来源节点对主体的观测),不是主体自证;自证走 `identity.anchor`;
|
|
17
|
-
· **禁止转手**:已导入的跨节点证据(带 `xnode:cross`)不参与再次导出,
|
|
18
|
-
否则 A 可以把「C 说 B 怎样」洗成「A 说 B 怎样」,来源链断裂。
|
|
19
|
-
|
|
20
|
-
诚实边界:本层验证的是「**这条证据确实来自该节点**」,
|
|
21
|
-
**不是**「这条证据为真」——后者需节点侧的可信执行,属工程侧责任。
|
|
22
|
-
|
|
23
|
-
零第三方依赖。
|
|
24
|
-
"""
|
|
25
|
-
from __future__ import annotations
|
|
26
|
-
|
|
27
|
-
import argparse
|
|
28
|
-
import hashlib
|
|
29
|
-
import json
|
|
30
|
-
import
|
|
31
|
-
import
|
|
32
|
-
import
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
from . import
|
|
36
|
-
from .
|
|
37
|
-
from .
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
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
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
#
|
|
124
|
-
def
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
#
|
|
131
|
-
|
|
132
|
-
#
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
"
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
|
|
276
|
-
|
|
277
|
-
|
|
278
|
-
|
|
279
|
-
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
340
|
-
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
|
|
369
|
-
|
|
370
|
-
|
|
371
|
-
|
|
372
|
-
|
|
373
|
-
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
#
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
|
|
446
|
-
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
|
|
460
|
-
|
|
461
|
-
|
|
462
|
-
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
"
|
|
466
|
-
|
|
467
|
-
"
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
#
|
|
477
|
-
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
|
|
482
|
-
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
|
|
486
|
-
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
|
|
494
|
-
|
|
495
|
-
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|
|
517
|
-
|
|
518
|
-
|
|
519
|
-
|
|
520
|
-
#
|
|
521
|
-
def
|
|
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
|
-
if
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
"""跨节点证据存储(蜂群互联 v0.3)。
|
|
3
|
+
|
|
4
|
+
攻 §9.1 盲区:`identity.infer_position` 只统计**本根**带 `subject:<id>` 标签的
|
|
5
|
+
证据节点,跨节点时对端观测对本节点不可见。本模块给出最小可测的交换机制:
|
|
6
|
+
|
|
7
|
+
① **节点名片**(card)——`node_id` / 根路径 / 版本状态 / 签名器公开信息;
|
|
8
|
+
② **证据包**(pack)——从本根导出「我对某主体的观测」,**由本节点签名**;
|
|
9
|
+
③ **导入**(import)——验签 → 落本根(带 `source:<node>` 标签)→ 可审计、可拒收。
|
|
10
|
+
|
|
11
|
+
设计边界(承 D-1 / D-4):
|
|
12
|
+
|
|
13
|
+
· 内核**不做密码学**:签名/验签一律经 `signer.sign_for / verify_for`,
|
|
14
|
+
跨节点证据要求子系统策略 `sign_on` 含 `evidence`(由智能体自决);
|
|
15
|
+
· 内核**不保证全局共识**(0.0.3 局部不可知):只保证「来源可溯 + 可拒收 + 留痕」;
|
|
16
|
+
· 证据是**他证**(来源节点对主体的观测),不是主体自证;自证走 `identity.anchor`;
|
|
17
|
+
· **禁止转手**:已导入的跨节点证据(带 `xnode:cross`)不参与再次导出,
|
|
18
|
+
否则 A 可以把「C 说 B 怎样」洗成「A 说 B 怎样」,来源链断裂。
|
|
19
|
+
|
|
20
|
+
诚实边界:本层验证的是「**这条证据确实来自该节点**」,
|
|
21
|
+
**不是**「这条证据为真」——后者需节点侧的可信执行,属工程侧责任。
|
|
22
|
+
|
|
23
|
+
零第三方依赖。
|
|
24
|
+
"""
|
|
25
|
+
from __future__ import annotations
|
|
26
|
+
|
|
27
|
+
import argparse
|
|
28
|
+
import hashlib
|
|
29
|
+
import json
|
|
30
|
+
import math
|
|
31
|
+
import os
|
|
32
|
+
import sys
|
|
33
|
+
import time
|
|
34
|
+
|
|
35
|
+
from . import crypto as _crypto
|
|
36
|
+
from . import identity as _identity
|
|
37
|
+
from . import security as _sec
|
|
38
|
+
from . import signer as _signer
|
|
39
|
+
from .datapath import aux_root
|
|
40
|
+
from . import fsutil
|
|
41
|
+
from .fsutil import publish
|
|
42
|
+
|
|
43
|
+
NODE_ID_ENV = "MDCG_NODE_ID"
|
|
44
|
+
SWARM_DIR_ENV = "MDCG_SWARM_DIR"
|
|
45
|
+
ROOT_ENV = "MDCG_ROOT"
|
|
46
|
+
|
|
47
|
+
DEFAULT_DIR = aux_root()
|
|
48
|
+
DEFAULT_SWARM_DIR = os.path.join(DEFAULT_DIR, "swarm")
|
|
49
|
+
|
|
50
|
+
SUBSYSTEM = "swarm" # 子系统名:智能体可对它声明签名策略(D-4)
|
|
51
|
+
SIGN_ACTION = "evidence"
|
|
52
|
+
SCHEMA = 1
|
|
53
|
+
KIND = "mdcg.evidence.pack"
|
|
54
|
+
CARD_KIND = "mdcg.node.card"
|
|
55
|
+
|
|
56
|
+
TAG_XNODE = "xnode:cross"
|
|
57
|
+
SOURCE_PREFIX = "source:"
|
|
58
|
+
|
|
59
|
+
# ---- issue #191:导入侧的层/重要度夹紧与旧包重放台账(三处收口) ----
|
|
60
|
+
#: 落层白名单:对端声明**不得**自选受保护层(protect.PROTECTED_LAYERS = self/anchor)
|
|
61
|
+
#: 或 goals/structural 一类特殊层,一律改落 knowledge。
|
|
62
|
+
IMPORT_LAYERS = ("knowledge", "contextual")
|
|
63
|
+
#: 导入重要度上限。**必须低于** protect.AUTO_PROTECT_IMPORTANCE(0.70)——否则对端
|
|
64
|
+
#: 一条声明就能把节点变成不可遗忘(属主 mdcg_forget 直接 ProtectionError)。
|
|
65
|
+
IMPORT_IMPORTANCE_MAX = 0.5
|
|
66
|
+
#: 已见包版本台账(本根顶层):xnode id -> 最后一次写入所用包的 created_at。
|
|
67
|
+
SEEN_FILE = "_xnode_seen.json"
|
|
68
|
+
|
|
69
|
+
MAX_ITEMS = 500 # 单包条目上限(防灌包)
|
|
70
|
+
MAX_TEXT = 4000 # 单条正文上限
|
|
71
|
+
|
|
72
|
+
# ---- issue #453(站点 2):版本号不得由对端单方面推进 ----
|
|
73
|
+
#: 允许的对端时钟前偏(秒)。`created_at` 超过 `now + 本值` ⇒ **整包拒收**(与
|
|
74
|
+
#: 「非数值 / 非有限值整包拒收」同口径,fail-closed)。
|
|
75
|
+
#: 为什么需要上界:#191-B 拿 `created_at` 当版本号写 `_xnode_seen` 台账(跨进程持久)。
|
|
76
|
+
#: 免签名通道下该值完全由对端填写且无上界 ⇒ 一个 `9e15` 就把台账永久推高,
|
|
77
|
+
#: 之后**所有**真实时间戳的合法包都被判 `replayed`(回执仍 `ok: true`)=永久静默屏蔽。
|
|
78
|
+
MAX_PACK_FUTURE_SKEW = 300.0
|
|
79
|
+
|
|
80
|
+
# ---- issue #258:密级面的**单一权威**(不另立判据,直接引既有常量) ----
|
|
81
|
+
_SENSITIVITY_ORDER = _sec.SENSITIVITY_ORDER
|
|
82
|
+
_ENCRYPTED_LEVELS = set(_crypto.ENCRYPTED_LEVELS)
|
|
83
|
+
_AccessDenied = _sec.AccessDenied
|
|
84
|
+
|
|
85
|
+
# ---- issue #147(2026-10-11):pack_id 白名单 ----
|
|
86
|
+
# 病象:pack_id 未清洗即拼进归档路径(见 write_pack 缺省分支)⇒ 路径穿越;
|
|
87
|
+
# 非管理员令牌**一次 import 即可覆写** _keys.json / _tokens.json(实测 k=5 段 ../ 命中)。
|
|
88
|
+
# 合法生产者只产 "pack-<12hex>"(见 export_pack「pack["pack_id"] = "pack-" + pid」),
|
|
89
|
+
# 故白名单取 ASCII 字母数字与 . _ -,并显式拒 .. 与前导点。
|
|
90
|
+
PACK_ID_MAX = 128
|
|
91
|
+
PACK_ID_OK = frozenset(
|
|
92
|
+
"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789._-")
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
class EvidenceError(Exception):
|
|
96
|
+
"""跨节点证据层错误(fail-closed)。"""
|
|
97
|
+
|
|
98
|
+
|
|
99
|
+
# --------------------------------------------------------------------------
|
|
100
|
+
# 路径与身份
|
|
101
|
+
# --------------------------------------------------------------------------
|
|
102
|
+
|
|
103
|
+
# 生效条件:当传入 path 为真值时返回 path;否则若环境变量 SWARM_DIR_ENV 为真值则返回其值;否则返回模块级常量 DEFAULT_SWARM_DIR。
|
|
104
|
+
def swarm_dir(path: str = None) -> str:
|
|
105
|
+
return path or os.environ.get(SWARM_DIR_ENV) or DEFAULT_SWARM_DIR
|
|
106
|
+
|
|
107
|
+
|
|
108
|
+
# 生效条件:当传入 swarm 参数(假值回落到 swarm_dir 的默认逻辑)时,返回 os.path.join(swarm_dir(swarm), "peers")。
|
|
109
|
+
def peers_dir(swarm: str = None) -> str:
|
|
110
|
+
return os.path.join(swarm_dir(swarm), "peers")
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
# 生效条件:当传入 swarm 参数(假值回落到 swarm_dir 的默认逻辑)时,返回 os.path.join(swarm_dir(swarm), "inbox")。
|
|
114
|
+
def inbox_dir(swarm: str = None) -> str:
|
|
115
|
+
return os.path.join(swarm_dir(swarm), "inbox")
|
|
116
|
+
|
|
117
|
+
|
|
118
|
+
# 生效条件:当传入 root 为真值时返回 root;否则返回环境变量 ROOT_ENV 的值(可能为 None)。
|
|
119
|
+
def _root_of(root: str = None) -> str:
|
|
120
|
+
return root or os.environ.get(ROOT_ENV)
|
|
121
|
+
|
|
122
|
+
|
|
123
|
+
# 生效条件:当 explicit 或环境变量 NODE_ID_ENV strip 后非空时返回该值;否则若 _root_of(root) 返回真值,返回基于规范绝对路径的 'node-<12hex>';否则抛出 EvidenceError。
|
|
124
|
+
def node_id(root: str = None, explicit: str = None) -> str:
|
|
125
|
+
"""本节点身份。
|
|
126
|
+
|
|
127
|
+
优先 `MDCG_NODE_ID`(生产环境应显式设置,保证跨机器稳定);
|
|
128
|
+
缺省从根路径派生 `node-<12hex>`(同机可复现,跨机器不保证唯一)。
|
|
129
|
+
"""
|
|
130
|
+
# issue #277 类型闸**先于 .strip()**:旧写法 (explicit or env or "").strip()
|
|
131
|
+
# 在 explicit=123 这类非字符串上会漏成 AttributeError(int 没有 strip),
|
|
132
|
+
# 既不是 fail-closed 的错误类、调用方也无法按类型判空。
|
|
133
|
+
# 语义保持:假值 explicit 仍回落环境变量;空串仍是「未提供」⇒ 走派生。
|
|
134
|
+
raw = explicit or os.environ.get(NODE_ID_ENV)
|
|
135
|
+
if raw is not None and not isinstance(raw, str):
|
|
136
|
+
raise EvidenceError(
|
|
137
|
+
f"证据节点 id 必须是字符串:{raw!r}({type(raw).__name__})")
|
|
138
|
+
nid = (raw or "").strip()
|
|
139
|
+
if nid:
|
|
140
|
+
# issue #277:本值是**模型/环境可控输入**,而 publish_card 会把它直接
|
|
141
|
+
# 拼进 os.path.join(peers_dir(swarm), nid + ".json")——"../" 可穿越出
|
|
142
|
+
# swarm 目录(实测 MDCG_NODE_ID="../../../evil_pwned" 在 swarm 外落盘)。
|
|
143
|
+
# 旧实现只 strip、零校验 ⇒ 任意文件写。此处**先拦后拼**(同 #147 的
|
|
144
|
+
# 「汇点兜底」与 mdcos._restore_id_ok 的「先拦后读」纪律):
|
|
145
|
+
# 判据与写面 add() 的 P0-1 白名单**同源**,不是第二份判据。
|
|
146
|
+
err = _node_id_error(nid)
|
|
147
|
+
if err:
|
|
148
|
+
raise EvidenceError(err)
|
|
149
|
+
return nid
|
|
150
|
+
r = _root_of(root)
|
|
151
|
+
if not r:
|
|
152
|
+
raise EvidenceError(
|
|
153
|
+
"无法确定节点身份:请设 MDCG_NODE_ID(推荐)或 MDCG_ROOT")
|
|
154
|
+
key = os.path.normcase(os.path.abspath(r))
|
|
155
|
+
return "node-" + hashlib.sha256(key.encode("utf-8")).hexdigest()[:12]
|
|
156
|
+
|
|
157
|
+
|
|
158
|
+
# 生效条件:包内 md_cg.theory 可导入且 _th.check() 成功时返回 {version, accepted, theory_ok};任何异常(版本层缺失或校验失败)一律吞掉返回 {},不阻断证据层主流程;
|
|
159
|
+
def _theory_state() -> dict:
|
|
160
|
+
try:
|
|
161
|
+
from . import theory as _th
|
|
162
|
+
st = _th.check()
|
|
163
|
+
return {"version": st.get("version"),
|
|
164
|
+
"accepted": list(st.get("accepted_versions") or []),
|
|
165
|
+
"theory_ok": bool(st.get("theory_ok"))}
|
|
166
|
+
except Exception: # 版本层缺失不阻断证据层
|
|
167
|
+
return {}
|
|
168
|
+
|
|
169
|
+
|
|
170
|
+
# 生效条件:当传入 obj 时,返回其 json.dumps(obj, ensure_ascii=False, sort_keys=True, separators=(',',':')).encode("utf-8") 字节。
|
|
171
|
+
def _canon(obj) -> bytes:
|
|
172
|
+
return json.dumps(obj, ensure_ascii=False, sort_keys=True,
|
|
173
|
+
separators=(",", ":")).encode("utf-8")
|
|
174
|
+
|
|
175
|
+
|
|
176
|
+
# 生效条件:当传入 s 时,返回 str(s) 中每个字符若为字母数字或 '_' '-' 则保留,否则替换为 '_' 的字符串。
|
|
177
|
+
def _slug(s) -> str:
|
|
178
|
+
return "".join(ch if (ch.isalnum() or ch in "_-") else "_" for ch in str(s))
|
|
179
|
+
|
|
180
|
+
|
|
181
|
+
# --------------------------------------------------------------------------
|
|
182
|
+
# 节点名片(发现)
|
|
183
|
+
# --------------------------------------------------------------------------
|
|
184
|
+
|
|
185
|
+
# 生效条件:当传入 root、subsystem(默认常量 SUBSYSTEM)、signers_file 时,基于 _signer.policy_for 和 _signer.get_signer 返回名片字典,其中 root 为 os.path.abspath(_root_of(root)) 若 _root_of(root) 真值否则 None。
|
|
186
|
+
def card(root: str = None, *, subsystem: str = SUBSYSTEM,
|
|
187
|
+
signers_file: str = None) -> dict:
|
|
188
|
+
"""本节点名片:身份 + 版本 + 签名器公开信息(**不含密钥**)。"""
|
|
189
|
+
pol = _signer.policy_for(subsystem, signers_file)
|
|
190
|
+
s = _signer.get_signer(pol.get("signer"))
|
|
191
|
+
r = _root_of(root)
|
|
192
|
+
return {
|
|
193
|
+
"schema": SCHEMA, "kind": CARD_KIND,
|
|
194
|
+
"node_id": node_id(root),
|
|
195
|
+
"root": os.path.abspath(r) if r else None,
|
|
196
|
+
"theory": _theory_state(),
|
|
197
|
+
"signer": s.public(),
|
|
198
|
+
"subsystem": subsystem,
|
|
199
|
+
"policy": {"sign_on": list(pol.get("sign_on") or []),
|
|
200
|
+
"require_peer_signature": bool(pol.get("require_peer_signature")),
|
|
201
|
+
"on_verify_fail": pol.get("on_verify_fail")},
|
|
202
|
+
"created_at": time.time(),
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
|
|
206
|
+
# 生效条件:当传入 root、swarm、subsystem(默认常量 SUBSYSTEM)、signers_file 时,调用 card 得到 c,将 c 以 JSON 写入 peers_dir(swarm)/<c["node_id"]>.json,返回 {"ok": True, "file": p, "card": c}。
|
|
207
|
+
def publish_card(root: str = None, *, swarm: str = None,
|
|
208
|
+
subsystem: str = SUBSYSTEM, signers_file: str = None) -> dict:
|
|
209
|
+
"""把本节点名片写入共享目录 `peers/<node_id>.json`(0600)。"""
|
|
210
|
+
c = card(root, subsystem=subsystem, signers_file=signers_file)
|
|
211
|
+
# issue #277 **汇点兜底**(同 #147 的 write_pack 纪律):即使调用方绕过
|
|
212
|
+
# node_id() 直接构造 card,恶意 node_id 也一律 fail-closed——不静默落盘。
|
|
213
|
+
err = _node_id_error(c.get("node_id"))
|
|
214
|
+
if err:
|
|
215
|
+
raise EvidenceError(err)
|
|
216
|
+
base = os.path.realpath(peers_dir(swarm))
|
|
217
|
+
p = os.path.join(peers_dir(swarm), c["node_id"] + ".json")
|
|
218
|
+
# realpath 归一后判包含性:拒 ../ 穿越、绝对路径、盘符、UNC、空字节
|
|
219
|
+
# (白名单已挡住这些形态,此处是**第二道**,防白名单将来被放宽)。
|
|
220
|
+
try:
|
|
221
|
+
real = os.path.realpath(p)
|
|
222
|
+
except ValueError as exc: # 空字节等非法字符
|
|
223
|
+
raise EvidenceError(f"名片归档路径非法:{exc}")
|
|
224
|
+
if real != base and not real.startswith(base + os.sep):
|
|
225
|
+
raise EvidenceError(
|
|
226
|
+
f"名片归档路径越界(必须落在 peers 目录内):{p!r}")
|
|
227
|
+
_write_json(p, c)
|
|
228
|
+
return {"ok": True, "file": p, "card": c}
|
|
229
|
+
|
|
230
|
+
|
|
231
|
+
# 生效条件:当 peers_dir(swarm) 是目录时,遍历其中 .json 文件,加载为 dict 且 kind 等于常量 CARD_KIND 的名片,若 exclude_self 为真则排除 node_id 等于 node_id(root) 的名片(node_id(root) 抛 EvidenceError 时 self_id 为 None 不排除),返回按文件名排序的列表及计数;目录不存在则返回空列表。
|
|
232
|
+
def peers(swarm: str = None, *, exclude_self: bool = True,
|
|
233
|
+
root: str = None) -> dict:
|
|
234
|
+
"""发现共享目录里的对端名片(按 node_id 排序)。"""
|
|
235
|
+
d = peers_dir(swarm)
|
|
236
|
+
out, self_id = [], None
|
|
237
|
+
if exclude_self:
|
|
238
|
+
try:
|
|
239
|
+
self_id = node_id(root)
|
|
240
|
+
except EvidenceError:
|
|
241
|
+
self_id = None
|
|
242
|
+
if os.path.isdir(d):
|
|
243
|
+
for fn in sorted(os.listdir(d)):
|
|
244
|
+
if not fn.endswith(".json"):
|
|
245
|
+
continue
|
|
246
|
+
try:
|
|
247
|
+
with open(os.path.join(d, fn), "r", encoding="utf-8") as f:
|
|
248
|
+
c = json.load(f)
|
|
249
|
+
except (OSError, ValueError):
|
|
250
|
+
continue
|
|
251
|
+
if not isinstance(c, dict) or c.get("kind") != CARD_KIND:
|
|
252
|
+
continue
|
|
253
|
+
if self_id and c.get("node_id") == self_id:
|
|
254
|
+
continue
|
|
255
|
+
out.append(c)
|
|
256
|
+
return {"dir": d, "count": len(out), "peers": out}
|
|
257
|
+
|
|
258
|
+
|
|
259
|
+
# --------------------------------------------------------------------------
|
|
260
|
+
# 证据包:导出
|
|
261
|
+
# --------------------------------------------------------------------------
|
|
262
|
+
|
|
263
|
+
_PACK_FIELDS = ("schema", "kind", "pack_id", "from_node", "from_root",
|
|
264
|
+
"theory", "created_at", "subjects", "items")
|
|
265
|
+
|
|
266
|
+
|
|
267
|
+
# 生效条件:当传入 pack 字典时,返回仅含模块级常量 _PACK_FIELDS 中字段(缺失字段取 pack.get(k) 得到 None)的规范化 JSON 字节。
|
|
268
|
+
def _pack_payload(pack: dict) -> bytes:
|
|
269
|
+
"""签名载荷:固定字段 + 排序序列化,同参数必同字节。"""
|
|
270
|
+
body = {}
|
|
271
|
+
for k in _PACK_FIELDS:
|
|
272
|
+
body[k] = pack.get(k)
|
|
273
|
+
return _canon(body)
|
|
274
|
+
|
|
275
|
+
|
|
276
|
+
# 生效条件:当传入 cg、subjects、since 时,遍历 cg.index["nodes"] 中按 node_id 排序的节点,仅收集标签含常量 TAG_OBS、不含 TAG_ANCHOR/TAG_TRAIT、不含 TAG_XNODE、能提取 subject: 标签且该 subject 在 subjects(subjects 为真时)或不限制(subjects 假值时)、且若 since 为真且 ts 为真则要求 float(ts) >= float(since) 的节点,返回含 node_id、subject、text(截断 MAX_TEXT)、kind、role、layer、过滤后的 tags、importance、verification_basis、ts 的列表。
|
|
277
|
+
# ---- issue #258(2026-10-14):跨节点证据包通路丢密级 ----
|
|
278
|
+
# 病象:`_collect` 产出的条目**不带 sensitivity**,`import_pack` 又经
|
|
279
|
+
# `identity.observe`(签名无该形参)落盘 ⇒ 走 `MdCGSecure.add` 的缺省
|
|
280
|
+
# `DEFAULT_SENSITIVITY="internal"`。而 `crypto.ENCRYPTED_LEVELS =
|
|
281
|
+
# ("private","secret")` ⇒ 发送方盘上是密文、接收方盘上是**明文**,且
|
|
282
|
+
# `import_pack` 默认 `archive=True` 把整包明文 JSON 再落一份到收件箱。
|
|
283
|
+
# 实测:A 侧 private(盘上无明文)→ B 侧 internal(盘上明文)+ 收件箱明文。
|
|
284
|
+
#
|
|
285
|
+
# 收口三处:① 本条读数进包;② 导入侧 fail-closed 校验(缺字段/非字符串/
|
|
286
|
+
# 未知档一律不收,不降级);③ 包内含加密档 ⇒ 不归档(归档是明文 JSON)。
|
|
287
|
+
def _node_sensitivity(cg, nid):
|
|
288
|
+
"""读节点密级。**与 #164 同源**(`subgraph.node_sensitivity`),不另立判据。"""
|
|
289
|
+
from . import subgraph as _sg
|
|
290
|
+
try:
|
|
291
|
+
return _sg.node_sensitivity(cg, nid)
|
|
292
|
+
except Exception: # noqa: BLE001
|
|
293
|
+
return None
|
|
294
|
+
|
|
295
|
+
|
|
296
|
+
def _collect(cg, subjects=None, since=None) -> list:
|
|
297
|
+
"""收集本根**本地原始**观测证据(排除档案节点与已导入的跨节点证据)。"""
|
|
298
|
+
want = set(subjects or [])
|
|
299
|
+
items = []
|
|
300
|
+
nodes = cg.index.get("nodes") or {}
|
|
301
|
+
for nid in sorted(nodes):
|
|
302
|
+
e = nodes[nid]
|
|
303
|
+
tg = set(e.get("tags") or [])
|
|
304
|
+
if _identity.TAG_OBS not in tg:
|
|
305
|
+
continue
|
|
306
|
+
if tg & {_identity.TAG_ANCHOR, _identity.TAG_TRAIT}:
|
|
307
|
+
continue
|
|
308
|
+
if TAG_XNODE in tg: # 禁止转手(防洗证据)
|
|
309
|
+
continue
|
|
310
|
+
subj = ""
|
|
311
|
+
for t in tg:
|
|
312
|
+
if isinstance(t, str) and t.startswith("subject:"):
|
|
313
|
+
subj = t[len("subject:"):]
|
|
314
|
+
break
|
|
315
|
+
if not subj or (want and subj not in want):
|
|
316
|
+
continue
|
|
317
|
+
node = cg.get(nid) or {}
|
|
318
|
+
fm = node.get("frontmatter") or {}
|
|
319
|
+
ts = fm.get("ts") or fm.get("created_at") or e.get("ts") or 0
|
|
320
|
+
if since and ts and float(ts) < float(since):
|
|
321
|
+
continue
|
|
322
|
+
items.append({
|
|
323
|
+
"node_id": nid,
|
|
324
|
+
"subject": subj,
|
|
325
|
+
"text": (node.get("content") or "")[:MAX_TEXT],
|
|
326
|
+
"kind": fm.get("kind"),
|
|
327
|
+
"role": fm.get("role"),
|
|
328
|
+
"layer": e.get("layer"),
|
|
329
|
+
"tags": sorted(t for t in tg
|
|
330
|
+
if isinstance(t, str)
|
|
331
|
+
and not t.startswith("subject:")
|
|
332
|
+
and not t.startswith(SOURCE_PREFIX)
|
|
333
|
+
and t != TAG_XNODE),
|
|
334
|
+
"importance": fm.get("importance"),
|
|
335
|
+
"verification_basis": (e.get("verification_basis")
|
|
336
|
+
or fm.get("verification_basis")),
|
|
337
|
+
# issue #258:密级随条目出根(此前整条通路不带该字段)
|
|
338
|
+
"sensitivity": _node_sensitivity(cg, nid),
|
|
339
|
+
"ts": ts,
|
|
340
|
+
})
|
|
341
|
+
return items
|
|
342
|
+
|
|
343
|
+
|
|
344
|
+
# 生效条件:当传入 cg、subjects、since、swarm、subsystem(默认 SUBSYSTEM)、signers_file、require_signature(默认 True)时,收集证据并截断至常量 MAX_ITEMS,用 _signer.sign_for 以常量 SIGN_ACTION 签名,若 require_signature 为真且签名未成功则抛出 EvidenceError,否则返回含 pack、count、truncated、signed 的字典。
|
|
345
|
+
def export_pack(cg, *, subjects=None, since=None, swarm: str = None,
|
|
346
|
+
subsystem: str = SUBSYSTEM, signers_file: str = None,
|
|
347
|
+
require_signature: bool = True) -> dict:
|
|
348
|
+
"""导出本节点对(指定)主体的观测证据包,并签名。
|
|
349
|
+
|
|
350
|
+
`require_signature=True`(默认):策略未对 `evidence` 签名即抛错——
|
|
351
|
+
跨节点证据没有签名就不可溯源,宁可不产出。
|
|
352
|
+
"""
|
|
353
|
+
items = _collect(cg, subjects=subjects, since=since)
|
|
354
|
+
truncated = len(items) > MAX_ITEMS
|
|
355
|
+
items = items[:MAX_ITEMS]
|
|
356
|
+
nid = node_id(getattr(cg, "root", None))
|
|
357
|
+
pack = {
|
|
358
|
+
"schema": SCHEMA, "kind": KIND,
|
|
359
|
+
"from_node": nid,
|
|
360
|
+
"from_root": os.path.abspath(getattr(cg, "root", "") or ""),
|
|
361
|
+
"theory": _theory_state(),
|
|
362
|
+
"created_at": time.time(),
|
|
363
|
+
"subjects": sorted(set(subjects or [])),
|
|
364
|
+
"items": items,
|
|
365
|
+
}
|
|
366
|
+
pid = hashlib.sha256(_canon({"n": nid, "t": pack["created_at"],
|
|
367
|
+
"c": len(items)})).hexdigest()[:12]
|
|
368
|
+
pack["pack_id"] = "pack-" + pid
|
|
369
|
+
|
|
370
|
+
sigres = _signer.sign_for(subsystem, _pack_payload(pack),
|
|
371
|
+
action=SIGN_ACTION, path=signers_file)
|
|
372
|
+
pack["sig"] = {"signer": sigres.get("signer"),
|
|
373
|
+
"signature": sigres.get("signature") or "",
|
|
374
|
+
"signed": bool(sigres.get("signed"))}
|
|
375
|
+
if require_signature and not pack["sig"]["signed"]:
|
|
376
|
+
raise EvidenceError(
|
|
377
|
+
f"子系统 {subsystem} 策略未对 {SIGN_ACTION} 签名,证据包不可溯源。"
|
|
378
|
+
f"请先声明:set_policy({subsystem!r}, sign_on=['handshake','{SIGN_ACTION}'])")
|
|
379
|
+
return {"ok": True, "pack": pack, "count": len(items),
|
|
380
|
+
"truncated": truncated, "signed": pack["sig"]["signed"]}
|
|
381
|
+
|
|
382
|
+
|
|
383
|
+
# 生效条件:当传入 pack、path、swarm 时,若 path 为假值则用 os.path.join(inbox_dir(swarm), f"{_slug(pack.get('from_node'))}__{pack.get('pack_id')}.json") 生成路径,将 pack 以 JSON 写入该路径并返回 {"ok": True, "file": path}。
|
|
384
|
+
def write_pack(pack: dict, path: str = None, swarm: str = None) -> dict:
|
|
385
|
+
"""把证据包落盘到收件箱(或指定路径)。"""
|
|
386
|
+
if not path:
|
|
387
|
+
# issue #147 **汇点兜底**:与 _validate 同源的白名单——即使调用方绕过
|
|
388
|
+
# import_pack(直接调本函数),恶意 pack_id 也一律 fail-closed,
|
|
389
|
+
# 且异常类型统一为 EvidenceError(不再漏成 OSError/ValueError)。
|
|
390
|
+
perr = _pack_id_error(pack.get("pack_id"))
|
|
391
|
+
if perr:
|
|
392
|
+
raise EvidenceError(perr)
|
|
393
|
+
base = os.path.realpath(inbox_dir(swarm))
|
|
394
|
+
path = os.path.join(inbox_dir(swarm),
|
|
395
|
+
f"{_slug(pack.get('from_node'))}__{pack.get('pack_id')}.json")
|
|
396
|
+
# issue #147(2026-10-11):归档目标必须落在收件箱根内——realpath 归一后判
|
|
397
|
+
# 包含性,越界即 fail-closed(拒 ../ 穿越、绝对路径、盘符、UNC、空字节)。
|
|
398
|
+
# 只约束**由 pack 数据派生**的缺省路径;显式 path 是调用方(CLI --out /
|
|
399
|
+
# MCP out)自选落点,属 API 层调用者权限,不在此收窄(既有调用面两处)。
|
|
400
|
+
try:
|
|
401
|
+
real = os.path.realpath(path)
|
|
402
|
+
except ValueError as exc: # 空字节等非法字符
|
|
403
|
+
raise EvidenceError(f"证据包归档路径非法:{exc}")
|
|
404
|
+
if real != base and not real.startswith(base + os.sep):
|
|
405
|
+
raise EvidenceError(
|
|
406
|
+
f"证据包归档路径越界(必须落在收件箱内):{path!r}")
|
|
407
|
+
_write_json(path, pack)
|
|
408
|
+
return {"ok": True, "file": path}
|
|
409
|
+
|
|
410
|
+
|
|
411
|
+
# --------------------------------------------------------------------------
|
|
412
|
+
# 证据包:导入
|
|
413
|
+
# --------------------------------------------------------------------------
|
|
414
|
+
|
|
415
|
+
# 生效条件:当 src 是 dict 时直接返回 src;否则以 src 为路径打开 JSON 文件并返回 json.load(f)。
|
|
416
|
+
def _read_pack(src) -> dict:
|
|
417
|
+
if isinstance(src, dict):
|
|
418
|
+
return src
|
|
419
|
+
with open(src, "r", encoding="utf-8") as f:
|
|
420
|
+
return json.load(f)
|
|
421
|
+
|
|
422
|
+
|
|
423
|
+
# 生效条件:pid 为 pack["pack_id"](任意类型);合规返回空字符串,否则返回中文理由——非 str/空、超 PACK_ID_MAX、含 PACK_ID_OK 之外字符、以点开头或含连续两点各一条。**单一真源**:_validate 与 write_pack 汇点共用本函数,规则只有一份。
|
|
424
|
+
def _node_id_error(nid) -> str:
|
|
425
|
+
"""node_id 白名单判据(issue #277)。
|
|
426
|
+
|
|
427
|
+
判据与写面 MdCG.add() 的 P0-1 白名单**同源**(同一 _NODE_ID_RE、同一
|
|
428
|
+
".." 禁令、同一 _NODE_ID_FORBIDDEN),不是第二份判据——避免两套口径漂移。
|
|
429
|
+
空串返回错误文案(调用方已 strip 过,空串即「未提供」)。
|
|
430
|
+
"""
|
|
431
|
+
from .mdcg import _NODE_ID_RE, _NODE_ID_FORBIDDEN
|
|
432
|
+
if not isinstance(nid, str) or not nid:
|
|
433
|
+
return f"证据节点 id 必须是非空字符串:{nid!r}"
|
|
434
|
+
if len(nid) > 128:
|
|
435
|
+
return f"证据节点 id 过长:{len(nid)} > 128"
|
|
436
|
+
if ".." in nid:
|
|
437
|
+
return f"证据节点 id 形似路径穿越(拒 ..):{nid!r}"
|
|
438
|
+
if nid in _NODE_ID_FORBIDDEN:
|
|
439
|
+
return f"证据节点 id 是保留字:{nid!r}"
|
|
440
|
+
if not _NODE_ID_RE.match(nid):
|
|
441
|
+
return (f"证据节点 id 含非法字符(须匹配 {_NODE_ID_RE.pattern}):{nid!r}")
|
|
442
|
+
return ""
|
|
443
|
+
|
|
444
|
+
|
|
445
|
+
def _pack_id_error(pid) -> str:
|
|
446
|
+
"""pack_id 白名单判据(issue #147)。"""
|
|
447
|
+
if not isinstance(pid, str) or not pid:
|
|
448
|
+
return "证据包缺少 pack_id(归档不可命名)"
|
|
449
|
+
if len(pid) > PACK_ID_MAX:
|
|
450
|
+
return f"证据包 pack_id 过长:{len(pid)} > {PACK_ID_MAX}"
|
|
451
|
+
bad_ch = sorted({ch for ch in pid if ch not in PACK_ID_OK})
|
|
452
|
+
if bad_ch:
|
|
453
|
+
return (f"证据包 pack_id 含非法字符 {bad_ch}"
|
|
454
|
+
f"(只允许字母数字与 . _ -):{pid!r}")
|
|
455
|
+
if pid.startswith(".") or ".." in pid:
|
|
456
|
+
return f"证据包 pack_id 形似路径(拒 .. 与前导点):{pid!r}"
|
|
457
|
+
return ""
|
|
458
|
+
|
|
459
|
+
|
|
460
|
+
# 生效条件:当 pack 为 dict 且 kind 等于常量 KIND、int(pack.get("schema") or 0) 不大于常量 SCHEMA、from_node strip 后非空、items 为 list、且 _pack_id_error(pack.get("pack_id")) 为空时返回空字符串;否则按序返回对应错误字符串(非 dict、kind 不符、schema 过新、缺 from_node、缺 items、pack_id 不合法)。
|
|
461
|
+
def _validate(pack: dict) -> str:
|
|
462
|
+
if not isinstance(pack, dict):
|
|
463
|
+
return "证据包不是 JSON 对象"
|
|
464
|
+
if pack.get("kind") != KIND:
|
|
465
|
+
return f"不是证据包(kind={pack.get('kind')!r})"
|
|
466
|
+
if int(pack.get("schema") or 0) > SCHEMA:
|
|
467
|
+
return f"证据包 schema 过新:{pack.get('schema')} > {SCHEMA}"
|
|
468
|
+
if not (pack.get("from_node") or "").strip():
|
|
469
|
+
return "证据包缺少 from_node(来源不可溯)"
|
|
470
|
+
if not isinstance(pack.get("items"), list):
|
|
471
|
+
return "证据包缺少 items"
|
|
472
|
+
# issue #147:pack_id 进归档文件名 ⇒ 必须过白名单(拒穿越/绝对路径/盘符/UNC/空字节)。
|
|
473
|
+
return _pack_id_error(pack.get("pack_id"))
|
|
474
|
+
|
|
475
|
+
|
|
476
|
+
# 生效条件:当传入 from_node 和 orig 时,返回 f"xnode_{_slug(from_node)}_{_slug(orig)}"。
|
|
477
|
+
def _xnode_id(from_node: str, orig: str) -> str:
|
|
478
|
+
return f"xnode_{_slug(from_node)}_{_slug(orig)}"
|
|
479
|
+
|
|
480
|
+
|
|
481
|
+
# 生效条件:当传入 pack、reason、swarm、**kw 时,构建含 at、reason、from_node、pack_id 及 kw 中非 None 项的拒绝记录,尝试追加到 inbox_dir(swarm)/_rejected.jsonl(OSError 忽略),返回 {"ok": False, "rejected": True, "reason": reason, "from_node": ...} 并合并 kw 中非 None 项。
|
|
482
|
+
def _item_sensitivity(it: dict):
|
|
483
|
+
"""校验包内条目的密级 → (密级, 拒收理由)。**fail-closed**。
|
|
484
|
+
|
|
485
|
+
issue #258:缺字段/非字符串/未知档一律返回理由(调用方跳过,不写盘)。
|
|
486
|
+
旧格式包(无 sensitivity)因此一律拒收——有意的行为变更。
|
|
487
|
+
"""
|
|
488
|
+
raw = it.get("sensitivity")
|
|
489
|
+
if raw is None:
|
|
490
|
+
return None, "条目缺 sensitivity 字段(旧格式包一律拒收)"
|
|
491
|
+
if not isinstance(raw, str):
|
|
492
|
+
return None, "条目 sensitivity 非字符串:%r" % (raw,)
|
|
493
|
+
s = raw.strip().lower()
|
|
494
|
+
if s not in _SENSITIVITY_ORDER:
|
|
495
|
+
return None, "条目 sensitivity 未知档:%r(合法档 %s)" % (
|
|
496
|
+
raw, "/".join(_SENSITIVITY_ORDER))
|
|
497
|
+
return s, ""
|
|
498
|
+
|
|
499
|
+
|
|
500
|
+
def _note_reject(pack: dict, reason: str, swarm: str = None, **kw) -> dict:
|
|
501
|
+
rec = {"at": time.time(), "reason": reason,
|
|
502
|
+
"from_node": (pack or {}).get("from_node"),
|
|
503
|
+
"pack_id": (pack or {}).get("pack_id")}
|
|
504
|
+
rec.update({k: v for k, v in kw.items() if v is not None})
|
|
505
|
+
try:
|
|
506
|
+
from .fsutil import append_jsonl
|
|
507
|
+
os.makedirs(inbox_dir(swarm), exist_ok=True)
|
|
508
|
+
# #326-④:append_jsonl 不再上抛、以 False 报写失败——本处**仍容忍**(best-effort
|
|
509
|
+
# 簿记),但失败不再静默:源头已记 fsutil.APPEND_FAILURES + 有界 stderr 告警
|
|
510
|
+
# (B 面单点)。显式消费返回值:不留裸调用(守卫 AST 钉子会抓)。
|
|
511
|
+
_ok = append_jsonl(os.path.join(inbox_dir(swarm), "_rejected.jsonl"), rec)
|
|
512
|
+
except OSError:
|
|
513
|
+
pass
|
|
514
|
+
out = {"ok": False, "rejected": True, "reason": reason,
|
|
515
|
+
"from_node": rec.get("from_node")}
|
|
516
|
+
out.update({k: v for k, v in kw.items() if v is not None})
|
|
517
|
+
return out
|
|
518
|
+
|
|
519
|
+
|
|
520
|
+
# 生效条件:当传入 cg、src、subsystem(默认 SUBSYSTEM)、swarm、signers_file、archive(默认 True)时,依次读取 src 为 pack、_validate 校验、来源 node_id 不等于本节点、_signer.verify_for 验签成功、**签名串非空**(#453 fail-closed:空签名一律拒,不看 `sig.signer`/`sig.signed` 等对端自报值)、created_at 为有限数且不超过 now+MAX_PACK_FUTURE_SKEW 方可通过;通过则先对判据载体做一次代际探活(#403:`_maybe_reload_index`,陈旧索引下同名本地节点仍须被看见),再对 pack["items"] 前常量 MAX_ITEMS 项中 subject/text 非空者以 _identity.observe 写入(带常量 TAG_XNODE 和 SOURCE_PREFIX 标签,importance 默认 0.5,verification_basis 默认 "data"),统计 written/skipped,若 archive 为真则写包到收件箱,返回含 ok、from_node、pack_id、imported、skipped、truncated、node_ids、archived 的字典;任一拒绝分支调用 _note_reject 返回拒绝结果。
|
|
521
|
+
def _seen_path(cg) -> str:
|
|
522
|
+
"""已见台账路径(本根顶层)。cg.root 不可用时返回空串(调用方按无账处理)。"""
|
|
523
|
+
root = getattr(cg, "root", None)
|
|
524
|
+
return os.path.join(str(root), SEEN_FILE) if root else ""
|
|
525
|
+
|
|
526
|
+
|
|
527
|
+
def _load_seen(cg) -> dict:
|
|
528
|
+
"""读台账。缺文件 / 坏 JSON / 非对象一律按空账——台账是防重放,不是写入前提。"""
|
|
529
|
+
p = _seen_path(cg)
|
|
530
|
+
if not p:
|
|
531
|
+
return {}
|
|
532
|
+
try:
|
|
533
|
+
with open(p, "r", encoding="utf-8") as f:
|
|
534
|
+
data = json.load(f)
|
|
535
|
+
except (OSError, ValueError):
|
|
536
|
+
return {}
|
|
537
|
+
return data if isinstance(data, dict) else {}
|
|
538
|
+
|
|
539
|
+
|
|
540
|
+
def _save_seen(cg, seen: dict) -> None:
|
|
541
|
+
"""落盘台账。失败**不逃逸**(同上:台账不是写入前提)。"""
|
|
542
|
+
p = _seen_path(cg)
|
|
543
|
+
if not p:
|
|
544
|
+
return
|
|
545
|
+
try:
|
|
546
|
+
with open(p, "w", encoding="utf-8") as f:
|
|
547
|
+
json.dump(seen, f, ensure_ascii=False, sort_keys=True)
|
|
548
|
+
except OSError:
|
|
549
|
+
pass
|
|
550
|
+
|
|
551
|
+
|
|
552
|
+
def _import_layer(raw):
|
|
553
|
+
"""落层白名单(issue #191-A)-> (层, 是否夹紧)。非白名单层一律改落 knowledge。"""
|
|
554
|
+
layer = raw.strip() if isinstance(raw, str) else "knowledge"
|
|
555
|
+
if layer not in IMPORT_LAYERS:
|
|
556
|
+
return "knowledge", 1
|
|
557
|
+
return layer, 0
|
|
558
|
+
|
|
559
|
+
|
|
560
|
+
def _import_importance(raw):
|
|
561
|
+
"""重要度夹到 [0, IMPORT_IMPORTANCE_MAX](issue #191-A)-> (值, 是否夹紧)。
|
|
562
|
+
|
|
563
|
+
非数值 / bool / 非有限值按上限处理(与 #151 对越界值回落 0.5 同口径,但上限
|
|
564
|
+
更低——见 IMPORT_IMPORTANCE_MAX 说明)。缺省(None)沿用既有 0.5,不算夹紧。
|
|
565
|
+
"""
|
|
566
|
+
if raw is None:
|
|
567
|
+
return IMPORT_IMPORTANCE_MAX, 0
|
|
568
|
+
if isinstance(raw, bool) or not isinstance(raw, (int, float)):
|
|
569
|
+
return IMPORT_IMPORTANCE_MAX, 1
|
|
570
|
+
v = float(raw)
|
|
571
|
+
if not math.isfinite(v):
|
|
572
|
+
return IMPORT_IMPORTANCE_MAX, 1
|
|
573
|
+
if v < 0.0:
|
|
574
|
+
return 0.0, 1
|
|
575
|
+
if v > IMPORT_IMPORTANCE_MAX:
|
|
576
|
+
return IMPORT_IMPORTANCE_MAX, 1
|
|
577
|
+
return v, 0
|
|
578
|
+
|
|
579
|
+
|
|
580
|
+
def _signer_declaration_rejected(pack, signature) -> bool:
|
|
581
|
+
"""#453(站点 1):是否应**拒绝**该包的签名面(**返回 True ⇒ 拒绝**)。
|
|
582
|
+
|
|
583
|
+
判据只有一条:**签名串为空 ⇒ 拒**(fail-closed)。不看对端在 `sig` 里自称什么。
|
|
584
|
+
|
|
585
|
+
修前是豁免白名单:`if not signature and sig.signer != "null"` —— 对端写
|
|
586
|
+
`sig.signer="null"` 就让空签名绕过拒绝(形态名:**以声明值作为豁免凭据**)。
|
|
587
|
+
|
|
588
|
+
★ 为什么**不能**改成「`signed is False` 且空串 ⇒ 放行」(本单元一度出现过的写法):
|
|
589
|
+
`sig` 整块由**对端**书写,`signed` 与 `signer` 一样是自报字符串/布尔,没有任何
|
|
590
|
+
凭据把它绑定到真实封装动作。把豁免键从 `signer` 换到 `signed` 只是**换了一个
|
|
591
|
+
免签名通行证的名字**,伪造来源(`source:<任意节点>`)依旧无密钥可达——本单元
|
|
592
|
+
实测:`{"signer":"null","signature":"","signed":false}` ⇒ imported=1。
|
|
593
|
+
`export_pack` 自己产的无签名包(策略未对 evidence 签名)也因此不可导入——
|
|
594
|
+
与 issue #453 的「缺签名 ⇒ 一律拒收」及 import_pack docstring 逐字一致。
|
|
595
|
+
"""
|
|
596
|
+
return not (signature or "").strip()
|
|
597
|
+
|
|
598
|
+
|
|
599
|
+
def _local_generation_blocks(xid, prev, created) -> bool:
|
|
600
|
+
"""#403:同名的「本地」节点是否应**阻断**对端写入(**返回 True ⇒ 阻断**)。
|
|
601
|
+
|
|
602
|
+
判据 = 两条全真:① prev 存在;② 非 `xnode:cross` 跨节点证据。
|
|
603
|
+
|
|
604
|
+
★ 为什么**不**比时间戳(复核意见 3 的现场):本仓索引条目(`MdCG._node_entry`)
|
|
605
|
+
只有 `created_at`(= fm.created_at,节点**创建**时刻),**没有 `updated_at`**
|
|
606
|
+
(全仓 grep:`updated_at` 只出现在 links/refindex/self_state,不在索引条目里)。
|
|
607
|
+
拿一个不存在的键做「本地是否更新」的比较 ⇒ 分支不可达、判据恒为 True,既给
|
|
608
|
+
守卫虚假覆盖,又埋下「将来该键入索引时 #191-C 静默变成按时间比较、陈旧本地被
|
|
609
|
+
对端覆盖」的隐患。故此处**不做**代际比较——语义回到 #191-C 逐字:
|
|
610
|
+
「本根里同名的**本地**节点不得被对端覆写」。`created` 形参保留(调用点同签名、
|
|
611
|
+
判据单点仍在;将来索引真有代际键时在此一处扩展)。
|
|
612
|
+
"""
|
|
613
|
+
if prev is None:
|
|
614
|
+
return False
|
|
615
|
+
if TAG_XNODE in set(prev.get("tags") or []):
|
|
616
|
+
return False
|
|
617
|
+
return True
|
|
618
|
+
|
|
619
|
+
def import_pack(cg, src, *, subsystem: str = SUBSYSTEM, swarm: str = None,
|
|
620
|
+
signers_file: str = None, archive: bool = True) -> dict:
|
|
621
|
+
"""导入对端证据包:验签 → 落本根(带 `source:<node>` 标签)。
|
|
622
|
+
|
|
623
|
+
fail-closed:结构不合法、来源即本节点、验签失败、缺签名 → 一律拒收并留痕。
|
|
624
|
+
"""
|
|
625
|
+
try:
|
|
626
|
+
pack = _read_pack(src)
|
|
627
|
+
except (OSError, ValueError) as e:
|
|
628
|
+
return _note_reject({}, f"证据包读取失败:{e}", swarm=swarm)
|
|
629
|
+
|
|
630
|
+
err = _validate(pack)
|
|
631
|
+
if err:
|
|
632
|
+
return _note_reject(pack, err, swarm=swarm)
|
|
633
|
+
|
|
634
|
+
from_node = pack["from_node"].strip()
|
|
635
|
+
if from_node == node_id(getattr(cg, "root", None)):
|
|
636
|
+
return _note_reject(pack, "证据包来源即本节点(拒绝自导入)", swarm=swarm)
|
|
637
|
+
|
|
638
|
+
signature = ((pack.get("sig") or {}).get("signature") or "").strip()
|
|
639
|
+
vres = _signer.verify_for(subsystem, _pack_payload(pack), signature,
|
|
640
|
+
action=SIGN_ACTION, path=signers_file)
|
|
641
|
+
if not vres.get("ok"):
|
|
642
|
+
return _note_reject(pack, f"验签失败:{vres.get('reason') or '未知'}",
|
|
643
|
+
swarm=swarm, on_fail=vres.get("on_fail"))
|
|
644
|
+
# issue #453(SEC·P1):**删掉 `signer == "null"` 这个豁免**——「声明为空」曾被当成
|
|
645
|
+
# 「不要求签名」,于是对端只要在包里写 `sig.signer="null"` 就能带着空签名通过。
|
|
646
|
+
# fail-closed:声明为空 ⇒ 拒(不是跳过校验)。不改 signer.verify_for:它的
|
|
647
|
+
# 「不要求且未提供 ⇒ 放行」对其它调用方是**合法语义**,本件是**调用方该判空却没判**。
|
|
648
|
+
if _signer_declaration_rejected(pack, signature):
|
|
649
|
+
return _note_reject(pack, "证据包缺少签名(跨节点证据必须可溯源)",
|
|
650
|
+
swarm=swarm)
|
|
651
|
+
|
|
652
|
+
# issue #191-B:包版本以 `created_at` 为准。缺省按 0(只能新建、不能覆写);
|
|
653
|
+
# 非数值 / 非有限值整包拒收。
|
|
654
|
+
# issue #453(站点 2):**「在签名载荷里」不等于「对端改不了」**——站点 1 的
|
|
655
|
+
# 免签名通道下 `created_at` 完全由对端填写且原本无上界 ⇒ 一个 `9e15` 就把
|
|
656
|
+
# `_xnode_seen` 台账(跨进程持久)永久推高,之后**所有**真实时间戳的合法包都
|
|
657
|
+
# 被判 `replayed`(回执仍 `ok: true`)=永久静默屏蔽。现加**上界**:超过
|
|
658
|
+
# `now + MAX_PACK_FUTURE_SKEW` 一律整包拒收(与「非有限值整包拒收」同口径)。
|
|
659
|
+
# 站点 1 已改为「空签名一律拒」,故此处不再需要「未签名包按本地代际」的分支。
|
|
660
|
+
created = pack.get("created_at")
|
|
661
|
+
if created is None:
|
|
662
|
+
created = 0.0
|
|
663
|
+
elif (isinstance(created, bool) or not isinstance(created, (int, float))
|
|
664
|
+
or not math.isfinite(created)):
|
|
665
|
+
return _note_reject(pack, f"证据包 created_at 非法:{created!r}", swarm=swarm)
|
|
666
|
+
if created > time.time() + MAX_PACK_FUTURE_SKEW:
|
|
667
|
+
return _note_reject(
|
|
668
|
+
pack, "证据包 created_at 超出允许前偏(%r > now+%gs):拒绝未来时间戳"
|
|
669
|
+
"推进版本台账" % (created, MAX_PACK_FUTURE_SKEW), swarm=swarm)
|
|
670
|
+
seen = _load_seen(cg)
|
|
671
|
+
items = pack["items"][:MAX_ITEMS]
|
|
672
|
+
written, skipped, replayed, clamped = [], 0, 0, 0
|
|
673
|
+
#: issue #258:拒收理由留痕(此前降级**不可见**——返回体只说 imported: N)
|
|
674
|
+
reasons = []
|
|
675
|
+
# issue #403:判据载体是**本进程内存索引**;他进程(review_cli / hive worker /
|
|
676
|
+
# 第二个 MCP 实例)刚写入的本地节点不在其中 ⇒ `prev is None` ⇒ #191-C 放行 ⇒
|
|
677
|
+
# 同名本地节点被 override=True 静默顶替。进循环前先做一次代际探活
|
|
678
|
+
# (N195/N196/N209/N213/N276 同款「循环外单探」;探活失败不阻塞,沿用旧内存态)。
|
|
679
|
+
_reload = getattr(cg, "_maybe_reload_index", None)
|
|
680
|
+
if callable(_reload):
|
|
681
|
+
_reload()
|
|
682
|
+
try:
|
|
683
|
+
for it in items:
|
|
684
|
+
if not isinstance(it, dict):
|
|
685
|
+
skipped += 1
|
|
686
|
+
reasons.append("条目非字典")
|
|
687
|
+
continue
|
|
688
|
+
subj = (it.get("subject") or "").strip()
|
|
689
|
+
text = (it.get("text") or "").strip()
|
|
690
|
+
if not subj or not text:
|
|
691
|
+
skipped += 1
|
|
692
|
+
reasons.append("条目缺 subject/text")
|
|
693
|
+
continue
|
|
694
|
+
# issue #258:密级 fail-closed。缺字段/非字符串/未知档一律**不写盘**,
|
|
695
|
+
# 绝不回落到 DEFAULT_SENSITIVITY(那正是本件的病象)。旧格式包(无
|
|
696
|
+
# sensitivity)因此一律不收——**有意的行为变更**,与「跨节点证据没有
|
|
697
|
+
# 签名就不可溯源,宁可不产出」同口径。
|
|
698
|
+
sens, why = _item_sensitivity(it)
|
|
699
|
+
if why:
|
|
700
|
+
skipped += 1
|
|
701
|
+
reasons.append(why)
|
|
702
|
+
continue
|
|
703
|
+
tags = [TAG_XNODE, f"{SOURCE_PREFIX}{from_node}"]
|
|
704
|
+
tags += [t for t in (it.get("tags") or [])
|
|
705
|
+
if isinstance(t, str) and t
|
|
706
|
+
and not t.startswith("subject:")
|
|
707
|
+
and not t.startswith(SOURCE_PREFIX)
|
|
708
|
+
and t not in (TAG_XNODE, _identity.TAG_ANCHOR, _identity.TAG_TRAIT)]
|
|
709
|
+
# issue #191-A:落层白名单 + 重要度夹紧——对端声明不得自选保护级。
|
|
710
|
+
layer, c_layer = _import_layer(it.get("layer"))
|
|
711
|
+
imp, c_imp = _import_importance(it.get("importance"))
|
|
712
|
+
clamped += c_layer + c_imp
|
|
713
|
+
xid = _xnode_id(from_node, it.get("node_id") or subj)
|
|
714
|
+
# issue #191-B:旧包重放不得把新证据覆写回旧内容(含属主删除后复活)。
|
|
715
|
+
last = seen.get(xid)
|
|
716
|
+
if (isinstance(last, (int, float)) and not isinstance(last, bool)
|
|
717
|
+
and created <= last):
|
|
718
|
+
replayed += 1
|
|
719
|
+
continue
|
|
720
|
+
# issue #191-C:本根里恰好同名的**本地**节点(不带 xnode:cross 标签)不得
|
|
721
|
+
# 被对端覆写——override 只用于更新本来源自己的 xnode。
|
|
722
|
+
# issue #403(数据丢失):判据**单点**在 `_local_generation_blocks`。
|
|
723
|
+
# 修前调用点曾把同一判据**再算一遍**(`updated_at or created_at >= created`)
|
|
724
|
+
# 并据此放行,与谓词方向相反 ⇒ 谓词说「阻断」而写入照旧发生(同一真源两份
|
|
725
|
+
# 实现,形态名「判据复制」)。此处只消费谓词结果,不再自行推导。
|
|
726
|
+
prev = (cg.index.get("nodes") or {}).get(xid)
|
|
727
|
+
if _local_generation_blocks(xid, prev, created):
|
|
728
|
+
skipped += 1
|
|
729
|
+
reasons.append("同名本地节点(非跨节点证据)不覆写:%s" % xid)
|
|
730
|
+
continue
|
|
731
|
+
try:
|
|
732
|
+
_identity.observe(
|
|
733
|
+
cg, subj, text,
|
|
734
|
+
kind=it.get("kind"), role=it.get("role"),
|
|
735
|
+
layer=layer,
|
|
736
|
+
tags=tags,
|
|
737
|
+
importance=imp,
|
|
738
|
+
verification_basis=it.get("verification_basis") or "data",
|
|
739
|
+
node_id=xid,
|
|
740
|
+
sensitivity=sens,
|
|
741
|
+
override=True)
|
|
742
|
+
except _AccessDenied:
|
|
743
|
+
# issue #258:导入方密级不足 ⇒ **跳过,不降级落盘**(此前会落到
|
|
744
|
+
# 缺省 internal,等于把对端的 private 洗成 internal)。
|
|
745
|
+
skipped += 1
|
|
746
|
+
reasons.append("本节点密级不足(sensitivity=%s)" % sens)
|
|
747
|
+
continue
|
|
748
|
+
written.append(xid)
|
|
749
|
+
seen[xid] = created
|
|
750
|
+
|
|
751
|
+
finally:
|
|
752
|
+
_save_seen(cg, seen)
|
|
753
|
+
|
|
754
|
+
archived = ""
|
|
755
|
+
archive_skipped = ""
|
|
756
|
+
if archive:
|
|
757
|
+
# issue #258:归档是**明文 JSON**,包内含加密档(private/secret)时
|
|
758
|
+
# 再落一份到收件箱等于绕过 ENCRYPTED_LEVELS ⇒ 不归档并给出理由。
|
|
759
|
+
sealed = sorted({it.get("sensitivity") for it in items
|
|
760
|
+
if isinstance(it, dict)
|
|
761
|
+
and _crypto.is_encrypted_level(it.get("sensitivity"))})
|
|
762
|
+
if sealed:
|
|
763
|
+
archive_skipped = ("包内含加密档 %s:归档为明文 JSON,"
|
|
764
|
+
"跳过以免绕过落盘加密" % "、".join(sealed))
|
|
765
|
+
else:
|
|
766
|
+
try:
|
|
767
|
+
archived = write_pack(pack, swarm=swarm)["file"]
|
|
768
|
+
except (OSError, EvidenceError):
|
|
769
|
+
# issue #147:归档越界(EvidenceError,realpath 兜底)与写盘
|
|
770
|
+
# 失败同等处理——**不逃逸**。修前只捕 OSError:pack_id 带空
|
|
771
|
+
# 字节时 open()/realpath 抛的 ValueError 会**逸出
|
|
772
|
+
# import_pack**(实测),调用方只见崩溃且无留痕;现一并收口。
|
|
773
|
+
archived = ""
|
|
774
|
+
return {"ok": True, "from_node": from_node, "pack_id": pack.get("pack_id"),
|
|
775
|
+
"imported": len(written), "skipped": skipped,
|
|
776
|
+
# issue #191:被夹紧的条目数(层 / 重要度)与因旧包重放而跳过的条目数。
|
|
777
|
+
# 此前返回体只说 imported: N,看不出落了哪一层、也没提示重放。
|
|
778
|
+
"clamped": clamped, "replayed": replayed,
|
|
779
|
+
"truncated": len(pack["items"]) > MAX_ITEMS,
|
|
780
|
+
"node_ids": written, "archived": archived,
|
|
781
|
+
# issue #258:拒收理由(封顶 20 条,防灌包刷屏)+ 归档跳过理由
|
|
782
|
+
"skipped_reasons": reasons[:20],
|
|
783
|
+
"archive_skipped": archive_skipped}
|
|
784
|
+
|
|
785
|
+
|
|
786
|
+
# --------------------------------------------------------------------------
|
|
787
|
+
# 查询
|
|
788
|
+
# --------------------------------------------------------------------------
|
|
789
|
+
|
|
790
|
+
# 生效条件:当传入 cg、subject、source、limit(默认 100)时,收集标签含常量 TAG_XNODE 的节点,若 subject 为真则仅保留 subject 标签等于 subject 的节点,若 source 为真则仅保留 source 标签等于 source 的节点,返回最后 int(limit or 100) 条记录(limit 为假值如 0 时取 100)的 count 与列表。
|
|
791
|
+
def evidence(cg, *, subject: str = None, source: str = None,
|
|
792
|
+
limit: int = 100) -> dict:
|
|
793
|
+
"""列本根已导入的跨节点证据(按来源/主体过滤)。"""
|
|
794
|
+
out = []
|
|
795
|
+
nodes = cg.index.get("nodes") or {}
|
|
796
|
+
for nid in sorted(nodes):
|
|
797
|
+
e = nodes[nid]
|
|
798
|
+
tg = set(e.get("tags") or [])
|
|
799
|
+
if TAG_XNODE not in tg:
|
|
800
|
+
continue
|
|
801
|
+
subj, src = "", ""
|
|
802
|
+
for t in tg:
|
|
803
|
+
if isinstance(t, str) and t.startswith("subject:"):
|
|
804
|
+
subj = t[len("subject:"):]
|
|
805
|
+
elif isinstance(t, str) and t.startswith(SOURCE_PREFIX):
|
|
806
|
+
src = t[len(SOURCE_PREFIX):]
|
|
807
|
+
if subject and subj != subject:
|
|
808
|
+
continue
|
|
809
|
+
if source and src != source:
|
|
810
|
+
continue
|
|
811
|
+
node = cg.get(nid) or {}
|
|
812
|
+
out.append({"node_id": nid, "subject": subj, "source": src,
|
|
813
|
+
"layer": e.get("layer"),
|
|
814
|
+
"content": (node.get("content") or "")[:400]})
|
|
815
|
+
out = out[-int(limit or 100):]
|
|
816
|
+
return {"count": len(out), "evidence": out}
|
|
817
|
+
|
|
818
|
+
|
|
819
|
+
# 生效条件:无参数调用时返回包含模块级常量 SUBSYSTEM、SIGN_ACTION、SWARM_DIR_ENV、NODE_ID_ENV、ROOT_ENV、MAX_ITEMS、MAX_TEXT 及 swarm_dir() 等字段的自描述字典。
|
|
820
|
+
def catalog() -> dict:
|
|
821
|
+
return {
|
|
822
|
+
"layer": "跨节点证据存储(蜂群互联 v0.3)",
|
|
823
|
+
"question": "跨节点:你凭什么这么说",
|
|
824
|
+
"blindspot": "§9.1 单根假设——对端观测对本节点不可见",
|
|
825
|
+
"invariants": ["来源可溯", "可拒收", "全程留痕", "禁止转手"],
|
|
826
|
+
"subsystem": SUBSYSTEM,
|
|
827
|
+
"sign_action": SIGN_ACTION,
|
|
828
|
+
"swarm_dir": swarm_dir(),
|
|
829
|
+
"pack_fields": list(_PACK_FIELDS),
|
|
830
|
+
"limits": {"max_items": MAX_ITEMS, "max_text": MAX_TEXT},
|
|
831
|
+
"env": {"node_id": NODE_ID_ENV, "swarm_dir": SWARM_DIR_ENV,
|
|
832
|
+
"root": ROOT_ENV},
|
|
833
|
+
"honest_boundary": "验证的是「证据来自该节点」,不是「证据为真」",
|
|
834
|
+
}
|
|
835
|
+
|
|
836
|
+
|
|
837
|
+
# --------------------------------------------------------------------------
|
|
838
|
+
# 工具
|
|
839
|
+
# --------------------------------------------------------------------------
|
|
840
|
+
|
|
841
|
+
# 生效条件:当传入 path 和 obj 时,在 path 所在目录(若 dirname 为空则 ".")创建目录,将 obj 以 JSON 写入 path+".tmp"(ensure_ascii=False, indent=1, sort_keys=True),尝试 chmod 0600,替换到 path,返回 path。
|
|
842
|
+
def _write_json(path: str, obj) -> str:
|
|
843
|
+
os.makedirs(os.path.dirname(path) or ".", exist_ok=True)
|
|
844
|
+
tmp = path + ".tmp"
|
|
845
|
+
with open(tmp, "w", encoding="utf-8") as f:
|
|
846
|
+
json.dump(obj, f, ensure_ascii=False, indent=1, sort_keys=True)
|
|
847
|
+
try:
|
|
848
|
+
os.chmod(tmp, 0o600)
|
|
849
|
+
except OSError:
|
|
850
|
+
pass
|
|
851
|
+
publish(tmp, path)
|
|
852
|
+
return path
|
|
853
|
+
|
|
854
|
+
|
|
855
|
+
# 生效条件:当传入 root 且 _root_of(root) 返回真值时,以 designer 角色 Principal(tenant 取 os.environ.get("MDCG_TENANT", "default") 的实际值,actor 取 os.environ.get("MDCG_ACTOR", "swarm-cli") 的实际值)打开 MdCGSecure;否则抛出 EvidenceError。
|
|
856
|
+
def _open_cg(root: str = None):
|
|
857
|
+
"""CLI 用:以 designer 身份打开根(令牌路径仍推荐走 MCP)。"""
|
|
858
|
+
from .mdcos import MdCGSecure
|
|
859
|
+
from .security import Principal
|
|
860
|
+
from .tokens import role_spec
|
|
861
|
+
r = _root_of(root)
|
|
862
|
+
if not r:
|
|
863
|
+
raise EvidenceError("缺少根目录:请设 MDCG_ROOT 或传 --root")
|
|
864
|
+
spec = role_spec("designer")
|
|
865
|
+
p = Principal(tenant=os.environ.get("MDCG_TENANT", "default"),
|
|
866
|
+
actor=os.environ.get("MDCG_ACTOR", "swarm-cli"),
|
|
867
|
+
clearance="private", can_write=True, can_admin=True,
|
|
868
|
+
role="designer", layers_allow=spec["layers_allow"],
|
|
869
|
+
ops_allow=spec["ops_allow"], auth_mode="legacy_env")
|
|
870
|
+
# autoflush=1(P1b,2026-09-26,与 mcp_server.py:3695-3702 / review_cli._cg
|
|
871
|
+
# 同款):短命工具进程被 kill 时 close/atexit 兜底不执行,缺省 64 会让
|
|
872
|
+
# 写入停在内存 _dirty、分片日志从未落——逐条落日志保任意退出形态跨进程可见。
|
|
873
|
+
return MdCGSecure(r, principal=p, autoflush=1)
|
|
874
|
+
|
|
875
|
+
|
|
876
|
+
# 生效条件:当传入 obj 时,打印 json.dumps(obj, ensure_ascii=False, indent=1, default=str)。
|
|
877
|
+
def _print(obj):
|
|
878
|
+
print(json.dumps(obj, ensure_ascii=False, indent=1, default=str))
|
|
879
|
+
|
|
880
|
+
|
|
881
|
+
# 生效条件:argv 为 None 时取 sys.argv[1:];经 argparse 解析后必填子命令(catalog/card/export/import 等)之一,参数缺失或非法由 argparse 直接退出;返回进程退出码;
|
|
882
|
+
def main(argv=None):
|
|
883
|
+
ap = argparse.ArgumentParser(
|
|
884
|
+
prog="python -m md_cg.evidence",
|
|
885
|
+
description="跨节点证据存储:名片 / 导出 / 导入(v0.3)")
|
|
886
|
+
ap.add_argument("--root", default=None, help="认知图根(默认 MDCG_ROOT)")
|
|
887
|
+
ap.add_argument("--swarm", default=None, help="共享目录(默认 ~/.mdcg/swarm)")
|
|
888
|
+
ap.add_argument("--signers-file", default=None)
|
|
889
|
+
sub = ap.add_subparsers(dest="cmd", required=True)
|
|
890
|
+
|
|
891
|
+
sub.add_parser("catalog", help="自描述")
|
|
892
|
+
sub.add_parser("card", help="本节点名片")
|
|
893
|
+
sub.add_parser("publish", help="发布名片到共享目录")
|
|
894
|
+
sub.add_parser("peers", help="发现对端名片")
|
|
895
|
+
|
|
896
|
+
p_ex = sub.add_parser("export", help="导出证据包")
|
|
897
|
+
p_ex.add_argument("--subject", action="append", default=None)
|
|
898
|
+
p_ex.add_argument("--out", default=None, help="输出文件(默认写收件箱)")
|
|
899
|
+
|
|
900
|
+
p_im = sub.add_parser("import", help="导入证据包")
|
|
901
|
+
p_im.add_argument("path")
|
|
902
|
+
|
|
903
|
+
p_ls = sub.add_parser("ls", help="列已导入的跨节点证据")
|
|
904
|
+
p_ls.add_argument("--subject", default=None)
|
|
905
|
+
p_ls.add_argument("--source", default=None)
|
|
906
|
+
p_ls.add_argument("--limit", type=int, default=100)
|
|
907
|
+
|
|
908
|
+
a = ap.parse_args(argv)
|
|
909
|
+
cg = None
|
|
910
|
+
try:
|
|
911
|
+
if a.cmd == "catalog":
|
|
912
|
+
_print(catalog())
|
|
913
|
+
elif a.cmd == "card":
|
|
914
|
+
_print(card(a.root, signers_file=a.signers_file))
|
|
915
|
+
elif a.cmd == "publish":
|
|
916
|
+
_print(publish_card(a.root, swarm=a.swarm,
|
|
917
|
+
signers_file=a.signers_file))
|
|
918
|
+
elif a.cmd == "peers":
|
|
919
|
+
_print(peers(a.swarm, root=a.root))
|
|
920
|
+
elif a.cmd == "export":
|
|
921
|
+
cg = _open_cg(a.root)
|
|
922
|
+
res = export_pack(cg, subjects=a.subject, swarm=a.swarm,
|
|
923
|
+
signers_file=a.signers_file)
|
|
924
|
+
_print(write_pack(res["pack"], path=a.out, swarm=a.swarm)
|
|
925
|
+
if a.out else res)
|
|
926
|
+
elif a.cmd == "import":
|
|
927
|
+
cg = _open_cg(a.root)
|
|
928
|
+
_print(import_pack(cg, a.path, swarm=a.swarm,
|
|
929
|
+
signers_file=a.signers_file))
|
|
930
|
+
elif a.cmd == "ls":
|
|
931
|
+
cg = _open_cg(a.root)
|
|
932
|
+
_print(evidence(cg, subject=a.subject, source=a.source,
|
|
933
|
+
limit=a.limit))
|
|
934
|
+
except (EvidenceError, _signer.SignerError) as e:
|
|
935
|
+
print(f"[md_cg.evidence] {e}", file=sys.stderr)
|
|
936
|
+
return 2
|
|
937
|
+
finally:
|
|
938
|
+
if cg is not None:
|
|
939
|
+
try:
|
|
940
|
+
cg.close() # 落盘索引,保证跨进程可见
|
|
941
|
+
except Exception: # noqa: BLE001 —— 关闭失败不掩盖主流程结果
|
|
942
|
+
pass
|
|
943
|
+
return 0
|
|
944
|
+
|
|
945
|
+
|
|
946
|
+
if __name__ == "__main__":
|
|
586
947
|
sys.exit(main())
|