@furongjun1999/dsh-memory 0.8.0 → 0.9.6

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 (714) hide show
  1. package/README.md +662 -632
  2. package/codebuddy/README.md +1 -1
  3. package/data/policy.json +17 -6
  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 +1 -1
  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 +18 -3
  18. package/lib/hooks.js +147 -18
  19. package/lib/index.d.ts +2 -2
  20. package/lib/index.js +18 -4
  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 +13 -1
  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 +16 -1
  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 +8 -2
  34. package/lib/tools.js +22 -3
  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 +22 -5
  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 +572 -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 +21 -0
  71. package/md_cg/conformance_core.py +753 -0
  72. package/md_cg/consistency.py +1278 -955
  73. package/md_cg/consolidate.py +180 -20
  74. package/md_cg/crypto.py +794 -472
  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 +14 -3
  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 +86 -5
  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 +7104 -5417
  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 +4 -1
  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 +188 -28
  108. package/md_cg/protocol.py +492 -411
  109. package/md_cg/provenance.py +7 -1
  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 +12 -3
  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 +256 -19
  123. package/md_cg/rollback_cli.py +21 -1
  124. package/md_cg/rotate.py +347 -0
  125. package/md_cg/routing.py +62 -1
  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 +1 -1
  133. package/md_cg/semantic/export_en_zh_map.py +2 -2
  134. package/md_cg/semantic/zh_en_atoms.py +2 -0
  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 +273 -15
  139. package/md_cg/state_events.py +75 -10
  140. package/md_cg/state_slots.py +312 -221
  141. package/md_cg/stg.py +82 -16
  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 +43 -3
  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_coldverify_drain.py +127 -0
  172. package/md_cg/test_condaccept.py +156 -0
  173. package/md_cg/test_condgate.py +141 -0
  174. package/md_cg/test_config_registry.py +55 -0
  175. package/md_cg/test_crypto_rotate.py +257 -0
  176. package/md_cg/test_csre_correctness.py +297 -0
  177. package/md_cg/test_csre_index_import_guard.py +161 -0
  178. package/md_cg/test_csre_mutations.py +34 -0
  179. package/md_cg/test_csre_session.py +69 -0
  180. package/md_cg/test_curiosity_budget.py +468 -0
  181. package/md_cg/test_d17_autostart_toolface.py +453 -0
  182. package/md_cg/test_datapath_tilde_home.py +271 -0
  183. package/md_cg/test_derived_cache_generations.py +256 -0
  184. package/md_cg/test_evidence_delivery_compact.py +54 -0
  185. package/md_cg/test_exact_text_cache.py +191 -0
  186. package/md_cg/test_excerpt_budget.py +188 -0
  187. package/md_cg/test_experience_consolidation.py +112 -0
  188. package/md_cg/test_export_default_collision.py +138 -0
  189. package/md_cg/test_export_snapshots.py +322 -0
  190. package/md_cg/test_fuzzy_substring_equivalence.py +127 -0
  191. package/md_cg/test_gain_gate.py +16 -5
  192. package/md_cg/test_goal_gen.py +355 -0
  193. package/md_cg/test_h2_session_view_norm.py +251 -233
  194. package/md_cg/test_h4_sustain_snapshot.py +1490 -1387
  195. package/md_cg/test_heartbeat_ledger.py +557 -0
  196. package/md_cg/test_hierarchy_audit_graph.py +237 -0
  197. package/md_cg/test_i50c_meta_passthrough.py +628 -608
  198. package/md_cg/test_i50e_readside_protection.py +6 -4
  199. package/md_cg/test_identity_attribution.py +96 -2
  200. package/md_cg/test_identity_contract.py +329 -0
  201. package/md_cg/test_imgskill.py +1444 -0
  202. package/md_cg/test_index_snapshot_shape.py +240 -0
  203. package/md_cg/test_interop_judgment.py +258 -228
  204. package/md_cg/test_issue111_gate_order.py +77 -0
  205. package/md_cg/test_issue111_scoring_contract.py +87 -0
  206. package/md_cg/test_issue121_calibration_bounds.py +293 -0
  207. package/md_cg/test_issue128_session_env_authority.py +246 -0
  208. package/md_cg/test_issue130_rrf_rank_credibility.py +217 -0
  209. package/md_cg/test_issue131_postings_content_staleness.py +424 -0
  210. package/md_cg/test_issue145_sleep_no_silent_rollback.py +168 -0
  211. package/md_cg/test_issue146_frontmatter_quarantine.py +428 -0
  212. package/md_cg/test_issue147_pack_id_escape.py +378 -0
  213. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -0
  214. package/md_cg/test_issue149_accel_default_face.py +249 -0
  215. package/md_cg/test_issue150_empty_query_terms.py +328 -0
  216. package/md_cg/test_issue151_153_157_write_cache_index.py +152 -0
  217. package/md_cg/test_issue151b_base_add_importance_guard.py +166 -0
  218. package/md_cg/test_issue152_sealed_postings.py +309 -0
  219. package/md_cg/test_issue152b_decrypt_cache.py +218 -0
  220. package/md_cg/test_issue153b_cache_alias_and_canon.py +236 -0
  221. package/md_cg/test_issue153b_index_generation_invalidation.py +143 -0
  222. package/md_cg/test_issue157b_index_remainder.py +344 -0
  223. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -0
  224. package/md_cg/test_issue190_tidy_idempotent.py +806 -0
  225. package/md_cg/test_issue191_import_trust.py +382 -0
  226. package/md_cg/test_issue192_move_layer_indices_guard.py +258 -0
  227. package/md_cg/test_issue193_consistency_knowledge_guard.py +524 -0
  228. package/md_cg/test_issue193_write_scope.py +378 -0
  229. package/md_cg/test_issue197_rank_credibility_property.py +201 -0
  230. package/md_cg/test_issue211_export_target.py +325 -0
  231. package/md_cg/test_issue212_writeface_gaps.py +349 -0
  232. package/md_cg/test_issue214_reject_sensitivity.py +267 -0
  233. package/md_cg/test_issue215_condition_source_gap.py +272 -0
  234. package/md_cg/test_issue216_clash_routes.py +214 -0
  235. package/md_cg/test_issue217_slot_routes.py +248 -0
  236. package/md_cg/test_issue218_postcondition_value_blind.py +222 -0
  237. package/md_cg/test_issue225_consistency_torn_log.py +433 -0
  238. package/md_cg/test_issue245_swarm_traversal.py +366 -0
  239. package/md_cg/test_issue258_pack_sensitivity.py +468 -0
  240. package/md_cg/test_issue265_coldverify_multiproc.py +438 -0
  241. package/md_cg/test_issue274_read_node_id_none.py +341 -0
  242. package/md_cg/test_issue275_layer_param.py +250 -0
  243. package/md_cg/test_issue277_node_id_traversal.py +384 -0
  244. package/md_cg/test_issue278_neg_separated_tension.py +271 -0
  245. package/md_cg/test_issue278_neg_window.py +294 -0
  246. package/md_cg/test_issue278_negative_layering.py +83 -0
  247. package/md_cg/test_issue279_signers_path_guard.py +652 -0
  248. package/md_cg/test_issue284_skip_not_pass.py +291 -0
  249. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -0
  250. package/md_cg/test_issue295_sleep_root_binding.py +589 -0
  251. package/md_cg/test_issue297_rewrite_sensitivity.py +454 -0
  252. package/md_cg/test_issue298_consistency_ledger_sensitivity.py +421 -0
  253. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -0
  254. package/md_cg/test_issue303_design_boundaries.py +262 -0
  255. package/md_cg/test_issue313_writelimit_sensitivity.py +404 -0
  256. package/md_cg/test_issue315_merge_branch_sensitivity.py +384 -0
  257. package/md_cg/test_issue315_sensitivity_passthrough_guard.py +514 -0
  258. package/md_cg/test_issue319_tenant_unregistered_bypass.py +257 -0
  259. package/md_cg/test_issue320_vstate_requires_verify.py +279 -0
  260. package/md_cg/test_issue321_mcp_deep_json.py +305 -0
  261. package/md_cg/test_issue322_node_write_lock.py +727 -0
  262. package/md_cg/test_issue323_aggregate_segment_boundary.py +365 -0
  263. package/md_cg/test_issue324_write_size_fields.py +215 -0
  264. package/md_cg/test_issue325_audit_poison.py +230 -0
  265. package/md_cg/test_issue326_append_jsonl_oserror.py +464 -0
  266. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -0
  267. package/md_cg/test_issue326_key_perms.py +355 -0
  268. package/md_cg/test_issue326_twin_parser_parity.py +323 -0
  269. package/md_cg/test_issue326_vm_call_frame.py +569 -0
  270. package/md_cg/test_issue345_writelimit_effective_sens.py +234 -0
  271. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -0
  272. package/md_cg/test_issue346_review_overwrite_guard.py +509 -0
  273. package/md_cg/test_issue348_insight_verify_op.py +200 -0
  274. package/md_cg/test_issue348_merge_rmw_lock.py +345 -0
  275. package/md_cg/test_issue350_casefold_collision.py +236 -0
  276. package/md_cg/test_issue351_ingest_root_fallback.py +202 -0
  277. package/md_cg/test_issue352_imgaudit.py +418 -0
  278. package/md_cg/test_issue352_pathsjson.py +537 -0
  279. package/md_cg/test_issue352_refindex.py +412 -0
  280. package/md_cg/test_issue352_rollback.py +604 -0
  281. package/md_cg/test_issue352_vstateinherit.py +196 -0
  282. package/md_cg/test_issue354_p1_writelimit_type.py +522 -0
  283. package/md_cg/test_issue354_p2_datapath_clock.py +381 -0
  284. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -0
  285. package/md_cg/test_issue354_rust_index_containment.py +571 -0
  286. package/md_cg/test_issue354_rust_wal_containment.py +606 -0
  287. package/md_cg/test_issue358_truncation_observable.py +247 -0
  288. package/md_cg/test_issue360_tidy_private_excerpt.py +196 -0
  289. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -0
  290. package/md_cg/test_issue362_neg_condition.py +468 -0
  291. package/md_cg/test_issue363_lexical_idf.py +275 -0
  292. package/md_cg/test_issue370_readcache_assembly.py +488 -0
  293. package/md_cg/test_issue375_state_slot_retire.py +325 -0
  294. package/md_cg/test_issue376_heartbeat_failed.py +293 -0
  295. package/md_cg/test_issue377_layer_protect_stamp.py +324 -0
  296. package/md_cg/test_issue378_protected_floor.py +310 -0
  297. package/md_cg/test_issue383_state_event_write_gate.py +462 -0
  298. package/md_cg/test_issue397_sens_eff_wiring.py +435 -0
  299. package/md_cg/test_issue398_toolface_op_parity.py +511 -0
  300. package/md_cg/test_issue399_hive_json_shape.py +317 -0
  301. package/md_cg/test_issue400_hive_dirty_args.py +450 -0
  302. package/md_cg/test_issue401_wisdom_codegen.py +295 -0
  303. package/md_cg/test_issue404_heal_receipt.py +390 -0
  304. package/md_cg/test_issue405_git_pathspec.py +333 -0
  305. package/md_cg/test_issue408_eface_registry.py +291 -0
  306. package/md_cg/test_issue409_compact_index_completeness.py +509 -0
  307. package/md_cg/test_issue410_verify_demote_write.py +366 -0
  308. package/md_cg/test_issue411_scrub_idempotence.py +575 -0
  309. package/md_cg/test_issue412_discipline_producer_parity.py +312 -0
  310. package/md_cg/test_issue413_preimage_failclosed.py +239 -0
  311. package/md_cg/test_issue413_preimage_twin.py +340 -0
  312. package/md_cg/test_issue414_write_args_parity.py +613 -0
  313. package/md_cg/test_issue415_deps_gate_probe.py +358 -0
  314. package/md_cg/test_issue416_entry_key_subset.py +525 -0
  315. package/md_cg/test_issue417_twophase_merge_landed.py +423 -0
  316. package/md_cg/test_issue418_identity_role_type_gate.py +188 -0
  317. package/md_cg/test_issue418_role_type_gate.py +265 -0
  318. package/md_cg/test_issue419_pii_redaction.py +642 -0
  319. package/md_cg/test_issue424_merge_confirm_sensitivity.py +381 -0
  320. package/md_cg/test_issue425_ingest_library_path.py +331 -0
  321. package/md_cg/test_issue426a_dedup_receipt.py +242 -0
  322. package/md_cg/test_issue426b_root_clash_invisible.py +270 -0
  323. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -0
  324. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -0
  325. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -0
  326. package/md_cg/test_issue427_serve_status_shape.py +191 -0
  327. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -0
  328. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -0
  329. package/md_cg/test_issue434_435_float_gate.py +90 -0
  330. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -0
  331. package/md_cg/test_issue43_default_policy.py +13 -4
  332. package/md_cg/test_issue443a_state_event_length_gate.py +94 -0
  333. package/md_cg/test_issue443b_audit_record_length_gate.py +83 -0
  334. package/md_cg/test_issue443c_self_state_imgskill_length_gate.py +77 -0
  335. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -0
  336. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -0
  337. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -0
  338. package/md_cg/test_issue446_is_encrypted_envelope.py +166 -0
  339. package/md_cg/test_issue447_recent_sens_failclosed.py +270 -0
  340. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -0
  341. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -0
  342. package/md_cg/test_issue451_audit_actor.py +313 -0
  343. package/md_cg/test_issue452_ingest_root_hint.py +238 -0
  344. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -0
  345. package/md_cg/test_issue463_ghost_prune_guard.py +259 -0
  346. package/md_cg/test_issue466_basis_registry.py +469 -0
  347. package/md_cg/test_issue467_identity_sensitivity.py +204 -0
  348. package/md_cg/test_issue467_identity_sensitivity_parity.py +361 -0
  349. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -0
  350. package/md_cg/test_issue470_wal_event_durable.py +427 -0
  351. package/md_cg/test_issue471_identity_readable.py +137 -0
  352. package/md_cg/test_issue472_audit_chain.py +91 -0
  353. package/md_cg/test_issue472_prune_ledger.py +106 -0
  354. package/md_cg/test_issue472_rollback_degraded.py +82 -0
  355. package/md_cg/test_issue491_compose_sandbox.py +460 -0
  356. package/md_cg/test_issue492_dup_readout_opt_in.py +292 -0
  357. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -0
  358. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -0
  359. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -0
  360. package/md_cg/test_issue522_review_record_sensitivity.py +267 -0
  361. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -0
  362. package/md_cg/test_issue525_read_null_semantics.py +52 -0
  363. package/md_cg/test_issue538_hook_condition_space.py +97 -0
  364. package/md_cg/test_issue540_path_guard_whitespace.py +126 -0
  365. package/md_cg/test_issue541_tidy_protect_gate.py +141 -0
  366. package/md_cg/test_issue542_tenant_root_same.py +153 -0
  367. package/md_cg/test_issue543_issue_authorization.py +147 -0
  368. package/md_cg/test_issue544_sandbox_reflection_gate.py +175 -0
  369. package/md_cg/test_issue545_charset_vs_size_diagnostic.py +77 -0
  370. package/md_cg/test_issue546_ledger_concurrency.py +81 -0
  371. package/md_cg/test_issue547_append_jsonl_whitelist.py +115 -0
  372. package/md_cg/test_issue547_audit_durable.py +96 -0
  373. package/md_cg/test_issue549_durable_append.py +143 -0
  374. package/md_cg/test_issue557_r1_credential_value_forms.py +76 -0
  375. package/md_cg/test_issue557_r2_write_entries_size_gate.py +84 -0
  376. package/md_cg/test_issue557_r3_pem_block_redaction.py +75 -0
  377. package/md_cg/test_issue559_refine_prefix.py +70 -0
  378. package/md_cg/test_issue561_pending_review.py +109 -0
  379. package/md_cg/test_issue66_scrub_semantics.py +107 -0
  380. package/md_cg/test_issue67_scrub_control_pool.py +233 -0
  381. package/md_cg/test_issue69_audit_boundary.py +129 -0
  382. package/md_cg/test_issue71_queue_backlog.py +377 -0
  383. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -0
  384. package/md_cg/test_issue73_doc_chapter_refs.py +326 -0
  385. package/md_cg/test_issue75_neural_failure.py +582 -0
  386. package/md_cg/test_issue78_export_concurrency.py +334 -0
  387. package/md_cg/test_issue80_residual_flush.py +169 -0
  388. package/md_cg/test_issue82_credential_rules.py +271 -0
  389. package/md_cg/test_issue82_layer_and_size.py +120 -0
  390. package/md_cg/test_issue84_portability.py +95 -0
  391. package/md_cg/test_issue85_export_overwrite.py +113 -0
  392. package/md_cg/test_issue86_runtime_revoke.py +110 -0
  393. package/md_cg/test_issue87_default_sensitivity_single.py +201 -0
  394. package/md_cg/test_issue88_conclusion_face.py +280 -0
  395. package/md_cg/test_issue88_execution_conflicts.py +87 -0
  396. package/md_cg/test_issue89_zero_score.py +169 -0
  397. package/md_cg/test_issue89a_score_cap_tiebreak.py +279 -0
  398. package/md_cg/test_issue91_verifier_sandbox.py +314 -0
  399. package/md_cg/test_issue91_verifier_timeout.py +528 -0
  400. package/md_cg/test_issue93_remember_redaction.py +282 -0
  401. package/md_cg/test_issue96_key_fallback.py +102 -0
  402. package/md_cg/test_issue98_tenant_root.py +104 -0
  403. package/md_cg/test_jsonl_commit_watermark.py +221 -0
  404. package/md_cg/test_live_validity_cache.py +256 -0
  405. package/md_cg/test_logref.py +32 -0
  406. package/md_cg/test_mcp_call_argument_types.py +99 -0
  407. package/md_cg/test_md_access_parity.py +80 -5
  408. package/md_cg/test_md_cg_no_hive_dep.py +140 -0
  409. package/md_cg/test_memory_rsi.py +215 -0
  410. package/md_cg/test_memory_rsi_adversarial.py +91 -0
  411. package/md_cg/test_mode_parity.py +1413 -1393
  412. package/md_cg/test_mutation_residue.py +120 -0
  413. package/md_cg/test_mutation_rollback.py +62 -32
  414. package/md_cg/test_n123_derive_expiry_chain.py +10 -5
  415. package/md_cg/test_n130_verify_falsified_protect.py +185 -185
  416. package/md_cg/test_n209_verify_write_face_gates.py +7 -2
  417. package/md_cg/test_n230_dirty_replay.py +52 -9
  418. package/md_cg/test_n62_tenant_bind_failclosed.py +3 -3
  419. package/md_cg/test_neg_coverage_budget.py +500 -0
  420. package/md_cg/test_neg_tail_honesty.py +79 -9
  421. package/md_cg/test_p0.py +16 -2
  422. package/md_cg/test_p14_root_fallback.py +373 -0
  423. package/md_cg/test_p1x_ref_root.py +47 -10
  424. package/md_cg/test_p21_tokens.py +2 -1
  425. package/md_cg/test_p24_evidence.py +232 -227
  426. package/md_cg/test_p26_refindex.py +20 -3
  427. package/md_cg/test_p27_docindex.py +16 -1
  428. package/md_cg/test_p28_refcheck.py +45 -24
  429. package/md_cg/test_p29_session_ingest_export.py +6 -0
  430. package/md_cg/test_p2_mcp.py +474 -453
  431. package/md_cg/test_p2_six_elements.py +14 -1
  432. package/md_cg/test_p3.py +370 -261
  433. package/md_cg/test_p33_ccg_wiring.py +9 -2
  434. package/md_cg/test_p3_legacy_closure.py +6 -1
  435. package/md_cg/test_p40_refine_worklist.py +5 -2
  436. package/md_cg/test_p45_session_identity.py +250 -3
  437. package/md_cg/test_p47_session_view.py +25 -9
  438. package/md_cg/test_p4_freshness.py +8 -1
  439. package/md_cg/test_p83_jsonrpc_parse_error.py +124 -0
  440. package/md_cg/test_p9c_dedup_hints.py +7 -2
  441. package/md_cg/test_policy_required_ccg.py +12 -0
  442. package/md_cg/test_postings_digest_memo.py +139 -0
  443. package/md_cg/test_predict_beta.py +138 -135
  444. package/md_cg/test_qmd.py +500 -0
  445. package/md_cg/test_query_excerpt.py +209 -0
  446. package/md_cg/test_reach.py +456 -378
  447. package/md_cg/test_reach_snapshot_admission.py +218 -0
  448. package/md_cg/test_readcache_prodpath.py +4 -0
  449. package/md_cg/test_recall_face_guards.py +854 -812
  450. package/md_cg/test_recall_metadata.py +422 -0
  451. package/md_cg/test_retr_s5.py +104 -5
  452. package/md_cg/test_retr_score_once.py +14 -2
  453. package/md_cg/test_review_cli_attribution.py +11 -7
  454. package/md_cg/test_review_queue_batch.py +123 -0
  455. package/md_cg/test_review_queue_index.py +130 -0
  456. package/md_cg/test_rrf_candidates.py +292 -0
  457. package/md_cg/test_rrf_qualified_topk.py +214 -0
  458. package/md_cg/test_rrf_unique_votes.py +218 -0
  459. package/md_cg/test_s1_ast_judge.py +110 -0
  460. package/md_cg/test_scrub_ledger.py +413 -0
  461. package/md_cg/test_security_audit_b26.py +34 -3
  462. package/md_cg/test_security_audit_v21.py +1 -2
  463. package/md_cg/test_sensitivity_predicate_single_point.py +184 -0
  464. package/md_cg/test_session5_identity.py +93 -0
  465. package/md_cg/test_session_attribution_consistency.py +813 -0
  466. package/md_cg/test_session_identity_tristate.py +486 -0
  467. package/md_cg/test_sleep_p1.py +35 -3
  468. package/md_cg/test_state_event_op.py +8 -1
  469. package/md_cg/test_state_projection_streaming.py +136 -0
  470. package/md_cg/test_stg_interval_candidates.py +280 -0
  471. package/md_cg/test_stg_time_blocks.py +239 -0
  472. package/md_cg/test_stgidx_index_parity.py +16 -12
  473. package/md_cg/test_subgraph_bounded_bfs.py +227 -0
  474. package/md_cg/test_sustain_bounded.py +30 -2
  475. package/md_cg/test_task_memory.py +394 -0
  476. package/md_cg/test_text_projection_mutations.py +101 -0
  477. package/md_cg/test_time_anchor.py +421 -0
  478. package/md_cg/test_time_core_lint.py +1024 -975
  479. package/md_cg/test_tool_face.py +200 -189
  480. package/md_cg/test_trust_bounded_frontier.py +248 -0
  481. package/md_cg/test_trust_edge_reachability.py +405 -0
  482. package/md_cg/test_w5_path_fingerprint.py +381 -0
  483. package/md_cg/test_w7_redlines.py +659 -0
  484. package/md_cg/test_write_return_shape.py +919 -0
  485. package/md_cg/test_writepipe.py +5 -3
  486. package/md_cg/timeanchor.py +534 -0
  487. package/md_cg/tokens.py +68 -5
  488. package/md_cg/tool_face.py +273 -260
  489. package/md_cg/trust.py +110 -26
  490. package/md_cg/twophase.py +74 -2
  491. package/md_cg/weights.py +642 -638
  492. package/md_cg/whitebox.py +9 -0
  493. package/md_cg/whitebox_kb/aeis_core/core.py +5026 -5026
  494. package/md_cg/whitebox_kb/wisdom/chat_engine.py +1504 -1506
  495. package/md_cg/whitebox_kb/wisdom/code_compose.py +876 -837
  496. package/md_cg/whitebox_kb/wisdom/compiler_code_units.py +3040 -3033
  497. package/md_cg/whitebox_kb/wisdom/compose_engine.py +3 -2
  498. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +22 -2
  499. package/md_cg/whitebox_kb/wisdom/core/parser.py +17 -0
  500. package/md_cg/whitebox_kb/wisdom/csre.py +412 -264
  501. package/md_cg/whitebox_kb/wisdom/csre_session.py +97 -0
  502. package/md_cg/whitebox_kb/wisdom/md_access.py +23 -3
  503. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +21 -0
  504. package/md_cg/whitebox_kb/wisdom/mini_python.py +44 -7
  505. package/md_cg/whitebox_kb/wisdom/navigate.py +249 -248
  506. package/md_cg/whitebox_kb/wisdom/net_units.py +12 -7
  507. package/md_cg/whitebox_kb/wisdom/neural_retrieve.py +100 -10
  508. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +13 -7
  509. package/md_cg/whitebox_kb/wisdom/test_ecosystem_assembly.py +158 -158
  510. package/md_cg/whitebox_kb/wisdom/test_safe_module_proxy.py +147 -0
  511. package/md_cg/whitebox_kb/wisdom/verifier.py +1918 -1297
  512. package/md_cg/writelimit.py +584 -390
  513. package/md_cg/writepipe.py +587 -76
  514. package/package.json +13 -9
  515. package/skills/plugin.json +1 -1
  516. package/src/bridge.ts +34 -11
  517. package/src/cli.ts +75 -65
  518. package/src/hooks.ts +908 -776
  519. package/src/index.ts +19 -5
  520. package/src/init.ts +362 -361
  521. package/src/lib/datapath.ts +419 -326
  522. package/src/lib/hook_audit.ts +256 -243
  523. package/src/lib/mdcg_client.ts +10 -2
  524. package/src/lib/mutual.ts +481 -432
  525. package/src/lib/prompt_safety.ts +164 -149
  526. package/src/lib/roleplay_web.ts +30 -2
  527. package/src/lib/token_store.ts +274 -52
  528. package/src/tools.ts +249 -223
  529. package/zcode/README.md +1 -1
  530. 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
  531. 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
  532. 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
  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_v2.0.md +0 -239
  534. 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
  535. 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
  536. 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
  537. package/docs/eval/DSH/347/253/257/347/274/272/351/231/267/344/270/223/351/241/271_v1.0.md +0 -254
  538. 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
  539. 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
  540. package/docs/eval/bench_lingshu_self/bench_self.py +0 -140
  541. package/docs/eval/bench_lingshu_self/self_bench_result.json +0 -404
  542. 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
  543. 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
  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.1.md +0 -340
  545. 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
  546. 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
  547. 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
  548. 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
  549. 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
  550. 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
  551. 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
  552. 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
  553. 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
  554. 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
  555. 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
  556. 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
  557. 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
  558. 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
  559. 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
  560. 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
  561. 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
  562. 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
  563. 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
  564. 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
  565. 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
  566. 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
  567. 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
  568. 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
  569. 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
  570. 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
  571. 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
  572. 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 -152
  573. 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
  574. 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
  575. 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
  576. 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
  577. 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
  578. 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
  579. 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
  580. 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
  581. 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
  582. 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
  583. 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
  584. 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
  585. 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
  586. 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
  587. 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
  588. 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
  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_v12.md +0 -203
  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_v13.md +0 -233
  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_v14.md +0 -191
  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_v15.md +0 -213
  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_v16.md +0 -214
  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_v17.md +0 -199
  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_v18.md +0 -183
  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_v19.md +0 -207
  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_v2.md +0 -156
  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_v20.md +0 -283
  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_v21.md +0 -224
  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_v22.md +0 -223
  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_v23.md +0 -293
  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_v24.md +0 -303
  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_v25.md +0 -230
  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_v26.md +0 -196
  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_v27.md +0 -259
  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_v28.md +0 -217
  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_v29.md +0 -270
  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_v3.md +0 -152
  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_v30.md +0 -231
  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_v31.md +0 -281
  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_v4.md +0 -128
  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_v5.md +0 -114
  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_v6.md +0 -192
  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_v7.md +0 -187
  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_v8.md +0 -207
  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_v9.md +0 -203
  617. 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
  618. 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
  619. 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
  620. 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
  621. 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
  622. 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
  623. 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
  624. 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
  625. 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
  626. 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
  627. 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
  628. 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
  629. 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
  630. 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
  631. 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
  632. 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
  633. package/docs/images/lingshu-moonlight-covenant-poster-preview.jpg +0 -0
  634. package/docs/images/lingshu-moonlight-covenant-poster.png +0 -0
  635. 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
  636. package/docs/mdcg/README/350/257/246/347/273/206/347/211/210_v0.4.10.md +0 -746
  637. package/docs/mdcg/guardrail-charter.md +0 -164
  638. package/docs/mdcg/lingshu_tutorial.html +0 -14956
  639. package/docs/mdcg/memory-assessment.html +0 -923
  640. package/docs/mdcg/memory_score.html +0 -213
  641. package/docs/mdcg/memory_score.png +0 -0
  642. package/docs/mdcg/release_v0.3.0.md +0 -36
  643. package/docs/mdcg/release_v0.4.11.md +0 -49
  644. package/docs/mdcg/release_v0.4.5.md +0 -55
  645. package/docs/mdcg/tool_table_v0.3.0.md +0 -117
  646. 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
  647. 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
  648. 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
  649. 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
  650. 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
  651. package/docs/mdcg//345/217/221/345/270/203/351/227/250/347/246/201/351/223/276_v0.1.md +0 -134
  652. 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
  653. 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
  654. 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
  655. 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
  656. 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
  657. 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
  658. 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
  659. 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
  660. package/docs/mdcg//347/274/272/345/217/243/345/215/225_P0/346/224/266/345/217/243_v0.1.md +0 -270
  661. 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
  662. 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
  663. 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
  664. 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
  665. 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
  666. 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
  667. 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
  668. 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
  669. 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
  670. 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
  671. 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
  672. 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
  673. 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
  674. 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
  675. 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
  676. 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
  677. 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
  678. 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
  679. 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
  680. package/docs/promo/bilibili-cover.jpg +0 -0
  681. package/docs/promo/promo-visual-1.png +0 -0
  682. package/docs/promo/promo-visual-2.png +0 -0
  683. package/docs/promo/promo-visual-3.png +0 -0
  684. package/docs/promo/promo-visual-4.png +0 -0
  685. package/docs/promo/promo-visual-5.png +0 -0
  686. package/docs/swarm//350/234/202/347/276/244/344/272/222/350/201/224_v0.1.md +0 -704
  687. 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
  688. 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
  689. 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
  690. 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
  691. 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
  692. 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
  693. 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
  694. 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
  695. 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
  696. 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
  697. package/docs/theory//346/231/272/350/203/275/350/256/2723.4.md +0 -5260
  698. 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
  699. 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
  700. 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
  701. 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
  702. 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
  703. 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
  704. 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
  705. 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
  706. 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
  707. 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
  708. 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
  709. 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
  710. 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
  711. 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
  712. 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
  713. 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
  714. 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,325 @@
