@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
@@ -0,0 +1,204 @@
1
+ """Exact-superset candidates for RRF word matching, opt in with MDCG_RRF_CANDIDATES=1.
2
+
3
+ The instance-local index uses the production read cache's path generations.
4
+ It is built lazily, updates changed paths, and is never written to disk.
5
+ Only lexical/fuzzy/goal inputs are narrowed, after the existing visibility and
6
+ retrieval gates. Semantic, temporal and graph paths keep their own candidates.
7
+ Metadata enumeration remains linear. A broad invalidation/reload rebuilds the
8
+ index; external file edits have the same boundary as the production read cache.
9
+ """
10
+ from __future__ import annotations
11
+
12
+ import os
13
+ import sys
14
+ import time
15
+
16
+
17
+ def enabled():
18
+ return os.environ.get("MDCG_RRF_CANDIDATES") == "1"
19
+
20
+
21
+ def tokens(text):
22
+ """Raw characters and adjacent pairs, including whitespace and Unicode."""
23
+ return set(text) | {text[i:i + 2] for i in range(len(text) - 1)}
24
+
25
+
26
+ def term_tokens(term):
27
+ return {term} if len(term) == 1 else {
28
+ term[i:i + 2] for i in range(len(term) - 1)}
29
+
30
+
31
+ class CandidateIndex:
32
+ def __init__(self):
33
+ self.nodes = None
34
+ self.dirty = None
35
+ self.broad_gen = -1
36
+ self.docs = {}
37
+ self.post = {}
38
+ self.semantic = set()
39
+ self.initialized = False
40
+ self.last_sync = None
41
+
42
+ def clear(self):
43
+ self.docs.clear()
44
+ self.semantic.clear()
45
+ self.post.clear()
46
+ self.nodes = None
47
+ self.dirty = None
48
+ self.broad_gen = -1
49
+ self.initialized = False
50
+ self.last_sync = None
51
+
52
+ def remove(self, path):
53
+ old = self.docs.pop(path, None)
54
+ self.semantic.discard(path)
55
+ if old is None:
56
+ return
57
+ for word in old[1]:
58
+ paths = self.post[word]
59
+ paths.discard(path)
60
+ if not paths:
61
+ del self.post[word]
62
+
63
+ def sync(self, cg, entries, report):
64
+ dirty = cg._dirty
65
+ nodes = cg.index["nodes"]
66
+ last = self.last_sync
67
+ if (last is not None and last[0] is report
68
+ and last[1:] == (id(entries), dirty.write_gen)
69
+ and self.nodes is nodes and self.dirty is dirty):
70
+ return # The same query's lexical/fuzzy/goal paths share a pool.
71
+ if (self.nodes is not nodes or self.dirty is not dirty
72
+ or dirty.broad_gen > self.broad_gen):
73
+ self.clear()
74
+ self.nodes, self.dirty = nodes, dirty
75
+ self.broad_gen = dirty.broad_gen
76
+ first = not self.initialized
77
+ started = time.perf_counter()
78
+ cached_nodes = 0
79
+ for entry in entries:
80
+ path = entry["path"]
81
+ old = self.docs.get(path)
82
+ if old is not None and dirty.path_gen.get(path, 0) <= old[0]:
83
+ cached_nodes += 1
84
+ continue
85
+ self.remove(path)
86
+ report["build_reads" if first else "update_reads"] += 1
87
+ fm, content, failure = cg._read_status(entry)
88
+ if failure is not None or content is None:
89
+ # Never freeze transient failures or failed decryption into a
90
+ # negative candidate cache. Retry on the next query.
91
+ continue
92
+ content = cg._open_content(fm.get("id"), fm, content)
93
+ if content is None:
94
+ continue
95
+ tags = " ".join(str(t) for t in (fm.get("tags") or []))
96
+ positive = cg._positive_body(entry, content)
97
+ # One superset table serves all three scoring paths. Interning
98
+ # repeated short grams avoids retaining duplicate Unicode objects
99
+ # for every node. Negative/case false positives are still checked
100
+ # by each path's unchanged exact scorer.
101
+ words = {sys.intern(g) for g in (
102
+ tokens(content + " " + tags) | tokens(positive + " " + tags)
103
+ | tokens(positive.lower() + " " + tags.lower()))}
104
+ for g in words:
105
+ self.post.setdefault(g, set()).add(path)
106
+ if fm.get("semantic"):
107
+ self.semantic.add(path)
108
+ self.docs[path] = (dirty.write_gen, words)
109
+ cached_nodes += 1
110
+ self.initialized = True
111
+ report["index_ms"] += (time.perf_counter() - started) * 1000
112
+ report["cached_nodes"] = cached_nodes
113
+ self.last_sync = (report, id(entries), dirty.write_gen)
114
+
115
+
116
+ def begin(cg):
117
+ cg._rrf_candidate_report = None
118
+ if not enabled():
119
+ return {}
120
+ report = {"paths": {}, "build_reads": 0, "update_reads": 0,
121
+ "index_ms": 0.0, "cached_nodes": 0}
122
+ cg._rrf_candidate_report = report
123
+ return {"rrf_candidates": report}
124
+
125
+
126
+ def narrow(cg, entries, terms, mode, query=""):
127
+ if not enabled():
128
+ return entries
129
+ report = getattr(cg, "_rrf_candidate_report", None)
130
+ if report is None:
131
+ return entries # Private direct calls retain their original behavior.
132
+ detail = {"input": len(entries), "output": len(entries)}
133
+ report["paths"][mode] = detail
134
+ if mode == "lexical" and any(not str(term) for term in terms):
135
+ # expand_query_terms can yield [''] for punctuation/emoji-only input.
136
+ # Existing LIKE treats the empty substring as matching every document;
137
+ # its relevance cap differs from the importance fallback cap.
138
+ detail["fallback"] = "empty_term_matches_all"
139
+ return entries
140
+ dirty = getattr(cg, "_dirty", None)
141
+ if (not hasattr(cg, "_read_cache") or not hasattr(dirty, "path_gen")
142
+ or not hasattr(dirty, "broad_gen")):
143
+ detail["fallback"] = "read_cache_unavailable"
144
+ return entries
145
+ idx = getattr(cg, "_rrf_candidate_index", None)
146
+ if idx is None:
147
+ idx = cg._rrf_candidate_index = CandidateIndex()
148
+ try:
149
+ words = {word for term in terms for word in term_tokens(
150
+ str(term).lower() if mode == "lexical" else str(term))}
151
+ threshold = len(entries) * 0.75
152
+ # A fresh high-frequency posting is a selectivity hint, never a
153
+ # pruning decision. Choosing the original full pool is safe even if
154
+ # some posting members are outside this query's visibility/gates.
155
+ # Avoid the linear sync and set unions when they cannot pay off.
156
+ if (idx.initialized and idx.nodes is cg.index["nodes"]
157
+ and idx.dirty is dirty and idx.last_sync is not None
158
+ and idx.last_sync[2] == dirty.write_gen
159
+ and idx.broad_gen == dirty.broad_gen
160
+ and any(len(idx.post.get(word, ())) >= threshold for word in words)):
161
+ detail.update(fallback="broad_candidates", early_bypass=True)
162
+ return entries
163
+ idx.sync(cg, entries, report)
164
+ table = idx.post
165
+ found = set()
166
+ for word in words:
167
+ posting = table.get(word, ())
168
+ if len(posting) >= threshold:
169
+ detail["fallback"] = "broad_candidates"
170
+ return entries
171
+ found.update(posting)
172
+ if len(found) >= threshold:
173
+ detail["fallback"] = "broad_candidates"
174
+ return entries
175
+ if len(found) >= threshold:
176
+ detail["fallback"] = "broad_candidates"
177
+ return entries
178
+ if mode == "lexical":
179
+ from .mdcg import index_key_hits, semantic_on
180
+ if semantic_on():
181
+ found.update(idx.semantic)
182
+ # Six-element postcondition/rejection keys are metadata, and can
183
+ # recall a node with no matching body. Keep that route intact.
184
+ selected = [e for e in entries if e["path"] in found
185
+ or e["path"] not in idx.docs
186
+ or index_key_hits(e, terms, query).get("hit")]
187
+ else:
188
+ selected = [e for e in entries if e["path"] in found
189
+ or e["path"] not in idx.docs]
190
+ except Exception as exc:
191
+ # A broken derived index must not change retrieval or block a read.
192
+ idx.clear()
193
+ detail["fallback"] = "index_error"
194
+ detail["error_type"] = type(exc).__name__
195
+ return entries
196
+ detail["output"] = len(selected)
197
+ return selected
198
+
199
+
200
+ def lexical_fallback(cg, size):
201
+ report = getattr(cg, "_rrf_candidate_report", None)
202
+ if report is not None and "lexical" in report["paths"]:
203
+ report["paths"]["lexical"].update(
204
+ fallback="no_like_hit", output=size)
@@ -61,6 +61,24 @@ _LOG_DIR = os.environ.get("MDCG_TESTLOG_DIR") or os.path.join(
61
61
  tempfile.gettempdir(), "md_cg_testlogs")
