@furongjun1999/dsh-memory 0.8.1 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (717) hide show
  1. package/README.md +662 -659
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +38 -27
  4. package/docs/README.md +18 -2
  5. package/docs/discipline/harnesses.yaml +1 -1
  6. package/docs/discipline/templates/spec.txt.tmpl +23 -0
  7. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203.md +179 -0
  8. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/347/201/265/346/236/242/351/200/202/351/205/215.md +45 -0
  9. package/docs//350/247/204/350/214/203/AI/347/274/226/347/250/213/351/200/232/347/224/250/350/247/204/350/214/203_/350/207/252/346/243/200/346/270/205/345/215/225.md +69 -0
  10. package/dsh/README.md +1 -1
  11. package/dsh/cordis.yml.example +139 -139
  12. package/hive/README.md +705 -0
  13. package/hive/id_charset_blocks.txt +147 -0
  14. package/lib/bridge.d.ts +3 -0
  15. package/lib/bridge.js +32 -11
  16. package/lib/cli.js +14 -17
  17. package/lib/hooks.d.ts +37 -3
  18. package/lib/hooks.js +176 -24
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +29 -6
  21. package/lib/init.js +21 -21
  22. package/lib/lib/datapath.d.ts +56 -0
  23. package/lib/lib/datapath.js +102 -9
  24. package/lib/lib/hook_audit.d.ts +0 -1
  25. package/lib/lib/hook_audit.js +51 -3
  26. package/lib/lib/mdcg_client.d.ts +4 -1
  27. package/lib/lib/mdcg_client.js +10 -2
  28. package/lib/lib/mutual.js +61 -15
  29. package/lib/lib/prompt_safety.js +28 -2
  30. package/lib/lib/roleplay_web.js +30 -2
  31. package/lib/lib/token_store.d.ts +25 -6
  32. package/lib/lib/token_store.js +224 -33
  33. package/lib/tools.d.ts +15 -2
  34. package/lib/tools.js +44 -4
  35. package/md_cg/_guard_kit.py +121 -0
  36. package/md_cg/admission.py +718 -718
  37. package/md_cg/anchor.py +114 -0
  38. package/md_cg/audit.py +37 -7
  39. package/md_cg/autonomy.py +433 -288
  40. package/md_cg/autonomy_modes.py +781 -642
  41. package/md_cg/bench_beir_bm25.py +154 -0
  42. package/md_cg/bench_beir_scifact.py +170 -0
  43. package/md_cg/bench_bm25_blockmax.py +134 -0
  44. package/md_cg/bench_bm25_incremental.py +246 -0
  45. package/md_cg/bench_ccg_heading.py +118 -0
  46. package/md_cg/bench_csre_correctness.py +145 -0
  47. package/md_cg/bench_excerpt_budget.py +94 -0
  48. package/md_cg/bench_fuzzy_substrings.py +299 -0
  49. package/md_cg/bench_memory_rsi.py +358 -0
  50. package/md_cg/bench_memory_rsi_latency.py +82 -0
  51. package/md_cg/bench_memory_rsi_public.py +116 -0
  52. package/md_cg/bench_memory_rsi_tools.py +229 -0
  53. package/md_cg/bench_rrf_candidates.py +212 -0
  54. package/md_cg/bench_rrf_public.py +100 -0
  55. package/md_cg/bench_text_projections.py +221 -0
  56. package/md_cg/bench_timeanchor.py +357 -0
  57. package/md_cg/bm25.py +601 -0
  58. package/md_cg/branches.py +404 -327
  59. package/md_cg/build_postings.py +74 -73
  60. package/md_cg/ccgc.py +4 -2
  61. package/md_cg/chain.py +573 -379
  62. package/md_cg/coldverify.py +531 -292
  63. package/md_cg/condaccept.py +263 -0
  64. package/md_cg/condgate.py +308 -0
  65. package/md_cg/config_registry.py +329 -0
  66. package/md_cg/config_registry_bulk.py +482 -0
  67. package/md_cg/config_registry_guard.py +487 -0
  68. package/md_cg/config_render.py +354 -0
  69. package/md_cg/config_validate.py +455 -0
  70. package/md_cg/conformance.py +747 -726
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +1793 -1633
  74. package/md_cg/crypto.py +346 -24
  75. package/md_cg/datapath.py +137 -12
  76. package/md_cg/eval_common.py +522 -575
  77. package/md_cg/evidence.py +946 -585
  78. package/md_cg/evidence_delivery.py +101 -0
  79. package/md_cg/experience_consolidation.py +317 -0
  80. package/md_cg/export.py +329 -222
  81. package/md_cg/forgetting.py +1050 -922
  82. package/md_cg/freshness.py +601 -548
  83. package/md_cg/fsutil.py +1120 -824
  84. package/md_cg/goal_gen.py +458 -0
  85. package/md_cg/hotcache.py +107 -9
  86. package/md_cg/hyperedge.py +262 -251
  87. package/md_cg/identity.py +573 -391
  88. package/md_cg/imgskill.py +1712 -0
  89. package/md_cg/insight.py +540 -521
  90. package/md_cg/interface_schema.py +146 -0
  91. package/md_cg/interop.py +20 -0
  92. package/md_cg/judgment_manifest.py +24 -1
  93. package/md_cg/lifecycle.py +426 -345
  94. package/md_cg/links.py +27 -6
  95. package/md_cg/logref.py +332 -327
  96. package/md_cg/mcp_server.py +5227 -4449
  97. package/md_cg/mdcg.py +1301 -203
  98. package/md_cg/mdcos.py +7108 -5440
  99. package/md_cg/memory_rsi.py +308 -0
  100. package/md_cg/metacognition.py +726 -591
  101. package/md_cg/nodefile.py +151 -3
  102. package/md_cg/op_table.py +1128 -0
  103. package/md_cg/postings.py +524 -300
  104. package/md_cg/predict.py +1103 -1100
  105. package/md_cg/probe_memory_rsi.py +95 -0
  106. package/md_cg/probe_memory_rsi_mcp.py +66 -0
  107. package/md_cg/protect.py +654 -494
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +606 -600
  110. package/md_cg/qmd.py +477 -0
  111. package/md_cg/qmd_llm.py +334 -0
  112. package/md_cg/query_excerpt.py +171 -0
  113. package/md_cg/queue_health.py +130 -0
  114. package/md_cg/reach.py +470 -453
  115. package/md_cg/readcache.py +115 -3
  116. package/md_cg/reconcile.py +239 -228
  117. package/md_cg/refindex.py +1191 -1042
  118. package/md_cg/refine.py +613 -604
  119. package/md_cg/retrieve.py +128 -0
  120. package/md_cg/review_cli.py +204 -26
  121. package/md_cg/revise.py +140 -0
  122. package/md_cg/rollback.py +657 -420
  123. package/md_cg/rollback_cli.py +124 -104
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +490 -429
  126. package/md_cg/rrf_candidates.py +204 -0
  127. package/md_cg/run_tests.py +19 -1
  128. package/md_cg/scrub.py +177 -23
  129. package/md_cg/security.py +269 -17
  130. package/md_cg/self_state.py +1053 -1029
  131. package/md_cg/self_surface.py +50 -0
  132. package/md_cg/semantic/canonical.py +144 -144
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +141 -139
  135. package/md_cg/session5.py +106 -0
  136. package/md_cg/signer.py +76 -2
  137. package/md_cg/sleep.py +1779 -1583
  138. package/md_cg/sources.py +1091 -833
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +85 -18
  142. package/md_cg/stgidx.py +537 -281
  143. package/md_cg/subgraph.py +851 -729
  144. package/md_cg/sustain.py +458 -19
  145. package/md_cg/task_memory.py +367 -0
  146. package/md_cg/test_action_derive.py +210 -203
  147. package/md_cg/test_audit_heartbeat_20261015.py +417 -0
  148. package/md_cg/test_audit_protection_20261015.py +483 -0
  149. package/md_cg/test_audit_rotate_parity.py +280 -0
  150. package/md_cg/test_audit_state_20261015.py +253 -0
  151. package/md_cg/test_audit_write_20261015.py +161 -0
  152. package/md_cg/test_auto_defaults.py +43 -4
  153. package/md_cg/test_autonomy_emotion.py +328 -0
  154. package/md_cg/test_autonomy_modes.py +2013 -1973
  155. package/md_cg/test_b1_foreign_read.py +245 -0
  156. package/md_cg/test_bm25.py +438 -0
  157. package/md_cg/test_bm25_hydration_refill.py +265 -0
  158. package/md_cg/test_bm25_incremental.py +241 -0
  159. package/md_cg/test_bm25_incremental_mutations.py +160 -0
  160. package/md_cg/test_bm25_mutations.py +205 -0
  161. package/md_cg/test_bm25_pool_view.py +196 -0
  162. package/md_cg/test_boot_openblas_guard.py +218 -197
  163. package/md_cg/test_boundary_hit.py +1 -1
  164. package/md_cg/test_branches_sensitivity.py +375 -0
  165. package/md_cg/test_c8_search_rrf_gates.py +1 -1
  166. package/md_cg/test_canonical_timezones.py +211 -0
  167. package/md_cg/test_ccg_heading_parser.py +73 -0
  168. package/md_cg/test_chain_best_first.py +403 -0
  169. package/md_cg/test_chain_candidate_scope.py +227 -0
  170. package/md_cg/test_cn_recall_grams.py +206 -0
  171. package/md_cg/test_code_kind_forbidden.py +101 -0
  172. package/md_cg/test_coldverify_drain.py +127 -0
  173. package/md_cg/test_condaccept.py +156 -0
  174. package/md_cg/test_condgate.py +141 -0
  175. package/md_cg/test_config_registry.py +55 -0
  176. package/md_cg/test_crypto_rotate.py +257 -0
  177. package/md_cg/test_csre_correctness.py +297 -0
  178. package/md_cg/test_csre_index_import_guard.py +161 -0
  179. package/md_cg/test_csre_mutations.py +34 -0
  180. package/md_cg/test_csre_session.py +69 -0
  181. package/md_cg/test_curiosity_budget.py +468 -0
  182. package/md_cg/test_d17_autostart_toolface.py +453 -0
  183. package/md_cg/test_datapath_tilde_home.py +271 -0
  184. package/md_cg/test_derived_cache_generations.py +256 -0
  185. package/md_cg/test_evidence_delivery_compact.py +54 -0
  186. package/md_cg/test_exact_text_cache.py +191 -0
  187. package/md_cg/test_excerpt_budget.py +188 -0
  188. package/md_cg/test_experience_consolidation.py +112 -0
  189. package/md_cg/test_export_default_collision.py +138 -0
  190. package/md_cg/test_export_snapshots.py +322 -0
  191. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  192. package/md_cg/test_gain_gate.py +16 -5
  193. package/md_cg/test_goal_gen.py +355 -0
  194. package/md_cg/test_h2_session_view_norm.py +251 -233
  195. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  196. package/md_cg/test_heartbeat_ledger.py +557 -0
  197. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  198. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  199. package/md_cg/test_i50e_readside_protection.py +658 -656
  200. package/md_cg/test_identity_attribution.py +96 -2
  201. package/md_cg/test_identity_contract.py +329 -0
  202. package/md_cg/test_imgskill.py +1444 -0
  203. package/md_cg/test_index_snapshot_shape.py +240 -0
  204. package/md_cg/test_interop_judgment.py +258 -228
  205. package/md_cg/test_issue111_gate_order.py +77 -0
  206. package/md_cg/test_issue111_scoring_contract.py +87 -0
  207. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  208. package/md_cg/test_issue128_session_env_authority.py +246 -0
  209. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  210. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  211. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  212. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  213. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  214. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  215. package/md_cg/test_issue149_accel_default_face.py +249 -0
  216. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  217. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  218. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  219. package/md_cg/test_issue152_sealed_postings.py +309 -0
  220. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  221. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  222. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  223. package/md_cg/test_issue157b_index_remainder.py +344 -0
  224. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  225. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  226. package/md_cg/test_issue191_import_trust.py +382 -0
  227. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  228. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  229. package/md_cg/test_issue193_write_scope.py +378 -0
  230. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  231. package/md_cg/test_issue211_export_target.py +325 -0
  232. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  233. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  234. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  235. package/md_cg/test_issue216_clash_routes.py +214 -0
  236. package/md_cg/test_issue217_slot_routes.py +248 -0
  237. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  238. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  239. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  240. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  241. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  242. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  243. package/md_cg/test_issue275_layer_param.py +250 -0
  244. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  245. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  246. package/md_cg/test_issue278_neg_window.py +294 -0
  247. package/md_cg/test_issue278_negative_layering.py +83 -0
  248. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  249. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  250. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  251. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  252. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  253. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  254. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  255. package/md_cg/test_issue303_design_boundaries.py +262 -0
  256. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  257. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  258. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  259. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  260. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  261. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  262. package/md_cg/test_issue322_node_write_lock.py +727 -0
  263. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  264. package/md_cg/test_issue324_write_size_fields.py +215 -0
  265. package/md_cg/test_issue325_audit_poison.py +230 -0
  266. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  267. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  268. package/md_cg/test_issue326_key_perms.py +355 -0
  269. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  270. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  271. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  272. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  273. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  274. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  275. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  276. package/md_cg/test_issue350_casefold_collision.py +236 -0
  277. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  278. package/md_cg/test_issue352_imgaudit.py +418 -0
  279. package/md_cg/test_issue352_pathsjson.py +537 -0
  280. package/md_cg/test_issue352_refindex.py +412 -0
  281. package/md_cg/test_issue352_rollback.py +604 -0
  282. package/md_cg/test_issue352_vstateinherit.py +196 -0
  283. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  284. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  285. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  286. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  287. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  288. package/md_cg/test_issue358_truncation_observable.py +247 -0
  289. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  290. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  291. package/md_cg/test_issue362_neg_condition.py +468 -0
  292. package/md_cg/test_issue363_lexical_idf.py +275 -0
  293. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  294. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  295. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  296. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  297. package/md_cg/test_issue378_protected_floor.py +310 -0
  298. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  299. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  300. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  301. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  302. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  303. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  304. package/md_cg/test_issue404_heal_receipt.py +390 -0
  305. package/md_cg/test_issue405_git_pathspec.py +333 -0
  306. package/md_cg/test_issue408_eface_registry.py +291 -0
  307. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  308. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  309. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  310. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  311. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  312. package/md_cg/test_issue413_preimage_twin.py +340 -0
  313. package/md_cg/test_issue414_write_args_parity.py +613 -0
  314. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  315. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  316. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  317. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  318. package/md_cg/test_issue418_role_type_gate.py +265 -0
  319. package/md_cg/test_issue419_pii_redaction.py +642 -0
  320. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  321. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  322. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  323. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  324. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  325. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  326. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  327. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  328. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  329. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  330. package/md_cg/test_issue434_435_float_gate.py +90 -0
  331. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  332. package/md_cg/test_issue43_default_policy.py +874 -865
  333. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  334. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  335. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  336. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  337. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  338. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  339. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  340. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  341. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  342. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  343. package/md_cg/test_issue451_audit_actor.py +313 -0
  344. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  345. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  346. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  347. package/md_cg/test_issue466_basis_registry.py +469 -0
  348. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  349. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  350. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  351. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  352. package/md_cg/test_issue471_identity_readable.py +137 -0
  353. package/md_cg/test_issue472_audit_chain.py +91 -0
  354. package/md_cg/test_issue472_prune_ledger.py +106 -0
  355. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  356. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  357. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  358. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  359. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  360. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  361. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  362. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  363. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  364. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  365. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  366. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  367. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  368. package/md_cg/test_issue543_issue_authorization.py +147 -0
  369. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  370. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  371. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  372. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  373. package/md_cg/test_issue547_audit_durable.py +96 -0
  374. package/md_cg/test_issue549_durable_append.py +143 -0
  375. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  376. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  377. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  378. package/md_cg/test_issue559_refine_prefix.py +70 -0
  379. package/md_cg/test_issue561_pending_review.py +109 -0
  380. package/md_cg/test_issue562_retired_faces.py +150 -0
  381. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  382. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  383. package/md_cg/test_issue69_audit_boundary.py +129 -0
  384. package/md_cg/test_issue71_queue_backlog.py +377 -0
  385. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  386. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  387. package/md_cg/test_issue75_neural_failure.py +582 -0
  388. package/md_cg/test_issue78_export_concurrency.py +334 -0
  389. package/md_cg/test_issue80_residual_flush.py +169 -0
  390. package/md_cg/test_issue82_credential_rules.py +271 -0
  391. package/md_cg/test_issue82_layer_and_size.py +120 -0
  392. package/md_cg/test_issue84_portability.py +95 -0
  393. package/md_cg/test_issue85_export_overwrite.py +113 -0
  394. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  395. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  396. package/md_cg/test_issue88_conclusion_face.py +280 -0
  397. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  398. package/md_cg/test_issue89_zero_score.py +169 -0
  399. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  400. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  401. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  402. package/md_cg/test_issue93_remember_redaction.py +282 -0
  403. package/md_cg/test_issue96_key_fallback.py +102 -0
  404. package/md_cg/test_issue98_tenant_root.py +104 -0
  405. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  406. package/md_cg/test_live_validity_cache.py +256 -0
  407. package/md_cg/test_logref.py +1141 -1109
  408. package/md_cg/test_mcp_call_argument_types.py +99 -0
  409. package/md_cg/test_md_access_parity.py +330 -255
  410. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  411. package/md_cg/test_memory_rsi.py +215 -0
  412. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  413. package/md_cg/test_mode_parity.py +1413 -1393
  414. package/md_cg/test_mutation_residue.py +120 -0
  415. package/md_cg/test_mutation_rollback.py +835 -805
  416. package/md_cg/test_n123_derive_expiry_chain.py +210 -205
  417. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  418. package/md_cg/test_n209_verify_write_face_gates.py +466 -461
  419. package/md_cg/test_n230_dirty_replay.py +52 -9
  420. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  421. package/md_cg/test_neg_coverage_budget.py +500 -0
  422. package/md_cg/test_neg_tail_honesty.py +733 -663
  423. package/md_cg/test_p0.py +16 -2
  424. package/md_cg/test_p14_root_fallback.py +373 -0
  425. package/md_cg/test_p1x_ref_root.py +47 -10
  426. package/md_cg/test_p21_tokens.py +294 -293
  427. package/md_cg/test_p24_evidence.py +232 -227
  428. package/md_cg/test_p26_refindex.py +20 -3
  429. package/md_cg/test_p27_docindex.py +792 -777
  430. package/md_cg/test_p28_refcheck.py +1053 -1032
  431. package/md_cg/test_p29_session_ingest_export.py +6 -0
  432. package/md_cg/test_p2_mcp.py +474 -453
  433. package/md_cg/test_p2_six_elements.py +476 -463
  434. package/md_cg/test_p3.py +370 -261
  435. package/md_cg/test_p33_ccg_wiring.py +300 -293
  436. package/md_cg/test_p3_legacy_closure.py +438 -433
  437. package/md_cg/test_p40_refine_worklist.py +244 -241
  438. package/md_cg/test_p47_session_view.py +25 -9
  439. package/md_cg/test_p4_freshness.py +781 -774
  440. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  441. package/md_cg/test_p9c_dedup_hints.py +288 -283
  442. package/md_cg/test_policy_required_ccg.py +444 -432
  443. package/md_cg/test_postings_digest_memo.py +139 -0
  444. package/md_cg/test_predict_beta.py +138 -135
  445. package/md_cg/test_qmd.py +500 -0
  446. package/md_cg/test_query_excerpt.py +209 -0
  447. package/md_cg/test_reach.py +456 -378
  448. package/md_cg/test_reach_snapshot_admission.py +218 -0
  449. package/md_cg/test_readcache_prodpath.py +4 -0
  450. package/md_cg/test_recall_face_guards.py +854 -812
  451. package/md_cg/test_recall_metadata.py +422 -0
  452. package/md_cg/test_retr_s5.py +312 -213
  453. package/md_cg/test_retr_score_once.py +14 -2
  454. package/md_cg/test_review_cli_attribution.py +11 -7
  455. package/md_cg/test_review_queue_batch.py +123 -0
  456. package/md_cg/test_review_queue_index.py +130 -0
  457. package/md_cg/test_rrf_candidates.py +292 -0
  458. package/md_cg/test_rrf_qualified_topk.py +214 -0
  459. package/md_cg/test_rrf_unique_votes.py +218 -0
  460. package/md_cg/test_s1_ast_judge.py +110 -0
  461. package/md_cg/test_scrub_ledger.py +413 -0
  462. package/md_cg/test_security_audit_b26.py +34 -3
  463. package/md_cg/test_security_audit_v21.py +1 -2
  464. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  465. package/md_cg/test_session5_identity.py +93 -0
  466. package/md_cg/test_session_attribution_consistency.py +813 -0
  467. package/md_cg/test_session_identity_tristate.py +486 -0
  468. package/md_cg/test_sleep_p1.py +35 -3
  469. package/md_cg/test_state_event_op.py +521 -514
  470. package/md_cg/test_state_projection_streaming.py +136 -0
  471. package/md_cg/test_stg_interval_candidates.py +280 -0
  472. package/md_cg/test_stg_time_blocks.py +239 -0
  473. package/md_cg/test_stgidx_index_parity.py +1024 -1020
  474. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  475. package/md_cg/test_sustain_bounded.py +652 -624
  476. package/md_cg/test_task_memory.py +394 -0
  477. package/md_cg/test_text_projection_mutations.py +101 -0
  478. package/md_cg/test_time_anchor.py +421 -0
  479. package/md_cg/test_time_core_lint.py +1024 -975
  480. package/md_cg/test_tool_face.py +200 -189
  481. package/md_cg/test_trust_bounded_frontier.py +248 -0
  482. package/md_cg/test_trust_edge_reachability.py +405 -0
  483. package/md_cg/test_w5_path_fingerprint.py +381 -0
  484. package/md_cg/test_w7_redlines.py +659 -0
  485. package/md_cg/test_write_return_shape.py +919 -0
  486. package/md_cg/test_writepipe.py +228 -226
  487. package/md_cg/timeanchor.py +534 -0
  488. package/md_cg/tokens.py +68 -5
  489. package/md_cg/tool_face.py +273 -260
  490. package/md_cg/trust.py +1114 -1030
  491. package/md_cg/twophase.py +303 -231
  492. package/md_cg/weights.py +642 -638
  493. package/md_cg/whitebox.py +536 -527
  494. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  495. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  496. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  497. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  498. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1633
  499. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -298
  500. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1065
  501. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  502. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  503. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -470
  504. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -476
  505. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -958
  506. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  507. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2895
  508. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  509. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4054
  510. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  511. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  512. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  513. package/md_cg/writelimit.py +584 -390
  514. package/md_cg/writepipe.py +1337 -826
  515. package/package.json +14 -9
  516. package/scripts/workspace_index.py +328 -0
  517. package/src/bridge.ts +34 -11
  518. package/src/cli.ts +75 -65
  519. package/src/hooks.ts +932 -776
  520. package/src/index.ts +30 -7
  521. package/src/init.ts +362 -361
  522. package/src/lib/datapath.ts +419 -326
  523. package/src/lib/hook_audit.ts +42 -3
  524. package/src/lib/mdcg_client.ts +469 -461
  525. package/src/lib/mutual.ts +481 -432
  526. package/src/lib/prompt_safety.ts +178 -149
  527. package/src/lib/roleplay_web.ts +30 -2
  528. package/src/lib/token_store.ts +274 -52
  529. package/src/tools.ts +271 -223
  530. package/zcode/README.md +1 -1
  531. package/docs/GBrain/345/217/257/345/200/237/351/211/264/347/202/271_/347/201/265/346/236/242/350/220/275/347/202/271/344/272/244/346/216/245_20260919.md +0 -169
  532. package/docs/Pi/345/217/257/345/255/246/344/271/240/344/274/230/347/202/271_/347/201/265/346/236/242/345/244/247/350/204/221/346/224/271/350/277/233/344/272/244/346/216/245_20260915.md +0 -144
  533. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v1.0.md +0 -299
  534. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_md_cg_v2.0.md +0 -239
  535. package/docs/eval/AGI/344/270/203/347/273/264/350/257/204/345/210/206/346/212/245/345/221/212_/345/205/255/345/256/266/350/256/260/345/277/206/347/263/273/347/273/237/345/220/214/345/260/272/345/256/236/346/265/213_v3.1.md +0 -340
  536. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225v2_/345/217/202/350/200/203dsh-TUI_v1.0.md +0 -248
  537. package/docs/eval/DSH/346/227/245/345/277/227/347/264/242/345/274/225/346/225/210/346/236/234/351/252/214/350/257/201_v1.0.md +0 -209
  538. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  539. package/docs/eval/N225_/347/264/242/345/274/225/346/227/245/345/277/227/351/235/236/345/257/271/350/261/241/350/243/205/350/275/275/351/235/242/347/261/273/345/236/213/351/227/270_v1.0.md +0 -418
  540. package/docs/eval/P1b2_/350/257/273/351/235/242/344/273/243/351/231/205/344/277/256/345/244/215_v1.0.md +0 -124
  541. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  542. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  543. package/docs/eval/bench_lingshu_self//347/201/265/346/236/242/350/207/252/345/272/223/347/253/257/345/210/260/347/253/257/346/243/200/347/264/242/345/256/236/346/265/213_v1.0.md +0 -38
  544. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -223
  545. package/docs/eval/cons200_/345/206/262/347/252/201/346/243/200/346/265/213/351/200/211/351/235/242_/345/256/236/346/226/275/350/256/260/345/275/225_v1.1.md +0 -340
  546. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/344/270/216/351/224/256/347/261/273/345/236/213/351/227/270_v1.1.md +0 -441
  547. package/docs/eval/issue43_/351/273/230/350/256/244/347/255/226/347/225/245/345/212/240/350/275/275/344/270/216/345/207/255/346/215/256/346/230/216/346/226/207/351/230/237/345/210/227_v1.0.md +0 -398
  548. package/docs/eval/issue50_/345/205/203/346/225/260/346/215/256/351/200/217/344/274/240/344/270/216/345/205/234/345/272/225_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -437
  549. package/docs/eval/issue50_/345/215/212/351/207/215/345/244/215/345/276/205/345/256/232/345/244/215/346/240/270_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -488
  550. package/docs/eval/issue50_/345/276/205/345/256/232/345/244/215/346/240/270/345/205/245/351/230/237_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -428
  551. package/docs/eval/issue50_/350/257/273/351/235/242/344/277/235/346/212/244/345/217/252/350/256/244/346/230/276/345/274/217/346/235/245/346/272/220_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -271
  552. package/docs/eval/issue50_/351/207/215/350/246/201/345/272/246/345/220/214/346/272/220/344/270/216/344/277/235/346/212/244/350/257/255/344/271/211_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -306
  553. package/docs/eval/issue51_/344/270/200/351/224/256/345/256/211/350/243/205/345/244/261/350/264/245_/345/275/222/345/261/236/345/210/244/345/256/232_v1.0.md +0 -58
  554. package/docs/eval/issue52_/346/235/241/344/273/266/345/205/210/350/241/214/344/270/216/346/210/252/346/226/255/345/217/257/350/247/202/346/265/213_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -360
  555. package/docs/eval/issue64_replay_check_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -284
  556. package/docs/eval/issue65_session_recall_/344/274/232/350/257/235/351/232/224/347/246/273_/346/240/270/351/252/214/344/270/216/344/277/256/345/244/215_v1.0.md +0 -329
  557. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/241/346/241/243/344/275/215/345/215/225/344/270/200/345/205/245/345/217/243_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -651
  558. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/242/345/217/230/346/233/264/345/215/225/344/270/216/345/233/236/346/273/232/345/216/237/350/257/255_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -439
  559. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/243/345/207/206/345/205/245/350/257/273/346/225/260_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1337
  560. package/docs/eval//344/270/211/346/241/243/350/207/252/346/262/273_/346/255/245/351/252/244/342/221/244/346/224/266/345/256/230/344/270/216/345/205/250/351/223/276/351/252/214/346/224/266_/350/220/275/347/240/201/350/256/260/345/275/225_v1.0.md +0 -1817
  561. package/docs/eval//344/270/215/345/217/257/351/235/240/346/200/247/350/220/275/345/234/260_P0_v1.0.md +0 -185
  562. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/200/346/211/271_/346/216/245/347/272/277/344/270/216/347/255/211/344/273/267/345/217/230/346/215/242_v1.0.md +0 -498
  563. package/docs/eval//344/274/230/345/214/226/347/254/254/344/270/211/346/211/271_/351/227/250/347/246/201/350/275/254/346/255/243/344/270/216/350/260/203/345/272/246/346/255/242/350/241/200/344/270/216/351/227/250/346/216/247/346/224/266/345/217/243_v1.0.md +0 -669
  564. package/docs/eval//344/274/230/345/214/226/347/254/254/344/272/214/346/211/271_/344/276/235/350/265/226/351/200/217/344/274/240/344/270/216/345/257/271/346/213/215/345/217/243/345/276/204/344/270/216/350/264/237/347/274/223/345/255/230_v1.0.md +0 -683
  565. package/docs/eval//345/207/272/350/264/247/351/235/242/345/206/222/347/203/237_/350/277/233/350/264/247/351/227/250/347/246/201_v1.0.md +0 -460
  566. package/docs/eval//345/217/221/345/270/20306_/344/270/200/351/224/256/351/205/215/347/275/256/344/270/216DSH0172_v1.0.md +0 -171
  567. package/docs/eval//345/217/221/345/270/20307_/345/244/226/351/203/250/346/212/245/345/221/212/345/233/233/346/211/271/344/277/256/345/244/215/344/270/216/346/217/222/344/273/266/351/235/242/345/212/240/345/233/272_v1.0.md +0 -209
  568. package/docs/eval//345/217/221/345/270/20308_/350/207/252/350/277/255/344/273/243/344/270/216/347/235/241/347/234/240_/345/233/276/346/243/200/347/264/242/350/267/257/344/270/216/346/235/203/351/207/215_v1.0.md +0 -97
  569. package/docs/eval//345/217/221/345/270/20309_/346/243/200/347/264/242/351/235/242/344/270/211/346/211/271/346/224/266/345/217/243_v1.0.md +0 -66
  570. package/docs/eval//345/217/221/345/270/20310_/350/257/273/351/235/242/346/215/237/345/235/217UTF8/345/256/266/346/227/217/346/224/266/345/217/243_v1.0.md +0 -71
  571. package/docs/eval//345/217/221/345/270/20311_/345/244/226/346/212/245/345/205/255/350/277/236/344/277/256/344/270/216/344/270/226/347/225/214/346/250/241/345/236/213/345/272/225/345/272/247_v1.0.md +0 -91
  572. package/docs/eval//345/217/221/345/270/20312_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_v1.0.md +0 -108
  573. package/docs/eval//345/217/221/345/270/20313_/344/270/212/344/270/213/346/226/207/350/207/252/347/256/241/347/220/206/346/234/272/345/210/266_v1.0.md +0 -114
  574. package/docs/eval//345/217/221/345/270/20314_/350/272/253/344/275/223/303/227/350/204/221/347/273/204/345/220/210_v1.0.md +0 -160
  575. package/docs/eval//345/217/221/345/270/20315_/344/274/232/350/257/235/351/232/224/347/246/273/344/277/256/345/244/215/344/270/216/350/272/253/344/275/223/345/272/223/345/261/225/347/244/272_v1.0.md +0 -88
  576. package/docs/eval//345/256/236/351/252/214/346/226/271/346/241/210_/345/255/246/344/271/240/351/227/255/347/216/257AB/344/270/216/346/250/252/350/257/204_v1.0.md +0 -174
  577. package/docs/eval//345/275/222/344/270/200/345/261/202/347/274/272/347/234/201/347/277/273/345/205/263_/344/277/256/345/244/215/350/256/260/345/275/225_v1.0.md +0 -458
  578. package/docs/eval//346/200/247/350/203/275/344/270/223/351/241/271_/345/206/267/346/237/245/350/257/242/344/270/216/345/206/205/345/255/230_v1.0.md +0 -218
  579. package/docs/eval//346/225/205/351/232/234/346/263/250/345/205/245/345/256/236/346/265/213_v1.0.md +0 -432
  580. package/docs/eval//346/250/252/350/257/204_/345/205/255/345/256/266100/351/242/230/344/270/255/350/213/261/345/217/214/346/237/245_v1.0.md +0 -223
  581. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/270/200/346/211/271_v1.0.md +0 -195
  582. package/docs/eval//347/224/250/346/210/267/350/243/201/345/206/263/345/244/204/347/275/256_/347/254/254/344/272/214/346/211/271B6_/346/234/254/346/234/272/350/267/257/345/276/204/347/233/270/345/257/271/345/214/226_v1.0.md +0 -78
  583. package/docs/eval//347/253/257/345/210/260/347/253/257LoCoMoQA/345/220/214/345/217/243/345/276/204/345/257/271/347/205/247_v1.0.md +0 -100
  584. package/docs/eval//347/253/257/345/210/260/347/253/257/345/271/262/346/211/260/346/261/240/350/257/204/346/265/213_/347/241/256/345/256/232/346/200/247/350/243/201/345/206/263vsLLM_judge_v1.1.md +0 -197
  585. package/docs/eval//347/254/2543/345/261/202stg/347/273/223/346/236/204/347/264/242/345/274/225_/345/256/236/346/226/275/350/256/260/345/275/225_v1.0.md +0 -250
  586. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_LoCoMo_/347/201/265/346/236/242_.png +0 -0
  587. package/docs/eval//347/254/254/344/270/211/346/226/271/351/252/214/350/257/201/346/212/245/345/221/212_/347/201/265/346/236/242_vs_dejavu_/347/273/237/344/270/200/350/257/204/345/210/206_v7.md +0 -202
  588. package/docs/eval//347/274/226/347/240/201/351/235/242/345/211/215/347/275/256_/345/205/245/345/217/243/350/207/252/344/277/235/350/257/201UTF8/344/270/216/346/226/207/346/234/254open/345/256/210/345/215/253_v1.0.md +0 -646
  589. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v1.md +0 -156
  590. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v10.md +0 -210
  591. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v11.md +0 -227
  592. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v12.md +0 -203
  593. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v13.md +0 -233
  594. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v14.md +0 -191
  595. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v15.md +0 -213
  596. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v16.md +0 -214
  597. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v17.md +0 -199
  598. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v18.md +0 -183
  599. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v19.md +0 -207
  600. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v2.md +0 -156
  601. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v20.md +0 -283
  602. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v21.md +0 -224
  603. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v22.md +0 -223
  604. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v23.md +0 -293
  605. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v24.md +0 -303
  606. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v25.md +0 -230
  607. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v26.md +0 -196
  608. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v27.md +0 -259
  609. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v28.md +0 -217
  610. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v29.md +0 -270
  611. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v3.md +0 -152
  612. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v30.md +0 -231
  613. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v31.md +0 -281
  614. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v4.md +0 -128
  615. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v5.md +0 -114
  616. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v6.md +0 -192
  617. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v7.md +0 -187
  618. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v8.md +0 -207
  619. package/docs/eval//347/274/272/351/231/267/346/214/226/346/216/230_/350/207/252/344/270/273/350/277/255/344/273/243_v9.md +0 -203
  620. package/docs/eval//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_P1_/346/212/275/345/217/226/345/231/250v4_/344/270/211/347/216/207/350/257/273/346/225/260_v1.0.md +0 -231
  621. package/docs/eval//351/262/270/345/250/230/344/270/203/347/261/273/347/212/266/346/200/201/350/277/275/350/270/252_v1.0.md +0 -176
  622. package/docs/hive//344/270/273/344/273/243/347/220/206/345/255/220/344/273/243/347/220/206/350/256/260/345/277/206/346/236/266/346/236/204/350/256/276/350/256/241.md +0 -385
  623. package/docs/hive//344/273/244/347/211/214/344/270/216/350/247/222/350/211/262/346/235/203/350/201/214/345/210/206/347/246/273_v0.1.md +0 -165
  624. package/docs/hive//344/273/244/347/211/214/350/257/255/344/271/211/344/277/256/346/255/243_/344/273/262/350/243/201/344/275/215_v0.1.md +0 -76
  625. package/docs/hive//345/244/232/347/253/257harness/351/200/232/344/277/241/345/245/221/347/272/246_v0.1.md +0 -42
  626. package/docs/hive//345/255/220/344/273/243/347/220/206/351/205/215/347/275/256/346/240/207/345/207/206_v0.5.md +0 -236
  627. package/docs/hive//345/256/211/345/205/250/345/256/241/350/256/241/345/256/236/351/224/232_v0.1.md +0 -202
  628. package/docs/hive//346/243/200/347/264/242/346/224/266/346/225/233/345/256/236/346/265/213/344/270/216S1b/350/256/276/350/256/241_v0.1.md +0 -43
  629. package/docs/hive//346/243/200/347/264/242/347/256/227/346/263/225/345/217/243/345/276/204/345/257/271/347/205/247_v0.1.md +0 -210
  630. package/docs/hive//346/243/200/347/264/242/350/267/257/345/276/204/344/270/216/350/256/244/347/237/245/347/273/223/346/236/204/345/245/221/347/272/246_v0.1.md +0 -152
  631. package/docs/hive//350/234/202/345/267/242M6_ingest/345/256/236/346/226/275/350/256/241/345/210/222_v0.1.md +0 -47
  632. package/docs/hive//350/234/202/345/267/242/345/217/214/345/256/236/344/276/213/344/272/222/351/252/214_/350/256/276/350/256/241/345/256/232/347/250/277.md +0 -519
  633. package/docs/hive//350/234/202/345/267/242/345/267/245/344/275/234/350/256/260/345/277/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -85
  634. package/docs/hive//350/234/202/345/267/242/350/256/276/350/256/241_/347/220/206/350/256/272/345/257/271/351/275/220_v0.1.md +0 -191
  635. package/docs/hive//350/234/202/345/267/242/350/277/255/344/273/243_/345/256/217/350/247/202/344/270/216/347/276/244/344/275/223/350/260/203/345/272/246_v0.1.md +0 -90
  636. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  637. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  638. package/docs/mdcg/D_meta_/345/267/245/347/250/213/345/214/226/346/226/271/346/241/210_v0.2.md +0 -216
  639. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  640. package/docs/mdcg/guardrail-charter.md +0 -164
  641. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  642. package/docs/mdcg/memory-assessment.html +0 -923
  643. package/docs/mdcg/memory_score.html +0 -213
  644. package/docs/mdcg/memory_score.png +0 -0
  645. package/docs/mdcg/release_v0.3.0.md +0 -36
  646. package/docs/mdcg/release_v0.4.11.md +0 -49
  647. package/docs/mdcg/release_v0.4.5.md +0 -55
  648. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  649. package/docs/mdcg//344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/344/275/277/347/224/250/344/270/216/350/277/220/347/273/264_v1.0.md +0 -384
  650. package/docs/mdcg//344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/345/245/221/347/272/246_v0.1.md +0 -82
  651. package/docs/mdcg//345/205/250/345/272/223/344/273/243/347/240/201/350/257/204/345/256/241/344/270/216/346/235/241/344/273/266/345/214/226/346/263/250/351/207/212_/350/256/241/345/210/222_v0.1.md +0 -600
  652. package/docs/mdcg//345/212/237/350/203/275/350/260/203/347/224/250/346/230/240/345/260/204/350/241/250_v0.1.md +0 -266
  653. package/docs/mdcg//345/215/225/345/205/203/350/207/252/346/210/221/351/224/232/347/202/271_/347/263/273/347/273/237/346/217/220/347/244/272/350/257/215/346/240/207/345/207/206_v0.3.md +0 -275
  654. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  655. package/docs/mdcg//346/272/220/347/240/201/347/272/247/346/236/266/346/236/204/345/256/241/350/256/241_GPT/346/211/271/350/257/204/345/257/271/347/205/247_v1.0.md +0 -130
  656. package/docs/mdcg//347/201/265/346/236/24282/345/267/245/345/205/267_/345/212/237/350/203/275/346/225/264/347/220/206/344/270/216/350/277/201/347/247/273/346/230/240/345/260/204_v0.1.md +0 -278
  657. package/docs/mdcg//347/201/265/346/236/242MCP/345/267/245/345/205/267/346/200/273/350/241/250_v3.4.md +0 -164
  658. package/docs/mdcg//347/201/265/346/236/242_/350/207/252/346/210/221/345/261/202/345/256/232/344/271/211.md +0 -43
  659. package/docs/mdcg//347/201/265/346/236/242/344/270/211/345/261/202/346/213/206/345/210/206/350/247/204/345/210/222_v0.1.md +0 -181
  660. package/docs/mdcg//347/201/265/346/236/242/350/256/260/345/277/206/345/212/250/350/257/215/345/215/217/350/256/256_v1.0-draft.md +0 -177
  661. package/docs/mdcg//347/216/257/344/272/214_/347/231/275/347/256/261/345/241/253/345/205/205/346/265/201/346/260/264/347/272/277_v0.1.md +0 -31
  662. package/docs/mdcg//347/235/241/347/234/240/345/221/250/346/234/237_/350/277/220/347/273/264/345/211/215/346/217/220/344/270/216/347/273/264/346/212/244/346/214/207/345/215/227_v1.0.md +0 -337
  663. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  664. package/docs/mdcg//350/256/244/347/237/245/345/233/276_G4-G8/347/274/272/345/217/243/350/243/201/345/256/232/345/215/225_v0.1.md +0 -491
  665. package/docs/mdcg//350/256/244/347/237/245/345/233/276_MD/347/233/256/345/275/225/346/226/271/346/241/210_v0.1.md +0 -552
  666. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/346/235/241/344/273/266/347/251/272/351/227/264/345/220/210/346/210/220/344/270/216/347/224/237/346/225/210/346/235/241/344/273/266/345/217/243/345/276/204_v0.1.md +0 -340
  667. package/docs/mdcg//350/256/244/347/237/245/345/233/276_/347/264/242/345/274/225/344/270/216/345/267/245/347/250/213/350/247/204/350/214/203/345/214/226_/350/256/241/345/210/222_v0.1.md +0 -624
  668. package/docs/mdcg//350/256/244/347/237/245/345/233/276/344/275/234/344/270/272/350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_/350/257/204/344/274/260/344/270/216/350/267/257/347/272/277_v0.1.md +0 -94
  669. package/docs/mdcg//350/256/260/345/277/206/346/223/215/344/275/234/347/263/273/347/273/237_MdCGOS/344/270/216MCP/346/216/245/345/205/245_v0.1.md +0 -281
  670. package/docs/mdcg//350/267/250/347/253/257/351/252/214/350/257/201/344/270/216/345/220/214/346/255/245/345/215/217/350/256/256_v0.1.md +0 -93
  671. package/docs/plans/GridWorld/346/234/200/345/260/217/351/227/255/347/216/257/350/247/204/346/240/274_v0.1.md +0 -176
  672. package/docs/plans/stg/346/235/241/344/273/266/345/214/226/344/270/216/347/273/223/346/236/204/347/264/242/345/274/225_/350/256/276/350/256/241_v0.1.md +0 -124
  673. package/docs/plans//345/205/250/344/270/255/346/226/207/347/274/226/347/240/201/344/270/216/350/234/202/345/267/242/344/273/273/345/212/241/346/240/207/350/257/206/345/245/221/347/272/246_v2.0.md +0 -220
  674. package/docs/plans//345/221/275/345/220/215/346/262/273/347/220/206_/351/241/271/347/233/256/350/256/241/345/210/222.md +0 -81
  675. package/docs/plans//345/244/232/344/270/273/344/275/223/344/270/226/347/225/214/346/250/241/345/236/213_/345/257/271/351/275/220/350/257/204/344/274/260/344/270/216/350/220/275/345/234/260/350/256/276/350/256/241_v0.1.md +0 -141
  676. package/docs/plans//347/201/265/346/236/242/350/272/253/344/275/223/303/227/350/204/221_/344/270/226/347/225/214/346/250/241/345/236/213/345/257/271/346/216/245/350/256/276/350/256/241_v0.1.md +0 -119
  677. package/docs/plans//347/234/237/346/272/220/347/264/242/345/274/225_/351/200/232/347/224/250/346/234/272/345/210/266_v0.3.md +0 -227
  678. package/docs/plans//347/235/241/347/234/240/344/270/216/350/207/252/350/277/255/344/273/243_/345/212/237/350/203/275/344/274/230/345/214/226/350/256/276/350/256/241_v0.4.md +0 -547
  679. package/docs/plans//347/237/245/350/257/206/345/233/276/350/260/261/351/241/271/347/233/256_/344/272/244/346/216/245/346/226/207/346/241/243_20260914.md +0 -308
  680. package/docs/plans//350/234/202/345/267/242/346/250/241/345/236/213/345/257/206/351/222/245/351/205/215/347/275/256/351/235/242_v1.0.md +0 -385
  681. package/docs/plans//350/256/260/345/277/206/350/207/252/345/244/204/347/220/206/344/270/211/346/241/243/350/207/252/346/262/273_/350/256/276/350/256/241_v0.2.md +0 -207
  682. package/docs/plans//350/257/255/344/271/211/346/227/266/347/251/272/345/233/276/350/241/245/345/205/250_/344/270/226/347/225/214/346/250/241/345/236/213/345/212/237/350/203/275/347/253/257_/350/256/276/350/256/241_v0.1.md +0 -107
  683. package/docs/promo/bilibili-cover.jpg +0 -0
  684. package/docs/promo/promo-visual-1.png +0 -0
  685. package/docs/promo/promo-visual-2.png +0 -0
  686. package/docs/promo/promo-visual-3.png +0 -0
  687. package/docs/promo/promo-visual-4.png +0 -0
  688. package/docs/promo/promo-visual-5.png +0 -0
  689. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  690. package/docs/swarm//350/234/202/347/276/244/345/220/214/351/224/231/346/243/200/346/265/213/345/256/236/351/252/214/345/215/217/350/256/256_v0.1.md +0 -242
  691. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/344/275/277/347/224/250/346/212/245/345/221/212_20260913.md +0 -68
  692. package/docs/swarm//350/234/202/347/276/244/345/244/232/346/231/272/350/203/275/344/275/223_/345/212/237/350/203/275/350/257/264/346/230/216_v0.6.md +0 -130
  693. package/docs/swarm//350/234/202/347/276/244/347/233/262/345/214/272/346/240/207/350/256/260_v1.0.md +0 -89
  694. package/docs/theory//344/270/215/345/217/257/351/235/240/345/256/232/347/220/206/344/270/216/345/244/261/346/225/210/344/274/230/345/205/210/346/241/206/346/236/266_v0.3.md +0 -365
  695. package/docs/theory//344/277/241/346/201/257/345/267/256/344/270/272/344/273/200/344/271/210/345/277/205/347/204/266/345/255/230/345/234/250/344/270/224/350/207/252/347/204/266/346/211/251/345/244/247.md +0 -239
  696. package/docs/theory//345/215/225/347/272/277/347/250/213/344/270/216/346/263/250/346/204/217/345/212/233/351/233/206/344/270/255_/346/227/240/344/272/211/350/256/256/347/220/206/350/256/272/346/226/207/346/241/243_v1.0.md +0 -129
  697. package/docs/theory//345/271/266/345/217/221/345/277/205/347/204/266/346/200/247/347/220/206/350/256/272_v0.2.md +0 -134
  698. package/docs/theory//346/231/272/350/203/275/347/232/204/345/205/254/347/220/206/345/214/226/345/237/272/347/237/263.md +0 -789
  699. package/docs/theory//346/231/272/350/203/275/347/232/204/350/256/244/347/237/245/350/277/207/347/250/213.md +0 -379
  700. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  701. package/docs/theory//346/246/202/345/277/265/345/210/206/345/261/202/345/257/271/351/275/220/350/241/250_v0.1.md +0 -145
  702. package/docs/theory//347/220/206/350/256/272_/346/234/272/345/210/266_/344/273/243/347/240/201_/345/256/236/351/252/214_/347/274/272/345/217/243/347/237/251/351/230/265_v0.1.md +0 -144
  703. package/docs/theory//347/220/206/350/256/272/344/273/223/346/213/206/345/210/206/344/270/216/347/231/275/347/256/261/347/237/245/350/257/206/345/272/223/345/206/205/350/277/201_v0.1.md +0 -198
  704. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/346/230/257/344/273/200/344/271/210/357/274/237.md +0 -812
  705. package/docs/theory//347/231/275/347/256/261/346/231/272/350/203/275/347/263/273/345/210/227/302/267/347/254/254/344/272/224/347/257/207/357/274/232/350/256/251AI/347/234/237/346/255/243/350/243/205/344/270/212/350/256/260/345/277/206.md +0 -421
  706. package/docs/theory//350/256/244/347/237/245/344/273/243/347/220/206/344/270/216/346/224/266/346/225/233/347/273/223/346/236/204_/346/235/241/344/273/266/350/256/272/351/207/215/346/236/204_v0.1.md +0 -221
  707. package/docs/world_model//344/270/226/347/225/214/346/250/241/345/236/213_/347/245/236/347/273/217/347/275/221/347/273/234/345/272/225/345/261/202/346/236/266/346/236/204_v1.0.md +0 -237
  708. package/docs//344/270/215/345/217/257/351/235/240/346/200/247/347/220/206/350/256/272_v0.1.md +0 -343
  709. package/docs//345/217/221/345/270/203/344/273/266/345/233/236/346/272/257/350/257/264/346/230/216_v0.1.md +0 -82
  710. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/346/236/266/346/236/204/345/255/246/344/271/240_/345/244/226/351/203/250/347/220/206/350/256/272/345/257/271/347/205/247/344/270/216/350/267/257/347/272/277/344/272/244/346/216/245_20260916.md +0 -98
  711. package/docs//345/255/230/347/256/227/344/270/200/344/275/223/347/245/236/347/273/217/347/275/221/347/273/234/346/236/266/346/236/204_/346/200/273/347/272/262/344/270/216/344/272/244/346/216/245_20260916.md +0 -109
  712. package/docs//347/201/265/346/236/242/350/207/252/346/210/221/346/224/271/350/277/233/345/267/245/344/275/234/350/256/241/345/210/222_/345/244/226/351/203/250/347/240/224/347/251/266/347/263/273/345/210/227/345/220/270/346/224/266_v1_20260919.md +0 -286
  713. package/docs//347/231/275/347/256/261/345/214/226/347/272/262/351/242/206_/344/270/211/351/241/271/347/233/256/345/255/246/344/271/240/346/200/273/346/236/266/346/236/204/344/270/216Ghidra/344/272/244/346/216/245_20260916.md +0 -104
  714. package/docs//347/247/244_/350/256/260/345/277/206/347/263/273/347/273/237/350/257/204/346/265/213/350/247/204/350/214/203_v2.1.md +0 -225
  715. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.2.md +0 -121
  716. package/docs//350/256/260/345/277/206/347/263/273/347/273/237/345/215/263/347/231/275/347/256/261/345/214/226/346/231/272/350/203/275_/346/236/266/346/236/204/345/257/271/347/205/247_v0.3.md +0 -117
  717. package/docs//350/256/260/345/277/206/350/257/204/345/256/241/347/263/273/347/273/237_/347/253/213/351/241/271/350/256/276/350/256/241/344/270/216/346/226/275/345/267/245/344/272/244/346/216/245_20260915.md +0 -183
