@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
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
+ }