@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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@furongjun1999/dsh-memory",
3
- "version": "0.8.1",
3
+ "version": "0.9.7",
4
4
  "description": "灵枢(Lingshu·líng shū)DeepSeek Harness 插件:完整大脑——长期记忆/知识飞轮/自我认知/递归反思接入 DSH,对话自动沉淀进 md_cg 认知图(md 文档)",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
@@ -22,12 +22,18 @@
22
22
  "md_cg",
23
23
  "utf8_boot.py",
24
24
  "data/policy.json",
25
+ "hive/id_charset_blocks.txt",
25
26
  "skills",
26
27
  "README.md",
27
28
  "dsh",
28
29
  "codebuddy",
29
30
  "zcode",
30
- "docs"
31
+ "docs/规范/AI编程通用规范.md",
32
+ "docs/规范/AI编程通用规范_灵枢适配.md",
33
+ "docs/规范/AI编程通用规范_自检清单.md",
34
+ "docs/discipline",
35
+ "docs/工作纪律_认知图条目_v1.1.json",
36
+ "scripts/workspace_index.py"
31
37
  ],
32
38
  "keywords": [
33
39
  "deepseek",
@@ -58,9 +64,6 @@
58
64
  },
59
65
  "@deepseek-ai/dsh-tools": {
60
66
  "optional": true
61
- },
62
- "@deepseek-ai/schemastery": {
63
- "optional": true
64
67
  }
65
68
  },
66
69
  "peerDependencies": {
@@ -68,8 +71,10 @@
68
71
  "@deepseek-ai/dsh-llm": ">=0.1.0-rc.6",
69
72
  "@deepseek-ai/dsh-session": ">=0.1.0-rc.6",
70
73
  "@deepseek-ai/dsh-system-prompt": ">=0.1.0-rc.6",
71
- "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6",
72
- "@deepseek-ai/schemastery": ">=3.0.0"
74
+ "@deepseek-ai/dsh-tools": ">=0.1.0-rc.6"
75
+ },
76
+ "dependencies": {
77
+ "@deepseek-ai/schemastery": "^3.18.1"
73
78
  },
