@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
package/md_cg/mdcg.py CHANGED
@@ -19,6 +19,8 @@ P0 风险(基线功能):
19
19
  import os
20
20
  import re
21
21
  import json
22
+ import sys
23
+ import math
22
24
  import time
23
25
  import atexit
24
26
  import weakref
@@ -28,9 +30,23 @@ import threading
28
30
 
29
31
  from . import (nodefile, protect, routing, subgraph, chain, provenance, pooling,
30
32
  lifecycle, reach, trust, roleviews, fsutil, freshness)
33
+ from . import timeanchor as _timeanchor
31
34
  from .fsutil import (FileLock, ShardedLog, atomic_write, append_jsonl,
32
35
  read_jsonl, sweep_stale_temps, note_bad_payload_rows)
33
36
 
37
+
38
+ # ---- issue #173(健壮性):形如 list(x or []) 的写法会把字符串静默拆成单字符 ----
39
+ # 单点守卫:写入 / 发出路径的 6 处调用点统一走 _ensure_list——str 按「一个值」
40
+ # 处理(不再逐字符展开);None / 空串按空列表(与改动前逐位一致);其余可迭代
41
+ # 仍 list(x)。
42
+ def _ensure_list(x):
43
+ """归一成列表:任何假值(None/空串/0/False/[])-> [];str -> [str];其它可迭代 -> list(x)。"""
44
+ if not x:
45
+ return []
46
+ if isinstance(x, str):
47
+ return [x]
48
+ return list(x)
49
+
34
50
  # 五层 + 两类负记忆 + 目标槽(白箱记忆七件套工程化:事实/规则→knowledge;
35
51
  # 假设→contextual;失败/未解→独立目录;目标→goals)。
36
52
  # 第 5 篇第 3 章:「没有目标,检索就没有方向」——goals 层不参与词法正排,
@@ -90,6 +106,50 @@ DEMOTE_CONFIDENCE = 0.2
90
106
  # 保证当前任务的连续性。只做 append + 截断,不参与词法正排(不稀释既有基线)。
91
107
  DEFAULT_RECENT_WINDOW = 200
92
108
 
109
+
110
+ def check_recent_event(role, text, window=DEFAULT_RECENT_WINDOW) -> None:
111
+ """近期事件写口入参闸(issue #166①):非法即抛 ValueError(fail-closed)。
112
+
113
+ 病象:`cg(op=recent, action=add)` 曾把数字/列表原样落盘;读侧
114
+ `crypto.is_encrypted(r.get("text"))` 对非 str 调 `.lstrip()` ⇒ info / recent /
115
+ health / recall(include_recent) 全线 AttributeError,且重启不自愈。
116
+ 形态与仓库既有「类型错 ⇒ 不静默降级」一致:写面抛异常(同族读面闸见
117
+ mcp_server 的 `node_id_not_str` 结构化 error 一族),不静默降级。
118
+ """
119
+ # issue #418:类型判据走单点 nodefile.valid_role(此前三处各写一遍
120
+ # isinstance,本处是其中之一)——判据语义逐位不变。
121
+ if role and not nodefile.valid_role(role):
122
+ raise ValueError("recent: role 须为字符串(收到 %s)" % type(role).__name__)
123
+ if text and not isinstance(text, str):
124
+ raise ValueError("recent: text 须为字符串(收到 %s)" % type(text).__name__)
125
+ if window is None:
126
+ return
127
+ if isinstance(window, bool) or not isinstance(window, int):
128
+ raise ValueError("recent: window 须为整数(收到 %s)"
129
+ % type(window).__name__)
130
+ if window < 1:
131
+ raise ValueError("recent: window 须 >= 1(收到 %s)" % (window,))
132
+
133
+
134
+ def recent_record_ok(r) -> bool:
135
+ """读侧容错判据(issue #166②):只放行 text 为 str、role 为空或 str 的行。
136
+
137
+ **读入处**过滤:一次坏写入不再让 info / recent / health /
138
+ recall(include_recent) 全线 AttributeError。为什么必须在这一层:
139
+ `mdcos.MdCGSecure.recent_events` 在 `super().recent_events(...)` 的结果上逐行
140
+ `r.get("meta")` / `crypto.is_encrypted(r.get("text"))`,坏行(含非 dict 行)会在
141
+ 那里炸穿读隔离层;先过滤 ⇒ 上层只拿到好行。role 允许缺失(存量/旁路写入的兼容
142
+ 面)——只拒「有值但非 str」(读侧 `set(roles)` 对不可哈希的 role 会 TypeError)。
143
+ """
144
+ if not isinstance(r, dict):
145
+ return False
146
+ if not isinstance(r.get("text"), str):
147
+ return False
148
+ # issue #418:读侧容错同源走单点(语义与 role is None or
149
+ # isinstance(role, str) 逐位相同)。
150
+ return nodefile.valid_role(r.get("role"))
151
+
152
+
93
153
  # 全量回退的读取上限,对齐 sqlite 版 `ORDER BY importance DESC, created_at DESC LIMIT 500`
94
154
  GLOBAL_CAP = 500
95
155
 
