@furongjun1999/dsh-memory 0.8.0 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +662 -632
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -5417
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. 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
  531. 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
  532. 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
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  534. 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
  535. 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
  536. 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
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. 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
  539. 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
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. 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
  543. 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
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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 -152
  573. 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
  574. 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
  575. 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
  576. 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
  577. 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
  578. 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
  579. 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
  580. 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
  581. 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
  582. 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
  583. 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
  584. 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
  585. 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
  586. 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
  587. 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
  588. 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
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. 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
  618. 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
  619. 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
  620. 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
  621. 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
  622. 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
  623. 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
  624. 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
  625. 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
  626. 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
  627. 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
  628. 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
  629. 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
  630. 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
  631. 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
  632. 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
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. 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
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. 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
  647. 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
  648. 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
  649. 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
  650. 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
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. 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
  653. 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
  654. 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
  655. 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
  656. 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
  657. 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
  658. 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
  659. 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
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. 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
  662. 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
  663. 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
  664. 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
  665. 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
  666. 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
  667. 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
  668. 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
  669. 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
  670. 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
  671. 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
  672. 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
  673. 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
  674. 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
  675. 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
  676. 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
  677. 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
  678. 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
  679. 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
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. 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
  688. 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
  689. 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
  690. 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
  691. 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
  692. 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
  693. 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
  694. 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
  695. 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
  696. 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
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. 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
  699. 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
  700. 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
  701. 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
  702. 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
  703. 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
  704. 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
  705. 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
  706. 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
  707. 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
  708. 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
  709. 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
  710. 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
  711. 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
  712. 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
  713. 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
  714. 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 os
