@furongjun1999/dsh-memory 0.8.1 → 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 -659
  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 -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 +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_p47_session_view.py +25 -9
  437. package/md_cg/test_p4_freshness.py +8 -1
  438. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  439. package/md_cg/test_p9c_dedup_hints.py +7 -2
  440. package/md_cg/test_policy_required_ccg.py +12 -0
  441. package/md_cg/test_postings_digest_memo.py +139 -0
  442. package/md_cg/test_predict_beta.py +138 -135
  443. package/md_cg/test_qmd.py +500 -0
  444. package/md_cg/test_query_excerpt.py +209 -0
  445. package/md_cg/test_reach.py +456 -378
  446. package/md_cg/test_reach_snapshot_admission.py +218 -0
  447. package/md_cg/test_readcache_prodpath.py +4 -0
  448. package/md_cg/test_recall_face_guards.py +854 -812
  449. package/md_cg/test_recall_metadata.py +422 -0
  450. package/md_cg/test_retr_s5.py +104 -5
  451. package/md_cg/test_retr_score_once.py +14 -2
  452. package/md_cg/test_review_cli_attribution.py +11 -7
  453. package/md_cg/test_review_queue_batch.py +123 -0
  454. package/md_cg/test_review_queue_index.py +130 -0
  455. package/md_cg/test_rrf_candidates.py +292 -0
  456. package/md_cg/test_rrf_qualified_topk.py +214 -0
  457. package/md_cg/test_rrf_unique_votes.py +218 -0
  458. package/md_cg/test_s1_ast_judge.py +110 -0
  459. package/md_cg/test_scrub_ledger.py +413 -0
  460. package/md_cg/test_security_audit_b26.py +34 -3
  461. package/md_cg/test_security_audit_v21.py +1 -2
  462. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  463. package/md_cg/test_session5_identity.py +93 -0
  464. package/md_cg/test_session_attribution_consistency.py +813 -0
  465. package/md_cg/test_session_identity_tristate.py +486 -0
  466. package/md_cg/test_sleep_p1.py +35 -3
  467. package/md_cg/test_state_event_op.py +8 -1
  468. package/md_cg/test_state_projection_streaming.py +136 -0
  469. package/md_cg/test_stg_interval_candidates.py +280 -0
  470. package/md_cg/test_stg_time_blocks.py +239 -0
  471. package/md_cg/test_stgidx_index_parity.py +16 -12
  472. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  473. package/md_cg/test_sustain_bounded.py +30 -2
  474. package/md_cg/test_task_memory.py +394 -0
  475. package/md_cg/test_text_projection_mutations.py +101 -0
  476. package/md_cg/test_time_anchor.py +421 -0
  477. package/md_cg/test_time_core_lint.py +1024 -975
  478. package/md_cg/test_tool_face.py +200 -189
  479. package/md_cg/test_trust_bounded_frontier.py +248 -0
  480. package/md_cg/test_trust_edge_reachability.py +405 -0
  481. package/md_cg/test_w5_path_fingerprint.py +381 -0
  482. package/md_cg/test_w7_redlines.py +659 -0
  483. package/md_cg/test_write_return_shape.py +919 -0
  484. package/md_cg/test_writepipe.py +5 -3
  485. package/md_cg/timeanchor.py +534 -0
  486. package/md_cg/tokens.py +68 -5
  487. package/md_cg/tool_face.py +273 -260
  488. package/md_cg/trust.py +110 -26
  489. package/md_cg/twophase.py +74 -2
  490. package/md_cg/weights.py +642 -638
  491. package/md_cg/whitebox.py +9 -0
  492. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  493. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  494. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  495. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  496. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  497. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  498. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  499. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  500. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  501. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  502. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  503. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  504. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  505. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  506. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  507. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  508. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  509. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  510. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  511. package/md_cg/writelimit.py +584 -390
  512. package/md_cg/writepipe.py +587 -76
  513. package/package.json +13 -9
  514. package/src/bridge.ts +34 -11
  515. package/src/cli.ts +75 -65
  516. package/src/hooks.ts +908 -776
  517. package/src/index.ts +19 -5
  518. package/src/init.ts +362 -361
  519. package/src/lib/datapath.ts +419 -326
  520. package/src/lib/hook_audit.ts +256 -243
  521. package/src/lib/mdcg_client.ts +10 -2
  522. package/src/lib/mutual.ts +481 -432
  523. package/src/lib/prompt_safety.ts +164 -149
  524. package/src/lib/roleplay_web.ts +30 -2
  525. package/src/lib/token_store.ts +274 -52
  526. package/src/tools.ts +249 -223
  527. package/zcode/README.md +1 -1
  528. 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
  529. 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
  530. 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
  531. 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
  532. 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
  533. 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
  534. 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
  535. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  536. 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
  537. 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
  538. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  539. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  540. 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
  541. 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
  542. 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
  543. 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
  544. 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
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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
  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
@@ -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
+ }