@@ -177,6 +237,9 @@ def cut_by_relevance(docs, scored, total, pools=None, key_of=None, stat=None):
177
237
  order = sorted(
178
238
  range(len(docs)),
179
239
  key=lambda i: (-float(scored[i][1]),
240
+ # issue #89①:分数封顶后同分不可分辨,精确命中作**次级键**
241
+ # (分数语义一字不动,只在并列时把整串命中提前)。
242
+ -int(scored[i][0].get(EXACT_HIT_KEY) or 0),
180
243
  -float(scored[i][0]["frontmatter"].get("importance") or 0),
181
244
  -float(scored[i][0]["frontmatter"].get("created_at") or 0),
182
245
  # 终键:三级全等时按 nid 定序。没有它,sorted 的**稳定性**
@@ -368,7 +431,11 @@ def expand_query_terms(query: str) -> list:
368
431
  for t in _en_zh:
369
432
  if t not in terms:
370
433
  terms.append(t)
371
- return list(dict.fromkeys(terms))
434
+ # issue #150(2026-10-11):**过滤空词项**——全标点/纯空白 query 经 normalize_en
435
+ # 归一后为 "",若不滤出,下游 `_like` 的 `t in body_l` 因 `"" in s` 恒真而使
436
+ # **LIKE 恒真**(实测 q="???" 命中全库 6/6)。同族四处一并过滤:
437
+ # `_like` / `tag_bonus` / 负覆盖(3965)/写入侧 `add()` 的 tags;Rust 侧同步。
438
+ return [t for t in dict.fromkeys(terms) if t and t.strip()]
372
439
 
373
440
 
374
441
  # 生效条件:当 `s` 为字符串时,先去掉空白字符;去空白后长度≤1 返回 `{s}`,否则返回所有相邻 2-gram 集合。
@@ -386,7 +453,7 @@ CN_STOP_GRAMS = {
386
453
  }
387
454
 
388
455
 
389
- # 生效条件:当 query 非空且环境变量 MDCG_CN_GRAMS 不为 "0" 时,对 query 中长度 ≥ max(min_run,2) 的连续中文串切 2-gram,去重且排除 CN_STOP_GRAMS,最多 cap 个返回;MDCG_CN_GRAMS=="0" 或 query 为假值时返回 [](cap<=0 仍会 append 后立即返回首个 gram)。
456
+ # 生效条件:当 query 非空且环境变量 MDCG_CN_GRAMS 不为 "0" 时,对 query 中长度 ≥ max(min_run,2) 的连续中文串切 2-gram,去重且排除 CN_STOP_GRAMS;cap 为 None 时**不限**(返回全部 gram),cap<=0 时逐位保留旧行为(append 后立即返回首个 gram——注意 cap=0 **不是**「不限」);否则各段 gram 总数 ≤ cap 时按段序拼接返回(与旧实现逐位相同),超过 cap 时**跨段轮转**取键(各段按比例进入召回面,长查询的末尾段不再恒为 0),最多返回 cap 个。
390
457
  def cn_recall_grams(query: str, min_run: int = 4, cap: int = 16) -> list:
391
458
  """构词法 v1 · 中文召回扩展:把连续中文串切成 2-gram 作为额外召回键。
392
459
 
@@ -396,18 +463,47 @@ def cn_recall_grams(query: str, min_run: int = 4, cap: int = 16) -> list:
396
463
 
397
464
  约束:只扩召回,不改打分口径(bigrams(q) 的 _score 不变);纯标准库,零依赖;
398
465
  仅当中文连续串 ≥ min_run 字时触发(短词本身已是召回词,无需扩展)。
466
+
467
+ #108(2026-10-10)· **预算分配**:旧实现对每段 gram 顺次 append,一旦
468
+ len(out) >= cap 就整函数返回 ⇒ 长查询(题卡式「两段以换行拼接」)只有
469
+ **开头段**进入召回键。实测 64 字 + 12 字两段查询:cap=16 时全查询 gram
470
+ 覆盖 0.218、**末段覆盖 0.000**;cap=32 仍 0.000;cap=64 为 0.159。现改为
471
+ 预算不足时**跨段轮转**(段内保序),使末段按比例进入召回面(同例 cap=16 时
472
+ 末段覆盖 0.727)。预算够时**逐位同旧**(短查询零差异)。cap=None 是「不限」的
473
+ 显式表示(返回全部 gram,覆盖率 1.000;代价是 LIKE 召回词数增多、候选面变大,
474
+ 由调用方/评测按需选用)。cap<=0 逐位保留旧行为(cap=0 不是「不限」)。
399
475
  """
400
476
  if os.environ.get("MDCG_CN_GRAMS") == "0": # A/B 开关:关闭即回退旧行为
401
477
  return []
402
- out = []
478
+ # 先按段收集(段内保序、跨段全局去重)——去重/停用词语义与旧实现逐位一致。
479
+ runs, seen = [], set()
403
480
  for run in re.findall(r"[\u4e00-\u9fff]{%d,}" % max(min_run, 2), query or ""):
481
+ grams = []
404
482
  for i in range(len(run) - 1):
405
483
  g = run[i:i + 2]
406
- if g in CN_STOP_GRAMS or g in out:
484
+ if g in CN_STOP_GRAMS or g in seen:
407
485
  continue
408
- out.append(g)
409
- if len(out) >= cap:
410
- return out
486
+ seen.add(g)
487
+ grams.append(g)
488
+ if grams:
489
+ runs.append(grams)
490
+ if cap is not None and cap <= 0: # 旧行为逐位保留(cap=0 不是「不限」)
491
+ return [runs[0][0]] if runs else []
492
+ total = sum(len(r) for r in runs)
493
+ if cap is None or total <= cap: # 预算够:段序拼接(与旧实现逐位相同)
494
+ return [g for r in runs for g in r]
495
+ out, depth = [], 0 # 预算不足:跨段轮转(各段按比例)
496
+ while len(out) < cap:
497
+ moved = False
498
+ for r in runs:
499
+ if depth < len(r):
500
+ out.append(r[depth])
501
+ moved = True
502
+ if len(out) >= cap:
503
+ break
504
+ if not moved:
505
+ break
506
+ depth += 1
411
507
  return out
412
508
 
413
509
 
@@ -519,12 +615,17 @@ def normalize_en(text: str) -> str:
519
615
  # legacy = |q ∩ d| / |q| 只归一化**查询侧** → 长文档天然占优(既有基线)。
520
616
  # LongMemEval-S 长 turn 上把证据挤出 Top-5:
521
617
  # precise/temporal/reference hit@1 均为 0%。
618
+ # 实义/功能 bigram 等权 ⇒ 分数只有 k/|q| 几个离散档,
619
+ # 文档一多就大面积同分(#363)。**传 df/n_docs 时**
620
+ # legacy 走 IDF 加权覆盖度(见下),这是缺省检索
621
+ # 路径的真实打分;不传时逐位保持旧公式(S5 负记忆
622
+ # 抑制等二文档比对仍用旧口径)。
522
623
  # jaccard = |q ∩ d| / |q ∪ d| 对称归一化(长度自惩罚,无参数)。
523
624
  # 同口径实测:长文档组 0%→8.97% / 0%→6.77% /
524
625
  # 1.28%→20.51%;短文档组(LoCoMo)基本持平或微降
525
626
  # → 收益随文档长度单调增长,是长度偏置的定向修复。
526
627
  # 切换:mdcg.SCORE_MODE = "jaccard",或环境变量 MDCG_SCORE_MODE=jaccard。
527
- # 缺省 "legacy":既有检索行为与基线完全不变。
628
+ # 缺省 "legacy":检索路径与基线一致,除 #363 的 IDF 加权(见下)。
528
629
  # **评测侧**改用 eval_common.use_jaccard() 显式注入——长 turn 语料上
529
630
  # precise 0%→8.97% / temporal 0%→6.77% / interference 1.28%→20.51% /
530
631
  # reference 0%→3.76%(与 Rust mdcg-eval --score jaccard 逐位一致)。
@@ -536,19 +637,106 @@ SCORE_MODES = ("legacy", "jaccard")
536
637
  SCORE_MODE = os.environ.get("MDCG_SCORE_MODE") or "legacy"
537
638
 
538
639
 
539
- # 生效条件:当 `qb` 与 `nb` 均为非空集合时,若 `mode` 或模块级 `SCORE_MODE` 为 `'jaccard'` 返回交集/并集,否则返回交集/len(`qb`);任一为空返回 0.0。
540
- def lexical_sim(qb: set, nb: set, mode: str = None) -> float:
640
+ # 生效条件:n_docs 为正整数、df 为 [0, n_docs] 内的整数时返回正 IDF;否则返回 0.0(不猜测、不放大)。
641
+ def idf_of(df: int, n_docs: int) -> float:
642
+ """单 term 的 IDF——**与 `md_cg/bm25.py` 的 BM25 打分同一条公式**:
643
+
644
+ log1p((N - df + 0.5) / (df + 0.5)) (bm25.py:357 的同一算术)
645
+
646
+ 为什么不另建一套:`_score` 的 IDF 面与 bm25 路的 IDF 面若各写一份,
647
+ 两个「真实打分」会随参数漂移而互相矛盾(#363 的根因正是「一条真源被
648
+ 复制」的反面:缺省路根本没有 IDF 这一维)。这里只做算术单点,词表/
649
+ 分词仍由调用方给(`_score` 用 `bigrams(normalize_en(...))`,与词法路
650
+ 同源),故不引入第二套分词口径。
651
+ """
652
+ n_docs = int(n_docs or 0)
653
+ if n_docs <= 0:
654
+ return 0.0
655
+ df = max(0, min(int(df or 0), n_docs))
656
+ return math.log1p((n_docs - df + 0.5) / (df + 0.5))
657
+
658
+
659
+ # 生效条件:当 `qb` 与 `nb` 均为非空集合时,若 `mode` 或模块级 `SCORE_MODE` 为 `'jaccard'` 返回交集/并集;否则若同时传入 df 与 n_docs(df 为查询 bigram→文档频次映射)返回 IDF 加权覆盖度 Σidf(q∩d)/Σidf(q)(#363:缺省检索路的真实打分),任一为空返回 0.0;未传 df 时返回交集/len(`qb`)(旧公式,逐位不变)。
660
+ def lexical_sim(qb: set, nb: set, mode: str = None,
661
+ df: dict = None, n_docs: int = None) -> float:
541
662
  """查询/文档二元组集合的相似度。mode 缺省取模块级 `SCORE_MODE`。
542
663
 
543
664
  显式传 mode 用于单点 A/B(不改全局口径即可对比两套打分)。
665
+
666
+ #363:`df`/`n_docs` 同时给出时,legacy 口径改走 **IDF 加权覆盖度**:
667
+
668
+ sim = Σ_{g ∈ q∩d} idf(g) / Σ_{g ∈ q} idf(g)
669
+
670
+ 分母只含查询侧(与 legacy 的「只归一化查询侧」同形,长文档不因此
671
+ 额外占优),但每个 bigram 按其在候选池中的稀有度加权——「什么/是什」
672
+ 这类高频功能 bigram 的 idf 趋近于 0,「共识/提交」这类实义 bigram
673
+ 的 idf 大。修前缺省路用 `inter/len(qb)`,分数只有 k/len(qb) 几个离散
674
+ 档,文档一多就大面积同分、名次退化为写入序(#363 现场)。
675
+
676
+ 未传 `df` 时**逐位保持旧公式**:`lexical_sim(a, b)` 仍是
677
+ `len(a∩b)/len(a)`——S5 负记忆抑制(`_score` 之外的二文档比对)等
678
+ 调用点语义不变,不需要也不应被语料频次影响。
679
+
680
+ 不适用条件:df 的统计面 = 调用方传入的那批候选文档(`_score` 的
681
+ `docs`)。跨批次比较(同一查询在不同候选池上)时 idf 分母不同,
682
+ 分数不可直接横向比较;名次仍可比较。
544
683
  """
545
684
  if not qb or not nb:
546
685
  return 0.0
547
- inter = len(qb & nb)
686
+ inter = qb & nb
548
687
  if (mode or SCORE_MODE) == "jaccard":
549
- union = len(qb | nb)
550
- return inter / union if union else 0.0
551
- return inter / len(qb)
688
+ union = qb | nb
689
+ return len(inter) / len(union) if union else 0.0
690
+ if df is not None and n_docs:
691
+ # 分母含**全部**查询 bigram:池里不存在的 gram(df=0)拿到最大 idf——
692
+ # 它们恰恰是最有判别力的(「池里没有」本身是信息),且这样「覆盖全查询」
693
+ # 才可能接近 1.0;把 df=0 从分母剔除会让「命中全部池内 gram」的文档恒
694
+ # 得 1.0(实测 retr_s4 夹具:同内容各层全部顶到 1.0,层级加成失效)。
695
+ _pairs = [(g, idf_of(df.get(g, 0), n_docs)) for g in qb]
696
+ total = sum(w for _, w in _pairs)
697
+ if total <= 0.0: # 无查询 bigram(qb 非空时不可达)→ 不放大
698
+ return 0.0
699
+ return sum(w for g, w in _pairs if g in inter) / total
700
+ return len(inter) / len(qb)
701
+
702
+
703
+ # issue #89①(2026-10-09 DSH 端):整串精确命中判据单点。
704
+ # 判据与 neg_condition_hits 判据 ① **同源**(去全部空白后作子串 + 长度下限 2),
705
+ # 检索面的「整串命中」只有这一个口径,不另发明一套。
706
+ EXACT_HIT_KEY = "_exact_hit"
707
+ EXACT_MIN_LEN = 2
708
+
709
+
710
+ # 生效条件:q 与 content 去全部空白后,q 长度 >= EXACT_MIN_LEN 且作为**连续子串**出现在 content 中 -> 返回 1,否则 0(假值按 "" 处理)。
711
+ def compact_exact_text(text: str) -> str:
712
+ """The existing exact-match whitespace normalization, without case folding."""
713
+ return re.sub(r"\s+", "", text or "")
714
+
715
+
716
+ def exact_hit_of(q: str, content: str, *, _prepared=None) -> int:
717
+ """整串精确命中(0/1)——**分数之外的次级排序键**(issue #89①)。
718
+
719
+ 缺陷(本端实测复现,2026-10-09):打分走 bigram 覆盖度,**连续整串**与
720
+ 「分散出现同样两个 bigram」得分**逐位相同**(实测 10 条 sim 全 = 1.0);
721
+ 封顶 min(1.0, ...) 后完全不可分辨 ⇒ 排序退化到 id 字典序 ⇒ 精确命中被
722
+ 挤出 top-k(复现:10 条同分、精确命中 id 字典序最大 ⇒ top5 不含它,
723
+ 与 GitHub #89 现象「222 不在前 5」一致)。
724
+
725
+ **为什么不是「封顶前保留原始分」**(issue 建议 1 前半句):实测封顶前的
726
+ 原始分同样全 = 1.0(sim 与 sim+tag_bonus 逐条相同)——原始分本身就没有
727
+ 分辨力,故该句在本机制下**不成立**;判据必须落在**分数之外**。
728
+
729
+ 为什么落排序键而不改分数:分数封顶 1.0 是既有契约(下游按 score 排序/
730
+ 取首位、MCP 三处把 score 透给调用方),改 cap 或让分数越过 1.0 会破契约;
731
+ 本判据只加 0/1 标记,**分数与阈值语义一字不动**。
732
+ """
733
+ # Only the scoring loop supplies prepared texts. The public two-argument
734
+ # entry keeps normalizing its own inputs and uses the same predicate.
735
+ _q = compact_exact_text(q) if _prepared is None else _prepared[0]
736
+ if len(_q) < EXACT_MIN_LEN:
737
+ return 0
738
+ body = compact_exact_text(content) if _prepared is None else _prepared[1]
739
+ return 1 if _q in body else 0
552
740
 
553
741
 
554
742
  # 负条件判据的词长下限(批次76):空白切词会把中文句子里夹的裸标识符切成独立词、
@@ -556,7 +744,92 @@ def lexical_sim(qb: set, nb: set, mode: str = None) -> float:
556
744
  NEG_MIN_TERM = 2
557
745
 
558
746
 
559
- # 生效条件:neg_conditions 为字符串列表(假值按空列表);逐条按空白切词、丢弃长度 < NEG_MIN_TERM 的词与已入选的重复词;词出现在 scene_text 中,且(own_topic_text 去全部空白后为空,或该词去全部空白后不是 own_topic_text 去空白文本的子串)才计入;返回按首次出现顺序排列的命中词列表,无命中返回空列表。
747
+ # ---- #362a:否定作用域(负条件命中的**唯一**新增否决项)------------------------
748
+ #: 否定词表——**最长优先**(`_negated_at` 按表序 startswith,故长词必须排在前面)。
749
+ NEG_CUES = ("不属于", "不是", "没有", "并非", "并无", "未有",
750
+ "不", "非", "没", "无", "未", "别", "莫")
751
+
752
+ #: 否定词与被否定成分之间**允许**出现的连接字(「不是**这种**X」「不是**的**X」)。
753
+ #: 只有「否定词 + 纯连接字」**紧邻**才算否定——`不`/`无` 是高频字,放宽成
754
+ #: 「窗口内出现否定词就算否定」会把 `不适合梅雨季节的施工`(真负条件)一起吞掉,
755
+ #: 那是过度收紧方向(由守卫 `--mutate` 的 M3 定点变异钉住)。
756
+ NEG_LINK_CHARS = frozenset("是这那该此种个些的了在为之其")
757
+
758
+ #: 否定作用域窗口(向前最多回看的字符数):6 够「不是」+「这样的」(2+3),
759
+ #: 又不足以跨过 `不适合X` 里的实义词。窗口两端都有 K 组对照——缩到 1 即红(M2)。
760
+ NEG_SCOPE_WINDOW = 6
761
+
762
+
763
+ # 生效条件:text 为任意对象(None 按空串)时返回其匹配面归一串(去全部空白 + NFKC + casefold + 繁简折叠,繁简表当前为空);归一口径复用 routing.fold_variants 单点。
764
+ def fold_for_match(text) -> str:
765
+ """匹配面归一人(#362b/c)——**复用路由面的同一份口径**,不新造第二份。
766
+
767
+ 与 `compact_exact_text`(整串精确命中判据的空白归一)的区别只有一条:本函数
768
+ 额外取 `routing.fold_variants`(NFKC + casefold + 繁简折叠)。之所以不另写一份
769
+ 「全角/大小写」处理,是因为那正是本仓反复出现的**同语义多落点判据分裂**
770
+ (`routing.nfkc_text` 是 NFKC 的唯一单点,由守卫 E 组做源码面断言)。
771
+ """
772
+ return compact_exact_text(routing.fold_variants(text))
773
+
774
+
775
+ # 生效条件:text 与 term 均为 str 时,把 text 中所有「与 term 同形(去全部空白 + NFKC + casefold + 繁简折叠后相等)」的区间替换为空格并返回;term 归一后为空或未找到同形区间时原样返回。
776
+ def _strip_variant(text: str, term: str) -> str:
777
+ """把与 `term` **同形但不同字面**的区间也摘掉(#362b/c 的摘词面腿)。
778
+
779
+ 为什么必须补这一步:`boundary_hit` 的命中判据(`neg_condition_hits`)在 #362b/c
780
+ 之后按**归一后**的词面命中,而摘词面若只认原样字面,就会出现「归一后命中、
781
+ 却摘不干净」⇒ 边界问句下资格仍 REJECT 而 `boundary_suppressed=True` ⇒
782
+ `tally_boundary` 的 `self_negation` 不再恒 0(该不变量见 `test_boundary_hit` B4)。
783
+ 两条腿共用同一个 `fold_for_match` 口径,是 §5.2「同一字段两条语义可分」的前提。
784
+ """
785
+ target = fold_for_match(term)
786
+ if not target:
787
+ return text
788
+ out = text
789
+ while True:
790
+ chars, idx = [], []
791
+ for i, ch in enumerate(out):
792
+ for c in fold_for_match(ch):
793
+ chars.append(c)
794
+ idx.append(i)
795
+ k = "".join(chars).find(target)
796
+ if k < 0:
797
+ return out
798
+ i, j = idx[k], idx[k + len(target) - 1] + 1
799
+ out = out[:i] + " " + out[j:]
800
+
801
+
802
+ # 生效条件:s 为归一串、i 为 0 <= i < len(s) 的匹配起址时,向前最多回看 NEG_SCOPE_WINDOW 个字符,若存在否定词 cue 且该 cue 恰好止于 i 之前(不跨进匹配内部)、cue 与 i 之间只由 NEG_LINK_CHARS 组成则返回 True,否则 False。
803
+ def _negated_at(s: str, i: int) -> bool:
804
+ """`s[i:]` 处的匹配是否落在某个否定词的作用域内(#362a)。"""
805
+ for back in range(1, NEG_SCOPE_WINDOW + 1):
806
+ j = i - back
807
+ if j < 0:
808
+ break
809
+ # **正反问(A-not-A)不算否定**:「是不是X」「有没有X」「能不能X」「去不去X」
810
+ # 里的否定词是正反叠用标记,不是对 X 的否定(X 恰是句子的**主题**)。
811
+ # 判据:否定词**两侧同字**(`s[j-1] == s[j+1]`)——`不是X` 前面不是「是」
812
+ # 时照旧算否定,故该豁免只吃掉正反问,不放松真否定(K12/K13 两向钉住)。
813
+ if j >= 1 and j + 1 < len(s) and s[j - 1] == s[j + 1]:
814
+ continue
815
+ for cue in NEG_CUES:
816
+ if j + len(cue) <= i and s.startswith(cue, j):
817
+ if all(ch in NEG_LINK_CHARS for ch in s[j + len(cue):i]):
818
+ return True
819
+ return False
820
+
821
+
822
+ # 生效条件:hay 与 needle 均为 str 时返回 needle 在 hay 中的全部出现起始下标(左对齐、按升序,含重叠出现);needle 为空串返回空列表。
823
+ def _occurrences(hay: str, needle: str) -> list:
824
+ """needle 在 hay 中的全部出现起址(#362a:逐次出现各自判否定作用域)。"""
825
+ out, i = [], hay.find(needle) if needle else -1
826
+ while i >= 0:
827
+ out.append(i)
828
+ i = hay.find(needle, i + 1)
829
+ return out
830
+
831
+
832
+ # 生效条件:neg_conditions 为字符串列表(假值按空列表)、scene_text/own_topic_text 为字符串(假值按空串)时,两侧都过 fold_for_match 归一(去全部空白 + NFKC + casefold + 繁简折叠);逐条取其归一后词面——整条(长度 ≥ NEG_MIN_TERM)出现在情境里、且**存在一次出现未被否定作用域覆盖**(_negated_at 为假)、且不落在自主题面上,即命中;否则按空白切词、丢弃归一后长度 < NEG_MIN_TERM 的词,「每个词都出现在情境里」且不落在自主题面上也算命中;返回按首次出现顺序排列的命中原样条目列表,无命中返回空列表。
560
833
  def neg_condition_hits(neg_conditions, scene_text, own_topic_text="") -> list:
561
834
  """负条件(不适用条件)命中判据——**检索面唯一的负判据单点**。
562
835
 
@@ -571,6 +844,19 @@ def neg_condition_hits(neg_conditions, scene_text, own_topic_text="") -> list:
571
844
  ④ **自主题豁免**:命中内容出现在节点自己声明的主题面(功能名 + 生效条件,
572
845
  见 `MdCG._self_topic_text`)里则不计——它不是「不适用」,而是「本节点
573
846
  讲的就是它」。
847
+ ⑤ **否定作用域**(#362a):整条命中后**逐次出现**检查紧邻是否有否定词
848
+ (`NEG_CUES`:不/非/没/无/…);「否定词 + 纯连接字」紧邻
849
+ (`不是梅雨季节`、`不是这种梅雨季节`)⇒ 该次出现**不计**命中。
850
+ 任一出现未被否定即命中(`不是梅雨季节,现在是梅雨季节` 仍命中——
851
+ 第二次出现没被否定)。`不适合梅雨季节的施工` **照旧命中**:`适合`
852
+ 不是连接字,否定词作用的是「适合」而不是「梅雨季节」——收紧只落在
853
+ 真正的否定结构上,不落「否定词出现在附近」。
854
+ **正反问(A-not-A)不算否定**:「是不是X」「有没有X」是否定词两侧同字的
855
+ 正反叠用,X 恰是句子主题 ⇒ 照旧命中(`_negated_at` 的同字判据)。
856
+ ⑥ **字符归一**(#362b/c):两侧都过 `fold_for_match`(去全部空白 + NFKC +
857
+ casefold + 繁简折叠,全部经 `routing` 单点)。全角/半角与大小写因此
858
+ 互通(`4G单模终端` = `4G单模终端`、`PDF 扫描件` = `pdf 扫描件`);
859
+ 繁简折叠表**当前为空**(见 `routing.TRAD_TO_SIMP`),该能力未生效。
574
860
 
575
861
  为什么不能沿用「任一词命中」(三处过粗,各有实测支撑):
576
862
  · **主题词变扳机**:空白切词把中文句里夹的裸标识符切成独立词,于是
@@ -589,20 +875,28 @@ def neg_condition_hits(neg_conditions, scene_text, own_topic_text="") -> list:
589
875
  ——`test_neg_condition_hits.py` 有正向对照断言钉住(`问ZXQ7`/`刚才在干什么`/
590
876
  `问完全无关主题` 三条语料口径 + 自造多词条目),防「一律不拒」的退化解。
591
877
  """
592
- scene = scene_text or ""
593
- scene_norm = re.sub(r"\s+", "", scene)
594
- own = re.sub(r"\s+", "", own_topic_text or "")
878
+ scene_norm = fold_for_match(scene_text or "")
879
+ own = fold_for_match(own_topic_text or "")
595
880
  hits = []
596
881
  for n in (neg_conditions or []):
597
- item = re.sub(r"\s+", "", str(n))
882
+ item = fold_for_match(n)
598
883
  if not item:
599
884
  continue
600
885
  if len(item) >= NEG_MIN_TERM and item in scene_norm:
601
886
  if not (own and item in own):
602
- hits.append(str(n))
887
+ # #362a:整条命中后还要过**否定作用域**——任一出现**未被否定**
888
+ # 即命中(`不是梅雨季节,现在是梅雨季节` 的第二次出现没被否定,
889
+ # 故仍命中)。逐次判而非「整串搜一次否定词」,正是为了不把
890
+ # `不适合X` 里的 `不`(作用在「适合」上)当成对 X 的否定。
891
+ if any(not _negated_at(scene_norm, k)
892
+ for k in _occurrences(scene_norm, item)):
893
+ hits.append(str(n))
603
894
  continue
604
- words = [w for w in str(n).split() if len(w) >= NEG_MIN_TERM]
605
- if words and all(w in scene for w in words):
895
+ # 全词命中:词面齐全才算问到点上。归一后的词与归一串同口径比较
896
+ # (#362b/c;去空白同时把「条目内空白」与「情境内空白」两种写法对齐)。
897
+ words = [w for w in (fold_for_match(x) for x in str(n).split())
898
+ if len(w) >= NEG_MIN_TERM]
899
+ if words and all(w in scene_norm for w in words):
606
900
  if own and any(w in own for w in words):
607
901
  continue
608
902
  hits.append(str(n))
@@ -692,19 +986,34 @@ def index_key_hits(entry, terms, query) -> dict:
692
986
  即行为退回改动前(零破坏)。
693
987
  """
694
988
  e = entry or {}
695
- hits = {"hit": False, "post": False, "reject": False, "why": []}
989
+ # issue #218(2026-10-13 DSH 端):**分支回传面结构化**。
990
+ # 本函数此前把「是哪一条出口命中的」只写进 why(字符串列表)——而 why
991
+ # 的消费者只有守卫(test_p2_six_elements 断言其内容),**检索面与人工裁决面
992
+ # 都读不到**。于是「验证方式的值真的与查询有关」(term)与「只是声明了验证
993
+ # 方式」(declared)在回传体上不可区分。
994
+ # 本改动只**新增**两个结构化字段(判据、hit/post/reject/why 逐位不变):
995
+ # · post_source : "term" | "declared" | None
996
+ # · reject_source: "declared" | None
997
+ # 取值的**值敏感性**因此可复核:post_source=="term" 才是值命中,
998
+ # post_source=="declared" 表示值未参与判定(详见 nodefile.CCG_CONTRACT_ROLES
999
+ # 旁 #218 的登记注释)。
1000
+ hits = {"hit": False, "post": False, "reject": False, "why": [],
1001
+ "post_source": None, "reject_source": None}
696
1002
  q = str(query or "")
697
1003
  post = e.get(nodefile.POSTCONDITION_TERMS_KEY) or []
698
1004
  if post:
699
1005
  if any(t in " ".join(post) for t in (terms or [])):
700
1006
  hits["post"] = True
1007
+ hits["post_source"] = "term"
701
1008
  hits["why"].append("postcondition_terms:term")
702
1009
  elif is_postcondition_query(q):
703
1010
  hits["post"] = True
1011
+ hits["post_source"] = "declared"
704
1012
  hits["why"].append("postcondition_terms:declared")
705
1013
  rej = e.get(nodefile.REJECTION_TERMS_KEY) or []
706
1014
  if rej and is_boundary_query(q):
707
1015
  hits["reject"] = True
1016
+ hits["reject_source"] = "declared"
708
1017
  hits["why"].append("rejection_terms:declared")
709
1018
  hits["hit"] = bool(hits["post"] or hits["reject"])
710
1019
  return hits
@@ -791,7 +1100,7 @@ def boundary_hit(node_dict, query, context=None) -> dict:
791
1100
  "scene": scene_str}
792
1101
 
793
1102
 
794
- # 生效条件:text 为字符串(假值按空串)、terms 为可迭代条目表时,逐条把其原样字面量与「去空白后的字符间容忍任意空白」形态从 text 中替换为空格;返回替换后的字符串(terms 为空即原样返回)。
1103
+ # 生效条件:text 为字符串(假值按空串)、terms 为可迭代条目表时,逐条把其原样字面量、「去空白后的字符间容忍任意空白」形态、以及「同形(去空白 + NFKC + casefold + 繁简折叠后相等,走 _strip_variant)」形态从 text 中替换为空格;返回替换后的字符串(terms 为空即原样返回)。
795
1104
  def strip_boundary_terms(text: str, terms) -> str:
796
1105
  """从查询串里摘掉命中的拒绝域条目(只用于**边界问句**的资格判定)。
797
1106
 
@@ -809,6 +1118,9 @@ def strip_boundary_terms(text: str, terms) -> str:
809
1118
  ns = re.sub(r"\s+", "", s)
810
1119
  if ns and ns != s: # 条目内含空白 → 容忍任意空白形态
811
1120
  out = re.sub(r"\s*".join(re.escape(ch) for ch in ns), " ", out)
1121
+ # #362b/c:命中判据已按**归一词面**认(全角/大小写/繁简),摘词面必须同口径,
1122
+ # 否则「归一后命中、却摘不干净」会在边界问句下留下自否定残留。
1123
+ out = _strip_variant(out, s)
812
1124
  return out
813
1125
 
814
1126
 
@@ -1150,6 +1462,29 @@ def apply_retrieval_gates(entries, terms, big_domain, context, min_results):
1150
1462
  return entries, gates
1151
1463
 
1152
1464
 
1465
+ # 生效条件:fp 为可读文件路径时返回其**整文件字节**的 sha256 十六进制摘要前 16 位;open/read 抛 OSError 时返回 None(读不到即「证不出」,调用方据此走 fail-open 分支);不缓存、不解析、不看扩展名。
1466
+ def _file_digest(fp: str):
1467
+ """节点文件的**整字节身份指纹**(#80)。
1468
+
1469
+ 为什么不用 nodefile.content_hash:那只哈希**正文**、按纪律**不含
1470
+ frontmatter**(nodefile.py:314-316)——frontmatter 被单独改写时它不变,
1471
+ 不足以回答「这个文件还是我标脏时那个文件吗」。本判据要的正是**整文件
1472
+ 逐字身份**,故直接哈希盘面字节。
1473
+
1474
+ 为什么截 16 位:与全仓 sha256 系列(nodefile.content_hash 截 12、
1475
+ mdcg.py:2571 截 12)同族;本判据只做同/异比较、不做安全承诺,
1476
+ 16 位(64 bit)的碰撞概率远低于误判代价。
1477
+
1478
+ 为什么返回 None 而不抛:调用方两条路径(登记 / 判陈旧)都必须
1479
+ fail-open——「证不出陈旧就不当陈旧」是 N230 的既有不变量。
1480
+ """
1481
+ try:
1482
+ with open(fp, "rb") as f:
1483
+ return hashlib.sha256(f.read()).hexdigest()[:16]
1484
+ except OSError:
1485
+ return None
1486
+
1487
+
1153
1488
  # 生效条件:无独立生效条件(模块级哨兵字典类);任何变更操作(setitem/delitem/clear/pop/popitem/setdefault/update)都会使 write_gen 自增 1,读取 write_gen 不变更;setitem 的值为含非空 path 字符串的 dict 时把该 path 记入 path_gen(值为当时的 write_gen)且不动 broad_gen,值为其它形态(含 None tombstone)或经 delitem/pop/popitem/setdefault/update 变更时把 broad_gen 置为当时的 write_gen,clear() 缺省(flush 收尾)只使 write_gen 自增、不改写 path_gen/broad_gen,clear(broad=True)(rebuild_index 收尾)同时把 broad_gen 置为当时的 write_gen。
1154
1489
  class _DirtyDict(dict):
1155
1490
  """写代际哨兵字典(批次 23,issue #31 D-4 / v20 报告):任何变更使
@@ -1194,6 +1529,15 @@ class _DirtyDict(dict):
1194
1529
  # `MdCG._dirty_entry_superseded`。
1195
1530
  self.root = None
1196
1531
  self.staged_stat = {}
1532
+ # issue #80 残留面(2026-10-09 DSH 端,C 案:标记而非清除 + flush 侧过滤):
1533
+ # _maybe_reload_index 判某条脏条目已被盘面更新盖过时**跳过重放**(放行盘面),
1534
+ # 但原实现把条目**留在脏集** ⇒ 随后的 flush 会把它**无条件 append 进分片日志**,
1535
+ # compact 再把它固化进 _index.json ⇒ **索引侧旧盖新,且跨进程/跨重启存活**
1536
+ # (仅 rebuild_index 可自愈)。此处按 nid 打标记,flush 侧据此过滤。
1537
+ # 标记集**放在本类内**(不挂宿主)——与 dict 同生命周期,使泄漏面收敛到
1538
+ # 本类的变更点上(setitem/delitem/pop/popitem/setdefault/update/clear),
1539
+ # 而不是靠『记得在四处都写一遍』。
1540
+ self.superseded_ids = set()
1197
1541
 
1198
1542
  def _bump(self):
1199
1543
  self.write_gen += 1
@@ -1206,14 +1550,26 @@ class _DirtyDict(dict):
1206
1550
  else:
1207
1551
  self.broad_gen = self.write_gen
1208
1552
 
1209
- # 生效条件:k 为节点 id、v 为 entry;恒 pop 该 k 的旧见证,随后仅当 v 为含非空 path 字符串的 dict 且 self.root 为真、且 os.stat(root/path) 成功时记入 self.staged_stat[k]=(st_mtime_ns, st_size);其余情形(None tombstone / 无 path / stat 失败 / 无 root)不登记——不登记即「证不出陈旧」,重放按旧口径放行。
1553
+ # 生效条件:k 为节点 id、v 为 entry;恒 pop 该 k 的旧见证,随后仅当 v 为含非空 path 字符串的 dict 且 self.root 为真、且 os.stat(root/path) 成功时记入 self.staged_stat[k]=(st_mtime_ns, st_size, 整文件 sha256 前 16 位);内容读不到(OSError)时第三元记 None(显式的「陈旧证不出」标记,判据侧据此放行);其余情形(None tombstone / 无 path / stat 失败 / 无 root)不登记——不登记即「证不出陈旧」,重放按旧口径放行。
1210
1554
  def _note_witness(self, k, v):
1211
1555
  """落盘逐字见证的登记(N230)。
1212
1556
 
1213
- 为什么记 (mtime_ns, size):`_maybe_reload_index` 需要判「本实例这条
1214
- 未 flush 的写入,是不是已经被他进程后来写下的**更新**记录盖过」。节点
1215
- 文件是唯一真源——标脏时它长什么样,重放时再 stat 一次,不一样就说明
1216
- 盘面已被别人改过(改写内容必然改 mtime_ns;NTFS 粒度 100ns)。
1557
+ 为什么记 (mtime_ns, size, sha256):`_maybe_reload_index` 需要判「本实例
1558
+ 这条未 flush 的写入,是不是已经被他进程后来写下的**更新**记录盖过」。
1559
+ 节点文件是唯一真源——标脏时它长什么样,重放时再看一次,不一样就说明
1560
+ 盘面已被别人改过。
1561
+
1562
+ **#80(2026-10-09)修正**:原判据只记 (mtime_ns, size),其原注释断言
1563
+ 「改写内容必然改 mtime_ns;NTFS 粒度 100ns」——**该断言是错的**。
1564
+ mtime 可被**还原**:cp -p / rsync -t / tar x / robocopy /DCOPY:T /
1565
+ 备份还原 / 网盘同步客户端回写原 mtime;粗粒度文件系统(FAT 2s、
1566
+ ext3 1s)下同刻度写入更是常态。届时一个**等长**改写会同时满足 size
1567
+ 相等与 mtime 相等 ⇒ 见证不失配 ⇒ 判据漏判 ⇒ 旧写盖新写并随 flush
1568
+ 持久化(沙箱实测:撕裂 17/17 轮、持久化 13/13 轮)。
1569
+ 故补第三元**整文件内容哈希**:mtime/size 失配仍即时判陈旧(零额外
1570
+ IO,原语义一字不改),**双双相等时再比内容哈希**——身份最终由字节定,
1571
+ 不再由时间戳定。
1572
+
1217
1573
  stat 失败与无 path 一律不登记:**证不出陈旧就不当陈旧**——「本实例未
1218
1574
  落盘写入不因重载从检索面消失」是既有不变量,宁可漏挡也不误杀。
1219
1575
  """
@@ -1221,21 +1577,25 @@ class _DirtyDict(dict):
1221
1577
  p = v.get("path") if isinstance(v, dict) else None
1222
1578
  if not (isinstance(p, str) and p and self.root):
1223
1579
  return
1580
+ fp = os.path.join(self.root, p)
1224
1581
  try:
1225
- st = os.stat(os.path.join(self.root, p))
1582
+ st = os.stat(fp)
1226
1583
  except OSError:
1227
1584
  return
1228
- self.staged_stat[k] = (st.st_mtime_ns, st.st_size)
1585
+ # #80:第三元=整文件内容哈希(mtime/size 可被还原,不足以定身份)。
1586
+ self.staged_stat[k] = (st.st_mtime_ns, st.st_size, _file_digest(fp))
1229
1587
 
1230
1588
  def __setitem__(self, k, v):
1231
1589
  self._bump()
1232
1590
  self._note(v)
1233
1591
  self._note_witness(k, v)
1592
+ self.superseded_ids.discard(k) # 新写入不再陈旧(issue #80 残留面)
1234
1593
  super().__setitem__(k, v)
1235
1594
 
1236
1595
  def __delitem__(self, k):
1237
1596
  self._bump()
1238
1597
  self.staged_stat.pop(k, None)
1598
+ self.superseded_ids.discard(k) # issue #80 残留面
1239
1599
  self.broad_gen = self.write_gen
1240
1600
  super().__delitem__(k)
1241
1601
 
@@ -1257,11 +1617,13 @@ class _DirtyDict(dict):
1257
1617
  if broad:
1258
1618
  self.broad_gen = self.write_gen
1259
1619
  self.staged_stat.clear()
1620
+ self.superseded_ids.clear() # issue #80 残留面:脏集清空 ⇒ 标记一并清
1260
1621
  super().clear()
1261
1622
 
1262
1623
  def pop(self, k, *d):
1263
1624
  self._bump()
1264
1625
  self.staged_stat.pop(k, None)
1626
+ self.superseded_ids.discard(k) # issue #80 残留面
1265
1627
  self.broad_gen = self.write_gen
1266
1628
  return super().pop(k, *d)
1267
1629
 
@@ -1269,17 +1631,20 @@ class _DirtyDict(dict):
1269
1631
  self._bump()
1270
1632
  self.broad_gen = self.write_gen
1271
1633
  self.staged_stat.clear() # 摘哪条不确定,保守清空(下一轮按「无见证」放行)
1634
+ self.superseded_ids.clear() # issue #80 残留面:同上,摘哪条不确定 ⇒ 保守清空
1272
1635
  return super().popitem()
1273
1636
 
1274
1637
  def setdefault(self, k, d=None):
1275
1638
  self._bump()
1276
1639
  self.broad_gen = self.write_gen
1277
1640
  self.staged_stat.pop(k, None)
1641
+ self.superseded_ids.discard(k) # issue #80 残留面
1278
1642
  return super().setdefault(k, d)
1279
1643
 
1280
1644
  def update(self, *a, **k):
1281
1645
  self._bump()
1282
1646
  self.broad_gen = self.write_gen
1647
+ self.superseded_ids.clear() # issue #80 残留面:批量变更 ⇒ 保守清空
1283
1648
  self.staged_stat.clear()
1284
1649
  super().update(*a, **k)
1285
1650
 
@@ -1410,7 +1775,7 @@ def _check_sensitivity_landing(node_id, fm_sensitivity, declared, sealed,
1410
1775
  "改写/丢弃;请检查写面是否透传 sensitivity(B2:落盘面丢字段="
1411
1776
  "上游声明静默失效)。本次**未写盘**。" % (decl, fm_sens, node_id))
1412
1777
  eff = decl or fm_sens
1413
- if has_sealer and eff in crypto.ENCRYPTED_LEVELS \
1778
+ if has_sealer and crypto.is_encrypted_level(eff) \
1414
1779
  and not crypto.is_encrypted(sealed):
1415
1780
  raise ValueError(
1416
1781
  "加密级密级对应明文落盘(fail-closed):声明/落盘密级=%r,但本次"
@@ -1420,9 +1785,100 @@ def _check_sensitivity_landing(node_id, fm_sensitivity, declared, sealed,
1420
1785
  return None
1421
1786
 
1422
1787
 
1788
+ # 生效条件:field 为字段名(str)、value 为待落盘数值——value 非 bool 且经 float() 可转为 [0, 1] 区间内的**有限数**时返回该 float,否则抛 ValueError(文案点名字段、原值、允许域与理由)。
1789
+ def _require_unit_number(field, value) -> float:
1790
+ """写侧数值守卫单点(#151②):[0, 1] 有限数,否则 fail-closed。
1791
+
1792
+ 为什么**非有限视同非法**(与 `reach._ttl()` 同款判据,特征串
1793
+ `if not math.isfinite(v) or v <= 0:`):
1794
+ · `inf` ⇒ `importance >= protect.AUTO_PROTECT_IMPORTANCE` 恒真 ⇒
1795
+ 节点被打上**不可遗忘保护**并永久霸榜(inf 参与任何加权相乘仍是 inf);
1796
+ · `nan` ⇒ 一切比较恒 False ⇒ 排序不可复现(同一查询两次顺序可不同),
1797
+ 且事后无法从读数区分「没算」与「算成 nan」。
1798
+ 为什么**拒**而不回落:回落会让「填错」看起来像「填对」(与
1799
+ `_check_sensitivity_landing` 的「静默回落 = 声明被静默改写」同向);
1800
+ 子类 `mdcos.MdCGOS.add` 的回落语义在**更上游**,不受本单点影响。
1801
+ 判据单点化(同仓纪律):写侧各处共用这一份,守卫可对其定点变异自证。
1802
+ """
1803
+ if isinstance(value, bool) or value is None:
1804
+ raise ValueError(
1805
+ f"非法 {field}:{value!r}——须为 [0, 1] 区间内的有限数(bool 不算"
1806
+ f" number:落盘会成 `{field}: true`);fail-closed 拒绝落盘(#151②)。")
1807
+ try:
1808
+ v = float(value)
1809
+ except (TypeError, ValueError):
1810
+ raise ValueError(
1811
+ f"非法 {field}:{value!r}——须为 [0, 1] 区间内的有限数(不可转"
1812
+ f" float);fail-closed 拒绝落盘(#151②)。")
1813
+ if not math.isfinite(v) or not (0.0 <= v <= 1.0):
1814
+ raise ValueError(
1815
+ f"非法 {field}:{value!r}——须为 [0, 1] 区间内的有限数(非有限视同"
1816
+ f"非法:inf 会触发不可遗忘保护并永久霸榜,nan 使排序不可复现);"
1817
+ f"fail-closed 拒绝落盘(#151②)。")
1818
+ return v
1819
+
1820
+
1821
+ # ---- issue #146③:密级行的**值域**判据(fail-closed,单一真源 = security)----
1822
+ # 病象:`sensitivity: "机密"`(类型对、值域错)能过 nodefile.frontmatter_problem
1823
+ # 的类型判据进索引;此后按「未知密级」消费时要么在 _rank 抛 AccessDenied 打断
1824
+ # 整条检索链,要么被当成默认档——后者等于把「密级声明坏掉」静默**降级为明文**。
1825
+ # 故在装载面就地 fail-closed:隔离该节点(不进索引、不改盘)。
1826
+ def _sensitivity_problem(value) -> str:
1827
+ """密级行值域判据:None(未声明)合法;不在阶梯里 → 原因串(fail-closed)。
1828
+
1829
+ 阶梯的**唯一真源**是 security.SENSITIVITY_ORDER——延迟导入,本模块不另抄
1830
+ 一份(第二份判据迟早与真源漂移)。返回空串 = 无问题。
1831
+ """
1832
+ if value is None:
1833
+ return "" # 缺省合法:存量节点本就不带该键
1834
+ from .security import SENSITIVITY_ORDER
1835
+ if value in SENSITIVITY_ORDER:
1836
+ return ""
1837
+ return ("密级损坏(fail-closed,不降级为明文):sensitivity=%r 不在 %s"
1838
+ % (value, list(SENSITIVITY_ORDER)))
1839
+
1840
+
1841
+ # ---- issue #146②:隔离的**可观测面**(单一实现点)-----------------------------
1842
+ # 隔离本身是「静默消失」:节点不进索引、盘面不改,使用者只会觉得「记忆少了」。
1843
+ # 故每次全量扫描后把隔离清单写 stderr(与 fsutil.note_* 同一条可观测纪律:
1844
+ # 容忍 ≠ 静默);告警写失败被吞掉——告警面不得反向破坏装载路径。
1845
+ def _warn_quarantined(items) -> None:
1846
+ """把本次扫描的隔离清单写 stderr;空清单不打噪声。"""
1847
+ if not items:
1848
+ return
1849
+ try:
1850
+ lines = ["[mdcg] 装载隔离告警:%d 个坏节点被隔离(不进索引、不改盘、"
1851
+ "盘面真源保留)" % len(items)]
1852
+ for nid in sorted(items):
1853
+ info = items.get(nid) or {}
1854
+ lines.append(" 隔离 %s:%s(%s)"
1855
+ % (nid, info.get("path") or "?",
1856
+ info.get("reason") or ""))
1857
+ sys.stderr.write("\n".join(lines) + "\n")
1858
+ except Exception: # noqa: BLE001
1859
+ pass
1860
+
1861
+
1862
+ # 生效条件:schema 同源、nodes 为 dict、全部键为字符串且条目具有非空字符串 path 与字符串/None bucket 时返回 True;任一不符返回 False,由加载与 compact 共用回扫真源。
1863
+ def _usable_index_snapshot(value):
1864
+ """A derived snapshot must contain usable entries before it can be replayed.
1865
+
1866
+ Node files remain authoritative. Re-scan the whole snapshot on a malformed
1867
+ container/entry instead of accepting a partial pool and losing real nodes.
1868
+ """
1869
+ if not isinstance(value, dict) or value.get("schema") != SCHEMA:
1870
+ return False
1871
+ nodes = value.get("nodes")
1872
+ return isinstance(nodes, dict) and all(
1873
+ isinstance(nid, str) and isinstance(entry, dict)
1874
+ and isinstance(entry.get("path"), str) and bool(entry["path"])
1875
+ and (entry.get("bucket") is None or isinstance(entry.get("bucket"), str))
1876
+ for nid, entry in nodes.items())
1877
+
1878
+
1423
1879
  # 生效条件:构造须传入 root,经 os.path.abspath 后以 exist_ok=True 创建该目录及 LAYERS 各层子目录;autoflush 无论取值(默认 64)都原样赋给实例。
1424
1880
  class MdCG:
1425
- # 生效条件:root 传参即被 os.path.abspath 绝对化并 makedirs(exist_ok=True) 建立 root 与模块级 LAYERS 各层目录,autoflush(默认 64,含 0 等假值)原样存入 self.autoflush,随后 _load_index() 载入索引并以 _index_signature() 记录 _index.json 签名到 self._index_sig(跨进程读面代际感知的基线,P1b-2)、sweep_stale_temps(self.root) 清扫,并把 self 登记进模块级 _LIVE_CGS;
1881
+ # 生效条件:root 传参即被 os.path.abspath 绝对化并 makedirs(exist_ok=True) 建立 root 与模块级 LAYERS 各层目录,autoflush(默认 64,含 0 等假值)原样存入 self.autoflush,随后 _load_index() 载入索引并以 _index_signature() 记录 _index.json 签名到 self._index_sig(跨进程读面代际感知的基线,P1b-2)、sweep_stale_temps(self.root) 清扫,并把 self 登记进模块级 _LIVE_CGS,最后按 MDCG_READ_CACHE 装配读缓存(#370:readcache.install_default——自动装配的唯一入口,env 门 + 幂等,MDCG_READ_CACHE=0 时不装配);
1426
1882
  def __init__(self, root: str, autoflush: int = 64):
1427
1883
  self.root = os.path.abspath(root)
1428
1884
  os.makedirs(self.root, exist_ok=True)
@@ -1471,6 +1927,17 @@ class MdCG:
1471
1927
  # 进程退出兜底登记(见模块级 _LIVE_CGS):一次性脚本漏收尾时索引仍能落盘。
1472
1928
  _LIVE_CGS.add(self)
1473
1929
  _register_atexit_hook()
1930
+ # #370:读缓存装配**下沉到基类**(Lead 裁定 2026-10-16)。修前装配点
1931
+ # 只有 MdCGOS.__init__ ⇒ 直接以 `MdCG(root)` 打开的库(backfill/
1932
+ # migrate/build_postings 等全库扫描 CLI)全走无缓存路径:本机 500 节点
1933
+ # 合成库实测 33.1 vs 3.3 ms/查询、nodefile.loads 500 vs 0 次/查询。
1934
+ # 落点理由:失效判据(_DirtyDict 脏集 path_gen/broad_gen)与组装面
1935
+ # (_read_status / _read / 四个派生钩子)**都在本类**,装配点与它们同层;
1936
+ # 不对称只有历史原因。必须晚于 self._dirty 建立(第 1840 行)。
1937
+ # install_default 是自动装配的**唯一入口**(env 门 + 幂等)——
1938
+ # MDCG_READ_CACHE=0 退出阀语义不变(不装配,回到逐次读盘)。
1939
+ from . import readcache as _readcache
1940
+ _readcache.install_default(self)
1474
1941
 
1475
1942
  # ---------- 索引(派生物,可重建) ----------
1476
1943
 
@@ -1488,7 +1955,7 @@ class MdCG:
1488
1955
  # 服务起不来、一次性脚本全崩,而盘上 .md 真源完好无损(丢的只是
1489
1956
  # 派生索引这一条腿)。视同损坏 ⇒ idx 保持 None ⇒ 落到下面**既有**
1490
1957
  # 的「回退全库扫描」路径(不新增第三套判据)。
1491
- if isinstance(d, dict) and d.get("schema") == SCHEMA:
1958
+ if _usable_index_snapshot(d):
1492
1959
  idx = d
1493
1960
  except (ValueError, OSError):
1494
1961
  idx = None
@@ -1500,8 +1967,11 @@ class MdCG:
1500
1967
  # 「无快照」路径的兜底行为,成本不劣于改动前)。旧快照无
1501
1968
  # _fingerprint 键 → 同样回退一次(迁移窗口),下次 close
1502
1969
  # 落新快照后恢复快照路径。
1503
- fp = idx.get("_fingerprint")
1504
- if fp is None or fp != self._dir_fingerprint():
1970
+ # #409(P0):判据本体收成**单点** _snapshot_trusted——装载面与
1971
+ # 落盘面(compact_index)调**同一个**实现。此前 compact 面另写一套
1972
+ # 「.md 计数相等」,两套判据对同一个问题(「这份快照可信吗」)各答
1973
+ # 各的,且 compact 还会把当前指纹盖到陈旧快照上把指纹判据一起抹掉。
1974
+ if not self._snapshot_trusted(idx):
1505
1975
  idx = None
1506
1976
  if idx is None:
1507
1977
  idx = {"schema": SCHEMA, "nodes": self._scan_nodes(), "buckets": {}}
@@ -1600,22 +2070,35 @@ class MdCG:
1600
2070
  parts.append((fn, s.st_size, s.st_mtime_ns))
1601
2071
  return (snap, tuple(parts))
1602
2072
 
1603
- # 生效条件:self._dirty.staged_stat 中无该 nid 的见证、或 self._dirty[nid] 非含非空 path 的 dict 时返回 False;有见证时对 root/path 再 stat 一次——OSError(文件已不在,标脏时在)返回 True,成功则返回 (st_mtime_ns, st_size) 与见证不等的布尔(不等即 True)。
2073
+ # 生效条件:self._dirty.staged_stat 中无该 nid 的见证、或 self._dirty[nid] 非含非空 path 的 dict 时返回 False;有见证时对 root/path 再 stat 一次——OSError(文件已不在,标脏时在)返回 True;成功且 (st_mtime_ns, st_size) 与见证不等时返回 True;两者相等时再比整文件 sha256(见证第三元)——不等返回 True、相等返回 False;见证第三元为 None(登记时内容读不到)或当前内容读不到时返回 False(证不出陈旧即放行)。
1604
2074
  def _dirty_entry_superseded(self, nid) -> bool:
1605
2075
  """本实例 `_dirty[nid]` 是否**已被盘面更新盖过**(N230:旧不得盖新)。
1606
2076
 
1607
- 判据是**节点文件的逐字见证**:标脏那一刻记下 `(st_mtime_ns, st_size)`,
1608
- 重放前再 stat 一次;不相等 ⇒ 盘面已被他进程改写过 ⇒ 本实例这条是旧的,
1609
- 重放必须放行盘面(`_maybe_reload_index` 据此跳过本条)。
2077
+ 判据是**节点文件的逐字见证**:标脏那一刻记下
2078
+ `(st_mtime_ns, st_size, 整文件 sha256 前 16 位)`,重放前再看一次;
2079
+ 任何一项不等 ⇒ 盘面已被他进程改写过 ⇒ 本实例这条是旧的,重放必须
2080
+ 放行盘面(`_maybe_reload_index` 据此跳过本条)。
2081
+
2082
+ 四级判定(#80 之后):
2083
+ ① (mtime_ns, size) 不等 ⇒ True(零额外 IO,与旧判据逐位一致);
2084
+ ② 两者相等 ⇒ 比内容哈希,不等 ⇒ True(**#80 补的就是这一级**);
2085
+ ③ 见证第三元为 None(登记时读不到内容)或当前读不到 ⇒ False(证不出);
2086
+ ④ 哈希相等 ⇒ False(盘面确未变,照旧重放本实例这条)。
1610
2087
 
1611
2088
  三条边界(都是有意的):
1612
2089
  · **证不出陈旧就不当陈旧**:无见证(无 path / stat 失败 / `_dirty` 未挂
1613
- root)返回 False ⇒ 照旧重放——「本实例未落盘写入不因重载从检索面消失」
2090
+ root / 内容读不到)返回 False ⇒ 照旧重放——「本实例未落盘写入不因重载从检索面消失」
1614
2091
  这条既有不变量优先于本缺陷的覆盖面。
1615
2092
  · **tombstone(`None`)不走本判据**:`_unstage` 立即 flush(删除不延迟到
1616
2093
  autoflush 阈值),故 tombstone 实际上极少跨重载存活;其语义一字不改。
1617
- · **同内容改写**:他进程用同样的字节重写(size 同)时 mtime_ns 仍会变,
1618
- 故仍判陈旧——放行的盘面条目与本条同义,结果无差。
2094
+ · **同内容改写**:他进程用同样的字节重写时 mtime_ns 通常仍会变 ⇒ ① 即判
2095
+ 陈旧——放行的盘面条目与本条同义,结果无差(此路径仅为保守性保留,
2096
+ 正确性不再依赖它)。
2097
+
2098
+ **#80(2026-10-09)**:旧判据只到 ① 为止,其原注释断言「改写内容必然改
2099
+ mtime_ns」,被实测证伪(见 `_note_witness`):等长改写 + mtime 被还原时
2100
+ ① 不成立、旧判据直接返回 False ⇒ **旧写盖新写并随 flush 持久化**。
2101
+ ②③④ 即为此补的字节级身份判定。
1619
2102
  """
1620
2103
  st = self._dirty.staged_stat.get(nid)
1621
2104
  if st is None:
@@ -1624,11 +2107,22 @@ class MdCG:
1624
2107
  p = e.get("path") if isinstance(e, dict) else None
1625
2108
  if not p:
1626
2109
  return False
2110
+ fp = os.path.join(self.root, p)
1627
2111
  try:
1628
- cur = os.stat(os.path.join(self.root, p))
2112
+ cur = os.stat(fp)
1629
2113
  except OSError:
1630
2114
  return True # 标脏时文件在、现在不在 ⇒ 盘面确已变
1631
- return (cur.st_mtime_ns, cur.st_size) != st
2115
+ if (cur.st_mtime_ns, cur.st_size) != (st[0], st[1]):
2116
+ return True # ① 快路径:时间戳/长度任一变化即陈旧
2117
+ # #80:② 双双相等**不足以定身份**——mtime 可被还原工具与粗粒度文件系统
2118
+ # 抹平,故比内容哈希(身份最终由字节定,不由时间戳定)。
2119
+ old = st[2] if len(st) > 2 else None
2120
+ if old is None:
2121
+ return False # ③ 登记时读不到内容 ⇒ 证不出陈旧,放行
2122
+ cur_digest = _file_digest(fp)
2123
+ if cur_digest is None:
2124
+ return False # ③ 现在读不到 ⇒ 证不出陈旧,放行
2125
+ return cur_digest != old # ④ 字节相同 ⇒ 盘面确未变
1632
2126
 
1633
2127
  # 生效条件:stat 对比 _index_signature() 与 self._index_sig,相等(含双侧 None)即返回 False 不做任何事;不等则调 _load_index() 重载,OSError/ValueError 时静默放弃并返回 False(重载失败不阻塞读,沿用旧内存态);成功后把 self._dirty 重放回新索引(None=tombstone pop、否则覆盖,与 _load_index 的日志重放同语义——本实例未 flush 的写入不得因重载从检索面消失;N230:见证失配者判为陈旧,**跳过重放**并计入 self._dirty_replay_superseded)并重算 buckets,替换 self.index、刷新 self._index_sig、返回 True;
1634
2128
  def _maybe_reload_index(self):
@@ -1674,6 +2168,9 @@ class MdCG:
1674
2168
  # 照旧重放(见 _note_witness 的「证不出陈旧就不当陈旧」)。
1675
2169
  if self._dirty_entry_superseded(nid):
1676
2170
  superseded += 1
2171
+ # issue #80 残留面(C 案):跳过重放**且打标记**——否则本条会随
2172
+ # 随后的 flush 落进分片日志,compact 再固化进 _index.json(旧盖新)。
2173
+ self._dirty.superseded_ids.add(nid)
1677
2174
  continue
1678
2175
  idx["nodes"][nid] = e
1679
2176
  self._dirty_replay_superseded = superseded
@@ -1728,15 +2225,77 @@ class MdCG:
1728
2225
  continue
1729
2226
  return fp
1730
2227
 
1731
- # 生效条件:遍历 LAYERS 各层目录树(os.walk,不读文件内容),统计文件名以 ".md" 结尾的文件总数并返回。
1732
- def _count_md_files(self):
1733
- """盘面 .md 文件计数(不 open/不解析)——compact 写快照前的账本对账。"""
1734
- n = 0
2228
+
2229
+ # 生效条件:idx 为快照候选(dict)时——其 "_fingerprint" 为真值且等于 self._dir_fingerprint()(当前盘面目录树指纹)返回 True;非 dict / 无该键 / 该键为 None / 指纹不符一律 False;恒不写盘。
2230
+ def _snapshot_trusted(self, idx):
2231
+ """「这份快照**可信**吗」的**唯一**判定(issue #409 收口)。
2232
+
2233
+ **判据本体只此一处**:装载面 `_load_index` 与落盘面 `compact_index`
2234
+ 都只调本函数,不得各自内联一份(本仓在
2235
+ `_usable_index_snapshot`(N225 准入闸)与 `_apply_log`(N225 重放)
2236
+ 上已有「把 load/compact 的共用判据收成单点」的先例,本条延续同一形态,
2237
+ 不是新立机制)。
2238
+
2239
+ 回答的问题是**新鲜度**:快照写入后盘面**目录树**是否变过。变过(指纹
2240
+ 不符)⇒ 该快照的「节点→path」映射可能已不是当前盘面的事实(改名/
2241
+ 换目录/对调/删一加一都不改 .md 计数,却都改映射)。边界与
2242
+ `_dir_fingerprint` 同源:**同目录内容级改写**(不动文件名)不触发,
2243
+ 属非合作写者协议外(见该方法 docstring)。
2244
+
2245
+ **不回答**「写完这份快照是否安全」——那是另一个问题,另有其判据
2246
+ `_covers_disk`(完整性/覆盖性)。两个判据**互不调用**:把完整性塞进
2247
+ 本函数就又把两套口径并成一套、重新长出 #409 的根因。
2248
+ """
2249
+ if not isinstance(idx, dict):
2250
+ return False
2251
+ fp = idx.get("_fingerprint")
2252
+ return fp is not None and fp == self._dir_fingerprint()
2253
+
2254
+
2255
+ # 生效条件:遍历 LAYERS 各层目录树(os.walk,不读文件内容)时,返回盘面全部 .md 相对 root 的路径**集合**(正斜杠归一——与 _scan_nodes/_node_entry 落进条目 path 的口径逐字一致);恒不写盘。
2256
+ def _md_rel_paths(self):
2257
+ """盘面 .md 相对路径集合(不 open/不解析)——完整性判据的**盘面一侧**。"""
2258
+ out = set()
1735
2259
  for layer in LAYERS:
1736
2260
  base = os.path.join(self.root, layer)
1737
- for _dp, _dirs, files in os.walk(base):
1738
- n += sum(1 for fn in files if fn.endswith(".md"))
1739
- return n
2261
+ for dirpath, _dirs, files in os.walk(base):
2262
+ for fn in files:
2263
+ if fn.endswith(".md"):
2264
+ out.add(os.path.relpath(os.path.join(dirpath, fn),
2265
+ self.root).replace("\\", "/"))
2266
+ return out
2267
+
2268
+
2269
+ # 生效条件:nodes 为映射(元素为 dict 时取其 "path")时——索引侧 path 集合(反斜杠归一、空值丢弃)与 self._md_rel_paths() **集合相等**,且 len(nodes) == 盘面 .md 文件数,返回 True;否则 False;恒不写盘、不抛(元素非 dict 不计入路径侧,由条数不等兜住)。
2270
+ def _covers_disk(self, nodes):
2271
+ """「写完这份快照**安全**吗」的判定(issue #409)——**不是**「可信吗」。
2272
+
2273
+ 与 `_snapshot_trusted` 分工(两者互不调用):
2274
+ · `_snapshot_trusted`:我**能不能读**这份旧快照(新鲜度);
2275
+ · 本函数:我写出去的这份 nodes **是否恰好描述当前盘面**(完整性)。
2276
+
2277
+ 判据 = **索引路径集合 == 盘面 .md 路径集合**(外加条数相等)。这是
2278
+ 原来那条「`.md` 计数相等」的 **sound 版**:集合相等 ⇒ 计数相等,反之
2279
+ 不然——#409 的全部形态(改名、换目录、两文件对调、外部删一加一、
2280
+ 他实例写已落盘而索引增量还在其 `_dirty`)都恰好是「计数没变而路径
2281
+ 变了」,计数判据**必然假阳**。反向也覆盖:幽灵条目(索引有、盘上无)
2282
+ 与「在盘上但索引里没有」同时出现时,计数相等同样骗过旧判据,集合
2283
+ 判据两边都能看见。
2284
+
2285
+ 不过闸 ⇒ 宁重扫(`_scan_nodes` 为唯一真源判据),与 `_load_index` 的
2286
+ 兜底同向:**缺账快照会被重开路径的指纹校验放行,节点从此不可见**。
2287
+ """
2288
+ disk = self._md_rel_paths()
2289
+ paths = {str(e.get("path") or "").replace("\\", "/")
2290
+ for e in nodes.values() if isinstance(e, dict)}
2291
+ paths.discard("")
2292
+ return len(nodes) == len(disk) and paths == disk
2293
+
2294
+
2295
+ # 生效条件:遍历 LAYERS 各层目录树(os.walk,不读文件内容),统计文件名以 ".md" 结尾的文件总数并返回(= len(self._md_rel_paths()):计数与路径集合同源,不写第二份走查)。
2296
+ def _count_md_files(self):
2297
+ """盘面 .md 文件计数(不 open/不解析)——compact 写快照前的账本对账。"""
2298
+ return len(self._md_rel_paths())
1740
2299
 
1741
2300
  @staticmethod
1742
2301
  # 生效条件:nodes 须为带 values() 的映射且各元素支持 .get("bucket");仅当 bucket 取值为真值时才计入返回计数,缺键或假值均跳过。
@@ -1748,7 +2307,7 @@ class MdCG:
1748
2307
  buckets[b] = buckets.get(b, 0) + 1
1749
2308
  return buckets
1750
2309
 
1751
- # 生效条件:os.path.exists(self.index_path) 为真、JSON 可解析、解析结果为 dict(顶层非对象视同损坏)且 "schema" 等于 SCHEMA 时以该快照为基底;快照不存在用空骨架 {"schema":SCHEMA,"nodes":{},"buckets":{}}(不重扫目录);快照损坏(ValueError/OSError)、顶层非对象或 schema 不符时降级以 self._scan_nodes() 全库扫描结果为基底(宁重扫勿清池);基底确定后经 self._apply_log 对 index_log_dir 逐条重放(N225 补强:与 _load_index **同一实现**——无 id 跳过、e 为 None 则 pop、e 非 dict 且非 None 则跳过并记账、其余覆盖;对账触发重扫后同一实现叠回干净扫描之上),落盘并清空日志后替换 self.index、刷新 _index.json 签名(P1b-2 自写不自载)并返回 idx;
2310
+ # 生效条件:os.path.exists(self.index_path) 为真、JSON 可解析、解析结果为 dict(顶层非对象视同损坏)且 "schema" 等于 SCHEMA 且 self._snapshot_trusted(该快照) 为真时以该快照为基底;快照不存在用空骨架 {"schema":SCHEMA,"nodes":{},"buckets":{}}(不重扫目录);快照损坏(ValueError/OSError)、顶层非对象、schema 不符或**指纹不符(#409)**时不作基底——损坏/schema 不符降级 self._scan_nodes() 全库扫描(宁重扫勿清池),仅指纹不符改以本进程内存索引 self.index["nodes"] 的副本为基底;基底确定后经 self._apply_log 对 index_log_dir 逐条重放(N225:与 _load_index **同一实现**),随后**重放之前**过**完整性闸** self._covers_disk(#409:基底路径集合 == 盘面 .md 路径集合且条数相等;**闸在重放之前**——日志条目按合作写者协议是权威写入记录、允许指向盘外路径,见守卫 E3/E6),不过即以 self._scan_nodes() 换基底(宁重扫勿写缺账快照),再对最终基底**恰好重放一次**;落盘(_fingerprint 恒为 self._dir_fingerprint(),**只在过闸之后**写)并清空日志后替换 self.index、刷新 _index.json 签名(P1b-2 自写不自载)并返回 idx;
1752
2311
  def compact_index(self):
1753
2312
  with FileLock(self.index_path):
1754
2313
  idx = {"schema": SCHEMA, "nodes": {}, "buckets": {}}
@@ -1757,7 +2316,7 @@ class MdCG:
1757
2316
  try:
1758
2317
  with open(self.index_path, encoding="utf-8") as f:
1759
2318
  d = json.load(f)
1760
- if not isinstance(d, dict):
2319
+ if not _usable_index_snapshot(d):
1761
2320
  # N225(2026-09-29):顶层非对象(合法 JSON 但非对象)
1762
2321
  # 与下面两条**同一口径**——视同损坏,走 scan_fallback
1763
2322
  # 全库扫描(宁重扫勿清池)。不这样收口,裸调 d.get 的
@@ -1779,19 +2338,48 @@ class MdCG:
1779
2338
  idx = {"schema": SCHEMA, "nodes": self._scan_nodes(),
1780
2339
  "buckets": {}}
1781
2340
 
2341
+ # #409(P0):**盘上快照只有过 _snapshot_trusted 才可作基底**。
2342
+ # 此前 compact 无条件把盘上那份快照当基底(只比 .md 计数),而
2343
+ # 「净 .md 计数为零」的变化(库外改名 / 换目录 / 两文件内容对调 /
2344
+ # 删一加一 / 另一实例已落盘而其索引增量还在它自己的 _dirty 里)
2345
+ # 都能让计数判据给出**假阳** ⇒ 陈旧映射被原样保留,收尾那行再把
2346
+ # **当前**指纹盖上去 ⇒ 下一次打开指纹相符、不重扫 ⇒ 陈旧映射被
2347
+ # 当真源(get(id) 返回**别人的正文**;一次普通写回后别人的正文
2348
+ # 全库无副本——只有全量 rebuild_index 能救)。
2349
+ # 判据同源:与 _load_index 调**同一个** _snapshot_trusted(「这份
2350
+ # 快照可信吗」的唯一判定);不可信的旧快照**不作基底**,改吃本
2351
+ # 进程内存索引——它装载时已过同一判据(或已重扫),运行期由写
2352
+ # 路径维护,比一份自己都判不可信的盘上快照更可信。**不**采用
2353
+ # 「不可信一律重扫」:正常 close 路径里「本进程刚写过文件」必然
2354
+ # 使盘上快照指纹失配,一律重扫会退化成每次 close 全库重扫——
2355
+ # 正是 issue #33 要避免的代价。
2356
+ if not scan_fallback and not self._snapshot_trusted(idx):
2357
+ idx = {"schema": SCHEMA,
2358
+ "nodes": dict(self.index.get("nodes") or {}),
2359
+ "buckets": {}}
2360
+
2361
+ # #409:基底确定后、**重放之前**先过完整性闸。**这是另一个问题**——
2362
+ # 「写完这份快照是否安全」(完整性),不是「是否可信」(新鲜度,
2363
+ # 只有 _snapshot_trusted 一条,两者互不调用)。判据由「.md **计数**
2364
+ # 相等」升级为「索引**路径集合** == 盘面 .md 路径集合」:集合相等
2365
+ # ⇒ 计数相等,反之不然;#409 的全部形态恰好是「计数没变而路径变了」
2366
+ # (改名/换目录/对调),或同时造出幽灵与不可见(删一加一),计数
2367
+ # 判据必然假阳。不过闸 ⇒ 宁重扫(_scan_nodes 是唯一真源判据),与
2368
+ # _load_index 的兜底同向:缺账快照会被重开路径的指纹校验放行,
2369
+ # 节点从此「在盘上但不可见」。
2370
+ # **闸在重放之前**(不是之后):闸问的是「我拿到的这份**基底**是否
2371
+ # 恰好描述当前盘面」;增量日志是**权威写入记录**(合作写者协议),
2372
+ # 其条目本就允许指向盘外路径(N225 守卫 E3/E6 钉死「合法 upsert 仍
2373
+ # 生效」),拿重放后的结果去比盘面会把日志的正确性误判成基底不完整,
2374
+ # 并多付一次重放(守卫 E6 的记账面会立刻转红)。
2375
+ if not scan_fallback and not self._covers_disk(idx["nodes"]):
2376
+ idx = {"schema": SCHEMA, "nodes": self._scan_nodes(),
2377
+ "buckets": {}}
2378
+
1782
2379
  # N225 补强(2026-09-29):重放改为 self._apply_log——与 _load_index
1783
2380
  # **同一实现**(此处原有的一份同源循环删除,口径不可能再漂开)。
2381
+ # 重放**恰好一次**(重扫分支也只重放一次:先换基底、后统一重放)。
1784
2382
  self._apply_log(idx["nodes"])
1785
- if not scan_fallback and self._count_md_files() != len(idx["nodes"]):
1786
- # 计数对账(issue #33):快照+日志账本与盘面不符——其它存活
1787
- # 实例未 flush 的写入(文件已落盘、索引增量还在其 _dirty)
1788
- # 或外部增删文件。宁重扫勿写缺账快照:缺账快照会被重开
1789
- # 路径的指纹校验放行,节点从此「在盘上但不可见」。
1790
- # 与 _load_index 的指纹兜底双保险:此处保快照**完整**,
1791
- # 指纹保快照**新鲜**。
1792
- idx = {"schema": SCHEMA,
1793
- "nodes": self._apply_log(self._scan_nodes()),
1794
- "buckets": {}}
1795
2383
  idx["buckets"] = self._count_buckets(idx["nodes"])
1796
2384
  idx["_fingerprint"] = self._dir_fingerprint()
1797
2385
  atomic_write(self.index_path, json.dumps(idx, ensure_ascii=False))
@@ -1827,6 +2415,10 @@ class MdCG:
1827
2415
  # 追加会被自家探活当成他进程变化(多线程下白重载一次)。
1828
2416
  self._own_shard = self._log.path
1829
2417
  for nid, e in self._dirty.items():
2418
+ # issue #80 残留面(C 案):被判定陈旧(重放时已放行盘面)的条目
2419
+ # **不得**落分片日志——落了就成『索引侧旧盖新』且跨重启存活。
2420
+ if nid in self._dirty.superseded_ids:
2421
+ continue
1830
2422
  self._log.append({"id": nid, "e": e})
1831
2423
  self._dirty.clear() # 保住 _DirtyDict 钩子(批次 23 D-4:不得换新 dict)
1832
2424
  # 写完立即关分片句柄:Windows 上「被本进程打开的文件」无法删除,
@@ -1893,11 +2485,22 @@ class MdCG:
1893
2485
  # issue #33:中文别名入快照(fm 派生,与写入路径同口径)——
1894
2486
  # S1b 跨语言收敛免读文件可判。
1895
2487
  "bucket_zh": fm.get("bucket_zh") or None,
2488
+ # 2026-10-18(gap_cs_not_indexed):条件空间入快照。
2489
+ # 此前索引 42 键不含该字段,生产库 31139 节点中索引带它者为 0——
2490
+ # 检索面拿到的条目先天没有条件空间,P0-5 的 legacy 姿态因此无法在
2491
+ # 装配层判定(只能逐条读文件)。字段体量约 +8.5%(43MB → ~47MB),
2492
+ # 换来检索期免读盘。存量需一次 rebuild_index 才补齐(见文档)。
2493
+ "condition_space": fm.get("condition_space") or None,
1896
2494
  "importance": fm.get("importance", 0.5),
1897
2495
  # issue50-d(2026-10-02):重要度**来源**入快照("hint"|"heuristic",
1898
2496
  # 旧库无此键 → None)——「这条 0.8 是显式声明还是启发式分」免读
1899
2497
  # 文件可判(与既有扁平键同理由:检索期/审计期不读盘)。
1900
2498
  "importance_source": fm.get("importance_source"),
2499
+ # #417(2026-10-16):把「本节点合并过哪些来源 id」入快照——
2500
+ # twophase 恢复期在**新实例**上判「已合并落盘」必须免读文件可见
2501
+ # (与 merge_sources 同款纪律:写路径同钩镜像 + 重建面同口径,
2502
+ # 漏登记则 rebuild/_scan_nodes 之后该键整类消失、判据静默失效)。
2503
+ "merge_source_ids": fm.get("merge_source_ids") or None,
1901
2504
  "created_at": fm.get("created_at", 0),
1902
2505
  "verification_basis": fm.get("verification_basis"),
1903
2506
  # 多主体世界模型对齐 v0.1(L1):检验强度入快照(与写入路径 _stage
@@ -1963,9 +2566,19 @@ class MdCG:
1963
2566
  "derived_relation": fm.get("derived_relation"),
1964
2567
  })
1965
2568
 
1966
- # 生效条件:遍历模块级 LAYERS 各层目录下所有 .md 文件,读取抛 OSError 的跳过;nid 取 fm.get("id"),为假值时回落去掉 .md 的文件名;条目经 self._node_entry(p, layer, fm, content) 构造;返回按 nid 排序的 nodes;
2569
+ # 生效条件:遍历模块级 LAYERS 各层目录下所有 .md 文件,读取抛 OSError 的跳过;nid 取 fm.get("id"),为假值时回落去掉 .md 的文件名;fm 经 nodefile.frontmatter_problem 判为损坏(类型非法)或 self._node_entry(p, layer, fm, content) 抛异常者**一律隔离**(记入 self._quarantined,路径 + 原因),不进索引、不改盘、continue;其余条目经 self._node_entry(p, layer, fm, content) 构造;返回按 nid 排序的 nodes;
1967
2570
  def _scan_nodes(self):
1968
2571
  nodes = {}
2572
+ # issue #146①:**坏文件隔离面**。修前只有「读文件」在 try 内,
2573
+ # `nodes[nid] = self._node_entry(...)` 在 try **之外**——一个手改坏了
2574
+ # frontmatter 的节点(漏 `}` ⇒ condition_space 成 str ⇒ `_node_entry`
2575
+ # 的 `(fm.get("condition_space") or {}).get(...)` 抛 AttributeError)
2576
+ # 会把异常送出 `MdCG.__init__`:整库打不开、MCP 服务起不来(一个坏
2577
+ # 文件炸全库)。隔离口径:坏文件**不进索引、不改盘**(盘面是唯一真相
2578
+ # 源,重建索引是派生物,绝不因读不动而回写),其余节点照常可用。
2579
+ # 隔离清单经 self._quarantined 透出到 health / op=info(仅确有隔离时
2580
+ # 出键,健康库键集逐位不变)。
2581
+ quarantined = {}
1969
2582
  for layer in LAYERS:
1970
2583
  base = os.path.join(self.root, layer)
1971
2584
  for dirpath, _dirs, files in os.walk(base):
@@ -1992,7 +2605,36 @@ class MdCG:
1992
2605
  # 写面(add)对非字符串 node_id 已 fail-closed 拒写,此处
1993
2606
  # 只兜盘面既有脏数据——拒写与自愈各司其职。
1994
2607
  nid = str(nid)
1995
- nodes[nid] = self._node_entry(p, layer, fm, content)
2608
+ _rel = os.path.relpath(p, self.root).replace("\\", "/")
2609
+ # ①' 密级行**值域**判据(issue #146③,fail-closed):类型判据只看
2610
+ # 「是不是 str」,值域判据看「是不是阶梯里的档」——密级声明
2611
+ # 坏掉的节点若被当默认档消费,等于**静默降级为明文**;故与
2612
+ # ① 同路隔离(不进索引、不改盘,修好后下次扫描自动回归)。
2613
+ _sec_bad = _sensitivity_problem(fm.get("sensitivity"))
2614
+ if _sec_bad:
2615
+ quarantined[nid] = {"path": _rel, "reason": _sec_bad}
2616
+ continue
2617
+ # ① 类型可用性判据(单点,nodefile.frontmatter_problem)
2618
+ _prob = nodefile.frontmatter_problem(fm, content)
2619
+ if _prob:
2620
+ quarantined[nid] = {"path": _rel,
2621
+ "reason": "frontmatter 损坏:" + ";".join(_prob)}
2622
+ continue
2623
+ # ② 判据之外仍可能抛(下游消费面比类型判据更宽)——兜底
2624
+ # 收口在此,异常**不得**逃出装载路径(#146①的根因)。
2625
+ try:
2626
+ nodes[nid] = self._node_entry(p, layer, fm, content)
2627
+ except Exception as exc: # noqa: BLE001
2628
+ quarantined[nid] = {
2629
+ "path": _rel,
2630
+ "reason": "索引条目构造失败:%s: %s"
2631
+ % (type(exc).__name__, str(exc)[:160])}
2632
+ continue
2633
+ # 隔离清单**每次全量扫描都重建**(不累加)——扫描即盘面真相,上一次
2634
+ self._quarantined = quarantined
2635
+ _warn_quarantined(quarantined)
2636
+ # 被隔离的文件修好后本次自动回归索引(自愈腿,与 legacy P3 同向)。
2637
+ self._quarantined = quarantined
1996
2638
  # 索引序确定性:按 nid 排序返回。os.walk 的遍历序是**文件系统事实**
1997
2639
  # (NTFS 上常为字母序,但换 FS / 目录碎片化后不保证),若直接作为
1998
2640
  # index["nodes"] 的物理序,就会让「完全并列」的结果顺序依赖重建路径。
@@ -2000,6 +2642,22 @@ class MdCG:
2000
2642
  return {k: nodes[k] for k in sorted(nodes)}
2001
2643
 
2002
2644
  # 生效条件:每次调用都以 self._scan_nodes() 的结果重建 nodes 与 buckets 并附 _dir_fingerprint(),在 FileLock 下 atomic_write 覆盖 index_path 并 ShardedLog.clear(index_log_dir),随后替换 self.index、刷新 _index.json 签名(P1b-2 自写不自载)、清空 _dirty 并返回 idx(无 .md 时也照样覆盖为空索引);
2645
+ def _cache_generation(self):
2646
+ """O(1) generation for metadata writes and replaced node snapshots.
2647
+
2648
+ Strong references and identity comparisons avoid mapping equality scans
2649
+ and object-id reuse. All supported writes advance _dirty.write_gen;
2650
+ rebuild/reload may instead replace the nodes mapping.
2651
+ """
2652
+ nodes, dirty = self.index.get("nodes"), self._dirty
2653
+ version = getattr(dirty, "write_gen", None)
2654
+ previous = getattr(self, "_cache_generation_state", None)
2655
+ if (previous is None or previous[0] is not nodes
2656
+ or previous[1] is not dirty or previous[2] != version):
2657
+ self._cache_generation_value = getattr(self, "_cache_generation_value", 0) + 1
2658
+ self._cache_generation_state = (nodes, dirty, version)
2659
+ return self._cache_generation_value
2660
+
2003
2661
  def rebuild_index(self):
2004
2662
  nodes = self._scan_nodes()
2005
2663
  idx = {"schema": SCHEMA, "nodes": nodes,
@@ -2071,12 +2729,13 @@ class MdCG:
2071
2729
 
2072
2730
  # ---------- 写 ----------
2073
2731
 
2074
- # 生效条件:node_id/content 必填;node_id 不匹配 _NODE_ID_RE(^[A-Za-z0-9_.@-]{1,128}$)或含 ".."、或整串精确等值于 _NODE_ID_FORBIDDEN("None"/"null",空语义值字符串化污染形态,P3 None.md 缺陷禁写)、或落盘 realpath 越出 self.root 时抛 ValueError(P0-1 白名单+纵深闸);layer 不在 LAYERS 内、或 verification_basis 非 None 且不在 VERIFICATION_BASIS 内时抛 ValueError;consistency 为真且 _cons.check 判 REJECT 时,on_conflict="reject" 抛 ConsistencyError、on_conflict="defer" 返回 None,verdict 为 BLINDSPOT 且 on_conflict="defer" 同样返回 None,其余情形完成写盘/入索引后返回 node_id。
2732
+ # 生效条件:node_id/content 必填;node_id 不匹配 _NODE_ID_RE(^[A-Za-z0-9_.@-]{1,128}$)或含 ".."、或整串精确等值于 _NODE_ID_FORBIDDEN("None"/"null",空语义值字符串化污染形态,P3 None.md 缺陷禁写)、或落盘 realpath 越出 self.root 时抛 ValueError(P0-1 白名单+纵深闸);layer 不在 LAYERS 内、或 verification_basis 非 None 且不在 VERIFICATION_BASIS 内时抛 ValueError;consistency 为真且 _cons.check 判 REJECT 时,on_conflict="reject" 抛 ConsistencyError、on_conflict="defer" 返回 None;判 BLINDSPOT(comparable==0,检测前提不存在)时**恒放行**(与 writepipe._gate_consistency 的 issue #26 同口径,落盘并把 vd 并进 extra["consistency"]);其余情形完成写盘/入索引后返回 node_id;consistency_out 为 dict 时把本次判定回填 consistency_out["consistency"](#361:三条出口都可追溯)。
2075
2733
  def add(self, node_id: str, content: str, layer: str = "knowledge",
2076
2734
  tags=None, condition_space=None, importance: float = 0.5,
2077
2735
  confidence: float = 0.6, edges=None, verification_basis: str = None,
2078
2736
  non_applicable_conditions=None, override: bool = False,
2079
2737
  consistency: bool = False, on_conflict: str = "reject",
2738
+ consistency_out: dict = None,
2080
2739
  derived_from=None, relation: str = provenance.DEFAULT_RELATION,
2081
2740
  semantic: str = None, depends_on=None, valid_from=None,
2082
2741
  valid_until=None, effective_from=None, effective_until=None,
@@ -2092,7 +2751,9 @@ class MdCG:
2092
2751
  non_applicable_conditions: 不适用条件列表,第 1 篇第 10 章 28%→88% 的关键。
2093
2752
  consistency: 是否做节点间自动冲突检测(三级决策:情绪→反思→递归反思)。
2094
2753
  on_conflict: 冲突处置——"reject" 抛 ConsistencyError(默认)/
2095
- "defer" 不写盘返回 None / "record" 记录后放行。
2754
+ "defer" 不写盘返回 None——**仅对已判定的冲突(REJECT)生效**;
2755
+ BLINDSPOT(检测前提不存在,空库上恒真)恒放行(#361)/
2756
+ "record" 记录后放行。
2096
2757
  derived_from:(G8 派生溯源)本节点来源节点 id,单个或列表。声明后写进
2097
2758
  frontmatter(单一真相源)并追加派生边到 <root>/_link.jsonl;
2098
2759
  **建链失败不阻断本次写入**(降级为告警 + .fail 台账留痕)。
@@ -2119,6 +2780,11 @@ class MdCG:
2119
2780
  真源 trust.py)。**覆写既有节点时默认继承**——add 是全量重建
2120
2781
  fm,不显式继承会把已 verified 静默打回 unverified(与
2121
2782
  lifecycle_state 同构的坑);显式传入则走迁移裁决,非法即拒。
2783
+ 例外(issue #352 §B):既有态为 verified、**正文变了**、且本次
2784
+ 写方无 verify 权限(`Principal.allows_op("verify")` 为假,与
2785
+ #320 同一判据)时,缺省继承落 doubted——否则无 verify 权限的
2786
+ 改写会把验证标带进新正文(#320 的闸只看入参,看不见这条继承
2787
+ 路)。有 verify 权限的写方与裸库照旧继承(既有语义零变化)。
2122
2788
  check_strength: 检验强度(hoop/smoking_gun/doubly_decisive,真源
2123
2789
  nodefile.CHECK_STRENGTHS)——与 verification_basis(来源**类型**)
2124
2790
  正交的**裁决力**分级(多主体世界模型对齐 v0.1 §2 L1)。
@@ -2167,6 +2833,23 @@ class MdCG:
2167
2833
  f"非法 node_id:{node_id!r}(空语义值的字符串化污染形态 "
2168
2834
  f"{sorted(_NODE_ID_FORBIDDEN)} 禁写——会落盘成 None.md 参与检索"
2169
2835
  f"(DSH 在役库实测缺陷 P3);fail-closed,如为合法业务 id 请改名)")
2836
+ # issue #151②(2026-10-12 DSH 端):**数值有限性 + 范围守卫**(范式抄
2837
+ # `reach._ttl()`:非有限视同非法)。子类 `mdcos.MdCGOS.add` 早已有
2838
+ # 回落式守卫(#151a),但**基类 `MdCG.add` 仍裸存**——直接实例化
2839
+ # `MdCG`(bench/迁移/脚本/测试面大量存在)填 `importance=inf` 会:
2840
+ # · `float("inf") >= protect.AUTO_PROTECT_IMPORTANCE` 恒真 ⇒ 节点被
2841
+ # 打上**不可遗忘保护**且永久霸榜(inf 参与任何加权相乘仍是 inf);
2842
+ # · 填 `nan` 则 `nan >= x` 恒假、`nan` 参与排序恒 False ⇒ 结果不可
2843
+ # 复现(同一查询两次顺序可不同),且事后无法从读数区分。
2844
+ # 处置与基类既有的 node_id/verification_basis 校验同款:**fail-closed
2845
+ # 拒写**(抛结构化 ValueError,点名字段、值、允许域与理由),不静默
2846
+ # 回落——回落会让「填错」看起来像「填对」(与 `_check_sensitivity_landing`
2847
+ # 的「静默回落 = 声明被静默改写」同向)。子类回落守卫在**更上游**,
2848
+ # 故 MdCGOS 的既有语义(非法值回落文档缺省)一字不变。
2849
+ # 判据单点在模块级 `_require_unit_number`(同仓单点判据纪律:判据只写
2850
+ # 一份,写侧读侧共用;守卫可对其做定点变异自证)。
2851
+ _require_unit_number("importance", importance)
2852
+ _require_unit_number("confidence", confidence)
2170
2853
  if verification_basis is not None and verification_basis not in VERIFICATION_BASIS:
2171
2854
  raise ValueError(f"未知验证基底:{verification_basis}(允许:{VERIFICATION_BASIS})")
2172
2855
  if check_strength is not None and check_strength not in CHECK_STRENGTHS:
@@ -2188,6 +2871,50 @@ class MdCG:
2188
2871
  # 签名未变时只有一次 stat(微秒级);自身未 flush 的写入由
2189
2872
  # `_maybe_reload_index` 的 _dirty 重放保住(与读路径同款语义)。
2190
2873
  self._maybe_reload_index()
2874
+ # issue #350(2026-10-16 DSH 端):**大小写折叠查重**。节点文件名就是
2875
+ # node_id,而「已存在/受保护/原密级」全部按区分大小写的索引键判断——在
2876
+ # 大小写不敏感文件系统(Windows NTFS、macOS APFS 默认卷)上,
2877
+ # User_Identity.md 与 user_identity.md 是同一个文件:写入 user_identity
2878
+ # 会被当成**新节点**,保护闸/冻结副本/跨层闸/#297 密级继承全部不生效,
2879
+ # os.replace 直接把先写者整份换掉,回执 ok:true,重启后先写者从库里
2880
+ # 消失且库根无任何副本(项目方 Windows 实测命中缺陷 3/3,与报告模拟组一致)。
2881
+ # 口径:**所有平台都拒**(报告建议并请维护者裁定的那条)——库会在机器之间
2882
+ # 同步/拷贝,Linux 上建的库拷到 Windows 会互相顶替;已并存的存量对不受
2883
+ # 影响(对既有 id 的覆写照旧放行,只拦「新 id 与既有 id 只差大小写」)。
2884
+ _nodes350 = self.index.get("nodes") or {}
2885
+ if (node_id not in _nodes350 and isinstance(node_id, str) and node_id):
2886
+ _cf350 = node_id.casefold()
2887
+ # H-4(a):凡从 cg.index 取回的 nodes,迭代前先取快照(tuple)——
2888
+ # 否则他进程并发写会「dictionary changed size during iteration」。
2889
+ _keys350 = tuple(_nodes350)
2890
+ _hit350 = next((k for k in _keys350
2891
+ if isinstance(k, str) and k.casefold() == _cf350), None)
2892
+ if _hit350 is not None:
2893
+ raise ValueError(
2894
+ f"node_id {node_id!r} 与既有节点 {_hit350!r} 只差大小写——"
2895
+ "在大小写不敏感文件系统(Windows NTFS / macOS APFS 默认卷)上"
2896
+ "两者是同一个文件,后写者会整份顶替先写者且不留副本"
2897
+ "(issue #350),拒绝写入。请改用与既有节点完全一致的大小写,"
2898
+ "或换一个不冲突的 id。")
2899
+ # issue #346(2026-10-15 DSH 端):**同层覆写也必须过既有密级闸**。
2900
+ # `MdCGSecure.add` 的层闸只认**调用方声明的** layer/sensitivity(声明
2901
+ # internal 即按 internal 判),下方 N221 只拦**跨层**覆写——同层覆写
2902
+ # 没有任何一处比对「目标原密级 private > 写入者 clearance internal」。
2903
+ # 于是审核通道(accept/edit 落盘、C 类变更单执行、库层直调 add)把
2904
+ # 属主 private 节点整条降密级覆写成 internal 明文:不抛错、原密文无
2905
+ # 副本、无令牌访客可读。MCP 直写面靠 mcp_server 的 write_qualify 拦,
2906
+ # 但 accept 执行链不经过它。判据复用 protect.require_layer 单点(按
2907
+ # **索引里的既有层与密级**判,与直写面 write_qualify / merge 支 N131
2908
+ # 同口径):低 clearance 身份对既有高密级节点的覆写在此 fail-closed,
2909
+ # 拒绝发生在冲突检测 / guard_write / 任何写盘之前,无副作用;裸 MdCG
2910
+ # (无 principal)时该单点本就空转,零回归。属主(clearance 足够)的
2911
+ # 显式降密照旧放行。
2912
+ _ex346 = (self.index.get("nodes") or {}).get(node_id)
2913
+ if _ex346 is not None:
2914
+ protect.require_layer(self, node_id,
2915
+ layer=_ex346.get("layer") or None,
2916
+ sensitivity=_ex346.get("sensitivity") or None,
2917
+ actor=extra.get("actor"))
2191
2918
  protect.guard_write(self, node_id, layer=layer, override=override,
2192
2919
  actor=extra.get("actor"))
2193
2920
  # 节点间自动冲突检测(智能论 §十一 情绪二阶 / 条件论「反题」/ :273 递归约束)
@@ -2196,18 +2923,44 @@ class MdCG:
2196
2923
  vd = _cons.check(self, content, layer=layer,
2197
2924
  condition_space=condition_space,
2198
2925
  non_applicable_conditions=non_applicable_conditions,
2199
- tags=tags, exclude=node_id, auto_flywheel=True)
2926
+ tags=tags, exclude=node_id, auto_flywheel=True,
2927
+ # issue #193:写入面按 EXTRA_SCOPE 并入层外候选
2928
+ # (只读 check 面不变)。
2929
+ write_scope=True,
2930
+ # issue #294:extra["sensitivity"] 是**归一后的
2931
+ # 落盘值**(MdCGSecure.add 算出,含 #297 的既有
2932
+ # 密级继承),正是飞轮该沿用的那个值。
2933
+ sensitivity=extra.get("sensitivity"))
2200
2934
  v = vd["verdict"]
2935
+ # issue #361(2026-10-17 DSH 端):判定**如实回填**给调用方。报告病灶的
2936
+ # 核心是「BLINDSPOT 被丢时返回体无任何去向线索」——回填与后续路由
2937
+ # **解耦**:raise(reject)/ return None(REJECT+defer)/ 放行落盘
2938
+ # 三条出口,调用方都能拿到本次冲突判定的 verdict/reason/comparable。
2939
+ if consistency_out is not None:
2940
+ consistency_out["consistency"] = vd
2201
2941
  if v == "REJECT" and on_conflict == "reject":
2202
2942
  raise _cons.ConsistencyError(v, vd["reason"], vd["conflicts"])
2203
- if v in ("REJECT", "BLINDSPOT") and on_conflict == "defer":
2943
+ # issue #361:**BLINDSPOT 不再按 defer 丢弃**。BLINDSPOT 的唯一来源是
2944
+ # consistency.check 判定序里的 `comparable == 0 and (pos or neg)`——
2945
+ # 既有节点一条条件声明都没有(新库恒真),语义是「检测前提不存在」,
2946
+ # 而 REJECT/DEFER 都排在它**之前**(已判定的冲突/分歧另有其态)。空库上
2947
+ # 若按 defer 一律 return None:既不落盘也不入队、返回体无去向,且库
2948
+ # **永远写不进第一条** ⇒ comparable 恒 0、自我维持(实测《民法典》批量
2949
+ # 200/200 静默丢失)。
2950
+ # 口径与写链 writepipe._gate_consistency(issue #26:BLINDSPOT 恒放行、
2951
+ # REJECT 维持拦截)**同一条**——同一判据不在两条通路上给两个结论。
2952
+ # 故唯一被拦截态收敛到 REJECT。
2953
+ if v == "REJECT" and on_conflict == "defer":
2204
2954
  return None
2205
2955
  extra["consistency"] = {
2206
2956
  "verdict": v, "reason": vd["reason"],
2207
2957
  "strength": vd["conflict_strength"],
2208
2958
  "emotional": (vd.get("emotional") or {}).get("bias"),
2209
2959
  "unresolved_id": vd.get("unresolved_id")}
2210
- tags = list(tags or [])
2960
+ # issue #150:**入口过滤空 tag**——空串 tag 会让 tag_bonus 恒发(`"" in q`)、
2961
+ # 也会污染桶路由键;写入侧先净化,检索侧四处(expand_query_terms/_like/
2962
+ # tag_bonus/负覆盖)另加非空守卫,两侧冗余是刻意的 defense-in-depth。
2963
+ tags = [t for t in _ensure_list(tags) if str(t).strip()]
2211
2964
  # 标准语义摘要(semantic/canonical.py:词表真源 + OOV 审计,警告不拒绝)。
2212
2965
  # 语义校验失败不阻断写入(与 derived_from 建链降级同风格)。
2213
2966
  if semantic is not None:
@@ -2236,7 +2989,7 @@ class MdCG:
2236
2989
  except Exception:
2237
2990
  _bd_pre = None
2238
2991
  if _bd_pre:
2239
- tags = list(tags or [])
2992
+ tags = _ensure_list(tags)
2240
2993
  tags.append("domain:" + str(_bd_pre))
2241
2994
  bucket = None
2242
2995
  d = os.path.join(self.root, layer)
@@ -2279,13 +3032,17 @@ class MdCG:
2279
3032
  "importance": importance, "confidence": confidence,
2280
3033
  "condition_space": cs, "tags": tags,
2281
3034
  "created_at": created_at,
2282
- "access_count": 0, "last_access": 0, "edges": list(edges or []),
3035
+ "access_count": 0, "last_access": 0, "edges": _ensure_list(edges),
2283
3036
  "verification_basis": verification_basis,
2284
- "non_applicable_conditions": list(non_applicable_conditions or []),
3037
+ "non_applicable_conditions": _ensure_list(non_applicable_conditions),
2285
3038
  # 证据计数(白箱第 5 篇第 4 章):每次 verify 累加,正/反例分开记
2286
3039
  "evidence_count": 0, "positive_evidence": 0, "negative_evidence": 0,
2287
3040
  }
2288
3041
  fm.update(extra)
3042
+ # 相对时间锚定(MDCG_TIME_ANCHOR=1,缺省关 ⇒ 零调用、fm 逐位不变):无显式 temporal
3043
+ # 时把正文里的时间表达以 created_at 为参照归一成派生字段 temporal_anchor;解析不了不写。
3044
+ if _timeanchor.enabled():
3045
+ _timeanchor.apply_on_write(fm, content)
2289
3046
  # issue50-d(2026-10-02):重要度**来源**声明("hint"|"heuristic")落
2290
3047
  # frontmatter——下游免读文件即可判「这条 0.8 是显式声明还是闸门启发式
2291
3048
  # 分」。缺省 None 不落键(既有调用方 fm 形态逐位不变,零回归)。
@@ -2344,10 +3101,19 @@ class MdCG:
2344
3101
  # 次序对齐 N131/N209:principal 层闸在先、保护闸在后。
2345
3102
  if prev_entry is not None:
2346
3103
  _prev_layer = str(prev_entry.get("layer") or "")
3104
+ # issue #346(2026-10-17 U05a):**同层覆写**此前零闸——层闸只按调用方
3105
+ # **声明的**值判(`MdCGSecure.add`/`_write_sensitivity` 用的是同一形参),
3106
+ # 显式声明一个更低的 sensitivity 就绕开了「既有节点真密级 > 写入者
3107
+ # clearance」的比较。而三条落盘出口——直写、审核 accept/edit
3108
+ # (`mdcos.review_decide`)、C 类变更单执行——**全部汇到本函数**,故闸
3109
+ # 收在此处:一次覆盖所有出口,拒绝发生在任何写盘之前(无副作用)。
3110
+ # 判据复用 `protect.require_layer` 单点(与 N131 merge 支、N221 跨层支、
3111
+ # 直写面 `write_qualify` 同口径),不另写第二份「声明↔既有」比较。
3112
+ # 次序与 N221/N131/N209 一致:principal 层闸在先、引擎保护闸在后。
3113
+ protect.require_layer(self, node_id, layer=_prev_layer,
3114
+ sensitivity=prev_entry.get("sensitivity"),
3115
+ actor=extra.get("actor"))
2347
3116
  if _prev_layer and _prev_layer != layer:
2348
- protect.require_layer(self, node_id, layer=_prev_layer,
2349
- sensitivity=prev_entry.get("sensitivity"),
2350
- actor=extra.get("actor"))
2351
3117
  protect.guard_move(self, node_id, layer, override=override,
2352
3118
  actor=extra.get("actor"))
2353
3119
  prev_state = lifecycle.state_of(prev_entry)
@@ -2403,7 +3169,34 @@ class MdCG:
2403
3169
  _v_alias = fm.pop(trust.STATE_FIELD, None) # **extra 通道的兼容写法
2404
3170
  want_vstate = verification_state or _v_alias
2405
3171
  if want_vstate is None:
2406
- fm[trust.STATE_FIELD] = prev_vstate
3172
+ # issue #352 §B(2026-10-15):**没有 verify 权限的改写不得把验证标
3173
+ # 带上**——判据与 #320 同一处(`Principal.allows_op("verify")`)。
3174
+ # 旧形态(缺省即继承)下,不带 verification_state 的同 id 改写会把旧
3175
+ # 节点的「✓ 已验证」原样挂到新正文上:#320 的闸只看**入参**
3176
+ # (`_require_verify_for_vstate`),看不见这条继承路,于是 ops 里没有
3177
+ # verify 的 record 令牌与工具面 `mdcg_remember` 都能借它把新正文带成
3178
+ # 「已验证」。证据针对的是**旧正文**,故只在正文真的变了时才降
3179
+ # (verified→doubted 是 TRANSITIONS 里的合法迁移,不需 override)。
3180
+ # 边界:无 principal 的裸库 / ops 未声明(`Principal()` 缺省)⇒
3181
+ # `allows_op` 为真,逐位继承,既有语义零变化;正文比对走读回内容
3182
+ # (盘面形态:nodefile.dumps 补尾换行),不用索引条目的 content_hash
3183
+ # ——该键的基准随写入路径而异(直调 add 落原串、重建扫描落盘面形态)。
3184
+ _inherit = prev_vstate
3185
+ if prev_vstate == "verified" and prev_entry is not None:
3186
+ _principal = getattr(self, "principal", None)
3187
+ _may_verify = (not callable(getattr(_principal, "allows_op", None))
3188
+ or _principal.allows_op("verify"))
3189
+ if not _may_verify:
3190
+ try:
3191
+ _prev_body = (self.get(node_id) or {}).get("content")
3192
+ except Exception: # noqa: BLE001 —— 读面失败按未变处置
3193
+ _prev_body = None
3194
+ _new_body = content or ""
3195
+ if not _new_body.endswith("\n"):
3196
+ _new_body += "\n"
3197
+ if _prev_body is not None and _prev_body != _new_body:
3198
+ _inherit = "doubted"
3199
+ fm[trust.STATE_FIELD] = _inherit
2407
3200
  else:
2408
3201
  _pe_v = prev_entry or {}
2409
3202
  trust.require_transition(
@@ -2547,6 +3340,9 @@ class MdCG:
2547
3340
  "path": os.path.relpath(path, self.root).replace("\\", "/"),
2548
3341
  "layer": layer, "tags": tags, "bucket": bucket,
2549
3342
  "bucket_zh": bucket_zh or None,
3343
+ # 2026-10-18:与 _node_entry 同口径(写入路径也要带,否则
3344
+ # 「新写的节点索引有条件空间、重建后反而没有」——两路径分叉的经典形态)。
3345
+ "condition_space": fm.get("condition_space") or None,
2550
3346
  "importance": importance, "created_at": fm["created_at"],
2551
3347
  # issue50-d:重要度来源入快照(与 _node_entry 同口径——写入后即可
2552
3348
  # 免读文件判「0.8 是显式 hint 还是启发式」,不等全量重建)。
@@ -2822,12 +3618,36 @@ class MdCG:
2822
3618
  self._sync_edge_entry(node_id, fm)
2823
3619
  return True
2824
3620
 
3621
+ # 生效条件:恒返回 f"rej_{sha1(hypothesis.encode()).hexdigest()[:10]}"(与 add_rejected 的幂等键逐字一致;hypothesis 为 None 时与原内联写法同样抛 AttributeError)。
3622
+ @staticmethod
3623
+ def _rejected_nid(hypothesis) -> str:
3624
+ """负记忆节点 id 单点(#439:口径收一处,安全层与基类共用,不复制 sha1 写法)。"""
3625
+ return f"rej_{hashlib.sha1(hypothesis.encode()).hexdigest()[:10]}"
3626
+
3627
+ # 生效条件:恒返回 "unr_"+slug(身份文本 topic 优先、缺省 question,经 _ticket_slug),slug 为空串时回落 "unr_"+sha1((question or "").encode()) 前 10 位——与 add_unresolved 的幂等键逐字一致。
3628
+ def _unresolved_nid(self, question, topic=None) -> str:
3629
+ """未解工单 id 单点(#439)。"""
3630
+ _slug = self._ticket_slug(question, topic)
3631
+ return (f"unr_{_slug}" if _slug else
3632
+ f"unr_{hashlib.sha1((question or '').encode()).hexdigest()[:10]}")
3633
+
3634
+ # 生效条件:恒返回 f"goal_{sha1((goal or '').strip().encode('utf-8')).hexdigest()[:10]}"——strip 与 add_goal 原内联写法同口径(goal 为 None/空时按 "" 处理)。
3635
+ @staticmethod
3636
+ def _goal_nid(goal) -> str:
3637
+ """目标节点 id 单点(#439)。"""
3638
+ return f"goal_{hashlib.sha1((goal or '').strip().encode('utf-8')).hexdigest()[:10]}"
3639
+
3640
+ # 生效条件:self.index["nodes"] 有该 id 条目时返回 True,否则 False——判据与 add_rejected / add_unresolved 的幂等分支同口径(单一写法),供基类与安全层共用。
3641
+ def _node_exists(self, nid) -> bool:
3642
+ """节点是否已在索引中(幂等分支判据单点;#439 幂等收窄靠它)。"""
3643
+ return (self.index.get("nodes") or {}).get(nid) is not None
3644
+
2825
3645
  # 生效条件:nid("rej_"+sha1(hypothesis) 前 10 位)已在 self.index["nodes"] 中时直接返回该 nid 不写盘(幂等);否则以 hypothesis/reason/verification_basis(默认 "test")拼正文并 add(..., layer="rejected", importance=0.0, **extra) 返回新 nid;
2826
3646
  def add_rejected(self, hypothesis: str, reason: str, verification_basis: str = "test",
2827
3647
  tags=None, **extra) -> str:
2828
3648
  """第 5 篇 L2:负记忆——失败/否决的假设库。重复证伪幂等。"""
2829
- nid = f"rej_{hashlib.sha1(hypothesis.encode()).hexdigest()[:10]}"
2830
- if nid in self.index["nodes"]:
3649
+ nid = self._rejected_nid(hypothesis)
3650
+ if self._node_exists(nid):
2831
3651
  return nid # 幂等:重复证伪不重复记录
2832
3652
  content = (f"# 假设:{hypothesis}\n"
2833
3653
  f"# 否决原因:{reason}\n"
@@ -2872,9 +3692,7 @@ class MdCG:
2872
3692
  + f"# 目标:{goal or '(未设定)'}\n"
2873
3693
  f"# 验证:{verification_basis}\n")
2874
3694
 
2875
- _slug = self._ticket_slug(question, topic)
2876
- nid = (f"unr_{_slug}" if _slug else
2877
- f"unr_{hashlib.sha1((question or '').encode()).hexdigest()[:10]}")
3695
+ nid = self._unresolved_nid(question, topic)
2878
3696
  entry = self.index["nodes"].get(nid)
2879
3697
  if entry is not None:
2880
3698
  # 同 id = 同一张工单(**不新建、不改 id/去重机制**)。改前此处直接
@@ -2936,7 +3754,7 @@ class MdCG:
2936
3754
  goal = (goal or "").strip()
2937
3755
  if not goal:
2938
3756
  raise ValueError("goal 不能为空")
2939
- gid = f"goal_{hashlib.sha1(goal.encode('utf-8')).hexdigest()[:10]}"
3757
+ gid = self._goal_nid(goal)
2940
3758
  content = self._goal_content(goal, conditions, action)
2941
3759
  return self.add(gid, content, layer="goals", tags=tags,
2942
3760
  importance=float(priority), confidence=1.0,
@@ -3017,6 +3835,7 @@ class MdCG:
3017
3835
  def remember_event(self, role: str, text: str, tags=None, meta=None,
3018
3836
  window: int = DEFAULT_RECENT_WINDOW):
3019
3837
  """追加一条近期事件(原始、未结构化),并按窗口滚动截断。"""
3838
+ check_recent_event(role, text, window)
3020
3839
  rec = {"t": time.time(), "role": role or "user",
3021
3840
  "text": text or "", "tags": list(tags or []),
3022
3841
  "meta": dict(meta or {})}
@@ -3040,7 +3859,12 @@ class MdCG:
3040
3859
  def recent_events(self, limit: int = 20, roles=None, since=None,
3041
3860
  newest_first: bool = True):
3042
3861
  """读取近期事件(默认最新在前)。roles 过滤角色,since 过滤时间戳。"""
3043
- recs = list(read_jsonl(self.recent_log))
3862
+ # issue #166②:**读侧容错单点**——坏行(非 dict / text 非 str / role 有值
3863
+ # 但非 str)在**读入处**过滤:一次坏写入不再让 info / recent / health /
3864
+ # recall(include_recent) 全线 AttributeError(Secure 层在 super() 结果上
3865
+ # 逐行 r.get("meta") / crypto.is_encrypted(r.get("text")),坏行正是在那炸)。
3866
+ # 顺序要紧:先过滤坏行,后做 roles / since 过滤(坏行不得流到过滤面上)。
3867
+ recs = [r for r in read_jsonl(self.recent_log) if recent_record_ok(r)]
3044
3868
  if roles:
3045
3869
  allow = set(roles)
3046
3870
  recs = [r for r in recs if r.get("role") in allow]
@@ -3325,6 +4149,13 @@ class MdCG:
3325
4149
  content = self._open_content(node_id, fm, content)
3326
4150
  if content is None:
3327
4151
  return None # 有节点但无密钥 → 不可读即不存在
4152
+ # issue #146④:损坏 frontmatter 按**不可读**返回(None),不得把
4153
+ # 坏 fm 透给调用方——`protect.mark` / `update_tags` / `set_state` 等
4154
+ # 「get → 改 fm → _write_node 回写」的族类会把读出来的坏 fm 原样
4155
+ # 写回盘面(把一次读取失败固化成一次写放大,甚至覆盖掉可人工修复的
4156
+ # 现场)。判据单点在 `nodefile.frontmatter_problem`。
4157
+ if nodefile.frontmatter_problem(fm, content):
4158
+ return None
3328
4159
  return {"id": node_id, "frontmatter": fm, "content": content, "path": e["path"]}
3329
4160
 
3330
4161
  # 生效条件:path 为节点盘上路径、exc 为读该文件时捕获的异常;仅当 fsutil.classify_read_failure(exc) 判为瞬时(非 FileNotFoundError)时调 fsutil.note_transient_read_failure 记账并返回 True,终态(真缺)不记账返回 False;本方法不改任何控制流(读不到仍是读不到)。
@@ -3355,13 +4186,22 @@ class MdCG:
3355
4186
  return None, None, None
3356
4187
  try:
3357
4188
  with open(p, encoding="utf-8") as f:
3358
- return nodefile.loads(f.read()) + (None,)
4189
+ fm, content = nodefile.loads(f.read())
3359
4190
  except UnicodeDecodeError:
3360
4191
  return None, None, None
3361
4192
  except OSError as exc:
3362
4193
  if self._note_read_oserror(p, exc):
3363
4194
  return None, None, fsutil.READ_FAIL_TRANSIENT
3364
4195
  return None, None, None
4196
+ # issue #146④:损坏 frontmatter 按**不可读**返回(三态里的「终态缺失」
4197
+ # ——不可读即不存在,与越界/真缺同形)。修前 `_read_status` 是唯一
4198
+ # 「读盘 → 交给调用方」的单点,坏 fm 从这里透出去:`protect.mark` /
4199
+ # 治理面「读 → 改 → 回写」会把坏文件**原样写回**(把读取失败固化成
4200
+ # 写放大,覆盖人工可修复的现场)。判据单点 `frontmatter_problem`,
4201
+ # 本层只消费、不另写第二份类型判据。
4202
+ if nodefile.frontmatter_problem(fm, content):
4203
+ return None, None, None
4204
+ return fm, content, None
3365
4205
 
3366
4206
  # 生效条件:等价于 _read_status(entry) 的前两项(成功 → (fm, content);终态缺失或瞬时读失败 → (None, None));返回形状与语义同 C-3 修复前**逐位一致**,包内全部既有调用点(_read_many / _goal_entry / _neg_coverage / 派生物 / 治理面)不受三态面影响;
3367
4207
  def _read(self, entry):
@@ -3394,6 +4234,18 @@ class MdCG:
3394
4234
  """
3395
4235
  return nodefile.positive_body(content)
3396
4236
 
4237
+ def _like_body_lower(self, entry, content):
4238
+ """Lowercase positive body; readcache reuses this pure projection."""
4239
+ return self._positive_body(entry, content).lower()
4240
+
4241
+ def _doc_exact_text(self, entry, content):
4242
+ """Whitespace-free full content for the existing exact-hit tie break.
4243
+
4244
+ Readcache wraps this document-only projection with its existing dirty
4245
+ generations. Query normalization stays local to each scoring call.
4246
+ """
4247
+ return compact_exact_text(content)
4248
+
3397
4249
  # ---------- 资格判定(与性能 tier 正交)----------
3398
4250
 
3399
4251
  @staticmethod
@@ -3547,7 +4399,7 @@ class MdCG:
3547
4399
  acc = "无情境可比(未做正条件确认)+ " + acc
3548
4400
  return {"state": STATE_ACCEPT, "reason": acc}
3549
4401
 
3550
- # 生效条件:node_dict 为 {frontmatter, content}(缺键按空处理)、query 为字符串、context 为 dict 或 None;无条件先算边界命中(boundary_hit),再算资格判定——边界命中**且** query 为边界问句(is_boundary_query)时,资格判定改以「摘掉命中拒绝域条目后的 query」重跑(并在返回体的 qualification 上标 boundary_suppressed=True),其余情形资格判定原样跑 judge_qualification(node_dict, query, context);返回 {"qualification","boundary","counts","recallable","reason"}——counts 内 reject 与 boundary_hit **分开计数**,recallable 为「可召回可展示」(边界命中恒真;无边界命中时 = 资格态不是 REJECT)。
4402
+ # 生效条件:node_dict 为 {frontmatter, content}(缺键按空处理)、query 为字符串、context 为 dict 或 None;无条件先算边界命中(boundary_hit),再算资格判定——边界命中**且** query 为边界问句(is_boundary_query)时,资格判定改以「摘掉命中拒绝域条目后的 query」重跑(并在返回体的 qualification 上标 boundary_suppressed=True),其余情形资格判定原样跑 judge_qualification(node_dict, query, context);返回 {"qualification","boundary","counts","recallable","reason"}——counts 内 reject 与 boundary_hit **分开计数**,recallable 为「可召回可展示」(边界命中恒真;无边界命中时 = 资格态不是 REJECT);#362d 案②:抑制确实发生且未摘词面原判 REJECT 时,把该证据并入顶层 reason(键集与 state 不动)。
3551
4403
  @staticmethod
3552
4404
  def judge_with_boundary(node_dict, query: str, context=None) -> dict:
3553
4405
  """资格判定 + 拒绝域命中——**分开计数、分开呈现**(§5.2 / P0-4)。
@@ -3561,13 +4413,24 @@ class MdCG:
3561
4413
  "blindspot":0|1, "boundary_hit":0|1},
3562
4414
  "recallable": bool, # 与既有候选过滤同口径:state 不属
3563
4415
  # (REJECT, BLINDSPOT) 即可召回
3564
- "reason": str}
4416
+ "reason": str} # #362d 案②:边界问句下若「未摘词面
4417
+ # 原判 REJECT」,此处并入该证据
3565
4418
 
3566
4419
  **不变量(本判据的核心)**:`boundary.hit` 为真**不构成**资格否定——
3567
4420
  边界问句下资格判定摘掉命中词面再跑,故「问该节点的拒绝域」不会把该节点
3568
4421
  打回 REJECT(自否定);非边界问句下资格判定**原样**跑 `judge_qualification`,
3569
4422
  负条件的灵敏度一字不变(情境里真的命中拒绝域 ⇒ 照旧 REJECT)。
3570
4423
 
4424
+ **#362d(2026-10-14 Lead 裁定,案②零破坏子形态)**:上面的不变量是
4425
+ P0-4/P2-2 的**有意设计**,不改;真正缺的是**可观测性**——旧返回体在
4426
+ 边界问句下只给「资格 DEFER」,看不出「未摘词面时原判 REJECT」。
4427
+ 故本函数在**抑制确实发生**且**未摘词面原判 REJECT** 时,把该证据并入
4428
+ 既有顶层 `reason` 串:**顶层键集与 qualification 键集一字不动、
4429
+ `state` 一字不动**(`test_boundary_hit` 的 B0c/B0d 逐项键集断言不受
4430
+ 影响)。代价如实登记:`mdcos.search_rrf` 与 `MdCG._emit` 都只取
4431
+ `qualification`/`counts`,**不会主动透出该 reason**——透出需改
4432
+ `md_cg/mdcos.py`(不在本轮写面),交后续轮次。
4433
+
3571
4434
  **已接线(P2-2,2026-10-01)**:本函数与 `boundary_hit` 都**有生产调用方**——
3572
4435
 
3573
4436
  · `MdCG._emit`(`md_cg/mdcg.py:4181`)=默认打分收口,结果卡带
@@ -3583,13 +4446,19 @@ class MdCG:
3583
4446
  node_dict = node_dict or {}
3584
4447
  bh = boundary_hit(node_dict, query, context)
3585
4448
  bq = is_boundary_query(query)
3586
- if bh["hit"] and bq:
3587
- qual = dict(MdCG.judge_qualification(
3588
- node_dict, strip_boundary_terms(query, bh["terms"]), context))
3589
- qual["boundary_suppressed"] = True
3590
- else:
3591
- qual = dict(MdCG.judge_qualification(node_dict, query, context))
3592
- qual["boundary_suppressed"] = False
4449
+ suppressed = bool(bh["hit"] and bq)
4450
+ qual = dict(MdCG.judge_qualification(
4451
+ node_dict,
4452
+ strip_boundary_terms(query, bh["terms"]) if suppressed else query,
4453
+ context))
4454
+ qual["boundary_suppressed"] = suppressed
4455
+ # #362d 案②(零破坏子形态):另算一次**未摘词面**的判定作证据,见下方 reason 段。
4456
+ raw = (dict(MdCG.judge_qualification(node_dict, query, context))
4457
+ if suppressed else qual)
4458
+ # 非边界问句下 raw 即 qual 本身,**不产生第二次判定**(默认口径零位移);
4459
+ # 该证据只并入顶层 reason——键集与 state 一字不动,§5.2 的不变量保持成立;
4460
+ # 缺的只是**可观测性**(报告抱怨的正是「REJECT 被压掉了、看不到」)。
4461
+ # 完整裁定与覆盖缺口见本函数 docstring 的 #362d 段。
3593
4462
  st = str(qual.get("state") or "")
3594
4463
  counts = {"accept": int(st == STATE_ACCEPT),
3595
4464
  "reject": int(st == STATE_REJECT),
@@ -3599,14 +4468,21 @@ class MdCG:
3599
4468
  # 可召回与**既有候选过滤同口径**(mdcos 的 `st in (REJECT, BLINDSPOT)`
3600
4469
  # 即剔除):这两态不进候选,其余(ACCEPT/DEFER)可召回。
3601
4470
  recallable = st not in (STATE_REJECT, STATE_BLINDSPOT)
4471
+ why = ("边界命中(%s)+ 资格 %s" % (bh["marker"], st)
4472
+ if bh["hit"] else "无边界命中 + 资格 %s" % st)
4473
+ # #362d 案②:**证据在场**——边界问句摘掉命中词面后不再 REJECT,但「未摘
4474
+ # 词面的原判」必须让调用方看得见(键集不动,证据进既有 reason 串)。
4475
+ if suppressed and str(raw.get("state") or "") == STATE_REJECT:
4476
+ why += (";**摘词面前原判 %s**(查询逐字含本节点的拒绝域条目,该 REJECT "
4477
+ "被边界问句的摘词面抑制;边界命中使其可召回可展示)"
4478
+ % STATE_REJECT)
3602
4479
  return {"qualification": {"state": qual.get("state"),
3603
4480
  "reason": qual.get("reason"),
3604
4481
  "boundary_suppressed": qual["boundary_suppressed"]},
3605
4482
  "boundary": {"hit": bh["hit"], "terms": bh["terms"],
3606
4483
  "marker": bh["marker"], "reason": bh["reason"]},
3607
4484
  "counts": counts, "recallable": recallable,
3608
- "reason": ("边界命中(%s)+ 资格 %s" % (bh["marker"], st)
3609
- if bh["hit"] else "无边界命中 + 资格 %s" % st)}
4485
+ "reason": why}
3610
4486
 
3611
4487
  # ---------- 检索(性能阶梯 + 资格判定)----------
3612
4488
 
@@ -3644,6 +4520,11 @@ class MdCG:
3644
4520
  layer/role 维度),view 非空时叠加资格谓词;非法视图
3645
4521
  ValueError(fail-closed 只针对调用方误用)。
3646
4522
  """
4523
+ # issue #275:非法 layer 从「静默空结果」改为 fail-closed(与同一签名的
4524
+ # view / time_axis 同处置;口径与 add 侧校验逐字一致)。
4525
+ # 基类与 MdCGOS 两处入口**同口径**——防「同名方法两份、只一份受守」。
4526
+ if layer and layer not in LAYERS:
4527
+ raise ValueError(f"未知层:{layer}(允许:{LAYERS})")
3647
4528
  q = (query or "").strip()
3648
4529
  # 批次 15 统一口径(unify.py,2026-09-30 收窄作用域):只译**英文内容**
3649
4530
  # → 标准原子序列,中文段逐字原样(不再整条归一);纯中文/无 ASCII 字母
@@ -3695,7 +4576,9 @@ class MdCG:
3695
4576
  # 不进默认检索候选——判据单点 lifecycle.is_archived
3696
4577
  # (缺键=active fail-open),与生产路径 `MdCGOS._candidates`
3697
4578
  # 同一口径(此前基类面未接,属已登记的已知未覆盖面)。
3698
- and not lifecycle.is_archived(e)):
4579
+ # 2026-10-18:is_archived → is_retired(archived ∪ superseded)。
4580
+ # 被修订取代的旧版本同样不得进默认检索面,否则新旧并存污染结果。
4581
+ and not lifecycle.is_retired(e)):
3699
4582
  entries.append(e)
3700
4583
 
3701
4584
  # 默认关:索引里可能残留门控字段(曾开启过 / 回填过)→ 返回前剥离,
@@ -3795,7 +4678,8 @@ class MdCG:
3795
4678
  fm, content = nodefile.loads(f.read())
3796
4679
  except (OSError, UnicodeDecodeError):
3797
4680
  continue
3798
- if any(t in content for t in terms):
4681
+ # issue #150:空词项会使本判据恒真 ⇒ 全部负记忆都被算作「覆盖本查询」。
4682
+ if any(t and t in content for t in terms):
3799
4683
  neg_coverage.append(e)
3800
4684
 
3801
4685
  stat = {"scanned": 0, "query": q, "gates": gates}
@@ -3844,7 +4728,8 @@ class MdCG:
3844
4728
  if self._like(d[2], d[1], terms,
3845
4729
  index_key_hits(d[0], terms, q),
3846
4730
  entry=d[0],
3847
- positive_body=self._positive_body)
4731
+ positive_body=self._positive_body,
4732
+ body_lower=self._like_body_lower)
3848
4733
  or (semantic_on() and d[1].get("semantic"))]
3849
4734
  out = try_stage(hits, TIER_BUCKET_LIKE)
3850
4735
  if out:
@@ -3873,7 +4758,8 @@ class MdCG:
3873
4758
  if self._like(d[2], d[1], terms,
3874
4759
  index_key_hits(d[0], terms, q),
3875
4760
  entry=d[0],
3876
- positive_body=self._positive_body)
4761
+ positive_body=self._positive_body,
4762
+ body_lower=self._like_body_lower)
3877
4763
  or (semantic_on() and d[1].get("semantic"))
3878
4764
  or d[0].get("path") in _dif] # 图扩散补召回:无词面命中也放行进打分
3879
4765
  stat["pre_cap"] = len(hits_r) # 与 T2 同序:截断**前**的候选数
@@ -3978,7 +4864,8 @@ class MdCG:
3978
4864
  if self._like(d[2], d[1], terms,
3979
4865
  index_key_hits(d[0], terms, q),
3980
4866
  entry=d[0],
3981
- positive_body=self._positive_body)
4867
+ positive_body=self._positive_body,
4868
+ body_lower=self._like_body_lower)
3982
4869
  or (semantic_on() and d[1].get("semantic"))]
3983
4870
  # ---- S3 图扩散激活(契约 §3 S3;flag 控,默认关)----
3984
4871
  # 为何:审计偏差 1 曾成立——「edges 一直只被写入、检索从不使用」。**该偏差
@@ -4014,7 +4901,9 @@ class MdCG:
4014
4901
  "hops": _s3_hops, "decay": _s3_decay,
4015
4902
  "gain": _s3_gain, "valid": _valid}
4016
4903
  if _valid >= min_results:
4017
- _merged.sort(key=lambda x: (-x[1], -float(
4904
+ _merged.sort(key=lambda x: (-x[1],
4905
+ # issue #89①:同分时精确命中优先(次级键)
4906
+ -int(x[0].get(EXACT_HIT_KEY) or 0), -float(
4018
4907
  x[0]["frontmatter"].get("importance") or 0),
4019
4908
  str(x[0].get("id") or "")))
4020
4909
  if record and _merged[:k]:
@@ -4124,7 +5013,8 @@ class MdCG:
4124
5013
 
4125
5014
  @staticmethod
4126
5015
  # 生效条件:terms 为空时返回 False;否则任一 t 在 body 的小写串中出现(body 取自 positive_body 钩子——透传绑定方法时走 readcache 缓存版,未传时回落 nodefile.positive_body(content) 直调,两者同值),或该 t 的小写形式出现在 fm 的 tags(tags 取自 fm.get("tags") or [],缺键或假值按空列表拼接)小写串中,或 index_keys 为真值(六要素后两行的索引键命中,见 index_key_hits)即返回 True。
4127
- def _like(content, fm, terms, index_keys=None, entry=None, positive_body=None):
5016
+ def _like(content, fm, terms, index_keys=None, entry=None, positive_body=None,
5017
+ body_lower=None):
4128
5018
  # 负条件行(`# 不适用条件:`)是反例声明,不作召回键:命中它只应由
4129
5019
  # judge_qualification 走 REJECT,不能把节点召回。tags 仍参与匹配。
4130
5020
  #
@@ -4143,16 +5033,18 @@ class MdCG:
4143
5033
  if index_keys and index_keys.get("hit"):
4144
5034
  return True
4145
5035
  tags = " ".join(str(t) for t in (fm.get("tags") or []))
4146
- if positive_body is not None:
4147
- body = positive_body(entry, content)
5036
+ if body_lower is not None:
5037
+ body_l = body_lower(entry, content)
4148
5038
  else:
4149
- body = nodefile.positive_body(content)
4150
- # 双边小写化:英文大小写统一(中文无大小写不受影响)
4151
- body_l = body.lower()
5039
+ body = (positive_body(entry, content) if positive_body is not None
5040
+ else nodefile.positive_body(content))
5041
+ body_l = body.lower()
4152
5042
  tags_l = tags.lower()
4153
- return any(t in body_l or t.lower() in tags_l for t in terms)
5043
+ # issue #150:空词项恒真(`"" in s` → True)⇒ 必须滤掉;否则 LIKE 预筛恒真、
5044
+ # 全库入池。Rust `retrieval.rs::like` 同款(跨侧守卫钉住一致性)。
5045
+ return any(t and (t in body_l or t.lower() in tags_l) for t in terms)
4154
5046
 
4155
- # 生效条件:semantic_on() 为真、semantic.canonical.pair_hits 导入成功且该 doc 的 fm 有 semantic 时 raw = min(1.0, max(lexical_sim(qb, 该文档 normalize_en 后的 bigram, mode), pair_hits(fm["semantic"], q)) + tag_bonus),否则 raw = min(1.0, sim + tag_bonus);tag_bonus 仅在 fm.tags 中有 t 满足 str(t) in q 或 q in str(t) 时为 0.05,否则 0.0;pools 为真值时 raw 再乘 pooling.weight_of(...) 并夹到 [0,1];返回 scored 列表;
5047
+ # 生效条件:semantic_on() 为真、semantic.canonical.pair_hits 导入成功且该 doc 的 fm 有 semantic 时 raw = min(1.0, max(lexical_sim(qb, 该文档 normalize_en 后的 bigram, mode, df=本批df, n_docs=本批文档数), pair_hits(fm["semantic"], q)) + tag_bonus),否则 raw = min(1.0, sim + tag_bonus);tag_bonus 仅在 fm.tags 中有 t 满足 str(t) in q 或 q in str(t) 时为 0.05,否则 0.0;pools 为真值时 raw 再乘 pooling.weight_of(...) 并夹到 [0,1];返回 scored 列表;
4156
5048
  def _score(self, docs, q, qb, pools=None, mode=None):
4157
5049
  # 语义摘要路(MDCG_SEMANTIC=1 opt-in,默认关闭零回归):
4158
5050
  # doc 侧 fm.semantic 标准原子序列 × query 归一序列的组合窗口共现分
@@ -4184,16 +5076,35 @@ class MdCG:
4184
5076
  _fr_on = freshness.enabled()
4185
5077
  _fr_now = freshness.freshness_now() if _fr_on else None
4186
5078
  _fr_gamma = freshness.resolve_gamma(None) if _fr_on else None
5079
+ _exact_q = compact_exact_text(q)
5080
+ # issue #363:缺省 lexical 路无 IDF ⇒ 分数只有 k/|q| 几个离散档、文档一多
5081
+ # 就大面积同分,名次退化为写入序。此处按**本批候选文档**统计查询 bigram
5082
+ # 的文档频次(df),交给 lexical_sim 的 IDF 加权覆盖度。统计面与 bm25.py
5083
+ # 的 posting 面同一条口径(「scoped to the current eligible pool」):
5084
+ # 只统计 `docs`(= 本次 _score 的候选批),不扫全库、不读盘。
5085
+ # 走 readcache 覆写版钩子取 bigram:内容不变则派生物不变,df 统计与
5086
+ # 打分共用同一份 nb(单遍计算,无重复归一化)。
5087
+ _nbs = [self._doc_norm_bigrams(e, c) for e, _fm, c in docs]
5088
+ _df = None
5089
+ if qb and (mode or SCORE_MODE) != "jaccard":
5090
+ _df = {}
5091
+ for _nb in _nbs:
5092
+ for _g in qb & _nb:
5093
+ _df[_g] = _df.get(_g, 0) + 1
5094
+ _n_docs = len(_nbs)
4187
5095
  scored = []
4188
- for e, fm, c in docs:
5096
+ for _i, (e, fm, c) in enumerate(docs):
5097
+ nb = _nbs[_i]
4189
5098
  # 归一化 content 后取 bigram(与 query 侧 normalize_en 对称);
4190
5099
  # 走可覆写钩子(批次 21,issue #31):内容不变则派生物不变——
4191
5100
  # readcache 启用时覆写为缓存版(Rust load_docs 预计算同款),
4192
5101
  # 基类默认即算即弃,行为与改动前逐位一致
4193
- nb = self._doc_norm_bigrams(e, c)
4194
- sim = lexical_sim(qb, nb, mode)
4195
- tag_bonus = 0.05 if any(str(t) in q or q in str(t)
4196
- for t in (fm.get("tags") or [])) else 0.0
5102
+ sim = lexical_sim(qb, nb, mode, df=_df, n_docs=_n_docs)
5103
+ # issue #150:空 tag(`"" in q` 恒真)与空 q(`q in str(t)` 恒真)都会让
5104
+ # 加成恒发 ⇒ 两侧同步加守卫(Rust retrieval.rs 的 tag_bonus 同款)。
5105
+ tag_bonus = 0.05 if q and any(
5106
+ str(t) and (str(t) in q or q in str(t))
5107
+ for t in (fm.get("tags") or [])) else 0.0
4197
5108
  if sem_on and _pair_hits is not None and fm.get("semantic"):
4198
5109
  raw = min(1.0, max(sim, _pair_hits(fm["semantic"], q))
4199
5110
  + tag_bonus)
@@ -4216,7 +5127,12 @@ class MdCG:
4216
5127
  if _boost: # S4:层级加成(最后一步;上限仍夹在 1.0)
4217
5128
  raw = min(1.0, raw + _boost.get(str(fm.get("layer") or ""), 0.0))
4218
5129
  scored.append(({"id": fm.get("id") or e["path"], "frontmatter": fm,
4219
- "content": c, "path": e["path"]}, raw))
5130
+ "content": c, "path": e["path"],
5131
+ # issue #89①:精确命中标记随 doc 携带,供排序键消费;
5132
+ # _emit 出口剥离(内部键,不透出)。
5133
+ EXACT_HIT_KEY: exact_hit_of(q, c, _prepared=(
5134
+ _exact_q, self._doc_exact_text(e, c)
5135
+ if len(_exact_q) >= EXACT_MIN_LEN else ""))}, raw))
4220
5136
  return scored
4221
5137
 
4222
5138
 
@@ -4228,12 +5144,17 @@ class MdCG:
4228
5144
  「尾巴是否计入 k」这一个口径在**此一处**裁决:`_emit` 只从这里取预算,
4229
5145
  故 `len(results) = n_tail + (k - n_tail) ≤ k` 由构造保证。改前(等价于
4230
5146
  恒返回 int(k))尾巴在 k 之外,结果数可到 k+min(3,|覆盖|)。
5147
+
5148
+ H10 修订(2026-10-07):调用方传进来的 `n_tail` 由 `_emit` 限为
5149
+ min(NEG_COVERAGE_MAX, max(0, k − 真实命中数))——真实命中先占位,
5150
+ 故此处 `k − n_tail ≥ min(k, 真实命中数)`,主结果不会被提示挤成 0。
5151
+ 本函数体一字未改(H10② 的「≤ k」口径仍单点在此)。
4231
5152
  """
4232
5153
  return max(0, int(k) - int(n_tail))
4233
5154
 
4234
5155
 
4235
- # 生效条件:k<=0 或 neg_coverage 为空 → 返回 [];否则自 neg_coverage 起逐条 self._read(content 为 None 跳过,_read 已含 _node_disk_path 边界闸与 OSError→(None,None) 语义),每命中一条产出 (card, NEG_COVERAGE_SCORE, qual) 且最多取 min(NEG_COVERAGE_MAX, k) 条;card 带 negative_coverage/neg_layer/node_id 三个独立字段;qual.state 为 rejected 层→STATE_REJECT、否则 STATE_DEFER;
4236
- def _neg_tail(self, neg_coverage, k):
5156
+ # 生效条件:budget<=0 或 neg_coverage 为空 → 返回 [];否则自 neg_coverage 起逐条 self._read(content 为 None 跳过,_read 已含 _node_disk_path 边界闸与 OSError→(None,None) 语义),每命中一条产出 (card, NEG_COVERAGE_SCORE, qual) 且最多取 min(NEG_COVERAGE_MAX, budget) 条;card 带 negative_coverage/neg_layer/node_id 三个独立字段;qual.state 为 rejected 层→STATE_REJECT、否则 STATE_DEFER;
5157
+ def _neg_tail(self, neg_coverage, budget):
4237
5158
  """负覆盖提示条目(结果尾部)的**单点构造**(H10①②④)。
4238
5159
 
4239
5160
  与真实候选的区别在**字段**上而不在分数上:
@@ -4243,10 +5164,12 @@ class MdCG:
4243
5164
  `md_cg/test_emit_negtail_cache.py`(E0b/E2a/E5)按 `id` 认路盘路径,
4244
5165
  故 `id` 语义一字不动,真 id 走这个**新增**字段——纯增量键);
4245
5166
  · 分数=`NEG_COVERAGE_SCORE` 哨兵值(不是「得分 1.0 的答案」)。
4246
- 条数=min(NEG_COVERAGE_MAX, k):**计入 k 预算**,与 `_emit` 的主结果
4247
- `scored[:k - len(tail)]` 配对,保证 `len(results) ≤ k`。
5167
+ 条数=min(NEG_COVERAGE_MAX, budget):**计入 k 预算**——`budget` 由
5168
+ `_emit` 算出=max(0, k − 真实命中数)(H10 修订:真实命中优先,改前此处
5169
+ 收的恒是 k,提示按 min(3, k) 全额占位、k 小时把真实命中挤成 0);
5170
+ 与 `_emit` 的主结果 `scored[:k - len(tail)]` 仍配对,`len(results) ≤ k` 不变。
4248
5171
  """
4249
- slots = max(0, int(k))
5172
+ slots = max(0, int(budget))
4250
5173
  if slots <= 0 or not neg_coverage:
4251
5174
  return []
4252
5175
  out = []
@@ -4277,7 +5200,51 @@ class MdCG:
4277
5200
  return out
4278
5201
 
4279
5202
 
4280
- # 生效条件:scored 按 (-分数, -importance) 排序,负覆盖提示条数 = len(_neg_tail(neg_coverage, k)) 先占 k 预算,主结果取 scored[:max(0,k-提示数)] 后逐条判定(judge 为真值时调 judge_qualification(r[0], stat["query"] 或 "", context),否则 qual={"state":None,"reason":"judge_disabled"}),再把提示条目 extend 到 out 末尾;record 为真且主结果非空时调 record_access;pool_plan 以 pooling.plan(stat["cap"] 或模块级 GLOBAL_CAP, pools) 生成,stat["pool_taken"] 为真时并入 taken/cands/lost;返回 (out, 含 tier/scanned/bucket/candidates/pre_cap/cap/cut_order/pools/covered_neg/big_domain 的审计 dict);
5203
+ # 生效条件:tier == TIER_GLOBAL_SCAN(T3 全量兜底:候选取自未经 _like 过滤的全量表、且该出口**不设阈值**)且 n_real == 0(全库无任何 s>0 的条目)时返回 True;tier 为其它层(T0/T1/T2 桶与 LIKE、S3 spread)或 n_real > 0 时返回 False。
5204
+ @staticmethod
5205
+ def _zero_filler_only(tier, n_real) -> bool:
5206
+ """#89② 靶区单点判据:**只有「T3 兜底 ∧ 全库无真命中」才是纯 0 分填充行**。
5207
+
5208
+ 定因(2026-10-09,原始读数见交付记录 `%TEMP%\\p89_red\\`)——`score == 0`
5209
+ 在结果装配处**两种语义并存**,光看分数分不开:
5210
+
5211
+ · **T3 全量兜底**(`docs_all` 未过 `_like`):`s == 0` ⇔ 与查询零词面/语义
5212
+ 交集 ⇒ **真无关**。该出口按相关度(次级 importance/created_at)把 top-k
5213
+ 装进结果,0 分行就是「库里没有相关内容时的填充」= #89 的靶区。
5214
+ · **T0/T1/T2 与 reach 路径**:`s == 0` 另有语义——① 过了 LIKE 闸的真候选被
5215
+ S5 按 λ 降权(本实现 S5 自述「只降权、不删除、下限 0」);② reach 图扩散
5216
+ 邻居经 `path in reach_diffused_paths` 显式补入(reach 补召回的**唯一结果层
5217
+ 出口**)。这两类 0 都**带质量信号**,裁它们 = 把「降权」变成「删除」。
5218
+ 结构上还多一层保证:这些路径都经 `try_stage` 出口,而其判据是
5219
+ `valid >= min_results`(缺省 1,且各调用点 k ≥ 1)⇒ 它们**不会**在有真
5220
+ 命中的情况下只剩 0 分行;T3 是唯一**不设阈值**的兜底出口。
5221
+
5222
+ `n_real`(=`min(k, sum(s>0))`,H10 已算好的同一口径)只用来回答「库里到底有
5223
+ 没有真相关」:T3 下 `sum(s>0) > 0` ⇒ 0 分行是「真命中之外的填充」,与改动前
5224
+ 逐位一致 ⇒ 不裁。(`n_real` 恒不用于裁主结果条数——那是它**不具备**的职能。)
5225
+ """
5226
+ return tier == TIER_GLOBAL_SCAN and not n_real
5227
+
5228
+
5229
+ # 生效条件:恒返回主结果实取条数上界——`_zero_filler_only(tier, n_real)` 为真(T3 全量兜底 ∧ 全库无真命中 ⇒ #89② 靶区)时返回 0;否则返回 `_primary_slots(k, n_neg)`(= max(0, k − 负覆盖提示条数))。
5230
+ def _primary_bound(self, k, n_neg, tier, n_real) -> int:
5231
+ """主结果实取条数上界——#89② 收窄后**唯一**的裁切裁决点(2026-10-09)。
5232
+
5233
+ 两种口径在此合流:
5234
+ · `_primary_slots(k, n_neg)`(H10② 单点在彼):k 预算扣掉负覆盖提示条;
5235
+ · #89② 收窄:**只**在 `_zero_filler_only(...)` 为真时把上界压到 0。
5236
+
5237
+ 改前(c82e4255)此处是 `min(_primary_slots(k, n_neg), _n_real)`——把**只服务
5238
+ H10 负覆盖尾条预算**的 `_n_real` 借来当主结果裁切上限(`_n_real` 的 docstring
5239
+ 与 H10 修订注释都写明它只算「提示条让位」的预算),于是 T2 里被 S5 降权到 0 的
5240
+ 真候选、reach 里被显式补入的图扩散邻居一并被删——**真退化**,非期望过时。
5241
+ """
5242
+ if self._zero_filler_only(tier, n_real):
5243
+ return 0
5244
+ return self._primary_slots(k, n_neg)
5245
+
5246
+
5247
+ # 生效条件:scored 按 (-分数, -importance) 排序,真实命中数 n_real = min(max(0,k), scored 中 s>0 的条数),负覆盖提示条数 = len(_neg_tail(neg_coverage, max(0,k-n_real))) = min(NEG_COVERAGE_MAX, max(0,k-n_real))(H10 修订:真实命中优先,提示不再按 min(3,k) 先占位——改前 k=2/3 时主结果配额被算成 0、一条真实命中都不返回),主结果取 scored[:max(0,k-提示数)](#89② 收窄:tier==TIER_GLOBAL_SCAN 且 n_real==0 时取 0 条;单点见 _primary_bound/_zero_filler_only)后逐条判定(judge 为真值时调 judge_qualification(r[0], stat["query"] 或 "", context),否则 qual={"state":None,"reason":"judge_disabled"}),再把提示条目 extend 到 out 末尾;record 为真且主结果非空时调 record_access;pool_plan 以 pooling.plan(stat["cap"] 或模块级 GLOBAL_CAP, pools) 生成,stat["pool_taken"] 为真时并入 taken/cands/lost;返回 (out, 含 tier/scanned/bucket/candidates/pre_cap/cap/cut_order/pools/covered_neg/big_domain 的审计 dict);
4281
5248
  def _emit(self, scored, k, tier, stat, bucket, record, candidates,
4282
5249
  judge, context, neg_coverage, big_domain=None, big_scores=None,
4283
5250
  pools=None):
@@ -4339,6 +5306,8 @@ class MdCG:
4339
5306
  "neg": len(neg_coverage), "suppressed": len(_s5_hits),
4340
5307
  "suppressed_ids": _s5_hits[:20]}
4341
5308
  scored.sort(key=lambda x: (-x[1],
5309
+ # issue #89①:同分时精确命中优先(次级键)
5310
+ -int(x[0].get(EXACT_HIT_KEY) or 0),
4342
5311
  -float(x[0]["frontmatter"].get("importance") or 0),
4343
5312
  str(x[0].get("id") or "")))
4344
5313
  # ---- 负覆盖提示条目(H10①②④):先建尾条目,再按 k 预算切主结果 ----
@@ -4350,8 +5319,32 @@ class MdCG:
4350
5319
  # ② **计入 k 预算**:主结果让位给提示条数,故 len(results) 恒 ≤ k,
4351
5320
  # 不再出现 k+3 的超发(改前 k=3 → 5、k=5 → 7,与 k 无关);
4352
5321
  # ④ 位置如实为**尾部**(旧注释「(首条)」与代码相反,一并删除)。
4353
- _neg_tail = self._neg_tail(neg_coverage, k)
4354
- results = scored[:self._primary_slots(k, len(_neg_tail))]
5322
+ #
5323
+ # H10 修订(2026-10-07,缺陷:k ≤ 提示数时真实命中归零):
5324
+ # **真实命中优先**——主结果先取满 min(k, 真实命中数),提示条数才是
5325
+ # min(NEG_COVERAGE_MAX, max(0, k − 真实命中数))。真实命中数=`scored` 里
5326
+ # **过质量闸**者(`s > 0`;与 `try_stage` 的 `valid` 同一口径、同一处——
5327
+ # 本条正是「scored 是已过质量闸的候选」的那处唯一判据)。
5328
+ # 改前口径是「提示按 min(NEG_COVERAGE_MAX, k) 先全额占位」(`_neg_tail(.., k)`
5329
+ # 后 `_primary_slots(k, n_tail)` 算主结果),k=2/3 时主结果配额被算成 0——
5330
+ # **一条真实命中都不返回**,调用方读成「库里没有」而实际有高分命中
5331
+ # (把「读不到」读成「不存在」)。
5332
+ # 与 `_primary_slots` 仍配对:results = scored[:k − n_neg] ⇒ len(results) ≤ k
5333
+ # 一字不变(H10② 的成果不回退)。提示条数为 0(真实命中已占满 k)时,
5334
+ # 负覆盖信号**不失传**:仍从**既有**统计/审计面读到——meta["covered_neg"]
5335
+ # (全部被覆盖路径,恒在)与 stat["gates"]["s5"]["neg"](S5 门控开启时的
5336
+ # 计数位数)——两者皆非为本次修复新增,故不新增协议字段。
5337
+ _n_real = min(max(0, int(k)), sum(1 for _, s in scored if s > 0))
5338
+ _neg_tail = self._neg_tail(neg_coverage, max(0, int(k) - _n_real))
5339
+ # issue #89②(2026-10-09 DSH 端实施、zcode 端收窄靶区):**0 分(无质量信号)
5340
+ # 条目不得装进结果**——它们对调用方无价值且有误导(LLM 会当成相关内容)。
5341
+ # 但与 `try_stage` 的 `valid` 同一口径的 `_n_real`(= min(k, sum(s>0)))**只服务
5342
+ # H10 的负覆盖尾条预算**(其 docstring 明写:真实命中先占位、提示条让位),
5343
+ # 本笔原先把它借来当「主结果裁切上限」,等于给 H10 加了一层它不具备的职能——
5344
+ # 于是 T2 里被 S5 降权到 0 的真候选、reach 里显式补入的图扩散邻居被一并删除。
5345
+ # 收窄后的判据单点在 `MdCG._zero_filler_only` / 裁切上界单点在
5346
+ # `MdCG._primary_bound`(两路 `score==0` 的语义分档见前者 docstring)。
5347
+ results = scored[:self._primary_bound(k, len(_neg_tail), tier, _n_real)]
4355
5348
  # ---- S6 一致性交叉验证(契约 §3 S6;flag 控、默认关)----
4356
5349
  # 只读复用 crosscheck 的「赛道 × 来源执照」判定:对 top-k 逐个给出赛道、声明依据是否被
4357
5350
  # 该赛道许可、以及断言条数。**不进主排序**(scored/out 的次序一律不动),只落审计摘要。
@@ -4410,7 +5403,7 @@ class MdCG:
4410
5403
  # 否则下游按 state 判定的地方会把它读成资格结论)
4411
5404
  r[0]["boundary_hit"] = True
4412
5405
  r[0]["boundary_marker"] = _b.get("marker")
4413
- r[0]["boundary_terms"] = list(_b.get("terms") or [])
5406
+ r[0]["boundary_terms"] = _ensure_list(_b.get("terms"))
4414
5407
  for _k in ("accept", "reject", "defer", "blindspot"):
4415
5408
  _bnd["counts"][_k] += int(
4416
5409
  (_jw.get("counts") or {}).get(_k) or 0)
@@ -4481,6 +5474,12 @@ class MdCG:
4481
5474
  # 未启用则 meta 键集合与改动前逐字节一致(默认关零变更纪律)。
4482
5475
  if stat.get("time_filter"):
4483
5476
  meta["time_filter"] = stat["time_filter"]
5477
+ # issue #89①:次级排序键用毕即剥离——EXACT_HIT_KEY 是**内部键**,
5478
+ # 不得随 doc 引用透出。MCP 面(_node_view / 三处显式取键)本就是白名单,
5479
+ # 本步是第二道防线,也为将来新增的消费面兜底。
5480
+ for _r in out:
5481
+ if isinstance(_r[0], dict):
5482
+ _r[0].pop(EXACT_HIT_KEY, None)
4484
5483
  return out, meta
4485
5484
 
4486
5485
  # ---------- 五大单元之四:反思 / 验证 / 输出 ----------
@@ -4529,7 +5528,10 @@ class MdCG:
4529
5528
  if meta.get("enabled") else None),
4530
5529
  }