74
79
  "devDependencies": {
75
80
  "@deepseek-ai/cordis": "^4.0.1",
@@ -85,8 +90,8 @@
85
90
  "scripts": {
86
91
  "build": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\" && tsc -p tsconfig.json",
87
92
  "test": "npm run build && node --import tsx --test \"test/*.test.ts\"",
88
- "prepare": "node -e \"const fs=require('fs');const tsc='node_modules/typescript/bin/tsc';fs.existsSync(tsc)?(fs.rmSync('lib',{recursive:true,force:true}),require('child_process').execFileSync(process.execPath,[tsc,'-p','tsconfig.json'],{stdio:'inherit'})):console.log('[prepare] 跳过构建:typescript 未安装(NODE_ENV=production 或 --omit=dev 会省略 devDependencies)——需要构建请用 npm install --include=dev')\"",
89
- "gate": "python scripts/check_unreachable.py && python scripts/check_publish_artifact.py && python scripts/check_publish_smoke.py && python scripts/cogmap_sync.py check && python scripts/link_check.py && python scripts/workspace_index.py --check && python scripts/discipline_nodes.py --init --write --cg-root .tmp/discipline-cg && python scripts/verify_discipline.py --allow-missing --cg-root .tmp/discipline-cg && python scripts/gate_rust_crate_test.py && python scripts/gate_rust_parity.py && python scripts/check_local_paths.py && python scripts/body_e2e_smoke.py",
93
+ "prepare": "node -e \"const fs=require('fs');const tsc='node_modules/typescript/bin/tsc';if(fs.existsSync(tsc)){fs.rmSync('lib',{recursive:true,force:true});require('child_process').execFileSync(process.execPath,[tsc,'-p','tsconfig.json'],{stdio:'inherit'})}else if(fs.existsSync('lib/index.js')){console.log('[prepare] 跳过构建:typescript 未安装(NODE_ENV=production 或 --omit=dev 会省略 devDependencies)——需要构建请用 npm install --include=dev')}else{console.error('[prepare] 本安装会得到一个不可用的包(issue #161):包入口 main 指向 lib/index.js,但 lib/ 被 .gitignore 忽略、git 归档里没有它,此处 typescript 又未安装(NODE_ENV=production 或 --omit=dev 会省略 devDependencies)⇒ prepare 无法构建,lib/index.js 不存在。修法:用 npm install --include=dev 安装(带上 devDependencies,让 prepare 能构建),或改用已带构建产物的发布包。');process.exitCode=1}\"",
94
+ "gate": "python scripts/check_unreachable.py && python scripts/check_publish_artifact.py && python scripts/check_publish_smoke.py && python scripts/cogmap_sync.py check && python scripts/link_check.py && python scripts/check_line_anchors.py && python scripts/workspace_index.py --check && python scripts/discipline_nodes.py --init --write --cg-root .tmp/discipline-cg && python scripts/verify_discipline.py --allow-missing --cg-root .tmp/discipline-cg && python scripts/gate_rust_crate_test.py && python scripts/gate_rust_parity.py && python scripts/check_local_paths.py && python scripts/body_e2e_smoke.py",
90
95
  "prepublishOnly": "npm run build && npm test && npm run gate"
91
96
  },
92
97
  "repository": {
@@ -0,0 +1,328 @@
1
+ #!/usr/bin/env python3
2
+ # -*- coding: utf-8 -*-
3
+ """工作区索引生成器与陈化守卫(工作纪律第 18 条的载体)。
4
+
5
+ 背景(第 4 条取证):agent 每次「了解工作区」都靠 ls / glob 全盘浏览——成本随仓库规模
6
+ 线性上升,结论还随会话蒸发、下次重来(本仓追踪面已 1814 件)。第 18 条要求先读工作区
7
+ 索引;本脚本是该索引的**唯一生成入口**与守卫(手工维护必然陈化:「手写行号必腐化」同构)。
8
+
9
+ 数据源:git 追踪面(`git ls-files -z`,NUL 分隔取原始路径)。为什么用 -z:默认
10
+ core.quotepath 会把非 ASCII 路径转义成 `"…"` 形态——实测顶层目录统计因此分叉成
11
+ `md_cg`(716) 与 `"md_cg`(372) 两项;NUL 分隔规避该形态。副作用是 gitignored 的语料 /
12
+ 实验产物 / 构建产物天然不进索引,这正是所需(它们是再生产物,不是工作区结构)。
13
+
14
+ 守卫口径(--check,rebuild == have)四项:
15
+ ①顶层目录集合 == 登记表键集(未登记 / 登记但不存在),②根级文件集合同理,
16
+ ③关键入口文件存在,④正文逐字一致(计数 / HEAD / 日期三处归一后比对)。
17
+ 计数**不**参与逐字比对:它随任何文件增删而变,纳入会让守卫对每个改动亮红而退化为
18
+ 噪声;结构面(目录集合 / 职责文案 / 关键入口)才是索引价值所在。该边界已在文档内
19
+ 显式声明——承诺项与守卫面必须一致,否则等同无承诺。
20
+
21
+ 用法:
22
+ python scripts/workspace_index.py # 干跑(摘要)
23
+ python scripts/workspace_index.py --print # 干跑并打印全文
24
+ python scripts/workspace_index.py --write # 落盘
25
+ python scripts/workspace_index.py --check # 守卫(陈化即退出 1)
26
+ 退出码:0 一致或写入成功;1 陈化;2 用法错误。
27
+
28
+ 纪律第 15 条:纯 Python 文件读写 + 显式 UTF-8,子进程走 argv 列表不经 shell。
29
+ """
30
+ from __future__ import annotations
31
+
32
+ import argparse
33
+ import io
34
+ import os
35
+ import re
36
+ import subprocess
37
+ import sys
38
+ from datetime import datetime
39
+
40
+ REPO_DEFAULT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
41
+ DOC_REL = "WORKSPACE_INDEX.md"
42
+ CI_WORKFLOW = ".github/workflows/workspace-index-check.yml"
43
+
44
+ # —— 职责真源(本脚本即真源;新增顶层目录 / 根级文件必须在此登记,否则 --check 亮红)——
45
+ # 值 = (职责一句话, [关键入口,相对本目录;目录名亦可])
46
+ DIR_ROLES = {
47
+ #: 收据目录(receipt 机制):`完成` 必须带可复现命令输出(见 docs/state/会话状态.md 顶部用法)。
48
+ #: 登记于此是按纪律 #18「新增顶层目录须在 DIR_ROLES 登记后重生成」——本条属**机械连带产物**。
49
+ "receipts": ("收据(可复现命令输出的证据面)—— scripts/receipt.py 的 --write/--check/--list 落盘目录",
50
+ [".gitkeep"]),
51
+ "md_cg": ("灵枢大脑——记忆系统本体(纯 md 认知图 + 确定性裁决),即标准 stdio MCP server",
52
+ ["mcp_server.py", "mdcg.py", "mdcos.py"]),
53
+ "rust": ("Rust 检索引擎——只读侧检索内核(零第三方依赖,库内嵌 / --serve / 评测器三形态)",
54
+ ["README.md", "Cargo.toml", "src/lib.rs"]),
55
+ "swarm": ("蜂群运行时——.pbc 确定性实例 + Gossip 拓扑 / 水位信箱 / WAL-HMAC / 信任聚合",
56
+ ["swarm_cli.py", "rust_swarm.py"]),
57
+ "compiler": ("中文(术数)编译器——词法→语法→名实校验→白名单代码生成→验证终裁 + 结构性沙箱",
58
+ ["api.py", "SEMANTICS.md"]),
59
+ "hive": ("蜂巢并发引擎——worker 池调度(原子领取/心跳/超时强杀/崩溃恢复),文件协议即接口",
60
+ ["README.md", "exec_cmd.py", "exec.py"]),
61
+ "skills": ("灵枢自我认知技能包(管线生成的条件单元投影,随插件分发)",
62
+ ["README.md", "plugin.json"]),
63
+ "src": ("DSH 插件 TypeScript 源码(构建产物落 lib/)",
64
+ ["index.ts", "tools.ts", "bridge.ts"]),
65
+ "dsh": ("DSH profile 配置样例与插件启停脚本",
66
+ ["cordis.yml.example", "dsh-web-start.bat"]),
67
+ "codebuddy": ("CodeBuddy 端纪律注入件(full 变体)与 MCP 配置样例",
68
+ ["CODEBUDDY.md", "mcp.json"]),
69
+ "zcode": ("ZCode 端纪律注入件(full 变体)", ["AGENTS.md"]),
70
+ "codex": ("Codex CLI 端纪律注入件 + 插件形态(lingshu-memory/)",
71
+ ["AGENTS.md", "lingshu-memory"]),
72
+ "claude": ("Claude Code 端纪律注入件 + 插件形态(lingshu-memory/)",
73
+ ["CLAUDE.md", "lingshu-memory"]),
74
+ "scripts": ("工程管线——纪律渲染/守卫、认知图同步、发布件与常驻进程体检",
75
+ ["render_discipline.py", "verify_discipline.py", "cogmap_sync.py"]),
76
+ "test": ("跨包测试与独立评测脚本(宿主侧 TS 测试 + python 集成)",
77
+ ["mock_mcp.py", "hive_exec_test.py"]),
78
+ "tests": ("悬赏验收直接运行入口(复用 md_cg 下同一守卫与定点变异自证)",
79
+ ["test_chain_best_first.py"]),
80
+ "data": ("公开评测数据与裁决留痕",
81
+ ["memory-bench-1000.jsonl", "policy.json"]),
82
+ "docs": ("文档(按工程域分目录,索引见 docs/README.md)",
83
+ ["README.md", "工作纪律_认知图条目_v1.1.json"]),
84
+ ".github": ("CI 门禁(纪律/认知图/蜂巢/conformance/安装/发布件/python 测试)",
85
+ ["workflows"]),
86
+ ".codebuddy": ("CodeBuddy 宿主规则注入面(RULE.mdc 渲染落点,纪律第 18 条压缩锚点所在,随仓库分发)",
87
+ ["rules"]),
88
+ ".claude-plugin": ("Claude 插件市场清单(/plugin marketplace add 入口)",
89
+ ["marketplace.json"]),
90
+ ".agents": ("Codex 插件市场清单(codex plugin marketplace add 入口)",
91
+ ["plugins"]),
92
+ }
93
+
94
+ # 根级文件(同上:未登记即亮红)
95
+ ROOT_FILES = {
96
+ "README.md": "对外主入口(定位 / 核心亮点 / 平台全景 / 接入 / 评测 / 纪律)",
97
+ "LICENSE": "许可",
98
+ "package.json": "npm 包清单(@furongjun1999/dsh-memory,bin 入口与脚本)",
99
+ "package-lock.json": "npm 锁文件(npm ci 可复现)",
100
+ "tsconfig.json": "TypeScript 编译配置(src/ → lib/)",
101
+ "memory_score.md": "AGI 七维评分说明",
102
+ "discussion-post.md": "对外讨论帖留档",
103
+ ".gitignore": "忽略面(本地数据面 / 实验产物 / 构建产物)",
104
+ ".gitattributes": "换行归一(pre-commit 钩子等须 LF 的文件)",
105
+ "utf8_boot.py": "入口自保证 UTF-8 的单点助手(纯 stdlib、零 md_cg 依赖;"
106
+ "七个进程入口在任何 I/O 之前调用)",
107
+ }
108
+
109
+ # 定位提示(静态真源,参与逐字校验;只写跨目录的「去哪找」)
110
+ HINTS = [
111
+ ("找纪律本体", "`docs/工作纪律_认知图条目_v1.1.json`——唯一手写真源;"
112
+ "各端产物由 `scripts/render_discipline.py` 渲染、`scripts/verify_discipline.py` 守漂移"),
113
+ ("找记忆能力实现", "`md_cg/mcp_server.py`(cg / stg 工具面)→ `md_cg/mdcg.py`(引擎)→ `md_cg/mdcos.py`(检索)"),
114
+ ("找公开评测口径", "`README.md`(对外数字)→ `data/`(数据集)→ `md_cg/bench_*.py`(复现脚本)"),
115
+ ("找蜂巢派发契约", "`hive/exec_cmd.py`(确定性命令)/ `hive/exec.py`(LLM 委托),spec 进 result 出"),
116
+ ("找本次改动该动哪", "`docs/README.md`(文档归域规则)· 本页第一节(目录职责)"),
117
+ ]
118
+
119
+
120
+ # ---------------------------------------------------------------- 基础工具
121
+
122
+ # 生效条件:当 git 可用且 repo 是工作树时返回追踪路径列表(NUL 分隔取原始路径);git 返回非 0 时抛 RuntimeError。
123
+ def tracked(repo):
124
+ """git 追踪面(NUL 分隔取原始路径,规避 core.quotepath 转义)。"""
125
+ p = subprocess.run(["git", "ls-files", "-z"], cwd=repo, shell=False,
126
+ capture_output=True, text=True, encoding="utf-8", errors="replace",
127
+ env={**os.environ, "PYTHONUTF8": "1"})
128
+ if p.returncode != 0:
129
+ raise RuntimeError("git ls-files 失败:%s" % (p.stderr or "").strip())
130
+ return [x for x in (p.stdout or "").split("\0") if x]
131
+
132
+
133
+ # 生效条件:git rev-parse 成功时返回短 HEAD(7+ 位),失败返回 "unknown"。
134
+ def head_sha(repo):
135
+ try:
136
+ p = subprocess.run(["git", "rev-parse", "--short", "HEAD"], cwd=repo, shell=False,
137
+ capture_output=True, text=True, encoding="utf-8", errors="replace",
138
+ env={**os.environ, "PYTHONUTF8": "1"})
139
+ return (p.stdout or "").strip() or "unknown"
140
+ except OSError:
141
+ return "unknown"
142
+
143
+
144
+ # 生效条件:返回 (files, tops, roots)——files 为全量追踪路径(含本页自身若已被追踪);tops 为 {顶层目录: 件数};roots 为根级文件排序列表(恒排除 DOC_REL,故首次生成与已追踪两态一致)。
145
+ def scan(repo):
146
+ files = tracked(repo)
147
+ tops, roots = {}, []
148
+ for f in files:
149
+ if f == DOC_REL:
150
+ continue # 本页自身不计入(首次生成时尚未被追踪,排除后两态自洽)
151
+ if "/" in f:
152
+ tops[f.split("/")[0]] = tops.get(f.split("/")[0], 0) + 1
153
+ else:
154
+ roots.append(f)
155
+ return files, tops, sorted(roots)
156
+
157
+
158
+ # 生效条件:对任意 text 返回把 HEAD 指纹 / 追踪件数 / 生成日期 / 表格计数列四处替换为占位符后的 strip 文本。
159
+ def _norm(text):
160
+ text = re.sub(r"HEAD `[0-9a-fA-F]{4,40}`", "HEAD `<sha>`", text)
161
+ text = re.sub(r"追踪 \*{0,2}\d+\*{0,2} 件", "追踪 <n> 件", text)
162
+ text = re.sub(r"生成于 \d{4}-\d{2}-\d{2}", "生成于 <date>", text)
163
+ text = re.sub(r"\| \d+ \|", "| <n> |", text)
164
+ return text.strip()
165
+
166
+
167
+ # 生效条件:对 entries(字符串列表)返回反引号包裹、顿号连接的一行文本。
168
+ def _entries(entries):
169
+ return " · ".join("`%s`" % e for e in entries)
170
+
171
+
172
+ # 生效条件:对 files 全集检查 DIR_ROLES 各项的关键入口与 ROOT_FILES 各键是否存在(目录形态以路径前缀判定),返回缺失项排序列表。
173
+ def missing_entries(files):
174
+ have = set(files)
175
+ bad = []
176
+ for d, (_role, entries) in DIR_ROLES.items():
177
+ for e in entries:
178
+ rel = "%s/%s" % (d, e)
179
+ if rel in have or any(f.startswith(rel + "/") for f in have):
180
+ continue
181
+ bad.append(rel)
182
+ bad += [f for f in ROOT_FILES if f not in have]
183
+ return sorted(bad)
184
+
185
+
186
+ # ---------------------------------------------------------------- 渲染
187
+
188
+ # 生效条件:以 repo 的追踪面生成全文;now 为假值时取当前时间。结构面异常(未登记 / 登记但不存在)以标记行显式出现在表内,故「重建 == 磁盘」不掩盖结构变化——结构面由 check() 独立裁决。
189
+ def render(repo, now=None):
190
+ now = now or datetime.now()
191
+ files, tops, roots = scan(repo)
192
+ sha = head_sha(repo)
193
+ unreg_dirs = [d for d in sorted(tops) if d not in DIR_ROLES]
194
+ miss_dirs = [d for d in DIR_ROLES if d not in tops]
195
+
196
+ L = []
197
+ L.append("<!-- 本文件由 scripts/workspace_index.py 生成;请勿手改,改后跑 "
198
+ "`python scripts/workspace_index.py --write` 重生成 -->")
199
+ L.append("")
200
+ L.append("# 工作区索引(WORKSPACE_INDEX)")
201
+ L.append("")
202
+ L.append("> **为什么有这一页**:查工作区文件前先读本页——按目录职责与关键入口定位,"
203
+ "替代每次重复全盘浏览(**工作纪律第 18 条**)。")
204
+ L.append("> **数据源**:git 追踪面(`git ls-files`,NUL 分隔取原始路径);"
205
+ "gitignored 的语料 / 实验产物 / 构建产物不在其内。")
206
+ L.append("> **生成 / 守卫**:`python scripts/workspace_index.py --write` | "
207
+ "`--check`(CI:`%s`)。" % CI_WORKFLOW)
208
+ L.append("> **快照**:HEAD `%s` · 追踪 **%d** 件 · 生成于 %s —— "
209
+ "计数与 HEAD 为生成时快照,**不参与守卫校验**;守卫校验的是:"
210
+ "①顶层目录集合 ②根级文件集合 ③职责文案与关键入口 ④正文(归一化后)逐字一致。"
211
+ % (sha, len(files), now.strftime("%Y-%m-%d")))
212
+ L.append("")
213
+ L.append("## 一、顶层目录")
214
+ L.append("")
215
+ L.append("| 目录 | 职责 | 追踪件数 | 关键入口 |")
216
+ L.append("|---|---|---|---|")
217
+ for d, (role, entries) in DIR_ROLES.items():
218
+ if d in tops:
219
+ L.append("| `%s/` | %s | %d | %s |" % (d, role, tops[d], _entries(entries)))
220
+ else:
221
+ L.append("| `%s/` | %s | — | **目录缺失**(已登记但仓库内不存在) |" % (d, role))
222
+ for d in unreg_dirs:
223
+ L.append("| `%s/` | **未登记**——请在 `scripts/workspace_index.py` 的 `DIR_ROLES` "
224
+ "补职责与关键入口后重生成 | %d | — |" % (d, tops[d]))
225
+ L.append("")
226
+ L.append("## 二、根级文件")
227
+ L.append("")
228
+ L.append("| 文件 | 内容 |")
229
+ L.append("|---|---|")
230
+ for f, desc in ROOT_FILES.items():
231
+ mark = "" if f in roots else " **缺失**(已登记但仓库内不存在)"
232
+ L.append("| `%s` | %s%s |" % (f, desc, mark))
233
+ for f in roots:
234
+ if f not in ROOT_FILES:
235
+ L.append("| `%s` | **未登记**——请在 `scripts/workspace_index.py` 的 "
236
+ "`ROOT_FILES` 补说明后重生成 |" % f)
237
+ L.append("")
238
+ L.append("## 三、定位提示")
239
+ L.append("")
240
+ for k, v in HINTS:
241
+ L.append("- **%s** → %s" % (k, v))
242
+ L.append("")
243
+ L.append("---")
244
+ L.append("")
245
+ L.append("本页由 `scripts/workspace_index.py` 从 git 追踪面机械生成,不在上表计数内。"
246
+ "新增顶层目录或根级文件时,守卫会亮红并点名未登记项——"
247
+ "登记到脚本的真源后重生成即恢复一致(**手工编辑本页会在下一次守卫时被判陈化**)。")
248
+ L.append("")
249
+ return "\n".join(L)
250
+
251
+
252
+ # ---------------------------------------------------------------- 守卫
253
+
254
+ # 生效条件:重建文本与磁盘文本归一后比对,且逐项裁决结构面(未登记目录 / 登记但不存在 / 未登记根文件 / 登记但不存在 / 关键入口缺失),返回 {"ok", "drift":[...], "stats":{...}}。
255
+ def check(repo):
256
+ path = os.path.join(repo, DOC_REL)
257
+ files, tops, roots = scan(repo)
258
+ drift = []
259
+
260
+ for d in sorted(tops):
261
+ if d not in DIR_ROLES:
262
+ drift.append("未登记目录:`%s/`(%d 件)——请在 DIR_ROLES 登记后重生成" % (d, tops[d]))
263
+ for d in DIR_ROLES:
264
+ if d not in tops:
265
+ drift.append("登记但不存在:`%s/`——目录已删或改名,请更新 DIR_ROLES" % d)
266
+ for f in roots:
267
+ if f not in ROOT_FILES:
268
+ drift.append("未登记根级文件:`%s`——请在 ROOT_FILES 登记后重生成" % f)
269
+ for f in ROOT_FILES:
270
+ if f not in roots:
271
+ drift.append("登记但不存在:`%s`——文件已删或改名,请更新 ROOT_FILES" % f)
272
+ for rel in missing_entries(files):
273
+ drift.append("关键入口缺失:`%s`——请修正 DIR_ROLES / ROOT_FILES 的入口表" % rel)
274
+
275
+ if not os.path.isfile(path):
276
+ drift.append("索引缺失:`%s` 不存在——跑 --write 生成" % DOC_REL)
277
+ else:
278
+ with io.open(path, encoding="utf-8") as fh:
279
+ have = fh.read()
280
+ if _norm(have) != _norm(render(repo)):
281
+ drift.append("正文陈化:`%s` 与重建文本不一致(归一化后仍不同)——跑 --write 重生成" % DOC_REL)
282
+
283
+ return {"ok": not drift, "drift": drift,
284
+ "stats": {"dirs": len(tops), "tracked": len(files), "entries": len(missing_entries(files))}}
285
+
286
+
287
+ # 生效条件:argv 为 None 时 argparse 从 sys.argv 解析,否则解析给定 argv;--write 落盘并打印摘要返回 0,--check 按 check() 的 ok 返回 0/1,二者皆无时干跑打印摘要(--print 附全文)返回 0。
288
+ def main(argv=None):
289
+ ap = argparse.ArgumentParser(description="工作区索引生成器与陈化守卫(工作纪律第 18 条)")
290
+ ap.add_argument("--repo", default=REPO_DEFAULT)
291
+ ap.add_argument("--write", action="store_true", help="落盘生成 %s" % DOC_REL)
292
+ ap.add_argument("--check", action="store_true", help="守卫:陈化即退出 1")
293
+ ap.add_argument("--print", dest="do_print", action="store_true", help="干跑并打印全文")
294
+ args = ap.parse_args(argv)
295
+
296
+ repo = os.path.abspath(args.repo)
297
+ if args.check:
298
+ res = check(repo)
299
+ s = res["stats"]
300
+ if res["ok"]:
301
+ print("[OK ] 工作区索引与仓库一致(顶层目录 %d · 追踪 %d 件)"
302
+ % (s["dirs"], s["tracked"]))
303
+ else:
304
+ for d in res["drift"]:
305
+ print("[DRIFT] " + d)
306
+ print("")
307
+ print("结论:陈化 %d 处;修复:python scripts/workspace_index.py --write" % len(res["drift"]))
308
+ return 0 if res["ok"] else 1
309
+
310
+ text = render(repo)
311
+ path = os.path.join(repo, DOC_REL)
312
+ if args.write:
313
+ with io.open(path, "w", encoding="utf-8", newline="\n") as fh:
314
+ fh.write(text)
315
+ print("已写入 %s(%d 字节)" % (DOC_REL, len(text.encode("utf-8"))))
316
+ return 0
317
+
318
+ files, tops, _roots = scan(repo)
319
+ print("干跑:顶层目录 %d · 追踪 %d 件 · 渲染 %d 行(目标 %s)"
320
+ % (len(tops), len(files), text.count("\n") + 1, DOC_REL))
321
+ if args.do_print:
322
+ print("")
323
+ print(text)
324
+ return 0
325
+
326
+
327
+ if __name__ == "__main__":
328
+ sys.exit(main())
package/src/bridge.ts CHANGED
@@ -76,6 +76,29 @@ interface PendingCall {
76
76
  */
77
77
  const MAX_RETRIES = 8
78
78
 
79
+ /** md_cg 的「令牌校验失败」专用退出码(见 md_cg/mcp_server.py 的 `return 3`)。 */
80
+ const EXIT_TOKEN_REJECTED = 3
81
+
82
+ /**
83
+ * #224:启动失败提示按退出码分流。
84
+ *
85
+ * 改前三处提示(5 秒内退出 / 放弃终态 / 放弃后请求失败)都把原因指向
86
+ * 「python 可执行文件与 md_cg 依赖」——退出码 3 时 python 与依赖其实完全正常,
87
+ * 真正原因(令牌被拒)只在透传的 python stderr 里,用户按提示排查只会白耗一轮。
88
+ */
89
+ function startupHint(python: string, exitCode: number | null): string {
90
+ if (exitCode === EXIT_TOKEN_REJECTED) {
91
+ return `md_cg 以退出码 ${EXIT_TOKEN_REJECTED} 拒启:令牌校验失败(python 与依赖本身正常)。`
92
+ + '令牌被服务端拒绝的常见原因:租户不一致(mdcg.tenant / MDCG_TENANT 与令牌签发时的租户不同)、'
93
+ + '已吊销、已过期,或令牌记录不在当前 MDCG_AUX_ROOT / MDCG_TOKEN_FILE 指向的令牌库里。'
94
+ + '处理:确认后用 config.env.MDCG_TOKEN 注入一枚有效令牌,或删除密钥环(~/.mdcg/token,'
95
+ + '可用 MDCG_AUX_ROOT 覆盖)后重启以重新自动签发。'
96
+ }
97
+ return `请检查 ${python} 可执行文件与 md_cg 依赖;`
98
+ + `自检 \`${selfCheckCommand(python)}\` 须在插件包根目录运行`
99
+ + '(插件已自动锚定 cwd 与 PYTHONPATH,issue #12),修复后在 DSH 中重新启用 dsh-memory 插件。'
100
+ }
101
+
79
102
  export class LingshuBridge {
80
103
  private readonly options: BridgeOptions
81
104
  private proc: ChildProcess | null = null
@@ -93,6 +116,9 @@ export class LingshuBridge {
93
116
  private procStartedAt = 0
94
117
  /** issue #7:运行期反复退出的滑动窗口(时间戳列表)——防无限重启刷屏 */
95
118
  private unexpectedExits: number[] = []
119
+ /** #224:最近一次子进程退出码——退出码 3 是 md_cg 的「令牌校验失败」专用码,
120
+ * 三处启动失败提示据此改口,不再一律把人引向「python 与依赖」。 */
121
+ private lastExitCode: number | null = null
96
122
 
97
123
  constructor(options: BridgeOptions) {
98
124
  this.options = options
@@ -281,6 +307,7 @@ export class LingshuBridge {
281
307
  ? Math.round((Date.now() - this.procStartedAt) / 1000)
282
308
  : -1
283
309
  probe(`exit code=${code} signal=${signal} disposed=${this.disposed} ready=${this.readyState} started=${this.started} uptime=${uptimeS}s`)
310
+ this.lastExitCode = code
284
311
  console.error(`[lingshu-bridge] 灵枢进程退出 code=${code} signal=${signal}(存活 ${uptimeS}s)`)
285
312
  this.rl?.close()
286
313
  this.rl = null
@@ -294,10 +321,10 @@ export class LingshuBridge {
294
321
  )
295
322
  this.unexpectedExits.push(Date.now())
296
323
  if (uptimeS >= 0 && uptimeS < 5) {
324
+ // #224:退出码 3 = 令牌被拒,提示改口(不再把人引向 python/依赖)。
297
325
  console.error(
298
- `[lingshu-bridge] 进程启动后 5 秒内即退出——请检查 ${python} 可执行文件与 md_cg 依赖。` +
299
- `自检 \`${selfCheckCommand(python)}\` 须在插件包根目录运行` +
300
- '(插件已自动锚定 cwd 与 PYTHONPATH,issue #12)。')
326
+ `[lingshu-bridge] 进程启动后 5 秒内即退出——`
327
+ + startupHint(python, this.lastExitCode))
301
328
  } else if (this.unexpectedExits.length >= 3) {
302
329
  console.error(
303
330
  `[lingshu-bridge] 10 分钟内已意外退出 ${this.unexpectedExits.length} 次,` +
@@ -365,10 +392,8 @@ export class LingshuBridge {
365
392
  this.readyState = 'failed'
366
393
  this.flushBootQueue(false)
367
394
  console.error(
368
- `[lingshu-bridge] 连续启动失败 ${this.retries} 次,已停止自动重启(不再后台空转)。` +
369
- `请检查 ${this.options.python} 可执行文件与 md_cg 依赖;` +
370
- `自检 \`${selfCheckCommand(this.options.python)}\` 须在插件包根目录运行` +
371
- '(插件已自动锚定 cwd 与 PYTHONPATH,issue #12),修复后在 DSH 中重新启用 dsh-memory 插件。')
395
+ `[lingshu-bridge] 连续启动失败 ${this.retries} 次,已停止自动重启(不再后台空转)。`
396
+ + startupHint(this.options.python, this.lastExitCode))
372
397
  probe(`give up: ${this.retries} consecutive failures, entering failed terminal state`)
373
398
  return
374
399
  }
@@ -396,10 +421,8 @@ export class LingshuBridge {
396
421
  // issue #6:放弃终态下快速失败——之前进程不在且不再重启,请求只能白等超时
397
422
  if (this.gaveUp) {
398
423
  return Promise.reject(new Error(
399
- '灵枢进程不可用:连续启动失败已达上限,已停止重试。' +
400
- `请检查 ${this.options.python} 可执行文件与 md_cg 依赖` +
401
- `(自检 \`${selfCheckCommand(this.options.python)}\` 须在插件包根目录运行),` +
402
- '修复后重新启用 dsh-memory 插件。'))
424
+ '灵枢进程不可用:连续启动失败已达上限,已停止重试。'
425
+ + startupHint(this.options.python, this.lastExitCode)))
403
426
  }
404
427
  const id = this.nextId++
405
428
  const timeout = this.options.timeoutMs
package/src/cli.ts CHANGED
@@ -1,65 +1,75 @@
1
- #!/usr/bin/env node
2
- /**
3
- * cli.ts —— `lingshu` 主命令入口(npx 兼容分发器)
4
- *
5
- * 为什么有三个 bin(package.json bin):
6
- * · `lingshu` → 本文件:`lingshu init` 分发到 init.ts(未来其它子命令也挂这);
7
- * · `lingshu-init` → lib/init.js:单命令直入(不想敲子命令的场景);
8
- * · `dsh-memory` → 本文件:npx 的同名匹配规则——`npx @furongjun1999/dsh-memory init`
9
- * 在包有多个 bin 时,只会自动运行**与包名末段同名**的 bin(npm 官方口径),
10
- * 缺这个入口 npx 会因「多个 bin 且无同名」直接报错,一键配置命令即失效。
11
- *
12
- * 零运行时依赖:只用 Node 内置模块。
13
- */
14
- import { resolve } from 'node:path'
15
- import { pathToFileURL } from 'node:url'
16
- import { runInit } from './init.js'
17
-
18
- const USAGE = [
19
- '灵枢(Lingshu)命令行',
20
- '',
21
- '用法:lingshu <命令>',
22
- '',
23
- '命令:',
24
- ' init [选项] 一键配置生成器(交互三问;参数齐则跳过问答)',
25
- ' 选项:--end <dsh|claude|codex|generic> --root <dir> --python <interpreter>',
26
- '',
27
- '示例:',
28
- ' npx @furongjun1999/dsh-memory init',
29
- ' npx @furongjun1999/dsh-memory init -- --end claude --root D:/mem --python python3',
30
- ].join('\n')
31
-
32
- /** 入口分发:argv 为去掉 node 与本脚本路径后的参数。仅导出供测试。 */
33
- export async function main(argv: string[]): Promise<number> {
34
- const cmd = argv[0] ?? ''
35
- if (cmd === 'init') {
36
- await runInit(argv.slice(1))
37
- return 0
38
- }
39
- process.stdout.write(`${USAGE}\n`)
40
- if (cmd === '--help' || cmd === '-h' || cmd === 'help') return 0
41
- if (cmd !== '') process.stderr.write(`未知命令「${cmd}」。\n`)
42
- else process.stderr.write('缺少命令。\n')
43
- return 1
44
- }
45
-
46
- function isMainEntry(): boolean {
47
- const entry = process.argv[1]
48
- if (!entry) return false
49
- try {
50
- const entryUrl = pathToFileURL(resolve(entry)).href
51
- return import.meta.url === entryUrl
52
- || (process.platform === 'win32' && import.meta.url.toLowerCase() === entryUrl.toLowerCase())
53
- } catch {
54
- return false
55
- }
56
- }
57
-
58
- if (isMainEntry()) {
59
- main(process.argv.slice(2))
60
- .then((code) => { process.exitCode = code })
61
- .catch((e: unknown) => {
62
- process.stderr.write(`lingshu:${e instanceof Error ? e.message : String(e)}\n`)
63
- process.exitCode = 1
64
- })
65
- }
1
+ #!/usr/bin/env node
2
+ /**
3
+ * cli.ts —— `lingshu` 主命令入口(npx 兼容分发器)
4
+ *
5
+ * 为什么有三个 bin(package.json bin):
6
+ * · `lingshu` → 本文件:`lingshu init` 分发到 init.ts(未来其它子命令也挂这);
7
+ * · `lingshu-init` → lib/init.js:单命令直入(不想敲子命令的场景);
8
+ * · `dsh-memory` → 本文件:npx 的同名匹配规则——`npx @furongjun1999/dsh-memory init`
9
+ * 在包有多个 bin 时,只会自动运行**与包名末段同名**的 bin(npm 官方口径),
10
+ * 缺这个入口 npx 会因「多个 bin 且无同名」直接报错,一键配置命令即失效。
11
+ *
12
+ * 零运行时依赖:只用 Node 内置模块。
13
+ */
14
+ import { resolve } from 'node:path'
15
+ import { pathToFileURL, fileURLToPath } from 'node:url'
16
+ import { realpathSync } from 'node:fs'
17
+ import { runInit } from './init.js'
18
+
19
+ const USAGE = [
20
+ '灵枢(Lingshu)命令行',
21
+ '',
22
+ '用法:lingshu <命令>',
23
+ '',
24
+ '命令:',
25
+ ' init [选项] 一键配置生成器(交互三问;参数齐则跳过问答)',
26
+ ' 选项:--end <dsh|claude|codex|generic> --root <dir> --python <interpreter>',
27
+ '',
28
+ '示例:',
29
+ ' npx @furongjun1999/dsh-memory init',
30
+ ' npx @furongjun1999/dsh-memory init -- --end claude --root D:/mem --python python3',
31
+ ].join('\n')
32
+
33
+ /** 入口分发:argv 为去掉 node 与本脚本路径后的参数。仅导出供测试。 */
34
+ export async function main(argv: string[]): Promise<number> {
35
+ const cmd = argv[0] ?? ''
36
+ if (cmd === 'init') {
37
+ await runInit(argv.slice(1))
38
+ return 0
39
+ }
40
+ process.stdout.write(`${USAGE}\n`)
41
+ if (cmd === '--help' || cmd === '-h' || cmd === 'help') return 0
42
+ if (cmd !== '') process.stderr.write(`未知命令「${cmd}」。\n`)
43
+ else process.stderr.write('缺少命令。\n')
44
+ return 1
45
+ }
46
+
47
+ function isMainEntry(): boolean {
48
+ const entry = process.argv[1]
49
+ if (!entry) return false
50
+ try {
51
+ // issue #97(2026-10-09 DSH 端):npm 在 POSIX 把 bin 装成**符号链接**
52
+ // (node_modules/.bin/lingshu -> ../@furongjun1999/dsh-memory/lib/cli.js),
53
+ // 此时 argv[1] 是**链接路径**,而 resolve 是纯词法操作、解不开链接
54
+ // ⇒ 与 import.meta.url **永不相等** ⇒ 主函数不执行,**静默空转且 exit=0**
55
+ // (README 推荐的首条命令在 Linux/macOS 上无效而用户与脚本都看不出失败)。
56
+ // Windows 用 .cmd 传真实路径,故开发者在本机测不出来。
57
+ // 修:比较前对**两侧**都做 realpathSync —— 当前模块自身也可能是链接
58
+ // (npm link / 全局安装同样走软链)。
59
+ const selfUrl = pathToFileURL(realpathSync(fileURLToPath(import.meta.url))).href
60
+ const entryUrl = pathToFileURL(realpathSync(entry)).href
61
+ return selfUrl === entryUrl
62
+ || (process.platform === 'win32' && selfUrl.toLowerCase() === entryUrl.toLowerCase())
63
+ } catch {
64
+ return false
65
+ }
66
+ }
67
+
68
+ if (isMainEntry()) {
69
+ main(process.argv.slice(2))
70
+ .then((code) => { process.exitCode = code })
71
+ .catch((e: unknown) => {
72
+ process.stderr.write(`lingshu:${e instanceof Error ? e.message : String(e)}\n`)
73
+ process.exitCode = 1
74
+ })
75
+ }