62
62
 
63
63
 
64
+ #: 会话类 env 剔除名单(issue #196 / #198,2026-10-13)。宿主/部署侧注入会话 id 时,
65
+ #: md_cg/stg.py::_view_session 的 env 权威分支会把守卫夹具声明的会话改写成 env 值,
66
+ #: 同一守卫在「有 env 的开发机」上红、在干净 CI 上绿,属假红。上游 scripts/run_tests.py
67
+ #: 已有同口径剔除(同名单同日期),而 README 指定的包内入口 python -m md_cg.run_tests
68
+ #: 跑同一批守卫——本文件补同口径,避免两条入口对同一守卫给出相反结论。
69
+ #: env 权威本身是 issue #128 的刻意设计,本条不改变产品行为,只在测试环境剔除。
70
+ _SESSION_ENV_STRIP = ("MDCG_SESSION", "DSH_SESSION_ID", "DSH_SESSION")
71
+ _STRIP_UPPER = frozenset(_k.upper() for _k in _SESSION_ENV_STRIP)
72
+
73
+
74
+ def _test_env() -> dict:
75
+ """子进程环境:UTF-8 自保证 + 剔除宿主会话变量(不修改 os.environ 本身)。"""
76
+ env = dict(os.environ, PYTHONUTF8="1", PYTHONIOENCODING="utf-8")
77
+ for _k in [k for k in env if k.upper() in _STRIP_UPPER]:
78
+ env.pop(_k, None)
79
+ return env
80
+
81
+
64
82
  def _discover():