4531
5530
  try:
4532
- append_jsonl(self.reflection_log, reflection)
5531
+ # #326-④:append_jsonl 不再上抛、以 False 报写失败——本处**仍容忍**(best-effort
5532
+ # 簿记),但失败不再静默:源头已记 fsutil.APPEND_FAILURES + 有界 stderr 告警
5533
+ # (B 面单点)。显式消费返回值:不留裸调用(守卫 AST 钉子会抓)。
5534
+ _ok = append_jsonl(self.reflection_log, reflection)
4533
5535
  except OSError:
4534
5536
  pass
4535
5537
  return reflection
@@ -4582,7 +5584,8 @@ class MdCG:
4582
5584
  return max(0.0, 1.0 - accept / len(cands))
4583
5585
 
4584
5586
  # 生效条件:to_layer 不属于模块级 LAYERS 时抛 ValueError;self.get(node_id) 取不到节点或当前层(fm.layer 或路径首段)等于 to_layer 时返回 None;否则先对**源层与目标层**各调 protect.require_layer(N209:principal 层写闸,越权抛 AccessDenied),再调 protect.guard_move 后写入 demotion 审计、搬文件到目标层并按新层 _stage、重算 buckets,返回 {id, from, to, path, reason};
4585
- def _move_layer(self, node_id: str, to_layer: str, reason: str = ""):
5587
+ def _move_layer(self, node_id: str, to_layer: str, reason: str = "",
5588
+ override: bool = False):
4586
5589
  """把节点搬到另一层(可信度降级用),同步索引与 demotion 审计字段。"""
