@furongjun1999/dsh-memory 0.8.0 → 0.9.6

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