65
83
  """返回 [(组名, 显示名, argv 候选列表)];argv 依次尝试直到成功启动。"""
66
84
  out = []
@@ -95,7 +113,7 @@ def _discover():
95
113
  def _run_one(name, argvs, timeout):
96
114
  """跑一个用例;输出**重定向到文件**(不用管道——沙箱禁 CreatePipe)。"""
97
115
  os.makedirs(_LOG_DIR, exist_ok=True)
98
- env = dict(os.environ, PYTHONUTF8="1", PYTHONIOENCODING="utf-8")
116
+ env = _test_env()
99
117
  last = ""
100
118
  for argv in argvs: # -m 优先;No module named 时回退直跑
101
119
  log = os.path.join(_LOG_DIR, name.replace(".", "_") + ".log")
package/md_cg/scrub.py CHANGED
@@ -10,6 +10,24 @@
10
10
  会形成确认偏差,永远发现不了「看起来没问题其实有问题」的记忆。
11
11
  `seed` 固定 → 同 seed 同样本(可复现、可审计,对齐本仓确定性白箱取向)。
12
12
 
13
+ **issue #66 的两条口径(2026-10-09 DSH 端落文档,zcode 端裁定「一甲二乙」)**:
14
+
15
+ * **seed(子项二·乙:可注入、默认仍 0)**:sample() 的 seed 本就是可注入参数
16
+ (sample(..., seed=None),:280 seed = 0 if seed is None else seed)——**不传即 0**,
17
+ 与既有读数逐字一致;显式传入才轮换。故「抽样面不轮换」不是缺陷,而是**默认取向**:
18
+ 可复现、可审计对齐确定性白箱。_pick 另有已核实结论(:252-255):层内候选 <= k 时**全量抽取**,
19
+ 单节点分层每轮必中属**有意设计**(该层全部人口=全量覆盖);**seed 轮转只让大池层换人**,
20
+ 小分层恒中占少数名额,且账本上可由 already_handled 如实读出。
21
+ * **幂等账本(子项一·甲:维持现口径)**:_handled **只认 SCRUB_LOG 里 op=="decontaminate"
22
+ 且 ok 为真的「改过的单条记录」**——批量汇总只是**读数**,不是处置凭证。
23
+ 这是把「审计即状态」收窄成「**实际改动才是状态**」,属**刻意口径**,不是漏配:
24
+ 跑过一轮但没动的条目**下轮仍会报**,那是设计意图(持续观察),不是重复劳动。
25
+ ⇒ 使用者若期望「跑过就不再报」,应改看 already_handled 读数,而非期望幂等名单增长。
26
+
27
+ **issue #67(2026-10-09 DSH 端)**:_pick 的 3k 截断**只对有序池成立**;对照组
28
+ (random 池,_pool_candidates 唯一不排序者)此前同样被截断 ⇒「随机基线」退化成
29
+ 「索引前 3k 名」。现由 ordered 形参区分:风险层截断不变,对照组取全池。
30
+
13
31
  ② **联想(associate)**
14
32
  从抽样节点出发三路邻域合并:
15
33
  关系链(`chain.walk`,带条件序列)· 子图层级(`subgraph.expand`)