31
- import sys
32
- import time
33
-
34
- from . import identity as _identity
35
- from . import signer as _signer
36
- from .datapath import aux_root
37
- from .fsutil import publish
38
-
39
- NODE_ID_ENV = "MDCG_NODE_ID"
40
- SWARM_DIR_ENV = "MDCG_SWARM_DIR"
41
- ROOT_ENV = "MDCG_ROOT"
42
-
43
- DEFAULT_DIR = aux_root()
44
- DEFAULT_SWARM_DIR = os.path.join(DEFAULT_DIR, "swarm")
45
-
46
- SUBSYSTEM = "swarm" # 子系统名:智能体可对它声明签名策略(D-4)
47
- SIGN_ACTION = "evidence"
48
- SCHEMA = 1
49
- KIND = "mdcg.evidence.pack"
50
- CARD_KIND = "mdcg.node.card"
51
-
52
- TAG_XNODE = "xnode:cross"
53
- SOURCE_PREFIX = "source:"
54
-
55
- MAX_ITEMS = 500 # 单包条目上限(防灌包)
56
- MAX_TEXT = 4000 # 单条正文上限
57
-
58
-
59
- class EvidenceError(Exception):
60
- """跨节点证据层错误(fail-closed)。"""
61
-
62
-
63
- # --------------------------------------------------------------------------
64
- # 路径与身份
65
- # --------------------------------------------------------------------------
66
-
67
- # 生效条件:当传入 path 为真值时返回 path;否则若环境变量 SWARM_DIR_ENV 为真值则返回其值;否则返回模块级常量 DEFAULT_SWARM_DIR。
68
- def swarm_dir(path: str = None) -> str:
69
- return path or os.environ.get(SWARM_DIR_ENV) or DEFAULT_SWARM_DIR
70
-
71
-
72
- # 生效条件:当传入 swarm 参数(假值回落到 swarm_dir 的默认逻辑)时,返回 os.path.join(swarm_dir(swarm), "peers")。
73
- def peers_dir(swarm: str = None) -> str:
74
- return os.path.join(swarm_dir(swarm), "peers")
75
-
76
-
77
- # 生效条件:当传入 swarm 参数(假值回落到 swarm_dir 的默认逻辑)时,返回 os.path.join(swarm_dir(swarm), "inbox")。
78
- def inbox_dir(swarm: str = None) -> str:
79
- return os.path.join(swarm_dir(swarm), "inbox")
80
-
81
-
82
- # 生效条件:当传入 root 为真值时返回 root;否则返回环境变量 ROOT_ENV 的值(可能为 None)。
83
- def _root_of(root: str = None) -> str:
84
- return root or os.environ.get(ROOT_ENV)
85
-
86
-
87
- # 生效条件:当 explicit 或环境变量 NODE_ID_ENV strip 后非空时返回该值;否则若 _root_of(root) 返回真值,返回基于规范绝对路径的 'node-<12hex>';否则抛出 EvidenceError。
88
- def node_id(root: str = None, explicit: str = None) -> str:
89
- """本节点身份。
90
-
91
- 优先 `MDCG_NODE_ID`(生产环境应显式设置,保证跨机器稳定);
92
- 缺省从根路径派生 `node-<12hex>`(同机可复现,跨机器不保证唯一)。
93
- """
94
- nid = (explicit or os.environ.get(NODE_ID_ENV) or "").strip()
95
- if nid:
96
- return nid
97
- r = _root_of(root)
98
- if not r:
99
- raise EvidenceError(
100
- "无法确定节点身份:请设 MDCG_NODE_ID(推荐)或 MDCG_ROOT")
101
- key = os.path.normcase(os.path.abspath(r))
102
- return "node-" + hashlib.sha256(key.encode("utf-8")).hexdigest()[:12]
103
-
104
-
105
- # 生效条件:包内 md_cg.theory 可导入且 _th.check() 成功时返回 {version, accepted, theory_ok};任何异常(版本层缺失或校验失败)一律吞掉返回 {},不阻断证据层主流程;
106
- def _theory_state() -> dict:
107
- try:
108
- from . import theory as _th
109
- st = _th.check()
110
- return {"version": st.get("version"),
111
- "accepted": list(st.get("accepted_versions") or []),
112
- "theory_ok": bool(st.get("theory_ok"))}
113
- except Exception: # 版本层缺失不阻断证据层
114
- return {}
115
-
116
-
117
- # 生效条件:当传入 obj 时,返回其 json.dumps(obj, ensure_ascii=False, sort_keys=True, separators=(',',':')).encode("utf-8") 字节。
118
- def _canon(obj) -> bytes:
119
- return json.dumps(obj, ensure_ascii=False, sort_keys=True,
120
- separators=(",", ":")).encode("utf-8")
121
-
122
-
123
- # 生效条件:当传入 s 时,返回 str(s) 中每个字符若为字母数字或 '_' '-' 则保留,否则替换为 '_' 的字符串。
124
- def _slug(s) -> str:
125
- return "".join(ch if (ch.isalnum() or ch in "_-") else "_" for ch in str(s))
126
-
127
-
128
- # --------------------------------------------------------------------------
129
- # 节点名片(发现)
130
- # --------------------------------------------------------------------------
131
-
132
- # 生效条件:当传入 root、subsystem(默认常量 SUBSYSTEM)、signers_file 时,基于 _signer.policy_for 和 _signer.get_signer 返回名片字典,其中 root 为 os.path.abspath(_root_of(root)) 若 _root_of(root) 真值否则 None。
133
- def card(root: str = None, *, subsystem: str = SUBSYSTEM,
134
- signers_file: str = None) -> dict:
135
- """本节点名片:身份 + 版本 + 签名器公开信息(**不含密钥**)。"""
136
- pol = _signer.policy_for(subsystem, signers_file)
137
- s = _signer.get_signer(pol.get("signer"))
138
- r = _root_of(root)
139
- return {
140
- "schema": SCHEMA, "kind": CARD_KIND,
141
- "node_id": node_id(root),
142
- "root": os.path.abspath(r) if r else None,
143
- "theory": _theory_state(),
144
- "signer": s.public(),
145
- "subsystem": subsystem,
146
- "policy": {"sign_on": list(pol.get("sign_on") or []),
147
- "require_peer_signature": bool(pol.get("require_peer_signature")),
148
- "on_verify_fail": pol.get("on_verify_fail")},
149
- "created_at": time.time(),
150
- }
151
-
152
-
153
- # 生效条件:当传入 root、swarm、subsystem(默认常量 SUBSYSTEM)、signers_file 时,调用 card 得到 c,将 c 以 JSON 写入 peers_dir(swarm)/<c["node_id"]>.json,返回 {"ok": True, "file": p, "card": c}。
154
- def publish_card(root: str = None, *, swarm: str = None,
155
- subsystem: str = SUBSYSTEM, signers_file: str = None) -> dict:
156
- """把本节点名片写入共享目录 `peers/<node_id>.json`(0600)。"""
157
- c = card(root, subsystem=subsystem, signers_file=signers_file)
158
- p = os.path.join(peers_dir(swarm), c["node_id"] + ".json")
159
- _write_json(p, c)
160
- return {"ok": True, "file": p, "card": c}
161
-
162
-
163
- # 生效条件:当 peers_dir(swarm) 是目录时,遍历其中 .json 文件,加载为 dict 且 kind 等于常量 CARD_KIND 的名片,若 exclude_self 为真则排除 node_id 等于 node_id(root) 的名片(node_id(root) 抛 EvidenceError 时 self_id 为 None 不排除),返回按文件名排序的列表及计数;目录不存在则返回空列表。
164
- def peers(swarm: str = None, *, exclude_self: bool = True,
165
- root: str = None) -> dict:
166
- """发现共享目录里的对端名片(按 node_id 排序)。"""
167
- d = peers_dir(swarm)
168
- out, self_id = [], None
169
- if exclude_self:
170
- try:
171
- self_id = node_id(root)
172
- except EvidenceError:
173
- self_id = None
174
- if os.path.isdir(d):
175
- for fn in sorted(os.listdir(d)):
176
- if not fn.endswith(".json"):
177
- continue
178
- try:
179
- with open(os.path.join(d, fn), "r", encoding="utf-8") as f:
180
- c = json.load(f)
181
- except (OSError, ValueError):
182
- continue
183
- if not isinstance(c, dict) or c.get("kind") != CARD_KIND:
184
- continue
185
- if self_id and c.get("node_id") == self_id:
186
- continue
187
- out.append(c)
188
- return {"dir": d, "count": len(out), "peers": out}
189
-
190
-
191
- # --------------------------------------------------------------------------
192
- # 证据包:导出
193
- # --------------------------------------------------------------------------
194
-
195
- _PACK_FIELDS = ("schema", "kind", "pack_id", "from_node", "from_root",
196
- "theory", "created_at", "subjects", "items")
197
-
198
-
199
- # 生效条件:当传入 pack 字典时,返回仅含模块级常量 _PACK_FIELDS 中字段(缺失字段取 pack.get(k) 得到 None)的规范化 JSON 字节。
200
- def _pack_payload(pack: dict) -> bytes:
201
- """签名载荷:固定字段 + 排序序列化,同参数必同字节。"""
202
- body = {}
203
- for k in _PACK_FIELDS:
204
- body[k] = pack.get(k)
205
- return _canon(body)
206
-
207
-
208
- # 生效条件:当传入 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 的列表。
209
- def _collect(cg, subjects=None, since=None) -> list:
210
- """收集本根**本地原始**观测证据(排除档案节点与已导入的跨节点证据)。"""
211
- want = set(subjects or [])
212
- items = []
213
- nodes = cg.index.get("nodes") or {}
214
- for nid in sorted(nodes):
215
- e = nodes[nid]
216
- tg = set(e.get("tags") or [])
217
- if _identity.TAG_OBS not in tg:
218
- continue
219
- if tg & {_identity.TAG_ANCHOR, _identity.TAG_TRAIT}:
220
- continue
221
- if TAG_XNODE in tg: # 禁止转手(防洗证据)
222
- continue
223
- subj = ""
224
- for t in tg:
225
- if isinstance(t, str) and t.startswith("subject:"):
226
- subj = t[len("subject:"):]
227
- break
228
- if not subj or (want and subj not in want):
229
- continue
230
- node = cg.get(nid) or {}
231
- fm = node.get("frontmatter") or {}
232
- ts = fm.get("ts") or fm.get("created_at") or e.get("ts") or 0
233
- if since and ts and float(ts) < float(since):
234
- continue
235
- items.append({
236
- "node_id": nid,
237
- "subject": subj,
238
- "text": (node.get("content") or "")[:MAX_TEXT],
239
- "kind": fm.get("kind"),
240
- "role": fm.get("role"),
241
- "layer": e.get("layer"),
242
- "tags": sorted(t for t in tg
243
- if isinstance(t, str)
244
- and not t.startswith("subject:")
245
- and not t.startswith(SOURCE_PREFIX)
246
- and t != TAG_XNODE),
247
- "importance": fm.get("importance"),
248
- "verification_basis": (e.get("verification_basis")
249
- or fm.get("verification_basis")),
250
- "ts": ts,
251
- })
252
- return items
253
-
254
-
255
- # 生效条件:当传入 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 的字典。
256
- def export_pack(cg, *, subjects=None, since=None, swarm: str = None,
257
- subsystem: str = SUBSYSTEM, signers_file: str = None,
258
- require_signature: bool = True) -> dict:
259
- """导出本节点对(指定)主体的观测证据包,并签名。
260
-
261
- `require_signature=True`(默认):策略未对 `evidence` 签名即抛错——
262
- 跨节点证据没有签名就不可溯源,宁可不产出。
263
- """
264
- items = _collect(cg, subjects=subjects, since=since)
265
- truncated = len(items) > MAX_ITEMS
266
- items = items[:MAX_ITEMS]
267
- nid = node_id(getattr(cg, "root", None))
268
- pack = {
269
- "schema": SCHEMA, "kind": KIND,
270
- "from_node": nid,
271
- "from_root": os.path.abspath(getattr(cg, "root", "") or ""),
272
- "theory": _theory_state(),
273
- "created_at": time.time(),
274
- "subjects": sorted(set(subjects or [])),
275
- "items": items,
276
- }
277
- pid = hashlib.sha256(_canon({"n": nid, "t": pack["created_at"],
278
- "c": len(items)})).hexdigest()[:12]
279
- pack["pack_id"] = "pack-" + pid
280
-
281
- sigres = _signer.sign_for(subsystem, _pack_payload(pack),
282
- action=SIGN_ACTION, path=signers_file)
283
- pack["sig"] = {"signer": sigres.get("signer"),
284
- "signature": sigres.get("signature") or "",
285
- "signed": bool(sigres.get("signed"))}
286
- if require_signature and not pack["sig"]["signed"]:
287
- raise EvidenceError(
288
- f"子系统 {subsystem} 策略未对 {SIGN_ACTION} 签名,证据包不可溯源。"
289
- f"请先声明:set_policy({subsystem!r}, sign_on=['handshake','{SIGN_ACTION}'])")
290
- return {"ok": True, "pack": pack, "count": len(items),
291
- "truncated": truncated, "signed": pack["sig"]["signed"]}
292
-
293
-
294
- # 生效条件:当传入 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}。
295
- def write_pack(pack: dict, path: str = None, swarm: str = None) -> dict:
296
- """把证据包落盘到收件箱(或指定路径)。"""
297
- if not path:
298
- path = os.path.join(inbox_dir(swarm),
299
- f"{_slug(pack.get('from_node'))}__{pack.get('pack_id')}.json")
300
- _write_json(path, pack)
301
- return {"ok": True, "file": path}
302
-
303
-
304
- # --------------------------------------------------------------------------
305
- # 证据包:导入
306
- # --------------------------------------------------------------------------
307
-
308
- # 生效条件:当 src 是 dict 时直接返回 src;否则以 src 为路径打开 JSON 文件并返回 json.load(f)。
309
- def _read_pack(src) -> dict:
310
- if isinstance(src, dict):
311
- return src
312
- with open(src, "r", encoding="utf-8") as f:
313
- return json.load(f)
314
-
315
-
316
- # 生效条件:当 pack 为 dict 且 kind 等于常量 KIND、int(pack.get("schema") or 0) 不大于常量 SCHEMA、from_node strip 后非空、items 为 list 时返回空字符串;否则按序返回对应错误字符串(非 dict、kind 不符、schema 过新、缺 from_node、缺 items)。
317
- def _validate(pack: dict) -> str:
318
- if not isinstance(pack, dict):
319
- return "证据包不是 JSON 对象"
320
- if pack.get("kind") != KIND:
321
- return f"不是证据包(kind={pack.get('kind')!r})"
322
- if int(pack.get("schema") or 0) > SCHEMA:
323
- return f"证据包 schema 过新:{pack.get('schema')} > {SCHEMA}"
324
- if not (pack.get("from_node") or "").strip():
325
- return "证据包缺少 from_node(来源不可溯)"
326
- if not isinstance(pack.get("items"), list):
327
- return "证据包缺少 items"
328
- return ""
329
-
330
-
331
- # 生效条件:当传入 from_node 和 orig 时,返回 f"xnode_{_slug(from_node)}_{_slug(orig)}"。
332
- def _xnode_id(from_node: str, orig: str) -> str:
333
- return f"xnode_{_slug(from_node)}_{_slug(orig)}"
334
-
335
-
336
- # 生效条件:当传入 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 项。
337
- def _note_reject(pack: dict, reason: str, swarm: str = None, **kw) -> dict:
338
- rec = {"at": time.time(), "reason": reason,
339
- "from_node": (pack or {}).get("from_node"),
340
- "pack_id": (pack or {}).get("pack_id")}
341
- rec.update({k: v for k, v in kw.items() if v is not None})
342
- try:
343
- from .fsutil import append_jsonl
344
- os.makedirs(inbox_dir(swarm), exist_ok=True)
345
- append_jsonl(os.path.join(inbox_dir(swarm), "_rejected.jsonl"), rec)
346
- except OSError:
347
- pass
348
- out = {"ok": False, "rejected": True, "reason": reason,
349
- "from_node": rec.get("from_node")}
350
- out.update({k: v for k, v in kw.items() if v is not None})
351
- return out
352
-
353
-
354
- # 生效条件:当传入 cg、src、subsystem(默认 SUBSYSTEM)、swarm、signers_file、archive(默认 True)时,依次读取 src 为 pack、_validate 校验、来源 node_id 不等于本节点、_signer.verify_for 验签成功、且有签名或 signer 等于 "null" 方可通过;通过则对 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 返回拒绝结果。
355
- def import_pack(cg, src, *, subsystem: str = SUBSYSTEM, swarm: str = None,
356
- signers_file: str = None, archive: bool = True) -> dict:
357
- """导入对端证据包:验签 → 落本根(带 `source:<node>` 标签)。
358
-
359
- fail-closed:结构不合法、来源即本节点、验签失败、缺签名 → 一律拒收并留痕。
360
- """
361
- try:
362
- pack = _read_pack(src)
363
- except (OSError, ValueError) as e:
364
- return _note_reject({}, f"证据包读取失败:{e}", swarm=swarm)
365
-
366
- err = _validate(pack)
367
- if err:
368
- return _note_reject(pack, err, swarm=swarm)
369
-
370
- from_node = pack["from_node"].strip()
371
- if from_node == node_id(getattr(cg, "root", None)):
372
- return _note_reject(pack, "证据包来源即本节点(拒绝自导入)", swarm=swarm)
373
-
374
- signature = ((pack.get("sig") or {}).get("signature") or "").strip()
375
- vres = _signer.verify_for(subsystem, _pack_payload(pack), signature,
376
- action=SIGN_ACTION, path=signers_file)
377
- if not vres.get("ok"):
378
- return _note_reject(pack, f"验签失败:{vres.get('reason') or '未知'}",
379
- swarm=swarm, on_fail=vres.get("on_fail"))
380
- if not signature and (pack.get("sig") or {}).get("signer") != "null":
381
- return _note_reject(pack, "证据包缺少签名(跨节点证据必须可溯源)",
382
- swarm=swarm)
383
-
384
- items = pack["items"][:MAX_ITEMS]
385
- written, skipped = [], 0
386
- for it in items:
387
- if not isinstance(it, dict):
388
- skipped += 1
389
- continue
390
- subj = (it.get("subject") or "").strip()
391
- text = (it.get("text") or "").strip()
392
- if not subj or not text:
393
- skipped += 1
394
- continue
395
- tags = [TAG_XNODE, f"{SOURCE_PREFIX}{from_node}"]
396
- tags += [t for t in (it.get("tags") or [])
397
- if isinstance(t, str) and t
398
- and not t.startswith("subject:")
399
- and not t.startswith(SOURCE_PREFIX)
400
- and t not in (TAG_XNODE, _identity.TAG_ANCHOR, _identity.TAG_TRAIT)]
401
- imp = it.get("importance")
402
- _identity.observe(
403
- cg, subj, text,
404
- kind=it.get("kind"), role=it.get("role"),
405
- layer=it.get("layer") or "knowledge",
406
- tags=tags,
407
- importance=0.5 if imp is None else imp,
408
- verification_basis=it.get("verification_basis") or "data",
409
- node_id=_xnode_id(from_node, it.get("node_id") or subj),
410
- override=True)
411
- written.append(_xnode_id(from_node, it.get("node_id") or subj))
412
-
413
- archived = ""
414
- if archive:
415
- try:
416
- archived = write_pack(pack, swarm=swarm)["file"]
417
- except OSError:
418
- archived = ""
419
- return {"ok": True, "from_node": from_node, "pack_id": pack.get("pack_id"),
420
- "imported": len(written), "skipped": skipped,
421
- "truncated": len(pack["items"]) > MAX_ITEMS,
422
- "node_ids": written, "archived": archived}
423
-
424
-
425
- # --------------------------------------------------------------------------
426
- # 查询
427
- # --------------------------------------------------------------------------
428
-
429
- # 生效条件:当传入 cg、subject、source、limit(默认 100)时,收集标签含常量 TAG_XNODE 的节点,若 subject 为真则仅保留 subject 标签等于 subject 的节点,若 source 为真则仅保留 source 标签等于 source 的节点,返回最后 int(limit or 100) 条记录(limit 为假值如 0 时取 100)的 count 与列表。
430
- def evidence(cg, *, subject: str = None, source: str = None,
431
- limit: int = 100) -> dict:
432
- """列本根已导入的跨节点证据(按来源/主体过滤)。"""
433
- out = []
434
- nodes = cg.index.get("nodes") or {}
435
- for nid in sorted(nodes):
436
- e = nodes[nid]
437
- tg = set(e.get("tags") or [])
438
- if TAG_XNODE not in tg:
439
- continue
440
- subj, src = "", ""
441
- for t in tg:
442
- if isinstance(t, str) and t.startswith("subject:"):
443
- subj = t[len("subject:"):]
444
- elif isinstance(t, str) and t.startswith(SOURCE_PREFIX):
445
- src = t[len(SOURCE_PREFIX):]
446
- if subject and subj != subject:
447
- continue
448
- if source and src != source:
449
- continue
450
- node = cg.get(nid) or {}
451
- out.append({"node_id": nid, "subject": subj, "source": src,
452
- "layer": e.get("layer"),
453
- "content": (node.get("content") or "")[:400]})
454
- out = out[-int(limit or 100):]
455
- return {"count": len(out), "evidence": out}
456
-
457
-
458
- # 生效条件:无参数调用时返回包含模块级常量 SUBSYSTEM、SIGN_ACTION、SWARM_DIR_ENV、NODE_ID_ENV、ROOT_ENV、MAX_ITEMS、MAX_TEXT 及 swarm_dir() 等字段的自描述字典。
459
- def catalog() -> dict:
460
- return {
461
- "layer": "跨节点证据存储(蜂群互联 v0.3)",
462
- "question": "跨节点:你凭什么这么说",
463
- "blindspot": "§9.1 单根假设——对端观测对本节点不可见",
464
- "invariants": ["来源可溯", "可拒收", "全程留痕", "禁止转手"],
465
- "subsystem": SUBSYSTEM,
466
- "sign_action": SIGN_ACTION,
467
- "swarm_dir": swarm_dir(),
468
- "pack_fields": list(_PACK_FIELDS),
469
- "limits": {"max_items": MAX_ITEMS, "max_text": MAX_TEXT},
470
- "env": {"node_id": NODE_ID_ENV, "swarm_dir": SWARM_DIR_ENV,
471
- "root": ROOT_ENV},
472
- "honest_boundary": "验证的是「证据来自该节点」,不是「证据为真」",
473
- }
474
-
475
-
476
- # --------------------------------------------------------------------------
477
- # 工具
478
- # --------------------------------------------------------------------------
479
-
480
- # 生效条件:当传入 path 和 obj 时,在 path 所在目录(若 dirname 为空则 ".")创建目录,将 obj 以 JSON 写入 path+".tmp"(ensure_ascii=False, indent=1, sort_keys=True),尝试 chmod 0600,替换到 path,返回 path。
481
- def _write_json(path: str, obj) -> str:
482
- os.makedirs(os.path.dirname(path) or ".", exist_ok=True)
483
- tmp = path + ".tmp"
484
- with open(tmp, "w", encoding="utf-8") as f:
485
- json.dump(obj, f, ensure_ascii=False, indent=1, sort_keys=True)
486
- try:
487
- os.chmod(tmp, 0o600)
488
- except OSError:
489
- pass
490
- publish(tmp, path)
491
- return path
492
-
493
-
494
- # 生效条件:当传入 root 且 _root_of(root) 返回真值时,以 designer 角色 Principal(tenant 取 os.environ.get("MDCG_TENANT", "default") 的实际值,actor 取 os.environ.get("MDCG_ACTOR", "swarm-cli") 的实际值)打开 MdCGSecure;否则抛出 EvidenceError。
495
- def _open_cg(root: str = None):
496
- """CLI 用:以 designer 身份打开根(令牌路径仍推荐走 MCP)。"""
497
- from .mdcos import MdCGSecure
498
- from .security import Principal
499
- from .tokens import role_spec
500
- r = _root_of(root)
501
- if not r:
502
- raise EvidenceError("缺少根目录:请设 MDCG_ROOT 或传 --root")
503
- spec = role_spec("designer")
504
- p = Principal(tenant=os.environ.get("MDCG_TENANT", "default"),
505
- actor=os.environ.get("MDCG_ACTOR", "swarm-cli"),
506
- clearance="private", can_write=True, can_admin=True,
507
- role="designer", layers_allow=spec["layers_allow"],
508
- ops_allow=spec["ops_allow"], auth_mode="legacy_env")
509
- # autoflush=1(P1b,2026-09-26,与 mcp_server.py:3695-3702 / review_cli._cg
510
- # 同款):短命工具进程被 kill 时 close/atexit 兜底不执行,缺省 64 会让
511
- # 写入停在内存 _dirty、分片日志从未落——逐条落日志保任意退出形态跨进程可见。
512
- return MdCGSecure(r, principal=p, autoflush=1)
513
-
514
-
515
- # 生效条件:当传入 obj 时,打印 json.dumps(obj, ensure_ascii=False, indent=1, default=str)。
516
- def _print(obj):
517
- print(json.dumps(obj, ensure_ascii=False, indent=1, default=str))
518
-
519
-
520
- # 生效条件:argv 为 None 时取 sys.argv[1:];经 argparse 解析后必填子命令(catalog/card/export/import 等)之一,参数缺失或非法由 argparse 直接退出;返回进程退出码;
521
- def main(argv=None):
522
- ap = argparse.ArgumentParser(
523
- prog="python -m md_cg.evidence",
524
- description="跨节点证据存储:名片 / 导出 / 导入(v0.3)")
525
- ap.add_argument("--root", default=None, help="认知图根(默认 MDCG_ROOT)")
526
- ap.add_argument("--swarm", default=None, help="共享目录(默认 ~/.mdcg/swarm)")
527
- ap.add_argument("--signers-file", default=None)
528
- sub = ap.add_subparsers(dest="cmd", required=True)
529
-
530
- sub.add_parser("catalog", help="自描述")
531
- sub.add_parser("card", help="本节点名片")
532
- sub.add_parser("publish", help="发布名片到共享目录")
533
- sub.add_parser("peers", help="发现对端名片")
534
-
535
- p_ex = sub.add_parser("export", help="导出证据包")
536
- p_ex.add_argument("--subject", action="append", default=None)
537
- p_ex.add_argument("--out", default=None, help="输出文件(默认写收件箱)")
538
-
539
- p_im = sub.add_parser("import", help="导入证据包")
540
- p_im.add_argument("path")
541
-
542
- p_ls = sub.add_parser("ls", help="列已导入的跨节点证据")
543
- p_ls.add_argument("--subject", default=None)
544
- p_ls.add_argument("--source", default=None)
545
- p_ls.add_argument("--limit", type=int, default=100)
546
-
547
- a = ap.parse_args(argv)
548
- cg = None
549
- try:
550
- if a.cmd == "catalog":
551
- _print(catalog())
552
- elif a.cmd == "card":
553
- _print(card(a.root, signers_file=a.signers_file))
554
- elif a.cmd == "publish":
555
- _print(publish_card(a.root, swarm=a.swarm,
556
- signers_file=a.signers_file))
557
- elif a.cmd == "peers":
558
- _print(peers(a.swarm, root=a.root))
559
- elif a.cmd == "export":
560
- cg = _open_cg(a.root)
561
- res = export_pack(cg, subjects=a.subject, swarm=a.swarm,
562
- signers_file=a.signers_file)
563
- _print(write_pack(res["pack"], path=a.out, swarm=a.swarm)
564
- if a.out else res)
565
- elif a.cmd == "import":
566
- cg = _open_cg(a.root)
567
- _print(import_pack(cg, a.path, swarm=a.swarm,
568
- signers_file=a.signers_file))
569
- elif a.cmd == "ls":
570
- cg = _open_cg(a.root)
571
- _print(evidence(cg, subject=a.subject, source=a.source,
572
- limit=a.limit))
573
- except (EvidenceError, _signer.SignerError) as e:
574
- print(f"[md_cg.evidence] {e}", file=sys.stderr)
575
- return 2
576
- finally:
577
- if cg is not None:
578
- try:
579
- cg.close() # 落盘索引,保证跨进程可见
580
- except Exception: # noqa: BLE001 —— 关闭失败不掩盖主流程结果
581
- pass
582
- return 0
583
-
584
-
585
- if __name__ == "__main__":
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())