@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
package/src/lib/mutual.ts CHANGED
@@ -1,432 +1,481 @@
1
- /**
2
- * dsh-memory · 互维维护(Mutual Sustain Loop v1.1)——沙箱 B 侧
3
- *
4
- * 职责(与 A 侧 guardian.py 对称):
5
- * 1. 心跳写戳:10min 写 ~/.lingxu_net/heartbeat.web.stamp({ts,pid,task_running})
6
- * 2. 守护 A:检测 harness 进程(wmic 特征)→ 不存在则 detached 拉起
7
- * (python -m harness.guardian;幂等:拉起前确认不存在 + 60s 冷却)
8
- * 3. 任务验证:轮询 ~/.lingxu_net/tasks/task-*.json → 双通道验证
9
- * (白箱 base_verify + DeepSeek 复核)→ 写回 result-<id>.json
10
- *
11
- * 协议:CommonTrustProtocol/docs/mutual-sustain-loop.md v1.1
12
- * 失联分级:25min 告警 / 35min 重启 / task_running 豁免 ×2=70min
13
- */
14
- import { exec, spawn } from 'node:child_process'
15
- import * as fs from 'node:fs'
16
- import * as path from 'node:path'
17
- import * as os from 'node:os'
18
- import { pythonPathValue, runRoot } from './datapath.js'
19
- // issue #19:解释器默认值按平台解析(Windows: python / 其它: python3;
20
- // env MDCG_PYTHON 可覆盖)。此前写死 'python',Linux/macOS 上 mutual 一开就撞 ENOENT。
21
- import { defaultPython } from './python_path.js'
22
-
23
- export interface MutualOptions {
24
- /** 心跳间隔(毫秒),默认 10min */
25
- heartbeatMs: number
26
- /** 失联告警阈值(毫秒),默认 25min */
27
- warnMs: number
28
- /** 失联重启阈值(毫秒),默认 35min */
29
- deadMs: number
30
- /** 任务中豁免倍数,默认 ×2 */
31
- workingFactor: number
32
- /** 拉起冷却(毫秒),默认 60s */
33
- restartCooldownMs: number
34
- /** 互维网络目录,默认 ~/.lingxu_net */
35
- netDir: string
36
- }
37
-
38
- const DEFAULTS: MutualOptions = {
39
- heartbeatMs: 10 * 60 * 1000,
40
- warnMs: 25 * 60 * 1000,
41
- deadMs: 35 * 60 * 1000,
42
- workingFactor: 2,
43
- restartCooldownMs: 60 * 1000,
44
- netDir: path.join(os.homedir(), '.lingxu_net'),
45
- }
46
-
47
- /** 互维网络目录定位 */
48
- export function netDir(opts: MutualOptions = DEFAULTS): string {
49
- return opts.netDir
50
- }
51
-
52
- // ---------------------------------------------------------------------------
53
- // 心跳(B 侧写戳)
54
- // ---------------------------------------------------------------------------
55
-
56
- export function writeHeartbeat(opts: MutualOptions = DEFAULTS, taskRunning = false): void {
57
- const dir = netDir(opts)
58
- fs.mkdirSync(dir, { recursive: true })
59
- const stamp = {
60
- ts: Date.now() / 1000,
61
- pid: process.pid,
62
- task_running: taskRunning,
63
- }
64
- fs.writeFileSync(path.join(dir, 'heartbeat.web.stamp'),
65
- JSON.stringify(stamp), 'utf-8')
66
- }
67
-
68
- export function readHeartbeat(which: 'a' | 'web', opts: MutualOptions = DEFAULTS): {
69
- ts: number; pid: number; task_running: boolean; ageMs: number
70
- } | null {
71
- try {
72
- const raw = fs.readFileSync(path.join(netDir(opts), `heartbeat.${which}.stamp`), 'utf-8')
73
- const s = JSON.parse(raw)
74
- const ageMs = Date.now() - (s.ts as number) * 1000
75
- return { ts: s.ts, pid: s.pid, task_running: !!s.task_running, ageMs }
76
- } catch {
77
- return null
78
- }
79
- }
80
-
81
- /** 失联分级判定(纯函数,A 侧 judge_stamp 的 B 侧镜像) */
82
- export function judgeStamp(stamp: { ageMs: number; task_running: boolean } | null,
83
- opts: MutualOptions = DEFAULTS): 'alive' | 'alive_working' | 'warning' | 'dead' | 'no_stamp' {
84
- if (!stamp) return 'no_stamp'
85
- const threshold = stamp.task_running ? opts.deadMs * opts.workingFactor : opts.deadMs
86
- if (stamp.ageMs < opts.warnMs) return 'alive'
87
- if (stamp.task_running && stamp.ageMs < threshold) return 'alive_working'
88
- if (stamp.ageMs < threshold) return 'warning'
89
- return 'dead'
90
- }
91
-
92
- // ---------------------------------------------------------------------------
93
- // 守护 A(检测 harness 进程 + 拉起)
94
- // ---------------------------------------------------------------------------
95
-
96
- // 进程探测特征 = 命令行含 'harness.guardian' / 'harness.main'(见 harnessRunning)。
97
- // issue #19 已知边界(未纳入本轮修复面):Windows 分支按 name='python.exe' 过滤,
98
- // 用其它可执行名(conda 的 python3.exe 等)启动的 harness 可能漏检;该路径由
99
- // config.mutual.enabled 控制(默认关)。
100
-
101
- function execP(cmd: string): Promise<string> {
102
- return new Promise((resolve) => {
103
- exec(cmd, { windowsHide: true, timeout: 15_000 }, (err, stdout) => {
104
- resolve(err ? '' : String(stdout))
105
- })
106
- })
107
- }
108
-
109
- /** 检测 harness 进程是否存在
110
- * P1 完善(GPT 审查·wmic 兼容):wmic 在 Win11+ 已被移除——失败时
111
- * fallback PowerShell Get-CimInstance(Win);非 Windows 用 ps 查询。 */
112
- export async function harnessRunning(): Promise<boolean> {
113
- if (process.platform === 'win32') {
114
- // ① wmic(旧 Win10 可用)
115
- const out = await execP(
116
- `wmic process where "name='python.exe'" get commandline 2>nul`)
117
- if (out.includes('harness.guardian') || out.includes('harness.main')) return true
118
- // ② wmic 不可用(Win11 移除)→ PowerShell
119
- const psOut = await execP(
120
- `powershell -NoProfile -Command "Get-CimInstance Win32_Process -Filter \\"name='python.exe'\\" | Select-Object -ExpandProperty CommandLine"`)
121
- return psOut.includes('harness.guardian') || psOut.includes('harness.main')
122
- }
123
- // 非 Windows(Linux/macOS):ps 查询
124
- const psOut = await execP(`ps -eo command | grep -E 'harness\\.(guardian|main)' | grep -v grep`)
125
- return !!psOut
126
- }
127
-
128
- /** detached 拉起 A 侧 harness.guardian(幂等:先确认不存在) */
129
- export async function ensureHarness(python = defaultPython(),
130
- opts: MutualOptions = DEFAULTS): Promise<'started' | 'already' | 'failed'> {
131
- const running = await harnessRunning()
132
- if (running) return 'already'
133
- // P1 修复(GPT 审查):spawn 找不到可执行文件是异步 error 事件,无监听
134
- // 会直接崩 Node(Unhandled 'error' event)。加监听 + 超时判定拉起失败。
135
- return new Promise((resolve) => {
136
- let child: ReturnType<typeof spawn> | null = null
137
- let failTimer: NodeJS.Timeout | null = null
138
- let okTimer: NodeJS.Timeout | null = null
139
- let settled = false
140
- const finish = (r: 'started' | 'failed'): void => {
141
- if (settled) return
142
- settled = true
143
- if (failTimer) clearTimeout(failTimer)
144
- if (okTimer) clearTimeout(okTimer)
145
- resolve(r)
146
- }
147
- try {
148
- child = spawn(python, ['-m', 'harness.guardian'], {
149
- windowsHide: true,
150
- detached: true,
151
- stdio: 'ignore',
152
- // 同 mdcg_client:cwd 必须在包外(否则 pnpm 更新时 rmdir 包目录被 Windows
153
- // 拒绝 → ERR_PNPM_EBUSY);模块解析由 PYTHONPATH 保证,见 datapath.runRoot()。
154
- cwd: runRoot(),
155
- // 两条编码注入与 mdcg_client.mdcgChildEnv() 同口径(2026-09-20 v15-9):
156
- // 本站点此前只给 PYTHONPATH,是「唯一构造点」主张下**未表态**的 Python 站点
157
- // (v15b 结构扫描:Python 目标 3 站点、走构造点 0 个、两条编码变量全缺 2 个)。
158
- // 此处**不引** mdcgChildEnv():它构造的是 md_cg 子进程环境(带 MDCG_ROOT /
159
- // MDCG_MCP_SURFACE / MDCG_MCP_* 等,对 harness.guardian 无意义);只对齐编码口径。
160
- // 站点表态由 test/python-utf8-mode.test.ts ④(站点扫描)机械守护。
161
- env: {
162
- ...process.env,
163
- PYTHONPATH: pythonPathValue(),
164
- PYTHONUTF8: '1',
165
- PYTHONIOENCODING: 'utf-8',
166
- },
167
- })
168
- } catch (e) {
169
- log(opts, `守护失败:${String(e)}`)
170
- finish('failed')
171
- return
172
- }
173
- // 拉起失败(python 不存在等)→ 记录 + failed,不崩 Node。
174
- // spawn 的 error 事件是异步的:不能立即判 started——等 50ms error 窗口,
175
- // 无 error 才算拉起成功(GPT 审查:此前立即返回 started,错误路径也报成功)。
176
- child.on('error', (err) => {
177
- log(opts, `守护拉起错误:${err.message}`)
178
- finish('failed')
179
- })
180
- // 拉起成功但立即退出(harness.guardian 不存在)→ failed
181
- child.on('exit', (code) => {
182
- if (code !== null && code !== 0) {
183
- log(opts, `守护进程退出 code=${code}(guardian 可能不可用)`)
184
- finish('failed')
185
- }
186
- })
187
- okTimer = setTimeout(() => finish('started'), 50)
188
- failTimer = setTimeout(() => {
189
- log(opts, `守护拉起超时(10s 无健康确认)`)
190
- finish('failed')
191
- }, 10_000)
192
- child.unref()
193
- log(opts, `守护动作:拉起 harness.guardian(pid=${child.pid ?? '?'})`)
194
- })
195
- }
196
-
197
- // ---------------------------------------------------------------------------
198
- // 任务验证邮箱(双通道:白箱 base_verify + DeepSeek 复核)
199
- // ---------------------------------------------------------------------------
200
-
201
- export interface VerifyTask {
202
- id: string
203
- type: 'verify' | 'knowledge_sync'
204
- from: 'A' | 'B'
205
- to: 'B' | 'A'
206
- payload: { claim: string; evidence?: string; expected?: string; source_ref?: string }
207
- status: 'pending' | 'processing' | 'done'
208
- created_at: number
209
- }
210
-
211
- export interface VerifyResult {
212
- task_id: string
213
- verdict: 'pass' | 'fail' | 'needs_revision'
214
- whitebox: { judgment: string; best: string; d_norm: number; record_id: string }
215
- llm_review: { conclusion: string; reason: string }
216
- reasons: string[]
217
- evidence: string[]
218
- verifier: 'B'
219
- at: number
220
- }
221
-
222
- /** 扫描互维目录里 A→B 的 pending 任务 */
223
- export function scanTasks(opts: MutualOptions = DEFAULTS): VerifyTask[] {
224
- const dir = path.join(netDir(opts), 'tasks')
225
- if (!fs.existsSync(dir)) return []
226
- const out: VerifyTask[] = []
227
- for (const f of fs.readdirSync(dir)) {
228
- if (!f.startsWith('task-') || !f.endsWith('.json')) continue
229
- try {
230
- const t = JSON.parse(fs.readFileSync(path.join(dir, f), 'utf-8'))
231
- if (t.to === 'B' && t.status === 'pending') out.push(t)
232
- } catch { /* 跳过坏文件 */ }
233
- }
234
- return out
235
- }
236
-
237
- /** 白箱通道:智慧之书 base_verify(通过 bridge 调用,或本地注入) */
238
- export async function whiteboxVerify(claim: string,
239
- verifyFn: (c: string) => Promise<{ judgment: string; best: string; d_norm: number; record_id: string }>): Promise<VerifyResult['whitebox']> {
240
- try {
241
- return await verifyFn(claim)
242
- } catch (e) {
243
- return { judgment: `whitebox_error: ${String(e)}`, best: '', d_norm: -1, record_id: '' }
244
- }
245
- }
246
-
247
- /** 复核通道:DeepSeek 独立复核(在白箱判定之上) */
248
- export async function llmReview(claim: string, whitebox: VerifyResult['whitebox'],
249
- reviewFn: (c: string, w: VerifyResult['whitebox']) => Promise<{ conclusion: string; reason: string }>): Promise<VerifyResult['llm_review']> {
250
- try {
251
- return await reviewFn(claim, whitebox)
252
- } catch (e) {
253
- return { conclusion: `llm_error: ${String(e)}`, reason: '' }
254
- }
255
- }
256
-
257
- /** 综合 verdict(白箱优先) */
258
- export function combineVerdict(w: VerifyResult['whitebox'],
259
- l: VerifyResult['llm_review']): VerifyResult['verdict'] {
260
- const c = l.conclusion || ''
261
- // P1 修复(GPT 审查):白箱通道异常 → fail-closed(不因复核「同意」而 pass)
262
- // N268:**复核通道**异常的标记由 llmReview 写在 `l.conclusion`(`llm_error: …`)——
263
- // 此前只查 w.judgment(该字段只可能由 whiteboxVerify 写 whitebox_error)⇒ 该分支
264
- // 是死条件,复核抛异常时白箱「采纳」径直判 pass(复核不可用反成「通过」)。
265
- // 两字段都查:l 侧是真正的生产者口径,w 侧保留同形防御(防上游把异常塞进白箱字段)。
266
- if (w.judgment.startsWith('whitebox_error') || w.judgment.startsWith('llm_error')
267
- || c.startsWith('llm_error') || w.d_norm < 0) {
268
- return 'needs_revision'
269
- }
270
- if (w.judgment.startsWith('采纳')) {
271
- // 白箱采纳:复核质疑/不同意→needs_revision(白箱优先,记录分歧);否则 pass
272
- return c.includes('质疑') || c.includes('不同意') || c.includes('不通过')
273
- ? 'needs_revision' : 'pass'
274
- }
275
- if (w.judgment.includes('fail') || w.judgment.includes('不成立')) return 'fail'
276
- // 证据不足/无法判断 → 白箱不确定,交给复核决定(「不同意」须排除「同意」子串)
277
- if (c.includes('不同意') || c.includes('不通过')) return 'needs_revision'
278
- if (c.includes('通过') || c.includes('同意')) return 'pass'
279
- // P1 修复(GPT 审查):「质疑」是分歧信号——白箱不确定 + 复核质疑 → 需要修订,
280
- // 此前把「质疑」当 pass 与白箱采纳分支语义矛盾。
281
- if (c.includes('质疑')) return 'needs_revision'
282
- return 'needs_revision'
283
- }
284
-
285
- /** 任务 ID 安全校验(P1 修复:防路径穿越——task.id 可含 ../../ 写目录外) */
286
- const TASK_ID_RE = /^[A-Za-z0-9._-]{1,64}$/
287
-
288
- export function safeTaskId(id: string): boolean {
289
- return TASK_ID_RE.test(id) && !id.includes('..')
290
- }
291
-
292
- /** 处理单个任务:双通道验证 → 写回 result */
293
- export async function processTask(task: VerifyTask,
294
- verifyFn: (c: string) => Promise<{ judgment: string; best: string; d_norm: number; record_id: string }>,
295
- reviewFn: (c: string, w: VerifyResult['whitebox']) => Promise<{ conclusion: string; reason: string }>,
296
- opts: MutualOptions = DEFAULTS): Promise<VerifyResult | null> {
297
- const dir = path.join(netDir(opts), 'tasks')
298
- // P1 修复(GPT 审查):task.id 路径穿越——非法 id 拒绝处理,不写任何文件
299
- if (!safeTaskId(task.id)) {
300
- log(opts, `任务 ${JSON.stringify(task.id)} 非法(路径穿越风险),拒绝处理`)
301
- throw new Error(`非法任务 id: ${task.id}`)
302
- }
303
- const taskPath = path.join(dir, `task-${task.id}.json`)
304
- // P1 完善(GPT 审查·任务竞态):原子 claim——rename task→processing。
305
- // 多实例同时 scanTasks 读到同一 pending 时,rename 只有一方成功;
306
- // 失败(文件已被 rename/不存在)= 其他实例正在处理 → 跳过(返回 null)。
307
- // 此前无锁:多实例都写 processing/result/done,结果互相覆盖。
308
- const claimPath = path.join(dir, `processing-${task.id}.json`)
309
- try {
310
- fs.renameSync(taskPath, claimPath)
311
- }
312
- catch {
313
- return null // 已被其他实例 claim,或文件不存在
314
- }
315
- try {
316
- const w = await whiteboxVerify(task.payload.claim, verifyFn)
317
- const l = await llmReview(task.payload.claim, w, reviewFn)
318
- const verdict = combineVerdict(w, l)
319
- const result: VerifyResult = {
320
- task_id: task.id,
321
- verdict,
322
- whitebox: w,
323
- llm_review: l,
324
- reasons: [
325
- `白箱判定:${w.judgment}(best=${w.best},d_norm=${w.d_norm})`,
326
- `复核结论:${l.conclusion}`,
327
- ],
328
- evidence: [task.payload.source_ref || ''].filter(Boolean),
329
- verifier: 'B',
330
- at: Date.now() / 1000,
331
- }
332
- // 结果先写 tmp 再 rename(原子,防半写文件)
333
- const resultTmp = path.join(dir, `result-${task.id}.json.tmp`)
334
- fs.writeFileSync(resultTmp, JSON.stringify(result, null, 2), 'utf-8')
335
- fs.renameSync(resultTmp, path.join(dir, `result-${task.id}.json`))
336
- // 完成:清理 claim 文件(rename 回 done 标记供审计)
337
- fs.renameSync(claimPath, path.join(dir, `done-${task.id}.json`))
338
- log(opts, `任务 ${task.id} 验证完成:${verdict}`)
339
- return result
340
- }
341
- catch (e) {
342
- // 处理失败:释放 claim(rename 回 task 供重试)
343
- try {
344
- fs.renameSync(claimPath, taskPath)
345
- }
346
- catch { /* 文件可能已不在 */ }
347
- throw e
348
- }
349
- }
350
-
351
- // ---------------------------------------------------------------------------
352
- // 日志 / last_contact
353
- // ---------------------------------------------------------------------------
354
-
355
- export function log(opts: MutualOptions, msg: string): void {
356
- try {
357
- const p = path.join(netDir(opts), 'mutual.log')
358
- fs.appendFileSync(p, `[B ${new Date().toISOString()}] ${msg}\n`, 'utf-8')
359
- } catch { /* 日志失败不阻塞 */ }
360
- }
361
-
362
- export function writeLastContact(opts: MutualOptions = DEFAULTS): void {
363
- try {
364
- fs.writeFileSync(path.join(netDir(opts), 'last_contact.json'),
365
- JSON.stringify({ last_contact_b: Date.now() / 1000 }), 'utf-8')
366
- } catch { /* 非阻塞 */ }
367
- }
368
-
369
- // ---------------------------------------------------------------------------
370
- // 安装(ctx.effect 作用域内,卸载时清理)
371
- // ---------------------------------------------------------------------------
372
-
373
- export function installMutualMaintenance(
374
- ctx: { logger: { info(m: string): void }; effect(fn: () => () => void, name?: string): void },
375
- config: Partial<MutualOptions> = {},
376
- hooks: {
377
- verify?: (c: string) => Promise<{ judgment: string; best: string; d_norm: number; record_id: string }>
378
- review?: (c: string, w: VerifyResult['whitebox']) => Promise<{ conclusion: string; reason: string }>
379
- } = {},
380
- ): void {
381
- const opts: MutualOptions = { ...DEFAULTS, ...config }
382
-
383
- // 1. 心跳写戳 + 守护 A(10min 周期)
384
- // P1 修复(GPT 审查):cordis-plugin-timer 签名是 interval(callback, delay)
385
- // ——此前 (ms, fn) 写反:数字被当 callback、函数被当 delay,回调永不执行,
386
- // 互维心跳/任务扫描实际不工作。
387
- // P2 修复:不能用 ctx.interval——那是 cordis-plugin-timer 注入的快捷属性,
388
- // 未声明 `timer` inject 时访问抛 "cannot get property without inject"。
389
- // 改用 Node 原生 setInterval(互维不需要 Cordis effect 生命周期管理)。
390
- const heartbeatTimer = setInterval(() => {
391
- try {
392
- writeHeartbeat(opts)
393
- // 守护 A:harness 不在 → 拉起
394
- ensureHarness(defaultPython(), opts).then((r) => {
395
- if (r === 'started') ctx.logger.info(`mutual: 已拉起 A 侧 harness(${r})`)
396
- })
397
- // 读 A 戳分级判定
398
- const a = readHeartbeat('a', opts)
399
- const verdict = judgeStamp(a, opts)
400
- if (verdict === 'warning') ctx.logger.info('mutual: A 侧心跳告警(>25min 未更新)')
401
- if (verdict === 'dead') ctx.logger.info('mutual: A 侧失联(>35min),等待 guardian 自愈或告警')
402
- writeLastContact(opts)
403
- } catch (e) { /* 单次失败不中断 */ }
404
- }, opts.heartbeatMs)
405
- heartbeatTimer.unref?.()
406
-
407
- // 2. 任务轮询(30s 周期,检查 A→B 任务)
408
- const taskTimer = setInterval(() => {
409
- try {
410
- const tasks = scanTasks(opts)
411
- for (const t of tasks) {
412
- if (!hooks.verify || !hooks.review) continue
413
- processTask(t, hooks.verify, hooks.review, opts).catch((e) => {
414
- log(opts, `任务 ${t.id} 处理异常:${String(e)}`)
415
- })
416
- }
417
- } catch (e) { /* 单次失败不中断 */ }
418
- }, 30_000)
419
- taskTimer.unref?.()
420
-
421
- // 3. effect 作用域清理
422
- ctx.effect(() => {
423
- return () => {
424
- try {
425
- clearInterval(heartbeatTimer)
426
- clearInterval(taskTimer)
427
- } catch { /* 清理失败不阻塞 */ }
428
- }
429
- }, 'dsh-memory-mutual')
430
- }
431
-
432
- export default { installMutualMaintenance, writeHeartbeat, readHeartbeat, judgeStamp, scanTasks, processTask }
1
+ /**
2
+ * dsh-memory · 互维维护(Mutual Sustain Loop v1.1)——沙箱 B 侧
3
+ *
4
+ * 职责(与 A 侧 guardian.py 对称):
5
+ * 1. 心跳写戳:10min 写 ~/.lingxu_net/heartbeat.web.stamp({ts,pid,task_running})
6
+ * 2. 守护 A:检测 harness 进程(wmic 特征)→ 不存在则 detached 拉起
7
+ * (python -m harness.guardian;幂等:拉起前确认不存在 + 60s 冷却)
8
+ * 3. 任务验证:轮询 ~/.lingxu_net/tasks/task-*.json → 双通道验证
9
+ * (白箱 base_verify + DeepSeek 复核)→ 写回 result-<id>.json
10
+ *
11
+ * 协议:CommonTrustProtocol/docs/mutual-sustain-loop.md v1.1
12
+ * 失联分级:25min 告警 / 35min 重启 / task_running 豁免 ×2=70min
13
+ */
14
+ import { exec, spawn } from 'node:child_process'
15
+ import * as fs from 'node:fs'
16
+ import * as path from 'node:path'
17
+ import * as os from 'node:os'
18
+ import { pythonPathValue, runRoot } from './datapath.js'
19
+ // issue #19:解释器默认值按平台解析(Windows: python / 其它: python3;
20
+ // env MDCG_PYTHON 可覆盖)。此前写死 'python',Linux/macOS 上 mutual 一开就撞 ENOENT。
21
+ import { defaultPython } from './python_path.js'
22
+
23
+ export interface MutualOptions {
24
+ /** 心跳间隔(毫秒),默认 10min */
25
+ heartbeatMs: number
26
+ /** 失联告警阈值(毫秒),默认 25min */
27
+ warnMs: number
28
+ /** 失联重启阈值(毫秒),默认 35min */
29
+ deadMs: number
30
+ /** 任务中豁免倍数,默认 ×2 */
31
+ workingFactor: number
32
+ /** 拉起冷却(毫秒),默认 60s */
33
+ restartCooldownMs: number
34
+ /** 互维网络目录,默认 ~/.lingxu_net */
35
+ netDir: string
36
+ }
37
+
38
+ const DEFAULTS: MutualOptions = {
39
+ heartbeatMs: 10 * 60 * 1000,
40
+ warnMs: 25 * 60 * 1000,
41
+ deadMs: 35 * 60 * 1000,
42
+ workingFactor: 2,
43
+ restartCooldownMs: 60 * 1000,
44
+ netDir: path.join(os.homedir(), '.lingxu_net'),
45
+ }
46
+
47
+ /** 互维网络目录定位 */
48
+ export function netDir(opts: MutualOptions = DEFAULTS): string {
49
+ return opts.netDir
50
+ }
51
+
52
+ // ---------------------------------------------------------------------------
53
+ // 心跳(B 侧写戳)
54
+ // ---------------------------------------------------------------------------
55
+
56
+ export function writeHeartbeat(opts: MutualOptions = DEFAULTS, taskRunning = false): void {
57
+ const dir = netDir(opts)
58
+ fs.mkdirSync(dir, { recursive: true })
59
+ const stamp = {
60
+ ts: Date.now() / 1000,
61
+ pid: process.pid,
62
+ task_running: taskRunning,
63
+ }
64
+ fs.writeFileSync(path.join(dir, 'heartbeat.web.stamp'),
65
+ JSON.stringify(stamp), 'utf-8')
66
+ }
67
+
68
+ export function readHeartbeat(which: 'a' | 'web', opts: MutualOptions = DEFAULTS): {
69
+ ts: number; pid: number; task_running: boolean; ageMs: number
70
+ } | null {
71
+ try {
72
+ const raw = fs.readFileSync(path.join(netDir(opts), `heartbeat.${which}.stamp`), 'utf-8')
73
+ const s = JSON.parse(raw)
74
+ const ageMs = Date.now() - (s.ts as number) * 1000
75
+ return { ts: s.ts, pid: s.pid, task_running: !!s.task_running, ageMs }
76
+ } catch {
77
+ return null
78
+ }
79
+ }
80
+
81
+ /** 失联分级判定(纯函数,A 侧 judge_stamp 的 B 侧镜像) */
82
+ export function judgeStamp(stamp: { ageMs: number; task_running: boolean } | null,
83
+ opts: MutualOptions = DEFAULTS): 'alive' | 'alive_working' | 'warning' | 'dead' | 'no_stamp' {
84
+ if (!stamp) return 'no_stamp'
85
+ const threshold = stamp.task_running ? opts.deadMs * opts.workingFactor : opts.deadMs
86
+ if (stamp.ageMs < opts.warnMs) return 'alive'
87
+ if (stamp.task_running && stamp.ageMs < threshold) return 'alive_working'
88
+ if (stamp.ageMs < threshold) return 'warning'
89
+ return 'dead'
90
+ }
91
+
92
+ // ---------------------------------------------------------------------------
93
+ // 守护 A(检测 harness 进程 + 拉起)
94
+ // ---------------------------------------------------------------------------
95
+
96
+ // 进程探测特征 = 命令行含 'harness.guardian' / 'harness.main'(见 harnessRunning)。
97
+ // issue #19 已知边界(未纳入本轮修复面):Windows 分支按 name='python.exe' 过滤,
98
+ // 用其它可执行名(conda 的 python3.exe 等)启动的 harness 可能漏检;该路径由
99
+ // config.mutual.enabled 控制(默认关)。
100
+
101
+ function execP(cmd: string): Promise<string> {
102
+ return new Promise((resolve) => {
103
+ exec(cmd, { windowsHide: true, timeout: 15_000 }, (err, stdout) => {
104
+ resolve(err ? '' : String(stdout))
105
+ })
106
+ })
107
+ }
108
+
109
+ /** 检测 harness 进程是否存在
110
+ * P1 完善(GPT 审查·wmic 兼容):wmic 在 Win11+ 已被移除——失败时
111
+ * fallback PowerShell Get-CimInstance(Win);非 Windows 用 ps 查询。 */
112
+ export async function harnessRunning(): Promise<boolean> {
113
+ if (process.platform === 'win32') {
114
+ // ① wmic(旧 Win10 可用)
115
+ const out = await execP(
116
+ `wmic process where "name='python.exe'" get commandline 2>nul`)
117
+ if (out.includes('harness.guardian') || out.includes('harness.main')) return true
118
+ // ② wmic 不可用(Win11 移除)→ PowerShell
119
+ const psOut = await execP(
120
+ `powershell -NoProfile -Command "Get-CimInstance Win32_Process -Filter \\"name='python.exe'\\" | Select-Object -ExpandProperty CommandLine"`)
121
+ return psOut.includes('harness.guardian') || psOut.includes('harness.main')
122
+ }
123
+ // 非 Windows(Linux/macOS):ps 查询
124
+ const psOut = await execP(`ps -eo command | grep -E 'harness\\.(guardian|main)' | grep -v grep`)
125
+ return !!psOut
126
+ }
127
+
128
+ /** detached 拉起 A 侧 harness.guardian(幂等:先确认不存在) */
129
+ export async function ensureHarness(python = defaultPython(),
130
+ opts: MutualOptions = DEFAULTS): Promise<'started' | 'already' | 'failed'> {
131
+ const running = await harnessRunning()
132
+ if (running) return 'already'
133
+ // P1 修复(GPT 审查):spawn 找不到可执行文件是异步 error 事件,无监听
134
+ // 会直接崩 Node(Unhandled 'error' event)。加监听 + 超时判定拉起失败。
135
+ return new Promise((resolve) => {
136
+ let child: ReturnType<typeof spawn> | null = null
137
+ let failTimer: NodeJS.Timeout | null = null
138
+ let okTimer: NodeJS.Timeout | null = null
139
+ let settled = false
140
+ const finish = (r: 'started' | 'failed'): void => {
141
+ if (settled) return
142
+ settled = true
143
+ if (failTimer) clearTimeout(failTimer)
144
+ if (okTimer) clearTimeout(okTimer)
145
+ resolve(r)
146
+ }
147
+ try {
148
+ child = spawn(python, ['-m', 'harness.guardian'], {
149
+ windowsHide: true,
150
+ detached: true,
151
+ stdio: 'ignore',
152
+ // 同 mdcg_client:cwd 必须在包外(否则 pnpm 更新时 rmdir 包目录被 Windows
153
+ // 拒绝 → ERR_PNPM_EBUSY);模块解析由 PYTHONPATH 保证,见 datapath.runRoot()。
154
+ cwd: runRoot(),
155
+ // 两条编码注入与 mdcg_client.mdcgChildEnv() 同口径(2026-09-20 v15-9):
156
+ // 本站点此前只给 PYTHONPATH,是「唯一构造点」主张下**未表态**的 Python 站点
157
+ // (v15b 结构扫描:Python 目标 3 站点、走构造点 0 个、两条编码变量全缺 2 个)。
158
+ // 此处**不引** mdcgChildEnv():它构造的是 md_cg 子进程环境(带 MDCG_ROOT /
159
+ // MDCG_MCP_SURFACE / MDCG_MCP_* 等,对 harness.guardian 无意义);只对齐编码口径。
160
+ // 站点表态由 test/python-utf8-mode.test.ts ④(站点扫描)机械守护。
161
+ env: {
162
+ ...process.env,
163
+ PYTHONPATH: pythonPathValue(),
164
+ PYTHONUTF8: '1',
165
+ PYTHONIOENCODING: 'utf-8',
166
+ },
167
+ })
168
+ } catch (e) {
169
+ log(opts, `守护失败:${String(e)}`)
170
+ finish('failed')
171
+ return
172
+ }
173
+ // 拉起失败(python 不存在等)→ 记录 + failed,不崩 Node。
174
+ // spawn 的 error 事件是异步的:不能立即判 started——等 50ms error 窗口,
175
+ // 无 error 才算拉起成功(GPT 审查:此前立即返回 started,错误路径也报成功)。
176
+ child.on('error', (err) => {
177
+ log(opts, `守护拉起错误:${err.message}`)
178
+ finish('failed')
179
+ })
180
+ // 拉起成功但立即退出(harness.guardian 不存在)→ failed
181
+ child.on('exit', (code) => {
182
+ if (code !== null && code !== 0) {
183
+ log(opts, `守护进程退出 code=${code}(guardian 可能不可用)`)
184
+ finish('failed')
185
+ }
186
+ })
187
+ okTimer = setTimeout(() => finish('started'), 50)
188
+ failTimer = setTimeout(() => {
189
+ log(opts, `守护拉起超时(10s 无健康确认)`)
190
+ finish('failed')
191
+ }, 10_000)
192
+ child.unref()
193
+ log(opts, `守护动作:拉起 harness.guardian(pid=${child.pid ?? '?'})`)
194
+ })
195
+ }
196
+
197
+ // ---------------------------------------------------------------------------
198
+ // 任务验证邮箱(双通道:白箱 base_verify + DeepSeek 复核)
199
+ // ---------------------------------------------------------------------------
200
+
201
+ export interface VerifyTask {
202
+ id: string
203
+ type: 'verify' | 'knowledge_sync'
204
+ from: 'A' | 'B'
205
+ to: 'B' | 'A'
206
+ payload: { claim: string; evidence?: string; expected?: string; source_ref?: string }
207
+ status: 'pending' | 'processing' | 'done'
208
+ created_at: number
209
+ }
210
+
211
+ export interface VerifyResult {
212
+ task_id: string
213
+ verdict: 'pass' | 'fail' | 'needs_revision'
214
+ whitebox: { judgment: string; best: string; d_norm: number; record_id: string }
215
+ llm_review: { conclusion: string; reason: string }
216
+ reasons: string[]
217
+ evidence: string[]
218
+ verifier: 'B'
219
+ at: number
220
+ }
221
+
222
+ /** 扫描互维目录里 A→B 的 pending 任务 */
223
+ export function scanTasks(opts: MutualOptions = DEFAULTS): VerifyTask[] {
224
+ const dir = path.join(netDir(opts), 'tasks')
225
+ if (!fs.existsSync(dir)) return []
226
+ const out: VerifyTask[] = []
227
+ for (const f of fs.readdirSync(dir)) {
228
+ if (!f.startsWith('task-') || !f.endsWith('.json')) continue
229
+ try {
230
+ const t = JSON.parse(fs.readFileSync(path.join(dir, f), 'utf-8'))
231
+ if (t.to === 'B' && t.status === 'pending') out.push(t)
232
+ } catch { /* 跳过坏文件 */ }
233
+ }
234
+ return out
235
+ }
236
+
237
+ /** 白箱通道:智慧之书 base_verify(通过 bridge 调用,或本地注入) */
238
+ export async function whiteboxVerify(claim: string,
239
+ verifyFn: (c: string) => Promise<{ judgment: string; best: string; d_norm: number; record_id: string }>): Promise<VerifyResult['whitebox']> {
240
+ try {
241
+ return await verifyFn(claim)
242
+ } catch (e) {
243
+ return { judgment: `whitebox_error: ${String(e)}`, best: '', d_norm: -1, record_id: '' }
244
+ }
245
+ }
246
+
247
+ /** 复核通道:DeepSeek 独立复核(在白箱判定之上) */
248
+ export async function llmReview(claim: string, whitebox: VerifyResult['whitebox'],
249
+ reviewFn: (c: string, w: VerifyResult['whitebox']) => Promise<{ conclusion: string; reason: string }>): Promise<VerifyResult['llm_review']> {
250
+ try {
251
+ return await reviewFn(claim, whitebox)
252
+ } catch (e) {
253
+ return { conclusion: `llm_error: ${String(e)}`, reason: '' }
254
+ }
255
+ }
256
+
257
+ /** 复核结论归一化(issue #354 [P1-4] ④):剔除零宽字符与中文间隔号后再做关键词判定。
258
+ *
259
+ * 缺陷:`c.includes('质疑')` 是字面匹配,`质\u200b疑` / `不·同意` 被分隔后
260
+ * 整条逃逸成 pass。零宽(U+200B–U+200D / U+FEFF)与间隔号 `·` 不承载语义,
261
+ * 归一化只作用于**判据副本**(结论原文仍原样写进 result)。 */
262
+ function normalizeConclusion(raw: string): string {
263
+ return raw.replace(/[\u200B-\u200D\uFEFF\u00B7]/g, '')
264
+ }
265
+
266
+ /** 负向/分歧信号(单点):白箱采纳与否都必须**先**于正向词判定。
267
+ *
268
+ * issue #354 [P1-4] ③:旧实现把 `通过` 判在 `质疑` 之前,「通过?仍有质疑」
269
+ * 先命中正向词即 return pass,`质疑` 分支沦为不可达死代码。 */
270
+ const NEGATIVE_SIGNALS = ['不同意', '不通过', '质疑'] as const
271
+
272
+ function hasNegative(c: string): boolean {
273
+ return NEGATIVE_SIGNALS.some((k) => c.includes(k))
274
+ }
275
+
276
+ /** 综合 verdict(白箱优先) */
277
+ export function combineVerdict(w: VerifyResult['whitebox'],
278
+ l: VerifyResult['llm_review']): VerifyResult['verdict'] {
279
+ const c = normalizeConclusion(l.conclusion || '')
280
+ // P1 修复(GPT 审查):白箱通道异常 → fail-closed(不因复核「同意」而 pass)
281
+ // N268:**复核通道**异常的标记由 llmReview 写在 `l.conclusion`(`llm_error: …`)——
282
+ // 此前只查 w.judgment(该字段只可能由 whiteboxVerify 写 whitebox_error)⇒ 该分支
283
+ // 是死条件,复核抛异常时白箱「采纳」径直判 pass(复核不可用反成「通过」)。
284
+ // 两字段都查:l 侧是真正的生产者口径,w 侧保留同形防御(防上游把异常塞进白箱字段)。
285
+ if (w.judgment.startsWith('whitebox_error') || w.judgment.startsWith('llm_error')
286
+ || c.startsWith('llm_error')) {
287
+ return 'needs_revision'
288
+ }
289
+ // issue #354 [P1-4] ①:白箱距离必须是**有限数值**。旧判据只有 `d_norm < 0`,
290
+ // 而 NaN / ±Infinity / 字符串 / undefined 与 0 比较恒为 false ⇒ 全部穿透放行。
291
+ if (typeof w.d_norm !== 'number' || !Number.isFinite(w.d_norm) || w.d_norm < 0) {
292
+ return 'needs_revision'
293
+ }
294
+ // issue #354 [P1-4] ⑤:记录 id 缺省(空串/非字符串)不得放行——没有记录锚点的
295
+ // 「采纳」无法复核,按证据不足处理。
296
+ if (typeof w.record_id !== 'string' || !w.record_id.trim()) {
297
+ return 'needs_revision'
298
+ }
299
+ // 白箱明确否定 → fail(此时复核结论为空也不改变结论方向)
300
+ if (w.judgment.includes('fail') || w.judgment.includes('不成立')) return 'fail'
301
+ // issue #354 [P1-4] ②:空结论严禁 pass——旧实现 `c = ''` 时白箱采纳直接 pass。
302
+ if (!c) return 'needs_revision'
303
+ if (w.judgment.startsWith('采纳')) {
304
+ // 白箱采纳:复核质疑/不同意→needs_revision(白箱优先,记录分歧);否则 pass
305
+ return hasNegative(c) ? 'needs_revision' : 'pass'
306
+ }
307
+ // 证据不足/无法判断 → 白箱不确定,交给复核决定。
308
+ // issue #354 [P1-4] ③:负向/分歧信号**优先**判定,正向词不得短路它
309
+ //(「通过?仍有质疑」必须 needs_revision;`质疑` 不再是死代码)。
310
+ if (hasNegative(c)) return 'needs_revision'
311
+ if (c.includes('通过') || c.includes('同意')) return 'pass'
312
+ return 'needs_revision'
313
+ }
314
+
315
+ /** 任务 ID 安全校验(P1 修复:防路径穿越——task.id 可含 ../../ 写目录外) */
316
+ const TASK_ID_RE = /^[A-Za-z0-9._-]{1,64}$/
317
+
318
+ export function safeTaskId(id: string): boolean {
319
+ return TASK_ID_RE.test(id) && !id.includes('..')
320
+ }
321
+
322
+ /** 处理单个任务:双通道验证 → 写回 result */
323
+ export async function processTask(task: VerifyTask,
324
+ verifyFn: (c: string) => Promise<{ judgment: string; best: string; d_norm: number; record_id: string }>,
325
+ reviewFn: (c: string, w: VerifyResult['whitebox']) => Promise<{ conclusion: string; reason: string }>,
326
+ opts: MutualOptions = DEFAULTS): Promise<VerifyResult | null> {
327
+ const dir = path.join(netDir(opts), 'tasks')
328
+ // P1 修复(GPT 审查):task.id 路径穿越——非法 id 拒绝处理,不写任何文件
329
+ if (!safeTaskId(task.id)) {
330
+ log(opts, `任务 ${JSON.stringify(task.id)} 非法(路径穿越风险),拒绝处理`)
331
+ throw new Error(`非法任务 id: ${task.id}`)
332
+ }
333
+ const taskPath = path.join(dir, `task-${task.id}.json`)
334
+ // P1 完善(GPT 审查·任务竞态):原子 claim——rename task→processing。
335
+ // 多实例同时 scanTasks 读到同一 pending 时,rename 只有一方成功;
336
+ // 失败(文件已被 rename/不存在)= 其他实例正在处理 → 跳过(返回 null)。
337
+ // 此前无锁:多实例都写 processing/result/done,结果互相覆盖。
338
+ const claimPath = path.join(dir, `processing-${task.id}.json`)
339
+ try {
340
+ fs.renameSync(taskPath, claimPath)
341
+ }
342
+ catch {
343
+ return null // 已被其他实例 claim,或文件不存在
344
+ }
345
+ try {
346
+ // issue #354 [P1-5]:rename 成功后**必须从盘上重读 claim**——内存形参不是真源。
347
+ // 缺陷:旧实现直接 `task.payload.claim` 送审,盘上真实主张 A 可被内存伪造主张 B
348
+ // 顶替(B 通过审计、A 被 rename 成 done 消费),且盘上文件即使是坏 JSON 也照常放行。
349
+ // 现在:盘上文件读不出/非 JSON/缺 payload.claim → 抛错(catch 分支把 claim rename
350
+ // 回 task,不消费、不写 done),审计对象与最终被消费的文件是**同一份**。
351
+ let actual: VerifyTask
352
+ try {
353
+ actual = JSON.parse(fs.readFileSync(claimPath, 'utf-8')) as VerifyTask
354
+ }
355
+ catch (e) {
356
+ throw new Error(`claim 文件不可读或非合法 JSON(拒绝消费): ${(e as Error).message}`)
357
+ }
358
+ const claim = (actual && typeof actual === 'object' && actual.payload
359
+ && typeof actual.payload.claim === 'string') ? actual.payload.claim : ''
360
+ if (!claim.trim()) {
361
+ throw new Error('claim 文件缺少 payload.claim(拒绝消费)')
362
+ }
363
+ const sourceRef = (actual.payload && typeof actual.payload.source_ref === 'string')
364
+ ? actual.payload.source_ref : ''
365
+ const w = await whiteboxVerify(claim, verifyFn)
366
+ const l = await llmReview(claim, w, reviewFn)
367
+ const verdict = combineVerdict(w, l)
368
+ const result: VerifyResult = {
369
+ task_id: task.id,
370
+ verdict,
371
+ whitebox: w,
372
+ llm_review: l,
373
+ reasons: [
374
+ `白箱判定:${w.judgment}(best=${w.best},d_norm=${w.d_norm})`,
375
+ `复核结论:${l.conclusion}`,
376
+ ],
377
+ evidence: [sourceRef].filter(Boolean),
378
+ verifier: 'B',
379
+ at: Date.now() / 1000,
380
+ }
381
+ // 结果先写 tmp 再 rename(原子,防半写文件)
382
+ const resultTmp = path.join(dir, `result-${task.id}.json.tmp`)
383
+ fs.writeFileSync(resultTmp, JSON.stringify(result, null, 2), 'utf-8')
384
+ fs.renameSync(resultTmp, path.join(dir, `result-${task.id}.json`))
385
+ // 完成:清理 claim 文件(rename 回 done 标记供审计)
386
+ fs.renameSync(claimPath, path.join(dir, `done-${task.id}.json`))
387
+ log(opts, `任务 ${task.id} 验证完成:${verdict}`)
388
+ return result
389
+ }
390
+ catch (e) {
391
+ // 处理失败:释放 claim(rename 回 task 供重试)
392
+ try {
393
+ fs.renameSync(claimPath, taskPath)
394
+ }
395
+ catch { /* 文件可能已不在 */ }
396
+ throw e
397
+ }
398
+ }
399
+
400
+ // ---------------------------------------------------------------------------
401
+ // 日志 / last_contact
402
+ // ---------------------------------------------------------------------------
403
+
404
+ export function log(opts: MutualOptions, msg: string): void {
405
+ try {
406
+ const p = path.join(netDir(opts), 'mutual.log')
407
+ fs.appendFileSync(p, `[B ${new Date().toISOString()}] ${msg}\n`, 'utf-8')
408
+ } catch { /* 日志失败不阻塞 */ }
409
+ }
410
+
411
+ export function writeLastContact(opts: MutualOptions = DEFAULTS): void {
412
+ try {
413
+ fs.writeFileSync(path.join(netDir(opts), 'last_contact.json'),
414
+ JSON.stringify({ last_contact_b: Date.now() / 1000 }), 'utf-8')
415
+ } catch { /* 非阻塞 */ }
416
+ }
417
+
418
+ // ---------------------------------------------------------------------------
419
+ // 安装(ctx.effect 作用域内,卸载时清理)
420
+ // ---------------------------------------------------------------------------
421
+
422
+ export function installMutualMaintenance(
423
+ ctx: { logger: { info(m: string): void }; effect(fn: () => () => void, name?: string): void },
424
+ config: Partial<MutualOptions> = {},
425
+ hooks: {
426
+ verify?: (c: string) => Promise<{ judgment: string; best: string; d_norm: number; record_id: string }>
427
+ review?: (c: string, w: VerifyResult['whitebox']) => Promise<{ conclusion: string; reason: string }>
428
+ } = {},
429
+ ): void {
430
+ const opts: MutualOptions = { ...DEFAULTS, ...config }
431
+
432
+ // 1. 心跳写戳 + 守护 A(10min 周期)
433
+ // P1 修复(GPT 审查):cordis-plugin-timer 签名是 interval(callback, delay)
434
+ // ——此前 (ms, fn) 写反:数字被当 callback、函数被当 delay,回调永不执行,
435
+ // 互维心跳/任务扫描实际不工作。
436
+ // P2 修复:不能用 ctx.interval——那是 cordis-plugin-timer 注入的快捷属性,
437
+ // 未声明 `timer` inject 时访问抛 "cannot get property without inject"。
438
+ // 改用 Node 原生 setInterval(互维不需要 Cordis effect 生命周期管理)。
439
+ const heartbeatTimer = setInterval(() => {
440
+ try {
441
+ writeHeartbeat(opts)
442
+ // 守护 A:harness 不在 → 拉起
443
+ ensureHarness(defaultPython(), opts).then((r) => {
444
+ if (r === 'started') ctx.logger.info(`mutual: 已拉起 A 侧 harness(${r})`)
445
+ })
446
+ // 读 A 戳分级判定
447
+ const a = readHeartbeat('a', opts)
448
+ const verdict = judgeStamp(a, opts)
449
+ if (verdict === 'warning') ctx.logger.info('mutual: A 侧心跳告警(>25min 未更新)')
450
+ if (verdict === 'dead') ctx.logger.info('mutual: A 侧失联(>35min),等待 guardian 自愈或告警')
451
+ writeLastContact(opts)
452
+ } catch (e) { /* 单次失败不中断 */ }
453
+ }, opts.heartbeatMs)
454
+ heartbeatTimer.unref?.()
455
+
456
+ // 2. 任务轮询(30s 周期,检查 A→B 任务)
457
+ const taskTimer = setInterval(() => {
458
+ try {
459
+ const tasks = scanTasks(opts)
460
+ for (const t of tasks) {
461
+ if (!hooks.verify || !hooks.review) continue
462
+ processTask(t, hooks.verify, hooks.review, opts).catch((e) => {
463
+ log(opts, `任务 ${t.id} 处理异常:${String(e)}`)
464
+ })
465
+ }
466
+ } catch (e) { /* 单次失败不中断 */ }
467
+ }, 30_000)
468
+ taskTimer.unref?.()
469
+
470
+ // 3. effect 作用域清理
471
+ ctx.effect(() => {
472
+ return () => {
473
+ try {
474
+ clearInterval(heartbeatTimer)
475
+ clearInterval(taskTimer)
476
+ } catch { /* 清理失败不阻塞 */ }
477
+ }
478
+ }, 'dsh-memory-mutual')
479
+ }
480
+
481
+ export default { installMutualMaintenance, writeHeartbeat, readHeartbeat, judgeStamp, scanTasks, processTask }