1
+ # -*- coding: utf-8 -*-
2
+ """issue #211 守卫:导出落点的第二道约束(link/export 与 op=export 不得写进密钥库/层目录/辅助根)。
3
+
4
+ # 功能名:导出落点护栏 security.check_export_target(与白名单无关的第二道约束)
5
+ # 生效条件:改动 md_cg/security.py::check_export_target、md_cg/mcp_server.py 的 link/export 分支或 _export_call 之后必跑
6
+ # 子功能:① 单元:空路径放行 / 辅助根拒 / 库根层目录拒 / 库根 _ 与 . 开头拒 / 目标已存在拒 / allow_overwrite 放行 / 根外放行 / 库根顶层普通文件放行 ② 集成 link/export:非管理员 out=_keys.json 与 out=节点 .md 均拒且原文件逐字节未动 ③ overwrite=true 需管理权 ④ op=export 管理员同样不得写 _keys.json / 层目录 / 辅助根 ⑤ 保持不变:不带 out 返回包、白名单外仍拒、库根顶层新文件可写、private 读回不受影响 ⑥ 前置对照:撤掉接线(等价修复前形态)⇒ _keys.json 被覆写,判据有判别力
7
+ # 执行:python -X utf8 -m md_cg.test_issue211_export_target
8
+ # 验证方式:末行「通过 N / 失败 M」;红基线:修复前 main 上 ②④ 为红
9
+ # 不适用条件:只测**落点判据**与其接线,不改 evidence.write_pack(CLI --out 行为不变);不测 link/publish 与 link/import 的 swarm 参数(#211 已列为已知遗留);不碰在役库(全程 tempfile 沙箱)
10
+
11
+ ## 缺陷现场(issue #211)
12
+ MDCG_EXPORT_ROOT 未配置时 _whitelist_roots 回落**记忆库根本身**(#85 选 A),
13
+ 而 check_path_root 只判「在根内」⇒ _keys.json、_index.json、各层节点 .md 全在
14
+ 可写面里。持 sustain 令牌(can_admin=False)的调用方两次 MCP 调用即可把证据包
15
+ 整份替换掉数据密钥信封库:属主读自己的 private 记忆一律 not_found、新 private
16
+ 写入报 LockedError,库内无备份。
17
+
18
+ ## 本守卫的判别口径(重要)
19
+ 两个护栏抛的都是 PermissionError,**只看异常类型分不出是谁拦的**。故集成组一律
20
+ 连**报文**一起断言:check_path_root 的报文含「白名单」,本判据的报文含
21
+ 「只许根顶层」「不得以 _ 或 . 开头」「不得落在辅助存储根内」。若新判据没接线,
22
+ check_path_root 的报文就会出现(G6 前置对照即钉这一点)。
23
+ """
24
+ from __future__ import annotations
25
+
26
+ import os
27
+ import shutil
28
+ import sys
29
+ import tempfile
30
+ import traceback
31
+
32
+ # 沙箱必须在**任何** md_cg 子模块 import 之前设好(crypto.MASTER_FILE 在模块
33
+ # 导入时求值)——与 md_cg/test_b2_sensitivity_landing.py 同款装置。
34
+ # 子目录名**不得**用 aux / con / prn / nul / com1-9 / lpt1-9:Windows 保留
35
+ # 设备名,makedirs 会抛 NotADirectoryError(WinError 267)。
36
+ _SANDBOX = tempfile.mkdtemp(prefix="i211_sandbox_")
37
+ os.environ["MDCG_AUX_ROOT"] = os.path.join(_SANDBOX, "auxstore")
38
+ os.environ["MDCG_ROOT"] = os.path.join(_SANDBOX, "libroot")
39
+ os.environ["MDCG_MASTER_KEY"] = os.urandom(32).hex()
40
+ os.environ.pop("MDCG_EXPORT_ROOT", None) # 缺省配置:白名单回落库根
41
+ os.environ.pop("MDCG_TEST_LIVE_ROOT", None)
42
+ os.makedirs(os.environ["MDCG_AUX_ROOT"], exist_ok=True)
43
+ os.makedirs(os.environ["MDCG_ROOT"], exist_ok=True)
44
+
45
+ sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
46
+
47
+ if hasattr(sys.stdout, "reconfigure"):
48
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
49
+
50
+ from md_cg import datapath, mcp_server, security # noqa: E402
51
+ from md_cg.mdcos import MdCGSecure # noqa: E402
52
+ from md_cg.security import Principal # noqa: E402
53
+
54
+ _KEK = os.urandom(32)
55
+ #: 唯一库根。必须 == MDCG_ROOT:缺省白名单回落的是 _configured_library_root(),
56
+ #: 若库根另建子目录,check_path_root 会先以「超出白名单」拦下,本判据根本跑不到。
57
+ _ROOT = os.environ["MDCG_ROOT"]
58
+ _NEW_GUARD_MARKS = ("只许根顶层", "不得以 _ 或 . 开头", "不得落在辅助存储根内")
59
+ _OK = 0
60
+ _BAD = []
61
+
62
+
63
+ def _check(name, cond, detail=""):
64
+ global _OK
65
+ if cond:
66
+ _OK += 1
67
+ print(" ok %s" % name)
68
+ else:
69
+ _BAD.append(name)
70
+ print(" FAIL %s %s" % (name, detail))
71
+
72
+
73
+ def _principal(role, can_admin):
74
+ return Principal(tenant="t1", actor="a_" + role, role=role,
75
+ clearance="private", can_write=True, can_admin=can_admin)
76
+
77
+
78
+ def _mk(tag, role="designer", can_admin=True):
79
+ return MdCGSecure(_ROOT, principal=_principal(role, can_admin), master_key=_KEK)
80
+
81
+
82
+ def _arm(cg):
83
+ """满足 link/export 的前置:swarm 策略对 evidence 签名(#211 复现里同款)。"""
84
+ mcp_server._dispatch(cg, "cg", {"op": "link", "action": "policy", "set": True,
85
+ "subsystem": "swarm",
86
+ "sign_on": ["handshake", "evidence"]})
87
+
88
+
89
+ def _raised(fn, *a, **kw):
90
+ """→ (是否抛, 异常名, 文本)。"""
91
+ try:
92
+ fn(*a, **kw)
93
+ return False, "", ""
94
+ except Exception as exc: # noqa: BLE001
95
+ return True, type(exc).__name__, str(exc)
96
+
97
+
98
+ def _new_guard(txt):
99
+ """报文是否出自 check_export_target(而非 check_path_root)。"""
100
+ return any(m in txt for m in _NEW_GUARD_MARKS)
101
+
102
+
103
+ def _read(p):
104
+ try:
105
+ with open(p, encoding="utf-8", errors="ignore") as f:
106
+ return f.read()
107
+ except OSError:
108
+ return ""
109
+
110
+
111
+ def _run():
112
+ print("\n[1] 单元:check_export_target 判据")
113
+ lib = os.path.join(_SANDBOX, "lib_unit")
114
+ os.makedirs(os.path.join(lib, "knowledge"), exist_ok=True)
115
+ aux = datapath.aux_root()
116
+ _check("U1 空路径放行(未指定落点)",
117
+ _raised(security.check_export_target, "", lib, "t")[0] is False
118
+ and _raised(security.check_export_target, None, lib, "t")[0] is False)
119
+ hit, kind, _t = _raised(security.check_export_target,
120
+ os.path.join(aux, "x.json"), lib, "t")
121
+ _check("U2 辅助存储根内 → 拒", hit and kind == "PermissionError",
122
+ repr((hit, kind)))
123
+ hit, kind, _t = _raised(security.check_export_target,
124
+ os.path.join(lib, "knowledge", "a.md"), lib, "t")
125
+ _check("U3 库根内的层目录 → 拒", hit and kind == "PermissionError",
126
+ repr((hit, kind)))
127
+ hit, kind, _t = _raised(security.check_export_target,
128
+ os.path.join(lib, "_keys.json"), lib, "t")
129
+ _check("U4 库根顶层 _ 开头 → 拒", hit and kind == "PermissionError",
130
+ repr((hit, kind)))
131
+ hit, kind, _t = _raised(security.check_export_target,
132
+ os.path.join(lib, ".hidden"), lib, "t")
133
+ _check("U5 库根顶层 . 开头 → 拒", hit and kind == "PermissionError",
134
+ repr((hit, kind)))
135
+ exists = os.path.join(lib, "already.json")
136
+ with open(exists, "w", encoding="utf-8") as f:
137
+ f.write("x")
138
+ hit, kind, _t = _raised(security.check_export_target, exists, lib, "t")
139
+ _check("U6 目标已存在且未允许覆盖 → 拒", hit and kind == "PermissionError",
140
+ repr((hit, kind)))
141
+ _check("U7 allow_overwrite=True 时已存在目标放行",
142
+ _raised(security.check_export_target, exists, lib, "t",
143
+ allow_overwrite=True)[0] is False)
144
+ _check("U8 根外落点放行(白名单外由 check_path_root 管)",
145
+ _raised(security.check_export_target,
146
+ os.path.join(_SANDBOX, "elsewhere.json"), lib, "t")[0] is False)
147
+ _check("U9 库根顶层普通文件放行",
148
+ _raised(security.check_export_target,
149
+ os.path.join(lib, "export_1.jsonl"), lib, "t")[0] is False)
150
+ # aux 根误配(末段是 Windows 保留设备名)时 datapath.aux_root() 抛
151
+ # ValueError;落点无法校验 ⇒ 必须 fail-closed,且理由要能看懂。
152
+ # Inject the resolver failure itself. "aux" is a valid directory on POSIX;
153
+ # the same failure/PermissionError contract must be exercised on all hosts.
154
+ _old_aux_resolver = datapath.aux_root
155
+ def _broken_aux_resolver():
156
+ raise ValueError("injected auxiliary-root resolution failure")
157
+ datapath.aux_root = _broken_aux_resolver
158
+ try:
159
+ hit, kind, txt10 = _raised(security.check_export_target,
160
+ os.path.join(lib, "export_2.jsonl"), lib, "t")
161
+ _check("U10 aux 根无法解析 ⇒ fail-closed(PermissionError 而非裸 ValueError)",
162
+ hit and kind == "PermissionError" and "辅助存储根无法解析" in txt10,
163
+ repr((hit, kind, txt10[:90])))
164
+ finally:
165
+ datapath.aux_root = _old_aux_resolver
166
+
167
+ print("\n[2] 集成 link/export:非管理员不得覆写密钥库与节点文件")
168
+ cg = _mk("sustain", "sustain", can_admin=False)
169
+ _arm(cg)
170
+ cg.add("i211_node", "# 功能名:i211\n\n正文\n", layer="knowledge")
171
+ node_path = cg._node_disk_path(cg.index["nodes"]["i211_node"])
172
+ keys = os.path.join(_ROOT, "_keys.json")
173
+ before_keys, before_node = _read(keys), _read(node_path)
174
+ _check("G2 前置:库根下确有 _keys.json 与节点 .md",
175
+ bool(before_keys) and bool(before_node),
176
+ repr((len(before_keys), len(before_node))))
177
+
178
+ hit, kind, txt = _raised(mcp_server._dispatch, cg, "cg",
179
+ {"op": "link", "action": "export", "out": keys})
180
+ _check("G2a link/export out=<root>/_keys.json → 拒", hit and kind == "PermissionError",
181
+ repr((hit, kind, txt[:90])))
182
+ _check("G2a2 拒的理由来自**新判据**而非白名单(报文含 _ 开头口径)",
183
+ _new_guard(txt), repr(txt[:110]))
184
+ _check("G2b _keys.json 逐字节未动(数据密钥未丢)",
185
+ _read(keys) == before_keys, "len=%d" % len(_read(keys)))
186
+
187
+ hit, kind, txt = _raised(mcp_server._dispatch, cg, "cg",
188
+ {"op": "link", "action": "export", "out": node_path})
189
+ _check("G2c link/export out=<节点 .md> → 拒", hit and kind == "PermissionError",
190
+ repr((hit, kind, txt[:90])))
191
+ _check("G2c2 拒的理由来自**新判据**(报文含「只许根顶层」)",
192
+ _new_guard(txt), repr(txt[:110]))
193
+ _check("G2d 节点文件逐字节未动(越权改写未发生)",
194
+ _read(node_path) == before_node, repr(_read(node_path)[:40]))
195
+
196
+ hit, kind, txt = _raised(mcp_server._dispatch, cg, "cg",
197
+ {"op": "link", "action": "export",
198
+ "out": os.path.join(_ROOT, "knowledge", "new.md")})
199
+ _check("G2e link/export out=<层目录内新文件> → 拒", _new_guard(txt),
200
+ repr((hit, kind, txt[:90])))
201
+
202
+ hit, kind, txt = _raised(mcp_server._dispatch, cg, "cg",
203
+ {"op": "link", "action": "export",
204
+ "out": os.path.join(_ROOT, "_new.json")})
205
+ _check("G2f link/export out=<root>/_new.json> → 拒", _new_guard(txt),
206
+ repr((hit, kind, txt[:90])))
207
+
208
+ print("\n[3] overwrite=true 需管理权")
209
+ ok_target = os.path.join(_ROOT, "export_i211_ok.jsonl")
210
+ hit, kind, txt = _raised(mcp_server._dispatch, cg, "cg",
211
+ {"op": "link", "action": "export", "out": ok_target,
212
+ "overwrite": True})
213
+ _check("G3a 非管理员 overwrite=true → AccessDenied",
214
+ hit and kind == "AccessDenied", repr((hit, kind, txt[:90])))
215
+ _check("G3a2 被拦的是权限而不是落点(报 AccessDenied 而非 PermissionError)",
216
+ kind == "AccessDenied", repr(kind))
217
+
218
+ cg_a = _mk("designer", "designer", can_admin=True)
219
+ _arm(cg_a)
220
+ keys_a = os.path.join(_ROOT, "_keys.json")
221
+ before_a = _read(keys_a)
222
+ hit, kind, txt = _raised(mcp_server._dispatch, cg_a, "cg",
223
+ {"op": "link", "action": "export", "out": keys_a,
224
+ "overwrite": True})
225
+ _check("G3c 管理员 overwrite=true 也不得写 _keys.json(自伤面同样收口)",
226
+ _new_guard(txt), repr((hit, kind, txt[:90])))
227
+ _check("G3d 管理员侧 _keys.json 亦未动", _read(keys_a) == before_a)
228
+
229
+ print("\n[4] op=export(管理员)不得写进密钥库 / 层目录 / 辅助根")
230
+ for label, target in (
231
+ ("_keys.json", os.path.join(_ROOT, "_keys.json")),
232
+ ("层目录内文件", os.path.join(_ROOT, "knowledge", "dump.jsonl"))):
233
+ hit, kind, txt = _raised(mcp_server._dispatch, cg_a, "cg",
234
+ {"op": "export", "action": "nodes",
235
+ "out": target, "overwrite": True})
236
+ _check("G4 op=export out=<%s> → 拒" % label, _new_guard(txt),
237
+ repr((hit, kind, txt[:90])))
238
+ # 白名单**覆盖辅助根**时(#211 第 9 条缺陷):check_path_root 会放行,
239
+ # 只有新判据能拦住。
240
+ old_export_root = os.environ.get("MDCG_EXPORT_ROOT")
241
+ os.environ["MDCG_EXPORT_ROOT"] = datapath.aux_root()
242
+ try:
243
+ hit, kind, txt = _raised(mdcg_export_root_case, cg_a)
244
+ _check("G4b MDCG_EXPORT_ROOT 覆盖辅助根时仍不得往 aux 造文件",
245
+ _new_guard(txt), repr((hit, kind, txt[:90])))
246
+ finally:
247
+ if old_export_root is None:
248
+ os.environ.pop("MDCG_EXPORT_ROOT", None)
249
+ else:
250
+ os.environ["MDCG_EXPORT_ROOT"] = old_export_root
251
+
252
+ print("\n[5] 保持不变")
253
+ cg_b = _mk("keep", "designer", can_admin=True)
254
+ _arm(cg_b)
255
+ cg_b.add("i211_b", "# 功能名:i211b\n\n正文\n", layer="knowledge")
256
+ hit, kind, txt = _raised(mcp_server._dispatch, cg_b, "cg",
257
+ {"op": "link", "action": "export"})
258
+ _check("G5a 不带 out 的 link/export 仍返回包(不落盘)",
259
+ not hit, repr((hit, kind, txt[:90])))
260
+ hit, kind, _t = _raised(security.check_path_root,
261
+ os.path.join(_SANDBOX, "outside.json"),
262
+ "MDCG_EXPORT_ROOT", "t")
263
+ _check("G5b 白名单外仍拒(#85 的根约束未被削弱)",
264
+ hit and kind == "PermissionError", repr((hit, kind)))
265
+ ok_path = os.path.join(_ROOT, "export_i211_top.jsonl")
266
+ hit, kind, txt = _raised(mcp_server._dispatch, cg_b, "cg",
267
+ {"op": "link", "action": "export", "out": ok_path})
268
+ print(" 读数:link/export out=<root>/export_i211_top.jsonl → raised=%s kind=%s %s"
269
+ % (hit, kind, txt[:70]))
270
+ _check("G5c 库根顶层普通新文件不被落点判据拦(拒绝面只针对密钥/层/辅助根)",
271
+ not _new_guard(txt), repr((hit, kind, txt[:90])))
272
+ priv = cg_b.add("i211_p", "# 功能名:i211p\n\n私密\n", layer="knowledge",
273
+ sensitivity="private")
274
+ _check("G5d private 写入与读回不受影响",
275
+ "私密" in ((cg_b.get(priv) or {}).get("content") or ""))
276
+
277
+ print("\n[6] 前置对照(等价修复前形态):撤掉接线 ⇒ 密钥库被覆写")
278
+ _orig = security.check_export_target
279
+ security.check_export_target = lambda *a, **k: None # 等价「未接线」
280
+ try:
281
+ cg_c = _mk("control", "sustain", can_admin=False)
282
+ _arm(cg_c)
283
+ before_c = _read(keys)
284
+ hit, kind, txt = _raised(mcp_server._dispatch, cg_c, "cg",
285
+ {"op": "link", "action": "export", "out": keys})
286
+ after_c = _read(keys)
287
+ print(" 读数:raised=%s kind=%s 文件被改=%s"
288
+ % (hit, kind, after_c != before_c))
289
+ _check("G6 撤掉接线 ⇒ 无落点判据(修复前形态)",
290
+ not hit, repr((hit, kind, txt[:90])))
291
+ _check("G6b 撤掉接线后 _keys.json 确被改写(判据有判别力)",
292
+ after_c != before_c, repr((len(before_c), len(after_c))))
293
+ _check("G6c 覆写后的 _keys.json 不再是密钥信封库(永久数据丢失形态)",
294
+ "mdcg.evidence.pack" in after_c, repr(after_c[:80]))
295
+ finally:
296
+ security.check_export_target = _orig
297
+
298
+
299
+ def mdcg_export_root_case(cg_a):
300
+ """MDCG_EXPORT_ROOT=辅助根时,往辅助根导出(check_path_root 会放行)。"""
301
+ return mcp_server._dispatch(cg_a, "cg",
302
+ {"op": "export", "action": "nodes",
303
+ "out": os.path.join(datapath.aux_root(), "leak.jsonl"),
304
+ "overwrite": True})
305
+
306
+
307
+ def main():
308
+ print("=== issue #211 守卫:导出落点的第二道约束 ===")
309
+ try:
310
+ _run()
311
+ except Exception: # noqa: BLE001
312
+ traceback.print_exc()
313
+ _BAD.append("未捕获异常")
314
+ finally:
315
+ shutil.rmtree(_SANDBOX, ignore_errors=True)
316
+ print("\n" + "=" * 68)
317
+ print("通过 %d / 失败 %d" % (_OK, len(_BAD)))
318
+ if _BAD:
319
+ print("失败项:" + "、".join(_BAD))
320
+ print("=" * 68)
321
+ return 1 if _BAD else 0
322
+
323
+
324
+ if __name__ == "__main__":
325
+ sys.exit(main())
@@ -0,0 +1,349 @@
1
+ # -*- coding: utf-8 -*-
2
+ """issue #212 守卫:工具面写入的四个缺口(本波修缺口 1/3/4;缺口 2 待 #142 口径裁定)。
3
+
4
+ # 功能名:工具面写入的硬上限闸 + 尝试账本总开关 + 尝试账本归档感知读面
5
+ # 生效条件:改动 md_cg/mcp_server.py 的 mdcg_remember 分支、md_cg/writepipe.py 的
6
+ # oversize_response / _append_attempt / attempt_history、md_cg/rotate.py 的
7
+ # Rotator.read_records 之后必跑
8
+ # 子功能:① 工具面按写入硬上限硬拒,且与动词面同源(逐键相等)② 判据边界不误伤
9
+ # (== 上限放行 / 上限+1 拒,单元级直接钉比较算子)③ 尝试账本总开关有效
10
+ # (缺省开;0/false/no/off 停用)且停用不改写入语义——**走动词面测**:工具面
11
+ # 根本不进 writepipe 的 before 链,故它在尝试账本上恒 0 行(缺口 2 的现状,
12
+ # W4e 如实钉住)④ 轮转后读面不归零
13
+ # (归档感知),只读活动文件的旧口径为 0 行 ⑤ 判别力对照(撤掉接线 ⇒ ① 转红)
14
+ # ⑥ 源码级防回退
15
+ # 执行:python -X utf8 -m md_cg.test_issue212_writeface_gaps
16
+ # 验证方式:末行「通过 N / 失败 M」;红基线:修复前 main 上 ①②④ 为红
17
+ # 不适用条件:缺口 2(工具面对两本账零覆盖)**不在本守卫红绿面内**——它需先裁定
18
+ # #142 的两本账口径(工具面出口集与动词面不同,且 test_twophase ⑧2 钉
19
+ # 「未落盘的分支不产生 intent」);不碰在役库(全程 tempfile 隔离)
20
+ # 不测「恰好等于上限的正文真的落盘」——那条路会命中 audit.redact_forbidden
21
+ # 的二次方开销(见下),本守卫不把 16 分钟写进红绿面;比较算子改在单元级
22
+ # 直接钉(W3),接线另在集成级钉(W1 拒 / W3d 放行小正文)。
23
+
24
+ ## 缺陷现场(issue #212)
25
+ 同一内容走两条通路结论相反:cg(op=write) 被 MAX_WRITE_BYTES 硬拒,mdcg_remember
26
+ 却 committed=True 落盘。根因=判据与字段集被写了两份、只有动词面那份被接线。
27
+ 本守卫 W2 直接断言「两面响应体(按工具面键集)逐键相等」——这条比「工具面也有
28
+ gate 键」更强:它同时钉住「不是复制出来的第二份字段集」。
29
+
30
+ ## 与二次方脱敏的关系(本波实测,另案)
31
+ W3 用单元级钉边界,是因为集成级的「恰好上限」正文会走 audit.redact_forbidden,
32
+ 而该函数在**长小写字母串**上二次方退化(实测 64 KiB=3.9s / 256 KiB=61.3s,外推
33
+ 1 MiB≈16min;嫌疑模式 = data/policy.json 的
34
+ 形如「小写字母打头、[a-z0-9+.-]* 任意长、后接 :// 用户:口令@」的 URL 凭据规则
35
+ ——贪心前缀吃掉整段后逐位回溯找 ://)。
36
+ 该缺陷**不属于 #212 的四个缺口**(本波如实另案上报,不在本件改动面内)。
37
+
38
+ ## 轮转口径(缺口 4,重要)
39
+ 本账此前**只有写面、没有任何读面**(全仓对 _write_attempts 的引用只有写入点与
40
+ 注释)。W5 的判别口径是「读面不归零」,不是「一条不丢」:超出 keep_shards 的旧
41
+ 分片被淘汰是**有界保留=设计**;W5a 同时钉住「只读活动文件的旧口径在轮转后为 0
42
+ 行」,故 W5b 非空不是恒真。
43
+ """
44
+ from __future__ import annotations
45
+
46
+ import io
47
+ import os
48
+ import sys
49
+ import tempfile
50
+
51
+ # 沙箱必须在**任何** md_cg 子模块 import 之前设好(crypto.MASTER_KEY 等在模块导入时
52
+ # 求值)——与 md_cg/test_issue211_export_target.py 同款装置。子目录名不得用 aux /
53
+ # con / prn / nul / com1-9 / lpt1-9:Windows 保留设备名,makedirs 会抛 WinError 267。
54
+ _SANDBOX = tempfile.mkdtemp(prefix="i212_sandbox_")
55
+ os.environ["MDCG_AUX_ROOT"] = os.path.join(_SANDBOX, "auxstore")
56
+ os.environ["MDCG_ROOT"] = os.path.join(_SANDBOX, "libroot")
57
+ os.environ["MDCG_MASTER_KEY"] = os.urandom(32).hex()
58
+ os.environ.pop("MDCG_EXPORT_ROOT", None)
59
+ os.environ.pop("MDCG_TEST_LIVE_ROOT", None)
60
+ os.environ.pop("MDCG_WRITE_ATTEMPT_LEDGER", None)
61
+ os.makedirs(os.environ["MDCG_AUX_ROOT"], exist_ok=True)
62
+ os.makedirs(os.environ["MDCG_ROOT"], exist_ok=True)
63
+
64
+ sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
65
+
66
+ if hasattr(sys.stdout, "reconfigure"):
67
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
68
+
69
+ from md_cg import mcp_server, protocol, writepipe # noqa: E402
70
+ from md_cg.fsutil import read_jsonl # noqa: E402
71
+ from md_cg.mdcos import MdCGOS # noqa: E402
72
+ from md_cg.rotate import Rotator # noqa: E402
73
+
74
+ _HERE = os.path.dirname(os.path.abspath(__file__))
75
+ _PASS = []
76
+ _FAIL = []
77
+ _RUN = [0]
78
+
79
+
80
+ def ok(cond, msg, extra=''):
81
+ (_PASS if cond else _FAIL).append(msg)
82
+ print((' PASS ' if cond else ' FAIL ') + msg
83
+ + ((' <- ' + str(extra)) if (extra and not cond) else ''))
84
+
85
+
86
+ def _lib(tag):
87
+ _RUN[0] += 1
88
+ return MdCGOS(os.path.join(_SANDBOX, '%s_r%d' % (tag, _RUN[0])), autoflush=0)
89
+
90
+
91
+ BODY = '# 功能名:%s' + chr(10) + chr(10) + '# 生效条件:PASSED' + chr(10)
92
+ LIMIT = writepipe.MAX_WRITE_BYTES
93
+
94
+
95
+ def _args(text, nid):
96
+ return {'content_kind': 'text', 'content': text, 'layer': 'knowledge',
97
+ 'node_id': nid, 'verification_basis': 'test'}
98
+
99
+
100
+ def _ccg(tag):
101
+ """动词面会过 audit 的 required 规则(CCG 六要素),故**动词面夹具必须齐六行**;
102
+ 工具面不进审核链,短文即可。W4 用本函数,正是为了让「账本 +1」测的是开关而不是
103
+ 审核结论(用三行短文会被 REJECT,于是账本行数不增,测出来的红是夹具缺陷)。"""
104
+ # 六行**取值互不相同**:一致性的自否定判据会拿「不适用条件」去比「生效条件/正文」,
105
+ # 六行都写同一个哑值会被判「条件自相矛盾」转 review_queue(本守卫初版即踩此坑)。
106
+ return ('# 功能名:%s' % tag + chr(10)
107
+ + '# 生效条件:当尝试账本开关未显式停用时' + chr(10)
108
+ + '# 子功能:尝试账本的记账与开关' + chr(10)
109
+ + '# 执行:进程内 call_tool 写一条正文' + chr(10)
110
+ + '# 验证方式:比对账本行数差' + chr(10)
111
+ + '# 不适用条件:不涉及轮转与归档分片' + chr(10))
112
+
113
+
114
+ def _pad(n):
115
+ """造**恰好 n 字节**的正文。填充用大写字母:小写长串会命中
116
+ audit.redact_forbidden 的二次方退化(见模块 docstring),本守卫不测那个。"""
117
+ head = BODY % 'p'
118
+ return head + ('Z' * (n - len(head.encode('utf-8'))))
119
+
120
+
121
+ def tool_write(cg, text, nid):
122
+ return mcp_server.call_tool(cg, 'mdcg_remember', _args(text, nid))
123
+
124
+
125
+ def verb_write(cg, text, nid):
126
+ return mcp_server.call_tool(cg, 'cg', dict(op='write', **_args(text, nid)))
127
+
128
+
129
+ def _rows(cg):
130
+ p = os.path.join(cg.root, writepipe.ATTEMPT_LOG_FILE)
131
+ if not os.path.isfile(p):
132
+ return 0
133
+ with io.open(p, encoding='utf-8') as f:
134
+ return sum(1 for l in f if l.strip())
135
+
136
+
137
+ def _need(shape):
138
+ return set(protocol.VERB_SPECS['write']['shapes'][shape]['required'])
139
+
140
+
141
+ def _env_guard(key):
142
+ old = os.environ.get(key)
143
+ os.environ.pop(key, None)
144
+ return old
145
+
146
+
147
+ def _env_restore(key, old):
148
+ if old is None:
149
+ os.environ.pop(key, None)
150
+ else:
151
+ os.environ[key] = old
152
+
153
+
154
+ def w1_tool_face_hard_limit():
155
+ cg = _lib('w1')
156
+ big = _pad(LIMIT + 8)
157
+ o = tool_write(cg, big, 'w1_big')
158
+ ok(o.get('committed') is False,
159
+ 'W1a 工具面超限 => committed is False(修复前为 True)', o.get('committed'))
160
+ ok(o.get('gate') == 'writelimit_size',
161
+ 'W1b 工具面超限 => gate=writelimit_size', o.get('gate'))
162
+ miss = [k for k in protocol.WRITE_TRIO if k not in o]
163
+ ok(not miss, 'W1c 工具面超限返回体含三键(ok/id/committed)', sorted(o))
164
+ need = _need('gate_hard_reject')
165
+ ok(not [k for k in need if k not in o],
166
+ 'W1d 工具面超限返回体命中协议形态 gate_hard_reject', sorted(o))
167
+ ok('w1_big' not in cg.index['nodes'],
168
+ 'W1e 超限内容未落盘(索引里无该节点)', list(cg.index['nodes'])[:5])
169
+ ok(o.get('bytes') == len(big.encode('utf-8')) and o.get('limit') == LIMIT,
170
+ 'W1f 读数自洽:bytes = 正文实际字节数,limit = 上限',
171
+ (o.get('bytes'), len(big.encode('utf-8')), o.get('limit')))
172
+
173
+
174
+ def w2_two_faces_identical():
175
+ """两条通路必须给**同一个**响应体(按工具面键集)——比「工具面也有 gate 键」
176
+ 更强:它同时钉住「不是复制出来的第二份字段集」。
177
+ 动词面外层多一个 action_source(动词面信封),故按工具面键集取子集比对。"""
178
+ cg = _lib('w2')
179
+ big = _pad(LIMIT + 8)
180
+ o_t = tool_write(cg, big, 'same_id')
181
+ o_v = verb_write(cg, big, 'same_id')
182
+ sub = {k: o_v[k] for k in o_t if k in o_v}
183
+ ok(o_t == sub,
184
+ 'W2a 同内容 + 同 id:工具面响应体 == 动词面对应键集(同源,非复制)',
185
+ (sorted(o_t), sorted(o_v), o_t.get('gate'), o_v.get('gate')))
186
+ ok(set(o_t) <= set(o_v),
187
+ 'W2b 工具面键集是动词面键集的子集(动词面只多信封键)',
188
+ sorted(set(o_t) - set(o_v)))
189
+
190
+
191
+ def w3_boundary_no_false_positive():
192
+ """比较算子(> 上限 才拒)在**唯一构造点**上直接钉——不落盘,故不触发
193
+ redact_forbidden 的二次方开销。"""
194
+ a = {'content': _pad(LIMIT), 'content_kind': 'text'}
195
+ ok(writepipe.oversize_response('n', a) is None,
196
+ 'W3a 恰好 == 上限(%d 字节)=> 放行(比较算子是 >,不误伤)' % LIMIT,
197
+ writepipe.oversize_response('n', a))
198
+ a2 = {'content': _pad(LIMIT + 1), 'content_kind': 'text'}
199
+ r2 = writepipe.oversize_response('n', a2)
200
+ ok(isinstance(r2, dict) and r2.get('committed') is False,
201
+ 'W3b 上限 +1 字节 => 拒', r2)
202
+ ok(r2 and r2.get('bytes') == LIMIT + 1,
203
+ 'W3c 上限 +1 的 bytes 读数 = %d' % (LIMIT + 1), r2 and r2.get('bytes'))
204
+ cg = _lib('w3')
205
+ small = BODY % '小正文'
206
+ o = tool_write(cg, small, 'w3_small')
207
+ ok(o.get('committed') is True,
208
+ 'W3d 小正文仍正常落盘(补闸未误伤常规写入)', o)
209
+
210
+
211
+ def w4_ledger_switch():
212
+ cg = _lib('w4')
213
+ key = writepipe.ATTEMPT_LEDGER_ENV
214
+ old = _env_guard(key)
215
+ try:
216
+ b = _rows(cg)
217
+ o = verb_write(cg, _ccg('开关未设'), 'w4_a')
218
+ ok(_rows(cg) - b == 1 and o.get('committed') is True,
219
+ 'W4a 未设 %s => 账本 +1 行(缺省开,与修复前逐位一致)' % key,
220
+ _rows(cg) - b)
221
+ for i, val in enumerate(('0', 'false', 'no', 'off', 'OFF', ' false ')):
222
+ os.environ[key] = val
223
+ b = _rows(cg)
224
+ o = verb_write(cg, _ccg('开关' + str(i)), 'w4_off%d' % i)
225
+ ok(_rows(cg) - b == 0,
226
+ 'W4b %s=%r => 账本 +0 行(修复前该 env 无效、仍写 1 行)' % (key, val),
227
+ _rows(cg) - b)
228
+ ok(o.get('committed') is True,
229
+ 'W4c %s=%r 停用只停留痕、不改写入语义' % (key, val), o)
230
+ os.environ[key] = '1'
231
+ b = _rows(cg)
232
+ verb_write(cg, _ccg('开关1'), 'w4_one')
233
+ ok(_rows(cg) - b == 1, 'W4d %s=1 => 账本 +1 行' % key, _rows(cg) - b)
234
+ # 如实钉住**缺口 2 的现状**(本件不修):工具面根本不进 writepipe 的 before
235
+ # 链,故它的写入在尝试账本上是 0 行。若将来 #142 的伞状裁定把工具面也接进
236
+ # 记账面,本项会转红——那正是「把断言升级为『两面一致』」的信号(同
237
+ # md_cg/test_write_return_shape.py 的 H2/H3「现状记录·待裁定」惯例)。
238
+ b = _rows(cg)
239
+ tool_write(cg, BODY % '工具面不记账', 'w4_tool')
240
+ ok(_rows(cg) - b == 0,
241
+ 'W4e 现状(缺口 2,待 #142 裁定):工具面写入不产生尝试账本行',
242
+ _rows(cg) - b)
243
+ finally:
244
+ _env_restore(key, old)
245
+
246
+
247
+ def w5_history_survives_rotation():
248
+ """判别口径是「读面**不归零**」,不是「一条不丢」:超出 keep_shards 的旧分片
249
+ 被淘汰是有界保留=设计。W5a 同时钉住「只读活动文件的旧口径在轮转后为 0 行」,
250
+ 故 W5b 非空不是恒真。"""
251
+ cg = _lib('w5')
252
+ key = writepipe.ATTEMPT_LEDGER_ENV
253
+ old = _env_guard(key)
254
+ try:
255
+ rot = Rotator(cg.root, writepipe.ATTEMPT_BASENAME,
256
+ writepipe.ATTEMPT_ARCHIVE_DIR,
257
+ rotate_bytes=1, keep_shards=2)
258
+ for k in range(6):
259
+ for j in range(6):
260
+ writepipe._append_attempt(cg, 'w5_%d_%d' % (k, j),
261
+ {'content_kind': 'text',
262
+ 'layer': 'knowledge'},
263
+ writepipe.ATTEMPT_COMMITTED,
264
+ out={'id': 'x'})
265
+ r = rot.rotate()
266
+ ok(r is not None, 'W5 第 %d 次轮转切出分片' % (k + 1), r)
267
+ active_only = list(read_jsonl(os.path.join(cg.root,
268
+ writepipe.ATTEMPT_LOG_FILE)))
269
+ hist = writepipe.attempt_history(cg, limit=0)
270
+ ok(len(active_only) == 0,
271
+ 'W5a 只读活动文件的旧口径:轮转后 0 行(缺陷现场)', len(active_only))
272
+ ok(len(hist) > 0,
273
+ 'W5b 归档感知读面:轮转后**不归零**', len(hist))
274
+ ok(len(hist) == 12,
275
+ 'W5c 读面 = 存活分片(keep_shards=2 × 6 行)+ 活动文件', len(hist))
276
+ ok([r['id'] for r in hist][-1] == 'w5_5_5',
277
+ 'W5d 时间序正确(末条 = 最后一次写入)', [r['id'] for r in hist][-1:])
278
+ ok(len(writepipe.attempt_history(cg, limit=3)) == 3,
279
+ 'W5e limit 生效(取尾部 3 条)',
280
+ len(writepipe.attempt_history(cg, limit=3)))
281
+ finally:
282
+ _env_restore(key, old)
283
+
284
+
285
+ def w6_discriminator():
286
+ """判别力对照:把唯一构造点撤成 no-op(等价修复前形态)⇒ 工具面又落盘成功。
287
+ 证明 W1 不是恒真。"""
288
+ cg = _lib('w6')
289
+ big = _pad(LIMIT + 8)
290
+ real = writepipe.oversize_response
291
+ try:
292
+ writepipe.oversize_response = lambda nid, a: None
293
+ o = tool_write(cg, big, 'w6_big')
294
+ ok(o.get('committed') is True,
295
+ 'W6a 撤掉接线 => 工具面又落盘成功(W1 有判别力)', o)
296
+ finally:
297
+ writepipe.oversize_response = real
298
+
299
+
300
+ def w7_source_no_regress():
301
+ src = io.open(os.path.join(_HERE, 'mcp_server.py'), encoding='utf-8').read()
302
+ i = src.find('if name == "mdcg_remember":')
303
+ j = src.find('if name == "mdcg_recall":')
304
+ block = src[i:j] if (i >= 0 and j > i) else ''
305
+ ok('oversize_response' in block,
306
+ 'W7a 工具面分支仍调用动词面的同一实现(防回退到「各写一份判据」)',
307
+ '(本项红说明接线被撤)')
308
+ ws = io.open(os.path.join(_HERE, 'writepipe.py'), encoding='utf-8').read()
309
+ ok('def oversize_response' in ws,
310
+ 'W7b writepipe 仍有唯一构造点 oversize_response')
311
+ ok('def attempt_history' in ws,
312
+ 'W7c writepipe 仍有归档感知读面 attempt_history')
313
+ ok('def read_records' in io.open(os.path.join(_HERE, 'rotate.py'),
314
+ encoding='utf-8').read(),
315
+ 'W7d Rotator 仍有归档感知读原语 read_records')
316
+ ok(writepipe.ATTEMPT_LEDGER_ENV == 'MDCG_WRITE_ATTEMPT_LEDGER',
317
+ 'W7e 开关名就是 issue #212 点名的那一个(不是另起新名)',
318
+ writepipe.ATTEMPT_LEDGER_ENV)
319
+ ok(writepipe.oversize_response('n', {'content': 'x'}) is None,
320
+ 'W7f 唯一构造点可直接调用(两面的共用入口没被私有化)')
321
+
322
+
323
+ _CASES = (w1_tool_face_hard_limit, w2_two_faces_identical,
324
+ w3_boundary_no_false_positive, w4_ledger_switch,
325
+ w5_history_survives_rotation, w6_discriminator,
326
+ w7_source_no_regress)
327
+
328
+
329
+ def _run_all():
330
+ del _PASS[:]
331
+ del _FAIL[:]
332
+ for fn in _CASES:
333
+ print(chr(10) + '== %s' % fn.__name__)
334
+ try:
335
+ fn()
336
+ except Exception as exc: # noqa: BLE001
337
+ import traceback
338
+ _FAIL.append('%s 抛异常' % fn.__name__)
339
+ print(' FAIL %s 抛异常:%s: %s'
340
+ % (fn.__name__, type(exc).__name__, exc))
341
+ traceback.print_exc()
342
+ print(chr(10) + '通过 %d / 失败 %d' % (len(_PASS), len(_FAIL)))
343
+ for m in _FAIL:
344
+ print(' - ' + m)
345
+ return 1 if _FAIL else 0
346
+
347
+
348
+ if __name__ == '__main__':
349
+ raise SystemExit(_run_all())