@furongjun1999/dsh-memory 0.8.0 → 0.9.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (714) hide show
  1. package/README.md +662 -632
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +1 -1
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +13 -1
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +16 -1
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +8 -2
  34. package/lib/tools.js +22 -3
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +22 -5
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +572 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +14 -3
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +86 -5
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7104 -5417
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +4 -1
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +12 -3
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +43 -3
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  531. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  532. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  535. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  539. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  543. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  545. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  547. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  548. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  549. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  550. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  551. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  552. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  553. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  554. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  555. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  556. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  559. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  560. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  561. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  563. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  564. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  565. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  566. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  567. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  568. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  569. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  570. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  571. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  572. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -152
  573. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  574. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  575. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  576. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  577. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  578. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  579. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  580. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  581. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  582. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  583. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  584. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  585. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  586. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  587. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  588. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  617. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  618. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  619. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  620. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  621. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  622. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  623. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  624. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  625. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  626. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  627. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  628. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  629. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  630. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  631. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  632. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  647. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  648. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  649. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  650. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  653. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  654. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  655. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  656. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  657. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  658. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  659. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  662. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  663. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  666. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  667. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  668. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  669. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  670. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  671. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  672. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  673. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  674. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  675. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  676. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  677. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  678. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  679. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  688. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  689. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  690. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  691. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  692. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  693. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  694. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  695. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  696. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  699. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  700. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  701. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  702. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  703. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  704. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  705. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  706. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  707. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  708. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  709. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  710. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  711. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  712. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  713. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  714. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