4587
5590
  if to_layer not in LAYERS:
4588
5591
  raise ValueError(f"未知层:{to_layer}")
@@ -4603,65 +5606,53 @@ class MdCG:
4603
5606
  sensitivity=fm.get("sensitivity"))
4604
5607
  protect.require_layer(self, node_id, layer=to_layer,
4605
5608
  sensitivity=fm.get("sensitivity"))
4606
- protect.guard_move(self, node_id, to_layer)
5609
+ # issue #469:`override` 必须**下传**——修前恒 `guard_move(override=False)`,上游
5610
+ # (scrub.decontaminate)认了 override 却在 demote 处丢失 ⇒ 受保护节点「静默失败」。
5611
+ protect.guard_move(self, node_id, to_layer, override=override)
4607
5612
  fm["layer"] = to_layer
4608
5613
  fm["demotion"] = {"t": time.time(), "from": from_layer,
4609
5614
  "to": to_layer, "reason": reason}
4610
5615
  d = os.path.join(self.root, to_layer)
4611
5616
  os.makedirs(d, exist_ok=True)
4612
5617
  new_path = os.path.join(d, f"{node_id}.md")
4613
- self._write_node(node_id, new_path, fm, node["content"])
5618
+ sealed = self._write_node(node_id, new_path, fm, node["content"])
4614
5619
  old_full = os.path.join(self.root, node["path"])
