@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/routing.py CHANGED
@@ -1,430 +1,491 @@
1
- # -*- coding: utf-8 -*-
2
- """md 认知图 · 路由键归一化(风险1)
3
-
4
- 普查结论(wisdom-book-cloud-new.db, 3048 节点):
5
- - 原始 condition_space 四元组作分桶键 → 3037 桶 / 3048 节点,99.9% 单例桶。
6
- 根因:observation_position 实际格式是「<域> 知识点(<实例名>)」,把节点特有的
7
- 实例名嵌进了条件字段,3033 种取值 ≈ 唯一。按它分桶 = 一节点一桶,查询侧
8
- 构造不出精确匹配的情境 → 命中率≈0,召回归零(比退化成全量更糟)。
9
- - observation_tool(93% 集中) / existence_constraint(95% 集中) 去掉 position 后
10
- 塌缩成单个巨桶。
11
- - time_window 实测仅 3 种取值,进哈希键是纯噪声。
12
- - tags 的 domain: 标签 → 95 桶 / 最大桶 5.4% / 期望扫描 1.8%,是唯一健康的键。
13
-
14
- 因此路由键 = 归一化提取的「域」,而非四元组哈希。写入侧与查询侧共用本模块,
15
- 保证两侧同构(风险2 的前提:查询构造的键必须与写入键落在同一空间)。
16
- """
17
- import math
18
- import re
19
- import hashlib
20
- import unicodedata
21
-
22
- # observation_position 的实例名尾巴:「知识点(xxx)」「概念(xxx)」等
23
- _INSTANCE_TAIL = re.compile(
24
- r"\s*(知识点|概念|条目|卡片|节点|规律|定理|公式)\s*[((].*?[))]\s*$"
25
- )
26
- # 骨架填充类后缀:「高中物理知识点内容(按骨架填充)」→「高中物理」
27
- _SKELETON_TAIL = re.compile(r"(知识点)?内容\s*[((]按骨架填充[))]\s*$")
28
-
29
- ORPHAN = "orphan"
30
-
31
-
32
- # 生效条件:raw 为真值时按 NFKC 归一化并 strip,最多 3 轮剥离 _INSTANCE_TAIL(无变化即停)、再剥 _SKELETON_TAIL、空白转下划线后返回;raw 为假值(None/空串)或处理后为空串时返回 ORPHAN。
33
- def normalize_domain(raw: str) -> str:
34
- """把自由文本的域描述归一化成稳定的短键。
35
-
36
- 「工程学 知识点(内力与截面法)」 → 工程学
37
- 「高中物理知识点内容(按骨架填充)」 → 高中物理
38
- 「数学分析知识点内容(按骨架填充) 知识点(贝塞尔不等式)」 → 数学分析
39
- """
40
- if not raw:
41
- return ORPHAN
42
- s = unicodedata.normalize("NFKC", str(raw)).strip()
43
- # 反复剥离实例名尾巴(可能叠加两层,见上面第三个例子)
44
- for _ in range(3):
45
- new = _INSTANCE_TAIL.sub("", s)
46
- if new == s:
47
- break
48
- s = new.strip()
49
- s = _SKELETON_TAIL.sub("", s).strip()
50
- s = re.sub(r"\s+", "_", s)
51
- return s or ORPHAN
52
-
53
-
54
- # 生效条件:tags 为真值时取其中首个 str(t) 以 "domain:" 开头的项,返回其前缀后内容的 normalize_domain 结果;无此标签且 condition_space 为真值时返回 normalize_domain(condition_space.get("observation_position"))(缺键即 None 归一为 ORPHAN);tags 为假值且 condition_space 为假值时返回 ORPHAN。
55
- def route_key(condition_space: dict = None, tags=None) -> str:
56
- """导出条件路由键。优先级:tags 的 domain: > observation_position 归一化 > orphan。
57
-
58
- domain: 标签是显式声明的域,普查证明它分布最健康(95 桶/最大桶 5.4%),
59
- 所以优先。没有标签时才回退到从 observation_position 提取。
60
- """
61
- for t in tags or []:
62
- t = str(t)
63
- if t.startswith("domain:"):
64
- return normalize_domain(t[len("domain:"):])
65
- if condition_space:
66
- return normalize_domain(condition_space.get("observation_position"))
67
- return ORPHAN
68
-
69
-
70
- # 生效条件:key 等于 ORPHAN 时原样返回 ORPHAN;否则返回 "cond_" + 把 key 中非[\w中文-]字符替换为下划线并截前 24 字符的串 + "_" + key 的 sha256(utf-8)前 8 位十六进制。
71
- def bucket_dir(key: str) -> str:
72
- """路由键 → 目录名。中文键保留可读前缀 + 短哈希,避免文件系统非法字符/超长。"""
73
- if key == ORPHAN:
74
- return ORPHAN
75
- safe = re.sub(r"[^\w\u4e00-\u9fff-]", "_", key)[:24]
76
- h = hashlib.sha256(key.encode("utf-8")).hexdigest()[:8]
77
- return f"cond_{safe}_{h}"
78
-
79
-
80
- # 14 大域代表词表(白箱第 2 篇第 5 章 + 第 3 篇第 4 章:「56 学科卡 → 14 大域
81
- # → 域内 KCCS」两阶段并行收敛。本表用作阶段 1 的大域并行打分依据——
82
- # 当 query 没有显式 context 但 query 词能落进某个大域时,先收敛到大域再查。
83
- #
84
- # 词的选取原则:覆盖白箱工程文档里出现的高频学科关键词,且不互相吞并。
85
- # 同一个词可以出现在多个大域(如「公式」在数学与物理都常见),这是合理的:
86
- # 大域并行打分阶段就是让多域同分,再由阶段 2 的 KCCS 进一步区分。
87
- BIG_DOMAINS = {
88
- "数学": {"数学", "算术", "几何", "代数", "微积分", "概率", "统计", "集合", "矩阵",
89
- "线性", "拓扑", "数论", "公式", "定理", "证明", "函数", "导数", "积分",
90
- "极限", "方程", "不等式", "贝塞尔", "二分", "素数", "微元"},
91
- "物理": {"物理", "力学", "电磁", "光学", "热学", "量子", "相对论", "能量", "动量",
92
- "质量", "速度", "加速度", "电荷", "电压", "电流", "沸点", "海拔",
93
- "大气压", "压强", "温度", "牛顿", "惯性", "引力"},
94
- "化学": {"化学", "元素", "分子", "原子", "化合物", "反应", "酸", "碱", "盐",
95
- "氧化", "还原", "有机", "无机", "离子", "键", "浓度", "溶液"},
96
- "生物": {"生物", "细胞", "基因", "蛋白质", "酶", "光合", "呼吸", "植物", "动物",
97
- "进化", "免疫", "神经", "细菌", "病毒", "代谢", "染色", "分裂"},
98
- "计算机": {"计算机", "算法", "数据结构", "编程", "代码", "软件", "网络", "数据库",
99
- "系统", "排序", "递归", "图论", "哈希", "索引", "查询", "排序", "锁",
100
- "事务", "内存", "进程", "线程"},
101
- "语言": {"语言", "中文", "英文", "语法", "词汇", "语义", "修辞", "文学", "写作",
102
- "阅读", "拼音", "字", "词", "句"},
103
- "历史": {"历史", "朝代", "战争", "文明", "政治", "经济史", "文化史", "古代",
104
- "近代", "现代", "王朝", "革命", "改革"},
105
- "地理": {"地理", "地形", "气候", "人口", "城市", "国家", "地图", "板块",
106
- "洋流", "经度", "纬度", "海拔带", "流域"},
107
- "艺术": {"艺术", "绘画", "音乐", "雕塑", "电影", "设计", "色彩", "构图",
108
- "旋律", "节奏", "摄影"},
109
- "经济": {"经济", "市场", "金融", "货币", "投资", "股票", "债券", "GDP",
110
- "通胀", "财政", "税收", "供需"},
111
- "心理": {"心理", "认知", "情感", "记忆", "学习", "性格", "行为", "意识",
112
- "动机", "人格", "焦虑"},
113
- "医学": {"医学", "疾病", "治疗", "药物", "诊断", "外科", "内科", "儿科",
114
- "中医", "症状", "病理", "处方"},
115
- "工程": {"工程", "建筑", "结构", "材料", "机械", "电子", "土木", "桥梁",
116
- "内力", "截面", "梁", "柱", "应力"},
117
- "通用": {"常识", "生活", "日常", "通用", "礼仪", "礼貌", "文明", "规则"},
118
- }
119
-
120
-
121
- # 生效条件:terms 为真值时对 BIG_DOMAINS 每个大域统计命中词数,最高分为 0 或 terms 为假值(None/空)时返回 None,否则返回最高分大域名(并列取 BIG_DOMAINS 迭代序首个最高分)。
122
- def big_domain_classify(terms) -> str | None:
123
- """阶段 1:14 大域并行打分 → 收敛到 top-1。
124
-
125
- terms 是 expand_query_terms 返回的扩展词集合。
126
- 大域打分 = query 词命中大域代表词的次数(多词同域累加)。
127
- 并行在认知结构意义上:即使底层串行计算,14 个大域同时独立评估。
128
-
129
- 返回最匹配的大域名(多个 0 分 → 返回 None,走原 bucket_dir 路由)。
130
- """
131
- if not terms:
132
- return None
133
- scores = {}
134
- for d, vocab in BIG_DOMAINS.items():
135
- scores[d] = sum(1 for t in terms
136
- if any(w in t or t in w for w in vocab))
137
- best = max(scores.items(), key=lambda x: x[1])
138
- if best[1] == 0:
139
- return None
140
- # 多大域并列最高分时,按字典序取第一个稳定结果(避免浮点不确定)
141
- return best[0]
142
-
143
-
144
- # 生效条件:terms 为假值(None/空)时返回 {每个 BIG_DOMAINS 域: 0};terms 为真值时返回 {大域: 该域词表命中 terms 中词的个数}。
145
- def big_domain_score_breakdown(terms) -> dict:
146
- """暴露打分明细,便于审计与回归测试。"""
147
- if not terms:
148
- return {d: 0 for d in BIG_DOMAINS}
149
- return {d: sum(1 for t in terms if any(w in t or t in w for w in vocab))
150
- for d, vocab in BIG_DOMAINS.items()}
151
-
152
-
153
- # ---------------------------------------------------------------------------
154
- # 分级隶属度(模糊控制「隶属函数」的手写版)
155
- #
156
- # 上面的 big_domain_classify 是二值控制:`w in t or t in w` 命中即计 1。
157
- # 下面是同一套规则库的**分级**版本——命中程度是 0~1 的连续值,并乘 IDF:
158
- # · 隶属度 membership(t, w):完全相同 1.0;包含关系取长度比(覆盖越全越高)
159
- # · IDF:一个代表词覆盖的大域越少,区分度越高(「贝塞尔」只在数学出现,
160
- # 权重高于「公式」这种跨域通用词)
161
- # 老函数保持不动 → P0/P1 基线可比性不受影响;新函数只供新路径(fuzzy)使用。
162
- # ---------------------------------------------------------------------------
163
-
164
- # 生效条件:term 或 word 为假值(None/空串)返回 0.0;相等返回 1.0;word 是 term 子串返回 len(word)/len(term);term 是 word 子串返回 len(term)/len(word);二者无包含关系返回 0.0。
165
- def membership(term: str, word: str) -> float:
166
- """词 term 对代表词 word 的隶属度(0.0~1.0,越接近 1 越隶属)。
167
-
168
- 完全相同 → 1.0
169
- term 包含 word → len(word)/len(term)(覆盖越全越隶属)
170
- word 包含 term → len(term)/len(word)
171
- 无包含关系 → 0.0
172
- """
173
- if not term or not word:
174
- return 0.0
175
- if term == word:
176
- return 1.0
177
- if word in term:
178
- return len(word) / len(term)
179
- if term in word:
180
- return len(term) / len(word)
181
- return 0.0
182
-
183
-
184
- # 生效条件:无入参,恒遍历模块级常量 BIG_DOMAINS 的各域代表词表,返回 {代表词: 包含该词的域个数}。
185
- def _build_domain_df() -> dict:
186
- """代表词 → 覆盖它的大域数(IDF 的分母)。"""
187
- df = {}
188
- for vocab in BIG_DOMAINS.values():
189
- for w in vocab:
190
- df[w] = df.get(w, 0) + 1
191
- return df
192
-
193
-
194
- _DOMAIN_DF = _build_domain_df()
195
-
196
-
197
- # 生效条件:恒返回 math.log(1.0 + len(BIG_DOMAINS) / _DOMAIN_DF.get(word, 1)),即 word 在 _DOMAIN_DF 中取其覆盖域数,缺键(含任何未登记值)时按 _DOMAIN_DF.get 的默认 1 代入。
198
- def domain_idf(word: str) -> float:
199
- """代表词的区分度权重:log(1 + 大域总数 / 覆盖它的大域数)。
200
-
201
- 只在一个大域出现的词(如「贝塞尔」)≈ log(15)=2.71;
202
- 14 个大域都出现的词(如「公式」)≈ log(2)=0.69。
203
- """
204
- return math.log(1.0 + len(BIG_DOMAINS) / _DOMAIN_DF.get(word, 1))
205
-
206
-
207
- # 生效条件:terms 是 dict 时以其条目(键 str(t) 以 "__" 开头者剔除、值为 float)为词权重并忽略 weights,否则以 wmap.get(t, 1.0) 为权重(weights 为假值即 None/空 dict 时 wmap 为空、全部权重取 1.0,terms 为假值则词集为空);逐域累加「词权重 × 该词在域词表内最大(membership × domain_idf)」,权重 <=0 的词跳过,返回 {大域: round(得分, 6)}。
208
- def big_domain_score_weighted(terms, weights=None) -> dict:
209
- """阶段 1(分级版):14 大域并行打分,按「隶属度 × IDF」加权。
210
-
211
- terms: 可迭代的词集合,或 {词: 权重}(expand_query_terms_weighted 的输出,
212
- 调用方需先剔除 "__source__" 等元数据键)。
213
- weights: terms 为可迭代时的可选权重表;terms 已是 dict 时忽略。
214
- 返回 {大域: 得分},得分不再是整数计数,而是连续值。
215
- """
216
- if isinstance(terms, dict):
217
- tw = {str(t): float(w) for t, w in terms.items()
218
- if not str(t).startswith("__")}
219
- else:
220
- wmap = weights or {}
221
- tw = {str(t): float(wmap.get(t, 1.0)) for t in (terms or [])}
222
- out = {}
223
- for d, vocab in BIG_DOMAINS.items():
224
- s = 0.0
225
- for t, tw_ in tw.items():
226
- if tw_ <= 0:
227
- continue
228
- best = 0.0
229
- for w in vocab:
230
- m = membership(t, w)
231
- if m > 0.0:
232
- best = max(best, m * domain_idf(w))
233
- s += tw_ * best
234
- out[d] = round(s, 6)
235
- return out
236
-
237
-
238
- # 生效条件:以 terms、weights 计算各域加权得分(terms 为假值时各域均为 0.0),得分为空或最高分 <= min_score(默认 0.0)时返回 None,否则返回最高分大域名。
239
- def big_domain_classify_weighted(terms, weights=None, min_score: float = 0.0):
240
- """阶段 1(分级版)收敛到 top-1;全部低于 min_score → None。"""
241
- scores = big_domain_score_weighted(terms, weights)
242
- if not scores:
243
- return None
244
- best = max(scores.items(), key=lambda kv: kv[1])
245
- if best[1] <= min_score:
246
- return None
247
- return best[0]
248
-
249
-
250
- # 生效条件:a 或 b 为假值(None/空串)返回 0.0;相等返回 1.0;a 是 b 子串返回 len(a)/len(b);b 是 a 子串返回 len(b)/len(a);否则按二者二元组字符集合的 Jaccard 返回 len(ga & gb)/len(ga | gb),任一集合为空(如单字符键)时返回 0.0。
251
- def domain_similarity(a: str, b: str) -> float:
252
- """两个归一化域键的相似度(0~1):相同 1.0;包含取长度比;否则二元组 Jaccard。
253
-
254
- 「计算机科学」vs「计算机」→ 0.6(包含);「高中物理」vs「物理」→ 0.5;
255
- 完全无关 → 0.0。用于 fuzzy 路径的「大域亲和」打分。
256
- """
257
- if not a or not b:
258
- return 0.0
259
- if a == b:
260
- return 1.0
261
- if a in b:
262
- return len(a) / len(b)
263
- if b in a:
264
- return len(b) / len(a)
265
- ga = {a[i:i + 2] for i in range(len(a) - 1)}
266
- gb = {b[i:i + 2] for i in range(len(b) - 1)}
267
- if not ga or not gb:
268
- return 0.0
269
- return len(ga & gb) / len(ga | gb)
270
-
271
-
272
- # 生效条件:counts 各值之和为 0(含空 dict 与全 0 计数)时——total_nodes 为假值(缺省 None 或 <=0)返回 {'ok': True, 'reason': 'empty', 'buckets': 0}(与加 total_nodes 参数之前逐位一致),total_nodes > 0 返回 {'ok': False, 'reason': 'empty_buckets', 'buckets': 0, 'nodes': total_nodes, 'problems': [...]};否则在「桶数 >1 且最大桶占比 >30%」、「桶数 >1 且单例桶占比 >50%」、「桶数 ==1(单桶,条件路由不可用)」、桶数 >1 时「期望扫描 >30%」中命中的项写入 problems,返回含 ok(=problems 为空)、buckets、nodes、max_bucket_share、singleton_ratio、expected_scan、problems 的 dict。
273
- def bucket_health(counts: dict, total_nodes: int = None) -> dict:
274
- """分区健康度自检。分桶键一旦退化(巨桶或碎片化),条件路由就是纸面收益,
275
- 必须在写入侧就能发现,而不是等召回变差才回头查。
276
-
277
- counts: {bucket_dir: node_count}
278
- total_nodes: 调用方(`MdCG.health`)持有的**库内节点总数**,唯一用途是把
279
- 「真空库(无节点、无桶)」与「有节点但分桶表为空(分区信息缺失)」分开。
280
- **缺省 None ⇒ 不做该比对**:空 counts 的返回与加本参数之前逐位一致,
281
- 故既有调用方(test_p0 / bench_axis_domain / bench6_arms,只传 counts)
282
- 行为一字不变——M3③ 的向后兼容面。
283
-
284
- 单桶(nb == 1)是「从未分区」而不是「分区退化」:巨桶判据(top/n == 1.0)与
285
- 期望扫描判据(同样恒 1.0)在 nb==1 时必触发且互为同一事实,此前把这类库报成
286
- 「巨桶 / 分区失效」是假话(M3①②)。现只给一条如实读数——条件路由本就不可用;
287
- ok 仍为 False(单桶库的一次查询确实是全量扫描,判据未放宽)。
288
- """
289
- n = sum(counts.values())
290
- nb = len(counts)
291
- if not n:
292
- # 库里有节点却零个桶 ⇒ 分桶表与节点面不一致(分区信息缺失),
293
- # 不能报 ok=True 冒充健康(M3③)。total_nodes 缺省时不作此判断。
294
- if total_nodes and total_nodes > 0:
295
- return {
296
- "ok": False,
297
- "reason": "empty_buckets",
298
- "buckets": 0,
299
- "nodes": int(total_nodes),
300
- "problems": [f"分桶表为空但库内有 {int(total_nodes)} 个节点:"
301
- "分区信息缺失,条件路由不可用(非真空库)"],
302
- }
303
- return {"ok": True, "reason": "empty", "buckets": 0}
304
- top = max(counts.values())
305
- singles = sum(1 for v in counts.values() if v == 1)
306
- # 期望扫描占比:随机取一节点的情境去路由,命中桶的期望大小占全库比例
307
- expected_scan = sum(v * v for v in counts.values()) / n / n
308
- problems = []
309
- if nb > 1 and top / n > 0.30:
310
- problems.append(f"巨桶:最大桶占 {top / n:.1%}(>30% 视为分区失效)")
311
- if nb > 1 and singles / nb > 0.50:
312
- problems.append(f"碎片化:单例桶占 {singles / nb:.1%}(>50% 说明键含实例级字段)")
313
- if nb == 1:
314
- # 巨桶/期望扫描两条在 nb==1 时只是同一事实的两种写法,合并为一条如实读数。
315
- # expected_scan 的**数值**仍在返回 dict 里(下游读的是数:test_p0 :92、
316
- # bench_axis_domain :159),只有文案不再把「未分区」说成「巨桶退化」。
317
- problems.append(f"单桶:仅 1 个分桶({n} 个已分桶节点同桶),"
318
- "条件路由本就不可用(从未分区,非分区退化)")
319
- elif expected_scan > 0.30:
320
- problems.append(f"路由无效:期望扫描 {expected_scan:.1%}(接近全量)")
321
- return {
322
- "ok": not problems,
323
- "buckets": nb,
324
- "nodes": n,
325
- "max_bucket_share": top / n,
326
- "singleton_ratio": singles / nb if nb else 0.0,
327
- "expected_scan": expected_scan,
328
- "problems": problems,
329
- }
330
-
331
-
332
- # ---------------------------------------------------------------------------
333
- # 节点侧大域标签(S1 大域先验收敛的前置元数据)
334
- #
335
- # 为何需要:`big_domain_classify` 一直只作用于 **query 侧**(terms),节点侧没有域字段,
336
- # 于是「14 大域并行打分」算完只能写进 meta(审计偏差 4:先验算出来却当成报告)。
337
- # 要让大域先验真正参与候选收敛,节点必须在写入时固化自己的域。
338
- # 口径:与查询侧同一个分类器(BIG_DOMAINS + big_domain_classify),保证两侧同构。
339
- # ---------------------------------------------------------------------------
340
-
341
- # 域词取词:中文(≥2 字)与拉丁词(≥2 字)。词表命中用「包含关系」判定,
342
- # 故 2 字以上的切口足以覆盖 1~4 字代表词(如「工程」命中「工程师」)。
343
- DOMAIN_TERM_RE = re.compile(r"[\u4e00-\u9fff]{2,}|[A-Za-z][A-Za-z0-9_]{1,}")
344
-
345
-
346
- # 生效条件:text 为假值(None/空串)时返回 [];否则以 DOMAIN_TERM_RE 取词、按出现顺序去重后返回,
347
- # 最多 limit 个(limit 为假值/负数时按空处理,返回 [])。
348
- def domain_terms(text, limit: int = 400) -> list:
349
- """从节点正文/标题抽「域词」(供 big_domain_classify 使用)。
350
-
351
- 只做最小分词:中文按 ≥2 字连续片段、拉丁按 [A-Za-z][A-Za-z0-9_]+ 取词;
352
- 去重保序,最多 limit 个(默认 400,避免长文把分类器拖慢)。
353
- """
354
- if not text or not limit or limit < 1:
355
- return []
356
- out, seen = [], set()
357
- for m in DOMAIN_TERM_RE.finditer(str(text)):
358
- w = m.group(0)
359
- if w in seen:
360
- continue
361
- seen.add(w)
362
- out.append(w)
363
- if len(out) >= limit:
364
- break
365
- return out
366
-
367
-
368
- # 生效条件:bucket 为假值或等于 ORPHAN 时返回空串;否则去掉 "cond_" 前缀、并当末段为 8 位十六进制哈希时剥掉该段,返回剩余的可读键。
369
- def bucket_key_readable(bucket: str) -> str:
370
- """桶目录名 → 可读键(S1b query 侧桶推断用):'cond_感知系统_d94e90d2' → '感知系统'。
371
-
372
- 与 `bucket_dir` 互逆(丢哈希段);`orphan`/空值返回空串(S1b 不把 orphan 当键,orphan 恒作兜底)。
373
- """
374
- if not bucket or bucket == ORPHAN:
375
- return ""
376
- s = str(bucket)
377
- if s.startswith("cond_"):
378
- s = s[len("cond_"):]
379
- head, sep, tail = s.rpartition("_")
380
- if sep and len(tail) == 8 and all(c in "0123456789abcdef" for c in tail):
381
- s = head
382
- return s
383
-
384
-
385
- # 中文词判定:至少含一个汉字
386
- _ZH_RE = re.compile(r"[\u4e00-\u9fff]")
387
-
388
-
389
- # 生效条件:key 缺失或含汉字时返回 [];否则从 tags(保序在前)与 text 域词(domain_terms)中收集含汉字、长度≥2 的词,去重取前 limit 个返回。
390
- def bucket_zh_aliases(key: str, tags, text, limit: int = 6) -> list:
391
- """英文桶键的中文别名(issue #33:S1b 跨语言收敛盲区的修复面)。
392
-
393
- 机理:domain_similarity 的 bigram 兜底跨语言交集恒空——英文桶键 × 中文
394
- query 恒 0.0 → S1b 恒 no_key_match(真实库 91.1% 中文节点恰是设计目标场景)。
395
- 别名**只取节点自身内容**(tags 中文词 ∪ 正文中文域词,tags 优先),零翻译
396
- 依赖——unify_query/en_zh_terms 桥接已被 #33 实测排除(字级直译语义毁)。
397
- 键本身含中文时无跨语言问题,返回 []。
398
- """
399
- if not key or _ZH_RE.search(str(key)):
400
- return []
401
- out, seen = [], set()
402
- src = [str(t) for t in (tags or [])]
403
- src += domain_terms(text or "", limit=200)
404
- for w in src:
405
- if len(w) >= 2 and _ZH_RE.search(w) and w not in seen:
406
- seen.add(w)
407
- out.append(w)
408
- if len(out) >= limit:
409
- break
410
- return out
411
-
412
-
413
- # 生效条件:text 为假值或取不到任何域词时返回 None;否则返回 big_domain_classify(domain_terms(text))
414
- # 的结果(无有效域信号时亦为 None,调用方据此决定是否落域字段)。
415
- def classify_text(text, limit: int = 400):
416
- """正文 → 大域名(节点侧域标签真源)。与查询侧共用 big_domain_classify。
417
-
418
- 返回 None 表示「无有效域信号」——此时**不写** big_domain 字段,
419
- 该节点留在 ORPHAN/兜底池(S1 收敛时必须能被兜底召回,见契约 §3 S1 不变量)。
420
-
421
- issue #53-A:密文(`<!-- mdcg-enc:v1:…`)恒无域信号——无密钥的读面会把
422
- 密文**原样**交到这里,base64 噪声会碰巧命中词表(实测唯一命中形态=「经济」:
423
- 词表里唯一的拉丁词 GDP 被 base64 三连子串撞上),且假标签会被 backfill 的
424
- already 幂等分支永久固化。判据收在此**唯一致敏点**:节点侧全部调用方
425
- (add 写入面、backfill 回填面)自动同覆盖,无需各自设防。
426
- """
427
- from . import crypto # 延迟导入:routing 是底层模块,避免加载序耦合
428
- if crypto.is_encrypted(text):
429
- return None
1
+ # -*- coding: utf-8 -*-
2
+ """md 认知图 · 路由键归一化(风险1)
3
+
4
+ 普查结论(wisdom-book-cloud-new.db, 3048 节点):
5
+ - 原始 condition_space 四元组作分桶键 → 3037 桶 / 3048 节点,99.9% 单例桶。
6
+ 根因:observation_position 实际格式是「<域> 知识点(<实例名>)」,把节点特有的
7
+ 实例名嵌进了条件字段,3033 种取值 ≈ 唯一。按它分桶 = 一节点一桶,查询侧
8
+ 构造不出精确匹配的情境 → 命中率≈0,召回归零(比退化成全量更糟)。
9
+ - observation_tool(93% 集中) / existence_constraint(95% 集中) 去掉 position 后
10
+ 塌缩成单个巨桶。
11
+ - time_window 实测仅 3 种取值,进哈希键是纯噪声。
12
+ - tags 的 domain: 标签 → 95 桶 / 最大桶 5.4% / 期望扫描 1.8%,是唯一健康的键。
13
+
14
+ 因此路由键 = 归一化提取的「域」,而非四元组哈希。写入侧与查询侧共用本模块,
15
+ 保证两侧同构(风险2 的前提:查询构造的键必须与写入键落在同一空间)。
16
+ """
17
+ import math
18
+ import re
19
+ import hashlib
20
+ import unicodedata
21
+
22
+ # observation_position 的实例名尾巴:「知识点(xxx)」「概念(xxx)」等
23
+ _INSTANCE_TAIL = re.compile(
24
+ r"\s*(知识点|概念|条目|卡片|节点|规律|定理|公式)\s*[((].*?[))]\s*$"
25
+ )
26
+ # 骨架填充类后缀:「高中物理知识点内容(按骨架填充)」→「高中物理」
27
+ _SKELETON_TAIL = re.compile(r"(知识点)?内容\s*[((]按骨架填充[))]\s*$")
28
+
29
+ ORPHAN = "orphan"
30
+
31
+
32
+ # 生效条件:text 为任意对象(None 按空串)时返回 str(text) 的 NFKC 归一结果;不 strip、不改大小写——**本仓 NFKC 口径的唯一单点**。
33
+ def nfkc_text(text) -> str:
34
+ """NFKC 归一的**唯一单点**(全角/半角、兼容字形收口,issue #362b/c)。
35
+
36
+ `normalize_domain`(路由键)与 `mdcg.neg_condition_hits` / `mdcg.strip_boundary_terms`
37
+ (负条件判据与边界摘词面)都经此函数取 NFKC。为什么必须抽成函数:本仓的返工教训
38
+ 是「两份实现 + 注释写着同源 = 口径必分叉」(见 `mdcg.py` 里 `_ccg_line` 的副本案)。
39
+ 仓内**不得**再出现第二处 NFKC 归一实现(本模块的单点是唯一入口)——由
40
+ `md_cg/test_issue362_neg_condition.py` 的 E 组做源码面单点断言钉死。
41
+ """
42
+ return unicodedata.normalize("NFKC", "" if text is None else str(text))
43
+
44
+
45
+ #: 繁→简折叠表(#362c:**机制在位、数据待补**)。
46
+ #:
47
+ #: 为什么是空表:仓内**没有**既有的繁简映射表(证据与检索口径见
48
+ #: `md_cg/test_issue362_neg_condition.py` 的 C 组注释)。而「只覆盖本 issue 语料的
49
+ #: 最小表」会在守卫里全绿、在真实流量上静默漏拒——那是**假绿**,比没有表更坏。
50
+ #: 故按 Lead 裁定(2026-10-14):**c 项本轮挂起**,只落机制单点;表默认空 ⇒
51
+ #: 生产行为一字不动。注入点见 `trad_to_simp()` / `set_trad_to_simp()`。
52
+ TRAD_TO_SIMP = {}
53
+
54
+
55
+ # 生效条件:无参时返回当前生效的繁→简折叠表({单字符 str: 单字符 str});默认即模块级 `TRAD_TO_SIMP`(空表)。
56
+ def trad_to_simp() -> dict:
57
+ """繁简折叠表的**读取单点**(#362c 注入点之一)。"""
58
+ return TRAD_TO_SIMP
59
+
60
+
61
+ # 生效条件:table 为 {单字符 str: 单字符 str} 映射时把它设为当前折叠表并返回旧表;table 为假值时复原为空表(返回旧表)。
62
+ def set_trad_to_simp(table) -> dict:
63
+ """繁简折叠表的**写入单点**(#362c):真源一旦确定,只在此处接入。
64
+
65
+ 守卫用它注入 2~3 条**测试用**映射,证明「表一旦有,c 项链路就是通的」——
66
+ 这条非恒真对照要证明的是**机制到位**,而不是「现在没有表」。
67
+ """
68
+ global TRAD_TO_SIMP
69
+ old = TRAD_TO_SIMP
70
+ TRAD_TO_SIMP = dict(table or {})
71
+ return old
72
+
73
+
74
+ # 生效条件:text 为任意对象(None 按空串)时返回「NFKC → casefold → 繁简折叠(表非空时)」的结果;不删空白、不改标点,除这三步外不做任何其它归一。
75
+ def fold_variants(text) -> str:
76
+ """检索/判据面的**字符归一人**(#362b/c):NFKC → casefold → 繁简折叠。
77
+
78
+ NFKC 走与 `normalize_domain` 同一个 `nfkc_text` 单点,故两侧**同口径**;
79
+ casefold 追加大小写折叠(`4G`/`4g`、`PDF`/`pdf`);繁简折叠表**当前为空**
80
+ (见 `TRAD_TO_SIMP`),表非空时逐字符替换。
81
+
82
+ 刻意**不做**超出这三步的任何归一(不删标点、不并同音、不做拼音)——过度归一
83
+ 与归一缺失同样是缺陷:守卫 K 组有 `C++`/`A-B`/`Ⅳ`/`ß` 的非恒真对照把
84
+ 「哪些改写是可接受的既有口径、哪些是越界」逐条钉住。
85
+ """
86
+ s = nfkc_text(text).casefold()
87
+ table = trad_to_simp()
88
+ if table:
89
+ s = "".join(table.get(ch, ch) for ch in s)
90
+ return s
91
+
92
+
93
+ # 生效条件:raw 为真值时按 NFKC 归一化并 strip,最多 3 轮剥离 _INSTANCE_TAIL(无变化即停)、再剥 _SKELETON_TAIL、空白转下划线后返回;raw 为假值(None/空串)或处理后为空串时返回 ORPHAN。
94
+ def normalize_domain(raw: str) -> str:
95
+ """把自由文本的域描述归一化成稳定的短键。
96
+
97
+ 「工程学 知识点(内力与截面法)」 → 工程学
98
+ 「高中物理知识点内容(按骨架填充)」 → 高中物理
99
+ 「数学分析知识点内容(按骨架填充) 知识点(贝塞尔不等式)」 → 数学分析
100
+ """
101
+ if not raw:
102
+ return ORPHAN
103
+ s = nfkc_text(raw).strip()
104
+ # 反复剥离实例名尾巴(可能叠加两层,见上面第三个例子)
105
+ for _ in range(3):
106
+ new = _INSTANCE_TAIL.sub("", s)
107
+ if new == s:
108
+ break
109
+ s = new.strip()
110
+ s = _SKELETON_TAIL.sub("", s).strip()
111
+ s = re.sub(r"\s+", "_", s)
112
+ return s or ORPHAN
113
+
114
+
115
+ # 生效条件:tags 为真值时取其中首个 str(t) 以 "domain:" 开头的项,返回其前缀后内容的 normalize_domain 结果;无此标签且 condition_space 为真值时返回 normalize_domain(condition_space.get("observation_position"))(缺键即 None 归一为 ORPHAN);tags 为假值且 condition_space 为假值时返回 ORPHAN。
116
+ def route_key(condition_space: dict = None, tags=None) -> str:
117
+ """导出条件路由键。优先级:tags 的 domain: > observation_position 归一化 > orphan。
118
+
119
+ domain: 标签是显式声明的域,普查证明它分布最健康(95 桶/最大桶 5.4%),
120
+ 所以优先。没有标签时才回退到从 observation_position 提取。
121
+ """
122
+ for t in tags or []:
123
+ t = str(t)
124
+ if t.startswith("domain:"):
125
+ return normalize_domain(t[len("domain:"):])
126
+ if condition_space:
127
+ return normalize_domain(condition_space.get("observation_position"))
128
+ return ORPHAN
129
+
130
+
131
+ # 生效条件:key 等于 ORPHAN 时原样返回 ORPHAN;否则返回 "cond_" + 把 key 中非[\w中文-]字符替换为下划线并截前 24 字符的串 + "_" + key 的 sha256(utf-8)前 8 位十六进制。
132
+ def bucket_dir(key: str) -> str:
133
+ """路由键 → 目录名。中文键保留可读前缀 + 短哈希,避免文件系统非法字符/超长。"""
134
+ if key == ORPHAN:
135
+ return ORPHAN
136
+ safe = re.sub(r"[^\w\u4e00-\u9fff-]", "_", key)[:24]
137
+ h = hashlib.sha256(key.encode("utf-8")).hexdigest()[:8]
138
+ return f"cond_{safe}_{h}"
139
+
140
+
141
+ # 14 大域代表词表(白箱第 2 篇第 5 章 + 第 3 篇第 4 章:「56 学科卡 → 14 大域
142
+ # → 域内 KCCS」两阶段并行收敛。本表用作阶段 1 的大域并行打分依据——
143
+ # 当 query 没有显式 context 但 query 词能落进某个大域时,先收敛到大域再查。
144
+ #
145
+ # 词的选取原则:覆盖白箱工程文档里出现的高频学科关键词,且不互相吞并。
146
+ # 同一个词可以出现在多个大域(如「公式」在数学与物理都常见),这是合理的:
147
+ # 大域并行打分阶段就是让多域同分,再由阶段 2 的 KCCS 进一步区分。
148
+ BIG_DOMAINS = {
149
+ "数学": {"数学", "算术", "几何", "代数", "微积分", "概率", "统计", "集合", "矩阵",
150
+ "线性", "拓扑", "数论", "公式", "定理", "证明", "函数", "导数", "积分",
151
+ "极限", "方程", "不等式", "贝塞尔", "二分", "素数", "微元"},
152
+ "物理": {"物理", "力学", "电磁", "光学", "热学", "量子", "相对论", "能量", "动量",
153
+ "质量", "速度", "加速度", "电荷", "电压", "电流", "沸点", "海拔",
154
+ "大气压", "压强", "温度", "牛顿", "惯性", "引力"},
155
+ "化学": {"化学", "元素", "分子", "原子", "化合物", "反应", "酸", "碱", "盐",
156
+ "氧化", "还原", "有机", "无机", "离子", "键", "浓度", "溶液"},
157
+ "生物": {"生物", "细胞", "基因", "蛋白质", "酶", "光合", "呼吸", "植物", "动物",
158
+ "进化", "免疫", "神经", "细菌", "病毒", "代谢", "染色", "分裂"},
159
+ "计算机": {"计算机", "算法", "数据结构", "编程", "代码", "软件", "网络", "数据库",
160
+ "系统", "排序", "递归", "图论", "哈希", "索引", "查询", "排序", "锁",
161
+ "事务", "内存", "进程", "线程"},
162
+ "语言": {"语言", "中文", "英文", "语法", "词汇", "语义", "修辞", "文学", "写作",
163
+ "阅读", "拼音", "字", "词", "句"},
164
+ "历史": {"历史", "朝代", "战争", "文明", "政治", "经济史", "文化史", "古代",
165
+ "近代", "现代", "王朝", "革命", "改革"},
166
+ "地理": {"地理", "地形", "气候", "人口", "城市", "国家", "地图", "板块",
167
+ "洋流", "经度", "纬度", "海拔带", "流域"},
168
+ "艺术": {"艺术", "绘画", "音乐", "雕塑", "电影", "设计", "色彩", "构图",
169
+ "旋律", "节奏", "摄影"},
170
+ "经济": {"经济", "市场", "金融", "货币", "投资", "股票", "债券", "GDP",
171
+ "通胀", "财政", "税收", "供需"},
172
+ "心理": {"心理", "认知", "情感", "记忆", "学习", "性格", "行为", "意识",
173
+ "动机", "人格", "焦虑"},
174
+ "医学": {"医学", "疾病", "治疗", "药物", "诊断", "外科", "内科", "儿科",
175
+ "中医", "症状", "病理", "处方"},
176
+ "工程": {"工程", "建筑", "结构", "材料", "机械", "电子", "土木", "桥梁",
177
+ "内力", "截面", "梁", "柱", "应力"},
178
+ "通用": {"常识", "生活", "日常", "通用", "礼仪", "礼貌", "文明", "规则"},
179
+ }
180
+
181
+
182
+ # 生效条件:terms 为真值时对 BIG_DOMAINS 每个大域统计命中词数,最高分为 0 或 terms 为假值(None/空)时返回 None,否则返回最高分大域名(并列取 BIG_DOMAINS 迭代序首个最高分)。
183
+ def big_domain_classify(terms) -> str | None:
184
+ """阶段 1:14 大域并行打分 → 收敛到 top-1。
185
+
186
+ terms 是 expand_query_terms 返回的扩展词集合。
187
+ 大域打分 = query 词命中大域代表词的次数(多词同域累加)。
188
+ 并行在认知结构意义上:即使底层串行计算,14 个大域同时独立评估。
189
+
190
+ 返回最匹配的大域名(多个 0 分 → 返回 None,走原 bucket_dir 路由)。
191
+ """
192
+ if not terms:
193
+ return None
194
+ scores = {}
195
+ for d, vocab in BIG_DOMAINS.items():
196
+ scores[d] = sum(1 for t in terms
197
+ if any(w in t or t in w for w in vocab))
198
+ best = max(scores.items(), key=lambda x: x[1])
199
+ if best[1] == 0:
200
+ return None
201
+ # 多大域并列最高分时,按字典序取第一个稳定结果(避免浮点不确定)
202
+ return best[0]
203
+
204
+
205
+ # 生效条件:terms 为假值(None/空)时返回 {每个 BIG_DOMAINS 域: 0};terms 为真值时返回 {大域: 该域词表命中 terms 中词的个数}。
206
+ def big_domain_score_breakdown(terms) -> dict:
207
+ """暴露打分明细,便于审计与回归测试。"""
208
+ if not terms:
209
+ return {d: 0 for d in BIG_DOMAINS}
210
+ return {d: sum(1 for t in terms if any(w in t or t in w for w in vocab))
211
+ for d, vocab in BIG_DOMAINS.items()}
212
+
213
+
214
+ # ---------------------------------------------------------------------------
215
+ # 分级隶属度(模糊控制「隶属函数」的手写版)
216
+ #
217
+ # 上面的 big_domain_classify 是二值控制:`w in t or t in w` 命中即计 1。
218
+ # 下面是同一套规则库的**分级**版本——命中程度是 0~1 的连续值,并乘 IDF:
219
+ # · 隶属度 membership(t, w):完全相同 1.0;包含关系取长度比(覆盖越全越高)
220
+ # · IDF:一个代表词覆盖的大域越少,区分度越高(「贝塞尔」只在数学出现,
221
+ # 权重高于「公式」这种跨域通用词)
222
+ # 老函数保持不动 → P0/P1 基线可比性不受影响;新函数只供新路径(fuzzy)使用。
223
+ # ---------------------------------------------------------------------------
224
+
225
+ # 生效条件:term 或 word 为假值(None/空串)返回 0.0;相等返回 1.0;word 是 term 子串返回 len(word)/len(term);term 是 word 子串返回 len(term)/len(word);二者无包含关系返回 0.0。
226
+ def membership(term: str, word: str) -> float:
227
+ """词 term 对代表词 word 的隶属度(0.0~1.0,越接近 1 越隶属)。
228
+
229
+ 完全相同 → 1.0
230
+ term 包含 word → len(word)/len(term)(覆盖越全越隶属)
231
+ word 包含 term → len(term)/len(word)
232
+ 无包含关系 → 0.0
233
+ """
234
+ if not term or not word:
235
+ return 0.0
236
+ if term == word:
237
+ return 1.0
238
+ if word in term:
239
+ return len(word) / len(term)
240
+ if term in word:
241
+ return len(term) / len(word)
242
+ return 0.0
243
+
244
+
245
+ # 生效条件:无入参,恒遍历模块级常量 BIG_DOMAINS 的各域代表词表,返回 {代表词: 包含该词的域个数}。
246
+ def _build_domain_df() -> dict:
247
+ """代表词 → 覆盖它的大域数(IDF 的分母)。"""
248
+ df = {}
249
+ for vocab in BIG_DOMAINS.values():
250
+ for w in vocab:
251
+ df[w] = df.get(w, 0) + 1
252
+ return df
253
+
254
+
255
+ _DOMAIN_DF = _build_domain_df()
256
+
257
+
258
+ # 生效条件:恒返回 math.log(1.0 + len(BIG_DOMAINS) / _DOMAIN_DF.get(word, 1)),即 word 在 _DOMAIN_DF 中取其覆盖域数,缺键(含任何未登记值)时按 _DOMAIN_DF.get 的默认 1 代入。
259
+ def domain_idf(word: str) -> float:
260
+ """代表词的区分度权重:log(1 + 大域总数 / 覆盖它的大域数)。
261
+
262
+ 只在一个大域出现的词(如「贝塞尔」)≈ log(15)=2.71;
263
+ 14 个大域都出现的词(如「公式」)≈ log(2)=0.69。
264
+ """
265
+ return math.log(1.0 + len(BIG_DOMAINS) / _DOMAIN_DF.get(word, 1))
266
+
267
+
268
+ # 生效条件:terms 是 dict 时以其条目(键 str(t) 以 "__" 开头者剔除、值为 float)为词权重并忽略 weights,否则以 wmap.get(t, 1.0) 为权重(weights 为假值即 None/空 dict 时 wmap 为空、全部权重取 1.0,terms 为假值则词集为空);逐域累加「词权重 × 该词在域词表内最大(membership × domain_idf)」,权重 <=0 的词跳过,返回 {大域: round(得分, 6)}。
269
+ def big_domain_score_weighted(terms, weights=None) -> dict:
270
+ """阶段 1(分级版):14 大域并行打分,按「隶属度 × IDF」加权。
271
+
272
+ terms: 可迭代的词集合,或 {词: 权重}(expand_query_terms_weighted 的输出,
273
+ 调用方需先剔除 "__source__" 等元数据键)。
274
+ weights: terms 为可迭代时的可选权重表;terms 已是 dict 时忽略。
275
+ 返回 {大域: 得分},得分不再是整数计数,而是连续值。
276
+ """
277
+ if isinstance(terms, dict):
278
+ tw = {str(t): float(w) for t, w in terms.items()
279
+ if not str(t).startswith("__")}
280
+ else:
281
+ wmap = weights or {}
282
+ tw = {str(t): float(wmap.get(t, 1.0)) for t in (terms or [])}
283
+ out = {}
284
+ for d, vocab in BIG_DOMAINS.items():
285
+ s = 0.0
286
+ for t, tw_ in tw.items():
287
+ if tw_ <= 0:
288
+ continue
289
+ best = 0.0
290
+ for w in vocab:
291
+ m = membership(t, w)
292
+ if m > 0.0:
293
+ best = max(best, m * domain_idf(w))
294
+ s += tw_ * best
295
+ out[d] = round(s, 6)
296
+ return out
297
+
298
+
299
+ # 生效条件:以 terms、weights 计算各域加权得分(terms 为假值时各域均为 0.0),得分为空或最高分 <= min_score(默认 0.0)时返回 None,否则返回最高分大域名。
300
+ def big_domain_classify_weighted(terms, weights=None, min_score: float = 0.0):
301
+ """阶段 1(分级版)收敛到 top-1;全部低于 min_score → None。"""
302
+ scores = big_domain_score_weighted(terms, weights)
303
+ if not scores:
304
+ return None
305
+ best = max(scores.items(), key=lambda kv: kv[1])
306
+ if best[1] <= min_score:
307
+ return None
308
+ return best[0]
309
+
310
+
311
+ # 生效条件:a 或 b 为假值(None/空串)返回 0.0;相等返回 1.0;a 是 b 子串返回 len(a)/len(b);b 是 a 子串返回 len(b)/len(a);否则按二者二元组字符集合的 Jaccard 返回 len(ga & gb)/len(ga | gb),任一集合为空(如单字符键)时返回 0.0。
312
+ def domain_similarity(a: str, b: str) -> float:
313
+ """两个归一化域键的相似度(0~1):相同 1.0;包含取长度比;否则二元组 Jaccard。
314
+
315
+ 「计算机科学」vs「计算机」→ 0.6(包含);「高中物理」vs「物理」→ 0.5;
316
+ 完全无关 → 0.0。用于 fuzzy 路径的「大域亲和」打分。
317
+ """
318
+ if not a or not b:
319
+ return 0.0
320
+ if a == b:
321
+ return 1.0
322
+ if a in b:
323
+ return len(a) / len(b)
324
+ if b in a:
325
+ return len(b) / len(a)
326
+ ga = {a[i:i + 2] for i in range(len(a) - 1)}
327
+ gb = {b[i:i + 2] for i in range(len(b) - 1)}
328
+ if not ga or not gb:
329
+ return 0.0
330
+ return len(ga & gb) / len(ga | gb)
331
+
332
+
333
+ # 生效条件:counts 各值之和为 0(含空 dict 与全 0 计数)时——total_nodes 为假值(缺省 None 或 <=0)返回 {'ok': True, 'reason': 'empty', 'buckets': 0}(与加 total_nodes 参数之前逐位一致),total_nodes > 0 返回 {'ok': False, 'reason': 'empty_buckets', 'buckets': 0, 'nodes': total_nodes, 'problems': [...]};否则在「桶数 >1 且最大桶占比 >30%」、「桶数 >1 且单例桶占比 >50%」、「桶数 ==1(单桶,条件路由不可用)」、桶数 >1 时「期望扫描 >30%」中命中的项写入 problems,返回含 ok(=problems 为空)、buckets、nodes、max_bucket_share、singleton_ratio、expected_scan、problems 的 dict。
334
+ def bucket_health(counts: dict, total_nodes: int = None) -> dict:
335
+ """分区健康度自检。分桶键一旦退化(巨桶或碎片化),条件路由就是纸面收益,
336
+ 必须在写入侧就能发现,而不是等召回变差才回头查。
337
+
338
+ counts: {bucket_dir: node_count}
339
+ total_nodes: 调用方(`MdCG.health`)持有的**库内节点总数**,唯一用途是把
340
+ 「真空库(无节点、无桶)」与「有节点但分桶表为空(分区信息缺失)」分开。
341
+ **缺省 None ⇒ 不做该比对**:空 counts 的返回与加本参数之前逐位一致,
342
+ 故既有调用方(test_p0 / bench_axis_domain / bench6_arms,只传 counts)
343
+ 行为一字不变——M3③ 的向后兼容面。
344
+
345
+ 单桶(nb == 1)是「从未分区」而不是「分区退化」:巨桶判据(top/n == 1.0)与
346
+ 期望扫描判据(同样恒 1.0)在 nb==1 时必触发且互为同一事实,此前把这类库报成
347
+ 「巨桶 / 分区失效」是假话(M3①②)。现只给一条如实读数——条件路由本就不可用;
348
+ ok 仍为 False(单桶库的一次查询确实是全量扫描,判据未放宽)。
349
+ """
350
+ n = sum(counts.values())
351
+ nb = len(counts)
352
+ if not n:
353
+ # 库里有节点却零个桶 ⇒ 分桶表与节点面不一致(分区信息缺失),
354
+ # 不能报 ok=True 冒充健康(M3③)。total_nodes 缺省时不作此判断。
355
+ if total_nodes and total_nodes > 0:
356
+ return {
357
+ "ok": False,
358
+ "reason": "empty_buckets",
359
+ "buckets": 0,
360
+ "nodes": int(total_nodes),
361
+ "problems": [f"分桶表为空但库内有 {int(total_nodes)} 个节点:"
362
+ "分区信息缺失,条件路由不可用(非真空库)"],
363
+ }
364
+ return {"ok": True, "reason": "empty", "buckets": 0}
365
+ top = max(counts.values())
366
+ singles = sum(1 for v in counts.values() if v == 1)
367
+ # 期望扫描占比:随机取一节点的情境去路由,命中桶的期望大小占全库比例
368
+ expected_scan = sum(v * v for v in counts.values()) / n / n
369
+ problems = []
370
+ if nb > 1 and top / n > 0.30:
371
+ problems.append(f"巨桶:最大桶占 {top / n:.1%}(>30% 视为分区失效)")
372
+ if nb > 1 and singles / nb > 0.50:
373
+ problems.append(f"碎片化:单例桶占 {singles / nb:.1%}(>50% 说明键含实例级字段)")
374
+ if nb == 1:
375
+ # 巨桶/期望扫描两条在 nb==1 时只是同一事实的两种写法,合并为一条如实读数。
376
+ # expected_scan 的**数值**仍在返回 dict 里(下游读的是数:test_p0 :92、
377
+ # bench_axis_domain :159),只有文案不再把「未分区」说成「巨桶退化」。
378
+ problems.append(f"单桶:仅 1 个分桶({n} 个已分桶节点同桶),"
379
+ "条件路由本就不可用(从未分区,非分区退化)")
380
+ elif expected_scan > 0.30:
381
+ problems.append(f"路由无效:期望扫描 {expected_scan:.1%}(接近全量)")
382
+ return {
383
+ "ok": not problems,
384
+ "buckets": nb,
385
+ "nodes": n,
386
+ "max_bucket_share": top / n,
387
+ "singleton_ratio": singles / nb if nb else 0.0,
388
+ "expected_scan": expected_scan,
389
+ "problems": problems,
390
+ }
391
+
392
+
393
+ # ---------------------------------------------------------------------------
394
+ # 节点侧大域标签(S1 大域先验收敛的前置元数据)
395
+ #
396
+ # 为何需要:`big_domain_classify` 一直只作用于 **query 侧**(terms),节点侧没有域字段,
397
+ # 于是「14 大域并行打分」算完只能写进 meta(审计偏差 4:先验算出来却当成报告)。
398
+ # 要让大域先验真正参与候选收敛,节点必须在写入时固化自己的域。
399
+ # 口径:与查询侧同一个分类器(BIG_DOMAINS + big_domain_classify),保证两侧同构。
400
+ # ---------------------------------------------------------------------------
401
+
402
+ # 域词取词:中文(≥2 字)与拉丁词(≥2 字)。词表命中用「包含关系」判定,
403
+ # 故 2 字以上的切口足以覆盖 1~4 字代表词(如「工程」命中「工程师」)。
404
+ DOMAIN_TERM_RE = re.compile(r"[\u4e00-\u9fff]{2,}|[A-Za-z][A-Za-z0-9_]{1,}")
405
+
406
+
407
+ # 生效条件:text 为假值(None/空串)时返回 [];否则以 DOMAIN_TERM_RE 取词、按出现顺序去重后返回,
408
+ # 最多 limit 个(limit 为假值/负数时按空处理,返回 [])。
409
+ def domain_terms(text, limit: int = 400) -> list:
410
+ """从节点正文/标题抽「域词」(供 big_domain_classify 使用)。
411
+
412
+ 只做最小分词:中文按 ≥2 字连续片段、拉丁按 [A-Za-z][A-Za-z0-9_]+ 取词;
413
+ 去重保序,最多 limit 个(默认 400,避免长文把分类器拖慢)。
414
+ """
415
+ if not text or not limit or limit < 1:
416
+ return []
417
+ out, seen = [], set()
418
+ for m in DOMAIN_TERM_RE.finditer(str(text)):
419
+ w = m.group(0)
420
+ if w in seen:
421
+ continue
422
+ seen.add(w)
423
+ out.append(w)
424
+ if len(out) >= limit:
425
+ break
426
+ return out
427
+
428
+
429
+ # 生效条件:bucket 为假值或等于 ORPHAN 时返回空串;否则去掉 "cond_" 前缀、并当末段为 8 位十六进制哈希时剥掉该段,返回剩余的可读键。
430
+ def bucket_key_readable(bucket: str) -> str:
431
+ """桶目录名 → 可读键(S1b query 侧桶推断用):'cond_感知系统_d94e90d2' → '感知系统'。
432
+
433
+ 与 `bucket_dir` 互逆(丢哈希段);`orphan`/空值返回空串(S1b 不把 orphan 当键,orphan 恒作兜底)。
434
+ """
435
+ if not bucket or bucket == ORPHAN:
436
+ return ""
437
+ s = str(bucket)
438
+ if s.startswith("cond_"):
439
+ s = s[len("cond_"):]
440
+ head, sep, tail = s.rpartition("_")
441
+ if sep and len(tail) == 8 and all(c in "0123456789abcdef" for c in tail):
442
+ s = head
443
+ return s
444
+
445
+
446
+ # 中文词判定:至少含一个汉字
447
+ _ZH_RE = re.compile(r"[\u4e00-\u9fff]")
448
+
449
+
450
+ # 生效条件:key 缺失或含汉字时返回 [];否则从 tags(保序在前)与 text 域词(domain_terms)中收集含汉字、长度≥2 的词,去重取前 limit 个返回。
451
+ def bucket_zh_aliases(key: str, tags, text, limit: int = 6) -> list:
452
+ """英文桶键的中文别名(issue #33:S1b 跨语言收敛盲区的修复面)。
453
+
454
+ 机理:domain_similarity 的 bigram 兜底跨语言交集恒空——英文桶键 × 中文
455
+ query 恒 0.0 → S1b 恒 no_key_match(真实库 91.1% 中文节点恰是设计目标场景)。
456
+ 别名**只取节点自身内容**(tags 中文词 ∪ 正文中文域词,tags 优先),零翻译
457
+ 依赖——unify_query/en_zh_terms 桥接已被 #33 实测排除(字级直译语义毁)。
458
+ 键本身含中文时无跨语言问题,返回 []。
459
+ """
460
+ if not key or _ZH_RE.search(str(key)):
461
+ return []
462
+ out, seen = [], set()
463
+ src = [str(t) for t in (tags or [])]
464
+ src += domain_terms(text or "", limit=200)
465
+ for w in src:
466
+ if len(w) >= 2 and _ZH_RE.search(w) and w not in seen:
467
+ seen.add(w)
468
+ out.append(w)
469
+ if len(out) >= limit:
470
+ break
471
+ return out
472
+
473
+
474
+ # 生效条件:text 为假值或取不到任何域词时返回 None;否则返回 big_domain_classify(domain_terms(text))
475
+ # 的结果(无有效域信号时亦为 None,调用方据此决定是否落域字段)。
476
+ def classify_text(text, limit: int = 400):
477
+ """正文 → 大域名(节点侧域标签真源)。与查询侧共用 big_domain_classify。
478
+
479
+ 返回 None 表示「无有效域信号」——此时**不写** big_domain 字段,
480
+ 该节点留在 ORPHAN/兜底池(S1 收敛时必须能被兜底召回,见契约 §3 S1 不变量)。
481
+
482
+ issue #53-A:密文(`<!-- mdcg-enc:v1:…`)恒无域信号——无密钥的读面会把
483
+ 密文**原样**交到这里,base64 噪声会碰巧命中词表(实测唯一命中形态=「经济」:
484
+ 词表里唯一的拉丁词 GDP 被 base64 三连子串撞上),且假标签会被 backfill 的
485
+ already 幂等分支永久固化。判据收在此**唯一致敏点**:节点侧全部调用方
486
+ (add 写入面、backfill 回填面)自动同覆盖,无需各自设防。
487
+ """
488
+ from . import crypto # 延迟导入:routing 是底层模块,避免加载序耦合
489
+ if crypto.is_encrypted(text):
490
+ return None
430
491
  return big_domain_classify(domain_terms(text, limit))