@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/export.py CHANGED
@@ -1,222 +1,329 @@
1
- # -*- coding: utf-8 -*-
2
- """md_cg · 全库导出(P0 · export op)
3
-
4
- 把整库认知图导出为「可搬运、可灾备」的结构化数据。
5
-
6
- 设计约束(D-005 零第三方依赖,只用标准库):
7
- - **流式**写 JSONL:逐节点处理,不把整库读进内存(真实库 4500+ 节点)。
8
- - 先写 `<out>.tmp` 再 `os.replace` 改名:流式的同时保证「要么完整、要么无」。
9
- - 只导出 md 单一真相源的**内容**;索引等派生物不入导出(删了可重建)。
10
- - 可见性由 `cg.get` 决定:无密钥 / 越权 → 跳过并计数,绝不静默丢弃。
11
- - 密级默认导出明文(调用方须先通过 `require_admin` 授权);可选 redact 脱敏。
12
-
13
- 对外只有 `run(cg, action, **kw)` 一个入口,action ∈ EXPORT_ACTIONS。
14
- """
15
- from __future__ import annotations
16
-
17
- import json
18
- import os
19
- import time
20
-
21
- from .fsutil import publish
22
-
23
- SCHEMA = 1
24
- EXPORT_ACTIONS = ("graph", "nodes", "slice", "stat")
25
-
26
- # 导出行的字段(顺序即 JSON 键顺序,便于 diff 与人工核对)
27
- _ROW_KEYS = ("id", "layer", "path", "tags", "importance", "confidence",
28
- "condition_space", "non_applicable_conditions", "verification_basis",
29
- "created_at", "edges", "protected", "sensitivity", "content")
30
-
31
-
32
- # 生效条件:给定 cg 与 kind 即返回 os.path.join(cg.root, f"export_{kind}_{当前 %Y%m%d_%H%M%S 时间戳}.jsonl"),无任何前置校验或分支。
33
- def _default_out(cg, kind: str) -> str:
34
- """默认导出路径:`<root>/export_<kind>_<ts>.jsonl`(可搬运、可灾备)。"""
35
- ts = time.strftime("%Y%m%d_%H%M%S")
36
- return os.path.join(cg.root, f"export_{kind}_{ts}.jsonl")
37
-
38
-
39
- # 生效条件:cg.get(nid) 为 None 时返回 None;否则以 fm = node.get("frontmatter") or {}(缺键或假值回落空 dict)与 entry 组装行,layer 取 fm 的 layer、为假值时回落 entry.get("layer"),include_content 为真值时追加 content = node.get("content") or "",最终只保留 _ROW_KEYS 中实际存在的键。
40
- def _row(cg, nid: str, entry: dict, include_content: bool = True):
41
- """索引条目 → 导出行(回读节点拿到 frontmatter + 正文)。
42
-
43
- 返回 None 表示不可读(无密钥 / 越权)——由调用方计数,不静默。
44
- """
45
- node = cg.get(nid)
46
- if node is None:
47
- return None
48
- fm = node.get("frontmatter") or {}
49
- row = {
50
- "id": nid,
51
- "layer": fm.get("layer") or entry.get("layer"),
52
- "path": entry.get("path"),
53
- "tags": list(fm.get("tags") or []),
54
- "importance": fm.get("importance"),
55
- "confidence": fm.get("confidence"),
56
- "condition_space": fm.get("condition_space"),
57
- "non_applicable_conditions": list(fm.get("non_applicable_conditions") or []),
58
- "verification_basis": fm.get("verification_basis"),
59
- "created_at": fm.get("created_at"),
60
- "edges": list(fm.get("edges") or []),
61
- "protected": bool(entry.get("protected")),
62
- "sensitivity": fm.get("sensitivity"),
63
- }
64
- if include_content:
65
- row["content"] = node.get("content") or ""
66
- return {k: row[k] for k in _ROW_KEYS if k in row}
67
-
68
-
69
- # 生效条件:源为 cg.index 的 nodes(缺 "nodes" 键或假值回落空 dict)——ids 为真值时只取其中确实在 nodes 里的 id,否则取全部——按 (float(created_at or 0), id) 排序后逐个产出同时满足 layer(为真时须 (e.layer or "") == layer)、tag(为真时须在 e.tags or [] 中)、since/until(非 None 时按 float 比较 created_at)的条目,limit 为真值且已产出 n 条并 n >= int(limit) 时停止(limit 为 0 或 None 不设上限)。
70
- def _iter_entries(cg, layer=None, since=None, until=None, tag=None,
71
- ids=None, limit=None):
72
- """按条件遍历索引条目(不读文件,保证筛选阶段零 IO)。
73
-
74
- 排序键 = (created_at, id):稳定、可重现,便于灾备 diff。
75
- """
76
- nodes = (cg.index.get("nodes") or {})
77
- if ids:
78
- picked = [(nid, nodes[nid]) for nid in ids if nid in nodes]
79
- else:
80
- picked = list(nodes.items())
81
- picked.sort(key=lambda kv: (float(kv[1].get("created_at") or 0), kv[0]))
82
- n = 0
83
- for nid, e in picked:
84
- if layer and (e.get("layer") or "") != layer:
85
- continue
86
- if tag and tag not in (e.get("tags") or []):
87
- continue
88
- ca = float(e.get("created_at") or 0)
89
- if since is not None and ca < float(since):
90
- continue
91
- if until is not None and ca > float(until):
92
- continue
93
- yield nid, e
94
- n += 1
95
- if limit and n >= int(limit):
96
- return
97
-
98
-
99
- # 生效条件:将 entries 逐条经 _row 转换后写入 out_path(先 makedirs 其父目录、写 out_path + ".tmp"、结束后 os.replace 为 out_path),_row 返回 None 的条目只累加 skipped_unreadable 而不写入,其余写入并累加 written 及 by_layer(row 的 layer 缺键或假值记为 "?");include_content 透传给 _row 决定行是否含正文;返回含 ok/out/written/skipped_unreadable/by_layer/bytes/elapsed_ms 的统计 dict。
100
- def _write_jsonl(cg, out_path: str, entries, include_content: bool = True):
101
- """流式写 JSONL(tmp + 原子改名)。返回统计 dict。"""
102
- out_path = os.path.abspath(out_path)
103
- parent = os.path.dirname(out_path)
104
- if parent:
105
- os.makedirs(parent, exist_ok=True)
106
- tmp = out_path + ".tmp"
107
- written = skipped = 0
108
- by_layer = {}
109
- t0 = time.time()
110
- with open(tmp, "w", encoding="utf-8") as f:
111
- for nid, e in entries:
112
- row = _row(cg, nid, e, include_content=include_content)
113
- if row is None:
114
- skipped += 1 # 不可读:计数上报,不静默丢
115
- continue
116
- f.write(json.dumps(row, ensure_ascii=False) + "\n")
117
- written += 1
118
- lay = row.get("layer") or "?"
119
- by_layer[lay] = by_layer.get(lay, 0) + 1
120
- if written % 500 == 0:
121
- f.flush() # 定期刷盘,控制缓冲区
122
- publish(tmp, out_path) # 流式 + 原子:要么完整、要么无
123
- return {"ok": True, "out": out_path, "written": written,
124
- "skipped_unreadable": skipped, "by_layer": by_layer,
125
- "bytes": os.path.getsize(out_path),
126
- "elapsed_ms": round((time.time() - t0) * 1000, 1)}
127
-
128
-
129
- # 生效条件:out 为假值(None/空串)时回落为 _default_out(cg, "graph"),以 _iter_entries(cg, layer=layer, limit=limit) 为条目流调用 _write_jsonl(include_content=include_content),再补 action="graph" 与 note 后返回该结果 dict。
130
- def export_graph(cg, out: str = None, layer=None, limit=None,
131
- include_content: bool = True):
132
- """全库导出(默认含正文)。"""
133
- out = out or _default_out(cg, "graph")
134
- entries = _iter_entries(cg, layer=layer, limit=limit)
135
- res = _write_jsonl(cg, out, entries, include_content=include_content)
136
- res["action"] = "graph"
137
- res["note"] = ("流式导出行=JSONL,一节点一行;不含索引等派生物"
138
- "(删了可重建)。skipped_unreadable>0 表示有节点因密钥/越权"
139
- "不可读,需用更高权限或原密钥重导。")
140
- return res
141
-
142
-
143
- # 生效条件:ids 先按 [str(i) for i in (ids or []) if str(i).strip()] 规整,规整结果为空(ids 为 None/空容器/全空白项)时返回 {'ok': False, 'error': 'ids 不能为空'};否则 out 为假值时回落为 _default_out(cg, "nodes"),以 _iter_entries(cg, ids=ids) 为条目流调用 _write_jsonl(include_content=include_content),再补 action="nodes"、requested=len(ids)、missing=索引 keys 与 ids 的差集排序后返回。
144
- def export_nodes(cg, ids, out: str = None, include_content: bool = True):
145
- """按 id 列表导出(顺序 = 传入顺序)。"""
146
- ids = [str(i) for i in (ids or []) if str(i).strip()]
147
- if not ids:
148
- return {"ok": False, "error": "ids 不能为空"}
149
- out = out or _default_out(cg, "nodes")
150
- entries = _iter_entries(cg, ids=ids)
151
- res = _write_jsonl(cg, out, entries, include_content=include_content)
152
- res["action"] = "nodes"
153
- res["requested"] = len(ids)
154
- res["missing"] = sorted(set(ids) - set((cg.index.get("nodes") or {}).keys()))
155
- return res
156
-
157
-
158
- # 生效条件:out 为假值(None/空串)时回落为 _default_out(cg, "slice"),以 _iter_entries(cg, layer=layer, since=since, until=until, tag=tag, limit=limit) 为条目流调用 _write_jsonl(include_content=include_content),再补 action="slice" 与记录 layer/since/until/tag 的 filter 后返回。
159
- def export_slice(cg, out: str = None, layer=None, since=None, until=None,
160
- tag=None, limit=None, include_content: bool = True):
161
- """按层 / 时间窗 / 标签切片导出(有界,便于增量搬运)。"""
162
- out = out or _default_out(cg, "slice")
163
- entries = _iter_entries(cg, layer=layer, since=since, until=until,
164
- tag=tag, limit=limit)
165
- res = _write_jsonl(cg, out, entries, include_content=include_content)
166
- res["action"] = "slice"
167
- res["filter"] = {"layer": layer, "since": since, "until": until, "tag": tag}
168
- return res
169
-
170
-
171
- # 生效条件:只读 cg.index 的 nodes(缺 "nodes" 键或假值回落空 dict),逐条统计 layer(缺键或假值记 "?")、verification_basis(缺键或假值记 "(未声明)")、tags 计数(按计数降序取前 15)、protected 与 has_neg_conditions 为真值的条目数,以及 created_at 为真值时的 min/max(全为 0 或缺键时二者均为 None),返回含 total/by_layer/by_verification_basis/protected/with_non_applicable/top_tags/time_range/note 的 dict。
172
- def export_stat(cg):
173
- """导出前体检:层分布 / 验证基底 / 标签 Top / 时间范围。**只读索引,零 IO**。"""
174
- nodes = (cg.index.get("nodes") or {})
175
- by_layer, by_basis, by_tag = {}, {}, {}
176
- protected = with_neg = 0
177
- t_min, t_max = None, None
178
- for _nid, e in list(nodes.items()):
179
- lay = e.get("layer") or "?"
180
- by_layer[lay] = by_layer.get(lay, 0) + 1
181
- b = e.get("verification_basis") or "(未声明)"
182
- by_basis[b] = by_basis.get(b, 0) + 1
183
- if e.get("protected"):
184
- protected += 1
185
- if e.get("has_neg_conditions"):
186
- with_neg += 1
187
- for t in (e.get("tags") or []):
188
- by_tag[t] = by_tag.get(t, 0) + 1
189
- ca = float(e.get("created_at") or 0)
190
- if ca:
191
- t_min = ca if t_min is None else min(t_min, ca)
192
- t_max = ca if t_max is None else max(t_max, ca)
193
- top_tags = sorted(by_tag.items(),
194
- key=lambda kv: (-kv[1], str(kv[0])))[:15]
195
- return {"ok": True, "action": "stat", "total": len(nodes),
196
- "by_layer": by_layer, "by_verification_basis": by_basis,
197
- "protected": protected, "with_non_applicable": with_neg,
198
- "top_tags": [{"tag": t, "n": n} for t, n in top_tags],
199
- "time_range": {"min": t_min, "max": t_max},
200
- "note": ("只读索引统计(零 IO)。sensitivity 不入索引快照,"
201
- "如需密级分布请用 graph 导出后统计。")}
202
-
203
-
204
- # 生效条件:act = (action or "graph").strip().lower()(action 为 None/空串等假值时取 "graph")——act 为 "graph"/"nodes"/"slice"/"stat" 时分别转调 export_graph/export_nodes/export_slice/export_stat(out、layer、limit、since、until、tag、ids 取自 kw 对应键,include_content 取 kw.get("include_content", True)),其它 act 值抛 ValueError。
205
- def run(cg, action: str = "graph", **kw):
206
- """export op 唯一入口。"""
207
- act = (action or "graph").strip().lower()
208
- if act == "graph":
209
- return export_graph(cg, out=kw.get("out"), layer=kw.get("layer"),
210
- limit=kw.get("limit"),
211
- include_content=kw.get("include_content", True))
212
- if act == "nodes":
213
- return export_nodes(cg, kw.get("ids"), out=kw.get("out"),
214
- include_content=kw.get("include_content", True))
215
- if act == "slice":
216
- return export_slice(cg, out=kw.get("out"), layer=kw.get("layer"),
217
- since=kw.get("since"), until=kw.get("until"),
218
- tag=kw.get("tag"), limit=kw.get("limit"),
219
- include_content=kw.get("include_content", True))
220
- if act == "stat":
221
- return export_stat(cg)
222
- raise ValueError(f"未知 export action:{action!r}(允许 {EXPORT_ACTIONS})")
1
+ # -*- coding: utf-8 -*-
2
+ """md_cg · 全库导出(P0 · export op)
3
+
4
+ 把整库认知图导出为「可搬运、可灾备」的结构化数据。
5
+
6
+ 设计约束(D-005 零第三方依赖,只用标准库):
7
+ - **流式**写 JSONL:逐节点处理,不把整库读进内存(真实库 4500+ 节点)。
8
+ - 先写 `<out>.tmp` 再 `os.replace` 改名:流式的同时保证「要么完整、要么无」。
9
+ - 只导出 md 单一真相源的**内容**;索引等派生物不入导出(删了可重建)。
10
+ - 可见性由 `cg.get` 决定:无密钥 / 越权 → 跳过并计数,绝不静默丢弃。
11
+ - 密级默认导出明文(调用方须先通过 `require_admin` 授权);可选 redact 脱敏。
12
+
13
+ 对外只有 `run(cg, action, **kw)` 一个入口,action ∈ EXPORT_ACTIONS。
14
+ """
15
+ from __future__ import annotations
16
+
17
+ import json
18
+ import os
19
+ import time
20
+ import uuid
21
+
22
+ from .fsutil import publish
23
+
24
+ SCHEMA = 1
25
+ EXPORT_ACTIONS = ("graph", "nodes", "slice", "stat")
26
+
27
+ # 导出行的字段(顺序即 JSON 键顺序,便于 diff 与人工核对)
28
+ _ROW_KEYS = ("id", "layer", "path", "tags", "importance", "confidence",
29
+ "condition_space", "non_applicable_conditions", "verification_basis",
30
+ "created_at", "edges", "protected", "sensitivity", "content")
31
+
32
+
33
+ # 生效条件:给定 cg 与 kind 即返回 os.path.join(cg.root, f"export_{kind}_{当前 %Y%m%d_%H%M%S 时间戳}.jsonl"),无任何前置校验或分支。
34
+ def _default_out(cg, kind: str) -> str:
35
+ """默认导出路径:`<root>/export_<kind>_<ts>.jsonl`(可搬运、可灾备)。
36
+
37
+ issue #78:秒级时间戳下同秒两次导出会同名,第二次 publish 覆盖第一份快照,
38
+ 而两个调用都返回 ok —— 静默丢数据。此处做碰撞自增:首份保持原格式不变
39
+ (对依赖 export_<kind>_<ts>.jsonl 精确格式的调用方零影响),仅当目标已存在
40
+ 时追加 _1/_2… 后缀,绝不覆盖既有快照。
41
+ """
42
+ ts = time.strftime("%Y%m%d_%H%M%S")
43
+ base = os.path.join(cg.root, f"export_{kind}_{ts}")
44
+ out = base + ".jsonl"
45
+ if not os.path.exists(out):
46
+ return out
47
+ for i in range(1, 10000):
48
+ cand = f"{base}_{i}.jsonl"
49
+ if not os.path.exists(cand):
50
+ return cand
51
+ return f"{base}_{int(time.time() * 1000)}.jsonl"
52
+
53
+
54
+ # 生效条件:preferred 给定时逐个尝试 _claim_candidates(preferred) 的候选路径,对每个候选以 os.open(O_CREAT|O_EXCL|O_WRONLY) 原子创建空文件;成功即关闭句柄并返回该路径;候选被占用(FileExistsError)或不可创建(OSError)则继续下一个;全部失败时追加 uuid 段再占一次并返回。
55
+ def _claim_candidates(preferred: str):
56
+ """首选名 + 让位名序列(与 _default_out 同命名口径)。"""
57
+ base = preferred[:-6] if preferred.endswith(".jsonl") else preferred
58
+ yield preferred
59
+ for i in range(1, 10000):
60
+ yield "%s_%d.jsonl" % (base, i)
61
+
62
+
63
+ def _claim_path(preferred: str) -> str:
64
+ """**原子占位**:把「选路径」从查询变成内核级互斥的创建,返回本调用独占的路径。
65
+
66
+ issue #78 并发面(2026-10-09 DSH 端):原实现只在 _default_out 里用
67
+ os.path.exists **先查后建**(check-then-act),两个线程可同时判定「目标不存在」
68
+ 并选中**同一路径** ⇒ 后发布者覆盖前者,而**两次调用都返回 ok**(静默丢快照)。
69
+ 1ceefd3f 的碰撞自增只覆盖**串行同秒**面,未覆盖该竞态。
70
+
71
+ 为什么不在 _default_out 里创建:该函数已声明为**纯查询**(只探存在性、不创建
72
+ 文件,见 test_export_default_collision.py 的 G1 口径)——在那里落文件会改掉它
73
+ 已声明的语义,也会让「连问三次」不再是同一答案。故此处保留 _default_out 为
74
+ **首选名(hint)**,权威占用在本函数(真正创建文件的那一步)。
75
+
76
+ O_EXCL 由内核保证「探测 + 创建」不可分割:并发下至多一个调用者占到同一路径,
77
+ 其余让位到 _1/_2…。占位是**空文件**,随后由 publish 原子改名覆盖为完整快照。
78
+ """
79
+ for cand in _claim_candidates(preferred):
80
+ try:
81
+ fd = os.open(cand, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o644)
82
+ except (FileExistsError, OSError):
83
+ continue
84
+ os.close(fd)
85
+ return cand
86
+ # 兜底:候选全满(1 万份/秒)——uuid 段保证互异,仍走原子创建
87
+ base = preferred[:-6] if preferred.endswith(".jsonl") else preferred
88
+ cand = "%s_%s.jsonl" % (base, uuid.uuid4().hex[:8])
89
+ fd = os.open(cand, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o644)
90
+ os.close(fd)
91
+ return cand
92
+
93
+
94
+ # 生效条件:cg.get(nid) 为 None 时返回 None;否则以 fm = node.get("frontmatter") or {}(缺键或假值回落空 dict)与 entry 组装行,layer 取 fm 的 layer、为假值时回落 entry.get("layer"),include_content 为真值时追加 content = node.get("content") or "",最终只保留 _ROW_KEYS 中实际存在的键。
95
+ def _row(cg, nid: str, entry: dict, include_content: bool = True):
96
+ """索引条目 → 导出行(回读节点拿到 frontmatter + 正文)。
97
+
98
+ 返回 None 表示不可读(无密钥 / 越权)——由调用方计数,不静默。
99
+ """
100
+ node = cg.get(nid)
101
+ if node is None:
102
+ return None
103
+ fm = node.get("frontmatter") or {}
104
+ row = {
105
+ "id": nid,
106
+ "layer": fm.get("layer") or entry.get("layer"),
107
+ "path": entry.get("path"),
108
+ "tags": list(fm.get("tags") or []),
109
+ "importance": fm.get("importance"),
110
+ "confidence": fm.get("confidence"),
111
+ "condition_space": fm.get("condition_space"),
112
+ "non_applicable_conditions": list(fm.get("non_applicable_conditions") or []),
113
+ "verification_basis": fm.get("verification_basis"),
114
+ "created_at": fm.get("created_at"),
115
+ "edges": list(fm.get("edges") or []),
116
+ "protected": bool(entry.get("protected")),
117
+ "sensitivity": fm.get("sensitivity"),
118
+ }
119
+ if include_content:
120
+ row["content"] = node.get("content") or ""
121
+ return {k: row[k] for k in _ROW_KEYS if k in row}
122
+
123
+
124
+ # 生效条件:源为 cg.index 的 nodes(缺 "nodes" 键或假值回落空 dict)——ids 为真值时只取其中确实在 nodes 里的 id,否则取全部——按 (float(created_at or 0), id) 排序后逐个产出同时满足 layer(为真时须 (e.layer or "") == layer)、tag(为真时须在 e.tags or [] 中)、since/until(非 None 时按 float 比较 created_at)的条目,limit 为真值且已产出 n 条并 n >= int(limit) 时停止(limit 为 0 或 None 不设上限)。
125
+ def _iter_entries(cg, layer=None, since=None, until=None, tag=None,
126
+ ids=None, limit=None):
127
+ """按条件遍历索引条目(不读文件,保证筛选阶段零 IO)。
128
+
129
+ 排序键 = (created_at, id):稳定、可重现,便于灾备 diff。
130
+ """
131
+ nodes = (cg.index.get("nodes") or {})
132
+ if ids:
133
+ picked = [(nid, nodes[nid]) for nid in ids if nid in nodes]
134
+ else:
135
+ picked = list(nodes.items())
136
+ picked.sort(key=lambda kv: (float(kv[1].get("created_at") or 0), kv[0]))
137
+ n = 0
138
+ for nid, e in picked:
139
+ if layer and (e.get("layer") or "") != layer:
140
+ continue
141
+ if tag and tag not in (e.get("tags") or []):
142
+ continue
143
+ ca = float(e.get("created_at") or 0)
144
+ if since is not None and ca < float(since):
145
+ continue
146
+ if until is not None and ca > float(until):
147
+ continue
148
+ yield nid, e
149
+ n += 1
150
+ if limit and n >= int(limit):
151
+ return
152
+
153
+
154
+ # 生效条件:将 entries 逐条经 _row 转换后写入 out_path(先 makedirs 其父目录、写 out_path + ".<uuid>.tmp"、结束后 os.replace 为 out_path),_row 返回 None 的条目只累加 skipped_unreadable 而不写入,其余写入并累加 written 及 by_layer(row 的 layer 缺键或假值记为 "?");include_content 透传给 _row 决定行是否含正文;claim 为真值时先经 _claim_path(out_path) 原子占位、并以**占位到的路径**为 out_path(并发下让位到 _1/_2…),占位/发布失败时撤掉占位与临时件后抛出;返回含 ok/out/written/skipped_unreadable/by_layer/bytes/elapsed_ms 的统计 dict(out 为占位后的最终路径)。
155
+ def _write_jsonl(cg, out_path: str, entries, include_content: bool = True,
156
+ claim: bool = False):
157
+ """流式写 JSONL(tmp + 原子改名)。返回统计 dict。
158
+
159
+ claim=True(默认导出路径):out_path 只是**首选名**,真正占用经 _claim_path
160
+ 原子完成——并发调用不再取到同一路径(issue #78 并发面)。claim=False(调用方
161
+ 显式传 out):按原语义写到该路径(覆盖由 mcp_server 的 #85③ 护栏把关)。
162
+ """
163
+ out_path = os.path.abspath(out_path)
164
+ parent = os.path.dirname(out_path)
165
+ if parent:
166
+ os.makedirs(parent, exist_ok=True)
167
+ # issue #78 附带:tmp 加 uuid 段——两进程同时导出同一 out 时不再共用
168
+ # 同一个 .tmp(原实现下后写者会踩掉前者的中间态)。
169
+ tmp = "%s.%s.tmp" % (out_path, uuid.uuid4().hex[:8])
170
+ written = skipped = 0
171
+ by_layer = {}
172
+ t0 = time.time()
173
+ with open(tmp, "w", encoding="utf-8") as f:
174
+ for nid, e in entries:
175
+ row = _row(cg, nid, e, include_content=include_content)
176
+ if row is None:
177
+ skipped += 1 # 不可读:计数上报,不静默丢
178
+ continue
179
+ f.write(json.dumps(row, ensure_ascii=False) + "\n")
180
+ written += 1
181
+ lay = row.get("layer") or "?"
182
+ by_layer[lay] = by_layer.get(lay, 0) + 1
183
+ if written % 500 == 0:
184
+ f.flush() # 定期刷盘,控制缓冲区
185
+ # issue #78 并发面:**先原子占位、再发布**。占位失败/发布失败都不留垃圾。
186
+ claimed = None
187
+ if claim:
188
+ out_path = _claim_path(out_path)
189
+ claimed = out_path
190
+ try:
191
+ publish(tmp, out_path) # 流式 + 原子:要么完整、要么无
192
+ except BaseException:
193
+ # 内容未落地:占位是本调用独占的空文件,撤掉它(别留空快照),临时件同样清掉
194
+ if claimed:
195
+ try:
196
+ os.remove(claimed)
197
+ except OSError:
198
+ pass
199
+ try:
200
+ os.remove(tmp)
201
+ except OSError:
202
+ pass
203
+ raise
204
+ return {"ok": True, "out": out_path, "written": written,
205
+ "skipped_unreadable": skipped, "by_layer": by_layer,
206
+ "bytes": os.path.getsize(out_path),
207
+ "elapsed_ms": round((time.time() - t0) * 1000, 1)}
208
+
209
+
210
+ # 生效条件:out 为假值(None/空串)时回落为 _default_out(cg, "graph"),以 _iter_entries(cg, layer=layer, limit=limit) 为条目流调用 _write_jsonl(include_content=include_content),再补 action="graph" 与 note 后返回该结果 dict。
211
+ def export_graph(cg, out: str = None, layer=None, limit=None,
212
+ include_content: bool = True):
213
+ """全库导出(默认含正文)。"""
214
+ # issue #78 并发面:默认名只是**首选名**,权威占用在 _write_jsonl 里原子完成
215
+ _claim = not out
216
+ out = out or _default_out(cg, "graph")
217
+ entries = _iter_entries(cg, layer=layer, limit=limit)
218
+ res = _write_jsonl(cg, out, entries, include_content=include_content,
219
+ claim=_claim)
220
+ res["action"] = "graph"
221
+ res["note"] = ("流式导出行=JSONL,一节点一行;不含索引等派生物"
222
+ "(删了可重建)。skipped_unreadable>0 表示有节点因密钥/越权"
223
+ "不可读,需用更高权限或原密钥重导。")
224
+ return res
225
+
226
+
227
+ # 生效条件:ids 先按 [str(i) for i in (ids or []) if str(i).strip()] 规整,规整结果为空(ids 为 None/空容器/全空白项)时返回 {'ok': False, 'error': 'ids 不能为空'};否则 out 为假值时回落为 _default_out(cg, "nodes"),以 _iter_entries(cg, ids=ids) 为条目流调用 _write_jsonl(include_content=include_content),再补 action="nodes"、requested=len(ids)、missing=索引 keys 与 ids 的差集排序后返回。
228
+ def export_nodes(cg, ids, out: str = None, include_content: bool = True):
229
+ """按 id 列表导出(顺序 = 传入顺序)。"""
230
+ ids = [str(i) for i in (ids or []) if str(i).strip()]
231
+ if not ids:
232
+ return {"ok": False, "error": "ids 不能为空"}
233
+ # issue #78 并发面:默认名只是**首选名**,权威占用在 _write_jsonl 里原子完成
234
+ _claim = not out
235
+ out = out or _default_out(cg, "nodes")
236
+ entries = _iter_entries(cg, ids=ids)
237
+ res = _write_jsonl(cg, out, entries, include_content=include_content,
238
+ claim=_claim)
239
+ res["action"] = "nodes"
240
+ res["requested"] = len(ids)
241
+ res["missing"] = sorted(set(ids) - set((cg.index.get("nodes") or {}).keys()))
242
+ return res
243
+
244
+
245
+ # 生效条件:out 为假值(None/空串)时回落为 _default_out(cg, "slice"),以 _iter_entries(cg, layer=layer, since=since, until=until, tag=tag, limit=limit) 为条目流调用 _write_jsonl(include_content=include_content),再补 action="slice" 与记录 layer/since/until/tag 的 filter 后返回。
246
+ def export_slice(cg, out: str = None, layer=None, since=None, until=None,
247
+ tag=None, limit=None, include_content: bool = True):
248
+ """按层 / 时间窗 / 标签切片导出(有界,便于增量搬运)。"""
249
+ # issue #78 并发面:默认名只是**首选名**,权威占用在 _write_jsonl 里原子完成
250
+ _claim = not out
251
+ out = out or _default_out(cg, "slice")
252
+ entries = _iter_entries(cg, layer=layer, since=since, until=until,
253
+ tag=tag, limit=limit)
254
+ res = _write_jsonl(cg, out, entries, include_content=include_content,
255
+ claim=_claim)
256
+ res["action"] = "slice"
257
+ res["filter"] = {"layer": layer, "since": since, "until": until, "tag": tag}
258
+ return res
259
+
260
+
261
+ # 生效条件:只读 cg.index 的 nodes(缺 "nodes" 键或假值回落空 dict),逐条统计 layer(缺键或假值记 "?")、verification_basis(缺键或假值记 "(未声明)")、tags 计数(按计数降序取前 15)、protected 与 has_neg_conditions 为真值的条目数,以及 created_at 为真值时的 min/max(全为 0 或缺键时二者均为 None),返回含 total/by_layer/by_verification_basis/protected/with_non_applicable/top_tags/time_range/note 的 dict。
262
+ def export_stat(cg):
263
+ """导出前体检:层分布 / 验证基底 / 标签 Top / 时间范围。**只读索引,零 IO**。"""
264
+ nodes = (cg.index.get("nodes") or {})
265
+ by_layer, by_basis, by_tag = {}, {}, {}
266
+ protected = with_neg = 0
267
+ t_min, t_max = None, None
268
+ for _nid, e in list(nodes.items()):
269
+ lay = e.get("layer") or "?"
270
+ by_layer[lay] = by_layer.get(lay, 0) + 1
271
+ b = e.get("verification_basis") or "(未声明)"
272
+ by_basis[b] = by_basis.get(b, 0) + 1
273
+ if e.get("protected"):
274
+ protected += 1
275
+ if e.get("has_neg_conditions"):
276
+ with_neg += 1
277
+ for t in (e.get("tags") or []):
278
+ by_tag[t] = by_tag.get(t, 0) + 1
279
+ ca = float(e.get("created_at") or 0)
280
+ if ca:
281
+ t_min = ca if t_min is None else min(t_min, ca)
282
+ t_max = ca if t_max is None else max(t_max, ca)
283
+ top_tags = sorted(by_tag.items(),
284
+ key=lambda kv: (-kv[1], str(kv[0])))[:15]
285
+ return {"ok": True, "action": "stat", "total": len(nodes),
286
+ "by_layer": by_layer, "by_verification_basis": by_basis,
287
+ "protected": protected, "with_non_applicable": with_neg,
288
+ "top_tags": [{"tag": t, "n": n} for t, n in top_tags],
289
+ "time_range": {"min": t_min, "max": t_max},
290
+ "note": ("只读索引统计(零 IO)。sensitivity 不入索引快照,"
291
+ "如需密级分布请用 graph 导出后统计。")}
292
+
293
+
294
+ # 生效条件:act = (action or "graph").strip().lower()(action 为 None/空串等假值时取 "graph")——act 为 "graph"/"nodes"/"slice"/"stat" 时分别转调 export_graph/export_nodes/export_slice/export_stat(out、layer、limit、since、until、tag、ids 取自 kw 对应键,include_content 取 kw.get("include_content", True)),其它 act 值抛 ValueError。
295
+ def run(cg, action: str = "graph", **kw):
296
+ """export op 唯一入口。
297
+
298
+ issue #540 纵深(同族缺口):根约束原先**只在 MCP 层**(`mcp_server._export_call`),
299
+ 本库层入口直调时连那道闸都不存在(实测 `export.run(cg, out="\\u00a0")` 可把整库正文
300
+ 写到数据根与白名单之外)。此处补一道**与白名单无关**的落点约束,使库层直调也受控。
301
+ 只加拒绝分支、不新增放行:`out` 为 None/空串时行为一字不变。
302
+ """
303
+ act = (action or "graph").strip().lower()
304
+ _out = kw.get("out")
305
+ if _out is not None and str(_out) != "":
306
+ from .security import check_export_target, check_path_root
307
+ _lib_root = getattr(cg, "root", None)
308
+ # ① 空白判据(#540):纯空白不是「没给落点」,两道闸内部各自拒绝
309
+ check_path_root(_out, "MDCG_EXPORT_ROOT", "export")
310
+ # ② 落点约束(#211 第二道):不得落进辅助根 / 库根危险位。
311
+ # 与 MCP 层 `_export_call` 同口径——**allow_overwrite=True**:覆盖与否由
312
+ # 调用方自己的「目标已存在 + 未显式 overwrite」判据处理(MCP 层同款),
313
+ # 本函数不重复实现该闸,避免把 `overwrite=True` 的合法逃生口一并拒掉。
314
+ check_export_target(_out, _lib_root, "export", allow_overwrite=True)
315
+ if act == "graph":
316
+ return export_graph(cg, out=kw.get("out"), layer=kw.get("layer"),
317
+ limit=kw.get("limit"),
318
+ include_content=kw.get("include_content", True))
319
+ if act == "nodes":
320
+ return export_nodes(cg, kw.get("ids"), out=kw.get("out"),
321
+ include_content=kw.get("include_content", True))
322
+ if act == "slice":
323
+ return export_slice(cg, out=kw.get("out"), layer=kw.get("layer"),
324
+ since=kw.get("since"), until=kw.get("until"),
325
+ tag=kw.get("tag"), limit=kw.get("limit"),
326
+ include_content=kw.get("include_content", True))
327
+ if act == "stat":
328
+ return export_stat(cg)
329
+ raise ValueError(f"未知 export action:{action!r}(允许 {EXPORT_ACTIONS})")