@@ -41,6 +59,7 @@
41
59
  """
42
60
  from __future__ import annotations
43
61
 
62
+ import hashlib
44
63
  import os
45
64
  import random
46
65
  import time
@@ -75,7 +94,13 @@ CONTAMINATION = {
75
94
  # 故 severity=info、处置仅 hint(不 weaken / 不 demote / 不删)。
76
95
  "not_yet": ("info", ("hint",)),
77
96
  "duplicate": ("medium", ("hint",)),
78
- "orphan_noise": ("low", ("weaken", "demote")),
97
+ # #524:`demote` 在此规则下**不可达** —— 产出条件要求 `layer == "contextual"`(见下方 audit 的
98
+ # orphan_noise 分支),而 demote 的执行条件是 `layer != "contextual"`(见 decontaminate 的
99
+ # 降级分支)⇒ 两者互斥 ⇒ 该动作永不执行。故删声明;**行为不变**(本来就不执行)。
100
+ # 三段证明:① `audit(min_severity="info")` ⇒ `n_issues=1`(issue 能造出)
101
+ # ② `decontaminate` ⇒ `action="applied"` 而 `done=["weaken"]`(demote 未执行)
102
+ # ③ `audit.issues[0].fix=["weaken","demote"]` 而 `done` 不含 demote(声明 vs 实际)
103
+ "orphan_noise": ("low", ("weaken",)),
79
104
  "unverified": ("info", ("hint",)),
80
105
  }
81
106
  SEVERITY_ORDER = {"high": 3, "medium": 2, "low": 1, "info": 0}
@@ -145,6 +170,37 @@ def _log(cg, op: str, **rec) -> dict:
145
170
  return rec
146
171
 
147
172
 
173
+ #: 处置动作的**失败标记**(写侧 `done` 列表里的实际字面串,**单点**)。
174
+ #: 判据按实际字符串定,不用通配占位——新增动作若引入新的失败形态,必须回到这里登记。
175
+ #: 三态来源(`decontaminate` 的实修段):
176
+ #: `weaken_failed:<Type>` —— `_weaken` → `cg.verify` 抛异常(越权 / 保护 / 冲突)
177
+ #: `demote_failed:<Type>` —— `cg._move_layer` 抛异常(保护闸 / 层闸)
178
+ #: `demote_state:<error>` —— 层降级成功但生命周期状态推进失败(负路由,不抛)
179
+ #: 第三条不以 `_failed:` 结尾,故**不能用 `*_failed:` 通配**——只认前缀会把它漏成「成功」。
180
+ #: **为什么是显式三项而不是通配**:四项 `done.append` 落点已逐一枚举(成功两项
181
+ #: "weaken"/"demote" + 失败三项),三项就是已知的**全部**失败形态;换成通配(如
182
+ #: 匹配任意 `*failed*` 或 `state:`)会把**语义无关的合法动作名**也判成失败——那是
183
+ #: **过度收紧方向**(合法成功处置被误判 ⇒ 幂等名单永不记账 ⇒ 每轮重复处置)。
184
+ #: 新增动作必须回来登记:这是「枚举完备性」而不是「模式匹配」的取舍。
185
+ ACTION_FAIL_MARKS = ("weaken_failed:", "demote_failed:", "demote_state:")
186
+
187
+
188
+ # 生效条件:actions 为可迭代(None/空按无动作计)时,任一动作的字符串形式以 ACTION_FAIL_MARKS 之一开头即返回 False,否则返回 True;不抛(非字符串项先 str());
189
+ def _actions_ok(actions) -> bool:
190
+ """本批处置动作是否**全部成功**(issue #411,**唯一判据单点**)。
191
+
192
+ 为什么必须抽成单点:改前写侧无条件写 `ok=True`(`_log(cg, "decontaminate",
193
+ …, ok=True, …)`),而读侧 `_handled` 只认 `op=="decontaminate" and ok`——
194
+ 失败只以字符串留在 `actions` 里,于是**无权身份跑一次就能把 (节点, 污染类型)
195
+ 永久钉成「已处置」**,污染此后**永久不再被处置**(幂等名单被失败污染)。
196
+
197
+ 这里只做「动作结果 → 布尔」这一件事;写侧把该布尔写进 `ok`,读侧(`_handled`
198
+ / `summary`)照旧**只读 `ok`**——**收成单点**,读侧不另写第二份判据。
199
+ """
200
+ return not any(str(a).startswith(ACTION_FAIL_MARKS)
201
+ for a in (actions or ()))
202
+
203
+
148
204
  # 生效条件:仅当 read_jsonl(cg.root 下 SCRUB_LOG) 的记录 op=="decontaminate" 且 ok 为真时,把 (rec.get("node_id"), rec.get("kind")) 收进返回集合;无此类记录返回空集。
149
205
  def _handled(cg) -> set:
150
206
  """已处置过的 (node_id, kind):保证去污染幂等(审计即状态)。"""
@@ -245,13 +301,25 @@ def _quota(n: int, strategy: str) -> dict:
245
301
  return out
246
302
 
247
303
 
248
- # 生效条件:k<=0 或 pool 为假值(空池)时返回 [],否则取池前 k*3 项后用 random.Random(f"{seed}:{stratum}") 稳定洗牌并返回前 k 项(池长不足 k*3 时对全池洗牌)。
249
- def _pick(pool, k: int, seed, stratum: str):
250
- """从池中取 k 个:风险最高的 3k 个入池,再按 seed 稳定洗牌。"""
304
+ # 生效条件:k<=0 或 pool 为假值(空池)时返回 [];否则 ordered 为真时先取池前 k*3 项(风险优先窗口),ordered 为假时**不截断**(无序池=对照组 random,见 issue #67),随后一律用 random.Random(f"{seed}:{stratum}") 稳定洗牌并返回前 k 项(池长不足窗口时对全池洗牌)。
305
+ def _pick(pool, k: int, seed, stratum: str, *, ordered: bool = True):
306
+ """从池中取 k 个:风险最高的 3k 个入池,再按 seed 稳定洗牌。
307
+
308
+ 层内候选 ≤ k 时**全量抽取**——单节点分层(如 low_conf 全库 1 个)
309
+ 因此每轮必中:这是**有意设计**(该层全部人口 = 全量覆盖,风险优先
310
+ 持续观察),不是漏配轮转。issue #66 核实:seed 轮转只让大池层换人,
311
+ 小分层恒中占少数名额、且账本上可由 `already_handled` 如实读出。
312
+
313
+ issue #67(2026-10-09 DSH 端):**对照组(random 池)不得截断**。_pool_candidates
314
+ 只对六个风险层排序(stale/hot/unverified/orphan/disputed/low_conf),random 池
315
+ 是**唯一不排序**的池;对它取 [:k*3] 等于把「随机基线」变成「索引前 3k 名」——
316
+ 对照面既非随机、又恒看不到后段人口,抽样结论无从代表全库。故 ordered=False。
317
+ 风险层保持截断**不变**:那是「风险优先窗口」的有意设计,不属本 issue 面。
318
+ """
251
319
  if k <= 0 or not pool:
252
320
  return []
253
321
  cand = list(pool)
254
- if len(cand) > k * 3:
322
+ if ordered and len(cand) > k * 3:
255
323
  cand = cand[:k * 3]
256
324
  random.Random(f"{seed}:{stratum}").shuffle(cand)
257
325
  return cand[:k]
@@ -278,7 +346,8 @@ def sample(cg, n: int = DEFAULT_SAMPLE, *, strategy: str = "stratified",
278
346
  quota = _quota(n, strategy)
279
347
  picked, seen = [], set()
280
348
  for s in STRATA:
281
- for nid, reason in _pick(pools.get(s), quota.get(s, 0), seed, s):
349
+ for nid, reason in _pick(pools.get(s), quota.get(s, 0), seed, s,
350
+ ordered=(s != "random")):
282
351
  if nid in seen:
283
352
  continue
284
353
  seen.add(nid)
@@ -287,7 +356,7 @@ def sample(cg, n: int = DEFAULT_SAMPLE, *, strategy: str = "stratified",
287
356
  if len(picked) < int(n):
288
357
  rest = [x for x in pools["random"] if x[0] not in seen]
289
358
  for nid, reason in _pick(rest, int(n) - len(picked), seed,
290
- "random-fill"):
359
+ "random-fill", ordered=False):
291
360
  seen.add(nid)
292
361
  picked.append({"node_id": nid, "stratum": "random",
293
362
  "reason": reason})
@@ -498,9 +567,22 @@ def _not_yet(fm, now):
498
567
  return None
499
568
 
500
569
 
501
- # 生效条件:对 content 取 kv_pairs、bigrams 和 polarity,遍历 related(若 related 为假值则视为空)的前 int(max_compare) 个 r,以 r["node_id"] 调 cg.get;若某 oid 节点可读非空,先在其 content 与 content 的共同键中找到值不同者并返回 {'with':oid,'via':r.get('via'),'why':'同键不同值:...'};否则若极性乘积 <0 且双方 bigram 非空,且共享 bigram 数 >=3 且 ratio>=0.15,返回 {'with':oid,'via':r.get('via'),'why':'极性相反且共享内容:...'};全部遍历完无命中则返回 None;
570
+ # 生效条件:对 content 取 kv_pairs、bigrams 和 polarity,遍历 related(若 related 为假值则视为空)的前 int(max_compare) 个 r,以 r["node_id"] 调 cg.get;【#444】返回的 why **只含键名 + 不可逆摘要(同键不同值)/ 计数与占比(极性相反)**,两端正文原值与共享词面一律不进串(该串会经 verify 落进 fm 与 _trust.jsonl 等明文面);若某 oid 节点可读非空,先在其 content 与 content 的共同键中找到值不同者并返回 {'with':oid,'via':r.get('via'),'why':'同键不同值:...'};否则若极性乘积 <0 且双方 bigram 非空,且共享 bigram 数 >=3 且 ratio>=0.15,返回 {'with':oid,'via':r.get('via'),'why':'极性相反且共享内容:...'};全部遍历完无命中则返回 None;
502
571
  def _contradiction(cg, content, related, max_compare=10):
503
- """与同族节点比对:同键不同值 / 极性相反且共享 bigram。"""
572
+ """与同族节点比对:同键不同值 / 极性相反且共享 bigram。
573
+
574
+ issue #444(P0 密级泄漏,2026-10-17 U05c):本函数产出的 `why` 会经
575
+ `add("contradiction", why)` → `_weaken` → `cg.verify(..., "weakened")` 写成
576
+ verify 的 **evidence**,进而落进 (a) 节点 frontmatter、(b) 对端节点自己的 .md、
577
+ (c) `_trust.jsonl` —— 三处**都是明文面**(加密只作用于正文,不作用于 fm 字段)。
578
+ 修前 `why` 里是**两端正文原值**(同键不同值)或**共享 bigram 词面**(极性相反),
579
+ 于是 private 正文被搬进低密级节点的明文面,`internal` 身份经 `mdcg_get` 即可读到。
580
+ 现口径:**正文原值与词面一律不进证据串**——只留键名 + 不可逆摘要(8 位)/ 计数。
581
+ """
582
+ def _h(v):
583
+ """证据串用的**不可逆**摘要——正文原值不得进证据串(#444)。"""
584
+ return hashlib.sha1(str(v).encode("utf-8")).hexdigest()[:8]
585
+
504
586
  kv_a = _kv_pairs(content)
505
587
  bg_a, pol_a = bigrams(content or ""), _polarity(content)
506
588
  for r in (related or [])[:int(max_compare)]:
@@ -516,15 +598,17 @@ def _contradiction(cg, content, related, max_compare=10):
516
598
  for k in sorted(set(kv_a) & set(kv_b)):
517
599
  if kv_a[k] != kv_b[k]:
518
600
  return {"with": oid, "via": r.get("via"),
519
- "why": f"同键不同值:{k}={kv_a[k]} vs {kv_b[k]}"}
601
+ "why": f"同键不同值:{k}(本端 {_h(kv_a[k])} / "
602
+ f"对端 {_h(kv_b[k])})"}
520
603
  bg_b = bigrams(oc)
521
604
  if pol_a * _polarity(oc) < 0 and bg_a and bg_b:
522
605
  shared = bg_a & bg_b
523
606
  ratio = len(shared) / max(1, min(len(bg_a), len(bg_b)))
524
607
  if len(shared) >= 3 and ratio >= 0.15:
608
+ # 同 #444:共享 bigram **词面也是正文片段**,同属泄漏面 ⇒ 只留计数与占比。
525
609
  return {"with": oid, "via": r.get("via"),
526
- "why": "极性相反且共享内容:" + "、".join(
527
- sorted(shared)[:5])}
610
+ "why": f"极性相反且共享内容:共享片段 {len(shared)} 个"
611
+ f"(占比 {ratio:.2f}),词面不入证据串"}
528
612
  return None