4615
5620
  if (os.path.abspath(old_full) != os.path.abspath(new_path)
4616
5621
  and os.path.exists(old_full)):
4617
5622
  os.remove(old_full)
4618
5623
  rel = os.path.relpath(new_path, self.root).replace("\\", "/")
4619
- # N137(2026-10-01):本条 _stage 条目此前缺 edges / subgraph / 双时间轴
4620
- # (trust.FROM/UNTIL/EFFECTIVE_FROM/EFFECTIVE_UNTIL)四组键——搬迁 =
4621
- # 「删除源层条目 + 写入目标层条目」,缺键即让目标层条目**静默退化**:
4622
- # ① 新检索路(P3-causal 的 chain 路走 index 的 edges 建邻接、P3-temporal
4623
- # 走索引标量)搬迁后对它即不可达(节点还在,边/时刻没了);
4624
- # ② trust.validity 的时效过滤免读盘判定失效(valid_from/until 不在快照)。
4625
- # 写入口 `_node_entry`(_scan_nodes / rebuild 共用)与 `add()` 的 _stage
4626
- # 条目都带这些键——本条与之对齐,杜绝「重建后有、搬迁后没有」的形态漂移。
4627
- self._stage(node_id, _strip_empty_gate_fields({
4628
- "path": rel, "layer": to_layer, "tags": fm.get("tags", []),
4629
- "bucket": None, "importance": fm.get("importance", 0.5),
4630
- "created_at": fm.get("created_at", 0),
4631
- "verification_basis": fm.get("verification_basis"),
4632
- # A1(2026-10-05,复核实证):检验强度随搬迁携带——N137 同款:
4633
- # 搬迁条目缺键=「move→普通覆写」链的继承源丢失该值 → 真丢数据。
4634
- nodefile.CHECK_STRENGTH_FIELD: fm.get(nodefile.CHECK_STRENGTH_FIELD),
4635
- # A2(2026-10-05,复核 info-①):幽灵标记随搬迁携带(字段级可见性;
4636
- # 不继承——搬迁不改正文,值从盘面 fm 读取,形态与重建条目一致)。
4637
- nodefile.UNCERTAIN_REFS_FIELD: fm.get(nodefile.UNCERTAIN_REFS_FIELD),
4638
- "has_neg_conditions": nodefile.has_non_applicable(node["content"]),
4639
- # P2-1 / P4-2①(与 `_node_entry` / `add()` 同口径;N137 的教训:
4640
- # 搬迁条目缺键 = 新检索路对搬迁后的节点静默不可达)
4641
- nodefile.POSTCONDITION_TERMS_KEY: nodefile.ccg_element_terms(
4642
- node["content"], nodefile.POSTCONDITION_FIELD),
4643
- nodefile.REJECTION_TERMS_KEY: rejection_index_terms(
4644
- fm, node["content"]),
4645
- "access_count": fm.get("access_count", 0),
4646
- "last_access": fm.get("last_access", 0),
4647
- "content_hash": hashlib.sha256(
4648
- node["content"].encode("utf-8")).hexdigest()[:12],
4649
- "temporal": fm.get("temporal"), "spatial": fm.get("spatial"),
4650
- "time_window": (fm.get("condition_space") or {}).get("time_window"),
4651
- "big_domain": fm.get("big_domain"),
4652
- "observation_position": (fm.get("condition_space") or {}).get("observation_position"),
4653
- "evidence_count": fm.get("evidence_count", 0),
4654
- # N137:边域与嵌套子图(chain 路 / 递归展开的免读盘来源)
4655
- "edges": fm.get("edges") or [],
4656
- "subgraph": fm.get("subgraph"),
4657
- # N137:双时间轴(trust.validity 的免读盘判定面,与 add/_node_entry 同口径)
4658
- trust.STATE_FIELD: fm.get(trust.STATE_FIELD),
4659
- trust.DEPS_FIELD: fm.get(trust.DEPS_FIELD),
4660
- trust.FROM_FIELD: fm.get(trust.FROM_FIELD),
4661
- trust.UNTIL_FIELD: fm.get(trust.UNTIL_FIELD),
4662
- trust.EFFECTIVE_FROM_FIELD: fm.get(trust.EFFECTIVE_FROM_FIELD),
4663
- trust.EFFECTIVE_UNTIL_FIELD: fm.get(trust.EFFECTIVE_UNTIL_FIELD),
4664
- }))
5624
+ # issue #192:搬迁条目改由 `_node_entry` 构造——**手写字段表已删除**。
5625
+ #
5626
+ # N137(2026-10-01)/ A1 / A2 三轮都在同一张手写表上逐个补键
5627
+ # (edges/subgraph/双时间轴、check_strength、uncertain_refs),但表与真源
5628
+ # `_node_entry` 一直在漂:实测搬迁条目 **29 键** vs `_node_entry` **43 键**,
5629
+ # 前者是后者的**真子集**——丢失 role/content_kind/session/bucket_zh/
5630
+ # importance_source/lifecycle_state/branch_id/branched_from/protected/
5631
+ # protection_reason/immutable/self_state/derived_from/derived_relation 共 14 键。
5632
+ # `_set_index_entry` 是**整条替换**(`index["nodes"][id] = entry`,不合并),
5633
+ # 故搬迁 =「删源层条目 + 写目标层条目」,缺键即静默退化(实测):
5634
+ # ① 分支实验副本 `<nid>@<branch>` 在默认检索(branch=None)里现身;
5635
+ # ② role=tool-output/command/edit 的工作节点不再被默认剔除;
5636
+ # ③ content_kind=work_wip 的草稿进入 verifier 视图;
5637
+ # ④ session 丢失后按会话过滤漏节点、角色统计记成 (none)。
5638
+ # 重建路径(_scan_nodes / merge 定向 upsert / rollback._land / reconcile)
5639
+ # 早已同源——issue #34 立此单点的理由正是「字段集漂移」,搬迁不再自持一份。
5640
+ #
5641
+ # 取值口径:content 传 `_write_node` 返回的**落盘值**(private 为密文),
5642
+ # 与重建路径同源。手写表此前取 `node["content"]`(解密后明文),使
5643
+ # `content_hash`/后置条件词/拒绝域词在 `_index.json` 里留下 private 正文的
5644
+ # 明文派生词与明文 sha256 前 12 位(实测跨重启存活)。
5645
+ old_entry = self.index["nodes"].get(node_id) or {}
5646
+ entry = self._node_entry(new_path, to_layer, fm, sealed)
5647
+ # `_node_entry` 不产出的两个归因键:从 fm 带过(与 add() 的 _stage 同口径)。
5648
+ for _k in ("writer", "harness"):
5649
+ if fm.get(_k) is not None:
5650
+ entry[_k] = fm[_k]
5651
+ # 密级取**旧条目**而非 fm:基类 MdCG 无密级概念,从 fm 取会给它凭空长出该键、
5652
+ # 改变条目形态(`_node_entry` 同样不产出该键;MdCGSecure 读时按盘面回填)。
5653
+ if old_entry.get("sensitivity") is not None:
5654
+ entry["sensitivity"] = old_entry["sensitivity"]
5655
+ self._stage(node_id, entry)
4665
5656
  self.index["buckets"] = self._count_buckets(self.index["nodes"])
