@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -1,470 +1,490 @@
1
- # -*- coding: utf-8 -*-
2
- """md 语料统一只读访问层 —— 白箱检索层直查 SQL 的 md 数据源后端。
3
-
4
- 背景与目标
5
- ----------
6
- 白箱检索层(`semantic_translate.py` 等)存在 ~8 处深度直查 SQL
7
- (`dex.store.conn.execute("SELECT ... FROM nodes ...")`——KCCS 注释索引、
8
- 学科路由、四要素卡递归、知识点对齐)。md 语料是唯一知识来源
9
- (`migrate_wisdom_graph` 导出 + test_p44 三层校验),检索库只是
10
- `build_db_from_md()` 的可重建派生物。本模块把检索层的**知识查询**面
11
- 切换到 md 语料直读,SQLite 检索库降级为纯派生缓存(可丢弃)。
12
-
13
- 设计(零行为分叉的三条保障)
14
- ----------------------------
15
- 1. **行同构**:md frontmatter → 检索库 nodes 表 16 列,映射逻辑与
16
- `md_cg/md_whitebox.py::_restore` 逐字段一致(列值序列化同为
17
- `json.dumps(ensure_ascii=False)`,故 SQL LIKE 子串匹配逐位等价)。
18
- 2. **行序复刻**:无 ORDER BY 的 SELECT 在 SQLite 返回插入序;
19
- 本层按 `LAYERS` 权威序 × os.walk 序遍历(= `_restore` 的插入序),
20
- `fetchone` / `LIMIT 1` 语义等价。
21
- 3. **对拍守卫**:`md_cg/test_md_access_parity.py` 把全部真实直查 SQL
22
- 在两个后端上跑,逐行逐列断言相等——分叉即测试红。
23
-
24
- 范围(诚实边界)
25
- ----------------
26
- - 只解释白箱检索层实际使用的 SELECT 子集文法:
27
- `SELECT <cols|*> FROM nodes [WHERE <conj>] [LIMIT n]`,
28
- 谓词仅 `col = 'x'` / `col LIKE ?` / `col NOT LIKE ?`(AND 连接)。
29
- 超出文法 → `NotImplementedError`(fail-closed,不静默错执行)。
30
- - 写语句一律拒绝(打样阶段);`increment_access` 类统计写的
31
- md 真源化属后续增量(写路径裁定:知识写走 mdcg.add)。
32
- - 引擎内部面(`store.query_nodes` / `get_node` 等高层方法)不经本层,
33
- 仍走原库——`aeis_core` 属引擎自有存储,不在本工程范围。
34
-
35
- 用法
36
- ----
37
- from md_access import MdConn, read_conn
38
-
39
- conn = read_conn(dex) # WB_MD_DIRECT=1 → MdConn;否则派生库
40
- row = conn.execute("SELECT id FROM nodes WHERE layer='knowledge' "
41
- "AND state_attributes LIKE ? LIMIT 1",
42
- ('%"name": "X"%',)).fetchone()
43
-
44
- 环境开关:`WB_MD_DIRECT=1` 启用 md 直读;`WB_MD_ROOT` 指定 md 语料根
45
- (缺省回落派生库,诚实降级不猜路径)。
46
- """
47
- from __future__ import annotations
48
-
49
- import json
50
- import os
51
- import re
52
-
53
- try: # dsh 部署形态:复用 md_cg 的权威 frontmatter 解析(零解析差异)
54
- from nodefile import loads as _nf_loads
55
- except ImportError: # 独立部署形态:白箱自包含解析(对拍测试守卫等价性)
56
- _nf_loads = None
57
-
58
- #: nodes 表 16 列(权威列序,与 aeis_core CREATE TABLE / STNode.from_row 一致)
59
- COLS = ("id", "content", "modality", "spatial_coordinates",
60
- "temporal_coordinate", "condition_space", "importance",
61
- "confidence", "layer", "access_count", "last_access",
62
- "created_at", "tags", "semantic_coordinates", "state_attributes",
63
- "entity_id")
64
- _COL_IDX = {c: i for i, c in enumerate(COLS)}
65
-
66
- #: md 语料层目录权威序(行序 = _restore 插入序的关键;与 mdcg.LAYERS 一致)
67
- LAYERS = ("anchor", "structural", "knowledge", "contextual", "self",
68
- "rejected", "unresolved", "goals")
69
-
70
-
71
- # --------------------------------------------------------------------------
72
- # frontmatter 解析
73
- # --------------------------------------------------------------------------
74
-
75
- def _parse_node_text(text):
76
- """md 节点文本 → (fm dict, content str)。
77
-
78
- 有 nodefile 用权威实现;否则解析单行 YAML 简形(`key: value`,
79
- 值用 json.loads 全覆盖 dict/list/数字/null/带引号字符串,
80
- 失败回落原样字符串)。
81
- """
82
- if _nf_loads is not None:
83
- return _nf_loads(text)
84
- fm, content = {}, text
85
- if text.startswith("---"):
86
- lines = text.split("\n")
87
- try:
88
- end = lines.index("---", 1)
89
- except ValueError:
90
- return fm, content
91
- for line in lines[1:end]:
92
- if ":" not in line:
93
- continue
94
- k, _, v = line.partition(":")
95
- k = k.strip()
96
- v = v.strip()
97
- if not k:
98
- continue
99
- try:
100
- fm[k] = json.loads(v)
101
- except (ValueError, TypeError):
102
- fm[k] = v
103
- content = "\n".join(lines[end + 1:])
104
- if content.startswith("\n"):
105
- content = content[1:]
106
- return fm, content
107
-
108
-
109
- def _load_rows(root, layers):
110
- """md 语料 → 16 列行元组列表。
111
-
112
- 列映射与 `md_whitebox._restore` 逐字段一致。行序规范(两处统一):
113
- **(LAYERS 序, 相对路径字典序)**——`os.walk` 在 Windows 上顺序无保证,
114
- 显式排序才有确定性;`md_whitebox._restore` 按同一规范排列插入序,
115
- 故 MdConn 与派生库的行序结构性一致。
116
- """
117
- decorated = []
118
- layer_ord = {name: i for i, name in enumerate(layers)}
119
- for layer in layers:
120
- base = os.path.join(root, layer)
121
- if not os.path.isdir(base):
122
- continue
123
- for dirpath, _dirs, files in os.walk(base):
124
- for fn in files:
125
- if not fn.endswith(".md"):
126
- continue
127
- try:
128
- with open(os.path.join(dirpath, fn),
129
- encoding="utf-8") as f:
130
- text = f.read()
131
- except OSError:
132
- continue
133
- fm, content = _parse_node_text(text)
134
- nid = fm.get("id") or fn[:-3]
135
- rel = os.path.relpath(os.path.join(dirpath, fn),
136
- root).replace("\\", "/")
137
-
138
- def _js(v, default="{}"):
139
- if v is None or v == "":
140
- return default
141
- if isinstance(v, str):
142
- return v
143
- try:
144
- return json.dumps(v, ensure_ascii=False)
145
- except (TypeError, ValueError):
146
- return default
147
-
148
- def _f(v, default=0.0):
149
- try:
150
- return float(v)
151
- except (TypeError, ValueError):
152
- return default
153
-
154
- decorated.append((layer_ord.get(layer, 99), rel, (
155
- str(nid),
156
- content or "",
157
- fm.get("modality") or "text",
158
- _js(fm.get("spatial")),
159
- _f(fm.get("temporal"), None),
160
- _js(fm.get("condition_space")),
161
- _f(fm.get("importance"), 0.5),
162
- _f(fm.get("confidence"), 0.6),
163
- fm.get("layer") or "knowledge",
164
- int(_f(fm.get("access_count"), 0)),
165
- _f(fm.get("last_access"), 0),
166
- _f(fm.get("created_at"), 0),
167
- _js(fm.get("tags"), "[]"),
168
- _js(fm.get("semantic_coordinates")),
169
- _js(fm.get("state_attributes")),
170
- fm.get("entity_id"),
171
- )))
172
- decorated.sort(key=lambda t: (t[0], t[1]))
173
- return [t[2] for t in decorated]
174
-
175
-
176
- # --------------------------------------------------------------------------
177
- # SQL 子集解释器
178
- # --------------------------------------------------------------------------
179
-
180
- _LIKE_CACHE = {}
181
-
182
-
183
- def _like_re(pattern):
184
- """SQL LIKE 模式 → 全匹配正则(% 任意串 / _ 任一字符,
185
- ASCII 大小写不敏感——对齐 SQLite 默认 LIKE 语义)。"""
186
- rx = _LIKE_CACHE.get(pattern)
187
- if rx is None:
188
- parts = []
189
- for ch in pattern:
190
- if ch == "%":
191
- parts.append("[\\s\\S]*")
192
- elif ch == "_":
193
- parts.append("[\\s\\S]")
194
- else:
195
- parts.append(re.escape(ch))
196
- rx = re.compile("".join(parts) + r"\Z", re.IGNORECASE)
197
- _LIKE_CACHE[pattern] = rx
198
- return rx
199
-
200
-
201
- def _cmp_like(value, pattern, negate):
202
- """SQLite 三值 LIKE 语义:NULL 参与 → 未选中(NOT LIKE 同)。"""
203
- if value is None or pattern is None:
204
- return False
205
- hit = bool(_like_re(pattern).match(str(value)))
206
- return (not hit) if negate else hit
207
-
208
-
209
- _SELECT_RE = re.compile(
210
- r"\s*SELECT\s+(?P<cols>.+?)\s+FROM\s+nodes"
211
- r"(?:\s+WHERE\s+(?P<where>.+?))?"
212
- r"(?:\s+LIMIT\s+(?P<limit>\d+))?\s*\Z",
213
- re.I | re.S)
214
- _TERM_RE = re.compile(
215
- r"\s*(?P<col>[a-z_]+)\s*"
216
- r"(?P<op>NOT\s+LIKE|LIKE|=)\s*"
217
- r"(?P<val>\?|'[^']*')\s*(?:AND|$)", re.I)
218
-
219
-
220
- class _Cursor:
221
- """结果集:fetchone / fetchall / 迭代(与 sqlite3.Cursor 子集兼容)。"""
222
-
223
- def __init__(self, rows):
224
- self._rows = rows
225
- self._i = 0
226
-
227
- def fetchone(self):
228
- if self._i >= len(self._rows):
229
- return None
230
- r = self._rows[self._i]
231
- self._i += 1
232
- return r
233
-
234
- def fetchall(self):
235
- out = self._rows[self._i:]
236
- self._i = len(self._rows)
237
- return list(out)
238
-
239
- def __iter__(self):
240
- return iter(self._rows)
241
-
242
-
243
- class MdConn:
244
- """md 语料只读连接:`execute(sql, params)` 与 sqlite3.Connection
245
- 的读子集同签名;行源懒加载一次缓存(进程内单例见 `read_conn`)。"""
246
-
247
- def __init__(self, root, layers=None):
248
- self.root = os.path.abspath(root)
249
- self._layers = tuple(layers) if layers else LAYERS
250
- self._rows = None
251
- self._edge_map = None # {source_id: [edge_dict, ...]}(fm.edges)
252
- self._child_map = None # {parent_id: [child_id, ...]}(subgraph.nodes)
253
-
254
- def _all_rows(self):
255
- if self._rows is None:
256
- if not os.path.isdir(self.root):
257
- raise FileNotFoundError(
258
- f"[md_access] md 语料根不存在: {self.root}")
259
- self._rows = _load_rows(self.root, self._layers)
260
- return self._rows
261
-
262
- def reload(self):
263
- """丢弃全部缓存(行 + 边域)——写入方更新语料后刷新快照。"""
264
- self._rows = None
265
- self._edge_map = None
266
- self._child_map = None
267
-
268
- def _edge_domain(self):
269
- """边域懒加载(第二遍扫描,仅边访问器触发;检索读路径零开销)。
270
-
271
- fm.edges(causal/similar 等非层级边)与 fm.subgraph.nodes(层级边,
272
- 落点=父节点)——与 md_whitebox._restore 还原 edges 表的两大数据源
273
- 一致。
274
- """
275
- if self._edge_map is None:
276
- em, cm = {}, {}
277
- for layer in self._layers:
278
- base = os.path.join(self.root, layer)
279
- if not os.path.isdir(base):
280
- continue
281
- for dirpath, _dirs, files in os.walk(base):
282
- for fn in files:
283
- if not fn.endswith(".md"):
284
- continue
285
- try:
286
- with open(os.path.join(dirpath, fn),
287
- encoding="utf-8") as f:
288
- text = f.read()
289
- except OSError:
290
- continue
291
- fm, _content = _parse_node_text(text)
292
- nid = str(fm.get("id") or fn[:-3])
293
- edges = fm.get("edges")
294
- if isinstance(edges, list) and edges:
295
- em[nid] = [e for e in edges
296
- if isinstance(e, dict)]
297
- sg = fm.get("subgraph")
298
- if isinstance(sg, dict):
299
- subs = sg.get("nodes")
300
- if isinstance(subs, list) and subs:
301
- cm[nid] = [str(x) for x in subs]
302
- self._edge_map, self._child_map = em, cm
303
- return self._edge_map, self._child_map
304
-
305
- # -- 边域访问器(SQL 文法保持 nodes-only fail-closed,边查询走窄方法) --
306
-
307
- def has_edge(self, source_id, target_id, relation_type):
308
- """`SELECT id FROM edges WHERE source_id=? AND target_id=?
309
- AND relation_type=?` 的等价查询(causal/similar 幂等判重)。"""
310
- em, _cm = self._edge_domain()
311
- for e in em.get(str(source_id)) or ():
312
- if (str(e.get("target") or "") == str(target_id)
313
- and str(e.get("relation_type") or "") == str(relation_type)):
314
- return True
315
- return False
316
-
317
- def edges_between(self, source_id, target_id, relation_type=None):
318
- """source→target 的出边 dict 列表(relation_type 可选过滤)。
319
-
320
- 供调用侧做边内字段判据(如 separation 边的
321
- condition_space.observation_position)——文法不扩,判据留调用侧。
322
- """
323
- em, _cm = self._edge_domain()
324
- out = []
325
- for e in em.get(str(source_id)) or ():
326
- if str(e.get("target") or "") != str(target_id):
327
- continue
328
- if relation_type is not None and str(
329
- e.get("relation_type") or "") != str(relation_type):
330
- continue
331
- out.append(e)
332
- return out
333
-
334
- def children_of(self, node_id):
335
- """层级子节点 id 列表(fm.subgraph.nodes 落点)。"""
336
- _em, cm = self._edge_domain()
337
- return list(cm.get(str(node_id)) or [])
338
-
339
- def top_content_match(self, word, exclude_id):
340
- """`SELECT id FROM nodes WHERE content LIKE ? AND id != ?
341
- ORDER BY importance DESC, length(content) LIMIT 1` 的等价查询。
342
-
343
- 同 key 时保持扫描序优先(与 sqlite rowid 序同构——插入序规范)。
344
- """
345
- rx = _like_re("%" + str(word) + "%")
346
- best = None
347
- best_key = None
348
- for r in self._all_rows():
349
- cid = r[0]
350
- if cid == exclude_id:
351
- continue
352
- c = r[1] or ""
353
- if not rx.match(c):
354
- continue
355
- key = (-(r[6] if r[6] is not None else 0.0), len(c))
356
- if best_key is None or key < best_key:
357
- best, best_key = (cid,), key
358
- return best
359
-
360
- # -- SQL 解析 -----------------------------------------------------------
361
-
362
- def _parse(self, sql):
363
- m = _SELECT_RE.match(sql.strip().rstrip(";"))
364
- if not m:
365
- raise NotImplementedError(
366
- f"[md_access] SQL 超出只读子集文法(fail-closed): "
367
- f"{sql[:120]!r}")
368
- cols = m.group("cols").strip()
369
- if cols != "*":
370
- names = [c.strip() for c in cols.split(",")]
371
- for c in names:
372
- if c not in _COL_IDX:
373
- raise NotImplementedError(
374
- f"[md_access] 未知列 {c!r}(fail-closed)")
375
- cols = names
376
- where = m.group("where")
377
- preds, nparams = [], 0
378
- if where:
379
- pos = 0
380
- while pos < len(where):
381
- tm = _TERM_RE.match(where, pos)
382
- if not tm or tm.end() == pos:
383
- raise NotImplementedError(
384
- f"[md_access] 谓词超文法(fail-closed): "
385
- f"{where[pos:pos + 60]!r}")
386
- col = tm.group("col").lower()
387
- if col not in _COL_IDX:
388
- raise NotImplementedError(
389
- f"[md_access] 谓词列未知 {col!r}(fail-closed)")
390
- op = tm.group("op").upper()
391
- val = tm.group("val")
392
- preds.append((col, op, val, nparams))
393
- if val == "?":
394
- nparams += 1
395
- pos = tm.end()
396
- limit = int(m.group("limit")) if m.group("limit") else None
397
- return cols, preds, nparams, limit
398
-
399
- # -- 执行 ---------------------------------------------------------------
400
-
401
- def execute(self, sql, params=()):
402
- head = sql.lstrip()[:6].upper()
403
- if head != "SELECT":
404
- raise NotImplementedError(
405
- f"[md_access] 只读访问层拒绝写语句(fail-closed): "
406
- f"{sql[:80]!r}")
407
- params = tuple(params or ())
408
- cols, preds, nparams, limit = self._parse(sql)
409
- if len(params) != nparams:
410
- raise ValueError(
411
- f"[md_access] 参数个数不符: 期望 {nparams} 实得 {len(params)}")
412
- idx = _COL_IDX
413
- rows = self._all_rows()
414
- out = []
415
- for r in rows:
416
- ok = True
417
- for col, op, val, pi in preds:
418
- v = r[idx[col]]
419
- if op == "=":
420
- lit = val[1:-1] if val != "?" else str(params[pi])
421
- if v is None or str(v) != lit:
422
- ok = False
423
- break
424
- else:
425
- pat = params[pi] if val == "?" else val[1:-1]
426
- if not _cmp_like(v, pat, op == "NOT LIKE"):
427
- ok = False
428
- break
429
- if ok:
430
- out.append(r if cols == "*" else tuple(r[idx[c]]
431
- for c in cols))
432
- if limit is not None and len(out) >= limit:
433
- break
434
- return _Cursor(out)
435
-
436
- def close(self):
437
- self._rows = None
438
-
439
-
440
- # --------------------------------------------------------------------------
441
- # 检索读路径统一入口
442
- # --------------------------------------------------------------------------
443
-
444
- _CONN_CACHE = {}
445
-
446
-
447
- def _md_conn_or_none():
448
- """WB 开关生效则返回 MdConn 单例,否则 None(调用方自行回落原路径)。"""
449
- if os.environ.get("WB_MD_DIRECT") != "1":
450
- return None
451
- root = os.environ.get("WB_MD_ROOT") or ""
452
- if not root or not os.path.isdir(root):
453
- return None
454
- conn = _CONN_CACHE.get(root)
455
- if conn is None:
456
- conn = _CONN_CACHE[root] = MdConn(root)
457
- return conn
458
-
459
-
460
- def read_conn(dex):
461
- """白箱检索读路径统一入口。
462
-
463
- `WB_MD_DIRECT=1` 且 `WB_MD_ROOT` 指向存在的 md 语料根 → 返回该根的
464
- MdConn 单例(md 直读);否则回落 `dex.store.conn`(派生库,
465
- 零行为变更)。缺省回落是**诚实降级**:缺配置时不猜路径。
466
- """
467
- conn = _md_conn_or_none()
468
- if conn is not None:
469
- return conn
470
- return dex.store.conn
1
+ # -*- coding: utf-8 -*-
2
+ """md 语料统一只读访问层 —— 白箱检索层直查 SQL 的 md 数据源后端。
3
+
4
+ 背景与目标
5
+ ----------
6
+ 白箱检索层(`semantic_translate.py` 等)存在 ~8 处深度直查 SQL
7
+ (`dex.store.conn.execute("SELECT ... FROM nodes ...")`——KCCS 注释索引、
8
+ 学科路由、四要素卡递归、知识点对齐)。md 语料是唯一知识来源
9
+ (`migrate_wisdom_graph` 导出 + test_p44 三层校验),检索库只是
10
+ `build_db_from_md()` 的可重建派生物。本模块把检索层的**知识查询**面
11
+ 切换到 md 语料直读,SQLite 检索库降级为纯派生缓存(可丢弃)。
12
+
13
+ 设计(零行为分叉的三条保障)
14
+ ----------------------------
15
+ 1. **行同构**:md frontmatter → 检索库 nodes 表 16 列,映射逻辑与
16
+ `md_cg/md_whitebox.py::_restore` 逐字段一致(列值序列化同为
17
+ `json.dumps(ensure_ascii=False)`,故 SQL LIKE 子串匹配逐位等价)。
18
+ 2. **行序复刻**:无 ORDER BY 的 SELECT 在 SQLite 返回插入序;
19
+ 本层按 `LAYERS` 权威序 × os.walk 序遍历(= `_restore` 的插入序),
20
+ `fetchone` / `LIMIT 1` 语义等价。
21
+ 3. **对拍守卫**:`md_cg/test_md_access_parity.py` 把全部真实直查 SQL
22
+ 在两个后端上跑,逐行逐列断言相等——分叉即测试红。
23
+
24
+ 范围(诚实边界)
25
+ ----------------
26
+ - 只解释白箱检索层实际使用的 SELECT 子集文法:
27
+ `SELECT <cols|*> FROM nodes [WHERE <conj>] [LIMIT n]`,
28
+ 谓词仅 `col = 'x'` / `col LIKE ?` / `col NOT LIKE ?`(AND 连接)。
29
+ 超出文法 → `NotImplementedError`(fail-closed,不静默错执行)。
30
+ - 写语句一律拒绝(打样阶段);`increment_access` 类统计写的
31
+ md 真源化属后续增量(写路径裁定:知识写走 mdcg.add)。
32
+ - 引擎内部面(`store.query_nodes` / `get_node` 等高层方法)不经本层,
33
+ 仍走原库——`aeis_core` 属引擎自有存储,不在本工程范围。
34
+
35
+ 用法
36
+ ----
37
+ from md_access import MdConn, read_conn
38
+
39
+ conn = read_conn(dex) # WB_MD_DIRECT=1 → MdConn;否则派生库
40
+ row = conn.execute("SELECT id FROM nodes WHERE layer='knowledge' "
41
+ "AND state_attributes LIKE ? LIMIT 1",
42
+ ('%"name": "X"%',)).fetchone()
43
+
44
+ 环境开关:`WB_MD_DIRECT=1` 启用 md 直读;`WB_MD_ROOT` 指定 md 语料根
45
+ (缺省回落派生库,诚实降级不猜路径)。
46
+ """
47
+ from __future__ import annotations
48
+
49
+ import json
50
+ import os
51
+ import re
52
+
53
+ try: # dsh 部署形态:复用 md_cg 的权威 frontmatter 解析(零解析差异)
54
+ from nodefile import loads as _nf_loads
55
+ except ImportError: # 独立部署形态:白箱自包含解析(对拍测试守卫等价性)
56
+ _nf_loads = None
57
+
58
+ #: nodes 表 16 列(权威列序,与 aeis_core CREATE TABLE / STNode.from_row 一致)
59
+ COLS = ("id", "content", "modality", "spatial_coordinates",
60
+ "temporal_coordinate", "condition_space", "importance",
61
+ "confidence", "layer", "access_count", "last_access",
62
+ "created_at", "tags", "semantic_coordinates", "state_attributes",
63
+ "entity_id")
64
+ _COL_IDX = {c: i for i, c in enumerate(COLS)}
65
+
66
+ #: md 语料层目录权威序(行序 = _restore 插入序的关键)。
67
+ #: **#122(2026-10-12 DSH 端):本符号不再是第二份权威** —— 它**转发**自单一真源
68
+ #: `md_cg.mdcg.LAYERS`(取值与顺序由真源决定,此处不复制字面量)。修前此处是一份
69
+ #: 独立的同值元组:值一致靠人工同步、无机制保证,且审计面(conformance.enum_spaces)
70
+ #: 只声明 mdcg 一份 ⇒ 白箱侧悄悄换序无人知情(而顺序承重:_restore 插入序)。
71
+ #: 装载形态:① 包形态(md_cg.whitebox_kb.wisdom.md_access)→ 相对导入;
72
+ #: ② 仓库根在 sys.path;③ wisdom 目录平铺在 sys.path(本仓守卫走这条)。
73
+ #: 三者皆不可达(真正脱离 md_cg 的独立部署)时,才回落到下一行那份**显式标记**的
74
+ #: 字面量,并把 LAYERS_SOURCE 置 "literal-fallback" —— 该标记供 conformance 与守卫
75
+ #: 判「转发是否真的生效」,避免回落被静默当成真源。
76
+ LAYERS_SOURCE = "md_cg.mdcg"
77
+ try:
78
+ from ...mdcg import LAYERS as LAYERS # ① 包形态
79
+ except ImportError:
80
+ try:
81
+ from md_cg.mdcg import LAYERS as LAYERS # ② 仓库根在 sys.path
82
+ except ImportError:
83
+ try:
84
+ from mdcg import LAYERS as LAYERS # ③ 平铺形态
85
+ except ImportError: # ④ 独立部署:显式回落
86
+ LAYERS = ("anchor", "structural", "knowledge", "contextual", "self",
87
+ "rejected", "unresolved", "goals")
88
+ LAYERS_SOURCE = "literal-fallback"
89
+
90
+
91
+ # --------------------------------------------------------------------------
92
+ # frontmatter 解析
93
+ # --------------------------------------------------------------------------
94
+
95
+ def _parse_node_text(text):
96
+ """md 节点文本 → (fm dict, content str)。
97
+
98
+ 有 nodefile 用权威实现;否则解析单行 YAML 简形(`key: value`,
99
+ 值用 json.loads 全覆盖 dict/list/数字/null/带引号字符串,
100
+ 失败回落原样字符串)。
101
+ """
102
+ if _nf_loads is not None:
103
+ return _nf_loads(text)
104
+ fm, content = {}, text
105
+ if text.startswith("---"):
106
+ lines = text.split("\n")
107
+ try:
108
+ end = lines.index("---", 1)
109
+ except ValueError:
110
+ return fm, content
111
+ for line in lines[1:end]:
112
+ if ":" not in line:
113
+ continue
114
+ k, _, v = line.partition(":")
115
+ k = k.strip()
116
+ v = v.strip()
117
+ if not k:
118
+ continue
119
+ try:
120
+ fm[k] = json.loads(v)
121
+ except (ValueError, TypeError):
122
+ fm[k] = v
123
+ content = "\n".join(lines[end + 1:])
124
+ if content.startswith("\n"):
125
+ content = content[1:]
126
+ return fm, content
127
+
128
+
129
+ def _load_rows(root, layers):
130
+ """md 语料 → 16 列行元组列表。
131
+
132
+ 列映射与 `md_whitebox._restore` 逐字段一致。行序规范(两处统一):
133
+ **(LAYERS 序, 相对路径字典序)**——`os.walk` 在 Windows 上顺序无保证,
134
+ 显式排序才有确定性;`md_whitebox._restore` 按同一规范排列插入序,
135
+ 故 MdConn 与派生库的行序结构性一致。
136
+ """
137
+ decorated = []
138
+ layer_ord = {name: i for i, name in enumerate(layers)}
139
+ for layer in layers:
140
+ base = os.path.join(root, layer)
141
+ if not os.path.isdir(base):
142
+ continue
143
+ for dirpath, _dirs, files in os.walk(base):
144
+ for fn in files:
145
+ if not fn.endswith(".md"):
146
+ continue
147
+ try:
148
+ with open(os.path.join(dirpath, fn),
149
+ encoding="utf-8") as f:
150
+ text = f.read()
151
+ except OSError:
152
+ continue
153
+ fm, content = _parse_node_text(text)
154
+ nid = fm.get("id") or fn[:-3]
155
+ rel = os.path.relpath(os.path.join(dirpath, fn),
156
+ root).replace("\\", "/")
157
+
158
+ def _js(v, default="{}"):
159
+ if v is None or v == "":
160
+ return default
161
+ if isinstance(v, str):
162
+ return v
163
+ try:
164
+ return json.dumps(v, ensure_ascii=False)
165
+ except (TypeError, ValueError):
166
+ return default
167
+
168
+ def _f(v, default=0.0):
169
+ try:
170
+ return float(v)
171
+ except (TypeError, ValueError):
172
+ return default
173
+
174
+ decorated.append((layer_ord.get(layer, 99), rel, (
175
+ str(nid),
176
+ content or "",
177
+ fm.get("modality") or "text",
178
+ _js(fm.get("spatial")),
179
+ _f(fm.get("temporal"), None),
180
+ _js(fm.get("condition_space")),
181
+ _f(fm.get("importance"), 0.5),
182
+ _f(fm.get("confidence"), 0.6),
183
+ fm.get("layer") or "knowledge",
184
+ int(_f(fm.get("access_count"), 0)),
185
+ _f(fm.get("last_access"), 0),
186
+ _f(fm.get("created_at"), 0),
187
+ _js(fm.get("tags"), "[]"),
188
+ _js(fm.get("semantic_coordinates")),
189
+ _js(fm.get("state_attributes")),
190
+ fm.get("entity_id"),
191
+ )))
192
+ decorated.sort(key=lambda t: (t[0], t[1]))
193
+ return [t[2] for t in decorated]
194
+
195
+
196
+ # --------------------------------------------------------------------------
197
+ # SQL 子集解释器
198
+ # --------------------------------------------------------------------------
199
+
200
+ _LIKE_CACHE = {}
201
+
202
+
203
+ def _like_re(pattern):
204
+ """SQL LIKE 模式 → 全匹配正则(% 任意串 / _ 任一字符,
205
+ ASCII 大小写不敏感——对齐 SQLite 默认 LIKE 语义)。"""
206
+ rx = _LIKE_CACHE.get(pattern)
207
+ if rx is None:
208
+ parts = []
209
+ for ch in pattern:
210
+ if ch == "%":
211
+ parts.append("[\\s\\S]*")
212
+ elif ch == "_":
213
+ parts.append("[\\s\\S]")
214
+ else:
215
+ parts.append(re.escape(ch))
216
+ rx = re.compile("".join(parts) + r"\Z", re.IGNORECASE)
217
+ _LIKE_CACHE[pattern] = rx
218
+ return rx
219
+
220
+
221
+ def _cmp_like(value, pattern, negate):
222
+ """SQLite 三值 LIKE 语义:NULL 参与 → 未选中(NOT LIKE 同)。"""
223
+ if value is None or pattern is None:
224
+ return False
225
+ hit = bool(_like_re(pattern).match(str(value)))
226
+ return (not hit) if negate else hit
227
+
228
+
229
+ _SELECT_RE = re.compile(
230
+ r"\s*SELECT\s+(?P<cols>.+?)\s+FROM\s+nodes"
231
+ r"(?:\s+WHERE\s+(?P<where>.+?))?"
232
+ r"(?:\s+LIMIT\s+(?P<limit>\d+))?\s*\Z",
233
+ re.I | re.S)
234
+ _TERM_RE = re.compile(
235
+ r"\s*(?P<col>[a-z_]+)\s*"
236
+ r"(?P<op>NOT\s+LIKE|LIKE|=)\s*"
237
+ r"(?P<val>\?|'[^']*')\s*(?:AND|$)", re.I)
238
+
239
+
240
+ class _Cursor:
241
+ """结果集:fetchone / fetchall / 迭代(与 sqlite3.Cursor 子集兼容)。"""
242
+
243
+ def __init__(self, rows):
244
+ self._rows = rows
245
+ self._i = 0
246
+
247
+ def fetchone(self):
248
+ if self._i >= len(self._rows):
249
+ return None
250
+ r = self._rows[self._i]
251
+ self._i += 1
252
+ return r
253
+
254
+ def fetchall(self):
255
+ out = self._rows[self._i:]
256
+ self._i = len(self._rows)
257
+ return list(out)
258
+
259
+ def __iter__(self):
260
+ return iter(self._rows)
261
+
262
+
263
+ class MdConn:
264
+ """md 语料只读连接:`execute(sql, params)` 与 sqlite3.Connection
265
+ 的读子集同签名;行源懒加载一次缓存(进程内单例见 `read_conn`)。"""
266
+
267
+ def __init__(self, root, layers=None):
268
+ self.root = os.path.abspath(root)
269
+ self._layers = tuple(layers) if layers else LAYERS
270
+ self._rows = None
271
+ self._edge_map = None # {source_id: [edge_dict, ...]}(fm.edges)
272
+ self._child_map = None # {parent_id: [child_id, ...]}(subgraph.nodes)
273
+
274
+ def _all_rows(self):
275
+ if self._rows is None:
276
+ if not os.path.isdir(self.root):
277
+ raise FileNotFoundError(
278
+ f"[md_access] md 语料根不存在: {self.root}")
279
+ self._rows = _load_rows(self.root, self._layers)
280
+ return self._rows
281
+
282
+ def reload(self):
283
+ """丢弃全部缓存(行 + 边域)——写入方更新语料后刷新快照。"""
284
+ self._rows = None
285
+ self._edge_map = None
286
+ self._child_map = None
287
+
288
+ def _edge_domain(self):
289
+ """边域懒加载(第二遍扫描,仅边访问器触发;检索读路径零开销)。
290
+
291
+ fm.edges(causal/similar 等非层级边)与 fm.subgraph.nodes(层级边,
292
+ 落点=父节点)——与 md_whitebox._restore 还原 edges 表的两大数据源
293
+ 一致。
294
+ """
295
+ if self._edge_map is None:
296
+ em, cm = {}, {}
297
+ for layer in self._layers:
298
+ base = os.path.join(self.root, layer)
299
+ if not os.path.isdir(base):
300
+ continue
301
+ for dirpath, _dirs, files in os.walk(base):
302
+ for fn in files:
303
+ if not fn.endswith(".md"):
304
+ continue
305
+ try:
306
+ with open(os.path.join(dirpath, fn),
307
+ encoding="utf-8") as f:
308
+ text = f.read()
309
+ except OSError:
310
+ continue
311
+ fm, _content = _parse_node_text(text)
312
+ nid = str(fm.get("id") or fn[:-3])
313
+ edges = fm.get("edges")
314
+ if isinstance(edges, list) and edges:
315
+ em[nid] = [e for e in edges
316
+ if isinstance(e, dict)]
317
+ sg = fm.get("subgraph")
318
+ if isinstance(sg, dict):
319
+ subs = sg.get("nodes")
320
+ if isinstance(subs, list) and subs:
321
+ cm[nid] = [str(x) for x in subs]
322
+ self._edge_map, self._child_map = em, cm
323
+ return self._edge_map, self._child_map
324
+
325
+ # -- 边域访问器(SQL 文法保持 nodes-only fail-closed,边查询走窄方法) --
326
+
327
+ def has_edge(self, source_id, target_id, relation_type):
328
+ """`SELECT id FROM edges WHERE source_id=? AND target_id=?
329
+ AND relation_type=?` 的等价查询(causal/similar 幂等判重)。"""
330
+ em, _cm = self._edge_domain()
331
+ for e in em.get(str(source_id)) or ():
332
+ if (str(e.get("target") or "") == str(target_id)
333
+ and str(e.get("relation_type") or "") == str(relation_type)):
334
+ return True
335
+ return False
336
+
337
+ def edges_between(self, source_id, target_id, relation_type=None):
338
+ """source→target 的出边 dict 列表(relation_type 可选过滤)。
339
+
340
+ 供调用侧做边内字段判据(如 separation 边的
341
+ condition_space.observation_position)——文法不扩,判据留调用侧。
342
+ """
343
+ em, _cm = self._edge_domain()
344
+ out = []
345
+ for e in em.get(str(source_id)) or ():
346
+ if str(e.get("target") or "") != str(target_id):
347
+ continue
348
+ if relation_type is not None and str(
349
+ e.get("relation_type") or "") != str(relation_type):
350
+ continue
351
+ out.append(e)
352
+ return out
353
+
354
+ def children_of(self, node_id):
355
+ """层级子节点 id 列表(fm.subgraph.nodes 落点)。"""
356
+ _em, cm = self._edge_domain()
357
+ return list(cm.get(str(node_id)) or [])
358
+
359
+ def top_content_match(self, word, exclude_id):
360
+ """`SELECT id FROM nodes WHERE content LIKE ? AND id != ?
361
+ ORDER BY importance DESC, length(content) LIMIT 1` 的等价查询。
362
+
363
+ 同 key 时保持扫描序优先(与 sqlite rowid 序同构——插入序规范)。
364
+ """
365
+ rx = _like_re("%" + str(word) + "%")
366
+ best = None
367
+ best_key = None
368
+ for r in self._all_rows():
369
+ cid = r[0]
370
+ if cid == exclude_id:
371
+ continue
372
+ c = r[1] or ""
373
+ if not rx.match(c):
374
+ continue
375
+ key = (-(r[6] if r[6] is not None else 0.0), len(c))
376
+ if best_key is None or key < best_key:
377
+ best, best_key = (cid,), key
378
+ return best
379
+
380
+ # -- SQL 解析 -----------------------------------------------------------
381
+
382
+ def _parse(self, sql):
383
+ m = _SELECT_RE.match(sql.strip().rstrip(";"))
384
+ if not m:
385
+ raise NotImplementedError(
386
+ f"[md_access] SQL 超出只读子集文法(fail-closed): "
387
+ f"{sql[:120]!r}")
388
+ cols = m.group("cols").strip()
389
+ if cols != "*":
390
+ names = [c.strip() for c in cols.split(",")]
391
+ for c in names:
392
+ if c not in _COL_IDX:
393
+ raise NotImplementedError(
394
+ f"[md_access] 未知列 {c!r}(fail-closed)")
395
+ cols = names
396
+ where = m.group("where")
397
+ preds, nparams = [], 0
398
+ if where:
399
+ pos = 0
400
+ while pos < len(where):
401
+ tm = _TERM_RE.match(where, pos)
402
+ if not tm or tm.end() == pos:
403
+ raise NotImplementedError(
404
+ f"[md_access] 谓词超文法(fail-closed): "
405
+ f"{where[pos:pos + 60]!r}")
406
+ col = tm.group("col").lower()
407
+ if col not in _COL_IDX:
408
+ raise NotImplementedError(
409
+ f"[md_access] 谓词列未知 {col!r}(fail-closed)")
410
+ op = tm.group("op").upper()
411
+ val = tm.group("val")
412
+ preds.append((col, op, val, nparams))
413
+ if val == "?":
414
+ nparams += 1
415
+ pos = tm.end()
416
+ limit = int(m.group("limit")) if m.group("limit") else None
417
+ return cols, preds, nparams, limit
418
+
419
+ # -- 执行 ---------------------------------------------------------------
420
+
421
+ def execute(self, sql, params=()):
422
+ head = sql.lstrip()[:6].upper()
423
+ if head != "SELECT":
424
+ raise NotImplementedError(
425
+ f"[md_access] 只读访问层拒绝写语句(fail-closed): "
426
+ f"{sql[:80]!r}")
427
+ params = tuple(params or ())
428
+ cols, preds, nparams, limit = self._parse(sql)
429
+ if len(params) != nparams:
430
+ raise ValueError(
431
+ f"[md_access] 参数个数不符: 期望 {nparams} 实得 {len(params)}")
432
+ idx = _COL_IDX
433
+ rows = self._all_rows()
434
+ out = []
435
+ for r in rows:
436
+ ok = True
437
+ for col, op, val, pi in preds:
438
+ v = r[idx[col]]
439
+ if op == "=":
440
+ lit = val[1:-1] if val != "?" else str(params[pi])
441
+ if v is None or str(v) != lit:
442
+ ok = False
443
+ break
444
+ else:
445
+ pat = params[pi] if val == "?" else val[1:-1]
446
+ if not _cmp_like(v, pat, op == "NOT LIKE"):
447
+ ok = False
448
+ break
449
+ if ok:
450
+ out.append(r if cols == "*" else tuple(r[idx[c]]
451
+ for c in cols))
452
+ if limit is not None and len(out) >= limit:
453
+ break
454
+ return _Cursor(out)
455
+
456
+ def close(self):
457
+ self._rows = None
458
+
459
+
460
+ # --------------------------------------------------------------------------
461
+ # 检索读路径统一入口
462
+ # --------------------------------------------------------------------------
463
+
464
+ _CONN_CACHE = {}
465
+
466
+
467
+ def _md_conn_or_none():
468
+ """WB 开关生效则返回 MdConn 单例,否则 None(调用方自行回落原路径)。"""
469
+ if os.environ.get("WB_MD_DIRECT") != "1":
470
+ return None
471
+ root = os.environ.get("WB_MD_ROOT") or ""
472
+ if not root or not os.path.isdir(root):
473
+ return None
474
+ conn = _CONN_CACHE.get(root)
475
+ if conn is None:
476
+ conn = _CONN_CACHE[root] = MdConn(root)
477
+ return conn
478
+
479
+
480
+ def read_conn(dex):
481
+ """白箱检索读路径统一入口。
482
+
483
+ `WB_MD_DIRECT=1` 且 `WB_MD_ROOT` 指向存在的 md 语料根 → 返回该根的
484
+ MdConn 单例(md 直读);否则回落 `dex.store.conn`(派生库,
485
+ 零行为变更)。缺省回落是**诚实降级**:缺配置时不猜路径。
486
+ """
487
+ conn = _md_conn_or_none()
488
+ if conn is not None:
489
+ return conn
490
+ return dex.store.conn