529
613
 
530
614
 
@@ -532,7 +616,15 @@ def _contradiction(cg, content, related, max_compare=10):
532
616
  def audit(cg, node_ids=None, *, hops: int = 1, min_severity: str = "info",
533
617
  limit=None, unverified_days: float = UNVERIFIED_DAYS,
534
618
  lexical: bool = True, min_sim: float = 0.15) -> dict:
535
- """对指定节点(默认全库)做污染体检。**只读**,不改动任何节点。"""
619
+ """对指定节点(默认全库)做污染体检。**只读**,不改动任何节点。
620
+
621
+ `min_severity` 是**含等号**的档位门限(`>=`):`SEVERITY_ORDER` 为
622
+ {"high":3, "medium":2, "low":1, "info":0},只要某条 issue 的档位
623
+ **不低于** `min_severity` 就纳入返回。故 `min_severity="low"` **会**保留
624
+ `low` 级 issue(`1 < 1` 为假 ⇒ 不跳过);`"medium"` 及以上则滤掉 `low`。
625
+ 缺键按 0 计(等于把未知档位当 info)。实测:同一低重要情境噪音节点在
626
+ `info`/`low` 下都返回 1 条、`medium`/`high` 下返回 0 条。
627
+ """
536
628
  nodes = _nodes(cg)