4666
5657
  return {"id": node_id, "from": from_layer, "to": to_layer,
4667
5658
  "path": rel, "reason": reason}
@@ -4688,8 +5679,9 @@ class MdCG:
4688
5679
  if not node:
4689
5680
  return None
4690
5681
  if verdict == "falsified":
4691
- # 写保护(N130,2026-09-25):证伪 = 对原节点的一次**硬删除**
4692
- # (os.remove,无快照、不进 trash),与 forget/降级同受「不可遗忘」
5682
+ # 写保护(N130,2026-09-25):证伪 = 对原节点的一次**删除**——软删
5683
+ # (进 trash/ + 写删除清单,restore(node_id, force=True) 可复原),
5684
+ # 与 forget/降级同受「不可遗忘」
4693
5685
  # 保护——self/anchor 层、protected 标记、importance≥0.7 不得被一次
4694
5686
  # verify 调用一键删除。对照 forget 路径(mdcos.py forget)同一闸口:
4695
5687
  # 受保护节点需显式 override=True(旧版本先快照进 _protected_history
@@ -4698,12 +5690,40 @@ class MdCG:
4698
5690
  protect.guard_forget(self, node_id, override=override,
4699
5691
  actor=getattr(self, "actor", None))
4700
5692
  # 移入 rejected:负记忆化
