@furongjun1999/dsh-memory 0.9.6 → 0.9.8

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 (233) hide show
  1. package/README.md +150 -662
  2. package/codebuddy/CODEBUDDY.md +333 -204
  3. package/data/policy.json +38 -38
  4. package/docs/README.md +18 -0
  5. package/docs/discipline/harnesses.yaml +11 -3
  6. package/docs/discipline/templates/compact.txt.tmpl +20 -18
  7. package/docs/discipline/templates/full.md.tmpl +63 -61
  8. package/docs/discipline/templates/rules.mdc.tmpl +5 -3
  9. package/docs/discipline/templates/skill.md.tmpl +25 -23
  10. package/docs/discipline/templates/spec.txt.tmpl +2 -2
  11. package/docs/discipline/templates/zcode-user.md.tmpl +1 -1
  12. package/dsh/cordis.yml.example +139 -139
  13. package/lib/hooks.d.ts +19 -0
  14. package/lib/hooks.js +30 -7
  15. package/lib/index.js +18 -3
  16. package/lib/init.js +19 -4
  17. package/lib/lib/hook_audit.js +64 -2
  18. package/lib/lib/prompt_safety.js +14 -3
  19. package/lib/tools.d.ts +7 -0
  20. package/lib/tools.js +22 -1
  21. package/md_cg/_guard_kit.py +121 -121
  22. package/md_cg/anchor.py +114 -114
  23. package/md_cg/audit.py +15 -2
  24. package/md_cg/chain.py +3 -2
  25. package/md_cg/config_registry_guard.py +487 -487
  26. package/md_cg/conformance.py +747 -747
  27. package/md_cg/consolidate.py +1793 -1793
  28. package/md_cg/crypto.py +794 -794
  29. package/md_cg/hyperedge.py +262 -262
  30. package/md_cg/interface_schema.py +146 -146
  31. package/md_cg/lifecycle.py +426 -426
  32. package/md_cg/mdcos.py +12 -8
  33. package/md_cg/predict.py +1103 -1103
  34. package/md_cg/protect.py +654 -654
  35. package/md_cg/provenance.py +606 -606
  36. package/md_cg/queue_health.py +130 -130
  37. package/md_cg/refine.py +613 -613
  38. package/md_cg/retrieve.py +128 -128
  39. package/md_cg/revise.py +140 -140
  40. package/md_cg/rollback.py +657 -657
  41. package/md_cg/rollback_cli.py +124 -124
  42. package/md_cg/rotate.py +346 -346
  43. package/md_cg/routing.py +490 -490
  44. package/md_cg/self_surface.py +50 -50
  45. package/md_cg/semantic/canonical.py +144 -144
  46. package/md_cg/semantic/zh_en_atoms.py +141 -141
  47. package/md_cg/sources.py +1091 -1091
  48. package/md_cg/stg.py +3 -2
  49. package/md_cg/sustain.py +10 -1
  50. package/md_cg/test_audit_rotate_parity.py +279 -279
  51. package/md_cg/test_autonomy_modes.py +2013 -2013
  52. package/md_cg/test_cn_recall_grams.py +206 -206
  53. package/md_cg/test_code_kind_forbidden.py +101 -0
  54. package/md_cg/test_condaccept.py +156 -156
  55. package/md_cg/test_condgate.py +141 -141
  56. package/md_cg/test_heartbeat_ledger.py +9 -3
  57. package/md_cg/test_i50e_readside_protection.py +658 -658
  58. package/md_cg/test_issue111_gate_order.py +76 -76
  59. package/md_cg/test_issue111_scoring_contract.py +86 -86
  60. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  61. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  62. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  63. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  64. package/md_cg/test_issue149_accel_default_face.py +248 -248
  65. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  66. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  67. package/md_cg/test_issue152_sealed_postings.py +309 -309
  68. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  69. package/md_cg/test_issue157b_index_remainder.py +344 -344
  70. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  71. package/md_cg/test_issue191_import_trust.py +382 -382
  72. package/md_cg/test_issue193_write_scope.py +378 -378
  73. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  74. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  75. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  76. package/md_cg/test_issue216_clash_routes.py +214 -214
  77. package/md_cg/test_issue217_slot_routes.py +248 -248
  78. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  79. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  80. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  81. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  82. package/md_cg/test_issue275_layer_param.py +250 -250
  83. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  84. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  85. package/md_cg/test_issue278_neg_window.py +294 -294
  86. package/md_cg/test_issue278_negative_layering.py +83 -83
  87. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  88. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  89. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  90. package/md_cg/test_issue303_design_boundaries.py +262 -262
  91. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  92. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  93. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  94. package/md_cg/test_issue322_node_write_lock.py +727 -727
  95. package/md_cg/test_issue324_write_size_fields.py +214 -214
  96. package/md_cg/test_issue325_audit_poison.py +229 -229
  97. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  98. package/md_cg/test_issue326_key_perms.py +355 -355
  99. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  100. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  101. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  102. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  103. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  104. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  105. package/md_cg/test_issue350_casefold_collision.py +235 -235
  106. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  107. package/md_cg/test_issue352_imgaudit.py +418 -418
  108. package/md_cg/test_issue352_pathsjson.py +537 -537
  109. package/md_cg/test_issue352_refindex.py +412 -412
  110. package/md_cg/test_issue352_rollback.py +604 -604
  111. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  112. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  113. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  114. package/md_cg/test_issue358_truncation_observable.py +247 -247
  115. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  116. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  117. package/md_cg/test_issue362_neg_condition.py +468 -468
  118. package/md_cg/test_issue363_lexical_idf.py +275 -275
  119. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  120. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  121. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  122. package/md_cg/test_issue378_protected_floor.py +310 -310
  123. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  124. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  125. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  126. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  127. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  128. package/md_cg/test_issue404_heal_receipt.py +389 -389
  129. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  130. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  131. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  132. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  133. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  134. package/md_cg/test_issue413_preimage_twin.py +339 -339
  135. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  136. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  137. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  138. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  139. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  140. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  141. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  142. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  143. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  144. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  145. package/md_cg/test_issue434_435_float_gate.py +90 -90
  146. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  147. package/md_cg/test_issue43_default_policy.py +874 -874
  148. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  149. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  150. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  151. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  152. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  153. package/md_cg/test_issue451_audit_actor.py +313 -313
  154. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  155. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  156. package/md_cg/test_issue466_basis_registry.py +469 -469
  157. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  158. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  159. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  160. package/md_cg/test_issue471_identity_readable.py +136 -136
  161. package/md_cg/test_issue472_audit_chain.py +90 -90
  162. package/md_cg/test_issue472_prune_ledger.py +105 -105
  163. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  164. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  165. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  166. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  167. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  168. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  169. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  170. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  171. package/md_cg/test_issue547_audit_durable.py +96 -96
  172. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  173. package/md_cg/test_issue559_refine_prefix.py +69 -69
  174. package/md_cg/test_issue562_retired_faces.py +150 -0
  175. package/md_cg/test_issue71_queue_backlog.py +376 -376
  176. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  177. package/md_cg/test_issue82_credential_rules.py +271 -271
  178. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  179. package/md_cg/test_issue93_remember_redaction.py +282 -282
  180. package/md_cg/test_logref.py +1141 -1141
  181. package/md_cg/test_md_access_parity.py +330 -330
  182. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  183. package/md_cg/test_mutation_residue.py +119 -119
  184. package/md_cg/test_mutation_rollback.py +835 -835
  185. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  186. package/md_cg/test_n184_keys_concurrent_provision.py +1 -1
  187. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  188. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  189. package/md_cg/test_neg_tail_honesty.py +733 -733
  190. package/md_cg/test_p21_tokens.py +294 -294
  191. package/md_cg/test_p27_docindex.py +792 -792
  192. package/md_cg/test_p28_refcheck.py +1053 -1053
  193. package/md_cg/test_p2_six_elements.py +476 -476
  194. package/md_cg/test_p33_ccg_wiring.py +300 -300
  195. package/md_cg/test_p3_legacy_closure.py +438 -438
  196. package/md_cg/test_p40_refine_worklist.py +244 -244
  197. package/md_cg/test_p4_freshness.py +781 -781
  198. package/md_cg/test_p9c_dedup_hints.py +288 -288
  199. package/md_cg/test_policy_required_ccg.py +444 -444
  200. package/md_cg/test_read_scope_b27.py +2 -2
  201. package/md_cg/test_retr_s5.py +312 -312
  202. package/md_cg/test_s1_ast_judge.py +109 -109
  203. package/md_cg/test_security_audit_v21.py +249 -249
  204. package/md_cg/test_state_event_op.py +521 -521
  205. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  206. package/md_cg/test_sustain_bad_stamp.py +178 -0
  207. package/md_cg/test_sustain_bounded.py +652 -652
  208. package/md_cg/test_trust_edge_reachability.py +405 -405
  209. package/md_cg/test_w7_redlines.py +659 -659
  210. package/md_cg/test_write_return_shape.py +919 -919
  211. package/md_cg/test_writepipe.py +228 -228
  212. package/md_cg/trust.py +1114 -1114
  213. package/md_cg/twophase.py +303 -303
  214. package/md_cg/whitebox.py +536 -536
  215. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  216. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  217. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  218. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  219. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  220. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  221. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  222. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  223. package/md_cg/writepipe.py +1337 -1337
  224. package/package.json +3 -2
  225. package/scripts/workspace_index.py +328 -0
  226. package/src/hooks.ts +932 -908
  227. package/src/index.ts +21 -6
  228. package/src/init.ts +16 -4
  229. package/src/lib/hook_audit.ts +48 -2
  230. package/src/lib/mdcg_client.ts +469 -469
  231. package/src/lib/prompt_safety.ts +17 -3
  232. package/src/tools.ts +23 -1
  233. package/zcode/AGENTS.md +333 -204