537
629
  ids = list(nodes.keys()) if node_ids is None else (
538
630
  [node_ids] if isinstance(node_ids, str) else list(node_ids))
@@ -622,7 +714,7 @@ def audit(cg, node_ids=None, *, hops: int = 1, min_severity: str = "info",
622
714
  "t": now}
623
715
 
624
716
 
625
- # 生效条件:循环 max(1, int(times)) 次调用 cg.verify(nid, "scrub:"+kind+":"+str(detail)[:120], "weakened"),返回最后一次调用结果(times≤0 时按 1 次执行)。
717
+ # 生效条件:循环 max(1, int(times)) 次调用 cg.verify(nid, "scrub:"+kind+":"+str(detail)[:120], "weakened"),返回最后一次调用结果(times≤0 时按 1 次执行);【#444】detail 会进 verify 的 evidence(→ fm 明文面 / _trust.jsonl / 对端节点 .md),故**调用方传入的 detail 不得含正文原值**——contradiction 支已改为摘要,其它支传的是键名/日期类短值。
626
718
  def _weaken(cg, nid, kind, detail, times=1):
627
719
  res = None
628
720
  for _ in range(max(1, int(times))):
@@ -639,11 +731,18 @@ def decontaminate(cg, node_ids=None, *, kinds=None, dry_run: bool = True,
639
731
 
640
732
  动作:`weaken`(verify weakened → 反例+1、置信-0.15、跌破 0.2 自动降级)、
641
733
  `demote`(降级到情境层)、`hint`(只建议,不改)。保护节点跳过;永不删除。
734
+
735
+ 读数口径(issue #66):`already_handled` = 命中幂等名单(此前已处置过,
736
+ 旧键 `skipped_done` 即此含义——不是「检查并跳过」);`planned_dry_run`
737
+ = 本轮检查到、但本轮无任何处置动作(dry_run 登记计划未执行;实修恒 0);
738
+ 两者与 `applied` / `skipped_protected` / `hints` 构成逐条去向的互斥分类
739
+ (`checked_breakdown`,仅读数,不回喂 `_handled`)。
642
740
  """
643
741
  rep = audit(cg, node_ids, hops=hops, min_severity=min_severity)
644
742
  handled = _handled(cg)
645
743
  actions = []
646
- n_applied = n_prot = n_done = n_hint = 0
744
+ n_applied = n_prot = n_done = n_hint = n_planned = 0
745
+ n_failed = 0 # #411:本轮动作**未全成功**的条数(写进批次 ok)
647
746
 
648
747
  for issue in rep["issues"]:
649
748
  nid, kind = issue["node_id"], issue["kind"]
@@ -672,6 +771,7 @@ def decontaminate(cg, node_ids=None, *, kinds=None, dry_run: bool = True,
672
771
  "applied": False})
673
772
  continue
674
773
  if dry_run:
774
+ n_planned += 1
675
775
  actions.append({"node_id": nid, "kind": kind,
676
776
  "action": "planned",
677
777
  "planned": list(CONTAMINATION[kind][1]),
@@ -688,7 +788,9 @@ def decontaminate(cg, node_ids=None, *, kinds=None, dry_run: bool = True,
688
788
  try:
689
789
  fm = _fm_of(cg, nid, None)
690
790
  if str(fm.get("layer") or "") != "contextual":
691
- cg._move_layer(nid, "contextual", reason=f"scrub:{kind}")
791
+ # issue #469:override 必须下传(修前此处丢弃 ⇒ 受保护节点静默失败)
792
+ cg._move_layer(nid, "contextual", reason=f"scrub:{kind}",
793
+ override=override)
692
794
  # 层降级 = 生命周期降级(②):状态同批推进(负路由,失败不抛)
693
795
  _st = cg.set_state(nid, "demoted", reason=f"scrub:{kind}",
694
796
  actor=actor or "scrub")
@@ -697,19 +799,50 @@ def decontaminate(cg, node_ids=None, *, kinds=None, dry_run: bool = True,
697
799
  except Exception as exc: # noqa: BLE001
698
800
  done.append(f"demote_failed:{type(exc).__name__}")
699
801
  n_applied += 1
700
- _log(cg, "decontaminate", node_id=nid, kind=kind, ok=True,
802
+ _ok = _actions_ok(done) # #411:失败不得写成「已处置」
803
+ if not _ok:
804
+ n_failed += 1
805
+ _log(cg, "decontaminate", node_id=nid, kind=kind, ok=_ok,
701
806
  actions=done, severity=issue["severity"], actor=actor)
702
807
  actions.append({"node_id": nid, "kind": kind, "action": "applied",
703
808
  "done": done, "detail": issue["detail"],
704
809
  "applied": True})
705
810
 
811
+ # 覆盖账(issue #66):逐条去向的**互斥分类**(五键之和 = 本轮处置循环的
812
+ # issue 条数,kinds 过滤者除外),**只用于读数**——不回喂 `_handled`
813
+ # (幂等账本仍只认「改过」的单条记录,读法见 `_handled`)。
814
+ # applied 本轮实际执行了处置动作(weaken/demote)
815
+ # already_handled 命中幂等名单(此前已处置过)→「旧面孔」。
816
+ # 旧键 `skipped_done` 的**实际含义就是它**——不是「检查
817
+ # 过并跳过」,正名于此(旧键保留兼容,值恒等)。
818
+ # planned_dry_run = dry_run 下**本会处置、因 dry_run 未遂**(**≠「无需处置」**;
819
+ # 「无需处置」由 hint 一格承载)(原写「无任何处置动作」易误读,
820
+ # 计划未执行)→「本轮检查面」。实修恒 0:检查出的可
821
+ # 处置问题都会动手。它与 `already_handled` 语义相反:
822
+ # 一个数「本轮新检查」,一个数「此前已处置(幂等存量)」。
823
+ # protected 受保护跳过(`protect.is_protected` 拦下)
824
+ # hint 声明只给建议(duplicate/unverified/not_yet,不动手)
825
+ breakdown = {"applied": n_applied, "already_handled": n_done,
826
+ "planned_dry_run": n_planned, "protected": n_prot,
827
+ "hint": n_hint}
706
828
  if not dry_run:
707
- _log(cg, "decontaminate_batch", ok=True, applied=n_applied,
829
+ # #411:批次 ok 同样必须是**真实结果**(任一子条失败即 False),
830
+ # 否则 `summary` 的 batches/decontaminated 会把失败批次算成成功轮。
831
+ _log(cg, "decontaminate_batch", ok=(n_failed == 0), applied=n_applied,
832
+ failed_actions=n_failed,
833
+ # 覆盖账(issue #66):分类明细只读数不回喂 `_handled`;
834
+ # `already_handled` 为 `skipped_done` 的正名(二者恒等)。
835
+ already_handled=n_done, planned_dry_run=n_planned,
708
836
  skipped_protected=n_prot, skipped_done=n_done, hints=n_hint,
709
- actor=actor)
837
+ checked_breakdown=breakdown, actor=actor)
710
838
  return {"ok": True, "dry_run": dry_run, "n_issues": rep["n_issues"],
711
839
  "applied": n_applied, "skipped_protected": n_prot,
712
- "skipped_done": n_done, "hints": n_hint, "actions": actions,
840
+ # 正名(issue #66):`skipped_done` = 命中幂等名单,**非「检查并跳过」**;
841
+ # 兼容键保留(值恒等),新读数请用 `already_handled`。
842
+ "already_handled": n_done, "skipped_done": n_done,
843
+ "planned_dry_run": n_planned,
844
+ "hints": n_hint, "failed_actions": n_failed, "actions": actions,
845
+ "checked_breakdown": breakdown,
713
846
  "audit": rep, "t": time.time()}
714
847
 
715
848
 
@@ -850,6 +983,12 @@ def sweep(cg, *, n: int = DEFAULT_SAMPLE, seed=None, dry_run: bool = True,
850
983
  "decontaminate": dec, "calibration": cal, "t": time.time()}
851
984
  _log(cg, "sweep", n_sample=smp["n"], n_issues=rep["n_issues"],
852
985
  n_high_medium=len(hi), applied=dec["applied"], dry_run=dry_run,
986
+ # 覆盖账(issue #66):轮级读数也带逐条去向分类——dry_run 轮是常驻
987
+ # 默认下**唯一的账**(批量记录仅在实修轮写),不带则「三个旧面孔 +
988
+ # 一个新问题」与「四个全新问题」在 last_sweep 读数上不可区分。
989
+ already_handled=dec["already_handled"],
990
+ planned_dry_run=dec["planned_dry_run"],
991
+ checked_breakdown=dec["checked_breakdown"],
853
992
  calibration=(cal.get("verdict") if cal.get("ok")
854
993
  else cal.get("reason")))
855
994
  return out
@@ -861,19 +1000,34 @@ def history(cg, limit: int = 100) -> dict:
861
1000
  return {"n": len(recs), "records": recs[-int(limit):]}
862
1001
 
863
1002
 
864
- # 生效条件:读取 cg.root 下 SCRUB_LOG 的 JSONL 记录,过滤 op=="sweep" 得 sweeps、op=="decontaminate" 且 ok 为真得 decs;last 为 sweeps 最后一项或 None;返回 {'sweeps':len(sweeps),'decontaminated':len(decs),'last_sweep':last 的 t/n_issues/n_high_medium/applied/dry_run/calibration 或 None};
1003
+ # 生效条件:读取 cg.root 下 SCRUB_LOG 的 JSONL 记录,过滤 op=="sweep" 得 sweeps、op=="decontaminate" 且 ok 为真得 decs、op=="decontaminate_batch" 且 ok 为真得 batches;last 为 sweeps 最后一项或 None;返回 {'sweeps':len(sweeps),'decontaminated':batches 的 applied 累计,'decontaminated_records':len(decs),'batches':len(batches),'last_sweep':last 的 t/n_issues/n_high_medium/applied/dry_run/already_handled/planned_dry_run/checked_breakdown/calibration 或 None};
865
1004
  def summary(cg) -> dict:
866
- """给 health_os / 自维持循环用的只读摘要。"""
1005
+ """给 health_os / 自维持循环用的只读摘要。
1006
+
1007
+ `decontaminated`(issue #66 口径修正)= 批量汇总记录的**累计 applied 之和**
1008
+ ——「实际处置量」;原口径(`op="decontaminate"` 单条记录条数)另留
1009
+ `decontaminated_records`,`batches` 为批量轮数——三键并置,信息不丢。
1010
+ """
867
1011
  recs = list(read_jsonl(os.path.join(cg.root, SCRUB_LOG)))
868
1012
  sweeps = [r for r in recs if r.get("op") == "sweep"]
869
1013
  decs = [r for r in recs if r.get("op") == "decontaminate" and r.get("ok")]
1014
+ batches = [r for r in recs if r.get("op") == "decontaminate_batch"
1015
+ and r.get("ok")]
870
1016
  last = sweeps[-1] if sweeps else None
871
- return {"sweeps": len(sweeps), "decontaminated": len(decs),
1017
+ return {"sweeps": len(sweeps),
1018
+ "decontaminated": sum(int(r.get("applied") or 0) for r in batches),
1019
+ "decontaminated_records": len(decs),
1020
+ "batches": len(batches),
872
1021
  "last_sweep": ({"t": last.get("t"),
873
1022
  "n_issues": last.get("n_issues"),
874
1023
  "n_high_medium": last.get("n_high_medium"),
875
1024
  "applied": last.get("applied"),
876
1025
  "dry_run": last.get("dry_run"),
1026
+ # 覆盖账(issue #66):轮读数可区分「旧面孔/新检查」;
1027
+ # 旧记录无此键 → None(向后兼容读数)。
1028
+ "already_handled": last.get("already_handled"),
1029
+ "planned_dry_run": last.get("planned_dry_run"),
1030
+ "checked_breakdown": last.get("checked_breakdown"),
877
1031
  "calibration": last.get("calibration")}
878
1032
  if last else None)}
879
1033