@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  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 +139 -139
  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 +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  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 +51 -3
  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 +28 -2
  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 +15 -2
  34. package/lib/tools.js +44 -4
  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 +37 -7
  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 +573 -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 +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  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 +262 -251
  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 +426 -345
  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 +7108 -5440
  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 +1103 -1100
  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 +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  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 +613 -604
  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 +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  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 +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  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 +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  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 +2013 -1973
  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_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. 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
  532. 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
  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_v1.0.md +0 -299
  534. 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
  535. 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
  536. 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
  537. 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
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. 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
  540. 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
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. 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
  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.0.md +0 -223
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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
  573. 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
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. 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
  577. 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
  578. 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
  579. 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
  580. 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
  581. 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
  582. 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
  583. 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
  584. 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
  585. 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
  586. 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
  587. 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
  588. 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
  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_v1.md +0 -156
  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_v10.md +0 -210
  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_v11.md +0 -227
  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_v12.md +0 -203
  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_v13.md +0 -233
  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_v14.md +0 -191
  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_v15.md +0 -213
  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_v16.md +0 -214
  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_v17.md +0 -199
  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_v18.md +0 -183
  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_v19.md +0 -207
  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_v2.md +0 -156
  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_v20.md +0 -283
  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_v21.md +0 -224
  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_v22.md +0 -223
  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_v23.md +0 -293
  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_v24.md +0 -303
  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_v25.md +0 -230
  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_v26.md +0 -196
  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_v27.md +0 -259
  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_v28.md +0 -217
  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_v29.md +0 -270
  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_v3.md +0 -152
  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_v30.md +0 -231
  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_v31.md +0 -281
  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_v4.md +0 -128
  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_v5.md +0 -114
  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_v6.md +0 -192
  617. 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
  618. 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
  619. 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
  620. 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
  621. 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
  622. 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
  623. 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
  624. 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
  625. 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
  626. 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
  627. 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
  628. 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
  629. 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
  630. 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
  631. 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
  632. 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
  633. 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
  634. 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
  635. 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
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. 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
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. 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
  650. 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
  651. 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
  652. 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
  653. 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
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. 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
  656. 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
  657. 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
  658. 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
  659. 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
  660. 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
  661. 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
  662. 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
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. 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
  665. 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
  666. 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
  667. 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
  668. 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
  669. 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
  670. 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
  671. 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
  672. 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
  673. 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
  674. 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
  675. 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
  676. 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
  677. 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
  678. 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
  679. 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
  680. 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
  681. 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
  682. 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
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. 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
  691. 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
  692. 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
  693. 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
  694. 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
  695. 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
  696. 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
  697. 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
  698. 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
  699. 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
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. 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
  702. 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
  703. 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
  704. 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
  705. 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
  706. 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
  707. 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
  708. 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
  709. 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
  710. 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
  711. 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
  712. 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
  713. 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
  714. 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
  715. 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
  716. 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
  717. 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
