@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,461 +1,469 @@
1
- /**
2
- * mdcg_client.ts —— 认知图显式客户端(LIB 本地库)
3
- *
4
- * 架构定位(2026-09-10 决定)
5
- * --------------------------
6
- * · md_cg = 记忆操作系统 / **唯一真源**(记忆的写、读、裁决、留痕)。
7
- * · AEIS = **能力库**(白箱引擎、角色扮演生成等),不再是记忆真源。
8
- *
9
- * 本模块是插件侧调用 md_cg 的**唯一显式入口**:只暴露 `cg` / `stg` 两个
10
- * 认知基元,每个方法 = 一条 MCP 调用,不做隐式魔法。
11
- *
12
- * 显式调用映射(详见 docs/功能调用映射表_v0.1.md)
13
- * ------------------------------------------------
14
- * 路由/召回 → MdcgClient.route() → MCP cg(op=route)
15
- * 读取节点 → MdcgClient.read() → MCP cg(op=read)
16
- * 记忆沉淀 → MdcgClient.remember() → MCP mdcg_remember(gated=true)
17
- * 语义召回 → MdcgClient.recall() → MCP cg(op=read, query)
18
- * 写入记忆 → MdcgClient.write() → MCP mdcg_remember(gated=false)
19
- * 外部裁决回填 → MdcgClient.verify() → MCP cg(op=verify)
20
- * 最近记忆时间线 → MdcgClient.timeline() → MCP stg(op=timeline)
21
- * 近期事件窗口 → MdcgClient.recent() → MCP cg(op=recent)
22
- * 窗口追加事件 → MdcgClient.recentAdd() → MCP cg(op=recent, action=add)
23
- * 会话续接包 → MdcgClient.sessionRecall() → MCP cg(op=session, action=recall)
24
- * 身份读取 → MdcgClient.identity() → MCP cg(op=identity)
25
- * 白箱能力验证 → MdcgClient.whitebox() → MCP cg(op=whitebox)
26
- * 服务信息 → MdcgClient.serviceInfo()→ MCP cg(op=info)
27
- * 互维主张核验 → MdcgClient.verifyClaim()→ cg(op=read) + 依据强度判定
28
- * 角色/转录落图 → MdcgClient.writeRole() / writeTranscript() → mdcg_remember
29
- *
30
- * 写入为什么不能走 cg(op=write)(关键约束,勿回退)
31
- * ------------------------------------------------
32
- * `cg(op=write)` 是**带审核**的写路径:先过 `audit.audit(content_kind)`,
33
- * 未声明 content_kind 且未配置 `MDCG_POLICY_FILE` 时恒判 BLINDSPOT/DEFER ——
34
- * 只进审核队列、**永不落盘**(自动记忆会静默全失败,实测 0 篇 md 文档)。
35
- * 而 `mdcg_remember`(`md_cg/mcp_server.py:1691`)直接调 `MdCG.remember_gated`
36
- * / `MdCG.add`,跳过审核,是 mcp_server 顶部文档定义的「写」入口。故本客户端
37
- * 的**所有写入**(记忆沉淀 / 角色定义 / 对话转录)统一经 `mdcg_remember`。
38
- */
39
-
40
- import { delimiter } from 'node:path'
41
- import { LingshuBridge, type McpCallResult } from '../bridge.js'
42
- import { pythonPathValue, runRoot } from './datapath.js'
43
-
44
- /** md_cg 子进程与根目录配置。 */
45
- export interface MdcgOptions {
46
- /** Python 可执行文件,默认取 config.python。 */
47
- python: string
48
- /** 启动参数,默认 ['-m', 'md_cg.mcp_server']。 */
49
- args?: string[]
50
- /** 认知图根目录(MDCG_ROOT)。 */
51
- root: string
52
- /** Python 子进程工作目录,默认 `runRoot()`——**插件包目录之外**的稳定目录
53
- * (issue #18:Windows 不允许删除/改名「正被某进程当作 cwd」的目录,
54
- * cwd 落在包内会让 pnpm 更新本包必然 `ERR_PNPM_EBUSY` 且永不自愈)。
55
- * 模块解析**不依赖 cwd**:`python -m` 靠 `PYTHONPATH`
56
- * (见 `pythonPathValue()`)解析随包 md_cg,issue #12 口径不变。
57
- * 显式传入本项时完全尊重原值。 */
58
- cwd?: string
59
- /** 调用主体标识(MDCG_ACTOR)。私有内容按 (tenant, actor) 派生 DEK,
60
- * 故与迁移脚本 --actor 必须一致,否则读不到已迁移节点。 */
61
- actor?: string
62
- /** 租户(MDCG_TENANT),默认 default。 */
63
- tenant?: string
64
- /** 调用方密级(MDCG_CLEARANCE):只能读写 ≤ 该密级的节点,默认 private。 */
65
- clearance?: string
66
- /** 身份主体(MDCG_IDENTITY)。 */
67
- identity?: string
68
- /** 额外环境变量。 */
69
- env?: Record<string, string>
70
- /** MCP 工具面(MDCG_MCP_SURFACE):'kernel' = 仅 cg/stg 两基元;
71
- * 'full' = 另含 `mdcg_*` 细粒度工具。
72
- *
73
- * ⚠️ 本客户端**必须**用 full:唯一写入通道是 `mdcg_remember`(细粒度),
74
- * kernel 面下该工具不存在 → 写入静默失败(角色/转录/自动记忆全部不落盘)。
75
- * 默认 'full',勿改。 */
76
- surface?: 'kernel' | 'full'
77
- timeoutMs?: number
78
- maxRetryDelayMs?: number
79
- }
80
-
81
- const DEFAULT_ARGS = ['-m', 'md_cg.mcp_server']
82
-
83
- /** 子进程环境构造参数(`MdcgOptions` 中与环境相关的那半)。 */
84
- export interface MdcgChildEnvOptions {
85
- root: string
86
- surface?: 'kernel' | 'full'
87
- tenant?: string
88
- clearance?: string
89
- actor?: string
90
- identity?: string
91
- env?: Record<string, string>
92
- }
93
-
94
- /**
95
- * MCP 子进程环境:**唯一构造点**(导出即为了让机械守卫能断言它——
96
- * 见 `test/python-utf8-mode.test.ts`)。勿在别处另拼 env。
97
- *
98
- * ⚠️ 两条编码注入是**硬约束**,不是可选项:
99
- *
100
- * ① `PYTHONIOENCODING=utf-8`(子进程**自身** stdio):Windows 下 piped 子进程默认
101
- * gbk + surrogateescape,Node 写出的 UTF-8 中文会被解成孤立代理字符(\udcXX),
102
- * md_cg 在落盘 / 回写 stdout 时抛 UnicodeEncodeError——中文记忆(主场景)全失败。
103
- *
104
- * ② `PYTHONUTF8=1`(子进程**后代**的默认 text 编码,PEP 540):`PYTHONIOENCODING`
105
- * 会被后代继承(后代于是往管道写 UTF-8),但**文本解码口径不被继承**——后代读
106
- * `subprocess.run(..., text=True)` 时取的是 locale(本机 cp936),于是
107
- * 「子进程写 UTF-8、父进程按 gbk 读」→ 读线程崩死、诊断静默丢失。
108
- * 2026-09-20 实证现场(`npm test` 周期复现,来源为子进程的后代代码单元):
109
- * Exception in thread Thread-N (_readerthread):
110
- * UnicodeDecodeError: 'gbk' codec can't decode byte 0x82 in position 181
111
- * UTF-8 模式把默认 text 编码改为 UTF-8,读写两侧同口径(且解码结果正确,
112
- * 而非 `errors="replace"` 那种替换字符)。
113
- *
114
- * 确定性对照实验(P1 复现 / P3 消除)见 `test/python-utf8-mode.test.ts`。
115
- * `opts.env` 最后展开——显式覆盖优先。
116
- */
117
- export function mdcgChildEnv(opts: MdcgChildEnvOptions): Record<string, string> {
118
- return {
119
- PYTHONIOENCODING: 'utf-8',
120
- PYTHONUTF8: '1',
121
- MDCG_ROOT: opts.root,
122
- // 工具面必须是 full:写入通道 mdcg_remember 属细粒度工具(见 MdcgOptions.surface)。
123
- MDCG_MCP_SURFACE: opts.surface ?? 'full',
124
- MDCG_TENANT: opts.tenant ?? 'default',
125
- MDCG_CLEARANCE: opts.clearance ?? 'private',
126
- PYTHONPATH: pythonPathValue(),
127
- ...(opts.actor ? { MDCG_ACTOR: opts.actor } : {}),
128
- ...(opts.identity ? { MDCG_IDENTITY: opts.identity } : {}),
129
- ...(opts.env ?? {}),
130
- }
131
- }
132
-
133
- /** 认知图依据强度:这些 basis 视为「强依据」,可支撑 pass。
134
- * 取值须在 md_cg.mdcg.VERIFICATION_BASIS 允许集内:
135
- * compiler | test | measurement | formal_proof | data | other(other 不算强依据)。 */
136
- const STRONG_BASIS = new Set(['compiler', 'test', 'measurement', 'formal_proof', 'data'])
137
-
138
- /**
139
- * 请求级**单元身份**(MCP 参数 `as_unit`)。
140
- *
141
- * 与 `md_cg/tokens.py` 的 `POSITION_ROLES` 同源(record/reflect/verify/
142
- * output/sustain);大脑侧 `narrowed_principal` 对未知值 fail-closed 报错。
143
- *
144
- * 语义(关键):`as_unit` 只能**收窄**权限、不能放大——大脑侧以「与 owner 求交 +
145
- * 管理权恒 False」保证,故填错的最坏结果等于不填(owner 全权),**不可能提权**。
146
- *
147
- * 本客户端**只在写入 / 裁决路径注入**,且只注入与落层确定匹配的单元:
148
- * · 记忆沉淀 / 转录 / 角色定义 → `record`(落 contextual / knowledge,在 record
149
- * 的 layers_allow 内);
150
- * · 外部裁决回填 → `verify`(cg op=verify)。
151
- * **只读调用一律不注入**:record / output 的 `clearance_cap=internal`,注入会把
152
- * owner 的 private 读能力一并压低(读不到私有记忆=功能退化),而读无副作用,
153
- * 收窄无收益。`write()` 同样不注入——它被用于写 self / structural 层(角色锚点
154
- * 需 designer 权限),注入 `record` 会直接打断角色落图。
155
- */
156
- export type LingshuUnit = 'record' | 'reflect' | 'verify' | 'output' | 'sustain'
157
-
158
- function collectItems(payload: unknown): Array<Record<string, unknown>> {
159
- if (Array.isArray(payload)) return payload as Array<Record<string, unknown>>
160
- if (payload && typeof payload === 'object') {
161
- const obj = payload as Record<string, unknown>
162
- for (const key of ['results', 'items', 'nodes', 'hits', 'data', 'records']) {
163
- if (Array.isArray(obj[key])) return obj[key] as Array<Record<string, unknown>>
164
- }
165
- }
166
- return []
167
- }
168
-
169
- /**
170
- * 认知图显式客户端。
171
- *
172
- * 生命周期与桥一致:懒启动 + 自动重连;未就绪时调用会快速失败。
173
- * 未就绪的处置:互维 verify 走 fail-closed(见 index.ts 的注入),
174
- * 自动记忆静默跳过——**不再有"回退 aeis 能力库"路径**(该库已剥离)。
175
- */
176
- export class MdcgClient {
177
- readonly bridge: LingshuBridge
178
-
179
- constructor(opts: MdcgOptions) {
180
- // 子进程 cwd 必须落在插件包目录之外,否则 pnpm 更新本插件时
181
- // rmdir 包目录会撞上 Windows 的「目录被当作 CWD」共享冲突 → ERR_PNPM_EBUSY。
182
- // 模块解析不依赖 cwd:PYTHONPATH(pythonPathValue())已锚定随包 md_cg;
183
- // opts.env 显式提供 PYTHONPATH 时完全接管(其展开在最后)。详见 datapath.runRoot()。
184
- const cwd = opts.cwd ?? runRoot()
185
- // 编码与模块解析口径见 mdcgChildEnv() 头注(含 2026-09-20 读线程崩溃现场)。
186
- const env = mdcgChildEnv(opts)
187
- this.bridge = new LingshuBridge({
188
- python: opts.python,
189
- args: opts.args ?? DEFAULT_ARGS,
190
- env,
191
- cwd,
192
- timeoutMs: opts.timeoutMs ?? 60_000,
193
- maxRetryDelayMs: opts.maxRetryDelayMs ?? 30_000,
194
- })
195
- }
196
-
197
- start(): void {
198
- this.bridge.start()
199
- }
200
-
201
- async waitReady(): Promise<boolean> {
202
- return this.bridge.waitReady()
203
- }
204
-
205
- /** 桥是否已握手就绪。
206
- *
207
- * ⚠️ 不可缓存 waitReady() 的结果:waitReady() 在**首次心跳失败**时会立即
208
- * resolve(false)(见 bridge.ts 的 failed 分支),但桥仍会后台重连成功——
209
- * 若把这次 false 缓存下来,isReady() 将永久为假,自动记忆 / 互维核验会在
210
- * 重连成功后静默失效。故一律以桥的实时状态为准。 */
211
- isReady(): boolean {
212
- return this.bridge.isReady()
213
- }
214
-
215
- dispose(): void {
216
- this.bridge.dispose()
217
- }
218
-
219
- /** 原始 cg 调用(逃生口;显式传参,不做推断)。
220
- * `asUnit` = 本次调用的请求级单元身份(见 LingshuUnit);只收窄、不提权。 */
221
- async cg(args: Record<string, unknown>, asUnit?: LingshuUnit): Promise<unknown> {
222
- return this.call('cg', args, asUnit)
223
- }
224
-
225
- /** 原始 stg 调用(时间线/关系/锚点/一致性)。 */
226
- async stg(args: Record<string, unknown>, asUnit?: LingshuUnit): Promise<unknown> {
227
- return this.call('stg', args, asUnit)
228
- }
229
-
230
- private async call(tool: string, args: Record<string, unknown>,
231
- asUnit?: LingshuUnit): Promise<unknown> {
232
- // as_unit 由大脑侧 mcp_server.call_tool 在同一进程内消费并收窄 principal,
233
- // 不从 args 向下透传,故不会污染各 tool handler 的参数解析。
234
- const payload = asUnit ? { ...args, as_unit: asUnit } : args
235
- const result: McpCallResult = await this.bridge.callTool(tool, payload)
236
- const text = (result.content ?? [])
237
- .filter((c) => c.type === 'text')
238
- .map((c) => c.text ?? '')
239
- .join('')
240
- if (result.isError) throw new Error(text || `md_cg ${tool} 调用失败`)
241
- try {
242
- return JSON.parse(text)
243
- } catch {
244
- return text
245
- }
246
- }
247
-
248
- // -- 显式认知能力(每个方法一条 MCP 调用) --------------------------------
249
-
250
- /** 路由:意图 → 相关知识 + 建议能力。 */
251
- route(intent: string, extra: Record<string, unknown> = {}): Promise<unknown> {
252
- return this.cg({ op: 'route', intent, ...extra })
253
- }
254
-
255
- /** 读取:按语义召回节点。 */
256
- read(query: string, extra: Record<string, unknown> = {}): Promise<unknown> {
257
- return this.cg({ op: 'read', query, ...extra })
258
- }
259
-
260
- /** 按 id 精确读取单个节点。 */
261
- get(nodeId: string): Promise<unknown> {
262
- return this.cg({ op: 'read', node_id: nodeId })
263
- }
264
-
265
- /** 认知图写入入口(MCP `mdcg_remember`)。
266
- *
267
- * ⚠️ 唯一写入通道:**不可**改用 `cg(op=write)`(那条路径会被 audit 拦住,
268
- * 见文件头「写入为什么不能走 cg(op=write)」)。gated=false 直写 `MdCG.add`
269
- * (默认 layer=knowledge),gated=true 走主动遗忘闸门。 */
270
- private writeNode(args: Record<string, unknown>,
271
- asUnit?: LingshuUnit): Promise<unknown> {
272
- return this.call('mdcg_remember', args, asUnit)
273
- }
274
-
275
- /** 写入:新增/覆盖一个记忆节点(直写 `MdCG.add`,不经审核队列)。 */
276
- write(content: string, extra: Record<string, unknown> = {}): Promise<unknown> {
277
- return this.writeNode({ content, ...extra })
278
- }
279
-
280
- /** 记忆沉淀(AEIS `remember` 的对应物):写入情景层并过**主动遗忘闸门**。
281
- *
282
- * `mdcg_remember(gated=true)` → `MdCG.remember_gated`:三问 → 四态,
283
- * ACCEPT 落盘 / MERGE 并入既有(= 去重强化,不新增节点)/ DROP 丢弃低熵
284
- * 噪音 / DEFER 待定;四种结果都写 `_forgetting.jsonl`,可审计。
285
- * `importance` 作为 importance_hint 传入(≥0.7 时保护优先、直接 ACCEPT)。
286
- *
287
- * layer 默认 contextual:md_cg 对 DSH 会话事件约定的落层就是 contextual,
288
- * role 取 user | assistant | tool-output(见 md_cg/sources.py 的
289
- * SESSION_LAYER / DSHSessionSource 事件映射)。 */
290
- remember(content: string, extra: Record<string, unknown> = {}): Promise<unknown> {
291
- // 落层 contextual 固定在 record 白名单内 → 声明 record 单元(不得写 self/anchor)。
292
- return this.writeNode({ content, gated: true, layer: 'contextual', ...extra }, 'record')
293
- }
294
-
295
- /** 语义召回(AEIS `recall` 的对应物):`cg(op=read, query)` → md_cg 检索。
296
- * 读取会记 access log(复用观测),供 importance / scrub 陈旧度使用。 */
297
- recall(query: string, k = 5): Promise<unknown> {
298
- return this.read(query, { k })
299
- }
300
-
301
- /** 外部裁决回填:为已有节点写 confirmed/weakened/falsified。 */
302
- verify(nodeId: string, evidence: string, verdict: string): Promise<unknown> {
303
- // 裁决回填声明 verify 单元:只写 rejected/contextual,不得改被验证内容。
304
- return this.cg({ op: 'verify', node_id: nodeId, evidence, verdict }, 'verify')
305
- }
306
-
307
- /** 最近记忆。 */
308
- recent(limit = 20): Promise<unknown> {
309
- return this.cg({ op: 'recent', limit })
310
- }
311
-
312
- /** 追加一条**近期事件窗口**记录(`cg(op=recent, action=add)` →
313
- * `md_cg` 的 `remember_event(role, text, tags, meta, window)`)。
314
- *
315
- * 这是「滑动窗口」写侧:事件落 `_recent.jsonl`(**运行态面**),按窗口滚动
316
- * 淘汰(服务端缺省 200 条,`mdcg.py:91 DEFAULT_RECENT_WINDOW`)——它**不是
317
- * 知识节点**:不占 knowledge 层、不进检索正排,与 `remember()` 的知识面沉淀
318
- * 是两条独立的轨道(见 src/hooks.ts 文件头的 contextWindow 头注)。
319
- *
320
- * ⚠️ **不注入 as_unit**(与 `write()` 同款理由的反面):本调用不写任何层的
321
- * 节点(服务端 `remember_event` 不做层白名单校验),收窄单元无收益且可能压低
322
- * 事件密级(缺省 internal);`meta.session` 由调用方显式给出(沿本文件
323
- * `remember()` 的 sessionTag 口径)。
324
- *
325
- * ⚠️ 服务端对 `meta` 做 `setdefault`(tenant/session/harness/unit,见
326
- * `mdcos.py:5057 remember_event`):调用方已写的键**不被覆盖**。 */
327
- recentAdd(role: string, text: string,
328
- meta: Record<string, unknown> = {},
329
- tags: string[] = []): Promise<unknown> {
330
- return this.cg({ op: 'recent', action: 'add', role, text, meta, tags })
331
- }
332
-
333
- /** **会话续接包**(`cg(op=session, action=recall)` → `md_cg` 的
334
- * `session_recall`):一次取回 notes / goals / tasks / **recent 事件窗口** /
335
- * unresolved / self_state,按 `budget_tokens` 整包裁剪(服务端
336
- * `mdcos.py:3351-3362`:交替丢 recent / notes 尾部)。
337
- *
338
- * 本插件消费其中的 `recent` 段——滑动窗口的**注入面**(见 src/hooks.ts)。
339
- * `recent_limit` 语义 = 近期事件**条数**(非「轮数」);服务端读取时会按
340
- * `max(1, recent_limit or 10)` 归一(`mdcos.py:3309`)。
341
- *
342
- * ⚠️ 两条服务端事实(决定注入侧的可达性,勿据本方法名臆测):
343
- * ① `recent` 段取 `recent_events(limit=recent_limit)` —— **不按 session
344
- * 过滤**(近期事件是运行态滚动窗口,会话归属只写在每条事件的 meta 里);
345
- * ② budget 是**整包**预算:库内 notes/tasks/self_state 占位越多,同样
346
- * budget 下 recent 段被裁得越短(实测:空库 + 10 条窗口条目,
347
- * budget_tokens=600 → recent 8 条;1200 → 10 条)。
348
- *
349
- * 只读调用,不注入 as_unit(同其它读路径:读无副作用,收窄只会压低 owner
350
- * 的 private 读能力)。 */
351
- sessionRecall(session: string, recentLimit: number, budgetTokens: number): Promise<unknown> {
352
- return this.cg({
353
- op: 'session', action: 'recall',
354
- session, recent_limit: recentLimit, budget_tokens: budgetTokens,
355
- })
356
- }
357
-
358
- /** 最近记忆**时间线**(AEIS `timeline` 的对应物):`stg(op=timeline)` →
359
- * `{count, limit, items:[{id, layer, start, end, preview}]}`,按时间倒序。
360
- *
361
- * 只收录带时间区间的节点;而 `cg.add()` 在调用方未给 time_window 时会以
362
- * **写入时刻**自动填充(见 mdcg.py 的 OBSERVATION_WINDOW_SEC 分支),故经
363
- * 本客户端写入的记忆都能进入时间线。
364
- * 要原始近期**事件**(未结构化对话窗口)请用 `recent()`。 */
365
- timeline(limit = 4, extra: Record<string, unknown> = {}): Promise<unknown> {
366
- return this.stg({ op: 'timeline', limit, desc: true, ...extra })
367
- }
368
-
369
- /** 身份维度读取。 */
370
- identity(subjectId?: string, extra: Record<string, unknown> = {}): Promise<unknown> {
371
- return this.cg({ op: 'identity', ...(subjectId ? { subject_id: subjectId } : {}), ...extra })
372
- }
373
-
374
- /** 白箱能力库:显式调用 + 能力验证。 */
375
- whitebox(action: string, extra: Record<string, unknown> = {}): Promise<unknown> {
376
- return this.cg({ op: 'whitebox', action, ...extra })
377
- }
378
-
379
- /** 服务信息(信任透明度)。 */
380
- serviceInfo(): Promise<unknown> {
381
- return this.cg({ op: 'info' })
382
- }
383
-
384
- // -- 语义化封装(互维 / 角色扮演显式使用认知图) --------------------------
385
-
386
- /**
387
- * 互维主张核验(memory 通道):用认知图替代 AEIS `wisdom_verify`。
388
- * 返回结构与 VerifyResult['whitebox'] 对齐,便于直接注入 mutual。
389
- */
390
- async verifyClaim(claim: string): Promise<{
391
- judgment: string
392
- best: string
393
- d_norm: number
394
- record_id: string
395
- }> {
396
- const payload = await this.read(claim, { k: 4 })
397
- const scored = collectItems(payload)
398
- .map((it) => {
399
- const node = (it['node'] as Record<string, unknown>) ?? it
400
- const fm = (node['frontmatter'] as Record<string, unknown>) ?? node
401
- const score = typeof it['score'] === 'number'
402
- ? it['score'] as number
403
- : Number(it['score'] ?? 0)
404
- return {
405
- id: String(node['id'] ?? it['id'] ?? ''),
406
- score: Number.isFinite(score) ? score : 0,
407
- basis: String(fm['verification_basis'] ?? node['verification_basis'] ?? ''),
408
- content: String(node['content'] ?? ''),
409
- }
410
- })
411
- .filter((x) => x.id)
412
- .sort((a, b) => b.score - a.score)
413
- const best = scored[0]
414
- if (best && best.score > 0 && STRONG_BASIS.has(best.basis)) {
415
- return {
416
- judgment: `采纳:认知图已有强依据节点 ${best.id}(basis=${best.basis})`,
417
- best: best.content.slice(0, 200),
418
- d_norm: Math.min(1, best.score),
419
- record_id: best.id,
420
- }
421
- }
422
- if (best && best.score > 0) {
423
- return {
424
- judgment: `待定:命中节点 ${best.id} 但依据不足(basis=${best.basis || 'unknown'})`,
425
- best: best.content.slice(0, 200),
426
- d_norm: -1,
427
- record_id: best.id,
428
- }
429
- }
430
- return { judgment: '未命中:认知图中无相关节点', best: '', d_norm: -1, record_id: '' }
431
- }
432
-
433
- /** 角色定义落图:layer=knowledge,tags=['roleplay','role:<id>']。 */
434
- writeRole(roleId: string, content: string, extra: Record<string, unknown> = {}): Promise<unknown> {
435
- // 落层固定 knowledge(在 record 白名单内)→ 声明 record 单元。
436
- // ⚠️ 不经 this.write():那是不注入单元的通用直写口(还要写 self 层锚点)。
437
- return this.writeNode({
438
- content,
439
- node_id: `roleplay_role_${roleId}`,
440
- layer: 'knowledge',
441
- tags: ['roleplay', `role:${roleId}`, 'roleplay:role'],
442
- importance: 0.7,
443
- ...extra,
444
- }, 'record')
445
- }
446
-
447
- /** 角色对话转录落图:layer=contextual,tags=['roleplay','role:<id>','session:<cid>']。 */
448
- writeTranscript(roleId: string, sessionId: string, who: 'user' | 'assistant',
449
- content: string, extra: Record<string, unknown> = {}): Promise<unknown> {
450
- const stamp = Date.now()
451
- // 落层固定 contextual(在 record 白名单内)→ 声明 record 单元。
452
- return this.writeNode({
453
- content,
454
- node_id: `roleplay_turn_${roleId}_${sessionId}_${stamp}`,
455
- layer: 'contextual',
456
- tags: ['roleplay', `role:${roleId}`, `session:${sessionId}`, `turn:${who}`],
457
- importance: 0.4,
458
- ...extra,
459
- }, 'record')
460
- }
461
- }
1
+ /**
2
+ * mdcg_client.ts —— 认知图显式客户端(LIB 本地库)
3
+ *
4
+ * 架构定位(2026-09-10 决定)
5
+ * --------------------------
6
+ * · md_cg = 记忆操作系统 / **唯一真源**(记忆的写、读、裁决、留痕)。
7
+ * · AEIS = **能力库**(白箱引擎、角色扮演生成等),不再是记忆真源。
8
+ *
9
+ * 本模块是插件侧调用 md_cg 的**唯一显式入口**:只暴露 `cg` / `stg` 两个
10
+ * 认知基元,每个方法 = 一条 MCP 调用,不做隐式魔法。
11
+ *
12
+ * 显式调用映射(详见 docs/功能调用映射表_v0.1.md)
13
+ * ------------------------------------------------
14
+ * 路由/召回 → MdcgClient.route() → MCP cg(op=route)
15
+ * 读取节点 → MdcgClient.read() → MCP cg(op=read)
16
+ * 记忆沉淀 → MdcgClient.remember() → MCP mdcg_remember(gated=true)
17
+ * 语义召回 → MdcgClient.recall() → MCP cg(op=read, query)
18
+ * 写入记忆 → MdcgClient.write() → MCP mdcg_remember(gated=false)
19
+ * 外部裁决回填 → MdcgClient.verify() → MCP cg(op=verify)
20
+ * 最近记忆时间线 → MdcgClient.timeline() → MCP stg(op=timeline)
21
+ * 近期事件窗口 → MdcgClient.recent() → MCP cg(op=recent)
22
+ * 窗口追加事件 → MdcgClient.recentAdd() → MCP cg(op=recent, action=add)
23
+ * 会话续接包 → MdcgClient.sessionRecall() → MCP cg(op=session, action=recall)
24
+ * 身份读取 → MdcgClient.identity() → MCP cg(op=identity)
25
+ * 白箱能力验证 → MdcgClient.whitebox() → MCP cg(op=whitebox)
26
+ * 服务信息 → MdcgClient.serviceInfo()→ MCP cg(op=info)
27
+ * 互维主张核验 → MdcgClient.verifyClaim()→ cg(op=read) + 依据强度判定
28
+ * 角色/转录落图 → MdcgClient.writeRole() / writeTranscript() → mdcg_remember
29
+ *
30
+ * 写入为什么不能走 cg(op=write)(关键约束,勿回退)
31
+ * ------------------------------------------------
32
+ * `cg(op=write)` 是**带审核**的写路径:先过 `audit.audit(content_kind)`,
33
+ * 未声明 content_kind 且未配置 `MDCG_POLICY_FILE` 时恒判 BLINDSPOT/DEFER ——
34
+ * 只进审核队列、**永不落盘**(自动记忆会静默全失败,实测 0 篇 md 文档)。
35
+ * 而 `mdcg_remember`(`md_cg/mcp_server.py:1691`)直接调 `MdCG.remember_gated`
36
+ * / `MdCG.add`,跳过审核,是 mcp_server 顶部文档定义的「写」入口。故本客户端
37
+ * 的**所有写入**(记忆沉淀 / 角色定义 / 对话转录)统一经 `mdcg_remember`。
38
+ */
39
+
40
+ import { delimiter } from 'node:path'
41
+ import { LingshuBridge, type McpCallResult } from '../bridge.js'
42
+ import { pythonPathValue, runRoot } from './datapath.js'
43
+ // 租户单点(#224):签发侧(token_store)与运行侧(本文件的 mdcgChildEnv)必须
44
+ // 用同一函数算出租户——N62 之后服务端对「令牌记录租户 ≠ 入参租户」fail-closed,
45
+ // 两侧各算一遍就必然分叉(签发按 default、运行按 work ⇒ rc=3 拒启)。
46
+ import { effectiveTenant } from './token_store.js'
47
+
48
+ /** md_cg 子进程与根目录配置。 */
49
+ export interface MdcgOptions {
50
+ /** Python 可执行文件,默认取 config.python。 */
51
+ python: string
52
+ /** 启动参数,默认 ['-m', 'md_cg.mcp_server']。 */
53
+ args?: string[]
54
+ /** 认知图根目录(MDCG_ROOT)。 */
55
+ root: string
56
+ /** Python 子进程工作目录,默认 `runRoot()`——**插件包目录之外**的稳定目录
57
+ * (issue #18:Windows 不允许删除/改名「正被某进程当作 cwd」的目录,
58
+ * cwd 落在包内会让 pnpm 更新本包必然 `ERR_PNPM_EBUSY` 且永不自愈)。
59
+ * 模块解析**不依赖 cwd**:`python -m` 靠 `PYTHONPATH`
60
+ * (见 `pythonPathValue()`)解析随包 md_cg,issue #12 口径不变。
61
+ * 显式传入本项时完全尊重原值。 */
62
+ cwd?: string
63
+ /** 调用主体标识(MDCG_ACTOR)。私有内容按 (tenant, actor) 派生 DEK,
64
+ * 故与迁移脚本 --actor 必须一致,否则读不到已迁移节点。 */
65
+ actor?: string
66
+ /** 租户(MDCG_TENANT),默认 default。 */
67
+ tenant?: string
68
+ /** 调用方密级(MDCG_CLEARANCE):只能读写 ≤ 该密级的节点,默认 private。 */
69
+ clearance?: string
70
+ /** 身份主体(MDCG_IDENTITY)。 */
71
+ identity?: string
72
+ /** 额外环境变量。 */
73
+ env?: Record<string, string>
74
+ /** MCP 工具面(MDCG_MCP_SURFACE):'kernel' = 仅 cg/stg 两基元;
75
+ * 'full' = 另含 `mdcg_*` 细粒度工具。
76
+ *
77
+ * ⚠️ 本客户端**必须**用 full:唯一写入通道是 `mdcg_remember`(细粒度),
78
+ * kernel 面下该工具不存在 → 写入静默失败(角色/转录/自动记忆全部不落盘)。
79
+ * 默认 'full',勿改。 */
80
+ surface?: 'kernel' | 'full'
81
+ timeoutMs?: number
82
+ maxRetryDelayMs?: number
83
+ }
84
+
85
+ const DEFAULT_ARGS = ['-m', 'md_cg.mcp_server']
86
+
87
+ /** 子进程环境构造参数(`MdcgOptions` 中与环境相关的那半)。 */
88
+ export interface MdcgChildEnvOptions {
89
+ root: string
90
+ surface?: 'kernel' | 'full'
91
+ tenant?: string
92
+ clearance?: string
93
+ actor?: string
94
+ identity?: string
95
+ env?: Record<string, string>
96
+ }
97
+
98
+ /**
99
+ * MCP 子进程环境:**唯一构造点**(导出即为了让机械守卫能断言它——
100
+ * 见 `test/python-utf8-mode.test.ts`)。勿在别处另拼 env。
101
+ *
102
+ * ⚠️ 两条编码注入是**硬约束**,不是可选项:
103
+ *
104
+ * ① `PYTHONIOENCODING=utf-8`(子进程**自身** stdio):Windows 下 piped 子进程默认
105
+ * gbk + surrogateescape,Node 写出的 UTF-8 中文会被解成孤立代理字符(\udcXX),
106
+ * md_cg 在落盘 / 回写 stdout 时抛 UnicodeEncodeError——中文记忆(主场景)全失败。
107
+ *
108
+ * ② `PYTHONUTF8=1`(子进程**后代**的默认 text 编码,PEP 540):`PYTHONIOENCODING`
109
+ * 会被后代继承(后代于是往管道写 UTF-8),但**文本解码口径不被继承**——后代读
110
+ * `subprocess.run(..., text=True)` 时取的是 locale(本机 cp936),于是
111
+ * 「子进程写 UTF-8、父进程按 gbk 读」→ 读线程崩死、诊断静默丢失。
112
+ * 2026-09-20 实证现场(`npm test` 周期复现,来源为子进程的后代代码单元):
113
+ * Exception in thread Thread-N (_readerthread):
114
+ * UnicodeDecodeError: 'gbk' codec can't decode byte 0x82 in position 181
115
+ * UTF-8 模式把默认 text 编码改为 UTF-8,读写两侧同口径(且解码结果正确,
116
+ * 而非 `errors="replace"` 那种替换字符)。
117
+ *
118
+ * 确定性对照实验(P1 复现 / P3 消除)见 `test/python-utf8-mode.test.ts`。
119
+ * `opts.env` 最后展开——显式覆盖优先。**唯一例外是 `MDCG_TENANT`**(#224):
120
+ * 它由 `effectiveTenant()` 单点决定(`opts.env.MDCG_TENANT` > `opts.tenant` >
121
+ * default),放在 `opts.env` 之后写入——否则 `opts.env` 里的空串/其它值会把
122
+ * 「签发侧算出的租户」再覆盖一次,两侧分叉。其余键的覆盖顺序不变。
123
+ */
124
+ export function mdcgChildEnv(opts: MdcgChildEnvOptions): Record<string, string> {
125
+ return {
126
+ PYTHONIOENCODING: 'utf-8',
127
+ PYTHONUTF8: '1',
128
+ MDCG_ROOT: opts.root,
129
+ // 工具面必须是 full:写入通道 mdcg_remember 属细粒度工具(见 MdcgOptions.surface)。
130
+ MDCG_MCP_SURFACE: opts.surface ?? 'full',
131
+ MDCG_CLEARANCE: opts.clearance ?? 'private',
132
+ PYTHONPATH: pythonPathValue(),
133
+ ...(opts.actor ? { MDCG_ACTOR: opts.actor } : {}),
134
+ ...(opts.identity ? { MDCG_IDENTITY: opts.identity } : {}),
135
+ ...(opts.env ?? {}),
136
+ // 租户单点(见 effectiveTenant):与 token_store 签发/复核同一口径。
137
+ MDCG_TENANT: effectiveTenant(opts.tenant, opts.env),
138
+ }
139
+ }
140
+
141
+ /** 认知图依据强度:这些 basis 视为「强依据」,可支撑 pass。
142
+ * 取值须在 md_cg.mdcg.VERIFICATION_BASIS 允许集内:
143
+ * compiler | test | measurement | formal_proof | data | other(other 不算强依据)。 */
144
+ const STRONG_BASIS = new Set(['compiler', 'test', 'measurement', 'formal_proof', 'data'])
145
+
146
+ /**
147
+ * 请求级**单元身份**(MCP 参数 `as_unit`)。
148
+ *
149
+ * 与 `md_cg/tokens.py` 的 `POSITION_ROLES` 同源(record/reflect/verify/
150
+ * output/sustain);大脑侧 `narrowed_principal` 对未知值 fail-closed 报错。
151
+ *
152
+ * 语义(关键):`as_unit` 只能**收窄**权限、不能放大——大脑侧以「与 owner 求交 +
153
+ * 管理权恒 False」保证,故填错的最坏结果等于不填(owner 全权),**不可能提权**。
154
+ *
155
+ * 本客户端**只在写入 / 裁决路径注入**,且只注入与落层确定匹配的单元:
156
+ * · 记忆沉淀 / 转录 / 角色定义 → `record`(落 contextual / knowledge,在 record
157
+ * 的 layers_allow 内);
158
+ * · 外部裁决回填 → `verify`(cg op=verify)。
159
+ * **只读调用一律不注入**:record / output 的 `clearance_cap=internal`,注入会把
160
+ * owner 的 private 读能力一并压低(读不到私有记忆=功能退化),而读无副作用,
161
+ * 收窄无收益。`write()` 同样不注入——它被用于写 self / structural 层(角色锚点
162
+ * 需 designer 权限),注入 `record` 会直接打断角色落图。
163
+ */
164
+ export type LingshuUnit = 'record' | 'reflect' | 'verify' | 'output' | 'sustain'
165
+
166
+ function collectItems(payload: unknown): Array<Record<string, unknown>> {
167
+ if (Array.isArray(payload)) return payload as Array<Record<string, unknown>>
168
+ if (payload && typeof payload === 'object') {
169
+ const obj = payload as Record<string, unknown>
170
+ for (const key of ['results', 'items', 'nodes', 'hits', 'data', 'records']) {
171
+ if (Array.isArray(obj[key])) return obj[key] as Array<Record<string, unknown>>
172
+ }
173
+ }
174
+ return []
175
+ }
176
+
177
+ /**
178
+ * 认知图显式客户端。
179
+ *
180
+ * 生命周期与桥一致:懒启动 + 自动重连;未就绪时调用会快速失败。
181
+ * 未就绪的处置:互维 verify 走 fail-closed(见 index.ts 的注入),
182
+ * 自动记忆静默跳过——**不再有"回退 aeis 能力库"路径**(该库已剥离)。
183
+ */
184
+ export class MdcgClient {
185
+ readonly bridge: LingshuBridge
186
+
187
+ constructor(opts: MdcgOptions) {
188
+ // 子进程 cwd 必须落在插件包目录之外,否则 pnpm 更新本插件时
189
+ // rmdir 包目录会撞上 Windows 的「目录被当作 CWD」共享冲突 → ERR_PNPM_EBUSY。
190
+ // 模块解析不依赖 cwd:PYTHONPATH(pythonPathValue())已锚定随包 md_cg;
191
+ // opts.env 显式提供 PYTHONPATH 时完全接管(其展开在最后)。详见 datapath.runRoot()。
192
+ const cwd = opts.cwd ?? runRoot()
193
+ // 编码与模块解析口径见 mdcgChildEnv() 头注(含 2026-09-20 读线程崩溃现场)。
194
+ const env = mdcgChildEnv(opts)
195
+ this.bridge = new LingshuBridge({
196
+ python: opts.python,
197
+ args: opts.args ?? DEFAULT_ARGS,
198
+ env,
199
+ cwd,
200
+ timeoutMs: opts.timeoutMs ?? 60_000,
201
+ maxRetryDelayMs: opts.maxRetryDelayMs ?? 30_000,
202
+ })
203
+ }
204
+
205
+ start(): void {
206
+ this.bridge.start()
207
+ }
208
+
209
+ async waitReady(): Promise<boolean> {
210
+ return this.bridge.waitReady()
211
+ }
212
+
213
+ /** 桥是否已握手就绪。
214
+ *
215
+ * ⚠️ 不可缓存 waitReady() 的结果:waitReady() 在**首次心跳失败**时会立即
216
+ * resolve(false)(见 bridge.ts 的 failed 分支),但桥仍会后台重连成功——
217
+ * 若把这次 false 缓存下来,isReady() 将永久为假,自动记忆 / 互维核验会在
218
+ * 重连成功后静默失效。故一律以桥的实时状态为准。 */
219
+ isReady(): boolean {
220
+ return this.bridge.isReady()
221
+ }
222
+
223
+ dispose(): void {
224
+ this.bridge.dispose()
225
+ }
226
+
227
+ /** 原始 cg 调用(逃生口;显式传参,不做推断)。
228
+ * `asUnit` = 本次调用的请求级单元身份(见 LingshuUnit);只收窄、不提权。 */
229
+ async cg(args: Record<string, unknown>, asUnit?: LingshuUnit): Promise<unknown> {
230
+ return this.call('cg', args, asUnit)
231
+ }
232
+
233
+ /** 原始 stg 调用(时间线/关系/锚点/一致性)。 */
234
+ async stg(args: Record<string, unknown>, asUnit?: LingshuUnit): Promise<unknown> {
235
+ return this.call('stg', args, asUnit)
236
+ }
237
+
238
+ private async call(tool: string, args: Record<string, unknown>,
239
+ asUnit?: LingshuUnit): Promise<unknown> {
240
+ // as_unit 由大脑侧 mcp_server.call_tool 在同一进程内消费并收窄 principal,
241
+ // 不从 args 向下透传,故不会污染各 tool handler 的参数解析。
242
+ const payload = asUnit ? { ...args, as_unit: asUnit } : args
243
+ const result: McpCallResult = await this.bridge.callTool(tool, payload)
244
+ const text = (result.content ?? [])
245
+ .filter((c) => c.type === 'text')
246
+ .map((c) => c.text ?? '')
247
+ .join('')
248
+ if (result.isError) throw new Error(text || `md_cg ${tool} 调用失败`)
249
+ try {
250
+ return JSON.parse(text)
251
+ } catch {
252
+ return text
253
+ }
254
+ }
255
+
256
+ // -- 显式认知能力(每个方法一条 MCP 调用) --------------------------------
257
+
258
+ /** 路由:意图 → 相关知识 + 建议能力。 */
259
+ route(intent: string, extra: Record<string, unknown> = {}): Promise<unknown> {
260
+ return this.cg({ op: 'route', intent, ...extra })
261
+ }
262
+
263
+ /** 读取:按语义召回节点。 */
264
+ read(query: string, extra: Record<string, unknown> = {}): Promise<unknown> {
265
+ return this.cg({ op: 'read', query, ...extra })
266
+ }
267
+
268
+ /** 按 id 精确读取单个节点。 */
269
+ get(nodeId: string): Promise<unknown> {
270
+ return this.cg({ op: 'read', node_id: nodeId })
271
+ }
272
+
273
+ /** 认知图写入入口(MCP `mdcg_remember`)。
274
+ *
275
+ * ⚠️ 唯一写入通道:**不可**改用 `cg(op=write)`(那条路径会被 audit 拦住,
276
+ * 见文件头「写入为什么不能走 cg(op=write)」)。gated=false 直写 `MdCG.add`
277
+ * (默认 layer=knowledge),gated=true 走主动遗忘闸门。 */
278
+ private writeNode(args: Record<string, unknown>,
279
+ asUnit?: LingshuUnit): Promise<unknown> {
280
+ return this.call('mdcg_remember', args, asUnit)
281
+ }
282
+
283
+ /** 写入:新增/覆盖一个记忆节点(直写 `MdCG.add`,不经审核队列)。 */
284
+ write(content: string, extra: Record<string, unknown> = {}): Promise<unknown> {
285
+ return this.writeNode({ content, ...extra })
286
+ }
287
+
288
+ /** 记忆沉淀(AEIS `remember` 的对应物):写入情景层并过**主动遗忘闸门**。
289
+ *
290
+ * `mdcg_remember(gated=true)` → `MdCG.remember_gated`:三问 → 四态,
291
+ * ACCEPT 落盘 / MERGE 并入既有(= 去重强化,不新增节点)/ DROP 丢弃低熵
292
+ * 噪音 / DEFER 待定;四种结果都写 `_forgetting.jsonl`,可审计。
293
+ * `importance` 作为 importance_hint 传入(≥0.7 时保护优先、直接 ACCEPT)。
294
+ *
295
+ * layer 默认 contextual:md_cg 对 DSH 会话事件约定的落层就是 contextual,
296
+ * role 取 user | assistant | tool-output(见 md_cg/sources.py 的
297
+ * SESSION_LAYER / DSHSessionSource 事件映射)。 */
298
+ remember(content: string, extra: Record<string, unknown> = {}): Promise<unknown> {
299
+ // 落层 contextual 固定在 record 白名单内 → 声明 record 单元(不得写 self/anchor)。
300
+ return this.writeNode({ content, gated: true, layer: 'contextual', ...extra }, 'record')
301
+ }
302
+
303
+ /** 语义召回(AEIS `recall` 的对应物):`cg(op=read, query)` → md_cg 检索。
304
+ * 读取会记 access log(复用观测),供 importance / scrub 陈旧度使用。 */
305
+ recall(query: string, k = 5): Promise<unknown> {
306
+ return this.read(query, { k })
307
+ }
308
+
309
+ /** 外部裁决回填:为已有节点写 confirmed/weakened/falsified。 */
310
+ verify(nodeId: string, evidence: string, verdict: string): Promise<unknown> {
311
+ // 裁决回填声明 verify 单元:只写 rejected/contextual,不得改被验证内容。
312
+ return this.cg({ op: 'verify', node_id: nodeId, evidence, verdict }, 'verify')
313
+ }
314
+
315
+ /** 最近记忆。 */
316
+ recent(limit = 20): Promise<unknown> {
317
+ return this.cg({ op: 'recent', limit })
318
+ }
319
+
320
+ /** 追加一条**近期事件窗口**记录(`cg(op=recent, action=add)` →
321
+ * `md_cg` 的 `remember_event(role, text, tags, meta, window)`)。
322
+ *
323
+ * 这是「滑动窗口」写侧:事件落 `_recent.jsonl`(**运行态面**),按窗口滚动
324
+ * 淘汰(服务端缺省 200 条,`mdcg.py:91 DEFAULT_RECENT_WINDOW`)——它**不是
325
+ * 知识节点**:不占 knowledge 层、不进检索正排,与 `remember()` 的知识面沉淀
326
+ * 是两条独立的轨道(见 src/hooks.ts 文件头的 contextWindow 头注)。
327
+ *
328
+ * ⚠️ **不注入 as_unit**(与 `write()` 同款理由的反面):本调用不写任何层的
329
+ * 节点(服务端 `remember_event` 不做层白名单校验),收窄单元无收益且可能压低
330
+ * 事件密级(缺省 internal);`meta.session` 由调用方显式给出(沿本文件
331
+ * `remember()` 的 sessionTag 口径)。
332
+ *
333
+ * ⚠️ 服务端对 `meta` 做 `setdefault`(tenant/session/harness/unit,见
334
+ * `mdcos.py:5057 remember_event`):调用方已写的键**不被覆盖**。 */
335
+ recentAdd(role: string, text: string,
336
+ meta: Record<string, unknown> = {},
337
+ tags: string[] = []): Promise<unknown> {
338
+ return this.cg({ op: 'recent', action: 'add', role, text, meta, tags })
339
+ }
340
+
341
+ /** **会话续接包**(`cg(op=session, action=recall)` → `md_cg` 的
342
+ * `session_recall`):一次取回 notes / goals / tasks / **recent 事件窗口** /
343
+ * unresolved / self_state,按 `budget_tokens` 整包裁剪(服务端
344
+ * `mdcos.py:3351-3362`:交替丢 recent / notes 尾部)。
345
+ *
346
+ * 本插件消费其中的 `recent` 段——滑动窗口的**注入面**(见 src/hooks.ts)。
347
+ * `recent_limit` 语义 = 近期事件**条数**(非「轮数」);服务端读取时会按
348
+ * `max(1, recent_limit or 10)` 归一(`mdcos.py:3309`)。
349
+ *
350
+ * ⚠️ 两条服务端事实(决定注入侧的可达性,勿据本方法名臆测):
351
+ * ① `recent` 段取 `recent_events(limit=recent_limit)` —— **不按 session
352
+ * 过滤**(近期事件是运行态滚动窗口,会话归属只写在每条事件的 meta 里);
353
+ * ② budget 是**整包**预算:库内 notes/tasks/self_state 占位越多,同样
354
+ * budget 下 recent 段被裁得越短(实测:空库 + 10 条窗口条目,
355
+ * budget_tokens=600 → recent 8 条;1200 → 10 条)。
356
+ *
357
+ * 只读调用,不注入 as_unit(同其它读路径:读无副作用,收窄只会压低 owner
358
+ * 的 private 读能力)。 */
359
+ sessionRecall(session: string, recentLimit: number, budgetTokens: number): Promise<unknown> {
360
+ return this.cg({
361
+ op: 'session', action: 'recall',
362
+ session, recent_limit: recentLimit, budget_tokens: budgetTokens,
363
+ })
364
+ }
365
+
366
+ /** 最近记忆**时间线**(AEIS `timeline` 的对应物):`stg(op=timeline)` →
367
+ * `{count, limit, items:[{id, layer, start, end, preview}]}`,按时间倒序。
368
+ *
369
+ * 只收录带时间区间的节点;而 `cg.add()` 在调用方未给 time_window 时会以
370
+ * **写入时刻**自动填充(见 mdcg.py 的 OBSERVATION_WINDOW_SEC 分支),故经
371
+ * 本客户端写入的记忆都能进入时间线。
372
+ * 要原始近期**事件**(未结构化对话窗口)请用 `recent()`。 */
373
+ timeline(limit = 4, extra: Record<string, unknown> = {}): Promise<unknown> {
374
+ return this.stg({ op: 'timeline', limit, desc: true, ...extra })
375
+ }
376
+
377
+ /** 身份维度读取。 */
378
+ identity(subjectId?: string, extra: Record<string, unknown> = {}): Promise<unknown> {
379
+ return this.cg({ op: 'identity', ...(subjectId ? { subject_id: subjectId } : {}), ...extra })
380
+ }
381
+
382
+ /** 白箱能力库:显式调用 + 能力验证。 */
383
+ whitebox(action: string, extra: Record<string, unknown> = {}): Promise<unknown> {
384
+ return this.cg({ op: 'whitebox', action, ...extra })
385
+ }
386
+
387
+ /** 服务信息(信任透明度)。 */
388
+ serviceInfo(): Promise<unknown> {
389
+ return this.cg({ op: 'info' })
390
+ }
391
+
392
+ // -- 语义化封装(互维 / 角色扮演显式使用认知图) --------------------------
393
+
394
+ /**
395
+ * 互维主张核验(memory 通道):用认知图替代 AEIS `wisdom_verify`。
396
+ * 返回结构与 VerifyResult['whitebox'] 对齐,便于直接注入 mutual。
397
+ */
398
+ async verifyClaim(claim: string): Promise<{
399
+ judgment: string
400
+ best: string
401
+ d_norm: number
402
+ record_id: string
403
+ }> {
404
+ const payload = await this.read(claim, { k: 4 })
405
+ const scored = collectItems(payload)
406
+ .map((it) => {
407
+ const node = (it['node'] as Record<string, unknown>) ?? it
408
+ const fm = (node['frontmatter'] as Record<string, unknown>) ?? node
409
+ const score = typeof it['score'] === 'number'
410
+ ? it['score'] as number
411
+ : Number(it['score'] ?? 0)
412
+ return {
413
+ id: String(node['id'] ?? it['id'] ?? ''),
414
+ score: Number.isFinite(score) ? score : 0,
415
+ basis: String(fm['verification_basis'] ?? node['verification_basis'] ?? ''),
416
+ content: String(node['content'] ?? ''),
417
+ }
418
+ })
419
+ .filter((x) => x.id)
420
+ .sort((a, b) => b.score - a.score)
421
+ const best = scored[0]
422
+ if (best && best.score > 0 && STRONG_BASIS.has(best.basis)) {
423
+ return {
424
+ judgment: `采纳:认知图已有强依据节点 ${best.id}(basis=${best.basis})`,
425
+ best: best.content.slice(0, 200),
426
+ d_norm: Math.min(1, best.score),
427
+ record_id: best.id,
428
+ }
429
+ }
430
+ if (best && best.score > 0) {
431
+ return {
432
+ judgment: `待定:命中节点 ${best.id} 但依据不足(basis=${best.basis || 'unknown'})`,
433
+ best: best.content.slice(0, 200),
434
+ d_norm: -1,
435
+ record_id: best.id,
436
+ }
437
+ }
438
+ return { judgment: '未命中:认知图中无相关节点', best: '', d_norm: -1, record_id: '' }
439
+ }
440
+
441
+ /** 角色定义落图:layer=knowledge,tags=['roleplay','role:<id>']。 */
442
+ writeRole(roleId: string, content: string, extra: Record<string, unknown> = {}): Promise<unknown> {
443
+ // 落层固定 knowledge(在 record 白名单内)→ 声明 record 单元。
444
+ // ⚠️ 不经 this.write():那是不注入单元的通用直写口(还要写 self 层锚点)。
445
+ return this.writeNode({
446
+ content,
447
+ node_id: `roleplay_role_${roleId}`,
448
+ layer: 'knowledge',
449
+ tags: ['roleplay', `role:${roleId}`, 'roleplay:role'],
450
+ importance: 0.7,
451
+ ...extra,
452
+ }, 'record')
453
+ }
454
+
455
+ /** 角色对话转录落图:layer=contextual,tags=['roleplay','role:<id>','session:<cid>']。 */
456
+ writeTranscript(roleId: string, sessionId: string, who: 'user' | 'assistant',
457
+ content: string, extra: Record<string, unknown> = {}): Promise<unknown> {
458
+ const stamp = Date.now()
459
+ // 落层固定 contextual(在 record 白名单内)→ 声明 record 单元。
460
+ return this.writeNode({
461
+ content,
462
+ node_id: `roleplay_turn_${roleId}_${sessionId}_${stamp}`,
463
+ layer: 'contextual',
464
+ tags: ['roleplay', `role:${roleId}`, `session:${sessionId}`, `turn:${who}`],
465
+ importance: 0.4,
466
+ ...extra,
467
+ }, 'record')
468
+ }
469
+ }