@@ -0,0 +1,82 @@
1
+ """Warm, untraced timing replay. No selection and no new quality samples.
2
+
3
+ python -m md_cg.bench_memory_rsi_latency --experiment /saved/run --out /new/output
4
+ One warm-up pass is excluded. The original frozen holdout fixture is replayed;
5
+ this is a performance measurement, not another blind test set.
6
+ """
7
+ import argparse
8
+ import hashlib
9
+ import json
10
+ import os
11
+ from pathlib import Path
12
+ import random
13
+ import statistics
14
+ import time
15
+
16
+
17
+ def main(argv=None):
18
+ ap = argparse.ArgumentParser(description=__doc__)
19
+ ap.add_argument('--experiment', required=True, type=Path)
20
+ ap.add_argument('--out', required=True, type=Path)
21
+ args = ap.parse_args(argv)
22
+ out = args.out.resolve()
23
+ out.mkdir(parents=True, exist_ok=False)
24
+ for key, name in (('MDCG_STATE_ROOT', 'state'), ('MDCG_AUX_ROOT', 'auxiliary'),
25
+ ('DSH_HOME', 'dsh'), ('MDCG_ROOT', 'unused')):
26
+ os.environ[key] = str(out / name)
27
+ os.environ.update(MDCG_HOTCACHE='0', MDCG_READ_CACHE='1', MDCG_FRESHNESS='0',
28
+ MDCG_SEMANTIC='0', MDCG_RRF_CANDIDATES='0')
29
+ from .bench_memory_rsi import BUDGET, ITEM_BUDGET, populate
30
+ from .evidence_delivery import deliver
31
+ from .mdcos import MdCGOS
32
+ from .memory_rsi import create_sandbox
33
+ fixture_file = args.experiment / 'fixtures.json'
34
+ data = json.loads(fixture_file.read_text(encoding='utf-8'))
35
+ modes = ['A_original', 'B_query', 'B_query_metadata', 'C_prefix_control', 'D_candidate_index']
36
+ records = []
37
+ for fixture in (f for f in data if f['split'] == 'holdout'):
38
+ cg = MdCGOS(str(create_sandbox(out / str(fixture['seed']))))
39
+ try:
40
+ populate(cg, fixture)
41
+ for turn in range(11):
42
+ questions = list(fixture['queries'])
43
+ random.Random(fixture['seed'] + turn).shuffle(questions)
44
+ for q in questions:
45
+ order = list(modes)
46
+ random.Random(q['qid'] + str(turn)).shuffle(order)
47
+ for mode in order:
48
+ os.environ['MDCG_RRF_CANDIDATES'] = '1' if mode == 'D_candidate_index' else '0'
49
+ wall, cpu = time.perf_counter(), time.process_time()
50
+ if mode in ('A_original', 'D_candidate_index'):
51
+ cg.recall(q['query'], k=5, budget_tokens=BUDGET, max_item_tokens=ITEM_BUDGET)
52
+ else:
53
+ found, _ = cg.search_rrf(q['query'], k=5)
54
+ deliver(found, q['query'], budget_tokens=BUDGET, max_item_tokens=ITEM_BUDGET,
55
+ mode={'B_query': 'query', 'B_query_metadata': 'query_metadata',
56
+ 'C_prefix_control': 'prefix'}[mode])
57
+ ms = (time.perf_counter() - wall) * 1000
58
+ cpu_ms = (time.process_time() - cpu) * 1000
59
+ if turn:
60
+ records.append({'qid': q['qid'], 'seed': fixture['seed'], 'round': turn,
61
+ 'mode': mode, 'ms': ms, 'cpu_ms': cpu_ms})
62
+ finally:
63
+ cg.close()
64
+ summary = {}
65
+ for mode in modes:
66
+ rows = [r for r in records if r['mode'] == mode]
67
+ latency = sorted(r['ms'] for r in rows)
68
+ summary[mode] = {'executions': len(rows), 'unique_queries': len({r['qid'] for r in rows}),
69
+ 'p50_ms': statistics.median(latency),
70
+ 'p95_ms': latency[int(len(latency) * .95)],
71
+ 'cpu_ms_total': sum(r['cpu_ms'] for r in rows)}
72
+ payload = {'fixture_sha256': hashlib.sha256(fixture_file.read_bytes()).hexdigest(),
73
+ 'tracemalloc_enabled': False, 'warmup_rounds_excluded': 1,
74
+ 'repeats': 10, 'summary': summary, 'records': records,
75
+ 'warning': 'warm synthetic graph; process CPU on Windows has coarse resolution; no cold-start or RSS claim'}
76
+ (out / 'results.json').write_text(json.dumps(payload, ensure_ascii=False, indent=2), encoding='utf-8')
77
+ print(json.dumps(summary, indent=2))
78
+ return 0
79
+
80
+
81
+ if __name__ == '__main__':
82
+ raise SystemExit(main())
@@ -0,0 +1,116 @@
1
+ """RRF/delivery diagnostics on public hive state-chain data; no reader QA score.
2
+
3
+ python -m md_cg.bench_memory_rsi_public --bench /checkout/hive-memory-bench --out /new/output
4
+ Only the existing official diagnostic normalization is reused. Value-substring
5
+ presence does NOT prove current-value correctness, support, or temporal reasoning.
6
+ """
7
+ from __future__ import annotations
8
+
9
+ import argparse
10
+ import hashlib
11
+ import json
12
+ import os
13
+ from pathlib import Path
14
+ import statistics
15
+ import subprocess
16
+ import time
17
+
18
+
19
+ def main(argv=None):
20
+ ap = argparse.ArgumentParser(description=__doc__)
21
+ ap.add_argument('--bench', type=Path, required=True)
22
+ ap.add_argument('--out', type=Path, required=True)
23
+ ap.add_argument('--include-compact', action='store_true', help='retrospective compact-metadata ablation')
24
+ args = ap.parse_args(argv)
25
+ out, bench = args.out.resolve(), args.bench.resolve()
26
+ out.mkdir(parents=True, exist_ok=False)
27
+ for key, folder in (('MDCG_ROOT', 'graph'), ('MDCG_STATE_ROOT', 'state'),
28
+ ('MDCG_AUX_ROOT', 'auxiliary'), ('DSH_HOME', 'dsh')):
29
+ os.environ[key] = str(out / folder)
30
+ os.environ.update(MDCG_SEMANTIC='0', MDCG_HOTCACHE='0', MDCG_FRESHNESS='0',
31
+ MDCG_RRF_CANDIDATES='0', MDCG_SUSTAIN='0')
32
+ # Keep imports after isolation: storage modules bind some paths at import.
33
+ from scripts import bench_chain_retrieval_diag as diag
34
+ from .evidence_delivery import deliver
35
+ from .mdcos import MdCGOS, est_tokens
36
+
37
+ _, norm = diag.load_official(str(bench))
38
+ chapters, keys = diag.load_bench(str(bench))
39
+ files = ['chain/corpus/corpus.json', 'chain/keys/keys.json', 'chain/tools/probe_judge.py']
40
+ hashes = {p: hashlib.sha256((bench / p).read_bytes()).hexdigest() for p in files}
41
+ evaluator_files = [Path(__file__), Path(__file__).with_name('evidence_delivery.py')]
42
+ evaluator_hashes = {path.name: hashlib.sha256(path.read_bytes()).hexdigest() for path in evaluator_files}
43
+ modes = ('A_original', 'B_query', 'B_query_metadata', 'C_prefix_control', 'D_candidate_index')
44
+ if args.include_compact:
45
+ modes += ('B_query_metadata_compact',)
46
+ protocol = {'bench_commit': subprocess.check_output(
47
+ ['git', '-C', str(bench), 'rev-parse', 'HEAD'], text=True,
48
+ encoding='utf-8', errors='replace').strip(),
49
+ 'source_sha256': hashes, 'k': 6, 'budgets': [240, 1200], 'max_item_tokens': 250,
50
+ 'evaluator_source_sha256': evaluator_hashes, 'include_compact': args.include_compact,
51
+ 'evaluation_history': 'previously observed public corpus; retrospective diagnostic',
52
+ 'graph_created_at': 1767225600,
53
+ 'selection': 'none; fixed diagnostics after synthetic development',
54
+ 'model': None, 'reader': None, 'official_answer_score': False,
55
+ 'warning': 'value occurrence is not an answer or chain-support metric'}
56
+ (out / 'protocol.json').write_text(json.dumps(protocol, ensure_ascii=False, indent=2), encoding='utf-8')
57
+ cg = MdCGOS(str(out / 'graph'))
58
+ rows_out = []
59
+ try:
60
+ for ch in chapters:
61
+ cg.add(diag.MdCGEngine.node_id(ch['cid']), '# ' + ch['cid'] + '\n' + ch['text'],
62
+ layer='knowledge', verification_basis='data', source='public:hive-memory-bench',
63
+ created_at=1767225600)
64
+ cg.flush()
65
+ for q in (q for q in keys if q.get('type') == '现值'):
66
+ cur, stale = diag.split_values(q['answer'], norm)
67
+ for budget in (240, 1200):
68
+ for mode in modes:
69
+ os.environ['MDCG_RRF_CANDIDATES'] = '1' if mode == 'D_candidate_index' else '0'
70
+ start = time.perf_counter()
71
+ if mode in ('A_original', 'D_candidate_index'):
72
+ packed = cg.recall(q['question'], k=6, budget_tokens=budget, max_item_tokens=250)
73
+ text = '\n\n'.join(p['content'] for p in packed['pack'])
74
+ else:
75
+ found, _ = cg.search_rrf(q['question'], k=6)
76
+ packed = deliver(found, q['question'], budget_tokens=budget, max_item_tokens=250,
77
+ mode={'B_query': 'query', 'B_query_metadata': 'query_metadata',
78
+ 'B_query_metadata_compact': 'query_metadata_compact',
79
+ 'C_prefix_control': 'prefix'}[mode])
80
+ text = packed['text']
81
+ elapsed = (time.perf_counter() - start) * 1000
82
+ found, _ = cg.search_rrf(q['question'], k=6)
83
+ hits = [{'text': r[0]['content'], 'score': r[1]} for r in found]
84
+ d = diag.diag_case(hits, cur, stale, norm)
85
+ rows_out.append({'qid': q['qid'], 'mode': mode, 'budget': budget,
86
+ 'retrieval': d, 'rank_ids': [r[0]['id'] for r in found],
87
+ 'delivered_current_value_present': bool(cur and cur in norm(text)),
88
+ 'tokens': est_tokens(text), 'ms': elapsed, 'text': text})
89
+ finally:
90
+ os.environ['MDCG_RRF_CANDIDATES'] = '0'
91
+ cg.close()
92
+ summary = {}
93
+ for budget in (240, 1200):
94
+ summary[str(budget)] = {}
95
+ for mode in sorted({r['mode'] for r in rows_out}):
96
+ selected = [r for r in rows_out if r['mode'] == mode and r['budget'] == budget]
97
+ summary[str(budget)][mode] = {
98
+ 'questions': len(selected),
99
+ 'retrieved_current_value_present_rate': statistics.mean(r['retrieval']['cur_rank'] is not None for r in selected),
100
+ 'stale_precedes_current_proxy': statistics.mean(r['retrieval']['stale_beats_current'] for r in selected),
101
+ 'delivered_current_value_present_rate': statistics.mean(r['delivered_current_value_present'] for r in selected),
102
+ 'mean_estimated_tokens': statistics.mean(r['tokens'] for r in selected),
103
+ 'budget_violations': sum(r['tokens'] > budget for r in selected),
104
+ 'answer_accuracy': None, 'temporal_reasoning_accuracy': None}
105
+ unchanged = all(hashlib.sha256((bench / p).read_bytes()).hexdigest() == h for p, h in hashes.items())
106
+ result = {'protocol': protocol, 'summary': summary, 'records': rows_out,
107
+ 'source_files_unchanged': unchanged,
108
+ 'evaluator_sources_unchanged': all(hashlib.sha256(path.read_bytes()).hexdigest()
109
+ == evaluator_hashes[path.name] for path in evaluator_files)}
110
+ (out / 'results.json').write_text(json.dumps(result, ensure_ascii=False, indent=2), encoding='utf-8')
111
+ print(json.dumps(summary, ensure_ascii=False, indent=2))
112
+ return 0
113
+
114
+
115
+ if __name__ == '__main__':
116
+ raise SystemExit(main())
@@ -0,0 +1,229 @@
1
+ """Check the offline RSI pipeline using actual, bounded Python tool executions.
2
+
3
+ The controller and three repair plans are fixed. This is integration evidence,
4
+ not a language-model Agent benchmark or proof of learned task success.
5
+ No network, package install, shell command or automatically accepted knowledge.
6
+ """
7
+ import argparse
8
+ import hashlib
9
+ import json
10
+ import os
11
+ from pathlib import Path
12
+ import subprocess
13
+ import sys
14
+
15
+
16
+ PROGRAM = '''import csv, json, sys
17
+ from pathlib import Path
18
+ kind, mode, folder = sys.argv[1:]
19
+ project = Path(folder)
20
+ if mode == 'required-unit-check':
21
+ actual = json.loads((project / 'actual-output.json').read_text(encoding='utf-8'))
22
+ passed = actual.get('unit') == 'ms'
23
+ print(json.dumps({'answer': int(passed)}))
24
+ raise SystemExit(0 if passed else 1)
25
+ elif mode == 'placeholder':
26
+ print(json.dumps({'answer': 'placeholder'}))
27
+ elif kind == 'relative-config':
28
+ path = project / 'config.json' if mode == 'repair' else Path('config.json')
29
+ print(json.dumps(json.loads(path.read_text(encoding='utf-8'))))
30
+ elif kind == 'json-bom':
31
+ encoding = 'utf-8-sig' if mode == 'repair' else 'utf-8'
32
+ print(json.dumps(json.loads((project / 'config.json').read_text(encoding=encoding))))
33
+ elif kind == 'csv-bom':
34
+ encoding = 'utf-8-sig' if mode == 'repair' else 'utf-8'
35
+ with (project / 'config.csv').open(encoding=encoding, newline='') as handle:
36
+ row = next(csv.DictReader(handle))
37
+ print(json.dumps({'answer': int(row['answer'])}))
38
+ else:
39
+ raise ValueError('unsupported fixture family')
40
+ '''
41
+
42
+ PLANS = {
43
+ 'relative-config': {'action': 'read config.json using the fixture project absolute path',
44
+ 'conditions': ['working directory differs from fixture project root',
45
+ 'config.json exists in fixture project root']},
46
+ 'json-bom': {'action': 'read the UTF-8 BOM JSON fixture using utf-8-sig before json.loads',
47
+ 'conditions': ['JSON file has a UTF-8 BOM', 'loader is Python json.loads']},
48
+ 'csv-bom': {'action': 'read the UTF-8 BOM CSV fixture using utf-8-sig before csv.DictReader',
49
+ 'conditions': ['CSV file has a UTF-8 BOM', 'header field is answer']}}
50
+
51
+
52
+ def sha(path):
53
+ return hashlib.sha256(Path(path).read_bytes()).hexdigest()
54
+
55
+
56
+ def write_json(path, value):
57
+ path.write_text(json.dumps(value, ensure_ascii=False, indent=2), encoding='utf-8')
58
+
59
+
60
+ def graph_hash(root):
61
+ values = [(p.relative_to(root).as_posix(), sha(p))
62
+ for p in sorted(root.rglob('*')) if p.is_file()]
63
+ return hashlib.sha256(json.dumps(values).encode('utf-8')).hexdigest()
64
+
65
+
66
+ def main():
67
+ ap = argparse.ArgumentParser(description=__doc__)
68
+ ap.add_argument('--out', type=Path, required=True)
69
+ ap.add_argument('--multicheck', action='store_true', help='include a second required check that fails')
70
+ args = ap.parse_args()
71
+ out = args.out.resolve()
72
+ out.mkdir(parents=True, exist_ok=False)
73
+ for name in tuple(os.environ):
74
+ if name.startswith(('MDCG_', 'WB_')):
75
+ os.environ.pop(name)
76
+ for key, folder in (('MDCG_ROOT', 'unused-default'), ('MDCG_DATA_ROOT', 'data'),
77
+ ('MDCG_AUX_ROOT', 'auxiliary'), ('MDCG_STATE_ROOT', 'state'),
78
+ ('DSH_HOME', 'dsh'), ('TEMP', 'temporary'), ('TMP', 'temporary')):
79
+ path = out / folder
80
+ path.mkdir(exist_ok=True)
81
+ os.environ[key] = str(path)
82
+ os.environ.update(WB_MD_DIRECT='0', WB_MD_ROOT=str(out / 'absent-md'),
83
+ MDCG_SUSTAIN='0', MDCG_SLEEP='0', MDCG_FRESHNESS='0',
84
+ PYTHONUTF8='1', PYTHONIOENCODING='utf-8',
85
+ HF_HUB_OFFLINE='1', TRANSFORMERS_OFFLINE='1')
86
+ from .mdcos import MdCGOS
87
+ from .memory_rsi import MemoryRSILab, create_sandbox
88
+
89
+ program = out / 'fixture_tool.py'
90
+ program.write_text(PROGRAM, encoding='utf-8')
91
+ receipt_dir = out / 'tool-receipts'
92
+ receipt_dir.mkdir()
93
+ cwd = out / 'empty-working-directory'
94
+ cwd.mkdir()
95
+ protocol = {'controller': 'fixed whitelist; no model and no strategy selection',
96
+ 'families': PLANS, 'training_outcomes': ['repair', 'unchanged', 'placeholder']
97
+ + (['mixed'] if args.multicheck else []),
98
+ 'checks': 'returncode == 0 AND parsed stdout equals independent expected value',
99
+ 'tool_timeout_seconds': 5, 'max_tool_calls': 30 if args.multicheck else 21,
100
+ 'total_repairs': 3, 'multicheck': args.multicheck,
101
+ 'automatic_acceptance': False, 'script_sha256': sha(__file__),
102
+ 'fixture_tool_sha256': sha(program),
103
+ 'agent_task_success': None,
104
+ 'caveat': 'Fixed plan replay on constructed files is not an LLM Agent transfer score.'}
105
+ write_json(out / 'protocol.json', protocol)
106
+ calls = []
107
+
108
+ def fixture(name, family, expected):
109
+ project = out / 'fixtures' / name
110
+ project.mkdir(parents=True)
111
+ if family == 'csv-bom':
112
+ (project / 'config.csv').write_text('answer\n' + str(expected) + '\n', encoding='utf-8-sig')
113
+ else:
114
+ (project / 'config.json').write_text(json.dumps({'answer': expected}),
115
+ encoding='utf-8-sig' if family == 'json-bom' else 'utf-8')
116
+ return project
117
+
118
+ def run(family, mode, project, expected):
119
+ if len(calls) >= protocol['max_tool_calls']:
120
+ raise RuntimeError('tool call budget exceeded')
121
+ if family not in PLANS or mode not in ('repair', 'unchanged', 'placeholder', 'required-unit-check'):
122
+ raise ValueError('plan is outside fixed whitelist')
123
+ argv = [sys.executable, '-X', 'utf8', str(program), family, mode, str(project)]
124
+ completed = subprocess.run(argv, cwd=cwd, capture_output=True, text=True,
125
+ encoding='utf-8', errors='replace', timeout=5, shell=False)
126
+ try:
127
+ parsed = json.loads(completed.stdout)
128
+ except (ValueError, TypeError):
129
+ parsed = None
130
+ passed = completed.returncode == 0 and parsed == {'answer': expected}
131
+ record = {'argv': argv, 'cwd': str(cwd), 'returncode': completed.returncode,
132
+ 'stdout': completed.stdout, 'stderr': completed.stderr,
133
+ 'independent_expected': {'answer': expected}, 'passed': passed,
134
+ 'program_sha256': sha(program)}
135
+ path = receipt_dir / f'{len(calls):03}.json'
136
+ write_json(path, record)
137
+ reference = {'file': path.relative_to(out).as_posix(), 'sha256': sha(path),
138
+ 'returncode': completed.returncode}
139
+ calls.append(reference)
140
+ return record, reference
141
+
142
+ lab_dir = out / 'lab'
143
+ root = create_sandbox(lab_dir)
144
+ cg = MdCGOS(str(root))
145
+ lab = MemoryRSILab(cg, lab_dir, enabled=True)
146
+ observations, successful, proposal_ids = [], {}, []
147
+ try:
148
+ for family_number, (family, plan) in enumerate(PLANS.items()):
149
+ for outcome_number, mode in enumerate(protocol['training_outcomes']):
150
+ task = family + '-' + mode
151
+ expected = 100 + family_number * 10 + outcome_number
152
+ project = fixture(task, family, expected)
153
+ initial, first = run(family, 'unchanged', project, expected)
154
+ repaired, second = run(family, 'repair' if mode == 'mixed' else mode, project, expected)
155
+ if initial['passed'] or initial['returncode'] == 0:
156
+ raise AssertionError('initial fixture must fail visibly')
157
+ error = initial['stderr'].strip().splitlines()[-1]
158
+ action = plan['action'] if mode in ('repair', 'mixed') else 'retry unchanged loader' if mode == 'unchanged' else 'return a placeholder value'
159
+ trace = {'task_id': task, 'scope': 'Python fixture ' + family,
160
+ 'conditions': plan['conditions'], 'events': [
161
+ {'id': 'error', 'kind': 'error', 'text': error, 'receipt': first},
162
+ {'id': 'action', 'kind': 'action', 'text': action,
163
+ 'error_id': 'error', 'receipt': second},
164
+ {'id': 'check', 'kind': 'check', 'text': 'independent expected output check',
165
+ 'source': 'tool', 'passed': repaired['passed'],
166
+ 'error_id': 'error', 'action_id': 'action', 'receipt': second}]}
167
+ overall_pass = repaired['passed']
168
+ if mode == 'mixed':
169
+ (project / 'actual-output.json').write_text(repaired['stdout'], encoding='utf-8')
170
+ extra, third = run(family, 'required-unit-check', project, 1)
171
+ trace['conditions'] = [*plan['conditions'], 'output also requires unit=ms']
172
+ trace['events'].append({'id': 'required-unit', 'kind': 'check',
173
+ 'text': 'independent required unit field check', 'source': 'tool',
174
+ 'passed': extra['passed'], 'error_id': 'error', 'action_id': 'action',
175
+ 'receipt': third})
176
+ overall_pass = overall_pass and extra['passed']
177
+ trace_id = lab.record_experience(trace)
178
+ reflection = lab.reflect(trace_id)
179
+ candidates = reflection['candidates']
180
+ if len(candidates) != int(overall_pass):
181
+ raise AssertionError('candidate/check mismatch')
182
+ curated = None
183
+ if candidates:
184
+ candidate = candidates[0]
185
+ if not lab.verify(candidate)['ok']:
186
+ raise AssertionError('verified observation lost evidence')
187
+ curated = lab.curate(candidate)
188
+ proposal_ids.append(curated['pid'])
189
+ successful[family] = candidate
190
+ observations.append({'task': task, 'mode': mode, 'trace_id': trace_id,
191
+ 'tool_returncode': repaired['returncode'],
192
+ 'primary_check_passed': repaired['passed'],
193
+ 'check_passed': overall_pass, 'candidates': len(candidates),
194
+ 'curation': curated})
195
+ frozen = graph_hash(root)
196
+ replays = []
197
+ for family_number, (family, candidate) in enumerate(successful.items()):
198
+ if candidate.action != PLANS[family]['action']:
199
+ raise AssertionError('action outside frozen repair plan')
200
+ expected = 900 + family_number
201
+ project = fixture(family + '-independent-instance', family, expected)
202
+ record, receipt = run(family, 'repair', project, expected)
203
+ replays.append({'family': family, 'passed': record['passed'], 'receipt': receipt,
204
+ 'source': 'extracted candidate exact-match to fixed plan whitelist'})
205
+ graph_unchanged = frozen == graph_hash(root)
206
+ pending_before = len(cg.review_list())
207
+ rollback = lab.rollback(proposal_ids[0])
208
+ result = {'protocol': protocol, 'observations': observations,
209
+ 'actual_tool_calls': len(calls), 'receipts': calls,
210
+ 'successful_observations': sum(r['check_passed'] for r in observations),
211
+ 'failed_observations': sum(not r['check_passed'] for r in observations),
212
+ 'unsupported_candidates': sum(r['candidates'] for r in observations if not r['check_passed']),
213
+ 'zero_exit_but_failed_check': sum(r['tool_returncode'] == 0 and not r['check_passed'] for r in observations),
214
+ 'independent_instance_plan_replays': replays,
215
+ 'graph_frozen_during_plan_replay': graph_unchanged,
216
+ 'pending_before_rollback': pending_before,
217
+ 'rollback_ok': bool(rollback.get('ok')), 'pending_after_rollback': len(cg.review_list()),
218
+ 'knowledge_nodes_written': sum(entry.get('layer') == 'knowledge' for entry in list(cg.index['nodes'].values())),
219
+ 'agent_task_success': None, 'model': None, 'automatic_acceptance': False,
220
+ 'program_unchanged': sha(program) == protocol['fixture_tool_sha256']}
221
+ write_json(out / 'results.json', result)
222
+ print(json.dumps({k: v for k, v in result.items() if k not in ('protocol', 'observations', 'receipts')},
223
+ ensure_ascii=False, indent=2))
224
+ finally:
225
+ cg.close()
226
+
227
+
228
+ if __name__ == '__main__':
229
+ main()
@@ -0,0 +1,212 @@
1
+ """Actual Markdown / production RRF paired candidate-index benchmark.
2
+
3
+ python -X utf8 -m md_cg.bench_rrf_candidates --sizes 10000,100000 --rounds 3
4
+
5
+ Both arms use the substring-optimized engine. Only MDCG_RRF_CANDIDATES differs.
6
+ Synthetic rare, common and absent queries are reported separately. The first
7
+ query includes lazy index construction; warm timings do not. No LLM, external
8
+ service or result cache is used. This is not a memory QA leaderboard score.
9
+ """
10
+ from __future__ import annotations
11
+
12
+ import argparse
13
+ import hashlib
14
+ import json
15
+ import os
16
+ from pathlib import Path
17
+ import platform
18
+ import statistics
19
+ import sys
20
+ import time
21
+
22
+ from . import mdcos, nodefile
23
+ from .bench_fuzzy_substrings import latency
24
+
25
+
26
+ def key(topic):
27
+ return chr(0x4E00 + topic) + chr(0x6000 + topic) + chr(0x7200 + topic)
28
+
29
+
30
+ def process_memory():
31
+ """Whole-process RSS, including both engines; not per-arm index memory."""
32
+ if sys.platform != "win32":
33
+ return {"available": False}
34
+ import ctypes
35
+ from ctypes import wintypes
36
+ class Counters(ctypes.Structure):
37
+ _fields_ = [("cb", wintypes.DWORD), ("PageFaultCount", wintypes.DWORD)] + [
38
+ (name, ctypes.c_size_t) for name in (
39
+ "PeakWorkingSetSize", "WorkingSetSize", "QuotaPeakPagedPoolUsage",
40
+ "QuotaPagedPoolUsage", "QuotaPeakNonPagedPoolUsage",
41
+ "QuotaNonPagedPoolUsage", "PagefileUsage", "PeakPagefileUsage")]
42
+ api = ctypes.WinDLL("psapi")
43
+ kernel = ctypes.WinDLL("kernel32")
44
+ kernel.GetCurrentProcess.restype = wintypes.HANDLE
45
+ api.GetProcessMemoryInfo.argtypes = [wintypes.HANDLE, ctypes.POINTER(Counters), wintypes.DWORD]
46
+ value = Counters()
47
+ value.cb = ctypes.sizeof(value)
48
+ if not api.GetProcessMemoryInfo(kernel.GetCurrentProcess(), ctypes.byref(value), value.cb):
49
+ return {"available": False}
50
+ return {"available": True, "rss_mib": value.WorkingSetSize / 1048576,
51
+ "peak_rss_mib": value.PeakWorkingSetSize / 1048576}
52
+
53
+
54
+ def fixture(root, count):
55
+ marker = root / "_rrf_candidate_fixture.json"
56
+ spec = {"schema": 1, "nodes": count, "topics": 4096}
57
+ if root.exists():
58
+ if not marker.is_file() or json.loads(marker.read_text(encoding="utf-8")) != spec:
59
+ raise ValueError(f"Refusing to overwrite an unrelated/incomplete pool: {root}")
60
+ return
61
+ root.mkdir(parents=True)
62
+ for i in range(count):
63
+ nid = f"entry_{i:08d}"
64
+ folder = root / "knowledge" / f"{i // 1000:05d}"
65
+ if i % 1000 == 0:
66
+ folder.mkdir(parents=True)
67
+ fm = {"id": nid, "layer": "knowledge", "importance": 0.4,
68
+ "created_at": 1800000000.0 + i, "tags": []}
69
+ content = f"资料条目\n主题:{key(i % 4096)}\n正文记录编号 {i}。\n"
70
+ (folder / (nid + ".md")).write_text(nodefile.dumps(fm, content), encoding="utf-8")
71
+ if (i + 1) % 10000 == 0:
72
+ print(f"fixture {count}: wrote {i + 1} Markdown files", flush=True)
73
+ marker.write_text(json.dumps(spec), encoding="utf-8")
74
+
75
+
76
+ def signature(result, meta):
77
+ # Performance counters/fingerprints intentionally differ. Compare every
78
+ # returned card, score, qualification, provenance and path cardinality.
79
+ value = (result, {name: meta.get(name) for name in (
80
+ "paths", "fused", "provenance", "goal_used", "judge_filtered",
81
+ "expand_source", "judge_ranking", "early_stopped", "boundary")})
82
+ return hashlib.sha256(json.dumps(value, ensure_ascii=False, sort_keys=True,
83
+ separators=(",", ":")).encode()).hexdigest()
84
+
85
+
86
+ def benchmark(root, rounds):
87
+ queries = [("rare", key(i)) for i in (1, 409, 2047, 4095)]
88
+ queries += [("common", "资料"), ("absent", "🦄🦄🦄")]
89
+ report = {"root": str(root), "queries": queries, "first": {}, "configs": {}}
90
+ engines = {}
91
+ counters = {}
92
+ try:
93
+ for arm in ("scan", "indexed"):
94
+ os.environ["MDCG_RRF_CANDIDATES"] = "1" if arm == "indexed" else "0"
95
+ started = time.perf_counter()
96
+ cg = engines[arm] = mdcos.MdCGOS(str(root))
97
+ report.setdefault("construct_ms", {})[arm] = (time.perf_counter() - started) * 1000
98
+ counters[arm] = {"inputs": 0}
99
+ original = cg._read_many
100
+ def measured(entries, stat, original=original, counter=counters[arm]):
101
+ counter["inputs"] += len(entries)
102
+ return original(entries, stat)
103
+ cg._read_many = measured
104
+ started = time.perf_counter()
105
+ rows, meta = cg.search_rrf(queries[0][1], k=10, paths=("lexical", "fuzzy"),
106
+ judge=False, record=False)
107
+ report["first"][arm] = {"ms": (time.perf_counter() - started) * 1000,
108
+ "signature": signature(rows, meta),
109
+ "read_many_inputs": counters[arm]["inputs"],
110
+ "index": meta.get("rrf_candidates")}
111
+ report["nodes"] = len(engines["scan"].index["nodes"])
112
+ report["first_equal"] = report["first"]["scan"]["signature"] == report["first"]["indexed"]["signature"]
113
+ for paths in (("fuzzy",), ("lexical", "fuzzy")):
114
+ name = ",".join(paths)
115
+ records = {arm: [] for arm in engines}
116
+ reference = {}
117
+ mismatches = []
118
+ for turn in range(rounds):
119
+ order = ("scan", "indexed") if turn % 2 == 0 else ("indexed", "scan")
120
+ for arm in order:
121
+ os.environ["MDCG_RRF_CANDIDATES"] = "1" if arm == "indexed" else "0"
122
+ for kind, query in queries:
123
+ counters[arm]["inputs"] = 0
124
+ started = time.perf_counter()
125
+ rows, meta = engines[arm].search_rrf(query, k=10, paths=paths,
126
+ judge=False, record=False)
127
+ ms = (time.perf_counter() - started) * 1000
128
+ digest = signature(rows, meta)
129
+ if query not in reference:
130
+ reference[query] = digest
131
+ elif digest != reference[query]:
132
+ mismatches.append({"arm": arm, "round": turn + 1, "query": query})
133
+ records[arm].append({"round": turn + 1, "kind": kind,
134
+ "query": query, "ms": ms,
135
+ "read_many_inputs": counters[arm]["inputs"],
136
+ "index": meta.get("rrf_candidates"),
137
+ "signature": digest})
138
+ print(f"{report['nodes']} {name} round={turn + 1} {arm}: "
139
+ f"{sum(r['ms'] for r in records[arm][-len(queries):]):.1f} ms", flush=True)
140
+ groups = {}
141
+ for kind in ("rare", "common", "absent", "all"):
142
+ selected = {arm: [r for r in records[arm] if kind == "all" or r["kind"] == kind]
143
+ for arm in engines}
144
+ means = {arm: statistics.mean(r["ms"] for r in rows)
145
+ for arm, rows in selected.items()}
146
+ groups[kind] = {"latency": {arm: latency([r["ms"] for r in rows])
147
+ for arm, rows in selected.items()},
148
+ "speedup_mean": means["scan"] / means["indexed"],
149
+ "mean_read_many_inputs": {arm: statistics.mean(
150
+ r["read_many_inputs"] for r in rows)
151
+ for arm, rows in selected.items()}}
152
+ report["configs"][name] = {"groups": groups, "records": records,
153
+ "mismatch_count": len(mismatches),
154
+ "mismatches": mismatches}
155
+ # A real production write + flush followed by retrieval. Its latency
156
+ # includes add/flush; query time and index update reads are also separate.
157
+ cg = engines["indexed"]
158
+ os.environ["MDCG_RRF_CANDIDATES"] = "1"
159
+ started = time.perf_counter()
160
+ cg.add("write_probe", "🪷🪷🪷", importance=0.1)
161
+ cg.flush()
162
+ query_started = time.perf_counter()
163
+ rows, meta = cg.search_rrf("🪷🪷🪷", k=10, paths=("fuzzy",), judge=False, record=False)
164
+ report["write_visibility"] = {
165
+ "add_flush_query_ms": (time.perf_counter() - started) * 1000,
166
+ "query_ms": (time.perf_counter() - query_started) * 1000,
167
+ "retrieved": "write_probe" in {r[0]["id"] for r in rows},
168
+ "index": meta.get("rrf_candidates")}
169
+ report["process_memory"] = process_memory()
170
+ return report
171
+ finally:
172
+ # The benchmark does not rewrite/compact the immutable fixture index.
173
+ # Flush handles are closed by the production flush() implementation.
174
+ for cg in engines.values():
175
+ cg.flush()
176
+
177
+
178
+ def main():
179
+ parser = argparse.ArgumentParser(description=__doc__)
180
+ parser.add_argument("--sizes", default="10000,100000")
181
+ parser.add_argument("--rounds", type=int, default=3)
182
+ parser.add_argument("--root", type=Path, default=Path(__file__).resolve().parents[2] / "rrf-candidate-bench")
183
+ parser.add_argument("--output", type=Path, default=Path("rrf-candidate-results.json"))
184
+ args = parser.parse_args()
185
+ sizes = [int(s) for s in args.sizes.split(",")]
186
+ if args.rounds < 1 or any(s < 1 for s in sizes):
187
+ parser.error("sizes and rounds must be positive")
188
+ os.environ.update(MDCG_HOTCACHE="0", MDCG_READ_CACHE="1", MDCG_FRESHNESS="0",
189
+ MDCG_RETRIEVAL_PIPELINE="0", MDCG_SEMANTIC="0",
190
+ MDCG_UNIFY_QUERY="0")
191
+ report = {"python": platform.python_version(), "platform": platform.platform(),
192
+ "rounds": args.rounds, "cache": "document cache on; result cache off",
193
+ "baseline": "same substring-optimized code, candidate flag off",
194
+ "datasets": [], "sha256": {name: hashlib.sha256(
195
+ (Path(__file__).parent / name).read_bytes()).hexdigest()
196
+ for name in ("mdcos.py", "rrf_candidates.py", "readcache.py", "hotcache.py",
197
+ "bench_rrf_candidates.py")}}
198
+ args.root.mkdir(parents=True, exist_ok=True)
199
+ for count in sizes:
200
+ root = args.root / str(count)
201
+ fixture(root, count)
202
+ report["datasets"].append(benchmark(root, args.rounds))
203
+ args.output.parent.mkdir(parents=True, exist_ok=True)
204
+ args.output.write_text(json.dumps(report, ensure_ascii=False, indent=2), encoding="utf-8")
205
+ failed = any(not d["first_equal"] or not d["write_visibility"]["retrieved"]
206
+ or any(c["mismatch_count"] for c in d["configs"].values())
207
+ for d in report["datasets"])
208
+ return 1 if failed else 0
209
+
210
+
211
+ if __name__ == "__main__":
212
+ raise SystemExit(main())