@@ -1,326 +1,419 @@
1
- /**
2
- * datapath.ts · 灵枢数据根解析(记忆写入路径可配置)
3
- *
4
- * 与 Python 侧 `md_cg/datapath.py` **同口径**——两侧读同一份
5
- * `<用户级状态根>/paths.json`(新位置;旧版 `<插件仓>/data/paths.json`
6
- * 仍兼容读),避免大脑与脚本对「记忆真源在哪」各持一说。
7
- *
8
- * 为什么默认不再取「插件仓自身 data/」(issue #18 相邻问题,数据丢失级):
9
- * DSH 插件按 hoisted 布局装在 `<profile>/node_modules/<pkg>`,`pnpm` 更新该包
10
- * 会**整个替换包目录**——运行时数据落在包内(`<pkg>/data`)时,每次更新成功
11
- * 即连目录一起删掉(贡献者实机实证:`data/` 54 文件 → 0,46 条记忆节点只能
12
- * 靠人工备份回填);`paths.json` 同址,用户配置一并丢失。故默认数据根与配置
13
- * 文件一律落**用户级状态根**(见 `stateRoot()`),与包目录彻底解耦。
14
- *
15
- * 优先级(高 → 低):
16
- * 1. 环境变量 `MDCG_DATA_ROOT`(数据根)/ `MDCG_ROOT`(认知图根)
17
- * 2. 用户可编辑配置 `paths.json` 的 `data_root` / `root`
18
- * (位置:`<用户级状态根>/paths.json`;旧 `<插件仓>/data/paths.json` 兼容读)
19
- * 3. 插件配置项 `mdcg.root`(可为空=未指定)
20
- * 4. 默认 `<用户级状态根>/data/mdcg`
21
- *
22
- * 为什么默认不取「相对 cwd 的 data/mdcg」:
23
- * node 侧插件与 python 侧脚本的 cwd 不同,相对路径会漂移成
24
- * `<cwd>/data/mdcg`。历史事故:宿主 cwd 落在 AEIS 时,记忆真源
25
- * 分裂到 `AEIS/data/mdcg`,与插件仓 `data/` 变成互不可见的两处。
26
- *
27
- * 旧数据接手:`migrateLegacyData()` 在默认数据根生效且旧包内位置仍有内容时
28
- * 一次性**复制**(不删除、不覆盖)到用户级位置——见该函数注释。
29
- */
30
- import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync } from 'node:fs'
31
- import { homedir, tmpdir } from 'node:os'
32
- import { delimiter, dirname, isAbsolute, join, resolve } from 'node:path'
33
- import { fileURLToPath } from 'node:url'
34
-
35
- export const ENV_DATA_ROOT = 'MDCG_DATA_ROOT'
36
- export const ENV_MDCG_ROOT = 'MDCG_ROOT'
37
-
38
- let cachedRepoRoot: string | null = null
39
-
40
- /** 插件仓根目录:自本模块所在目录向上找 package.json(对构建层级不敏感)。 */
41
- export function repoRoot(): string {
42
- if (cachedRepoRoot) return cachedRepoRoot
43
- let dir = dirname(fileURLToPath(import.meta.url))
44
- for (let i = 0; i < 6; i += 1) {
45
- if (existsSync(join(dir, 'package.json'))) {
46
- cachedRepoRoot = dir
47
- return dir
48
- }
49
- const up = dirname(dir)
50
- if (up === dir) break
51
- dir = up
52
- }
53
- // 兜底:lib/lib/x.js 或 lib/x.js → 均回到仓根
54
- cachedRepoRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..')
55
- return cachedRepoRoot
56
- }
57
-
58
- export const ENV_STATE_ROOT = 'MDCG_STATE_ROOT'
59
-
60
- let cachedStateRoot: string | null = null
61
-
62
- /**
63
- * 用户级状态根(**插件包目录之外**):路径配置与默认数据根的落点。
64
- * 优先级:`MDCG_STATE_ROOT` → `$DSH_HOME/.dsh-memory` → `~/.dsh/.dsh-memory`。
65
- * `DSH_HOME` **未必**由宿主注入(本仓 `dsh/dsh-web-start.bat` 自行 set),
66
- * 故家目录兜底;`~/.dsh` 是本插件既有约定(`bridge.ts` 调试日志同址)。
67
- */
68
- export function stateRoot(): string {
69
- if (cachedStateRoot) return cachedStateRoot
70
- const env = process.env[ENV_STATE_ROOT]
71
- if (env) {
72
- cachedStateRoot = resolve(env)
73
- return cachedStateRoot
74
- }
75
- const dshHome = process.env['DSH_HOME']
76
- cachedStateRoot = dshHome
77
- ? join(resolve(dshHome), '.dsh-memory')
78
- : join(homedir(), '.dsh', '.dsh-memory')
79
- return cachedStateRoot
80
- }
81
-
82
- /** 旧版落点(插件包内 `data/`)——更新时会被整个替换,只作兼容读与迁移源。 */
83
- export function legacyDataRoot(): string {
84
- return join(repoRoot(), 'data')
85
- }
86
-
87
- function samePath(a: string, b: string): boolean {
88
- return process.platform === 'win32' ? a.toLowerCase() === b.toLowerCase() : a === b
89
- }
90
-
91
- /**
92
- * 用户可编辑的路径配置文件:
93
- * `<用户级状态根>/paths.json` → 不存在则回落**旧** `<插件仓>/data/paths.json`
94
- * (兼容读)→ 都不存在返回新位置(首次写入时创建)。
95
- * 不做自动复制:配置文件是「谁说了算」的唯一真源,悄悄复制会让旧件的后续编辑
96
- * 静默失效——迁移只搬数据面,配置显式交给用户搬(或用 `set_user_root`)。
97
- */
98
- export function pathsFile(): string {
99
- const current = join(stateRoot(), 'paths.json')
100
- if (existsSync(current)) return current
101
- const legacy = join(legacyDataRoot(), 'paths.json')
102
- return existsSync(legacy) ? legacy : current
103
- }
104
-
105
- /** 生效中的 paths.json 位置来源:`user`=用户级 / `legacy`=旧包内(兼容读)。 */
106
- export function pathsFileSource(): 'user' | 'legacy' {
107
- return samePath(dirname(pathsFile()), stateRoot()) ? 'user' : 'legacy'
108
- }
109
-
110
- function readUserPaths(): Record<string, unknown> {
111
- try {
112
- const raw = readFileSync(pathsFile(), 'utf8')
113
- const parsed: unknown = JSON.parse(raw)
114
- return parsed && typeof parsed === 'object' ? parsed as Record<string, unknown> : {}
115
- } catch {
116
- return {}
117
- }
118
- }
119
-
120
- /** 相对路径一律对「插件仓根」解析(不随宿主 cwd 漂移)。 */
121
- function anchor(p: string): string {
122
- return isAbsolute(p) ? p : resolve(repoRoot(), p)
123
- }
124
-
125
- /** 默认数据根 = 用户级状态根下 `data/`(**插件包目录之外**,更新不触碰)。 */
126
- export function defaultDataRoot(): string {
127
- return join(stateRoot(), 'data')
128
- }
129
-
130
- export interface LegacyMigration {
131
- /** 是否真的搬了(false 时 `reason` 说明为何没搬)。 */
132
- ran: boolean
133
- reason: string
134
- from: string
135
- to: string
136
- /** 复制成功的顶层条目数。 */
137
- copied: number
138
- /** 复制失败的顶层条目(权限/占用等,逐项吞掉不抛)。 */
139
- failed: string[]
140
- }
141
-
142
- /** dst 为「空目录」时 true(不存在/非目录/有内容均为 false)。 */
143
- function isEmptyDir(p: string): boolean {
144
- try {
145
- return readdirSync(p).length === 0
146
- } catch {
147
- return false
148
- }
149
- }
150
-
151
- /**
152
- * 一次性迁移:把旧版留在**插件包内** `data/` 的数据面复制到用户级默认数据根。
153
- *
154
- * 触发条件(三条同时满足,缺一不动):
155
- * ① 数据根未被显式配置(env `MDCG_DATA_ROOT` / paths.json 的 `data_root` 都未设,
156
- * 即 `dataRoot()` 恰为默认值)——显式配置是用户的决定,越权搬运等于改他的真源;
157
- * ② 旧位置存在;
158
- * ③ 目标顶层条目不存在或为空目录(**不覆盖、不合并**已有数据)。
159
- *
160
- * 只复制不删除(旧目录随后由 pnpm 更新自然移除);`paths.json` 不复制
161
- * (配置走 `pathsFile()` 兼容读,复制会制造「哪个文件说了算」的两说)。
162
- * 任何异常逐项吞掉并记入 `failed`——迁移是增益,不该成为启动失败源。
163
- *
164
- * 边界(如实):pnpm 更新是**先替换包目录再启动新代码**,故旧数据在升级瞬间
165
- * 即已消失,本函数只能接手「旧位置那时仍在」的情形(手工安装、就地覆盖、
166
- * 或包目录未被清理);已在升级中丢掉的数据无法由此恢复——发布说明须提示
167
- * 0.4.8 及更早用户升级前备份 `<profile>/node_modules/<pkg>/data/`。
168
- */
169
- export function migrateLegacyData(): LegacyMigration {
170
- const from = legacyDataRoot()
171
- const to = defaultDataRoot()
172
- const out: LegacyMigration = { ran: false, reason: '', from, to, copied: 0, failed: [] }
173
- if (!samePath(dataRoot(), to)) {
174
- out.reason = '数据根为显式配置(env/paths.json),不迁移'
175
- return out
176
- }
177
- if (!existsSync(from)) {
178
- out.reason = '旧位置不存在(多为更新时已随包目录被替换)'
179
- return out
180
- }
181
- let entries: string[]
182
- try {
183
- entries = readdirSync(from)
184
- } catch {
185
- out.reason = '旧位置不可读'
186
- return out
187
- }
188
- const names = entries.filter((n) => n !== 'paths.json')
189
- if (!names.length) {
190
- out.reason = '旧位置无数据'
191
- return out
192
- }
193
- for (const name of names) {
194
- const src = join(from, name)
195
- const dst = join(to, name)
196
- // 新位置已有实质内容 → 跳过(宁可少搬,不可覆盖)
197
- if (existsSync(dst) && !isEmptyDir(dst)) continue
198
- try {
199
- mkdirSync(to, { recursive: true })
200
- cpSync(src, dst, { recursive: true, force: false, errorOnExist: false })
201
- out.copied += 1
202
- } catch {
203
- out.failed.push(name)
204
- }
205
- }
206
- out.ran = out.copied > 0
207
- if (!out.ran) out.reason = out.failed.length ? '目标不可写' : '新位置已有数据,未覆盖'
208
- return out
209
- }
210
-
211
- export const ENV_CHILD_CWD = 'MDCG_CHILD_CWD'
212
-
213
- let cachedRunRoot: string | null = null
214
-
215
- /**
216
- * 子进程的工作目录(**必须落在插件包目录之外**)。
217
- *
218
- * 为什么不能沿用 `repoRoot()`:Windows 不允许删除/改名「正被某进程当作 CWD」
219
- * 的目录。DSH 的插件按 hoisted 布局安装在 `<profile>/node_modules/<pkg>`,
220
- * 而 `pnpm` 每次更新该包都要先 `rmdir` 包目录 → 子进程一旦把包目录当 CWD,
221
- * 更新必然 `ERR_PNPM_EBUSY: resource busy or locked`(含升级回滚一起失败,
222
- * 应用内永远升不动这个插件)。注意落点也**不能**是 `<包>/data`——它仍在包内,
223
- * 实测同样 `err=32`。
224
- *
225
- * 落点要求「稳定存在」:进程 cwd 指向已消失的目录会引出新的怪问题,故按稳定度
226
- * 排候选目录,取**第一个能建成**的:
227
- * 1. `MDCG_CHILD_CWD`(显式覆盖)
228
- * 2. `$DSH_HOME/.dsh-memory/run`
229
- * 3. `~/.dsh/.dsh-memory/run` —— 家目录兜底:`DSH_HOME` **未必**由宿主注入
230
- * (本仓 `dsh/dsh-web-start.bat` 是自行 `set DSH_HOME=%USERPROFILE%\.dsh`),
231
- * 而 `~/.dsh` 是本插件既有约定(`bridge.ts` 调试日志、`token_store` 密钥环同址)
232
- * 4. 系统临时目录(可能被清理,故排最后)
233
- * 全部建不成时不抛错,交给 spawn 报错——cwd 落点只是防呆,不该成为启动失败源。
234
- *
235
- * 安全性:`python -m` 的模块解析由 `pythonPathValue()` 的 PYTHONPATH 独立保证,
236
- * 不依赖 cwd;已实测 cwd=包目录 与 cwd=包外 时,MCP initialize 握手与
237
- * tools/list 工具面(33 个工具)完全一致。
238
- */
239
- export function runRoot(): string {
240
- if (cachedRunRoot) return cachedRunRoot
241
- const candidates: string[] = []
242
- const override = process.env[ENV_CHILD_CWD]
243
- if (override) candidates.push(resolve(override))
244
- const dshHome = process.env['DSH_HOME']
245
- if (dshHome) candidates.push(join(resolve(dshHome), '.dsh-memory', 'run'))
246
- candidates.push(join(homedir(), '.dsh', '.dsh-memory', 'run'))
247
- candidates.push(join(tmpdir(), 'dsh-memory-run'))
248
- for (const dir of candidates) {
249
- try {
250
- mkdirSync(dir, { recursive: true })
251
- cachedRunRoot = dir
252
- return dir
253
- } catch {
254
- /* 该候选不可用(父目录只读等)→ 试下一个 */
255
- }
256
- }
257
- const last = candidates[candidates.length - 1] ?? tmpdir()
258
- cachedRunRoot = last
259
- return last
260
- }
261
-
262
- /** 数据根(记忆/账本/运行态的父目录)。 */
263
- export function dataRoot(): string {
264
- const env = process.env[ENV_DATA_ROOT]
265
- if (env) return anchor(env)
266
- const cfg = readUserPaths()['data_root']
267
- if (typeof cfg === 'string' && cfg) return anchor(cfg)
268
- return defaultDataRoot()
269
- }
270
-
271
- /**
272
- * 认知图根(记忆唯一真源)。
273
- * @param configured 插件配置项 `mdcg.root`;空串/未给=None 表示未指定,走默认。
274
- */
275
- export function mdcgRoot(configured?: string): string {
276
- const env = process.env[ENV_MDCG_ROOT]
277
- if (env) return anchor(env)
278
- const cfg = readUserPaths()['root']
279
- if (typeof cfg === 'string' && cfg) return anchor(cfg)
280
- if (configured && configured.trim()) return anchor(configured.trim())
281
- return join(dataRoot(), 'mdcg')
282
- }
283
-
284
- /**
285
- * Python 子进程的 PYTHONPATH 值(issue #12)。
286
- *
287
- * Python 启动 `-m` 时只把 **cwd** 注入 sys.path——DSH 宿主在插件仓外启动时
288
- * `python -m md_cg.mcp_server` / `python -m md_cg.tokens` 必然
289
- * ModuleNotFoundError。cwd 与 PYTHONPATH 双保险:后者不依赖 cwd,即使调用方
290
- * 显式覆盖了启动参数/工作目录也兜得住。顺序:仓根在前(优先随包 md_cg,
291
- * 防宿主环境同名旧包抢先),进程既有 PYTHONPATH 在后。
292
- */
293
- export function pythonPathValue(): string {
294
- const prev = process.env.PYTHONPATH ?? ''
295
- const parts = [repoRoot()]
296
- if (prev && !prev.split(delimiter).includes(repoRoot())) parts.push(prev)
297
- return parts.join(delimiter)
298
- }
299
-
300
- /** 当前解析快照(供启动日志留痕——把「记忆真源在哪」写进可审计痕迹)。 */
301
- export function describeDataPaths(configured?: string): Record<string, string | boolean> {
302
- const dr = dataRoot()
303
- const mr = mdcgRoot(configured)
304
- const paths = readUserPaths()
305
- const pfSource = pathsFileSource()
306
- let source = 'default(用户级状态根 data/)'
307
- if (process.env[ENV_DATA_ROOT]) source = `env:${ENV_DATA_ROOT}`
308
- else if (process.env[ENV_MDCG_ROOT]) source = `env:${ENV_MDCG_ROOT}`
309
- else if (typeof paths['data_root'] === 'string' || typeof paths['root'] === 'string') {
310
- source = pfSource === 'user' ? 'paths.json(用户级)' : 'paths.json(兼容读旧包内位置)'
311
- } else if (configured && configured.trim()) source = 'config.mdcg.root'
312
- return {
313
- repoRoot: repoRoot(),
314
- stateRoot: stateRoot(),
315
- dataRoot: dr,
316
- mdcgRoot: mr,
317
- source,
318
- pathsFile: pathsFile(),
319
- pathsFileSource: pfSource,
320
- isDefault: samePath(dr, defaultDataRoot()),
321
- legacyDataRoot: legacyDataRoot(),
322
- legacyDataExists: existsSync(legacyDataRoot()),
323
- dataRootExists: existsSync(dr),
324
- mdcgRootExists: existsSync(mr),
325
- }
326
- }
1
+ /**
2
+ * datapath.ts · 灵枢数据根解析(记忆写入路径可配置)
3
+ *
4
+ * 与 Python 侧 `md_cg/datapath.py` **同口径**——两侧读同一份
5
+ * `<用户级状态根>/paths.json`(新位置;旧版 `<插件仓>/data/paths.json`
6
+ * 仍兼容读),避免大脑与脚本对「记忆真源在哪」各持一说。
7
+ *
8
+ * 为什么默认不再取「插件仓自身 data/」(issue #18 相邻问题,数据丢失级):
9
+ * DSH 插件按 hoisted 布局装在 `<profile>/node_modules/<pkg>`,`pnpm` 更新该包
10
+ * 会**整个替换包目录**——运行时数据落在包内(`<pkg>/data`)时,每次更新成功
11
+ * 即连目录一起删掉(贡献者实机实证:`data/` 54 文件 → 0,46 条记忆节点只能
12
+ * 靠人工备份回填);`paths.json` 同址,用户配置一并丢失。故默认数据根与配置
13
+ * 文件一律落**用户级状态根**(见 `stateRoot()`),与包目录彻底解耦。
14
+ *
15
+ * 优先级(高 → 低):
16
+ * 1. 环境变量 `MDCG_DATA_ROOT`(数据根)/ `MDCG_ROOT`(认知图根)
17
+ * 2. 用户可编辑配置 `paths.json` 的 `data_root` / `root`
18
+ * (位置:`<用户级状态根>/paths.json`;旧 `<插件仓>/data/paths.json` 兼容读)
19
+ * 3. 插件配置项 `mdcg.root`(可为空=未指定)
20
+ * 4. 默认 `<用户级状态根>/data/mdcg`
21
+ *
22
+ * 为什么默认不取「相对 cwd 的 data/mdcg」:
23
+ * node 侧插件与 python 侧脚本的 cwd 不同,相对路径会漂移成
24
+ * `<cwd>/data/mdcg`。历史事故:宿主 cwd 落在 AEIS 时,记忆真源
25
+ * 分裂到 `AEIS/data/mdcg`,与插件仓 `data/` 变成互不可见的两处。
26
+ *
27
+ * 旧数据接手:`migrateLegacyData()` 在默认数据根生效且旧包内位置仍有内容时
28
+ * 一次性**复制**(不删除、不覆盖)到用户级位置——见该函数注释。
29
+ */
30
+ import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync } from 'node:fs'
31
+ import { homedir, tmpdir } from 'node:os'
32
+ import { delimiter, dirname, isAbsolute, join, resolve } from 'node:path'
33
+ import { fileURLToPath } from 'node:url'
34
+
35
+ export const ENV_DATA_ROOT = 'MDCG_DATA_ROOT'
36
+ export const ENV_MDCG_ROOT = 'MDCG_ROOT'
37
+
38
+ let cachedRepoRoot: string | null = null
39
+
40
+ /** 插件仓根目录:自本模块所在目录向上找 package.json(对构建层级不敏感)。 */
41
+ export function repoRoot(): string {
42
+ if (cachedRepoRoot) return cachedRepoRoot
43
+ let dir = dirname(fileURLToPath(import.meta.url))
44
+ for (let i = 0; i < 6; i += 1) {
45
+ if (existsSync(join(dir, 'package.json'))) {
46
+ cachedRepoRoot = dir
47
+ return dir
48
+ }
49
+ const up = dirname(dir)
50
+ if (up === dir) break
51
+ dir = up
52
+ }
53
+ // 兜底:lib/lib/x.js 或 lib/x.js → 均回到仓根
54
+ cachedRepoRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..', '..')
55
+ return cachedRepoRoot
56
+ }
57
+
58
+ export const ENV_STATE_ROOT = 'MDCG_STATE_ROOT'
59
+
60
+ let cachedStateRoot: string | null = null
61
+
62
+ /**
63
+ * 路径的波浪线展开——**本判据在 TS 侧的唯一实现**(N167 先例 + N117 双口径分叉)。
64
+ *
65
+ * 判据(**与 python 侧 `md_cg/datapath.py::_expand_home` 逐条同口径**):
66
+ * `~` → 家目录
67
+ * `~/x` → 家目录/x
68
+ * `~\x` → 家目录/x(分隔符不按平台分派:N167 的 --root 先例即把 `~\` 一并算作
69
+ * 可用分隔符,POSIX 上同样判——见 python 侧同一条登记的对照读数)
70
+ * `~user` / `~abc` / 其余(含相对路径、空串)→ **原样返回**
71
+ *
72
+ * 为什么必须展开(事故形态,可复现):本模块的 env 覆盖值在 python 侧一律先做波浪线
73
+ * 展开再 abspath,node 侧不展开就会把 `MDCG_ROOT=~/mem` 解析成 `<插件仓根>/~/mem`
74
+ * 字面 `~` 目录——同一台机器上 python CLI(`datapath.mdcg_root()` / sleep / mreview)
75
+ * 落 `<家目录>/mem`,插件落仓内 `~/mem`,**记忆真源分裂成互不可见的两处**。
76
+ * `runRoot()` 的覆盖值落进包内还会触发该函数自己文档写明要避免的 `ERR_PNPM_EBUSY`
77
+ * (cwd 在包内 → pnpm 更新 rmdir 包目录必失败)。
78
+ *
79
+ * **`~user` 两侧都不展开(方案 a,2026-10-16 维护者裁定项 §二格 1)——双侧对称登记**:
80
+ * 本行是 TS 侧登记,python 侧在 `md_cg/datapath.py::_expand_home` 的 docstring 里有
81
+ * 一条对等登记,仓内留档见 `docs/eval/路径解析点盘点_同口径判定_v1.0.md`。
82
+ * 取 (a) 而非 (b) 的理由:`~user` 的语义是「查账号库拿该用户的 home」,两侧都做不到
83
+ * 同一种查询——posix 的 `os.path.expanduser` 走 `pwd.getpwnam`(查得到就展开,查不到
84
+ * 原样保留,结果随本机账号而变),ntpath 只在用户名等于当前用户时才展开。同一份 env
85
+ * 在两端落点不同 = 正是本 issue(分叉)本身,故**宁两侧同留字面量**。
86
+ * 收敛代价(如实):POSIX 上 `MDCG_ROOT=~ybyz/mem` 从「展开成 /home/ybyz/mem」变成
87
+ * 「原样 `~ybyz/mem`」——该形态在两侧都不再自动指向别人家目录,需用户写全路径。
88
+ *
89
+ * **唯一实现**:`src/init.ts` 的 `--root` 展开已改为调用本函数(原 `expandHomeTilde`
90
+ * 已删),源码面断言见 `test/datapath-expandhome.test.ts`——该断言扫 `src/` 下全部
91
+ * `.ts`(递归),发现第二处同判据即报红(反例读数为证)。
92
+ *
93
+ * **适用边界**:只用于 env 覆盖值与 `init.ts` 的 `--root`。`paths.json` 的取值**不接**
94
+ * ——两侧对配置文件里的相对值(含 `~/...`)都是「先拼插件仓根再归一」,单方面展开会
95
+ * 新造一条分叉;该面同口径的实测见留档文档。
96
+ *
97
+ * @param home 家目录(缺省 `os.homedir()`;可注入,供测试与 `init.ts` 的 `--home` 语义)
98
+ */
99
+ export function expandHome(p: string, home: string = homedir()): string {
100
+ if (p === '~') return home
101
+ if (p.startsWith('~/') || p.startsWith('~\\')) return join(home, p.slice(2))
102
+ return p
103
+ }
104
+
105
+ /**
106
+ * 用户级状态根(**插件包目录之外**):路径配置与默认数据根的落点。
107
+ * 优先级:`MDCG_STATE_ROOT` → `$DSH_HOME/.dsh-memory` → `~/.dsh/.dsh-memory`。
108
+ * `DSH_HOME` **未必**由宿主注入(本仓 `dsh/dsh-web-start.bat` 自行 set),
109
+ * 故家目录兜底;`~/.dsh` 是本插件既有约定(`bridge.ts` 调试日志同址)。
110
+ */
111
+ export function stateRoot(): string {
112
+ if (cachedStateRoot) return cachedStateRoot
113
+ const env = process.env[ENV_STATE_ROOT]
114
+ if (env) {
115
+ cachedStateRoot = resolve(expandHome(env))
116
+ return cachedStateRoot
117
+ }
118
+ const dshHome = process.env['DSH_HOME']
119
+ cachedStateRoot = dshHome
120
+ ? join(resolve(dshHome), '.dsh-memory')
121
+ : join(homedir(), '.dsh', '.dsh-memory')
122
+ return cachedStateRoot
123
+ }
124
+
125
+ /** 旧版落点(插件包内 `data/`)——更新时会被整个替换,只作兼容读与迁移源。 */
126
+ export function legacyDataRoot(): string {
127
+ return join(repoRoot(), 'data')
128
+ }
129
+
130
+ function samePath(a: string, b: string): boolean {
131
+ return process.platform === 'win32' ? a.toLowerCase() === b.toLowerCase() : a === b
132
+ }
133
+
134
+ /**
135
+ * 用户可编辑的路径配置文件:
136
+ * `<用户级状态根>/paths.json` → 不存在则回落**旧** `<插件仓>/data/paths.json`
137
+ * (兼容读)→ 都不存在返回新位置(首次写入时创建)。
138
+ * 不做自动复制:配置文件是「谁说了算」的唯一真源,悄悄复制会让旧件的后续编辑
139
+ * 静默失效——迁移只搬数据面,配置显式交给用户搬(或用 `set_user_root`)。
140
+ */
141
+ export function pathsFile(): string {
142
+ const current = join(stateRoot(), 'paths.json')
143
+ if (existsSync(current)) return current
144
+ const legacy = join(legacyDataRoot(), 'paths.json')
145
+ return existsSync(legacy) ? legacy : current
146
+ }
147
+
148
+ /** 生效中的 paths.json 位置来源:`user`=用户级 / `legacy`=旧包内(兼容读)。 */
149
+ export function pathsFileSource(): 'user' | 'legacy' {
150
+ return samePath(dirname(pathsFile()), stateRoot()) ? 'user' : 'legacy'
151
+ }
152
+
153
+ /**
154
+ * `paths.json` 存在但无法解析 / 顶层不是 JSON 对象(issue #352-D)。
155
+ *
156
+ * 改前 `readUserPaths()` 用一个空 `catch` 把「文件不存在」与「文件存在但坏了」
157
+ * 混成同一个 `{}`,于是坏配置下 `mdcgRoot()` **无声回落到默认库**——用户看到
158
+ * 的是「原有记忆从检索面消失」,而 python 侧仍按同一份坏文件走,两边分成两个库。
159
+ *
160
+ * **为什么响亮失败而不是告警后回落**:本仓先例 #161「打包面静默坏包 ⇒ 改为
161
+ * 响亮失败」。这里静默的代价是**数据分叉**(比启动失败更难发现、更难收拾),
162
+ * 故取 fail-closed:直接抛出,错误消息写全恢复路径。若维护者认为「插件起不来」
163
+ * 的代价更高,可改为「console.error + 在 describeDataPaths / op=info 里点名,
164
+ * 再回落」——本类即该告警面将来的载体(`code`/`pathsFile` 已留好)。
165
+ */
166
+ export class PathsConfigError extends Error {
167
+ readonly code = 'E_PATHS_CONFIG'
168
+ readonly pathsFile: string
169
+
170
+ constructor(message: string, pathsFile: string) {
171
+ super(message)
172
+ this.name = 'PathsConfigError'
173
+ this.pathsFile = pathsFile
174
+ }
175
+ }
176
+
177
+ function pathsConfigMessage(pf: string, why: string): string {
178
+ return `${pf} 无法解析(${why})——**未回落默认库**:记忆真源由该文件决定,`
179
+ + `静默回落会让原有记忆从检索面消失、新写入分叉到另一个库(#352-D)。`
180
+ + `请修正该文件(Windows 上常见两种写坏:记事本 / PowerShell 5 存成 `
181
+ + `UTF-8 BOM;路径里的反斜杠未转义,应写 \\\\ 或改用 /),`
182
+ + `或删掉它回到用户级默认数据根后重启。`
183
+ }
184
+
185
+ function readUserPaths(): Record<string, unknown> {
186
+ const pf = pathsFile()
187
+ // 「文件不存在」=用户没配过(合法,返回空表);「文件在但读不出/解析不出」
188
+ // =配置坏了(响亮失败)——这两件事从此**分开**,不再混成同一个 {}。
189
+ if (!existsSync(pf)) return {}
190
+ let raw: string
191
+ try {
192
+ raw = readFileSync(pf, 'utf8')
193
+ } catch (e) {
194
+ throw new PathsConfigError(pathsConfigMessage(pf, `读取失败:${String(e)}`), pf)
195
+ }
196
+ let parsed: unknown
197
+ try {
198
+ // BOM:记事本 / PowerShell 5 的 `Set-Content -Encoding UTF8` 会写出 UTF-8 BOM,
199
+ // `JSON.parse` 直接拒收(与 python 侧 `utf-8-sig` 同一口径)。
200
+ parsed = JSON.parse(raw.replace(/^\uFEFF/, ''))
201
+ } catch (e) {
202
+ throw new PathsConfigError(pathsConfigMessage(pf, String(e)), pf)
203
+ }
204
+ if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
205
+ // 合法 JSON、错形状:同样会让配置位静默失效,同一口径处理。
206
+ throw new PathsConfigError(pathsConfigMessage(pf, '顶层不是 JSON 对象'), pf)
207
+ }
208
+ return parsed as Record<string, unknown>
209
+ }
210
+
211
+ /** 相对路径一律对「插件仓根」解析(不随宿主 cwd 漂移)。 */
212
+ function anchor(p: string): string {
213
+ return isAbsolute(p) ? p : resolve(repoRoot(), p)
214
+ }
215
+
216
+ /** 默认数据根 = 用户级状态根下 `data/`(**插件包目录之外**,更新不触碰)。 */
217
+ export function defaultDataRoot(): string {
218
+ return join(stateRoot(), 'data')
219
+ }
220
+
221
+ export interface LegacyMigration {
222
+ /** 是否真的搬了(false 时 `reason` 说明为何没搬)。 */
223
+ ran: boolean
224
+ reason: string
225
+ from: string
226
+ to: string
227
+ /** 复制成功的顶层条目数。 */
228
+ copied: number
229
+ /** 复制失败的顶层条目(权限/占用等,逐项吞掉不抛)。 */
230
+ failed: string[]
231
+ }
232
+
233
+ /** dst 为「空目录」时 true(不存在/非目录/有内容均为 false)。 */
234
+ function isEmptyDir(p: string): boolean {
235
+ try {
236
+ return readdirSync(p).length === 0
237
+ } catch {
238
+ return false
239
+ }
240
+ }
241
+
242
+ /**
243
+ * 一次性迁移:把旧版留在**插件包内** `data/` 的数据面复制到用户级默认数据根。
244
+ *
245
+ * 触发条件(三条同时满足,缺一不动):
246
+ * ① 数据根未被显式配置(env `MDCG_DATA_ROOT` / paths.json 的 `data_root` 都未设,
247
+ * 即 `dataRoot()` 恰为默认值)——显式配置是用户的决定,越权搬运等于改他的真源;
248
+ * ② 旧位置存在;
249
+ * ③ 目标顶层条目不存在或为空目录(**不覆盖、不合并**已有数据)。
250
+ *
251
+ * 只复制不删除(旧目录随后由 pnpm 更新自然移除);`paths.json` 不复制
252
+ * (配置走 `pathsFile()` 兼容读,复制会制造「哪个文件说了算」的两说)。
253
+ * 任何异常逐项吞掉并记入 `failed`——迁移是增益,不该成为启动失败源。
254
+ *
255
+ * 边界(如实):pnpm 更新是**先替换包目录再启动新代码**,故旧数据在升级瞬间
256
+ * 即已消失,本函数只能接手「旧位置那时仍在」的情形(手工安装、就地覆盖、
257
+ * 或包目录未被清理);已在升级中丢掉的数据无法由此恢复——发布说明须提示
258
+ * 0.4.8 及更早用户升级前备份 `<profile>/node_modules/<pkg>/data/`。
259
+ */
260
+ export function migrateLegacyData(): LegacyMigration {
261
+ const from = legacyDataRoot()
262
+ const to = defaultDataRoot()
263
+ const out: LegacyMigration = { ran: false, reason: '', from, to, copied: 0, failed: [] }
264
+ if (!samePath(dataRoot(), to)) {
265
+ out.reason = '数据根为显式配置(env/paths.json),不迁移'
266
+ return out
267
+ }
268
+ if (!existsSync(from)) {
269
+ out.reason = '旧位置不存在(多为更新时已随包目录被替换)'
270
+ return out
271
+ }
272
+ let entries: string[]
273
+ try {
274
+ entries = readdirSync(from)
275
+ } catch {
276
+ out.reason = '旧位置不可读'
277
+ return out
278
+ }
279
+ const names = entries.filter((n) => n !== 'paths.json')
280
+ if (!names.length) {
281
+ out.reason = '旧位置无数据'
282
+ return out
283
+ }
284
+ for (const name of names) {
285
+ const src = join(from, name)
286
+ const dst = join(to, name)
287
+ // 新位置已有实质内容 → 跳过(宁可少搬,不可覆盖)
288
+ if (existsSync(dst) && !isEmptyDir(dst)) continue
289
+ try {
290
+ mkdirSync(to, { recursive: true })
291
+ cpSync(src, dst, { recursive: true, force: false, errorOnExist: false })
292
+ out.copied += 1
293
+ } catch {
294
+ out.failed.push(name)
295
+ }
296
+ }
297
+ out.ran = out.copied > 0
298
+ if (!out.ran) out.reason = out.failed.length ? '目标不可写' : '新位置已有数据,未覆盖'
299
+ return out
300
+ }
301
+
302
+ export const ENV_CHILD_CWD = 'MDCG_CHILD_CWD'
303
+
304
+ let cachedRunRoot: string | null = null
305
+
306
+ /**
307
+ * 子进程的工作目录(**必须落在插件包目录之外**)。
308
+ *
309
+ * 为什么不能沿用 `repoRoot()`:Windows 不允许删除/改名「正被某进程当作 CWD」
310
+ * 的目录。DSH 的插件按 hoisted 布局安装在 `<profile>/node_modules/<pkg>`,
311
+ * 而 `pnpm` 每次更新该包都要先 `rmdir` 包目录 → 子进程一旦把包目录当 CWD,
312
+ * 更新必然 `ERR_PNPM_EBUSY: resource busy or locked`(含升级回滚一起失败,
313
+ * 应用内永远升不动这个插件)。注意落点也**不能**是 `<包>/data`——它仍在包内,
314
+ * 实测同样 `err=32`。
315
+ *
316
+ * 落点要求「稳定存在」:进程 cwd 指向已消失的目录会引出新的怪问题,故按稳定度
317
+ * 排候选目录,取**第一个能建成**的:
318
+ * 1. `MDCG_CHILD_CWD`(显式覆盖)
319
+ * 2. `$DSH_HOME/.dsh-memory/run`
320
+ * 3. `~/.dsh/.dsh-memory/run` —— 家目录兜底:`DSH_HOME` **未必**由宿主注入
321
+ * (本仓 `dsh/dsh-web-start.bat` 是自行 `set DSH_HOME=%USERPROFILE%\.dsh`),
322
+ * 而 `~/.dsh` 是本插件既有约定(`bridge.ts` 调试日志、`token_store` 密钥环同址)
323
+ * 4. 系统临时目录(可能被清理,故排最后)
324
+ * 全部建不成时不抛错,交给 spawn 报错——cwd 落点只是防呆,不该成为启动失败源。
325
+ *
326
+ * 安全性:`python -m` 的模块解析由 `pythonPathValue()` 的 PYTHONPATH 独立保证,
327
+ * 不依赖 cwd;已实测 cwd=包目录 与 cwd=包外 时,MCP initialize 握手与
328
+ * tools/list 工具面(33 个工具)完全一致。
329
+ */
330
+ export function runRoot(): string {
331
+ if (cachedRunRoot) return cachedRunRoot
332
+ const candidates: string[] = []
333
+ const override = process.env[ENV_CHILD_CWD]
334
+ if (override) candidates.push(resolve(expandHome(override)))
335
+ const dshHome = process.env['DSH_HOME']
336
+ if (dshHome) candidates.push(join(resolve(dshHome), '.dsh-memory', 'run'))
337
+ candidates.push(join(homedir(), '.dsh', '.dsh-memory', 'run'))
338
+ candidates.push(join(tmpdir(), 'dsh-memory-run'))
339
+ for (const dir of candidates) {
340
+ try {
341
+ mkdirSync(dir, { recursive: true })
342
+ cachedRunRoot = dir
343
+ return dir
344
+ } catch {
345
+ /* 该候选不可用(父目录只读等)→ 试下一个 */
346
+ }
347
+ }
348
+ const last = candidates[candidates.length - 1] ?? tmpdir()
349
+ cachedRunRoot = last
350
+ return last
351
+ }
352
+
353
+ /** 数据根(记忆/账本/运行态的父目录)。 */
354
+ export function dataRoot(): string {
355
+ const env = process.env[ENV_DATA_ROOT]
356
+ // env 覆盖值先做波浪线展开再定锚(唯一实现 expandHome;N117)
357
+ if (env) return anchor(expandHome(env))
358
+ const cfg = readUserPaths()['data_root']
359
+ if (typeof cfg === 'string' && cfg) return anchor(cfg)
360
+ return defaultDataRoot()
361
+ }
362
+
363
+ /**
364
+ * 认知图根(记忆唯一真源)。
365
+ * @param configured 插件配置项 `mdcg.root`;空串/未给=None 表示未指定,走默认。
366
+ */
367
+ export function mdcgRoot(configured?: string): string {
368
+ const env = process.env[ENV_MDCG_ROOT]
369
+ // env 覆盖值先做波浪线展开再定锚(唯一实现 expandHome;N117)
370
+ if (env) return anchor(expandHome(env))
371
+ const cfg = readUserPaths()['root']
372
+ if (typeof cfg === 'string' && cfg) return anchor(cfg)
373
+ if (configured && configured.trim()) return anchor(configured.trim())
374
+ return join(dataRoot(), 'mdcg')
375
+ }
376
+
377
+ /**
378
+ * Python 子进程的 PYTHONPATH 值(issue #12)。
379
+ *
380
+ * Python 启动 `-m` 时只把 **cwd** 注入 sys.path——DSH 宿主在插件仓外启动时
381
+ * `python -m md_cg.mcp_server` / `python -m md_cg.tokens` 必然
382
+ * ModuleNotFoundError。cwd 与 PYTHONPATH 双保险:后者不依赖 cwd,即使调用方
383
+ * 显式覆盖了启动参数/工作目录也兜得住。顺序:仓根在前(优先随包 md_cg,
384
+ * 防宿主环境同名旧包抢先),进程既有 PYTHONPATH 在后。
385
+ */
386
+ export function pythonPathValue(): string {
387
+ const prev = process.env.PYTHONPATH ?? ''
388
+ const parts = [repoRoot()]
389
+ if (prev && !prev.split(delimiter).includes(repoRoot())) parts.push(prev)
390
+ return parts.join(delimiter)
391
+ }
392
+
393
+ /** 当前解析快照(供启动日志留痕——把「记忆真源在哪」写进可审计痕迹)。 */
394
+ export function describeDataPaths(configured?: string): Record<string, string | boolean> {
395
+ const dr = dataRoot()
396
+ const mr = mdcgRoot(configured)
397
+ const paths = readUserPaths()
398
+ const pfSource = pathsFileSource()
399
+ let source = 'default(用户级状态根 data/)'
400
+ if (process.env[ENV_DATA_ROOT]) source = `env:${ENV_DATA_ROOT}`
401
+ else if (process.env[ENV_MDCG_ROOT]) source = `env:${ENV_MDCG_ROOT}`
402
+ else if (typeof paths['data_root'] === 'string' || typeof paths['root'] === 'string') {
403
+ source = pfSource === 'user' ? 'paths.json(用户级)' : 'paths.json(兼容读旧包内位置)'
404
+ } else if (configured && configured.trim()) source = 'config.mdcg.root'
405
+ return {
406
+ repoRoot: repoRoot(),
407
+ stateRoot: stateRoot(),
408
+ dataRoot: dr,
409
+ mdcgRoot: mr,
410
+ source,
411
+ pathsFile: pathsFile(),
412
+ pathsFileSource: pfSource,
413
+ isDefault: samePath(dr, defaultDataRoot()),
414
+ legacyDataRoot: legacyDataRoot(),
415
+ legacyDataExists: existsSync(legacyDataRoot()),
416
+ dataRootExists: existsSync(dr),
417
+ mdcgRootExists: existsSync(mr),
418
+ }
419
+ }