5693
+ # issue #214(同根出口):证伪存根取**原节点 frontmatter 的密级**。
5694
+ # 不传 ⇒ 按 internal 明文落盘:一个 private 节点被证伪后,其正文前
5695
+ # 200 字反而变成 internal 明文——「删掉的比留下的更泄露」。
5696
+ # (#144 收口时曾列为未纳入的改进项。)
4701
5697
  self.add_rejected(hypothesis=node["content"][:200],
4702
5698
  reason=evidence,
4703
- verification_basis="test")
4704
- # 从原位置删除(节点进入 rejected 层)
4705
- os.remove(os.path.join(self.root, node["path"]))
4706
- self._unstage(node_id) # 同上:索引删除必须可重放(防幽灵条目)
5699
+ verification_basis="test",
5700
+ sensitivity=(node.get("frontmatter") or {})
5701
+ .get("sensitivity"))
5702
+ # 从原位置删除(节点进入 rejected 层)——**走软删单点**,与 forget
5703
+ # 同一条可恢复路径:MdCGOS._forget_apply(节点文件移入 trash/ +
5704
+ # 写删除清单 + _unstage 摘索引)。此前这里是 os.remove **硬删**
5705
+ # (无快照、不进 trash、restore 恒 not_in_trash)——同一份记忆在
5706
+ # verify 与 forget 两条路径上可恢复性分叉(一次裁决即不可逆丢失)。
5707
+ _sdel = getattr(self, "_forget_apply", None)
5708
+ if _sdel is not None:
5709
+ _sdel(node_id, self.index["nodes"].get(node_id) or node, evidence)
5710
+ else:
5711
+ # 纯 MdCG(未挂载 mdcos 的 OS 软删面)**不得硬删**:就地按同一
5712
+ # 口径兜底——同一 trash/ 布局、同一删除清单、同一摘索引收尾
5713
+ # (不是第二套判据;宁可不删也不丢数据,绝不退化成硬删)。
5714
+ _tdir = os.path.join(self.root, "trash")
5715
+ os.makedirs(_tdir, exist_ok=True)
5716
+ _dst = os.path.join(_tdir, "%s.md" % node_id)
5717
+ os.replace(os.path.join(self.root, node["path"]), _dst)
5718
+ append_jsonl(os.path.join(self.root, "_deletions.jsonl"),
5719
+ {"t": time.time(), "id": node_id,
5720
+ "hash": hashlib.sha256(
5721
+ (node.get("content") or "").encode("utf-8")
5722
+ ).hexdigest()[:16],
5723
+ "reason": evidence, "actor": None,
5724
+ "trash": os.path.relpath(_dst, self.root)
5725
+ .replace(os.sep, "/")})
5726
+ self._unstage(node_id)
4707
5727
  trust.invalidate_cache(self) # 索引已变 → 反查索引作废