package/src/init.ts CHANGED
@@ -1,361 +1,362 @@
1
- #!/usr/bin/env node
2
- /**
3
- * init.ts —— 灵枢一键配置生成器(独立 CLI 入口:`lingshu-init`)
4
- *
5
- * 用户痛点:部署灵枢要手工做多步——选记忆根目录、手写各端 mcp.json 的
6
- * env(MDCG_ROOT / MDCG_PYTHON 等)、理解令牌签发。本命令把「生成配置」
7
- * 这一步自动化:三问(接入端 / 记忆根目录 / Python 解释器)后打印所选端
8
- * 的 mcp.json 配置片段、把片段落盘成可复制的文件、并给出各端后续步骤
9
- * (片段放哪 / 令牌签发命令——后者指向 README「写入凭据」节)。
10
- *
11
- * 边界(刻意设计,勿越界):
12
- * · init **只生成配置**——不创建记忆目录、不启动 md_cg 服务、不写库;
13
- * 重跑(同参数)输出逐字节一致(无时间戳等易变内容),可放心重复执行。
14
- * · 与插件运行时的数据根缺省(`~/.dsh/.dsh-memory/data/mdcg`,见
15
- * `src/lib/datapath.ts`)不同,本命令的缺省记忆根是 `~/.lingshu/memory`
16
- * ——它会被**显式写进**片段的 MDCG_ROOT,两侧不靠默契、无歧义。
17
- *
18
- * env 片段口径与 `mdcgChildEnv()`(src/lib/mdcg_client.ts)对齐:
19
- * PYTHONIOENCODING/PYTHONUTF8 两条编码注入是硬约束(中文记忆场景,
20
- * 详见该函数头注的 2026-09-20 读线程崩溃现场);MDCG_MCP_SURFACE=kernel
21
- * 与各端 mcp.json 样例(claude/lingshu-memory/mcp.json.example 等)同口径。
22
- * MDCG_PYTHON 对直挂端是文档性键(解释器由 command 决定),对 DSH 插件端
23
- * 真实生效(`defaultPython()` 读它,src/lib/python_path.ts:42)。
24
- *
25
- * 零运行时依赖:只用 Node 内置模块(node:readline/promises / node:fs /
26
- * node:path)——与全仓「CLI 不加第三方依赖」纪律一致。
27
- */
28
-
29
- import { writeFileSync } from 'node:fs'
30
- import { homedir } from 'node:os'
31
- import { createInterface } from 'node:readline/promises'
32
- import type { Readable, Writable } from 'node:stream'
33
- import { join, resolve } from 'node:path'
34
- import { pathToFileURL } from 'node:url'
35
- import { repoRoot } from './lib/datapath.js'
36
- import { defaultPython } from './lib/python_path.js'
37
-
38
- /** 接入端:1=DSH 插件 2=Claude Code 3=Codex CLI 4=通用 MCP。 */
39
- export type InitEnd = 'dsh' | 'claude' | 'codex' | 'generic'
40
-
41
- interface EndSpec {
42
- id: InitEnd
43
- /** 问答菜单里的展示名。 */
44
- label: string
45
- /** MDCG_ACTOR(与既有各端样例/插件配置同口径;私有内容按 (tenant, actor) 派生 DEK)。 */
46
- actor: string
47
- /** 片段该放到哪(打印给用户)。 */
48
- configTarget: string
49
- /** 令牌签发指引里说明的角色语境(保持 README 口径,仅按端换 actor)。 */
50
- tokenActor: string
51
- }
52
-
53
- const ENDS: ReadonlyArray<EndSpec> = [
54
- {
55
- id: 'dsh',
56
- label: 'DSH 插件',
57
- actor: 'dsh-memory',
58
- configTarget: 'DSH 无全局 mcp.json——推荐走插件形态(下方指引②);下方 JSON 为 MCP 直挂等价形态',
59
- tokenActor: 'dsh-memory',
60
- },
61
- {
62
- id: 'claude',
63
- label: 'Claude Code',
64
- actor: 'claude-code',
65
- configTarget: '项目根 .mcp.json(把片段的 mcpServers 并入;或 ~/.claude.json 全局)',
66
- tokenActor: 'claude-code',
67
- },
68
- {
69
- id: 'codex',
70
- label: 'Codex CLI',
71
- actor: 'codex',
72
- configTarget: '~/.codex/config.toml 的 [mcp_servers.mdcg] 段(TOML 形态见 codex/config.toml.example:env 为 [mcp_servers.mdcg.env] 表)',
73
- tokenActor: 'codex',
74
- },
75
- {
76
- id: 'generic',
77
- label: '通用 MCP 宿主',
78
- actor: 'generic',
79
- configTarget: '宿主的 MCP server 配置处(command/args/env 三元组,按宿主文档挂载 stdio server)',
80
- tokenActor: 'generic',
81
- },
82
- ]
83
-
84
- /** --end 的宽松别名(含菜单数字)。未知值报错并列出允许集。 */
85
- function matchEnd(value: string): EndSpec | null {
86
- const v = value.trim().toLowerCase()
87
- for (const e of ENDS) {
88
- if (v === e.id || v === e.label) return e
89
- }
90
- const aliases: Record<string, InitEnd> = {
91
- '1': 'dsh', dsh: 'dsh',
92
- '2': 'claude', claude: 'claude', 'claude-code': 'claude', claudecode: 'claude',
93
- '3': 'codex', codex: 'codex',
94
- '4': 'generic', generic: 'generic', mcp: 'generic',
95
- }
96
- const id = aliases[v]
97
- return id ? ENDS.find((e) => e.id === id) ?? null : null
98
- }
99
-
100
- /** 缺省记忆根:<home>/.lingshu/memory(home 可注入,供测试)。 */
101
- export function defaultMemoryRoot(home: string = homedir()): string {
102
- return join(home, '.lingshu', 'memory')
103
- }
104
-
105
- /**
106
- * N167:根入口波浪线展开——`~` / `~/x`(含 `~\x`)前缀按 home 展开,缺省
107
- * os.homedir()。与大脑侧 md_cg/datapath.py 的 expanduser+abspath 同口径:
108
- * 帮助文案与 :264 自带示例都写着「--root ~/.lingshu/memory」,不展开就会把
109
- * 记忆根解析成宿主 cwd 下的字面 ~ 目录——落错位且随 cwd 漂移分裂。
110
- * 边界:`~user` 形态 Node 无便携语义(POSIX pwd 查询不可用),原样保留。
111
- */
112
- function expandHomeTilde(p: string, home: string = homedir()): string {
113
- if (p === '~') return home
114
- if (p.startsWith('~/') || p.startsWith('~\\')) return join(home, p.slice(2))
115
- return p
116
- }
117
-
118
- /** 生成的 mcp.json 片段(键序固定 → 序列化稳定 → 幂等)。 */
119
- export function buildSnippet(end: EndSpec, root: string, python: string): {
120
- mcpServers: { mdcg: { command: string, args: string[], env: Record<string, string> } }
121
- } {
122
- return {
123
- mcpServers: {
124
- mdcg: {
125
- command: python,
126
- args: ['-m', 'md_cg.mcp_server'],
127
- env: {
128
- // 随包 md_cg 的绝对路径(本包 files 自带 md_cg/):python -m 的模块
129
- // 解析不依赖 cwd,靠 PYTHONPATH(口径同 src/lib/datapath.ts pythonPathValue,
130
- // 此处为静态配置故取纯包根、不拼进程既有 PYTHONPATH)。
131
- PYTHONPATH: repoRoot(),
132
- PYTHONIOENCODING: 'utf-8',
133
- PYTHONUTF8: '1',
134
- MDCG_ROOT: root,
135
- // 直挂端文档性键(解释器由 command 决定);DSH 插件端真实生效。
136
- MDCG_PYTHON: python,
137
- MDCG_MCP_SURFACE: 'kernel',
138
- MDCG_ACTOR: end.actor,
139
- MDCG_TENANT: 'default',
140
- MDCG_CLEARANCE: 'private',
141
- MDCG_TOKEN: '',
142
- },
143
- },
144
- },
145
- }
146
- }
147
-
148
- /** 令牌签发命令文案(与 README「写入凭据」节逐字同口径,仅按端换 actor)。 */
149
- function tokenCommand(python: string, tokenActor: string, comment: string): string[] {
150
- return [
151
- `${comment}令牌签发(需 Python 环境 + 本包 md_cg;签发后把输出填进片段 MDCG_TOKEN,详见 README「写入凭据」节):`,
152
- ` ${python} -m md_cg.tokens issue --role designer --actor ${tokenActor} --clearance internal ^`,
153
- ` --ops-allow info,route,read,write,recent,goal,identity,whitebox,verify ^`,
154
- ` --layers-allow knowledge,contextual,structural,self,goals,unresolved,rejected`,
155
- ` (bash 把行尾 ^ 换成 \\;--role recorder 为最小权限版)`,
156
- ]
157
- }
158
-
159
- /** 各端后续步骤(片段放哪 / 纪律注入 / 自检)。 */
160
- function nextSteps(end: EndSpec, python: string): string[] {
161
- const selfCheck = `大脑自检:${python} -m md_cg.mcp_server 收到 initialize 应答即通(README「装后验证」)`
162
- switch (end.id) {
163
- case 'dsh':
164
- return [
165
- '② 推荐插件形态(README「快速开始」三步):git clone 本仓 → `dsh plugin --profile <name> add .` →',
166
- ' cordis.yml 启用 lingshu-memory;对应关系:config.python = 上面选的解释器,',
167
- ' config.mdcg.root = 上面选的记忆根(覆盖优先级 env MDCG_ROOT > paths.json > 本项,见 src/lib/datapath.ts)。',
168
- `③ 纪律注入:~/.dsh/profiles/<name>/cordis.patch.yml 的 personaPrefix(样例 dsh/cordis.patch.yml)。`,
169
- `④ ${selfCheck}`,
170
- ]
171
- case 'claude':
172
- return [
173
- `② 纪律注入:项目根 CLAUDE.md(样例 claude/CLAUDE.md;插件形态可 /plugin marketplace add FuRongJun-1999/dsh-memory)。`,
174
- `③ ${selfCheck}`,
175
- ]
176
- case 'codex':
177
- return [
178
- `② 纪律注入:项目根 AGENTS.md(样例 codex/AGENTS.md)。`,
179
- `③ ${selfCheck}`,
180
- ]
181
- default:
182
- return [
183
- `② 纪律注入:按需把 docs/工作纪律 渲染产物放进系统提示(各端样例见 codebuddy/ zcode/ claude/ codex/)。`,
184
- `③ ${selfCheck}`,
185
- ]
186
- }
187
- }
188
-
189
- /** runInit 可注入的 IO(测试注入;缺省 = 真实 stdin/stdout/cwd/home/平台)。 */
190
- export interface InitOptions {
191
- /** 交互模式的 stdin(注入 PassThrough 即可 mock)。 */
192
- input?: Readable
193
- /** 输出收集处(缺省 process.stdout)。 */
194
- output?: Writable
195
- /** 片段文件落盘目录(缺省 process.cwd())。 */
196
- cwd?: string
197
- /** 缺省记忆根的 home(缺省 os.homedir())。 */
198
- home?: string
199
- /** 平台缺省解释器判定(缺省 process.platform)。 */
200
- platform?: NodeJS.Platform
201
- /** 覆盖 TTY 判定(缺省 process.stdin.isTTY):决定「无参数时」走交互还是
202
- * 报错。测试注入 false 即可确定性触发非交互分支,不依赖测试宿主的 stdin
203
- * 形态(管道/终端两态都会让测试结果漂移——显式注入消除这个自由度)。 */
204
- tty?: boolean
205
- }
206
-
207
- export interface InitResult {
208
- end: InitEnd
209
- endLabel: string
210
- root: string
211
- python: string
212
- snippetPath: string
213
- snippet: ReturnType<typeof buildSnippet>
214
- /** 本次打印到 output 的完整文本(幂等断言用)。 */
215
- output: string
216
- /** 片段文件字节(= JSON.stringify(snippet, null, 2) + 换行)。 */
217
- snippetFile: string
218
- }
219
-
220
- const SNIPPET_FILENAME = 'lingshu-mcp-snippet.json'
221
-
222
- class InitError extends Error {}
223
-
224
- /** 从 argv 解析 --flag value / --flag=value(未知 flag 报错,防拼写静默走默认)。 */
225
- function parseFlags(argv: string[]): { end?: string, root?: string, python?: string } {
226
- const out: { end?: string, root?: string, python?: string } = {}
227
- // npx 传参惯例:`npx <pkg> init -- --end x` 的 `--` 是「npx 自己的 flag 到此为止」,
228
- // 不是本命令的参数——跳过一个前导 `--`(其后仍是本命令的 flag)。
229
- const rest = argv[0] === '--' ? argv.slice(1) : argv
230
- const known = new Set(['--end', '--root', '--python'])
231
- for (let i = 0; i < rest.length; i += 1) {
232
- const arg = rest[i] ?? ''
233
- const eq = arg.indexOf('=')
234
- const name = arg.startsWith('--') && eq > 0 ? arg.slice(0, eq) : arg
235
- if (!known.has(name)) {
236
- throw new InitError(`未知参数「${arg}」。支持:--end <dsh|claude|codex|generic> --root <dir> --python <interpreter>`)
237
- }
238
- const value = eq > 0 ? arg.slice(eq + 1) : rest[i + 1]
239
- if (value === undefined || value === '' || (eq < 0 && String(value).startsWith('--'))) {
240
- throw new InitError(`参数 ${name} 缺值。示例:${name} <值>`)
241
- }
242
- if (eq < 0) i += 1
243
- out[name.slice(2) as 'end' | 'root' | 'python'] = String(value)
244
- }
245
- return out
246
- }
247
-
248
- /**
249
- * 一键配置主流程:非交互(参数齐)跳过问答;无参数走交互三问。
250
- * 只生成配置(打印 + 片段落盘),不创建目录、不启动服务、不写库。
251
- */
252
- export async function runInit(argv: string[], opts: InitOptions = {}): Promise<InitResult> {
253
- const out = opts.output ?? process.stdout
254
- const cwd = opts.cwd ?? process.cwd()
255
- let collected = ''
256
- const say = (line = ''): void => {
257
- collected += `${line}\n`
258
- out.write(`${line}\n`)
259
- }
260
-
261
- const flags = parseFlags(argv)
262
- let end: EndSpec | undefined = flags.end ? matchEnd(flags.end) ?? undefined : undefined
263
- if (flags.end && !end) {
264
- throw new InitError(`--end「${flags.end}」无法识别。允许:dsh | claude | codex | generic(或菜单号 1-4)`)
265
- }
266
- let root: string | undefined = flags.root
267
- let python: string | undefined = flags.python
268
-
269
- if (!end || !root || !python) {
270
- // 交互模式。stdin 非 TTY(且未注入 input)时直接报错——宁缺毋滥,
271
- // 不挂死等一行永远不会来的输入。
272
- const interactive = opts.input !== undefined || (opts.tty ?? process.stdin.isTTY === true)
273
- if (!interactive) {
274
- const missing = [!end && '--end', !root && '--root', !python && '--python'].filter(Boolean)
275
- throw new InitError(
276
- `非交互环境(stdin 非 TTY)必须给齐参数:${missing.join(' ')}。`
277
- + '示例:lingshu-init --end claude --root ~/.lingshu/memory --python python3',
278
- )
279
- }
280
- const rl = createInterface({ input: opts.input ?? process.stdin })
281
- try {
282
- const ask = async (prompt: string): Promise<string> => (await rl.question(prompt)).trim()
283
- say('灵枢(Lingshu)一键配置——只生成配置:不创建记忆目录、不启动服务、不写库。')
284
- if (!end) {
285
- const picked = await ask('① 接入端 [1=DSH 插件 2=Claude Code 3=Codex CLI 4=通用 MCP](默认 1):')
286
- const fallback = picked === '' ? '1' : picked
287
- end = matchEnd(fallback) ?? undefined
288
- if (!end) throw new InitError(`接入端「${fallback}」无法识别(允许 1-4)。`)
289
- }
290
- if (!root) {
291
- const given = await ask(`② 记忆根目录 MDCG_ROOT(留空 = ${defaultMemoryRoot(opts.home)}):`)
292
- root = given === '' ? defaultMemoryRoot(opts.home) : given
293
- }
294
- if (!python) {
295
- const given = await ask(`③ Python 解释器(留空 = 按平台 ${defaultPython(opts.platform)}):`)
296
- python = given === '' ? defaultPython(opts.platform) : given
297
- }
298
- } finally {
299
- rl.close()
300
- }
301
- }
302
-
303
- const endSpec = end as EndSpec
304
- // N167:flag(--root)与交互手输两条入口在此汇合,展开一次即双路覆盖
305
- const rootAbs = resolve(cwd, expandHomeTilde(root as string, opts.home))
306
- const pythonName = (python as string).trim()
307
- if (pythonName === '') throw new InitError('--python 不能为空串')
308
-
309
- const snippet = buildSnippet(endSpec, rootAbs, pythonName)
310
- const snippetJson = `${JSON.stringify(snippet, null, 2)}\n`
311
- const snippetPath = join(cwd, SNIPPET_FILENAME)
312
- writeFileSync(snippetPath, snippetJson, 'utf8')
313
-
314
- say()
315
- say(`灵枢(Lingshu)一键配置 · 端=${endSpec.label}`)
316
- say(` 记忆根目录 MDCG_ROOT:${rootAbs}`)
317
- say(` Python 解释器:${pythonName}`)
318
- say()
319
- say(`① 把下面的 mcp.json 片段放到:${endSpec.configTarget}`)
320
- say(snippetJson.trimEnd())
321
- say()
322
- for (const line of nextSteps(endSpec, pythonName)) say(line)
323
- for (const line of tokenCommand(pythonName, endSpec.tokenActor, '')) say(line)
324
- say()
325
- say(`片段已写入:${snippetPath}(mcpServers 键直接复制即可)`)
326
- say('提示:PYTHONPATH 当前指向本命令所在包——若是 npx 临时包,建议换成 git clone 的常驻仓库绝对路径(免疫 npx 缓存清理)。')
327
- say('init 只生成配置:未创建目录、未启动服务、未写库;重跑输出一致。')
328
-
329
- return {
330
- end: endSpec.id,
331
- endLabel: endSpec.label,
332
- root: rootAbs,
333
- python: pythonName,
334
- snippetPath,
335
- snippet,
336
- output: collected,
337
- snippetFile: snippetJson,
338
- }
339
- }
340
-
341
- /** 直跑判定(node lib/init.js / npx 场景;import 作库时为 false)。 */
342
- function isMainEntry(): boolean {
343
- const entry = process.argv[1]
344
- if (!entry) return false
345
- try {
346
- const entryUrl = pathToFileURL(resolve(entry)).href
347
- return import.meta.url === entryUrl
348
- || (process.platform === 'win32' && import.meta.url.toLowerCase() === entryUrl.toLowerCase())
349
- } catch {
350
- return false
351
- }
352
- }
353
-
354
- if (isMainEntry()) {
355
- runInit(process.argv.slice(2))
356
- .then(() => { process.exitCode = 0 })
357
- .catch((e: unknown) => {
358
- process.stderr.write(`lingshu-init:${e instanceof Error ? e.message : String(e)}\n`)
359
- process.exitCode = 1
360
- })
361
- }
1
+ #!/usr/bin/env node
2
+ /**
3
+ * init.ts —— 灵枢一键配置生成器(独立 CLI 入口:`lingshu-init`)
4
+ *
5
+ * 用户痛点:部署灵枢要手工做多步——选记忆根目录、手写各端 mcp.json 的
6
+ * env(MDCG_ROOT / MDCG_PYTHON 等)、理解令牌签发。本命令把「生成配置」
7
+ * 这一步自动化:三问(接入端 / 记忆根目录 / Python 解释器)后打印所选端
8
+ * 的 mcp.json 配置片段、把片段落盘成可复制的文件、并给出各端后续步骤
9
+ * (片段放哪 / 令牌签发命令——后者指向 README「写入凭据」节)。
10
+ *
11
+ * 边界(刻意设计,勿越界):
12
+ * · init **只生成配置**——不创建记忆目录、不启动 md_cg 服务、不写库;
13
+ * 重跑(同参数)输出逐字节一致(无时间戳等易变内容),可放心重复执行。
14
+ * · 与插件运行时的数据根缺省(`~/.dsh/.dsh-memory/data/mdcg`,见
15
+ * `src/lib/datapath.ts`)不同,本命令的缺省记忆根是 `~/.lingshu/memory`
16
+ * ——它会被**显式写进**片段的 MDCG_ROOT,两侧不靠默契、无歧义。
17
+ *
18
+ * env 片段口径与 `mdcgChildEnv()`(src/lib/mdcg_client.ts)对齐:
19
+ * PYTHONIOENCODING/PYTHONUTF8 两条编码注入是硬约束(中文记忆场景,
20
+ * 详见该函数头注的 2026-09-20 读线程崩溃现场);MDCG_MCP_SURFACE=kernel
21
+ * 与各端 mcp.json 样例(claude/lingshu-memory/mcp.json.example 等)同口径。
22
+ * MDCG_PYTHON 对直挂端是文档性键(解释器由 command 决定),对 DSH 插件端
23
+ * 真实生效(`defaultPython()` 读它,src/lib/python_path.ts:42)。
24
+ *
25
+ * 零运行时依赖:只用 Node 内置模块(node:readline/promises / node:fs /
26
+ * node:path)——与全仓「CLI 不加第三方依赖」纪律一致。
27
+ */
28
+
29
+ import { writeFileSync } from 'node:fs'
30
+ import { homedir } from 'node:os'
31
+ import { createInterface } from 'node:readline/promises'
32
+ import type { Readable, Writable } from 'node:stream'
33
+ import { join, resolve } from 'node:path'
34
+ import { pathToFileURL, fileURLToPath } from 'node:url'
35
+ import { realpathSync } from 'node:fs'
36
+ import { expandHome, repoRoot } from './lib/datapath.js'
37
+ import { defaultPython } from './lib/python_path.js'
38
+
39
+ /** 接入端:1=DSH 插件 2=Claude Code 3=Codex CLI 4=通用 MCP。 */
40
+ export type InitEnd = 'dsh' | 'claude' | 'codex' | 'generic'
41
+
42
+ interface EndSpec {
43
+ id: InitEnd
44
+ /** 问答菜单里的展示名。 */
45
+ label: string
46
+ /** MDCG_ACTOR(与既有各端样例/插件配置同口径;私有内容按 (tenant, actor) 派生 DEK)。 */
47
+ actor: string
48
+ /** 片段该放到哪(打印给用户)。 */
49
+ configTarget: string
50
+ /** 令牌签发指引里说明的角色语境(保持 README 口径,仅按端换 actor)。 */
51
+ tokenActor: string
52
+ }
53
+
54
+ const ENDS: ReadonlyArray<EndSpec> = [
55
+ {
56
+ id: 'dsh',
57
+ label: 'DSH 插件',
58
+ actor: 'dsh-memory',
59
+ configTarget: 'DSH 无全局 mcp.json——推荐走插件形态(下方指引②);下方 JSON 为 MCP 直挂等价形态',
60
+ tokenActor: 'dsh-memory',
61
+ },
62
+ {
63
+ id: 'claude',
64
+ label: 'Claude Code',
65
+ actor: 'claude-code',
66
+ configTarget: '项目根 .mcp.json(把片段的 mcpServers 并入;或 ~/.claude.json 全局)',
67
+ tokenActor: 'claude-code',
68
+ },
69
+ {
70
+ id: 'codex',
71
+ label: 'Codex CLI',
72
+ actor: 'codex',
73
+ configTarget: '~/.codex/config.toml 的 [mcp_servers.mdcg] 段(TOML 形态见 codex/config.toml.example:env 为 [mcp_servers.mdcg.env] 表)',
74
+ tokenActor: 'codex',
75
+ },
76
+ {
77
+ id: 'generic',
78
+ label: '通用 MCP 宿主',
79
+ actor: 'generic',
80
+ configTarget: '宿主的 MCP server 配置处(command/args/env 三元组,按宿主文档挂载 stdio server)',
81
+ tokenActor: 'generic',
82
+ },
83
+ ]
84
+
85
+ /** --end 的宽松别名(含菜单数字)。未知值报错并列出允许集。 */
86
+ function matchEnd(value: string): EndSpec | null {
87
+ const v = value.trim().toLowerCase()
88
+ for (const e of ENDS) {
89
+ if (v === e.id || v === e.label) return e
90
+ }
91
+ const aliases: Record<string, InitEnd> = {
92
+ '1': 'dsh', dsh: 'dsh',
93
+ '2': 'claude', claude: 'claude', 'claude-code': 'claude', claudecode: 'claude',
94
+ '3': 'codex', codex: 'codex',
95
+ '4': 'generic', generic: 'generic', mcp: 'generic',
96
+ }
97
+ const id = aliases[v]
98
+ return id ? ENDS.find((e) => e.id === id) ?? null : null
99
+ }
100
+
101
+ /** 缺省记忆根:<home>/.lingshu/memory(home 可注入,供测试)。 */
102
+ export function defaultMemoryRoot(home: string = homedir()): string {
103
+ return join(home, '.lingshu', 'memory')
104
+ }
105
+
106
+ /** 生成的 mcp.json 片段(键序固定 → 序列化稳定 → 幂等)。 */
107
+ export function buildSnippet(end: EndSpec, root: string, python: string): {
108
+ mcpServers: { mdcg: { command: string, args: string[], env: Record<string, string> } }
109
+ } {
110
+ return {
111
+ mcpServers: {
112
+ mdcg: {
113
+ command: python,
114
+ args: ['-m', 'md_cg.mcp_server'],
115
+ env: {
116
+ // 随包 md_cg 的绝对路径(本包 files 自带 md_cg/):python -m 的模块
117
+ // 解析不依赖 cwd,靠 PYTHONPATH(口径同 src/lib/datapath.ts pythonPathValue,
118
+ // 此处为静态配置故取纯包根、不拼进程既有 PYTHONPATH)。
119
+ PYTHONPATH: repoRoot(),
120
+ PYTHONIOENCODING: 'utf-8',
121
+ PYTHONUTF8: '1',
122
+ MDCG_ROOT: root,
123
+ // 直挂端文档性键(解释器由 command 决定);DSH 插件端真实生效。
124
+ MDCG_PYTHON: python,
125
+ MDCG_MCP_SURFACE: 'kernel',
126
+ MDCG_ACTOR: end.actor,
127
+ MDCG_TENANT: 'default',
128
+ MDCG_CLEARANCE: 'private',
129
+ MDCG_TOKEN: '',
130
+ },
131
+ },
132
+ },
133
+ }
134
+ }
135
+
136
+ /** 令牌签发命令文案(与 README「写入凭据」节逐字同口径,仅按端换 actor)。 */
137
+ function tokenCommand(python: string, tokenActor: string, comment: string): string[] {
138
+ return [
139
+ `${comment}令牌签发(需 Python 环境 + 本包 md_cg;签发后把输出填进片段 MDCG_TOKEN,详见 README「写入凭据」节):`,
140
+ ` ${python} -m md_cg.tokens issue --role designer --actor ${tokenActor} --clearance internal ^`,
141
+ ` --ops-allow info,route,read,write,recent,goal,identity,whitebox,verify ^`,
142
+ ` --layers-allow knowledge,contextual,structural,self,goals,unresolved,rejected`,
143
+ ` (bash 把行尾 ^ 换成 \\;--role recorder 为最小权限版)`,
144
+ ]
145
+ }
146
+
147
+ /** 各端后续步骤(片段放哪 / 纪律注入 / 自检)。 */
148
+ function nextSteps(end: EndSpec, python: string): string[] {
149
+ const selfCheck = `大脑自检:${python} -m md_cg.mcp_server 收到 initialize 应答即通(README「装后验证」)`
150
+ switch (end.id) {
151
+ case 'dsh':
152
+ return [
153
+ '② 推荐插件形态(README「快速开始」三步):git clone 本仓 → `dsh plugin --profile <name> add .` →',
154
+ ' cordis.yml 启用 lingshu-memory;对应关系:config.python = 上面选的解释器,',
155
+ ' config.mdcg.root = 上面选的记忆根(覆盖优先级 env MDCG_ROOT > paths.json > 本项,见 src/lib/datapath.ts)。',
156
+ `③ 纪律注入:~/.dsh/profiles/<name>/cordis.patch.yml 的 personaPrefix(样例 dsh/cordis.patch.yml)。`,
157
+ `④ ${selfCheck}`,
158
+ ]
159
+ case 'claude':
160
+ return [
161
+ `② 纪律注入:项目根 CLAUDE.md(样例 claude/CLAUDE.md;插件形态可 /plugin marketplace add FuRongJun-1999/dsh-memory)。`,
162
+ `③ ${selfCheck}`,
163
+ ]
164
+ case 'codex':
165
+ return [
166
+ `② 纪律注入:项目根 AGENTS.md(样例 codex/AGENTS.md)。`,
167
+ `③ ${selfCheck}`,
168
+ ]
169
+ default:
170
+ return [
171
+ `② 纪律注入:按需把 docs/工作纪律 渲染产物放进系统提示(各端样例见 codebuddy/ zcode/ claude/ codex/)。`,
172
+ `③ ${selfCheck}`,
173
+ ]
174
+ }
175
+ }
176
+
177
+ /** runInit 可注入的 IO(测试注入;缺省 = 真实 stdin/stdout/cwd/home/平台)。 */
178
+ export interface InitOptions {
179
+ /** 交互模式的 stdin(注入 PassThrough 即可 mock)。 */
180
+ input?: Readable
181
+ /** 输出收集处(缺省 process.stdout)。 */
182
+ output?: Writable
183
+ /** 片段文件落盘目录(缺省 process.cwd())。 */
184
+ cwd?: string
185
+ /** 缺省记忆根的 home(缺省 os.homedir())。 */
186
+ home?: string
187
+ /** 平台缺省解释器判定(缺省 process.platform)。 */
188
+ platform?: NodeJS.Platform
189
+ /** 覆盖 TTY 判定(缺省 process.stdin.isTTY):决定「无参数时」走交互还是
190
+ * 报错。测试注入 false 即可确定性触发非交互分支,不依赖测试宿主的 stdin
191
+ * 形态(管道/终端两态都会让测试结果漂移——显式注入消除这个自由度)。 */
192
+ tty?: boolean
193
+ }
194
+
195
+ export interface InitResult {
196
+ end: InitEnd
197
+ endLabel: string
198
+ root: string
199
+ python: string
200
+ snippetPath: string
201
+ snippet: ReturnType<typeof buildSnippet>
202
+ /** 本次打印到 output 的完整文本(幂等断言用)。 */
203
+ output: string
204
+ /** 片段文件字节(= JSON.stringify(snippet, null, 2) + 换行)。 */
205
+ snippetFile: string
206
+ }
207
+
208
+ const SNIPPET_FILENAME = 'lingshu-mcp-snippet.json'
209
+
210
+ class InitError extends Error {}
211
+
212
+ /** 从 argv 解析 --flag value / --flag=value(未知 flag 报错,防拼写静默走默认)。 */
213
+ function parseFlags(argv: string[]): { end?: string, root?: string, python?: string } {
214
+ const out: { end?: string, root?: string, python?: string } = {}
215
+ // npx 传参惯例:`npx <pkg> init -- --end x` 的 `--` 是「npx 自己的 flag 到此为止」,
216
+ // 不是本命令的参数——跳过一个前导 `--`(其后仍是本命令的 flag)。
217
+ const rest = argv[0] === '--' ? argv.slice(1) : argv
218
+ const known = new Set(['--end', '--root', '--python'])
219
+ for (let i = 0; i < rest.length; i += 1) {
220
+ const arg = rest[i] ?? ''
221
+ const eq = arg.indexOf('=')
222
+ const name = arg.startsWith('--') && eq > 0 ? arg.slice(0, eq) : arg
223
+ if (!known.has(name)) {
224
+ throw new InitError(`未知参数「${arg}」。支持:--end <dsh|claude|codex|generic> --root <dir> --python <interpreter>`)
225
+ }
226
+ const value = eq > 0 ? arg.slice(eq + 1) : rest[i + 1]
227
+ if (value === undefined || value === '' || (eq < 0 && String(value).startsWith('--'))) {
228
+ throw new InitError(`参数 ${name} 缺值。示例:${name} <值>`)
229
+ }
230
+ if (eq < 0) i += 1
231
+ out[name.slice(2) as 'end' | 'root' | 'python'] = String(value)
232
+ }
233
+ return out
234
+ }
235
+
236
+ /**
237
+ * 一键配置主流程:非交互(参数齐)跳过问答;无参数走交互三问。
238
+ * 只生成配置(打印 + 片段落盘),不创建目录、不启动服务、不写库。
239
+ */
240
+ export async function runInit(argv: string[], opts: InitOptions = {}): Promise<InitResult> {
241
+ const out = opts.output ?? process.stdout
242
+ const cwd = opts.cwd ?? process.cwd()
243
+ let collected = ''
244
+ const say = (line = ''): void => {
245
+ collected += `${line}\n`
246
+ out.write(`${line}\n`)
247
+ }
248
+
249
+ const flags = parseFlags(argv)
250
+ let end: EndSpec | undefined = flags.end ? matchEnd(flags.end) ?? undefined : undefined
251
+ if (flags.end && !end) {
252
+ throw new InitError(`--end「${flags.end}」无法识别。允许:dsh | claude | codex | generic(或菜单号 1-4)`)
253
+ }
254
+ let root: string | undefined = flags.root
255
+ let python: string | undefined = flags.python
256
+
257
+ if (!end || !root || !python) {
258
+ // 交互模式。stdin 非 TTY(且未注入 input)时直接报错——宁缺毋滥,
259
+ // 不挂死等一行永远不会来的输入。
260
+ const interactive = opts.input !== undefined || (opts.tty ?? process.stdin.isTTY === true)
261
+ if (!interactive) {
262
+ const missing = [!end && '--end', !root && '--root', !python && '--python'].filter(Boolean)
263
+ throw new InitError(
264
+ `非交互环境(stdin 非 TTY)必须给齐参数:${missing.join(' ')}。`
265
+ + '示例:lingshu-init --end claude --root ~/.lingshu/memory --python python3',
266
+ )
267
+ }
268
+ const rl = createInterface({ input: opts.input ?? process.stdin })
269
+ try {
270
+ const ask = async (prompt: string): Promise<string> => (await rl.question(prompt)).trim()
271
+ say('灵枢(Lingshu)一键配置——只生成配置:不创建记忆目录、不启动服务、不写库。')
272
+ if (!end) {
273
+ const picked = await ask('① 接入端 [1=DSH 插件 2=Claude Code 3=Codex CLI 4=通用 MCP](默认 1):')
274
+ const fallback = picked === '' ? '1' : picked
275
+ end = matchEnd(fallback) ?? undefined
276
+ if (!end) throw new InitError(`接入端「${fallback}」无法识别(允许 1-4)。`)
277
+ }
278
+ if (!root) {
279
+ const given = await ask(`② 记忆根目录 MDCG_ROOT(留空 = ${defaultMemoryRoot(opts.home)}):`)
280
+ root = given === '' ? defaultMemoryRoot(opts.home) : given
281
+ }
282
+ if (!python) {
283
+ const given = await ask(`③ Python 解释器(留空 = 按平台 ${defaultPython(opts.platform)}):`)
284
+ python = given === '' ? defaultPython(opts.platform) : given
285
+ }
286
+ } finally {
287
+ rl.close()
288
+ }
289
+ }
290
+
291
+ const endSpec = end as EndSpec
292
+ // N167:flag(--root)与交互手输两条入口在此汇合,展开一次即双路覆盖。
293
+ // 展开用 `src/lib/datapath.ts::expandHome`(**唯一实现**,原 expandHomeTilde 已删):
294
+ // 帮助文案与 :264 自带示例都写着「--root ~/.lingshu/memory」,不展开就会把记忆根
295
+ // 解析成宿主 cwd 下的字面 ~ 目录——落错位且随 cwd 漂移分裂。`~user` 不展开,
296
+ // 与 python 侧 md_cg/datapath.py::_expand_home 同判据(登记见 datapath.ts 该函数)。
297
+ const rootAbs = resolve(cwd, expandHome(root as string, opts.home))
298
+ const pythonName = (python as string).trim()
299
+ if (pythonName === '') throw new InitError('--python 不能为空串')
300
+
301
+ const snippet = buildSnippet(endSpec, rootAbs, pythonName)
302
+ const snippetJson = `${JSON.stringify(snippet, null, 2)}\n`
303
+ const snippetPath = join(cwd, SNIPPET_FILENAME)
304
+ writeFileSync(snippetPath, snippetJson, 'utf8')
305
+
306
+ say()
307
+ say(`灵枢(Lingshu)一键配置 · 端=${endSpec.label}`)
308
+ say(` 记忆根目录 MDCG_ROOT:${rootAbs}`)
309
+ say(` Python 解释器:${pythonName}`)
310
+ say()
311
+ say(`① 把下面的 mcp.json 片段放到:${endSpec.configTarget}`)
312
+ say(snippetJson.trimEnd())
313
+ say()
314
+ for (const line of nextSteps(endSpec, pythonName)) say(line)
315
+ for (const line of tokenCommand(pythonName, endSpec.tokenActor, '')) say(line)
316
+ say()
317
+ say(`片段已写入:${snippetPath}(mcpServers 键直接复制即可)`)
318
+ say('提示:PYTHONPATH 当前指向本命令所在包——若是 npx 临时包,建议换成 git clone 的常驻仓库绝对路径(免疫 npx 缓存清理)。')
319
+ say('init 只生成配置:未创建目录、未启动服务、未写库;重跑输出一致。')
320
+
321
+ return {
322
+ end: endSpec.id,
323
+ endLabel: endSpec.label,
324
+ root: rootAbs,
325
+ python: pythonName,
326
+ snippetPath,
327
+ snippet,
328
+ output: collected,
329
+ snippetFile: snippetJson,
330
+ }
331
+ }
332
+
333
+ /** 直跑判定(node lib/init.js / npx 场景;import 作库时为 false)。 */
334
+ function isMainEntry(): boolean {
335
+ const entry = process.argv[1]
336
+ if (!entry) return false
337
+ try {
338
+ // issue #97(2026-10-09 DSH 端):npm 在 POSIX 把 bin 装成**符号链接**
339
+ // (node_modules/.bin/lingshu -> ../@furongjun1999/dsh-memory/lib/cli.js),
340
+ // 此时 argv[1] 是**链接路径**,而 resolve 是纯词法操作、解不开链接
341
+ // ⇒ 与 import.meta.url **永不相等** ⇒ 主函数不执行,**静默空转且 exit=0**
342
+ // (README 推荐的首条命令在 Linux/macOS 上无效而用户与脚本都看不出失败)。
343
+ // Windows 用 .cmd 传真实路径,故开发者在本机测不出来。
344
+ // 修:比较前对**两侧**都做 realpathSync —— 当前模块自身也可能是链接
345
+ // (npm link / 全局安装同样走软链)。
346
+ const selfUrl = pathToFileURL(realpathSync(fileURLToPath(import.meta.url))).href
347
+ const entryUrl = pathToFileURL(realpathSync(entry)).href
348
+ return selfUrl === entryUrl
349
+ || (process.platform === 'win32' && selfUrl.toLowerCase() === entryUrl.toLowerCase())
350
+ } catch {
351
+ return false
352
+ }
353
+ }
354
+
355
+ if (isMainEntry()) {
356
+ runInit(process.argv.slice(2))
357
+ .then(() => { process.exitCode = 0 })
358
+ .catch((e: unknown) => {
359
+ process.stderr.write(`lingshu-init:${e instanceof Error ? e.message : String(e)}\n`)
360
+ process.exitCode = 1
361
+ })
362
+ }