@@ -1,378 +1,378 @@
1
- # -*- coding: utf-8 -*-
2
- r"""#147 守卫:pack_id 一律不得逃出收件箱(路径穿越 / 覆写 _keys.json)。
3
-
4
- 缺陷(本件修复,2026-10-11)
5
- --------------------------
6
- \`write_pack\` 把 \`pack_id\` **未清洗**即拼进归档路径(缺省分支);
7
- \`_validate\` 也不校验 pack_id ⇒ 带 \`../\` 的 pack_id 可穿越出收件箱。
8
- 实测(tempfile 沙箱):\`pack_id = '../../../../../memroot/_keys'\` 经
9
- \`import_pack(archive=True)\` **一次即覆写** \`_keys.json\` 与 \`_tokens.json\`
10
- (返回 \`ok=True / archived=memroot\_keys.json\`);\`pack_id\` 带空字节时
11
- \`ValueError\` 还会**逸出** import_pack(原 except 只捕 OSError)。
12
-
13
- 三道闸(本守卫逐条钉)
14
- ---------------------
15
- ① \`_validate\` pack_id 白名单(ASCII 字母数字与 . _ -;拒 ..、前导点、超长)
16
- ② \`write_pack\` 汇点兜底:同源白名单 + realpath 包含性 → 一律 \`EvidenceError\`
17
- ③ \`import_pack\` 归档 except 扩到 \`EvidenceError\`(不逃逸)
18
-
19
- **磁盘证据优先**:不止断言「抛异常/拒收」,还断言**没有文件落在收件箱之外**
20
- 且受害者档未被覆写——M2 变异正是靠这条磁盘腿转红。
21
-
22
- 运行:python -X utf8 -m md_cg.test_issue147_pack_id_escape
23
- python -X utf8 -m md_cg.test_issue147_pack_id_escape --mutate
24
- 退出码:0 全绿 / 1 有失败
25
- """
26
- from __future__ import annotations
27
-
28
- import argparse
29
- import io
30
- import json
31
- import os
32
- import shutil
33
- import sys
34
- import tempfile
35
- import time
36
-
37
- from . import evidence as ev
38
- from .mdcos import MdCGOS
39
-
40
- PASS = FAIL = 0
41
- FAILS = []
42
- _SANDBOXES = []
43
-
44
- #: 恶意 pack_id 矩阵:(名, 值)——覆盖 穿越/绝对/盘符/UNC/空字节/点形/超长/类型
45
- MALICIOUS = (
46
- ("穿越(glued)", "../../../../../memroot/_keys"),
47
- ("穿越(slash)", "/../../../../memroot/_keys"),
48
- ("穿越(_tokens)", "/../../../../memroot/_tokens"),
49
- ("反斜杠穿越", "..\\..\\memroot\\_keys"),
50
- ("纯 ..", ".."),
51
- ("单点", "."),
52
- ("前导点", ".hidden"),
53
- ("绝对路径", "/tmp/evil"),
54
- ("盘符", "C:/evil"),
55
- ("UNC", "\\\\srv\\share\\evil"),
56
- ("空字节", "bad\x00id"),
57
- ("超长", "p" * (ev.PACK_ID_MAX + 1)),
58
- ("非字符串", 123),
59
- ("缺失", None),
60
- )
61
- #: 合法 pack_id(导出面真实形态,见 export_pack:pack-<12hex>)
62
- LEGIT = (("导出形", "pack-a1b2c3d4e5f6"), ("含点横线", "pack-1.2_x-3"))
63
-
64
- SENT = '{"victim": "ORIGINAL"}'
65
-
66
-
67
- def check(name, cond, detail=""):
68
- global PASS, FAIL
69
- if cond:
70
- PASS += 1
71
- print(" [PASS] %s%s" % (name, (" · " + str(detail)) if detail else ""))
72
- else:
73
- FAIL += 1
74
- FAILS.append(name)
75
- print(" [FAIL] %s · %s" % (name, detail))
76
- return bool(cond)
77
-
78
-
79
- # 生效条件:无入参;建 tempfile 沙箱(auxroot/memroot 两目录 + 策略档 + env),
80
- # 返回 (T, AUX, ROOT, cg)。注意目录名不能取 "aux"——Windows 保留设备名。
81
- def _sandbox():
82
- t = tempfile.mkdtemp(prefix="i147_guard_")
83
- _SANDBOXES.append(t)
84
- aux, root = os.path.join(t, "auxroot"), os.path.join(t, "memroot")
85
- for d in (aux, root):
86
- os.makedirs(d, exist_ok=True)
87
- os.environ.update(MDCG_AUX_ROOT=aux, MDCG_ROOT=root, MDCG_NODE_ID="node-self",
88
- MDCG_MASTER_KEY=os.urandom(32).hex())
89
- # **必须显式设 MDCG_SWARM_DIR**:`evidence.DEFAULT_SWARM_DIR` 在**模块导入时**
90
- # 由 aux_root() 冻结,而本守卫是模块顶层 `import evidence` ⇒ 只设 MDCG_AUX_ROOT
91
- # 不生效,归档会落到**真实** aux 目录(本守卫首版即踩此坑:实测污染了
92
- # `~/.mdcg/swarm/inbox` 并在家目录下留下穿越产物 `~/memroot`,
93
- # 已逐项核对清理——见 _team/iss147/report.md「探针污染」节)。
94
- # ⚠ 本机绝对路径不得写进追踪面(check_local_paths 硬门禁),故此处用中性占位。
95
- # `swarm_dir()` 在**调用时**读该环境变量,故这是唯一有效的沙箱开关。
96
- os.environ["MDCG_SWARM_DIR"] = os.path.join(aux, "swarm")
97
- pol = os.path.join(t, "policy.json")
98
- io.open(pol, "w", encoding="utf-8").write(
99
- json.dumps({"forbidden": [], "required": []}))
100
- os.environ["MDCG_POLICY_FILE"] = pol
101
- # #453(SEC·P1)同批随动:`import_pack` 现为 fail-closed(空签名一律拒)。
102
- # 本守卫的 G2「合法 pack_id 不误伤」需要一个**真签得出来**的合法包,故在沙箱里
103
- # 声明子系统策略(要求对端签名)并把密钥/策略文件都指进沙箱——不碰真实 aux。
104
- sigfile = os.path.join(t, "signers.json")
105
- io.open(sigfile, "w", encoding="utf-8").write(json.dumps({
106
- "schema": 1, "default_signer": "hmac-local",
107
- "subsystems": {ev.SUBSYSTEM: {
108
- "signer": "hmac-local", "sign_on": ["handshake", "evidence"],
109
- "require_peer_signature": True, "on_verify_fail": "reject"}}}))
110
- os.environ["MDCG_SIGNERS_FILE"] = sigfile
111
- os.environ["MDCG_SIGNER_KEY_FILE"] = os.path.join(t, "signer.key")
112
- # fail-closed:沙箱没生效就**拒跑**,绝不在真实 aux 目录上做攻击面验证。
113
- inbox = os.path.realpath(ev.inbox_dir())
114
- if not inbox.startswith(os.path.realpath(t) + os.sep):
115
- raise RuntimeError(
116
- "沙箱未生效:收件箱 %s 不在 tempfile 沙箱 %s 内——拒绝运行" % (inbox, t))
117
- return t, aux, root, MdCGOS(root)
118
-
119
-
120
- def _pack(pid):
121
- # #453(SEC·P1,同批随动):`import_pack` 现为 **fail-closed:空签名一律拒收**
122
- # (不看 `sig.signer`/`sig.signed` 等对端自报值)。本守卫的合法夹具原先用
123
- # `{"signer":"null","signature":"","signed":False}` 冒充「合法包」——那条通道
124
- # 正是 #453 要关掉的免签名通行证,故夹具必须带**真签名**,否则 G2 的
125
- # 「合法 pack_id 不误伤」会被签名闸(而非 pack_id 闸)打红。
126
- # 判据强度**不降**:G2 仍断言 `ok is True and archived`,并新增 `sig` 非空断言
127
- # (见 _run_all),把「夹具确实签过」也钉住。
128
- p = {"kind": ev.KIND, "schema": ev.SCHEMA, "from_node": "attacker",
129
- "pack_id": pid, "created_at": time.time(),
130
- "items": [{"subject": "s", "text": "t", "sensitivity": "internal"}]}
131
- s = ev._signer.sign_for(ev.SUBSYSTEM, ev._pack_payload(p),
132
- action=ev.SIGN_ACTION)
133
- p["sig"] = {"signer": s.get("signer"),
134
- "signature": s.get("signature") or "",
135
- "signed": bool(s.get("signed"))}
136
- return p
137
-
138
-
139
- def _reset(root):
140
- for p in (os.path.join(root, "_keys.json"), os.path.join(root, "_tokens.json")):
141
- io.open(p, "w", encoding="utf-8").write(SENT)
142
-
143
-
144
- def _victim_touched(root):
145
- for p in (os.path.join(root, "_keys.json"), os.path.join(root, "_tokens.json")):
146
- if io.open(p, encoding="utf-8").read() != SENT:
147
- return True
148
- return False
149
-
150
-
151
- def _outside_inbox(aux):
152
- """收件箱之外(整个 aux 树里)的落点——磁盘证据腿。"""
153
- inbox = os.path.realpath(ev.inbox_dir())
154
- out = []
155
- for dp, _dn, fns in os.walk(aux):
156
- for f in fns:
157
- p = os.path.realpath(os.path.join(dp, f))
158
- if p != inbox and not p.startswith(inbox + os.sep):
159
- out.append(os.path.relpath(p, aux).replace("\\", "/"))
160
- return sorted(out)
161
-
162
-
163
- # 生效条件:入参为 (_sandbox() 的四元组);逐条跑恶意/合法矩阵与显式 path 面,
164
- # 返回违规描述列表(空列表=全合规)。**判据单点**——变异打在其依赖的模块属性上。
165
- def _judge(sb) -> list:
166
- t, aux, root, cg = sb
167
- bad = []
168
- for name, pid in MALICIOUS:
169
- _reset(root)
170
- why = ev._validate(_pack(pid))
171
- if not why:
172
- bad.append("validate:[%s] 放行了非法 pack_id %r" % (name, pid))
173
- try:
174
- f = ev.write_pack(_pack(pid), swarm=None)["file"]
175
- bad.append("sink:[%s] 汇点未拒(写到 %s)" % (name, f))
176
- except ev.EvidenceError:
177
- pass
178
- except Exception as exc: # noqa: BLE001
179
- bad.append("sink:[%s] 汇点抛了非 EvidenceError:%s: %s"
180
- % (name, type(exc).__name__, str(exc)[:60]))
181
- _reset(root)
182
- try:
183
- r = ev.import_pack(cg, _pack(pid), swarm=None)
184
- if r.get("ok") is not False or not r.get("rejected"):
185
- bad.append("accept:[%s] import 未拒收:ok=%s rejected=%s"
186
- % (name, r.get("ok"), r.get("rejected")))
187
- except Exception as exc: # noqa: BLE001
188
- bad.append("escape:[%s] import 异常逃逸:%s: %s"
189
- % (name, type(exc).__name__, str(exc)[:60]))
190
- if _victim_touched(root):
191
- bad.append("victim:[%s] 受害者 _keys/_tokens 被覆写" % name)
192
- stray = _outside_inbox(aux)
193
- if stray:
194
- bad.append("stray:收件箱外出现落点:%s" % stray[:5])
195
- for name, pid in LEGIT:
196
- _p = _pack(pid)
197
- # 夹具自证(#453 随动):G2 若用空签名包,「不误伤」会由签名闸而非
198
- # pack_id 闸决定 ⇒ 判据失去指向。先钉「夹具确实签过」,再判 pack_id 面。
199
- if not (_p.get("sig") or {}).get("signature"):
200
- bad.append("legit:[%s] 夹具未签(#453 后空签名必被拒,G2 会失去指向)"
201
- % name)
202
- continue
203
- why = ev._validate(_p)
204
- if why:
205
- bad.append("legit:[%s] 被误拒:%s" % (name, why))
206
- continue
207
- f = ev.write_pack(_p, swarm=None)["file"]
208
- if not os.path.realpath(f).startswith(os.path.realpath(ev.inbox_dir()) + os.sep):
209
- bad.append("legit:[%s] 未落在收件箱内:%s" % (name, f))
210
- r = ev.import_pack(cg, _p, swarm=None)
211
- if not (r.get("ok") is True and r.get("archived")):
212
- bad.append("legit:[%s] import 未归档:%s" % (name, r))
213
- # 显式 path 仍为调用方权限(CLI --out / MCP out 两处调用面)——不得被收窄
214
- chosen = os.path.join(t, "userchosen", "export.json")
215
- os.makedirs(os.path.dirname(chosen), exist_ok=True)
216
- ev.write_pack(_pack(LEGIT[0][1]), path=chosen, swarm=None)
217
- if not os.path.isfile(chosen):
218
- bad.append("path:显式 path 被误拦(调用方权限被收窄)")
219
- return bad
220
-
221
-
222
- def _run_one(sb, pid):
223
- """单条**恶意** pack_id 的三道闸核对;返回 (是否合规, 详情)。"""
224
- t, aux, root, cg = sb
225
- _reset(root)
226
- why = ev._validate(_pack(pid))
227
- sink = ""
228
- try:
229
- ev.write_pack(_pack(pid), swarm=None)
230
- sink = "未拦"
231
- except ev.EvidenceError:
232
- sink = "EvidenceError"
233
- except Exception as exc: # noqa: BLE001
234
- sink = "%s(非EvidenceError)" % type(exc).__name__
235
- _reset(root)
236
- try:
237
- r = ev.import_pack(cg, _pack(pid), swarm=None)
238
- imp = "拒收" if (r.get("ok") is False and r.get("rejected")) else "**放行**"
239
- except Exception as exc: # noqa: BLE001
240
- imp = "**异常逃逸 %s**" % type(exc).__name__
241
- touched = _victim_touched(root)
242
- ok = bool(why) and sink == "EvidenceError" and imp == "拒收" and not touched
243
- return ok, "validate=%s sink=%s import=%s 覆写=%s" % (
244
- "拒" if why else "**放行**", sink, imp, touched)
245
-
246
-
247
- def _run_all():
248
- global PASS, FAIL
249
- PASS = FAIL = 0
250
- del FAILS[:]
251
- sb = None
252
- try:
253
- sb = _sandbox()
254
- t, aux, root, cg = sb
255
- for name, pid in MALICIOUS:
256
- ok, det = _run_one(sb, pid)
257
- check("G1-%s 恶意 pack_id 被拒且不落盘" % name, ok, det)
258
- stray = _outside_inbox(aux)
259
- check("G1z 收件箱外零残留(磁盘证据)", not stray, stray[:4])
260
- for name, pid in LEGIT:
261
- _p = _pack(pid)
262
- signed = bool((_p.get("sig") or {}).get("signature"))
263
- why = ev._validate(_p)
264
- f = ev.write_pack(_p, swarm=None)["file"]
265
- inside = os.path.realpath(f).startswith(
266
- os.path.realpath(ev.inbox_dir()) + os.sep)
267
- r = ev.import_pack(cg, _p, swarm=None)
268
- check("G2-%s 合法 pack_id 不误伤" % name,
269
- signed and (not why) and inside and r.get("ok") is True
270
- and bool(r.get("archived")),
271
- "夹具已签=%s validate=%r 落inbox内=%s import_ok=%s"
272
- % (signed, why, inside, r.get("ok")))
273
- chosen = os.path.join(t, "userchosen", "export.json")
274
- os.makedirs(os.path.dirname(chosen), exist_ok=True)
275
- ev.write_pack(_pack(LEGIT[0][1]), path=chosen, swarm=None)
276
- check("G3 显式 path 仍为调用方权限(CLI --out / MCP out 未被收窄)",
277
- os.path.isfile(chosen), chosen)
278
- except Exception as exc: # noqa: BLE001
279
- check("判据面组异常", False, "%s: %s" % (type(exc).__name__, exc))
280
- finally:
281
- if sb:
282
- sb[3].close()
283
-
284
-
285
- # 生效条件:无入参;在三个落点各注入一次定点变异并重跑同一判据函数,逐条打印
286
- # 「变异前 → 变异后」;返回失败条数(每条变异必须让判据转红)。
287
- def _run_mutations() -> int:
288
- print(chr(10) + "=== 定点变异自证(变异前 → 变异后)===")
289
- sb = _sandbox()
290
- bad = 0
291
- try:
292
- base = _judge(sb)
293
- print(" [基线] 变异前违规项 = %s(应为空)" % (base or "无"))
294
- keep_os = ev.os
295
- keep_pidfn = ev._pack_id_error
296
-
297
- class _PathNoNorm:
298
- """代理 os.path:realpath 退化为原样返回(模拟包含性判定失效)。"""
299
-
300
- def __init__(self, real):
301
- self._real = real
302
-
303
- def __getattr__(self, k):
304
- return getattr(self._real, k)
305
-
306
- @staticmethod
307
- def realpath(p, *a, **k):
308
- return p
309
-
310
- class _OsNoNorm:
311
- """代理 os:**连带 os.path**——源码用的是 os.path.realpath,
312
- 只替 os.realpath 不会生效(本守卫首版即踩此坑,实测仍抛 EvidenceError)。"""
313
-
314
- def __init__(self, real, path_proxy):
315
- self._real = real
316
- self.path = path_proxy
317
-
318
- def __getattr__(self, k):
319
- return getattr(self._real, k)
320
-
321
- def _relax_all():
322
- ev._pack_id_error = lambda pid: ""
323
- ev.os = _OsNoNorm(keep_os, _PathNoNorm(keep_os.path))
324
-
325
- only_pidfn = lambda: setattr(ev, "_pack_id_error", lambda pid: "")
326
- #: (名, 注入, 期望**必现**的腿, 说明)——腿标见 _judge:validate/sink/accept/
327
- #: escape/victim/stray/legit/path。三条各证一道闸承重。
328
- cases = (
329
- ("M1 白名单恒放行(断言 ② 汇点兜底独立承重)",
330
- only_pidfn, "sink"),
331
- # 期望腿是 victim 而非 stray:穿越目标(memroot)在 aux 树**之外**,
332
- # _outside_inbox 只巡 aux ⇒ 只有 victim 腿能看见(首版设计漏此点)。
333
- ("M2 白名单恒放行 + realpath 兜底失效(断言受害者档被覆写)",
334
- _relax_all, "victim"),
335
- ("M3 白名单恒放行(与 M1 同注入点、观测腿不同:③ 覆盖面)",
336
- only_pidfn, "escape"),
337
- )
338
- for label, inject, want_leg in cases:
339
- try:
340
- inject()
341
- got = _judge(sb)
342
- finally:
343
- ev._pack_id_error = keep_pidfn # 复原注入点
344
- ev.os = keep_os
345
- legs = sorted({v.split(":", 1)[0] for v in got})
346
- hit = want_leg in legs
347
- if not check(label, hit, "期望腿 %r 未出现,实得腿=%s" % (want_leg, legs)):
348
- bad += 1
349
- print(" 变异前:违规项=[] | 变异后:违规项=%d 项,腿=%s | 期望腿 %r ⇒ %s"
350
- % (len(got), legs, want_leg, "命中" if hit else "未命中"))
351
- if want_leg == "victim" or want_leg == "stray":
352
- print(" 磁盘证据:%s" % [v for v in got if v.startswith(("stray", "victim"))][:2])
353
- print(" 变异自证结论:%s" % ("全部按预期转红" if bad == 0
354
- else "存在 %d 条未按预期" % bad))
355
- return bad
356
- finally:
357
- sb[3].close()
358
-
359
-
360
- def main() -> int:
361
- sys.stdout.reconfigure(encoding="utf-8", errors="replace")
362
- ap = argparse.ArgumentParser(description="#147 pack_id 穿越守卫")
363
- ap.add_argument("--mutate", action="store_true", help="定点变异自证")
364
- a = ap.parse_args()
365
- print("[1] 判据面")
366
- _run_all()
367
- rc = 1 if FAILS else 0
368
- if a.mutate:
369
- rc = 1 if (_run_mutations() or FAILS) else 0
370
- print(chr(10) + "SUMMARY: #147 pack_id 穿越守卫:%d 通过,%d 失败%s"
371
- % (PASS, FAIL, (";失败项=" + "; ".join(FAILS)) if FAILS else ""))
372
- for d in _SANDBOXES:
373
- shutil.rmtree(d, ignore_errors=True)
374
- return rc
375
-
376
-
377
- if __name__ == "__main__":
378
- sys.exit(main())
1
+ # -*- coding: utf-8 -*-
2
+ r"""#147 守卫:pack_id 一律不得逃出收件箱(路径穿越 / 覆写 _keys.json)。
3
+
4
+ 缺陷(本件修复,2026-10-11)
5
+ --------------------------
6
+ \`write_pack\` 把 \`pack_id\` **未清洗**即拼进归档路径(缺省分支);
7
+ \`_validate\` 也不校验 pack_id ⇒ 带 \`../\` 的 pack_id 可穿越出收件箱。
8
+ 实测(tempfile 沙箱):\`pack_id = '../../../../../memroot/_keys'\` 经
9
+ \`import_pack(archive=True)\` **一次即覆写** \`_keys.json\` 与 \`_tokens.json\`
10
+ (返回 \`ok=True / archived=memroot\_keys.json\`);\`pack_id\` 带空字节时
11
+ \`ValueError\` 还会**逸出** import_pack(原 except 只捕 OSError)。
12
+
13
+ 三道闸(本守卫逐条钉)
14
+ ---------------------
15
+ ① \`_validate\` pack_id 白名单(ASCII 字母数字与 . _ -;拒 ..、前导点、超长)
16
+ ② \`write_pack\` 汇点兜底:同源白名单 + realpath 包含性 → 一律 \`EvidenceError\`
17
+ ③ \`import_pack\` 归档 except 扩到 \`EvidenceError\`(不逃逸)
18
+
19
+ **磁盘证据优先**:不止断言「抛异常/拒收」,还断言**没有文件落在收件箱之外**
20
+ 且受害者档未被覆写——M2 变异正是靠这条磁盘腿转红。
21
+
22
+ 运行:python -X utf8 -m md_cg.test_issue147_pack_id_escape
23
+ python -X utf8 -m md_cg.test_issue147_pack_id_escape --mutate
24
+ 退出码:0 全绿 / 1 有失败
25
+ """
26
+ from __future__ import annotations
27
+
28
+ import argparse
29
+ import io
30
+ import json
31
+ import os
32
+ import shutil
33
+ import sys
34
+ import tempfile
35
+ import time
36
+
37
+ from . import evidence as ev
38
+ from .mdcos import MdCGOS
39
+
40
+ PASS = FAIL = 0
41
+ FAILS = []
42
+ _SANDBOXES = []
43
+
44
+ #: 恶意 pack_id 矩阵:(名, 值)——覆盖 穿越/绝对/盘符/UNC/空字节/点形/超长/类型
45
+ MALICIOUS = (
46
+ ("穿越(glued)", "../../../../../memroot/_keys"),
47
+ ("穿越(slash)", "/../../../../memroot/_keys"),
48
+ ("穿越(_tokens)", "/../../../../memroot/_tokens"),
49
+ ("反斜杠穿越", "..\\..\\memroot\\_keys"),
50
+ ("纯 ..", ".."),
51
+ ("单点", "."),
52
+ ("前导点", ".hidden"),
53
+ ("绝对路径", "/tmp/evil"),
54
+ ("盘符", "C:/evil"),
55
+ ("UNC", "\\\\srv\\share\\evil"),
56
+ ("空字节", "bad\x00id"),
57
+ ("超长", "p" * (ev.PACK_ID_MAX + 1)),
58
+ ("非字符串", 123),
59
+ ("缺失", None),
60
+ )
61
+ #: 合法 pack_id(导出面真实形态,见 export_pack:pack-<12hex>)
62
+ LEGIT = (("导出形", "pack-a1b2c3d4e5f6"), ("含点横线", "pack-1.2_x-3"))
63
+
64
+ SENT = '{"victim": "ORIGINAL"}'
65
+
66
+
67
+ def check(name, cond, detail=""):
68
+ global PASS, FAIL
69
+ if cond:
70
+ PASS += 1
71
+ print(" [PASS] %s%s" % (name, (" · " + str(detail)) if detail else ""))
72
+ else:
73
+ FAIL += 1
74
+ FAILS.append(name)
75
+ print(" [FAIL] %s · %s" % (name, detail))
76
+ return bool(cond)
77
+
78
+
79
+ # 生效条件:无入参;建 tempfile 沙箱(auxroot/memroot 两目录 + 策略档 + env),
80
+ # 返回 (T, AUX, ROOT, cg)。注意目录名不能取 "aux"——Windows 保留设备名。
81
+ def _sandbox():
82
+ t = tempfile.mkdtemp(prefix="i147_guard_")
83
+ _SANDBOXES.append(t)
84
+ aux, root = os.path.join(t, "auxroot"), os.path.join(t, "memroot")
85
+ for d in (aux, root):
86
+ os.makedirs(d, exist_ok=True)
87
+ os.environ.update(MDCG_AUX_ROOT=aux, MDCG_ROOT=root, MDCG_NODE_ID="node-self",
88
+ MDCG_MASTER_KEY=os.urandom(32).hex())
89
+ # **必须显式设 MDCG_SWARM_DIR**:`evidence.DEFAULT_SWARM_DIR` 在**模块导入时**
90
+ # 由 aux_root() 冻结,而本守卫是模块顶层 `import evidence` ⇒ 只设 MDCG_AUX_ROOT
91
+ # 不生效,归档会落到**真实** aux 目录(本守卫首版即踩此坑:实测污染了
92
+ # `~/.mdcg/swarm/inbox` 并在家目录下留下穿越产物 `~/memroot`,
93
+ # 已逐项核对清理——见 _team/iss147/report.md「探针污染」节)。
94
+ # ⚠ 本机绝对路径不得写进追踪面(check_local_paths 硬门禁),故此处用中性占位。
95
+ # `swarm_dir()` 在**调用时**读该环境变量,故这是唯一有效的沙箱开关。
96
+ os.environ["MDCG_SWARM_DIR"] = os.path.join(aux, "swarm")
97
+ pol = os.path.join(t, "policy.json")
98
+ io.open(pol, "w", encoding="utf-8").write(
99
+ json.dumps({"forbidden": [], "required": []}))
100
+ os.environ["MDCG_POLICY_FILE"] = pol
101
+ # #453(SEC·P1)同批随动:`import_pack` 现为 fail-closed(空签名一律拒)。
102
+ # 本守卫的 G2「合法 pack_id 不误伤」需要一个**真签得出来**的合法包,故在沙箱里
103
+ # 声明子系统策略(要求对端签名)并把密钥/策略文件都指进沙箱——不碰真实 aux。
104
+ sigfile = os.path.join(t, "signers.json")
105
+ io.open(sigfile, "w", encoding="utf-8").write(json.dumps({
106
+ "schema": 1, "default_signer": "hmac-local",
107
+ "subsystems": {ev.SUBSYSTEM: {
108
+ "signer": "hmac-local", "sign_on": ["handshake", "evidence"],
109
+ "require_peer_signature": True, "on_verify_fail": "reject"}}}))
110
+ os.environ["MDCG_SIGNERS_FILE"] = sigfile
111
+ os.environ["MDCG_SIGNER_KEY_FILE"] = os.path.join(t, "signer.key")
112
+ # fail-closed:沙箱没生效就**拒跑**,绝不在真实 aux 目录上做攻击面验证。
113
+ inbox = os.path.realpath(ev.inbox_dir())
114
+ if not inbox.startswith(os.path.realpath(t) + os.sep):
115
+ raise RuntimeError(
116
+ "沙箱未生效:收件箱 %s 不在 tempfile 沙箱 %s 内——拒绝运行" % (inbox, t))
117
+ return t, aux, root, MdCGOS(root)
118
+
119
+
120
+ def _pack(pid):
121
+ # #453(SEC·P1,同批随动):`import_pack` 现为 **fail-closed:空签名一律拒收**
122
+ # (不看 `sig.signer`/`sig.signed` 等对端自报值)。本守卫的合法夹具原先用
123
+ # `{"signer":"null","signature":"","signed":False}` 冒充「合法包」——那条通道
124
+ # 正是 #453 要关掉的免签名通行证,故夹具必须带**真签名**,否则 G2 的
125
+ # 「合法 pack_id 不误伤」会被签名闸(而非 pack_id 闸)打红。
126
+ # 判据强度**不降**:G2 仍断言 `ok is True and archived`,并新增 `sig` 非空断言
127
+ # (见 _run_all),把「夹具确实签过」也钉住。
128
+ p = {"kind": ev.KIND, "schema": ev.SCHEMA, "from_node": "attacker",
129
+ "pack_id": pid, "created_at": time.time(),
130
+ "items": [{"subject": "s", "text": "t", "sensitivity": "internal"}]}
131
+ s = ev._signer.sign_for(ev.SUBSYSTEM, ev._pack_payload(p),
132
+ action=ev.SIGN_ACTION)
133
+ p["sig"] = {"signer": s.get("signer"),
134
+ "signature": s.get("signature") or "",
135
+ "signed": bool(s.get("signed"))}
136
+ return p
137
+
138
+
139
+ def _reset(root):
140
+ for p in (os.path.join(root, "_keys.json"), os.path.join(root, "_tokens.json")):
141
+ io.open(p, "w", encoding="utf-8").write(SENT)
142
+
143
+
144
+ def _victim_touched(root):
145
+ for p in (os.path.join(root, "_keys.json"), os.path.join(root, "_tokens.json")):
146
+ if io.open(p, encoding="utf-8").read() != SENT:
147
+ return True
148
+ return False
149
+
150
+
151
+ def _outside_inbox(aux):
152
+ """收件箱之外(整个 aux 树里)的落点——磁盘证据腿。"""
153
+ inbox = os.path.realpath(ev.inbox_dir())
154
+ out = []
155
+ for dp, _dn, fns in os.walk(aux):
156
+ for f in fns:
157
+ p = os.path.realpath(os.path.join(dp, f))
158
+ if p != inbox and not p.startswith(inbox + os.sep):
159
+ out.append(os.path.relpath(p, aux).replace("\\", "/"))
160
+ return sorted(out)
161
+
162
+
163
+ # 生效条件:入参为 (_sandbox() 的四元组);逐条跑恶意/合法矩阵与显式 path 面,
164
+ # 返回违规描述列表(空列表=全合规)。**判据单点**——变异打在其依赖的模块属性上。
165
+ def _judge(sb) -> list:
166
+ t, aux, root, cg = sb
167
+ bad = []
168
+ for name, pid in MALICIOUS:
169
+ _reset(root)
170
+ why = ev._validate(_pack(pid))
171
+ if not why:
172
+ bad.append("validate:[%s] 放行了非法 pack_id %r" % (name, pid))
173
+ try:
174
+ f = ev.write_pack(_pack(pid), swarm=None)["file"]
175
+ bad.append("sink:[%s] 汇点未拒(写到 %s)" % (name, f))
176
+ except ev.EvidenceError:
177
+ pass
178
+ except Exception as exc: # noqa: BLE001
179
+ bad.append("sink:[%s] 汇点抛了非 EvidenceError:%s: %s"
180
+ % (name, type(exc).__name__, str(exc)[:60]))
181
+ _reset(root)
182
+ try:
183
+ r = ev.import_pack(cg, _pack(pid), swarm=None)
184
+ if r.get("ok") is not False or not r.get("rejected"):
185
+ bad.append("accept:[%s] import 未拒收:ok=%s rejected=%s"
186
+ % (name, r.get("ok"), r.get("rejected")))
187
+ except Exception as exc: # noqa: BLE001
188
+ bad.append("escape:[%s] import 异常逃逸:%s: %s"
189
+ % (name, type(exc).__name__, str(exc)[:60]))
190
+ if _victim_touched(root):
191
+ bad.append("victim:[%s] 受害者 _keys/_tokens 被覆写" % name)
192
+ stray = _outside_inbox(aux)
193
+ if stray:
194
+ bad.append("stray:收件箱外出现落点:%s" % stray[:5])
195
+ for name, pid in LEGIT:
196
+ _p = _pack(pid)
197
+ # 夹具自证(#453 随动):G2 若用空签名包,「不误伤」会由签名闸而非
198
+ # pack_id 闸决定 ⇒ 判据失去指向。先钉「夹具确实签过」,再判 pack_id 面。
199
+ if not (_p.get("sig") or {}).get("signature"):
200
+ bad.append("legit:[%s] 夹具未签(#453 后空签名必被拒,G2 会失去指向)"
201
+ % name)
202
+ continue
203
+ why = ev._validate(_p)
204
+ if why:
205
+ bad.append("legit:[%s] 被误拒:%s" % (name, why))
206
+ continue
207
+ f = ev.write_pack(_p, swarm=None)["file"]
208
+ if not os.path.realpath(f).startswith(os.path.realpath(ev.inbox_dir()) + os.sep):
209
+ bad.append("legit:[%s] 未落在收件箱内:%s" % (name, f))
210
+ r = ev.import_pack(cg, _p, swarm=None)
211
+ if not (r.get("ok") is True and r.get("archived")):
212
+ bad.append("legit:[%s] import 未归档:%s" % (name, r))
213
+ # 显式 path 仍为调用方权限(CLI --out / MCP out 两处调用面)——不得被收窄
214
+ chosen = os.path.join(t, "userchosen", "export.json")
215
+ os.makedirs(os.path.dirname(chosen), exist_ok=True)
216
+ ev.write_pack(_pack(LEGIT[0][1]), path=chosen, swarm=None)
217
+ if not os.path.isfile(chosen):
218
+ bad.append("path:显式 path 被误拦(调用方权限被收窄)")
219
+ return bad
220
+
221
+
222
+ def _run_one(sb, pid):
223
+ """单条**恶意** pack_id 的三道闸核对;返回 (是否合规, 详情)。"""
224
+ t, aux, root, cg = sb
225
+ _reset(root)
226
+ why = ev._validate(_pack(pid))
227
+ sink = ""
228
+ try:
229
+ ev.write_pack(_pack(pid), swarm=None)
230
+ sink = "未拦"
231
+ except ev.EvidenceError:
232
+ sink = "EvidenceError"
233
+ except Exception as exc: # noqa: BLE001
234
+ sink = "%s(非EvidenceError)" % type(exc).__name__
235
+ _reset(root)
236
+ try:
237
+ r = ev.import_pack(cg, _pack(pid), swarm=None)
238
+ imp = "拒收" if (r.get("ok") is False and r.get("rejected")) else "**放行**"
239
+ except Exception as exc: # noqa: BLE001
240
+ imp = "**异常逃逸 %s**" % type(exc).__name__
241
+ touched = _victim_touched(root)
242
+ ok = bool(why) and sink == "EvidenceError" and imp == "拒收" and not touched
243
+ return ok, "validate=%s sink=%s import=%s 覆写=%s" % (
244
+ "拒" if why else "**放行**", sink, imp, touched)
245
+
246
+
247
+ def _run_all():
248
+ global PASS, FAIL
249
+ PASS = FAIL = 0
250
+ del FAILS[:]
251
+ sb = None
252
+ try:
253
+ sb = _sandbox()
254
+ t, aux, root, cg = sb
255
+ for name, pid in MALICIOUS:
256
+ ok, det = _run_one(sb, pid)
257
+ check("G1-%s 恶意 pack_id 被拒且不落盘" % name, ok, det)
258
+ stray = _outside_inbox(aux)
259
+ check("G1z 收件箱外零残留(磁盘证据)", not stray, stray[:4])
260
+ for name, pid in LEGIT:
261
+ _p = _pack(pid)
262
+ signed = bool((_p.get("sig") or {}).get("signature"))
263
+ why = ev._validate(_p)
264
+ f = ev.write_pack(_p, swarm=None)["file"]
265
+ inside = os.path.realpath(f).startswith(
266
+ os.path.realpath(ev.inbox_dir()) + os.sep)
267
+ r = ev.import_pack(cg, _p, swarm=None)
268
+ check("G2-%s 合法 pack_id 不误伤" % name,
269
+ signed and (not why) and inside and r.get("ok") is True
270
+ and bool(r.get("archived")),
271
+ "夹具已签=%s validate=%r 落inbox内=%s import_ok=%s"
272
+ % (signed, why, inside, r.get("ok")))
273
+ chosen = os.path.join(t, "userchosen", "export.json")
274
+ os.makedirs(os.path.dirname(chosen), exist_ok=True)
275
+ ev.write_pack(_pack(LEGIT[0][1]), path=chosen, swarm=None)
276
+ check("G3 显式 path 仍为调用方权限(CLI --out / MCP out 未被收窄)",
277
+ os.path.isfile(chosen), chosen)
278
+ except Exception as exc: # noqa: BLE001
279
+ check("判据面组异常", False, "%s: %s" % (type(exc).__name__, exc))
280
+ finally:
281
+ if sb:
282
+ sb[3].close()
283
+
284
+
285
+ # 生效条件:无入参;在三个落点各注入一次定点变异并重跑同一判据函数,逐条打印
286
+ # 「变异前 → 变异后」;返回失败条数(每条变异必须让判据转红)。
287
+ def _run_mutations() -> int:
288
+ print(chr(10) + "=== 定点变异自证(变异前 → 变异后)===")
289
+ sb = _sandbox()
290
+ bad = 0
291
+ try:
292
+ base = _judge(sb)
293
+ print(" [基线] 变异前违规项 = %s(应为空)" % (base or "无"))
294
+ keep_os = ev.os
295
+ keep_pidfn = ev._pack_id_error
296
+
297
+ class _PathNoNorm:
298
+ """代理 os.path:realpath 退化为原样返回(模拟包含性判定失效)。"""
299
+
300
+ def __init__(self, real):
301
+ self._real = real
302
+
303
+ def __getattr__(self, k):
304
+ return getattr(self._real, k)
305
+
306
+ @staticmethod
307
+ def realpath(p, *a, **k):
308
+ return p
309
+
310
+ class _OsNoNorm:
311
+ """代理 os:**连带 os.path**——源码用的是 os.path.realpath,
312
+ 只替 os.realpath 不会生效(本守卫首版即踩此坑,实测仍抛 EvidenceError)。"""
313
+
314
+ def __init__(self, real, path_proxy):
315
+ self._real = real
316
+ self.path = path_proxy
317
+
318
+ def __getattr__(self, k):
319
+ return getattr(self._real, k)
320
+
321
+ def _relax_all():
322
+ ev._pack_id_error = lambda pid: ""
323
+ ev.os = _OsNoNorm(keep_os, _PathNoNorm(keep_os.path))
324
+
325
+ only_pidfn = lambda: setattr(ev, "_pack_id_error", lambda pid: "")
326
+ #: (名, 注入, 期望**必现**的腿, 说明)——腿标见 _judge:validate/sink/accept/
327
+ #: escape/victim/stray/legit/path。三条各证一道闸承重。
328
+ cases = (
329
+ ("M1 白名单恒放行(断言 ② 汇点兜底独立承重)",
330
+ only_pidfn, "sink"),
331
+ # 期望腿是 victim 而非 stray:穿越目标(memroot)在 aux 树**之外**,
332
+ # _outside_inbox 只巡 aux ⇒ 只有 victim 腿能看见(首版设计漏此点)。
333
+ ("M2 白名单恒放行 + realpath 兜底失效(断言受害者档被覆写)",
334
+ _relax_all, "victim"),
335
+ ("M3 白名单恒放行(与 M1 同注入点、观测腿不同:③ 覆盖面)",
336
+ only_pidfn, "escape"),
337
+ )
338
+ for label, inject, want_leg in cases:
339
+ try:
340
+ inject()
341
+ got = _judge(sb)
342
+ finally:
343
+ ev._pack_id_error = keep_pidfn # 复原注入点
344
+ ev.os = keep_os
345
+ legs = sorted({v.split(":", 1)[0] for v in got})
346
+ hit = want_leg in legs
347
+ if not check(label, hit, "期望腿 %r 未出现,实得腿=%s" % (want_leg, legs)):
348
+ bad += 1
349
+ print(" 变异前:违规项=[] | 变异后:违规项=%d 项,腿=%s | 期望腿 %r ⇒ %s"
350
+ % (len(got), legs, want_leg, "命中" if hit else "未命中"))
351
+ if want_leg == "victim" or want_leg == "stray":
352
+ print(" 磁盘证据:%s" % [v for v in got if v.startswith(("stray", "victim"))][:2])
353
+ print(" 变异自证结论:%s" % ("全部按预期转红" if bad == 0
354
+ else "存在 %d 条未按预期" % bad))
355
+ return bad
356
+ finally:
357
+ sb[3].close()
358
+
359
+
360
+ def main() -> int:
361
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
362
+ ap = argparse.ArgumentParser(description="#147 pack_id 穿越守卫")
363
+ ap.add_argument("--mutate", action="store_true", help="定点变异自证")
364
+ a = ap.parse_args()
365
+ print("[1] 判据面")
366
+ _run_all()
367
+ rc = 1 if FAILS else 0
368
+ if a.mutate:
369
+ rc = 1 if (_run_mutations() or FAILS) else 0
370
+ print(chr(10) + "SUMMARY: #147 pack_id 穿越守卫:%d 通过,%d 失败%s"
371
+ % (PASS, FAIL, (";失败项=" + "; ".join(FAILS)) if FAILS else ""))
372
+ for d in _SANDBOXES:
373
+ shutil.rmtree(d, ignore_errors=True)
374
+ return rc
375
+
376
+
377
+ if __name__ == "__main__":
378
+ sys.exit(main())