4708
5728
  # 地基塌了:直接下游立即标存疑(**同步一跳**,永不抛、不阻断本次裁决)
4709
5729
  propagation = trust.mark_dependents(
@@ -4726,9 +5746,36 @@ class MdCG:
4726
5746
  fm[key] = int(fm.get(key) or 0) + 1
4727
5747
  fm.setdefault("evidence_log", []).append(
4728
5748
  {"t": time.time(), "verdict": verdict, "evidence": evidence})
5749
+ # #410(2026-10-16):本轮 fm 的**落盘尾**收成**单点**——两个分支都必须过它。
5750
+ # 此前降级分支整段跳过它(只搬层不落盘)⇒ 本轮 confidence/evidence_count/
5751
+ # negative_evidence/evidence_log 只在内存里,回执照报内存值而盘面是旧值
5752
+ # (回执与盘面不一致 = 回执不实),且**触发降级的证据本身丢失**;索引侧
5753
+ # 也不同步、不标脏(同族先例:C-1 / N133 的「写后读」纪律)。
5754
+ def _land_fm():
5755
+ """本轮 fm 的落盘尾(**单点**):写盘 + 索引同步 + 标脏。
5756
+
5757
+ 为何必须单点:分叉过一次(#410 降级轮漏了整段),而「改内存状态」与
5758
+ 「落盘」一旦分开写,就会在某个分支上再次漂开——本批把两分支收成同一处。
5759
+ """
5760
+ self._write_node(node_id, os.path.join(self.root, node["path"]),
5761
+ fm, node["content"])
5762
+ e = self.index["nodes"].get(node_id)
5763
+ if e is not None:
5764
+ e["evidence_count"] = fm["evidence_count"]
5765
+ # 落盘必须对索引增量日志(_dirty→flush→_index_log 重放)与
5766
+ # 读缓存代际可见:本分支写盘后若节点已在目标验证态,尾部
5767
+ # set_verification 走 noop 提前返回(trust.py stamp),不会
5768
+ # 经 _sync_index 标脏——不显式置 _dirty 会造成重开后索引
5769
+ # evidence_count 与盘面漂移、同实例 _read 命中旧 frontmatter
5770
+ #(口径同边域同步 _sync_edge_entry / goal 状态写回)。
5771
+ self._dirty[node_id] = e
5772
+
4729
5773
  demoted = None
4730
5774
  if (verdict == "weakened" and fm["confidence"] < DEMOTE_CONFIDENCE
4731
5775
  and (fm.get("layer") or "") == "knowledge"):
5776
+ # #410:**先落盘本轮 fm,再搬层**——_move_layer 读到的就是这份新 fm,
5777
+ # 搬过去的内容与回执同源(顺序依据见交付汇报)。
5778
+ _land_fm()
4732
5779
  demoted = self._move_layer(
4733
5780
  node_id, "contextual",
4734
5781
  reason=f"confidence {fm['confidence']} < {DEMOTE_CONFIDENCE}")
@@ -4739,18 +5786,7 @@ class MdCG:
4739
5786
  reason=f"confidence {fm['confidence']} < {DEMOTE_CONFIDENCE}",
4740
5787
  actor="verify:weakened")
4741
5788
  else:
4742
- self._write_node(node_id, os.path.join(self.root, node["path"]),
4743
- fm, node["content"])
4744
- e = self.index["nodes"].get(node_id)
4745
- if e is not None:
4746
- e["evidence_count"] = fm["evidence_count"]
4747
- # 落盘必须对索引增量日志(_dirty→flush→_index_log 重放)与
4748
- # 读缓存代际可见:本分支写盘后若节点已在目标验证态,尾部
4749
- # set_verification 走 noop 提前返回(trust.py stamp),不会
4750
- # 经 _sync_index 标脏——不显式置 _dirty 会造成重开后索引
4751
- # evidence_count 与盘面漂移、同实例 _read 命中旧 frontmatter
4752
- #(口径同边域同步 _sync_edge_entry / goal 状态写回)。
4753
- self._dirty[node_id] = e
5789
+ _land_fm() # #410:与非降级轮**同一条落盘尾**(单点)
4754
5790
  # 验证态流转(可验证记忆单元):外部证据裁决**就是**验证态迁移。
4755
5791
  # confirmed → verified(首次转正;已在 verified 则幂等 no-op)
4756
5792
  # weakened → doubted(证据被削弱 ⇒ 存疑,待复核)
@@ -4771,8 +5807,18 @@ class MdCG:
4771
5807
  propagation = trust.mark_dependents(
4772
5808
  self, node_id, reason=f"上游验证结论变为 {verdict}",
4773
5809
  actor=f"verify:{verdict}", trigger=f"verify_{verdict}")
4774
- return {"action": verdict, "confidence": fm["confidence"],
4775
- "evidence_count": fm["evidence_count"], "demoted": demoted,
5810
+ # #410:回执字段改为**落盘后回读**(回执说什么,盘面就该是什么);读不到
5811
+ # (异常/节点消失)才回落内存值,绝不把未落盘的值当盘面值报出去。
5812
+ try:
5813
+ _disk = self.get(node_id)
5814
+ except Exception: # noqa: BLE001 —— 回读失败不改已完成的裁决
5815
+ _disk = None
5816
+ _dfm = (_disk or {}).get("frontmatter") or {}
5817
+ return {"action": verdict,
5818
+ "confidence": _dfm.get("confidence", fm["confidence"]),
5819
+ "evidence_count": _dfm.get("evidence_count",
5820
+ fm["evidence_count"]),
5821
+ "demoted": demoted,
4776
5822
  "verification": ver, "propagation": propagation}
4777
5823
 
4778
5824
  # ---------- 知识飞轮(白箱第 2 篇第 8 章)----------
@@ -4793,6 +5839,22 @@ class MdCG:
4793
5839
  try_data = json.loads(error_report) if isinstance(error_report, str) else error_report
4794
5840
  _q = try_data.get('query', '?')
4795
5841
  _st = try_data.get('actual_state', '?')
5842
+ # issue #294(2026-10-14):调用方声明的密级。修前这一跳把 payload 原样
5843
+ # 用掉,工单便按 add_unresolved 的缺省档 internal 明文落盘。缺省 None=
5844
+ # 调用方未声明,走 #87 的 internal,**逐键不变**(零变化面)。
5845
+ _sens = try_data.get("sensitivity")
5846
+ _topic = f"{_q}|{_st}"
5847
+ _kw = {}
5848
+ if _sens:
5849
+ _kw["sensitivity"] = _sens
5850
+ if _sens not in ("public", "internal"):
5851
+ # 工单 id 由**正文 slug** 而来,明文写进文件名、_index.json 与
5852
+ # _audit.jsonl——密级高于 internal 时改用不可逆身份:正文不再
5853
+ # 进文件名与索引。身份里带密级,private 与 restricted 的同一段
5854
+ # 话不会落到同一张工单上互相覆写正文;同一密级同一主题仍得同一
5855
+ # id(H11⑦「同题同单」不变)。
5856
+ _topic = "h" + hashlib.sha1(
5857
+ ("%s|%s" % (_sens, _topic)).encode("utf-8")).hexdigest()[:16]
4796
5858
  question = (f"为何 {_q} 出现 {_st}"
4797
5859
  f" 而期望 {try_data.get('expected_state','?')}?")
4798
5860
  clues = try_data.get("missing", "")
@@ -4806,12 +5868,36 @@ class MdCG:
4806
5868
  if not isinstance(d, dict):
4807
5869
  continue
4808
5870
  if d.get("type") == "same_condition_divergence":
4809
- parts.append("同条件取值分歧 vs %s(条件重合 %s / 槽位 %s / 结论差异 %s)"
5871
+ # issue #217:分路读数进人工裁决证据串。缺 slot_routes 的历史
5872
+ # 记录(或别处构造的分歧条目)走原样,不因新键缺失而变形。
5873
+ _sr = d.get("slot_routes")
5874
+ _route = ""
5875
+ if isinstance(_sr, dict) and _sr:
5876
+ _route = "/槽位分路 功能名 %s·子功能 %s%s" % (
5877
+ _sr.get("功能名"), _sr.get("子功能"),
5878
+ "(仅一路达标)" if d.get("slot_single_route") else "")
5879
+ # issue #215:两侧口径差进证据串(缺则走原样)。
5880
+ _cd = d.get("cond_routes")
5881
+ _cd_txt = ""
5882
+ if isinstance(_cd, dict) and _cd:
5883
+ _cd_txt = "/条件两侧 新 %s 项·既有 %s 项·%s" % (
5884
+ _cd.get("new_side"), _cd.get("existing_side"),
5885
+ "同源" if _cd.get("same_source") else "**不同源**")
5886
+ parts.append("同条件取值分歧 vs %s(条件重合 %s / 槽位 %s / 结论差异 %s%s%s)"
4810
5887
  % (d.get("with"), d.get("same_condition"),
4811
- d.get("slot_overlap"), d.get("conclusion_overlap")))
5888
+ d.get("slot_overlap"), d.get("conclusion_overlap"),
5889
+ _route, _cd_txt))
4812
5890
  elif d.get("type") == "condition_clash":
4813
- parts.append("条件互斥 vs %s(覆盖 %s)"
4814
- % (d.get("with"), d.get("score")))
5891
+ # issue #216:c1/c2 分路读数进人工裁决证据串(缺则走原样)。
5892
+ _cr = d.get("clash_routes")
5893
+ _cr_txt = ""
5894
+ if isinstance(_cr, dict) and _cr:
5895
+ _tm = _cr.get("terms") or {}
5896
+ _cr_txt = "/分路 c1 %s·c2 %s(词项 pos %s/neg %s·既有 pos %s/neg %s)" % (
5897
+ _cr.get("c1"), _cr.get("c2"), _tm.get("tw_pos"),
5898
+ _tm.get("tw_neg"), _tm.get("e_pos"), _tm.get("e_neg"))
5899
+ parts.append("条件互斥 vs %s(覆盖 %s%s)"
5900
+ % (d.get("with"), d.get("score"), _cr_txt))
4815
5901
  elif d.get("type"):
4816
5902
  parts.append("%s vs %s" % (d.get("type"), d.get("with")))
4817
5903
  nid = self.add_unresolved(question=question, known_clues=clues,
@@ -4819,7 +5905,9 @@ class MdCG:
4819
5905
  context=" | ".join(parts),
4820
5906
  # ⑦ 身份文本:只取「主题|实际态」——问题模板措辞、
4821
5907
  # reason、missing、现场数值一变就不再是新工单。
4822
- topic=f"{_q}|{_st}")
5908
+ # (密级高于 internal 时 _topic 已换成不可逆身份,
5909
+ # 见上方 issue #294 段。)
5910
+ topic=_topic, **_kw)
4823
5911
  return {"unresolved_id": nid, "question": question}
4824
5912
 
4825
5913
  # ---------- 访问计数:append-only,检索路径不写节点文件 ----------
@@ -4827,8 +5915,12 @@ class MdCG:
4827
5915
  # 生效条件:无条件尝试把 {"t": time.time(), "ids": list(node_ids), "tier": tier} 追加到 access_log,append 抛 OSError 时静默吞掉;
4828
5916
  def record_access(self, node_ids, tier=None):
4829
5917
  try:
4830
- append_jsonl(self.access_log,
4831
- {"t": time.time(), "ids": list(node_ids), "tier": tier})
5918
+ # #326-④:append_jsonl 不再上抛、以 False 报写失败——本处**仍容忍**(best-effort
5919
+ # 簿记),但失败不再静默:源头已记 fsutil.APPEND_FAILURES + 有界 stderr 告警
5920
+ # (B 面单点)。显式消费返回值:不留裸调用(守卫 AST 钉子会抓)。
5921
+ _ok = append_jsonl(self.access_log,
5922
+ {"t": time.time(), "ids": _ensure_list(node_ids),
5923
+ "tier": tier})
4832
5924
  except OSError:
4833
5925
  pass
4834
5926
 
@@ -4925,4 +6017,10 @@ class MdCG:
4925
6017
  h["ccg_by_layer"] = layer_stats
4926
6018
  h["neg_memory_counts"] = neg_stats
4927
6019
  h["skipped_unreadable"] = skipped_unreadable
6020
+ # issue #146②:**隔离文件清单**(键只在确有隔离文件时出现——健康库
6021
+ # 的 health 键集逐位不变,故既有守卫/调用方零感知)。报路径 + 原因,
6022
+ # 使「某节点为什么搜不到」在体检面可回答,而不是静默消失。
6023
+ _quar = getattr(self, "_quarantined", None)
6024
+ if _quar:
6025
+ h["quarantined"] = {k: dict(v) for k, v in sorted(_quar.items())}
4928
6026
  return h