@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
@@ -1,292 +1,531 @@
1
- # -*- coding: utf-8 -*-
2
- """md_cg · 冷路径异步深度验证队列
3
-
4
- 【为什么】写入路径中的一跳同步传播(_after_trust → mark_dependents)
5
- 只做「标记存疑」——它不验证下游是否真的被影响。真正的深度验证
6
- 需要:(1) 重跑 judge_qualification 看条件是否仍命中;
7
- (2) 检查依赖链上的验证态是否级联失效。
8
-
9
- 这些操作可重可慢,不该阻塞写入路径。故异步入队,后台消费。
10
-
11
- 【设计】
12
- - enqueue(node_id, action, **kw):入队异步验证任务
13
- - 后台线程消费队列,调 trust.set_state + judge_ranking
14
- - 队列落盘 _coldverify.jsonl(崩溃恢复)
15
- - 默认不启动后台线程(opt-in:start_worker())
16
- - 也可同步消费(drain(),用于测试)
17
-
18
- 【边界】
19
- - 不阻塞写入路径(_after_trust 只 enqueue 不等结果)
20
- - 后台线程异常只记日志不抛(永不拖垮主进程)
21
- - 队列文件可选(无文件时纯内存,适合测试)
22
-
23
- 零第三方依赖(D-005)。
24
- """
25
- from __future__ import annotations
26
-
27
- import json
28
- import os
29
- import threading
30
- import time
31
- from collections import deque
32
-
33
- #: 队列文件名
34
- QUEUE_FILE = "_coldverify.jsonl"
35
- #: 后台线程轮询间隔(秒)
36
- POLL_INTERVAL = 2.0
37
- #: 单次批处理上限
38
- BATCH_LIMIT = 10
39
-
40
- _VALID_ACTIONS = {"reverify", "propagate_depth", "patrol_check"}
41
-
42
-
43
- class ColdVerifyQueue:
44
- """冷路径异步深度验证队列。
45
-
46
- 线程安全:enqueue/drain/status 可跨线程调用。
47
- """
48
-
49
- def __init__(self, root=None):
50
- self._root = root
51
- self._queue: deque = deque()
52
- self._lock = threading.Lock()
53
- self._worker = None
54
- self._stop = threading.Event()
55
- self._stats = {"enqueued": 0, "processed": 0, "errors": 0,
56
- "skipped": 0}
57
- self._queue_path = (os.path.join(root, QUEUE_FILE)
58
- if root else None)
59
- self._load_persisted()
60
-
61
- def _load_persisted(self):
62
- """从队列文件恢复未处理任务(崩溃恢复)。
63
-
64
- **加载路径与入口同白名单**(2026-09-20 v15-1 姊妹项):`enqueue()` 用
65
- `_VALID_ACTIONS` 拒收未知 action,加载路径此前却直接 append——队列文件里
66
- 出现任意字符串都会在 `drain` 时交给 `_process`,落到 `unknown_action`
67
- 分支(或执行任意已知分支)。「入口校验、加载不校验」是不对称的,而这里
68
- 的数据来自磁盘(可能被旧版本或手工编辑写坏)。故按同一白名单拒收并
69
- 计入 `skipped`,不静默放行。
70
- """
71
- if not self._queue_path or not os.path.exists(self._queue_path):
72
- return
73
- try:
74
- with open(self._queue_path, "r", encoding="utf-8") as f:
75
- for line in f:
76
- line = line.strip()
77
- if not line:
78
- continue
79
- task = json.loads(line)
80
- if task.get("_done"):
81
- continue
82
- if task.get("action") not in _VALID_ACTIONS:
83
- self._stats["skipped"] += 1 # 拒收:非法 action 不入队
84
- continue
85
- self._queue.append(task)
86
- except Exception: # noqa: BLE001
87
- pass # 崩溃恢复容错:文件损坏就不恢复
88
-
89
- def _persist(self):
90
- """持久化当前队列(全量覆写)。"""
91
- if not self._queue_path:
92
- return
93
- try:
94
- with open(self._queue_path, "w", encoding="utf-8") as f:
95
- for task in self._queue:
96
- f.write(json.dumps(task, ensure_ascii=False) + "\n")
97
- except Exception: # noqa: BLE001
98
- pass # 持久化失败不影响内存队列
99
-
100
- def enqueue(self, node_id: str, action: str = "reverify", **kw):
101
- """入队异步验证任务。返回 task dict。"""
102
- if action not in _VALID_ACTIONS:
103
- raise ValueError(f"未知 action: {action},合法: {_VALID_ACTIONS}")
104
- task = {
105
- "node_id": node_id,
106
- "action": action,
107
- "enqueued_at": time.time(),
108
- "kwargs": kw,
109
- }
110
- with self._lock:
111
- self._queue.append(task)
112
- self._stats["enqueued"] += 1
113
- self._persist()
114
- return task
115
-
116
- def drain(self, cg, *, limit=BATCH_LIMIT):
117
- """同步消费队列(用于测试/手动处理)。返回处理结果列表。"""
118
- results = []
119
- with self._lock:
120
- batch = []
121
- for _ in range(min(limit, len(self._queue))):
122
- batch.append(self._queue.popleft())
123
- for task in batch:
124
- try:
125
- r = self._process(cg, task)
126
- results.append(r)
127
- self._stats["processed"] += 1
128
- except Exception as exc: # noqa: BLE001
129
- self._stats["errors"] += 1
130
- results.append({"node_id": task["node_id"],
131
- "action": task["action"],
132
- "error": str(exc),
133
- "ok": False})
134
- with self._lock:
135
- self._persist()
136
- return results
137
-
138
- def _process(self, cg, task):
139
- """执行单个验证任务。"""
140
- from . import trust
141
- nid = task["node_id"]
142
- action = task["action"]
143
- kw = task.get("kwargs", {})
144
-
145
- if action == "reverify":
146
- # 重新验证单节点:重跑 judge_qualification
147
- node = cg.get(nid)
148
- if not node:
149
- self._stats["skipped"] += 1
150
- return {"node_id": nid, "action": action, "ok": True,
151
- "skipped": "node_not_found"}
152
- fm = node.get("frontmatter") or {}
153
- old_state = trust.state_of(fm)
154
- # 只对非 unverified 节点做深度验证
155
- if old_state == "unverified":
156
- self._stats["skipped"] += 1
157
- return {"node_id": nid, "action": action, "ok": True,
158
- "skipped": "unverified_no_action"}
159
- # 检查时效
160
- kind, _, _ = trust.validity(fm)
161
- want, why = None, ""
162
- if kind == "expired" and old_state != "expired":
163
- want, why = "expired", "冷路径:时效过期"
164
- elif kind == "not_yet":
165
- want, why = "unverified", "冷路径:尚未生效"
166
- if want is None:
167
- return {"node_id": nid, "action": action, "ok": True,
168
- "old_state": old_state, "new_state": old_state,
169
- "changed": False}
170
- # 迁移结果**必须检查**(2026-09-20 v14 缺陷 D 修复):`trust.set_state`
171
- # 对非法迁移返回 ok=False(负路由不抛异常),旧实现丢弃返回值后一律
172
- # 上报 `ok=True + new_state=<请求值>` —— 恰好在本队列最该说话的两条
173
- # 迁移上(doubted→expired / verified→unverified,均为 TRANSITIONS
174
- # 明令拒绝的跳级)**说了假话**,且 stats.errors 恒 0 把它盖住。
175
- # trust 层做对了(拒绝非法迁移),队列层不得把它翻译成成功。
176
- r = trust.set_state(cg, nid, want, reason=why,
177
- actor="coldverify", **kw)
178
- if not r.get("ok"):
179
- self._stats["errors"] += 1
180
- return {"node_id": nid, "action": action, "ok": False,
181
- "old_state": old_state, "requested_state": want,
182
- "error": "transition_rejected:%s" % r.get("error"),
183
- "reason": r.get("reason") or "",
184
- "detail": "非法迁移被 trust.TRANSITIONS 拒绝,状态未变"}
185
- return {"node_id": nid, "action": action, "ok": True,
186
- "old_state": old_state, "new_state": want,
187
- "changed": bool(r.get("changed"))}
188
-
189
- elif action == "propagate_depth":
190
- # 多跳深度传播
191
- r = trust.propagate(cg, apply=True, actor="coldverify",
192
- **kw)
193
- # `ok` 由**内层结论**决定,不得硬编码(2026-09-20 v15-1 修复):
194
- # `trust.propagate` 有失败态(异常路径返回 `ok=False, degraded=True`),
195
- # 旧写法一律上报 True。当前内层成功路径恒 ok=True,故本分支行为不变
196
- # ——但判据应由内层决定,而不是由「当前恰好没失败」决定。
197
- ok = bool(r.get("ok"))
198
- if not ok:
199
- self._stats["errors"] += 1
200
- return {"node_id": nid, "action": action, "ok": ok,
201
- "propagation": r}
202
-
203
- elif action == "patrol_check":
204
- # 巡检式检查
205
- rep = trust.patrol(cg, **kw)
206
- # `ok` 由**内层结论**决定(2026-09-20 v15-1 修复,同 v14 缺陷 D 病类):
207
- # `trust.patrol` 的返回是 `{"ok": not dangling, ...}`——**有真实失败态**
208
- # (存在悬空依赖即 ok=False)。旧写法 `{"ok": True, ...}` 把内层失败
209
- # 翻译成成功、`stats.errors` 恒 0,正是「队列层替内层说假话」。D 只修了
210
- # `reverify` 一支,本支与 `propagate_depth` 是同函数内的兄弟分支。
211
- ok = bool(rep.get("ok"))
212
- if not ok:
213
- self._stats["errors"] += 1
214
- return {"node_id": nid, "action": action, "ok": ok,
215
- "patrol": rep}
216
-
217
- return {"node_id": nid, "action": action, "ok": False,
218
- "error": "unknown_action"}
219
-
220
- def start_worker(self, cg, *, poll_interval=POLL_INTERVAL):
221
- """启动后台消费线程。"""
222
- if self._worker and self._worker.is_alive():
223
- return self._worker
224
- self._stop.clear()
225
-
226
- def _run():
227
- while not self._stop.is_set():
228
- try:
229
- if self._queue:
230
- self.drain(cg, limit=BATCH_LIMIT)
231
- except Exception: # noqa: BLE001
232
- self._stats["errors"] += 1
233
- self._stop.wait(poll_interval)
234
-
235
- self._worker = threading.Thread(target=_run, daemon=True,
236
- name="coldverify-worker")
237
- self._worker.start()
238
- return self._worker
239
-
240
- def stop_worker(self, timeout=5.0):
241
- """停止后台线程。"""
242
- self._stop.set()
243
- if self._worker and self._worker.is_alive():
244
- self._worker.join(timeout=timeout)
245
- self._worker = None
246
-
247
- def status(self):
248
- """返回队列状态。"""
249
- with self._lock:
250
- return {
251
- "queue_size": len(self._queue),
252
- "stats": dict(self._stats),
253
- "worker_alive": (self._worker is not None
254
- and self._worker.is_alive()),
255
- "queue_file": self._queue_path,
256
- }
257
-
258
- def clear(self):
259
- """清空队列(测试用)。"""
260
- with self._lock:
261
- self._queue.clear()
262
- self._persist()
263
-
264
-
265
- #: 进程级默认实例
266
- _DEFAULT = None
267
-
268
-
269
- def default_queue(root=None):
270
- """进程级默认冷路径队列单例。"""
271
- global _DEFAULT
272
- if _DEFAULT is None:
273
- _DEFAULT = ColdVerifyQueue(root=root)
274
- return _DEFAULT
275
-
276
-
277
- def attach(cg):
278
- """给 cg 实例挂冷路径队列(幂等)。"""
279
- if not hasattr(cg, "_coldverify") or cg._coldverify is None:
280
- cg._coldverify = ColdVerifyQueue(root=cg.root)
281
- return cg._coldverify
282
-
283
-
284
- def get(cg):
285
- """取 cg 实例的冷路径队列(未挂返回 None)。"""
286
- return getattr(cg, "_coldverify", None)
287
-
288
-
289
- def enqueue(cg, node_id: str, action: str = "reverify", **kw):
290
- """快捷入口:挂队列 + 入队。"""
291
- q = attach(cg)
292
- return q.enqueue(node_id, action, **kw)
1
+ # -*- coding: utf-8 -*-
2
+ """md_cg · 冷路径异步深度验证队列
3
+
4
+ 【为什么】写入路径中的一跳同步传播(_after_trust → mark_dependents)
5
+ 只做「标记存疑」——它不验证下游是否真的被影响。真正的深度验证
6
+ 需要:(1) 重跑 judge_qualification 看条件是否仍命中;
7
+ (2) 检查依赖链上的验证态是否级联失效。
8
+
9
+ 这些操作可重可慢,不该阻塞写入路径。故异步入队,后台消费。
10
+
11
+ 【设计】
12
+ - enqueue(node_id, action, **kw):入队异步验证任务
13
+ - 后台线程消费队列,调 trust.set_state + judge_ranking
14
+ - 队列落盘 _coldverify.jsonl(崩溃恢复)
15
+ - 默认不启动后台线程(opt-in:start_worker())
16
+ - 也可同步消费(drain(),用于测试)
17
+
18
+ 【边界】
19
+ - 不阻塞写入路径(_after_trust 只 enqueue 不等结果)
20
+ - 后台线程异常只记日志不抛(永不拖垮主进程)
21
+ - 队列文件可选(无文件时纯内存,适合测试)
22
+
23
+ 零第三方依赖(D-005)。
24
+ """
25
+ from __future__ import annotations
26
+
27
+ import json
28
+ import os
29
+ import threading
30
+ import time
31
+ from collections import Counter, deque
32
+
33
+ from .fsutil import FileLock as _FileLock
34
+ from .fsutil import atomic_write as _atomic_write
35
+ from .fsutil import ends_mid_line as _ends_mid_line
36
+ from .fsutil import read_jsonl as _read_jsonl
37
+
38
+ #: 队列文件名
39
+ QUEUE_FILE = "_coldverify.jsonl"
40
+ #: 后台线程轮询间隔(秒)
41
+ POLL_INTERVAL = 2.0
42
+ #: 单次批处理上限
43
+ BATCH_LIMIT = 10
44
+
45
+ _VALID_ACTIONS = {"reverify", "propagate_depth", "patrol_check"}
46
+
47
+
48
+ class ColdVerifyQueue:
49
+ """冷路径异步深度验证队列。
50
+
51
+ 线程安全:enqueue/drain/status 可跨线程调用。
52
+ """
53
+
54
+ def __init__(self, root=None):
55
+ self._root = root
56
+ self._queue: deque = deque()
57
+ self._lock = threading.Lock()
58
+ self._worker = None
59
+ self._stop = threading.Event()
60
+ self._stats = {"enqueued": 0, "processed": 0, "errors": 0,
61
+ "skipped": 0}
62
+ self._queue_path = (os.path.join(root, QUEUE_FILE)
63
+ if root else None)
64
+ self._load_persisted()
65
+
66
+ def _load_persisted(self):
67
+ """从队列文件恢复未处理任务(崩溃恢复)。
68
+
69
+ **加载路径与入口同白名单**(2026-09-20 v15-1 姊妹项):`enqueue()` 用
70
+ `_VALID_ACTIONS` 拒收未知 action,加载路径此前却直接 append——队列文件里
71
+ 出现任意字符串都会在 `drain` 时交给 `_process`,落到 `unknown_action`
72
+ 分支(或执行任意已知分支)。「入口校验、加载不校验」是不对称的,而这里
73
+ 的数据来自磁盘(可能被旧版本或手工编辑写坏)。故按同一白名单拒收并
74
+ 计入 `skipped`,不静默放行。
75
+
76
+ issue #265:**逐行容错**。此前 `json.loads` 的异常由包住整个循环的
77
+ `except` 捕获 ⇒ 上一个写者被杀死留下的半截行会让**整份队列都不恢复**
78
+ (实测)。改为逐行捕获:坏行只丢它自己,后续行照常恢复。
79
+ """
80
+ if not self._queue_path or not os.path.exists(self._queue_path):
81
+ return
82
+ for task in _read_jsonl(self._queue_path):
83
+ try:
84
+ if task.get("_done"):
85
+ continue
86
+ if task.get("action") not in _VALID_ACTIONS:
87
+ self._stats["skipped"] += 1 # 拒收:非法 action 不入队
88
+ continue
89
+ self._queue.append(task)
90
+ except Exception: # noqa: BLE001
91
+ self._stats["skipped"] += 1
92
+
93
+ def _append_persisted(self, task):
94
+ """把**一条**任务追加到队列文件(issue #265)。
95
+
96
+ 此前 `enqueue` 调 `_persist()` 做全量覆写——写盘的是「本实例内存的
97
+ 快照」,跨实例没有任何互斥或合并。多实例共用同一 root 时(两个 MCP
98
+ server 进程,或 server + CLI),后落盘者把先落盘者刚写的整段抹掉,
99
+ 两边都 rc=0、都报成功、**无痕丢失**(实测:两进程各自入队 →
100
+ `disk_lines=1`)。
101
+
102
+ 追加在物理上抹不掉别人的条目。半截行(上一个写者被杀在中途)由
103
+ `_ends_mid_line` 补一个换行处理,否则新记录会粘在那行上、两条都解析
104
+ 不出来。
105
+
106
+ 跨进程 FileLock:与 `_drop_persisted` 的读改写互斥——否则「追加」可能
107
+ 落在对方的「读」与「写回」之间而被覆盖。strict=False(best-effort):
108
+ 入队在**写路径**上(`writepipe._after_trust` 每次写入都调),锁竞争失败
109
+ 时宁可让这次追加无锁落盘,也不能让异常打断写入(调用方已 try/except,
110
+ 但静默放行比抛更符合本模块「永不拖垮主进程」的边界)。
111
+ """
112
+ if not self._queue_path:
113
+ return
114
+ line = json.dumps(task, ensure_ascii=False) + "\n"
115
+ try:
116
+ with _FileLock(self._queue_path, strict=False):
117
+ if _ends_mid_line(self._queue_path):
118
+ line = "\n" + line
119
+ d = os.path.dirname(os.path.abspath(self._queue_path)) or "."
120
+ os.makedirs(d, exist_ok=True)
121
+ fd = os.open(self._queue_path,
122
+ os.O_CREAT | os.O_WRONLY | os.O_APPEND, 0o600)
123
+ try:
124
+ os.write(fd, line.encode("utf-8"))
125
+ finally:
126
+ os.close(fd)
127
+ except Exception: # noqa: BLE001
128
+ pass # 持久化失败不影响内存队列
129
+
130
+ def _drop_persisted(self, consumed):
131
+ """从队列文件删掉**本实例刚消费**的条目(issue #265)。
132
+
133
+ 读改写全程持跨进程 `FileLock(strict=True)` 并以 `atomic_write` 落盘
134
+ (整文件替换:读者要么看到旧内容、要么看到新内容,永远看不到半截)。
135
+
136
+ **只删自己消费的**:他实例刚追加的条目原样保留——这正是本件的病象
137
+ (全量覆写会把它们抹掉)。匹配键取 `(node_id, action, enqueued_at)`,
138
+ 用 Counter 逐条扣减,故同键的重复入队也各删一条、不会多删别人的。
139
+
140
+ `strict=True`:消费是**不能丢**的写(删错了等于把别人的任务抹掉,正是
141
+ 本件要修的),锁竞争失败时显式抛出让调用方重试,好过静默退化为无锁
142
+ 并发。异常由本方法的 `except` 收口——drain 不因落盘失败而崩。
143
+ """
144
+ if not self._queue_path or not consumed:
145
+ return
146
+ want = Counter((t.get("node_id"), t.get("action"), t.get("enqueued_at"))
147
+ for t in consumed)
148
+ try:
149
+ with _FileLock(self._queue_path, strict=True):
150
+ if not os.path.exists(self._queue_path):
151
+ return
152
+ kept = []
153
+ for task in _read_jsonl(self._queue_path):
154
+ k = (task.get("node_id"), task.get("action"),
155
+ task.get("enqueued_at"))
156
+ if want.get(k, 0) > 0:
157
+ want[k] -= 1 # 本实例消费掉的:从盘上摘除
158
+ continue
159
+ if task.get("_done"):
160
+ continue # 墓碑:已消费,不再入队
161
+ kept.append(task)
162
+ _atomic_write(self._queue_path, "".join(
163
+ json.dumps(t, ensure_ascii=False) + "\n" for t in kept))
164
+ except Exception: # noqa: BLE001
165
+ pass # 持久化失败不影响内存队列
166
+
167
+ def _persist(self):
168
+ """全量覆写当前队列。**仅供 clear() 的重置语义**(enqueue/drain 不再走它)。
169
+
170
+ issue #265:全量覆写正是丢条目的根因,故入队改走 `_append_persisted`
171
+ (追加)、消费改走 `_drop_persisted`(只删自己消费的)。本方法保留给
172
+ `clear()` 的显式重置,并补上跨进程锁 + 原子替换。
173
+ """
174
+ if not self._queue_path:
175
+ return
176
+ try:
177
+ with _FileLock(self._queue_path, strict=True):
178
+ _atomic_write(self._queue_path, "".join(
179
+ json.dumps(task, ensure_ascii=False) + "\n"
180
+ for task in self._queue))
181
+ except Exception: # noqa: BLE001
182
+ pass # 持久化失败不影响内存队列
183
+
184
+ def enqueue(self, node_id: str, action: str = "reverify", **kw):
185
+ """入队异步验证任务。返回 task dict。"""
186
+ if action not in _VALID_ACTIONS:
187
+ raise ValueError(f"未知 action: {action},合法: {_VALID_ACTIONS}")
188
+ task = {
189
+ "node_id": node_id,
190
+ "action": action,
191
+ "enqueued_at": time.time(),
192
+ "kwargs": kw,
193
+ }
194
+ with self._lock:
195
+ self._queue.append(task)
196
+ self._stats["enqueued"] += 1
197
+ # issue #265:追加而非全量覆写(后者会抹掉他实例刚写的条目)
198
+ self._append_persisted(task)
199
+ return task
200
+
201
+ def drain(self, cg, *, limit=BATCH_LIMIT, dry_run=False):
202
+ """同步消费队列(用于测试/手动处理)。返回处理结果列表。
203
+
204
+ issue #72(2026-10-09 DSH 端):dry_run=True 时**只预演不消费**——
205
+ 不 popleft、不 _process、不落盘、不计数,只列出**将消费**的条目及其积压龄。
206
+ 注意本方法本就**不启常驻线程**(opt-in 语义见 :15),dry_run 只是把
207
+ 「想看看会发生什么」这条路也显式化。"""
208
+ if dry_run:
209
+ with self._lock:
210
+ preview = list(self._queue)[:max(0, int(limit))]
211
+ now = time.time()
212
+ return {"dry_run": True,
213
+ "would_process": [
214
+ {"node_id": x.get("node_id"),
215
+ "action": x.get("action"),
216
+ "enqueued_at": x.get("enqueued_at"),
217
+ "age_s": round(now - float(x.get("enqueued_at") or 0), 1)}
218
+ for x in preview],
219
+ "queue_size": len(self._queue),
220
+ "limit": int(limit)}
221
+ results = []
222
+ with self._lock:
223
+ batch = []
224
+ for _ in range(min(limit, len(self._queue))):
225
+ batch.append(self._queue.popleft())
226
+ for task in batch:
227
+ try:
228
+ r = self._process(cg, task)
229
+ results.append(r)
230
+ self._stats["processed"] += 1
231
+ except Exception as exc: # noqa: BLE001
232
+ self._stats["errors"] += 1
233
+ results.append({"node_id": task["node_id"],
234
+ "action": task["action"],
235
+ "error": str(exc),
236
+ "ok": False})
237
+ # issue #265:只从盘上摘除**本批消费掉**的条目——全量覆写会把他实例
238
+ # 刚追加的条目一并抹掉(本件的病象)。
239
+ self._drop_persisted(batch)
240
+ return results
241
+
242
+ def _process(self, cg, task):
243
+ """执行单个验证任务。"""
244
+ from . import trust
245
+ nid = task["node_id"]
246
+ action = task["action"]
247
+ kw = task.get("kwargs", {})
248
+
249
+ if action == "reverify":
250
+ # 重新验证单节点:重跑 judge_qualification
251
+ node = cg.get(nid)
252
+ if not node:
253
+ self._stats["skipped"] += 1
254
+ return {"node_id": nid, "action": action, "ok": True,
255
+ "skipped": "node_not_found"}
256
+ fm = node.get("frontmatter") or {}
257
+ old_state = trust.state_of(fm)
258
+ # 只对非 unverified 节点做深度验证
259
+ if old_state == "unverified":
260
+ self._stats["skipped"] += 1
261
+ return {"node_id": nid, "action": action, "ok": True,
262
+ "skipped": "unverified_no_action"}
263
+ # 检查时效
264
+ kind, _, _ = trust.validity(fm)
265
+ want, why = None, ""
266
+ if kind == "expired" and old_state != "expired":
267
+ want, why = "expired", "冷路径:时效过期"
268
+ elif kind == "not_yet":
269
+ want, why = "unverified", "冷路径:尚未生效"
270
+ if want is None:
271
+ return {"node_id": nid, "action": action, "ok": True,
272
+ "old_state": old_state, "new_state": old_state,
273
+ "changed": False}
274
+ # 迁移结果**必须检查**(2026-09-20 v14 缺陷 D 修复):`trust.set_state`
275
+ # 对非法迁移返回 ok=False(负路由不抛异常),旧实现丢弃返回值后一律
276
+ # 上报 `ok=True + new_state=<请求值>` —— 恰好在本队列最该说话的两条
277
+ # 迁移上(doubted→expired / verified→unverified,均为 TRANSITIONS
278
+ # 明令拒绝的跳级)**说了假话**,且 stats.errors 恒 0 把它盖住。
279
+ # trust 层做对了(拒绝非法迁移),队列层不得把它翻译成成功。
280
+ r = trust.set_state(cg, nid, want, reason=why,
281
+ actor="coldverify", **kw)
282
+ if not r.get("ok"):
283
+ self._stats["errors"] += 1
284
+ return {"node_id": nid, "action": action, "ok": False,
285
+ "old_state": old_state, "requested_state": want,
286
+ "error": "transition_rejected:%s" % r.get("error"),
287
+ "reason": r.get("reason") or "",
288
+ "detail": "非法迁移被 trust.TRANSITIONS 拒绝,状态未变"}
289
+ return {"node_id": nid, "action": action, "ok": True,
290
+ "old_state": old_state, "new_state": want,
291
+ "changed": bool(r.get("changed"))}
292
+
293
+ elif action == "propagate_depth":
294
+ # 多跳深度传播
295
+ r = trust.propagate(cg, apply=True, actor="coldverify",
296
+ **kw)
297
+ # `ok` 由**内层结论**决定,不得硬编码(2026-09-20 v15-1 修复):
298
+ # `trust.propagate` 有失败态(异常路径返回 `ok=False, degraded=True`),
299
+ # 旧写法一律上报 True。当前内层成功路径恒 ok=True,故本分支行为不变
300
+ # ——但判据应由内层决定,而不是由「当前恰好没失败」决定。
301
+ ok = bool(r.get("ok"))
302
+ if not ok:
303
+ self._stats["errors"] += 1
304
+ return {"node_id": nid, "action": action, "ok": ok,
305
+ "propagation": r}
306
+
307
+ elif action == "patrol_check":
308
+ # 巡检式检查
309
+ rep = trust.patrol(cg, **kw)
310
+ # `ok` 由**内层结论**决定(2026-09-20 v15-1 修复,同 v14 缺陷 D 病类):
311
+ # `trust.patrol` 的返回是 `{"ok": not dangling, ...}`——**有真实失败态**
312
+ # (存在悬空依赖即 ok=False)。旧写法 `{"ok": True, ...}` 把内层失败
313
+ # 翻译成成功、`stats.errors` 恒 0,正是「队列层替内层说假话」。D 只修了
314
+ # `reverify` 一支,本支与 `propagate_depth` 是同函数内的兄弟分支。
315
+ ok = bool(rep.get("ok"))
316
+ if not ok:
317
+ self._stats["errors"] += 1
318
+ return {"node_id": nid, "action": action, "ok": ok,
319
+ "patrol": rep}
320
+
321
+ return {"node_id": nid, "action": action, "ok": False,
322
+ "error": "unknown_action"}
323
+
324
+ def start_worker(self, cg, *, poll_interval=POLL_INTERVAL):
325
+ """启动后台消费线程。"""
326
+ if self._worker and self._worker.is_alive():
327
+ return self._worker
328
+ self._stop.clear()
329
+
330
+ def _run():
331
+ while not self._stop.is_set():
332
+ try:
333
+ if self._queue:
334
+ self.drain(cg, limit=BATCH_LIMIT)
335
+ except Exception: # noqa: BLE001
336
+ self._stats["errors"] += 1
337
+ self._stop.wait(poll_interval)
338
+
339
+ self._worker = threading.Thread(target=_run, daemon=True,
340
+ name="coldverify-worker")
341
+ self._worker.start()
342
+ return self._worker
343
+
344
+ def stop_worker(self, timeout=5.0):
345
+ """停止后台线程。"""
346
+ self._stop.set()
347
+ if self._worker and self._worker.is_alive():
348
+ self._worker.join(timeout=timeout)
349
+ self._worker = None
350
+
351
+ def status(self):
352
+ """返回队列状态。"""
353
+ with self._lock:
354
+ return {
355
+ "queue_size": len(self._queue),
356
+ "stats": dict(self._stats),
357
+ "worker_alive": (self._worker is not None
358
+ and self._worker.is_alive()),
359
+ # issue #72:积压龄(最久未消费条目的秒数)——让「积压无人管」
360
+ # 不再是隐性状态;空队列为 None。
361
+ "oldest_age_s": (
362
+ round(time.time() - min(float(x.get("enqueued_at") or 0)
363
+ for x in self._queue), 1)
364
+ if self._queue else None),
365
+ "queue_file": self._queue_path,
366
+ }
367
+
368
+ def clear(self):
369
+ """清空队列(测试用)。"""
370
+ with self._lock:
371
+ self._queue.clear()
372
+ self._persist()
373
+
374
+ def _requeue_failed(self, task, attempts):
375
+ """把**消费失败**的任务放回队尾(issue #72:失败不得静默蒸发)。
376
+
377
+ 与 `enqueue` 同款落盘路径(追加 + 跨进程锁),但保留 `attempts` 计数
378
+ (`_process` 不读该键,只透传 node_id/action/kwargs,故不污染执行面)。
379
+ 重试用尽由调用方(`controlled_drain`)决定丢弃并计入 dead_letter。
380
+ """
381
+ t = {
382
+ "node_id": task.get("node_id"),
383
+ "action": task.get("action"),
384
+ "enqueued_at": time.time(),
385
+ "kwargs": task.get("kwargs") or {},
386
+ "attempts": int(attempts),
387
+ }
388
+ with self._lock:
389
+ self._queue.append(t)
390
+ self._stats["enqueued"] += 1
391
+ self._append_persisted(t)
392
+ return t
393
+
394
+
395
+ #: issue #72:受控消费的**单批硬上限**(与后台线程批大小同源,不另立第二套数)。
396
+ CONTROL_LIMIT_MAX = BATCH_LIMIT
397
+ #: issue #72:失败任务重试上限;超过即丢弃并计入 dead_letter(可见、不无限滞留)。
398
+ CONTROL_MAX_ATTEMPTS = 3
399
+
400
+
401
+ def controlled_drain(cg, *, limit=BATCH_LIMIT, dry_run=False, principal=None):
402
+ """受控消费入口(issue #72)——权限、限量、审计三闸齐备的**显式**消费。
403
+
404
+ 背景:#72 报「队列仅可观察、无受控消费入口」(queue_size 119 / processed 0 /
405
+ worker_alive false)。`drain()` 本身是同步消费,但它是库内方法:没有权限门、
406
+ 没有单批硬上限、没有审计,任何拿到 cg 的调用方都能全量消费且不留痕。
407
+ 本函数是**工具面可接线的单点入口**,不引入常驻线程(opt-in 语义不变)。
408
+
409
+ 三闸(缺一不可):
410
+ 1. **权限**:调用方须 `can_admin`(显式 principal 优先,否则取 cg.principal)。
411
+ 未授权直接 `{"ok": False, "error": "forbidden"}`——**不返回队列内容**
412
+ (连 node_id 都不给),故「未授权不能看到任务正文或触发消费」。
413
+ 2. **限量**:`0 <= limit <= CONTROL_LIMIT_MAX`,越界 fail-closed 返回
414
+ `bad_limit`(不静默截断——截断会让调用方以为处理了 N 条)。
415
+ 3. **审计**:cg 有 `_audit` 时写一行聚合(dry_run/limit/processed/errors/
416
+ requeued/dead_letter/queue_size/oldest_age_s),绝不记正文(payload-free)。
417
+
418
+ 失败处置:`ok=False` 的任务重新入队(attempts+1,最多 `CONTROL_MAX_ATTEMPTS`
419
+ 次),超过则丢弃并计入 `dead_letter`——「消费失败可见、可重试、不无限滞留」。
420
+ 成功的任务已由 drain 从内存与盘上摘除,重复运行不会重复状态迁移。
421
+
422
+ 返回体(成功):
423
+ {"ok", "dry_run", "limit", "processed", "errors": [...], "skipped",
424
+ "requeued", "dead_letter", "results", "queue_size", "oldest_age_s",
425
+ "worker_alive", "audit"}
426
+ dry_run=True 时返回 `would_process`(node_id/action/age_s,无正文)且不消费、
427
+ 不落盘、不计数、不写审计(预演本身不是管理动作)。
428
+
429
+ 【功能名】coldverify 受控消费入口
430
+ 【生效条件】cg 的 principal.can_admin 为真且 limit 在 [0, CONTROL_LIMIT_MAX];
431
+ dry_run 亦须过同一权限闸(否则可借预演侧读队列组成)。
432
+ 【子功能】单批限量消费 / 预演 / 失败重入队与 dead-letter / 聚合审计。
433
+ 【执行】controlled_drain(cg, limit=N, dry_run=False, principal=None)
434
+ 【验证方式】md_cg/test_issue72_coldverify_controlled_drain.py(含 --mutate)。
435
+ 【不适用条件】不适用于后台常驻消费(那仍是 start_worker 的 opt-in 语义);
436
+ 不改变 drain() 既有契约(本函数在它之上加闸,不改其行为)。
437
+ """
438
+ q = get(cg)
439
+ if q is None:
440
+ return {"ok": False, "error": "no_queue",
441
+ "reason": "cg 未挂冷路径队列(先 coldverify.attach(cg))"}
442
+ p = principal if principal is not None else getattr(cg, "principal", None)
443
+ if not getattr(p, "can_admin", False):
444
+ return {"ok": False, "error": "forbidden",
445
+ "reason": "受控消费需 can_admin(未授权调用不返回队列内容)"}
446
+ try:
447
+ lim = int(limit)
448
+ except (TypeError, ValueError):
449
+ return {"ok": False, "error": "bad_limit", "reason": "limit 必须是整数"}
450
+ if lim < 0 or lim > CONTROL_LIMIT_MAX:
451
+ return {"ok": False, "error": "bad_limit",
452
+ "reason": "limit 须在 [0, %d](单批硬上限)" % CONTROL_LIMIT_MAX,
453
+ "limit_max": CONTROL_LIMIT_MAX}
454
+ st = q.status()
455
+ if dry_run:
456
+ # 预演不消费、不落盘、不计数、不审计(issue #72 验收:dry-run 不改队列)。
457
+ return {"ok": True, "dry_run": True, "limit": lim,
458
+ "would_process": q.drain(cg, limit=lim, dry_run=True)["would_process"],
459
+ "queue_size": st["queue_size"],
460
+ "oldest_age_s": st.get("oldest_age_s"),
461
+ "worker_alive": st.get("worker_alive"),
462
+ "audit": False}
463
+ # 取本批原任务快照(失败项要按原 kwargs 重入队)——与 drain 同锁口径。
464
+ with q._lock:
465
+ batch = list(q._queue)[:lim]
466
+ results = q.drain(cg, limit=lim)
467
+ errs, requeued, dead = [], 0, 0
468
+ for i, r in enumerate(results):
469
+ if r.get("ok"):
470
+ continue
471
+ errs.append({"node_id": r.get("node_id"), "action": r.get("action"),
472
+ "error": r.get("error") or r.get("skipped") or "unknown"})
473
+ src = batch[i] if i < len(batch) else None
474
+ if src is None:
475
+ dead += 1
476
+ continue
477
+ attempts = int(src.get("attempts") or 0) + 1
478
+ if attempts > CONTROL_MAX_ATTEMPTS:
479
+ dead += 1
480
+ continue
481
+ q._requeue_failed(src, attempts)
482
+ requeued += 1
483
+ st = q.status()
484
+ audit_ok = False
485
+ a = getattr(cg, "_audit", None)
486
+ if a is not None:
487
+ try:
488
+ a("coldverify_drain", "", dry_run=False, limit=lim,
489
+ processed=st["stats"].get("processed"), errors=len(errs),
490
+ requeued=requeued, dead_letter=dead,
491
+ queue_size=st["queue_size"], oldest_age_s=st.get("oldest_age_s"))
492
+ audit_ok = True
493
+ except Exception: # noqa: BLE001
494
+ audit_ok = False # 审计失败不阻断消费(best-effort,同 G8)
495
+ return {"ok": True, "dry_run": False, "limit": lim,
496
+ "processed": len(results) - len(errs),
497
+ "errors": errs, "skipped": st["stats"].get("skipped"),
498
+ "requeued": requeued, "dead_letter": dead,
499
+ "results": results, "queue_size": st["queue_size"],
500
+ "oldest_age_s": st.get("oldest_age_s"),
501
+ "worker_alive": st.get("worker_alive"), "audit": audit_ok}
502
+
503
+
504
+ #: 进程级默认实例
505
+ _DEFAULT = None
506
+
507
+
508
+ def default_queue(root=None):
509
+ """进程级默认冷路径队列单例。"""
510
+ global _DEFAULT
511
+ if _DEFAULT is None:
512
+ _DEFAULT = ColdVerifyQueue(root=root)
513
+ return _DEFAULT
514
+
515
+
516
+ def attach(cg):
517
+ """给 cg 实例挂冷路径队列(幂等)。"""
518
+ if not hasattr(cg, "_coldverify") or cg._coldverify is None:
519
+ cg._coldverify = ColdVerifyQueue(root=cg.root)
520
+ return cg._coldverify
521
+
522
+
523
+ def get(cg):
524
+ """取 cg 实例的冷路径队列(未挂返回 None)。"""
525
+ return getattr(cg, "_coldverify", None)
526
+
527
+
528
+ def enqueue(cg, node_id: str, action: str = "reverify", **kw):
529
+ """快捷入口:挂队列 + 入队。"""
530
+ q = attach(cg)
531
+ return q.enqueue(node_id, action, **kw)