@furongjun1999/dsh-memory 0.8.1 → 0.9.7

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