@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,227 @@
1
+ """Runtime guard with actual temporary graphs and named mutation assertions."""
2
+ """Shared runtime/mutation harness. No source file is modified by mutations."""
3
+ import argparse
4
+ from contextlib import ExitStack
5
+ import hashlib
6
+ import importlib
7
+ import io
8
+ import json
9
+ from pathlib import Path
10
+ import sys
11
+ import types
12
+ import unittest
13
+ from unittest import mock
14
+
15
+ def _tests(module, name=None):
16
+ loader = unittest.TestLoader()
17
+ suite = (loader.loadTestsFromName(name, module) if name
18
+ else loader.loadTestsFromModule(module))
19
+ log = io.StringIO()
20
+ result = unittest.TextTestRunner(stream=log, verbosity=2).run(suite)
21
+ failed = {t.id().split(' (')[0] for t, _ in result.failures + result.errors}
22
+ return result, {'tests': result.testsRun, 'passed': result.testsRun - len(failed) - len(result.skipped),
23
+ 'failed': len(failed), 'errors': len(result.errors),
24
+ 'skipped': len(result.skipped), 'log': log.getvalue()}
25
+
26
+ def run_guard(namespace, mutations, argv=None):
27
+ parser = argparse.ArgumentParser()
28
+ parser.add_argument('--mutate', action='store_true')
29
+ parser.add_argument('--output', type=Path)
30
+ args = parser.parse_args(argv)
31
+ module = types.ModuleType(namespace['__name__'])
32
+ module.__dict__.update(namespace)
33
+ _, baseline = _tests(module)
34
+ if baseline['tests'] == 0:
35
+ baseline['errors'] += 1
36
+ baseline['failed'] += 1
37
+ baseline['log'] += '\nERROR: no tests were discovered\n'
38
+ report = baseline
39
+ if args.mutate and baseline['failed'] == baseline['errors'] == baseline['skipped'] == 0:
40
+ records = []
41
+ for spec in mutations:
42
+ original = importlib.import_module(spec['module'])
43
+ path = Path(original.__file__)
44
+ before = path.read_bytes()
45
+ source = before.decode('utf-8-sig').replace('\r\n', '\n')
46
+ record = {'name': spec['name'], 'test': spec['test'], 'killed': False}
47
+ try:
48
+ assert source.count(spec['old']) == 1, 'mutation anchor must occur once'
49
+ source = source.replace(spec['old'], spec['new'], 1)
50
+ name = spec['module'] + '._runtime_mutant'
51
+ mutant = types.ModuleType(name)
52
+ mutant.__package__ = original.__package__
53
+ mutant.__file__ = str(path)
54
+ with mock.patch.dict(sys.modules, {name: mutant}):
55
+ exec(compile(source, str(path) + '.mutant', 'exec'), mutant.__dict__)
56
+ value = mutant
57
+ for part in spec['symbol'].split('.'):
58
+ value = getattr(value, part)
59
+ with ExitStack() as stack:
60
+ for target in spec['targets']:
61
+ modname, attrpath = target.split(':')
62
+ owner = importlib.import_module(modname)
63
+ parts = attrpath.split('.')
64
+ for part in parts[:-1]:
65
+ owner = getattr(owner, part)
66
+ stack.enter_context(mock.patch.object(owner, parts[-1], value))
67
+ result, summary = _tests(module, spec['test'])
68
+ record.update(summary)
69
+ record['killed'] = (result.testsRun == 1 and len(result.failures) >= 1
70
+ and not result.errors and not result.skipped)
71
+ except Exception as exc:
72
+ record['harness_error'] = type(exc).__name__ + ': ' + str(exc)
73
+ record['source_untouched'] = path.read_bytes() == before
74
+ record['source_sha256'] = hashlib.sha256(before).hexdigest()
75
+ record['killed'] &= record['source_untouched']
76
+ records.append(record)
77
+ _, restored = _tests(module)
78
+ report = {'baseline': baseline, 'mutants': records, 'restored': restored,
79
+ 'tests': len(records), 'passed': sum(r['killed'] for r in records),
80
+ 'failed': sum(not r['killed'] for r in records),
81
+ 'errors': sum('harness_error' in r or r.get('errors', 0) > 0 for r in records),
82
+ 'skipped': sum(r.get('skipped', 0) for r in records),
83
+ 'source_untouched': all(r['source_untouched'] for r in records)}
84
+ report['failed'] += restored['failed'] + restored['errors'] + restored['skipped']
85
+ if args.output:
86
+ args.output.parent.mkdir(parents=True, exist_ok=True)
87
+ args.output.write_text(json.dumps(report, ensure_ascii=False, indent=2) + '\n', encoding='utf-8')
88
+ if report['failed'] or report['errors']:
89
+ print(json.dumps(report, ensure_ascii=False, indent=2))
90
+ print(f"通过 {report['passed']} / 失败 {report['failed']} / errors {report['errors']} / SKIP {report['skipped']}")
91
+ return int(bool(report['failed'] or report['errors'] or report['skipped']))
92
+
93
+ import json
94
+ import os
95
+ from pathlib import Path
96
+ import tempfile
97
+ import unittest
98
+ from unittest import mock
99
+ from . import mdcos, mdcg
100
+
101
+ class RuntimeCase(unittest.TestCase):
102
+ def setUp(self):
103
+ self.temp = tempfile.TemporaryDirectory(prefix='memory_runtime_')
104
+ self.addCleanup(self.temp.cleanup)
105
+ self.env = mock.patch.dict(os.environ, {
106
+ 'MDCG_MASTER_KEY': 'ab' * 32, 'MDCG_HOTCACHE': '0',
107
+ 'MDCG_RRF_CANDIDATES': '0', 'MDCG_RANK_CREDIBILITY': '0',
108
+ 'MDCG_RETRIEVAL_PIPELINE': '0', 'MDCG_UNIFY_QUERY': '0',
109
+ 'MDCG_EN_ATOMS': '0', 'MDCG_SEMANTIC': '0',
110
+ 'MDCG_SUSTAIN': '0', 'MDCG_SESSION': '', 'DSH_SESSION_ID': '',
111
+ })
112
+ self.env.start()
113
+ self.addCleanup(self.env.stop)
114
+ self.cg = mdcos.MdCGOS(self.temp.name)
115
+ self.addCleanup(self.cg.close)
116
+
117
+ def mutation(name, module, symbol, targets, old, new, test):
118
+ return dict(name=name, module=module, symbol=symbol, targets=targets,
119
+ old=old, new=new, test='Guards.' + test)
120
+
121
+
122
+
123
+ from . import chain
124
+
125
+ class Guards(RuntimeCase):
126
+ def graph(self, **middle):
127
+ edge = lambda target: {'target': target, 'relation_type': 'causal', 'confidence': 1.0}
128
+ self.cg.add('seed', 'needle seed', edges=[edge('bridge')])
129
+ self.cg.add('bridge', '# 生效条件:bridge-only-condition\nbridge', edges=[edge('tail')], **middle)
130
+ self.cg.add('tail', 'remote destination')
131
+ self.cg.flush()
132
+ seed = self.cg.get('seed')
133
+ return [(dict(seed, id='seed'), 1.0)]
134
+
135
+ def path(self, seeds, **options):
136
+ entries = self.cg._candidates(**options)
137
+ return self.cg._path_chain('needle', entries, seeds)
138
+
139
+ def test_hidden_branch_is_not_a_bridge(self):
140
+ seeds = self.graph(branch_id='experiment')
141
+ rows, provenance = self.path(seeds)
142
+ self.assertEqual(rows, [])
143
+ self.assertEqual(provenance, {})
144
+
145
+ def test_explicit_branch_restores_path(self):
146
+ seeds = self.graph(branch_id='experiment')
147
+ rows, prov = self.path(seeds, branch='experiment')
148
+ self.assertIn('tail', {r[0]['id'] for r in rows})
149
+ self.assertEqual(prov['tail']['chain'], ['seed', 'bridge', 'tail'])
150
+
151
+ def test_work_role_is_not_a_bridge(self):
152
+ seeds = self.graph(role='tool-output')
153
+ rows, _ = self.path(seeds)
154
+ self.assertEqual(rows, [])
155
+
156
+ def test_include_work_restores_path(self):
157
+ seeds = self.graph(role='tool-output')
158
+ self.assertIn('tail', {r[0]['id'] for r in self.path(seeds, include_work=True)[0]})
159
+
160
+ def test_expired_node_is_not_a_bridge(self):
161
+ seeds = self.graph(valid_until=1)
162
+ self.assertEqual(self.path(seeds, validity=True)[0], [])
163
+
164
+ def test_session_filter_also_constrains_intermediates(self):
165
+ seeds = self.graph(session='other')
166
+ # Seed/tail share the selected session; only the intermediate differs.
167
+ for nid in ('seed', 'tail'):
168
+ self.cg.index['nodes'][nid]['session'] = 'selected'
169
+ self.assertEqual(self.path(seeds, session='selected')[0], [])
170
+
171
+ def test_layer_filter_constrains_intermediates(self):
172
+ seeds = self.graph(layer='contextual')
173
+ self.assertEqual(self.path(seeds, layer='knowledge')[0], [])
174
+
175
+ def test_real_rrf_has_no_hidden_provenance(self):
176
+ self.graph(branch_id='experiment')
177
+ rows, meta = self.cg.search_rrf('needle', paths=('lexical', 'chain'),
178
+ judge=False, record=False, k=20)
179
+ self.assertNotIn('tail', {r[0]['id'] for r in rows})
180
+ self.assertNotIn('bridge-only-condition', json.dumps(rows, ensure_ascii=False))
181
+
182
+ def test_direct_unscoped_api_keeps_existing_behavior(self):
183
+ self.graph(branch_id='experiment')
184
+ found = chain.expand_from_seeds(self.cg, {'seed': 1.0})
185
+ self.assertIn('tail', found)
186
+
187
+ def test_empty_candidate_pool_returns_no_paths(self):
188
+ seeds = self.graph()
189
+ self.assertEqual(self.cg._path_chain('needle', [], seeds), ([], {}))
190
+
191
+ def test_scope_does_not_poison_global_adjacency(self):
192
+ seeds = self.graph(branch_id='experiment')
193
+ self.assertEqual(self.path(seeds)[0], [])
194
+ self.assertIn('tail', chain.expand_from_seeds(self.cg, {'seed': 1.0}))
195
+
196
+ def test_nonmonotone_fallback_keeps_scope(self):
197
+ self.graph(branch_id='experiment')
198
+ # The native fallback remains usable; only a disallowed bridge is cut.
199
+ report = {}
200
+ import inspect
201
+ # Assert capability first so the baseline is a named assertion failure.
202
+ self.assertIn('allowed_ids', inspect.signature(chain.expand_from_seeds).parameters)
203
+ found = chain.expand_from_seeds(self.cg, {'seed': 1.0}, decay=1.1,
204
+ allowed_ids={'seed', 'tail'}, stats=report)
205
+ self.assertEqual(found, {})
206
+ self.assertEqual(report['algorithm'], 'legacy_fallback')
207
+
208
+ def test_incoming_walk_keeps_scope(self):
209
+ self.graph()
210
+ import inspect
211
+ self.assertIn('allowed_ids', inspect.signature(chain.walk).parameters)
212
+ self.assertEqual(chain.walk(self.cg, 'tail', direction='in',
213
+ allowed_ids={'seed', 'tail'}), [])
214
+
215
+ def test_hidden_intermediate_does_not_consume_budget(self):
216
+ self.graph(branch_id='experiment')
217
+ import inspect
218
+ self.assertIn('allowed_ids', inspect.signature(chain.expand_from_seeds).parameters)
219
+ report = {}
220
+ chain.expand_from_seeds(self.cg, {'seed': 1.0}, allowed_ids={'seed', 'tail'}, stats=report)
221
+ self.assertEqual(report['edges_scanned'], 0)
222
+ self.assertEqual(report['expanded'], 1)
223
+
224
+ MUTATIONS = [{'name': 'C1 allow a hidden target into scoped adjacency', 'module': 'md_cg.chain', 'symbol': '_scoped_adjacency', 'targets': ['md_cg.chain:_scoped_adjacency'], 'old': 'if dst in allowed_ids] for src in allowed_ids}', 'new': 'if True] for src in allowed_ids}', 'test': 'Guards.test_hidden_intermediate_does_not_consume_budget'}, {'name': 'C2 ignore candidate scope entirely', 'module': 'md_cg.chain', 'symbol': '_scoped_adjacency', 'targets': ['md_cg.chain:_scoped_adjacency'], 'old': 'if allowed_ids is None:\n return adj', 'new': 'if True:\n return adj', 'test': 'Guards.test_work_role_is_not_a_bridge'}, {'name': 'C3 drop scope in legacy fallback', 'module': 'md_cg.chain', 'symbol': '_expand_legacy', 'targets': ['md_cg.chain:_expand_legacy'], 'old': 'include_hierarchy=include_hierarchy, allowed_ids=allowed_ids):', 'new': 'include_hierarchy=include_hierarchy, allowed_ids=None):', 'test': 'Guards.test_nonmonotone_fallback_keeps_scope'}, {'name': 'C4 forget scope at production RRF call', 'module': 'md_cg.mdcos', 'symbol': 'MdCGOS._path_chain', 'targets': ['md_cg.mdcos:MdCGOS._path_chain'], 'old': 'max_depth=depth, decay=decay, allowed_ids=allowed_ids)', 'new': 'max_depth=depth, decay=decay, allowed_ids=None)', 'test': 'Guards.test_real_rrf_has_no_hidden_provenance'}]
225
+
226
+ if __name__ == "__main__":
227
+ raise SystemExit(run_guard(globals(), MUTATIONS))
@@ -0,0 +1,206 @@
1
+ # -*- coding: utf-8 -*-
2
+ r"""守卫 · #108 中文召回键的**预算分配**(长拼接查询下召回只覆盖开头)。
3
+
4
+ 病灶(HEAD,逐字内联为 _OLD 供对拍/变异):
5
+ md_cg/mdcg.py 的 cn_recall_grams 逐段 append gram,一旦 len(out) >= cap
6
+ 就**整函数返回** ⇒ 多段查询(题卡式「两段以换行拼接」)只有**开头段**进入
7
+ 召回键。实测 64 字 + 12 字两段查询:末段 gram 覆盖 0.000(cap=16/32)、
8
+ 0.159(cap=64)。
9
+
10
+ 判据:
11
+ A 单段查询逐位不变(与旧实现逐字对拍)
12
+ B 多段且 gram 总数 <= cap ⇒ 逐位同旧(预算够时零差异)
13
+ C 预算不足 ⇒ **末段覆盖率 >= 0.5**(旧为 0.000),且首段仍被覆盖 ← 本笔主判据
14
+ D cap=None = 「不限」:返回全部 gram(覆盖 1.000)且 > 默认 cap ← 新增能力
15
+ E cap=0 **不是**「不限」:与旧实现同为「首个 gram」1 个(钉住误用)
16
+ F 去重/停用词/段序语义不变(不限时与旧实现逐位相同)
17
+ G MDCG_CN_GRAMS=0 ⇒ 新旧同为 []
18
+ H 端到端(tempfile 沙箱):正文只含末段 gram 时,expand_query_terms 能给出
19
+ 命中该正文的 term(旧实现给不出)——即「候选资格」被恢复 ← 本笔主判据
20
+ 运行:
21
+ python -X utf8 -m md_cg.test_cn_recall_grams # 期望 0 退出
22
+ python -X utf8 -m md_cg.test_cn_recall_grams --mutate=old # 期望 1 退出
23
+ 变异期望红 = {C, H}(主判据)+ {D, F}(旧实现无 cap=None 能力,属能力级红)
24
+ """
25
+ from __future__ import annotations
26
+
27
+ import os
28
+ import re
29
+ import shutil
30
+ import sys
31
+ import tempfile
32
+
33
+ REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
34
+ if REPO not in sys.path:
35
+ sys.path.insert(0, REPO)
36
+
37
+ from md_cg import mdcg # noqa: E402
38
+ from md_cg.mdcos import MdCGOS # noqa: E402
39
+
40
+ PASS = FAIL = 0
41
+ FAILS = []
42
+ BIG = 10 ** 9 # 旧实现的「不限」等价写法(它不支持 cap=None)
43
+
44
+
45
+ def _OLD(query: str, min_run: int = 4, cap: int = 16) -> list:
46
+ """旧实现逐字内联(取自 HEAD:md_cg/mdcg.py 的 cn_recall_grams 函数体)。
47
+ 仅供「逐位对拍」与「--mutate=old 定点变异」用,**不参与生产路径**。"""
48
+ if os.environ.get("MDCG_CN_GRAMS") == "0":
49
+ return []
50
+ out = []
51
+ for run in re.findall(r"[\u4e00-\u9fff]{%d,}" % max(min_run, 2), query or ""):
52
+ for i in range(len(run) - 1):
53
+ g = run[i:i + 2]
54
+ if g in mdcg.CN_STOP_GRAMS or g in out:
55
+ continue
56
+ out.append(g)
57
+ if len(out) >= cap:
58
+ return out
59
+ return out
60
+
61
+
62
+ def call(fn, q, **kw):
63
+ """调用被测实现;不支持的能力(如旧实现的 cap=None)返回哨兵而非崩栈。"""
64
+ try:
65
+ return fn(q, **kw)
66
+ except TypeError as exc:
67
+ return "ERR:TypeError(%s)" % exc
68
+
69
+
70
+ def ok(cond, label, detail=""):
71
+ global PASS, FAIL
72
+ if cond:
73
+ PASS += 1
74
+ print("[PASS] %s%s" % (label, (" · " + detail) if detail else ""))
75
+ else:
76
+ FAIL += 1
77
+ FAILS.append(label)
78
+ print("[FAIL] %s · %s" % (label, detail))
79
+
80
+
81
+ def grams_all(q):
82
+ """全量 gram(同口径:>=4 连续中文串、2-gram、去重、剔停用词、段序)。"""
83
+ out = []
84
+ for run in re.findall(r"[\u4e00-\u9fff]{4,}", q or ""):
85
+ for i in range(len(run) - 1):
86
+ g = run[i:i + 2]
87
+ if g not in mdcg.CN_STOP_GRAMS and g not in out:
88
+ out.append(g)
89
+ return out
90
+
91
+
92
+ def _terms_with_old_grams(q):
93
+ """旧实现下的 expand_query_terms 等值替身(只替换 gram 来源,其余同生产)。"""
94
+ saved = mdcg.cn_recall_grams
95
+ mdcg.cn_recall_grams = _OLD
96
+ try:
97
+ return mdcg.expand_query_terms(q)
98
+ finally:
99
+ mdcg.cn_recall_grams = saved
100
+
101
+
102
+ EX1 = "甲乙丙丁戊己庚辛壬癸子丑寅卯辰巳午未申酉戌亥"
103
+ TOPIC = ["数据同步", "检索过滤", "缓存分层", "索引快照", "并发写入", "容量上限",
104
+ "路径解析", "会话归属", "召回扩展", "截断窗口", "治理积压", "提案裁决",
105
+ "密级过滤", "来源标注", "批量处置", "演练预览", "留痕审计", "阈值告警"]
106
+ SEG_A = "".join(TOPIC[(3 * k) % len(TOPIC)] for k in range(16)) # 64 字
107
+ SEG_B = (EX1 * 5)[0:12] # 12 字
108
+ LONG_Q = SEG_A + "\n" + SEG_B
109
+ SHORT_QS = ["酪氨酸激酶抑制剂", "抑制剂怎么选", "中文召回扩展的预算分配",
110
+ "缓存分层与索引快照", "检索过滤", "数据同步检索过滤缓存分层",
111
+ "灵枢 hotcache 设计说明", "长查询拼接预算"]
112
+ SMALL_MULTI = ["数据同步\n检索过滤", "缓存分层索引快照\n并发写入容量上限",
113
+ "召回扩展\n截断窗口治理积压", "路径解析会话归属\n密级过滤来源标注"]
114
+
115
+
116
+ def main(argv=None):
117
+ argv = list(sys.argv[1:] if argv is None else argv)
118
+ mutate = None
119
+ for a in argv:
120
+ if a.startswith("--mutate="):
121
+ mutate = a.split("=", 1)[1]
122
+ func = mdcg.cn_recall_grams
123
+ if mutate == "old": # 定点变异:换回修复前实现(逐字内联版)
124
+ func = _OLD
125
+ mdcg.cn_recall_grams = _OLD
126
+ print("被验实现 = %r | mutate=%s" % (getattr(func, "__name__", "?"), mutate))
127
+ print("LONG_Q: 首段 %d 字 + 末段 %d 字(共 %d 字)"
128
+ % (len(SEG_A), len(SEG_B), len(LONG_Q)))
129
+
130
+ # ---- A 单段逐位不变 ----
131
+ bad = [q for q in SHORT_QS if call(func, q) != _OLD(q)]
132
+ ok(not bad, "A 单段查询逐位不变(%d 例对拍)" % len(SHORT_QS),
133
+ "差异例 = %r" % bad[:2])
134
+
135
+ # ---- B 多段、总数 <= cap ⇒ 逐位同旧 ----
136
+ small = [q for q in SMALL_MULTI if len(grams_all(q)) <= 16]
137
+ bad = [q for q in small if call(func, q) != _OLD(q)]
138
+ ok(bool(small) and not bad, "B 多段且总数<=cap 逐位同旧(%d 例)" % len(small),
139
+ "差异例 = %r" % bad[:2])
140
+
141
+ # ---- C 预算不足 ⇒ 末段覆盖(主判据) ----
142
+ gB = {SEG_B[i:i + 2] for i in range(len(SEG_B) - 1)}
143
+ gA = set(grams_all(SEG_A))
144
+ full = grams_all(LONG_Q)
145
+ keys = call(func, LONG_Q)
146
+ ks = set(keys) if isinstance(keys, list) else set()
147
+ covB = len(ks & gB) / max(1, len(gB))
148
+ covA = len(ks & gA) / max(1, len(gA))
149
+ ok(covB >= 0.5, "C 预算不足时末段覆盖 >=0.5",
150
+ "末段覆盖=%.3f(键 %d 个:首段命中 %d / 末段命中 %d)"
151
+ % (covB, len(keys) if isinstance(keys, list) else -1,
152
+ len(ks & gA), len(ks & gB)))
153
+ ok(covA > 0, "C2 首段仍被覆盖(轮转不牺牲开头)", "首段覆盖=%.3f" % covA)
154
+ ok(isinstance(keys, list) and len(keys) <= 16, "C3 键数不超预算",
155
+ "len=%s" % (len(keys) if isinstance(keys, list) else keys))
156
+
157
+ # ---- D cap=None = 不限 ----
158
+ un = call(func, LONG_Q, cap=None)
159
+ ok(isinstance(un, list) and len(un) == len(full) and len(un) > 16,
160
+ "D cap=None = 不限(返回全部 gram)",
161
+ "len=%s / full=%d" % (len(un) if isinstance(un, list) else un, len(full)))
162
+
163
+ # ---- E cap=0 不是「不限」 ----
164
+ z0 = call(func, LONG_Q, cap=0)
165
+ ok(isinstance(z0, list) and len(z0) == 1 and z0 == _OLD(LONG_Q, cap=0)
166
+ and len(z0) != len(full),
167
+ "E cap=0 = 首个 gram(**不是**不限;与旧实现逐位同)",
168
+ "cap=0 -> %r(旧 -> %r,不限 -> %d 个)" % (z0, _OLD(LONG_Q, cap=0), len(full)))
169
+
170
+ # ---- F 去重/段序/停用词语义(不限时逐位同旧) ----
171
+ rep = "数据同步数据同步\n检索过滤检索过滤的了一个"
172
+ a_rep, b_rep = call(func, rep, cap=None), _OLD(rep, cap=BIG)
173
+ ok(a_rep == b_rep, "F 不限时去重·停用词·段序与旧实现逐位相同",
174
+ "%r" % (a_rep if not isinstance(a_rep, list) else a_rep[:6],))
175
+
176
+ # ---- G 开关 ----
177
+ os.environ["MDCG_CN_GRAMS"] = "0"
178
+ a0, b0 = call(func, LONG_Q), _OLD(LONG_Q)
179
+ os.environ.pop("MDCG_CN_GRAMS", None)
180
+ ok(a0 == [] and b0 == [], "G MDCG_CN_GRAMS=0 ⇒ 新旧同为 []", "%r/%r" % (a0, b0))
181
+
182
+ # ---- H 端到端:候选资格(主判据) ----
183
+ sand = tempfile.mkdtemp(prefix="cn_grams_guard_")
184
+ try:
185
+ cg = MdCGOS(sand)
186
+ body = "\n".join(SEG_B[2 * i:2 * i + 2] for i in range(6))
187
+ cg.add("tgt", body, layer="knowledge")
188
+ bl = body.lower()
189
+ terms = mdcg.expand_query_terms(LONG_Q)
190
+ hit_terms = [t for t in terms if t in bl]
191
+ old_hits = [t for t in _terms_with_old_grams(LONG_Q) if t in bl]
192
+ ok(bool(hit_terms), "H 候选资格恢复:expand_query_terms 给出命中正文的 term",
193
+ "命中 %d 个(例:%r)|旧实现命中数=%d"
194
+ % (len(hit_terms), [t[:8] for t in hit_terms[:3]], len(old_hits)))
195
+ cg.close()
196
+ finally:
197
+ shutil.rmtree(sand, ignore_errors=True)
198
+
199
+ print("\ncn_recall_grams: %d pass / %d fail" % (PASS, FAIL))
200
+ for f in FAILS:
201
+ print(" - 红:%s" % f)
202
+ return 1 if FAIL else 0
203
+
204
+
205
+ if __name__ == "__main__":
206
+ sys.exit(main())
@@ -0,0 +1,101 @@
1
+ # -*- coding: utf-8 -*-
2
+ """code 类型不得绕过 forbidden 禁表(2026-10-19 外部实测,dsh-bounty #1103)。
3
+
4
+ 运行:python -X utf8 -m md_cg.test_code_kind_forbidden
5
+
6
+ 病态(修前实测):
7
+ `_rule_check` 的契约写着「forbidden 是内容政策,对所有 content_kind 恒生效」,
8
+ `data/policy.json` 的 `_note` 也这么写;但全仓只有 `_verify_text` /
9
+ `_verify_work_wip` 两个验证器调用它,`_verify_code` 只做 `ast.parse`。
10
+ 于是「代码里夹带凭据」判 ACCEPT 并明文落盘(`knowledge/orphan/*.md`),
11
+ 且无令牌 guest 经 `cg(op=read)` 可读回。README 恰恰推荐用 code 立刻落盘。
12
+
13
+ 本守卫钉住四件事(缺一即红):
14
+ K1 行为面:code 正文含 sk-/AKIA/PEM 三种禁表形态 ⇒ 必须 REJECT(修前三条全 ACCEPT)
15
+ K2 不误伤:干净代码 ⇒ 必须 ACCEPT(防「一律拒绝」式假修复)
16
+ K3 不回退:空内容/语法错误仍 REJECT,且语法错误优先报语法(不比修前更差)
17
+ K4 静态面:`_verify_code` 分支体内**确实调用** `_rule_check`(防被改回只做 AST)
18
+
19
+ 判别力自证:删掉 K4 所指的那次调用,K1 必红、K4 必红(见 --mutate)。
20
+ 哑值 `sk-live-FAKE...` / `AKIA...` / PEM 均为**合成串**,非真凭据。
21
+ """
22
+ from __future__ import annotations
23
+
24
+ import inspect
25
+ import json
26
+ import re
27
+ import sys
28
+
29
+ from . import audit
30
+
31
+ _ok = 0
32
+ _bad = []
33
+
34
+ FAKE = "sk-live-FAKE0123456789abcdef0123"
35
+ DIRTY_SK = "TOKEN = '%s'\ndef get():\n return TOKEN\n" % FAKE
36
+ DIRTY_AKIA = "AWS = 'AKIAABCDEFGHIJKLMNOP'\n"
37
+ DIRTY_PEM = ("K = '''-----BEGIN RSA" + " PRIVATE KEY-----\n"
38
+ "MIIEowIBAAKCAQEA1234567890abcdef\n"
39
+ "-----END RSA PRIVATE KEY-----'''\n")
40
+ CLEAN = "def add(a, b):\n return a + b\n"
41
+
42
+
43
+ def ok(name, cond, detail=""):
44
+ global _ok
45
+ if cond:
46
+ _ok += 1
47
+ print(" ok %s" % name)
48
+ else:
49
+ _bad.append("%s %s" % (name, detail))
50
+ print(" FAIL %s %s" % (name, detail))
51
+
52
+
53
+ def state_of(kind, content):
54
+ rules = audit.load_rulebook()
55
+ v = audit.audit(kind, {"content": content}, {"rules": rules})
56
+ return v.get("state"), str(v.get("evidence") or "")
57
+
58
+
59
+ def main():
60
+ print("== K1 行为面:code 正文命中禁表必须 REJECT ==")
61
+ for label, body in (("sk-", DIRTY_SK), ("AKIA", DIRTY_AKIA), ("PEM", DIRTY_PEM)):
62
+ st, ev = state_of("code", body)
63
+ ok("K1 %s 形态判 REJECT" % label, st == audit.REJECT,
64
+ "实得 state=%s evidence=%s" % (st, ev[:80]))
65
+
66
+ print("== K2 不误伤:干净代码仍 ACCEPT ==")
67
+ st, ev = state_of("code", CLEAN)
68
+ ok("K2 干净代码 ACCEPT", st == audit.ACCEPT,
69
+ "实得 state=%s evidence=%s" % (st, ev[:80]))
70
+
71
+ print("== K3 不回退:原有拒绝理由不被削弱 ==")
72
+ st, ev = state_of("code", "")
73
+ ok("K3a 空内容仍 REJECT", st == audit.REJECT, "实得 %s" % st)
74
+ st, ev = state_of("code", "def f(:\n")
75
+ ok("K3b 语法错误仍 REJECT 且证据含「语法」",
76
+ st == audit.REJECT and "语法" in ev, "实得 state=%s ev=%s" % (st, ev[:60]))
77
+
78
+ print("== K4 静态面:_verify_code 确实调用 _rule_check ==")
79
+ src = inspect.getsource(audit._verify_code)
80
+ ok("K4 _verify_code 分支体内出现 _rule_check 调用",
81
+ bool(re.search(r"_rule_check\(", src)),
82
+ "分支体内未找到 _rule_check( —— 只做 AST 即本缺陷原形")
83
+
84
+ print("== 对照腿:text/work_wip 未被本次改动影响 ==")
85
+ st, _ = state_of("text", "值班记录:令牌 %s。" % FAKE)
86
+ ok("K5 text 仍 REJECT", st == audit.REJECT, "实得 %s" % st)
87
+ st, _ = state_of("work_wip", "值班记录:令牌 %s。" % FAKE)
88
+ ok("K6 work_wip 仍 REJECT", st == audit.REJECT, "实得 %s" % st)
89
+
90
+ print("")
91
+ if _bad:
92
+ print("code 禁表守卫:%d 通过,%d 失败" % (_ok, len(_bad)))
93
+ for b in _bad:
94
+ print(" 红:%s" % b)
95
+ return 1
96
+ print("code 禁表守卫:%d 通过,0 失败" % _ok)
97
+ return 0
98
+
99
+
100
+ if __name__ == "__main__":
101
+ sys.exit(main())
@@ -0,0 +1,127 @@
1
+ # -*- coding: utf-8 -*-
2
+ r"""守卫 · #72 coldverify 的受控消费与预演(2026-10-09 DSH 端实施)。
3
+
4
+ zcode 端 2026-10-09 批准 #72 稿:显式 drain(不常驻线程)+ dry-run 预演 +
5
+ status 增积压龄;**保留 opt-in 语义**(不动「默认不启线程」)。
6
+
7
+ 判据(真跑真库):
8
+ G1 受控消费:入队 N 条 → drain(limit=N) ⇒ 队列减少 N、processed 增加 N
9
+ G2 预演不消费:drain(dry_run=True) 前后 _coldverify.jsonl **逐字节不变**、processed 不增
10
+ G3 预演非空转:dry_run 返回的 would_process **非空且与队首 N 条一致**
11
+ G4 opt-in 未破(回归):未调 start_worker() ⇒ status()['worker_alive'] is False
12
+ G5 积压龄可读:status()['oldest_age_s'] 与队首条目的 enqueued_at 一致(±2s 容差)
13
+ 运行:python -X utf8 -m md_cg.test_coldverify_drain
14
+ 退出码:0 全绿 | 1 断言失败
15
+ """
16
+ from __future__ import annotations
17
+
18
+ import json
19
+ import os
20
+ import re
21
+ import sys
22
+ import tempfile
23
+ import time
24
+
25
+ HERE = os.path.dirname(os.path.abspath(__file__))
26
+ REPO = os.path.dirname(HERE)
27
+ if REPO not in sys.path:
28
+ sys.path.insert(0, REPO)
29
+
30
+ PASS = 0
31
+ FAIL = 0
32
+ FAILS = []
33
+
34
+
35
+ def check(name, cond, detail=""):
36
+ global PASS, FAIL
37
+ if cond:
38
+ PASS += 1
39
+ print("[PASS] %s%s" % (name, (" · " + detail) if detail else ""))
40
+ else:
41
+ FAIL += 1
42
+ FAILS.append(name)
43
+ print("[FAIL] %s · %s" % (name, detail))
44
+
45
+
46
+ def _cg(root):
47
+ """真 cg 实例:drain 的 _process 需要它做 reverify(传 None 会走 errors 分支)。"""
48
+ from md_cg import tokens as TK
49
+ from md_cg.mdcos import MdCGSecure
50
+ prof = os.environ.get("MDCG_DSH_PROFILE") or ""
51
+ tok = None
52
+ if prof:
53
+ try:
54
+ m = re.search("MDCG_TOKEN:[ ]*'([^']+)'",
55
+ open(prof, encoding="utf-8", errors="replace").read())
56
+ tok = m.group(1) if m else None
57
+ except OSError:
58
+ tok = None
59
+ return MdCGSecure(root, principal=TK.verify_token(tok) if tok else None)
60
+
61
+
62
+ def main():
63
+ from md_cg import coldverify
64
+ root = tempfile.mkdtemp(prefix="p72_")
65
+ q = coldverify.ColdVerifyQueue(root=root)
66
+ cg = _cg(root)
67
+
68
+ # G4:opt-in 未被破坏(未启线程)
69
+ st0 = q.status()
70
+ check("G4 未调 start_worker() ⇒ worker_alive is False(opt-in 未被破坏)",
71
+ st0.get("worker_alive") is False, "worker_alive=%r" % (st0.get("worker_alive"),))
72
+
73
+ # 入队 3 条
74
+ for i in range(3):
75
+ q.enqueue("n%d" % i, "reverify")
76
+ qf = q._queue_path
77
+ raw_before = open(qf, "rb").read() if os.path.exists(qf) else b""
78
+ proc_before = q.status()["stats"]["processed"]
79
+
80
+ # G2/G3:dry-run
81
+ dv = q.drain(cg, limit=3, dry_run=True)
82
+ raw_after = open(qf, "rb").read() if os.path.exists(qf) else b""
83
+ proc_after = q.status()["stats"]["processed"]
84
+ if isinstance(dv, dict):
85
+ check("G2 预演不消费:队列文件逐字节不变且 processed 不增",
86
+ (raw_before == raw_after) and (proc_before == proc_after),
87
+ "file_same=%r proc %r->%r" % (raw_before == raw_after, proc_before, proc_after))
88
+ # 类型防御:若 dry_run 失效,drain 返回的是**正常消费的 list**(而非预演 dict)
89
+ # —— 此时必须由 G2/G3 **干净点名**,而不是让守卫自己 AttributeError 崩掉。
90
+ # (本条由变异①发现:首版守卫在变异下抛 AttributeError,虽 rc=1 但不是"点名"。)
91
+ if not isinstance(dv, dict):
92
+ check("G2 预演不消费:返回体须为预演 dict(非 list)", False,
93
+ "实得 %s ⇒ dry_run 失效" % type(dv).__name__)
94
+ check("G3 预演非空转:would_process 与队首 3 条一致", False, "预演体缺失")
95
+ else:
96
+ wp = dv.get("would_process") or []
97
+ check("G3 预演非空转:would_process 与队首 3 条一致",
98
+ len(wp) == 3 and [x.get("node_id") for x in wp] == ["n0", "n1", "n2"],
99
+ "n=%d ids=%r" % (len(wp), [x.get("node_id") for x in wp]))
100
+
101
+ # G5:积压龄
102
+ st = q.status()
103
+ age = st.get("oldest_age_s")
104
+ first_ts = q._queue[0].get("enqueued_at") if q._queue else None
105
+ exp = round(time.time() - float(first_ts or 0), 1) if first_ts else None
106
+ check("G5 status 含 oldest_age_s 且与队首条目一致(±2s)",
107
+ age is not None and exp is not None and abs(age - exp) <= 2.0,
108
+ "age=%r exp=%r" % (age, exp))
109
+
110
+ # G1:真消费
111
+ res = q.drain(cg, limit=3)
112
+ st2 = q.status()
113
+ check("G1 受控消费:drain(limit=3) 后队列清空、processed 增 3",
114
+ st2["queue_size"] == 0 and st2["stats"]["processed"] == proc_after + 3,
115
+ "size=%r processed=%r" % (st2["queue_size"], st2["stats"]["processed"]))
116
+
117
+ print("")
118
+ print("=" * 64)
119
+ print("通过 %d / 失败 %d" % (PASS, FAIL))
120
+ if FAILS:
121
+ print("失败项:" + ",".join(FAILS))
122
+ print("=" * 64)
123
+ return 1 if FAIL else 0
124
+
125
+
126
+ if __name__ == "__main__":
127
+ sys.exit(main())