@furongjun1999/dsh-memory 0.9.6 → 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (216) hide show
  1. package/data/policy.json +38 -38
  2. package/docs/discipline/templates/spec.txt.tmpl +1 -1
  3. package/dsh/cordis.yml.example +139 -139
  4. package/lib/hooks.d.ts +19 -0
  5. package/lib/hooks.js +29 -6
  6. package/lib/index.js +11 -2
  7. package/lib/lib/hook_audit.js +38 -2
  8. package/lib/lib/prompt_safety.js +14 -3
  9. package/lib/tools.d.ts +7 -0
  10. package/lib/tools.js +22 -1
  11. package/md_cg/_guard_kit.py +121 -121
  12. package/md_cg/anchor.py +114 -114
  13. package/md_cg/audit.py +15 -2
  14. package/md_cg/chain.py +3 -2
  15. package/md_cg/config_registry_guard.py +487 -487
  16. package/md_cg/conformance.py +747 -747
  17. package/md_cg/consolidate.py +1793 -1793
  18. package/md_cg/crypto.py +794 -794
  19. package/md_cg/hyperedge.py +262 -262
  20. package/md_cg/interface_schema.py +146 -146
  21. package/md_cg/lifecycle.py +426 -426
  22. package/md_cg/mdcos.py +12 -8
  23. package/md_cg/predict.py +1103 -1103
  24. package/md_cg/protect.py +654 -654
  25. package/md_cg/provenance.py +606 -606
  26. package/md_cg/queue_health.py +130 -130
  27. package/md_cg/refine.py +613 -613
  28. package/md_cg/retrieve.py +128 -128
  29. package/md_cg/revise.py +140 -140
  30. package/md_cg/rollback.py +657 -657
  31. package/md_cg/rollback_cli.py +124 -124
  32. package/md_cg/rotate.py +346 -346
  33. package/md_cg/routing.py +490 -490
  34. package/md_cg/self_surface.py +50 -50
  35. package/md_cg/semantic/canonical.py +144 -144
  36. package/md_cg/semantic/zh_en_atoms.py +141 -141
  37. package/md_cg/sources.py +1091 -1091
  38. package/md_cg/stg.py +3 -2
  39. package/md_cg/test_audit_rotate_parity.py +279 -279
  40. package/md_cg/test_autonomy_modes.py +2013 -2013
  41. package/md_cg/test_cn_recall_grams.py +206 -206
  42. package/md_cg/test_code_kind_forbidden.py +101 -0
  43. package/md_cg/test_condaccept.py +156 -156
  44. package/md_cg/test_condgate.py +141 -141
  45. package/md_cg/test_heartbeat_ledger.py +557 -557
  46. package/md_cg/test_i50e_readside_protection.py +658 -658
  47. package/md_cg/test_issue111_gate_order.py +76 -76
  48. package/md_cg/test_issue111_scoring_contract.py +86 -86
  49. package/md_cg/test_issue121_calibration_bounds.py +293 -293
  50. package/md_cg/test_issue145_sleep_no_silent_rollback.py +167 -167
  51. package/md_cg/test_issue147_pack_id_escape.py +378 -378
  52. package/md_cg/test_issue148_merge_downgrade_leak.py +192 -192
  53. package/md_cg/test_issue149_accel_default_face.py +248 -248
  54. package/md_cg/test_issue150_empty_query_terms.py +328 -328
  55. package/md_cg/test_issue151_153_157_write_cache_index.py +151 -151
  56. package/md_cg/test_issue152_sealed_postings.py +309 -309
  57. package/md_cg/test_issue153b_index_generation_invalidation.py +142 -142
  58. package/md_cg/test_issue157b_index_remainder.py +344 -344
  59. package/md_cg/test_issue189_conclusion_bidirectional.py +223 -223
  60. package/md_cg/test_issue191_import_trust.py +382 -382
  61. package/md_cg/test_issue193_write_scope.py +378 -378
  62. package/md_cg/test_issue212_writeface_gaps.py +349 -349
  63. package/md_cg/test_issue214_reject_sensitivity.py +266 -266
  64. package/md_cg/test_issue215_condition_source_gap.py +272 -272
  65. package/md_cg/test_issue216_clash_routes.py +214 -214
  66. package/md_cg/test_issue217_slot_routes.py +248 -248
  67. package/md_cg/test_issue218_postcondition_value_blind.py +222 -222
  68. package/md_cg/test_issue258_pack_sensitivity.py +468 -468
  69. package/md_cg/test_issue265_coldverify_multiproc.py +438 -438
  70. package/md_cg/test_issue274_read_node_id_none.py +341 -341
  71. package/md_cg/test_issue275_layer_param.py +250 -250
  72. package/md_cg/test_issue277_node_id_traversal.py +384 -384
  73. package/md_cg/test_issue278_neg_separated_tension.py +271 -271
  74. package/md_cg/test_issue278_neg_window.py +294 -294
  75. package/md_cg/test_issue278_negative_layering.py +83 -83
  76. package/md_cg/test_issue284_skip_not_pass.py +291 -291
  77. package/md_cg/test_issue294_flywheel_sensitivity.py +573 -573
  78. package/md_cg/test_issue301_baseline_corpus_gate.py +245 -245
  79. package/md_cg/test_issue303_design_boundaries.py +262 -262
  80. package/md_cg/test_issue315_merge_branch_sensitivity.py +383 -383
  81. package/md_cg/test_issue319_tenant_unregistered_bypass.py +256 -256
  82. package/md_cg/test_issue321_mcp_deep_json.py +304 -304
  83. package/md_cg/test_issue322_node_write_lock.py +727 -727
  84. package/md_cg/test_issue324_write_size_fields.py +214 -214
  85. package/md_cg/test_issue325_audit_poison.py +229 -229
  86. package/md_cg/test_issue326_ingest_auto_whitelist.py +331 -331
  87. package/md_cg/test_issue326_key_perms.py +355 -355
  88. package/md_cg/test_issue326_twin_parser_parity.py +323 -323
  89. package/md_cg/test_issue326_vm_call_frame.py +569 -569
  90. package/md_cg/test_issue345_writelimit_effective_sens.py +233 -233
  91. package/md_cg/test_issue346_overwrite_sensitivity_gate.py +424 -424
  92. package/md_cg/test_issue348_insight_verify_op.py +199 -199
  93. package/md_cg/test_issue348_merge_rmw_lock.py +345 -345
  94. package/md_cg/test_issue350_casefold_collision.py +235 -235
  95. package/md_cg/test_issue351_ingest_root_fallback.py +201 -201
  96. package/md_cg/test_issue352_imgaudit.py +418 -418
  97. package/md_cg/test_issue352_pathsjson.py +537 -537
  98. package/md_cg/test_issue352_refindex.py +412 -412
  99. package/md_cg/test_issue352_rollback.py +604 -604
  100. package/md_cg/test_issue354_p2_writelimit_toctou.py +327 -327
  101. package/md_cg/test_issue354_rust_index_containment.py +571 -571
  102. package/md_cg/test_issue354_rust_wal_containment.py +606 -606
  103. package/md_cg/test_issue358_truncation_observable.py +247 -247
  104. package/md_cg/test_issue360_tidy_private_excerpt.py +195 -195
  105. package/md_cg/test_issue361_blindspot_not_silent_drop.py +494 -494
  106. package/md_cg/test_issue362_neg_condition.py +468 -468
  107. package/md_cg/test_issue363_lexical_idf.py +275 -275
  108. package/md_cg/test_issue370_readcache_assembly.py +488 -488
  109. package/md_cg/test_issue376_heartbeat_failed.py +293 -293
  110. package/md_cg/test_issue377_layer_protect_stamp.py +324 -324
  111. package/md_cg/test_issue378_protected_floor.py +310 -310
  112. package/md_cg/test_issue383_state_event_write_gate.py +462 -462
  113. package/md_cg/test_issue397_sens_eff_wiring.py +435 -435
  114. package/md_cg/test_issue398_toolface_op_parity.py +511 -511
  115. package/md_cg/test_issue399_hive_json_shape.py +317 -317
  116. package/md_cg/test_issue401_wisdom_codegen.py +295 -295
  117. package/md_cg/test_issue404_heal_receipt.py +389 -389
  118. package/md_cg/test_issue409_compact_index_completeness.py +509 -509
  119. package/md_cg/test_issue410_verify_demote_write.py +366 -366
  120. package/md_cg/test_issue411_scrub_idempotence.py +575 -575
  121. package/md_cg/test_issue412_discipline_producer_parity.py +311 -311
  122. package/md_cg/test_issue413_preimage_failclosed.py +239 -239
  123. package/md_cg/test_issue413_preimage_twin.py +339 -339
  124. package/md_cg/test_issue415_deps_gate_probe.py +357 -357
  125. package/md_cg/test_issue416_entry_key_subset.py +525 -525
  126. package/md_cg/test_issue417_twophase_merge_landed.py +423 -423
  127. package/md_cg/test_issue425_ingest_library_path.py +331 -331
  128. package/md_cg/test_issue426c_enqueue_not_silent.py +346 -346
  129. package/md_cg/test_issue426e_restore_overwrite_live.py +310 -310
  130. package/md_cg/test_issue426f_paths_gbk_failclosed.py +301 -301
  131. package/md_cg/test_issue427_serve_status_shape.py +191 -191
  132. package/md_cg/test_issue431_432_468_protect_single_point.py +322 -322
  133. package/md_cg/test_issue433_outlook_threshold_single_point.py +278 -278
  134. package/md_cg/test_issue434_435_float_gate.py +90 -90
  135. package/md_cg/test_issue439_sibling_sensitivity_inherit.py +448 -448
  136. package/md_cg/test_issue43_default_policy.py +874 -874
  137. package/md_cg/test_issue444_scrub_evidence_plaintext.py +281 -281
  138. package/md_cg/test_issue445_metacognition_ledger_gate.py +454 -454
  139. package/md_cg/test_issue446_453_403_verified_evidence.py +382 -382
  140. package/md_cg/test_issue450_sensitivity_fallback_reason.py +51 -51
  141. package/md_cg/test_issue450_writegate_unknown_sens.py +203 -203
  142. package/md_cg/test_issue451_audit_actor.py +313 -313
  143. package/md_cg/test_issue452_ingest_root_sensitivity.py +299 -299
  144. package/md_cg/test_issue463_ghost_prune_guard.py +259 -259
  145. package/md_cg/test_issue466_basis_registry.py +469 -469
  146. package/md_cg/test_issue467_identity_sensitivity_parity.py +360 -360
  147. package/md_cg/test_issue469_scrub_override_passthrough.py +126 -126
  148. package/md_cg/test_issue470_wal_event_durable.py +427 -427
  149. package/md_cg/test_issue471_identity_readable.py +136 -136
  150. package/md_cg/test_issue472_audit_chain.py +90 -90
  151. package/md_cg/test_issue472_prune_ledger.py +105 -105
  152. package/md_cg/test_issue472_rollback_degraded.py +81 -81
  153. package/md_cg/test_issue491_compose_sandbox.py +460 -460
  154. package/md_cg/test_issue498_merge_trace_stale_index.py +280 -280
  155. package/md_cg/test_issue511_scoreboard_bad_files.py +256 -256
  156. package/md_cg/test_issue521_rotate_lock_suffix.py +110 -110
  157. package/md_cg/test_issue524_orphan_noise_no_demote.py +88 -88
  158. package/md_cg/test_issue525_read_null_semantics.py +52 -52
  159. package/md_cg/test_issue547_append_jsonl_whitelist.py +114 -114
  160. package/md_cg/test_issue547_audit_durable.py +96 -96
  161. package/md_cg/test_issue557_r2_write_entries_size_gate.py +83 -83
  162. package/md_cg/test_issue559_refine_prefix.py +69 -69
  163. package/md_cg/test_issue562_retired_faces.py +150 -0
  164. package/md_cg/test_issue71_queue_backlog.py +376 -376
  165. package/md_cg/test_issue72_coldverify_controlled_drain.py +420 -420
  166. package/md_cg/test_issue82_credential_rules.py +271 -271
  167. package/md_cg/test_issue91_verifier_sandbox.py +314 -314
  168. package/md_cg/test_issue93_remember_redaction.py +282 -282
  169. package/md_cg/test_logref.py +1141 -1141
  170. package/md_cg/test_md_access_parity.py +330 -330
  171. package/md_cg/test_md_cg_no_hive_dep.py +139 -139
  172. package/md_cg/test_mutation_residue.py +119 -119
  173. package/md_cg/test_mutation_rollback.py +835 -835
  174. package/md_cg/test_n123_derive_expiry_chain.py +210 -210
  175. package/md_cg/test_n209_verify_write_face_gates.py +466 -466
  176. package/md_cg/test_n62_tenant_bind_failclosed.py +200 -200
  177. package/md_cg/test_neg_tail_honesty.py +733 -733
  178. package/md_cg/test_p21_tokens.py +294 -294
  179. package/md_cg/test_p27_docindex.py +792 -792
  180. package/md_cg/test_p28_refcheck.py +1053 -1053
  181. package/md_cg/test_p2_six_elements.py +476 -476
  182. package/md_cg/test_p33_ccg_wiring.py +300 -300
  183. package/md_cg/test_p3_legacy_closure.py +438 -438
  184. package/md_cg/test_p40_refine_worklist.py +244 -244
  185. package/md_cg/test_p4_freshness.py +781 -781
  186. package/md_cg/test_p9c_dedup_hints.py +288 -288
  187. package/md_cg/test_policy_required_ccg.py +444 -444
  188. package/md_cg/test_retr_s5.py +312 -312
  189. package/md_cg/test_s1_ast_judge.py +109 -109
  190. package/md_cg/test_state_event_op.py +521 -521
  191. package/md_cg/test_stgidx_index_parity.py +1024 -1024
  192. package/md_cg/test_sustain_bounded.py +652 -652
  193. package/md_cg/test_trust_edge_reachability.py +405 -405
  194. package/md_cg/test_w7_redlines.py +659 -659
  195. package/md_cg/test_write_return_shape.py +919 -919
  196. package/md_cg/test_writepipe.py +228 -228
  197. package/md_cg/trust.py +1114 -1114
  198. package/md_cg/twophase.py +303 -303
  199. package/md_cg/whitebox.py +536 -536
  200. package/md_cg/whitebox_kb/wisdom/compose_engine.py +1634 -1634
  201. package/md_cg/whitebox_kb/wisdom/core/condition_vm.py +318 -318
  202. package/md_cg/whitebox_kb/wisdom/core/parser.py +1082 -1082
  203. package/md_cg/whitebox_kb/wisdom/md_access.py +490 -490
  204. package/md_cg/whitebox_kb/wisdom/migrate_wisdom.py +497 -497
  205. package/md_cg/whitebox_kb/wisdom/mini_python.py +995 -995
  206. package/md_cg/whitebox_kb/wisdom/net_units.py +2900 -2900
  207. package/md_cg/whitebox_kb/wisdom/semantic_translate.py +4060 -4060
  208. package/md_cg/writepipe.py +1337 -1337
  209. package/package.json +3 -2
  210. package/scripts/workspace_index.py +328 -0
  211. package/src/hooks.ts +30 -6
  212. package/src/index.ts +14 -5
  213. package/src/lib/hook_audit.ts +282 -256
  214. package/src/lib/mdcg_client.ts +469 -469
  215. package/src/lib/prompt_safety.ts +17 -3
  216. package/src/tools.ts +23 -1
@@ -1,140 +1,140 @@
1
- # -*- coding: utf-8 -*-
2
- # 功能名:md_cg 生产码不得依赖 hive(依赖方向单向:外围→核心)
3
- # 生效条件:python -u -X utf8 -m md_cg.test_md_cg_no_hive_dep;扫描面 = md_cg/**/*.py 的 AST import(取自文件实际文本)
4
- # 子功能:P 生产面禁止 import hive · T 测试面允许但必须落在显式登记表内(双向:登记了却不存在即红)· S 自检(真造反例证明本腿能红)
5
- # 执行:直接跑;退出码 0=全绿、1=有红
6
- # 验证方式:全部 PASS;S 段在临时区真造一份 import hive 的 md_cg 生产文件,断言判据转红
7
- # 不适用条件:不判 hive 侧反向依赖 md_cg(那是允许方向,实测生产 3 件);不判 md_cg 内部子包之间的依赖;不判动态 import(getattr/__import__ 形式不在 AST 的 Import/ImportFrom 面内)
8
- """C1 落腿:**md_cg 生产码不得 `import hive`**。
9
-
10
- 出口(why):依赖方向必须单向 —— **外围(hive / 各端 / scripts)可依赖核心(md_cg),核心不得依赖外围**。
11
- 若核心反向依赖外围,则「核心」不再可独立验证:
12
- · 验证 md_cg 时要先拉起 hive(**T5 独立验证**失效:验证者与被验证者共享同一依赖面);
13
- · md_cg 单独发布/单测时会被 hive 的可变性拖住(**A1 真源唯一**在工程上落成「依赖也单向」)。
14
-
15
- **该规则出自 #465 的会话裁定**(本会话裁定「hive 侧新建 hive/_append.py,**不得反向依赖 md_cg**」,
16
- 并已实测 hive→md_cg 生产 3 件存在、md_cg→hive 生产 0 件)。**在此之前它只是一句会话里的约定、无任何判据载体**;
17
- 本件把它落成载体(这是 `docs/theory/形态×定理映射_v0.1.md` 第三节 **C1** 的兑现)。
18
-
19
- ★两面分开(否则要么误红、要么过度收紧):
20
- · **生产面**(文件名不以 `test_` 开头)⇒ **禁止** import hive;
21
- · **测试面**(`test_*.py`)⇒ **允许**反向引用(用 hive 的产物做夹具是正当用法),但必须落在下方的
22
- `ALLOWED_TEST_FACE` **显式登记表**里 —— 这才是双向断言:登记了却不存在 ⇒ 红(抓陈化登记)。
23
- """
24
- from __future__ import annotations
25
-
26
- import ast
27
- import io
28
- import os
29
- import shutil
30
- import sys
31
- import tempfile
32
-
33
- _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
34
- _MDCG = os.path.join(_REPO, "md_cg")
35
-
36
- #: 测试面允许 import hive 的**全量登记表**(实测 6 件)。
37
- #: 双向语义:①出现未登记的 test_*.py ⇒ 红(新反向依赖须显式登记,带理由);②登记项已不存在 ⇒ 红(抓陈化)。
38
- ALLOWED_TEST_FACE = (
39
- "test_issue399_hive_json_shape.py",
40
- "test_issue400_hive_dirty_args.py",
41
- "test_issue419_pii_redaction.py",
42
- "test_server_version.py",
43
- "test_v14_fixes.py",
44
- "test_v21r1_package_version.py",
45
- )
46
-
47
- PASS = FAIL = 0
48
- FAILS = []
49
-
50
-
51
- def ok(name, cond, detail=""):
52
- global PASS, FAIL
53
- if cond:
54
- PASS += 1
55
- print(" PASS " + name)
56
- else:
57
- FAIL += 1
58
- FAILS.append(name)
59
- print(" FAIL " + name + " " + str(detail)[:220])
60
-
61
-
62
- # 生效条件:root 存在即成立;返回 (生产违规列表, 测试面 import hive 的文件名排序列表, 扫描到的文件总数)。
63
- # 扫描面取自文件**实际文本**(AST);不截断(一次性取全,打印总数以便核对)。
64
- def scan(root=_MDCG):
65
- prod_viol, test_hits, total = [], [], 0
66
- for dp, dn, fns in os.walk(root):
67
- dn[:] = [d for d in dn if d not in ("__pycache__",)]
68
- for fn in sorted(fns):
69
- if not fn.endswith(".py"):
70
- continue
71
- total += 1
72
- p = os.path.join(dp, fn)
73
- try:
74
- tree = ast.parse(io.open(p, encoding="utf-8", errors="replace").read())
75
- except SyntaxError as e:
76
- prod_viol.append((fn, 0, "SyntaxError: %s" % e))
77
- continue
78
- hits = []
79
- for n in ast.walk(tree):
80
- if isinstance(n, ast.ImportFrom) and (n.module or "").split(".")[0] == "hive":
81
- hits.append((n.lineno, "from %s import ..." % (n.module or "")))
82
- if isinstance(n, ast.Import):
83
- for al in n.names:
84
- if al.name.split(".")[0] == "hive":
85
- hits.append((n.lineno, "import %s" % al.name))
86
- if not hits:
87
- continue
88
- if fn.startswith("test_"):
89
- test_hits.append(fn)
90
- else:
91
- prod_viol.extend((fn, ln, txt) for ln, txt in hits)
92
- return prod_viol, sorted(test_hits), total
93
-
94
-
95
- def main():
96
- print("== C1:md_cg 生产码不得 import hive(依赖方向单向:外围→核心)==")
97
- prod_viol, test_hits, total = scan()
98
- print(" [扫描面] md_cg/**/*.py 共 %d 件(全量扫描,未截断)" % total)
99
- print(" [读数] 生产面违规 %d 处:%s" % (len(prod_viol), prod_viol or "(无)"))
100
- print(" [读数] 测试面 import hive 的文件 %d 件:%s" % (len(test_hits), test_hits))
101
- ok("C1-P 生产面零处 import hive(违规则全量列出,见上)", not prod_viol,
102
- "生产面违规全量 = %s" % (prod_viol,))
103
- _unreg = [f for f in test_hits if f not in ALLOWED_TEST_FACE]
104
- ok("C1-T1 测试面 import hive 的文件全部已登记(未登记即红)", not _unreg, _unreg)
105
- _missing = [f for f in ALLOWED_TEST_FACE if f not in test_hits]
106
- ok("C1-T2 反向腿:登记的允许项必须真的存在(登记了却无引用 ⇒ 红,抓陈化登记)",
107
- not _missing, "登记了却无此引用(或文件名已改):%s" % _missing)
108
-
109
- print("")
110
- print("== C1-S 自检:真造反例,证明本腿**能红**(非「断言某函数被调用过」)==")
111
- sb = tempfile.mkdtemp(prefix="c1_selfcheck_")
112
- try:
113
- sub = os.path.join(sb, "md_cg")
114
- os.makedirs(sub, exist_ok=True)
115
- io.open(os.path.join(sub, "okmod.py"), "w", encoding="utf-8").write("import os\n")
116
- io.open(os.path.join(sub, "badmod.py"), "w", encoding="utf-8").write(
117
- "from hive import _append\nimport json\n")
118
- io.open(os.path.join(sub, "test_legit.py"), "w", encoding="utf-8").write(
119
- "import hive\n")
120
- _pv, _th, _tot = scan(sub)
121
- ok("C1-S1 反例面:自造反例树被扫到 3 件(不截断,先报总数)", _tot == 3, _tot)
122
- ok("C1-S2 ★真造反例:生产文件 import hive ⇒ **判据本体转红**(P 支捕获 1 处)",
123
- len(_pv) == 1 and _pv[0][0] == "badmod.py", _pv)
124
- ok("C1-S3 测试面同名反例被**正确归入允许面**而非生产违规(两面确实分开)",
125
- _th == ["test_legit.py"] and all(v[0] != "test_legit.py" for v in _pv),
126
- {"test_hits": _th, "prod": _pv})
127
- finally:
128
- shutil.rmtree(sb, ignore_errors=True)
129
-
130
- print("")
131
- print("断言总数 %d(PASS %d / FAIL %d)" % (PASS + FAIL, PASS, FAIL))
132
- if FAILS:
133
- print("FAILED:")
134
- for f in FAILS:
135
- print(" - " + f)
136
- return 1 if FAILS else 0
137
-
138
-
139
- if __name__ == "__main__":
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:md_cg 生产码不得依赖 hive(依赖方向单向:外围→核心)
3
+ # 生效条件:python -u -X utf8 -m md_cg.test_md_cg_no_hive_dep;扫描面 = md_cg/**/*.py 的 AST import(取自文件实际文本)
4
+ # 子功能:P 生产面禁止 import hive · T 测试面允许但必须落在显式登记表内(双向:登记了却不存在即红)· S 自检(真造反例证明本腿能红)
5
+ # 执行:直接跑;退出码 0=全绿、1=有红
6
+ # 验证方式:全部 PASS;S 段在临时区真造一份 import hive 的 md_cg 生产文件,断言判据转红
7
+ # 不适用条件:不判 hive 侧反向依赖 md_cg(那是允许方向,实测生产 3 件);不判 md_cg 内部子包之间的依赖;不判动态 import(getattr/__import__ 形式不在 AST 的 Import/ImportFrom 面内)
8
+ """C1 落腿:**md_cg 生产码不得 `import hive`**。
9
+
10
+ 出口(why):依赖方向必须单向 —— **外围(hive / 各端 / scripts)可依赖核心(md_cg),核心不得依赖外围**。
11
+ 若核心反向依赖外围,则「核心」不再可独立验证:
12
+ · 验证 md_cg 时要先拉起 hive(**T5 独立验证**失效:验证者与被验证者共享同一依赖面);
13
+ · md_cg 单独发布/单测时会被 hive 的可变性拖住(**A1 真源唯一**在工程上落成「依赖也单向」)。
14
+
15
+ **该规则出自 #465 的会话裁定**(本会话裁定「hive 侧新建 hive/_append.py,**不得反向依赖 md_cg**」,
16
+ 并已实测 hive→md_cg 生产 3 件存在、md_cg→hive 生产 0 件)。**在此之前它只是一句会话里的约定、无任何判据载体**;
17
+ 本件把它落成载体(这是 `docs/theory/形态×定理映射_v0.1.md` 第三节 **C1** 的兑现)。
18
+
19
+ ★两面分开(否则要么误红、要么过度收紧):
20
+ · **生产面**(文件名不以 `test_` 开头)⇒ **禁止** import hive;
21
+ · **测试面**(`test_*.py`)⇒ **允许**反向引用(用 hive 的产物做夹具是正当用法),但必须落在下方的
22
+ `ALLOWED_TEST_FACE` **显式登记表**里 —— 这才是双向断言:登记了却不存在 ⇒ 红(抓陈化登记)。
23
+ """
24
+ from __future__ import annotations
25
+
26
+ import ast
27
+ import io
28
+ import os
29
+ import shutil
30
+ import sys
31
+ import tempfile
32
+
33
+ _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
34
+ _MDCG = os.path.join(_REPO, "md_cg")
35
+
36
+ #: 测试面允许 import hive 的**全量登记表**(实测 6 件)。
37
+ #: 双向语义:①出现未登记的 test_*.py ⇒ 红(新反向依赖须显式登记,带理由);②登记项已不存在 ⇒ 红(抓陈化)。
38
+ ALLOWED_TEST_FACE = (
39
+ "test_issue399_hive_json_shape.py",
40
+ "test_issue400_hive_dirty_args.py",
41
+ "test_issue419_pii_redaction.py",
42
+ "test_server_version.py",
43
+ "test_v14_fixes.py",
44
+ "test_v21r1_package_version.py",
45
+ )
46
+
47
+ PASS = FAIL = 0
48
+ FAILS = []
49
+
50
+
51
+ def ok(name, cond, detail=""):
52
+ global PASS, FAIL
53
+ if cond:
54
+ PASS += 1
55
+ print(" PASS " + name)
56
+ else:
57
+ FAIL += 1
58
+ FAILS.append(name)
59
+ print(" FAIL " + name + " " + str(detail)[:220])
60
+
61
+
62
+ # 生效条件:root 存在即成立;返回 (生产违规列表, 测试面 import hive 的文件名排序列表, 扫描到的文件总数)。
63
+ # 扫描面取自文件**实际文本**(AST);不截断(一次性取全,打印总数以便核对)。
64
+ def scan(root=_MDCG):
65
+ prod_viol, test_hits, total = [], [], 0
66
+ for dp, dn, fns in os.walk(root):
67
+ dn[:] = [d for d in dn if d not in ("__pycache__",)]
68
+ for fn in sorted(fns):
69
+ if not fn.endswith(".py"):
70
+ continue
71
+ total += 1
72
+ p = os.path.join(dp, fn)
73
+ try:
74
+ tree = ast.parse(io.open(p, encoding="utf-8", errors="replace").read())
75
+ except SyntaxError as e:
76
+ prod_viol.append((fn, 0, "SyntaxError: %s" % e))
77
+ continue
78
+ hits = []
79
+ for n in ast.walk(tree):
80
+ if isinstance(n, ast.ImportFrom) and (n.module or "").split(".")[0] == "hive":
81
+ hits.append((n.lineno, "from %s import ..." % (n.module or "")))
82
+ if isinstance(n, ast.Import):
83
+ for al in n.names:
84
+ if al.name.split(".")[0] == "hive":
85
+ hits.append((n.lineno, "import %s" % al.name))
86
+ if not hits:
87
+ continue
88
+ if fn.startswith("test_"):
89
+ test_hits.append(fn)
90
+ else:
91
+ prod_viol.extend((fn, ln, txt) for ln, txt in hits)
92
+ return prod_viol, sorted(test_hits), total
93
+
94
+
95
+ def main():
96
+ print("== C1:md_cg 生产码不得 import hive(依赖方向单向:外围→核心)==")
97
+ prod_viol, test_hits, total = scan()
98
+ print(" [扫描面] md_cg/**/*.py 共 %d 件(全量扫描,未截断)" % total)
99
+ print(" [读数] 生产面违规 %d 处:%s" % (len(prod_viol), prod_viol or "(无)"))
100
+ print(" [读数] 测试面 import hive 的文件 %d 件:%s" % (len(test_hits), test_hits))
101
+ ok("C1-P 生产面零处 import hive(违规则全量列出,见上)", not prod_viol,
102
+ "生产面违规全量 = %s" % (prod_viol,))
103
+ _unreg = [f for f in test_hits if f not in ALLOWED_TEST_FACE]
104
+ ok("C1-T1 测试面 import hive 的文件全部已登记(未登记即红)", not _unreg, _unreg)
105
+ _missing = [f for f in ALLOWED_TEST_FACE if f not in test_hits]
106
+ ok("C1-T2 反向腿:登记的允许项必须真的存在(登记了却无引用 ⇒ 红,抓陈化登记)",
107
+ not _missing, "登记了却无此引用(或文件名已改):%s" % _missing)
108
+
109
+ print("")
110
+ print("== C1-S 自检:真造反例,证明本腿**能红**(非「断言某函数被调用过」)==")
111
+ sb = tempfile.mkdtemp(prefix="c1_selfcheck_")
112
+ try:
113
+ sub = os.path.join(sb, "md_cg")
114
+ os.makedirs(sub, exist_ok=True)
115
+ io.open(os.path.join(sub, "okmod.py"), "w", encoding="utf-8").write("import os\n")
116
+ io.open(os.path.join(sub, "badmod.py"), "w", encoding="utf-8").write(
117
+ "from hive import _append\nimport json\n")
118
+ io.open(os.path.join(sub, "test_legit.py"), "w", encoding="utf-8").write(
119
+ "import hive\n")
120
+ _pv, _th, _tot = scan(sub)
121
+ ok("C1-S1 反例面:自造反例树被扫到 3 件(不截断,先报总数)", _tot == 3, _tot)
122
+ ok("C1-S2 ★真造反例:生产文件 import hive ⇒ **判据本体转红**(P 支捕获 1 处)",
123
+ len(_pv) == 1 and _pv[0][0] == "badmod.py", _pv)
124
+ ok("C1-S3 测试面同名反例被**正确归入允许面**而非生产违规(两面确实分开)",
125
+ _th == ["test_legit.py"] and all(v[0] != "test_legit.py" for v in _pv),
126
+ {"test_hits": _th, "prod": _pv})
127
+ finally:
128
+ shutil.rmtree(sb, ignore_errors=True)
129
+
130
+ print("")
131
+ print("断言总数 %d(PASS %d / FAIL %d)" % (PASS + FAIL, PASS, FAIL))
132
+ if FAILS:
133
+ print("FAILED:")
134
+ for f in FAILS:
135
+ print(" - " + f)
136
+ return 1 if FAILS else 0
137
+
138
+
139
+ if __name__ == "__main__":
140
140
  sys.exit(main())
@@ -1,120 +1,120 @@
1
- # -*- coding: utf-8 -*-
2
- # 功能名:变异残留预检——in-place 定点变异工装被强杀后,工作树残留的「变异态源码」必须变成响亮的信号(issue #353)
3
- # 生效条件:python -X utf8 -m md_cg.test_mutation_residue;全仓扫描带 --mutate 的守卫,抽取其 _MUTATIONS 里的「变异态」字符串,断言它不在对应生产源里
4
- # 子功能:① AST + 受限求值抽取变异态串(chr/常量/拼接)② 判据=「变异态在盘 且 改动前形态不在盘」(两者同在=锚点歧义,跳过不判,防误报)③ 命中即列出文件/行并 rc=1
5
- # 执行:无需参数;被 run_tests.py 收集。in-place 守卫被强杀后,本守卫在下一次普通跑就把残留变成响亮失败
6
- # 验证方式:全绿 = 无残留;命中时输出「疑似残留」与修法提示(git checkout -- <file>)
7
- # 不适用条件:不修任何 in-place 工装本体(124 个文件迁移 + 共享 helper 是设计决定,归维护者);变异态串静态求值取不到时跳过(覆盖缺口如实计数,不误报);不判 CI 是否跑 --mutate
8
- """issue #353 守卫:变异残留从「静默假红」变成「响亮失败」。
9
-
10
- 病象:本仓约 125 个守卫带 --mutate 定点变异自证,其中约 113 个的形态是
11
- 「io.open(生产源, 'w').write(变异) → 跑守卫 → finally 还原」。finally 只防得住
12
- 异常与 SIGINT;SIGKILL(进程树强杀 / OOM / 断电)绕过 finally ⇒ 工作树停留在
13
- 变异态且没有任何一处记录这件事,之后在这棵树上跑的每个守卫都把残留当成
14
- 产品回归报假红(红项措辞与真缺陷完全同形)。
15
-
16
- 判据方向:**变异态字符串在盘 且 改动前形态不在盘** 才判残留——两者同在视为
17
- 锚点歧义(同一片段在别处合法出现),跳过不判。只判「变异态在盘」会把
18
- `return False` / 裸括号这类通用片段误报成残留(项目方首版实测 5/5 全误报)。
19
- 本守卫不改任何 in-place 工装本体。
20
- """
21
- import ast
22
- import os
23
- import sys
24
-
25
- sys.stdout.reconfigure(encoding="utf-8", errors="replace")
26
-
27
- _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
28
- _SKIP_DIRS = {".git", "__pycache__", "node_modules", ".venv", "target", "lib"}
29
- _MIN_LEN = 20 # 短于此的变异态串不判(太通用,误报面大)
30
- _SELF = os.path.basename(os.path.abspath(__file__))
31
- FAILS = []
32
-
33
-
34
- def _eval_str(node):
35
- """把 AST 表达式安全求值成字符串:字面量直取;拼接/chr() 用受限名字空间。
36
- 取不到返回 None(覆盖缺口如实跳过,不误报)。"""
37
- try:
38
- v = ast.literal_eval(node)
39
- return v if isinstance(v, str) else None
40
- except Exception:
41
- pass
42
- try:
43
- code = compile(ast.Expression(node), "<mut>", "eval")
44
- v = eval(code, {"__builtins__": {}}, {"chr": chr})
45
- return v if isinstance(v, str) else None
46
- except Exception:
47
- return None
48
-
49
-
50
- def _guard_files():
51
- out = []
52
- for dirpath, dd, ff in os.walk(_REPO):
53
- dd[:] = [d for d in dd if d not in _SKIP_DIRS]
54
- for fn in ff:
55
- if fn.startswith("test_") and fn.endswith(".py") and fn != _SELF:
56
- out.append(os.path.join(dirpath, fn))
57
- return sorted(out)
58
-
59
-
60
- def _extract(node):
61
- out = []
62
- for el in getattr(node, "elts", []):
63
- if not isinstance(el, ast.Tuple) or len(el.elts) < 4:
64
- continue
65
- rel = _eval_str(el.elts[1])
66
- old = _eval_str(el.elts[2])
67
- new = _eval_str(el.elts[3])
68
- if rel and new and rel.endswith(".py") and len(new) >= _MIN_LEN:
69
- out.append((rel, old, new))
70
- return out
71
-
72
-
73
- print("== 变异残留预检(issue #353)==")
74
- _guards = [p for p in _guard_files()
75
- if "--mutate" in (open(p, encoding="utf-8").read())]
76
- _checked = _ambiguous = 0
77
- _hits = []
78
- for p in _guards:
79
- try:
80
- tree = ast.parse(open(p, encoding="utf-8").read())
81
- except Exception:
82
- continue
83
- pairs = []
84
- for node in ast.walk(tree):
85
- if isinstance(node, ast.Assign) and any(
86
- isinstance(t, ast.Name) and "MUTATION" in t.id.upper()
87
- for t in node.targets):
88
- pairs.extend(_extract(node.value))
89
- if not pairs:
90
- continue
91
- rel_g = os.path.relpath(p, _REPO).replace(chr(92), "/")
92
- for rel, old, new in pairs:
93
- tp = os.path.join(_REPO, rel.replace("/", os.sep))
94
- try:
95
- cur = open(tp, encoding="utf-8").read()
96
- except OSError:
97
- continue
98
- _checked += 1
99
- if new in cur and (old or "") not in cur:
100
- line = cur[:cur.index(new)].count(chr(10)) + 1
101
- _hits.append((rel, rel_g, line, new))
102
- elif new in cur:
103
- _ambiguous += 1 # 变异态与改动前形态同时在盘 ⇒ 锚点歧义,不判
104
-
105
- print(" 盘点:带 --mutate 守卫 %d | 变异态判据 %d 条 | 锚点歧义跳过 %d 条"
106
- % (len(_guards), _checked, _ambiguous))
107
- if _hits:
108
- print(" !! 疑似残留变异:上一次 --mutate 未还干净,git checkout -- 下列文件即可")
109
- for rel, rel_g, line, new in _hits[:20]:
110
- print(" 残留 %s:%d(来自守卫 %s) 变异态=%r"
111
- % (rel, line, rel_g, new[:70]))
112
- FAILS.append("残留 %d 处" % len(_hits))
113
- else:
114
- print(" PASS 无变异残留(in-place 工装的变异态串都不在盘上源里)")
115
-
116
- print("")
117
- if FAILS:
118
- print("issue #353 结果:%s" % ";".join(FAILS))
119
- sys.exit(1)
1
+ # -*- coding: utf-8 -*-
2
+ # 功能名:变异残留预检——in-place 定点变异工装被强杀后,工作树残留的「变异态源码」必须变成响亮的信号(issue #353)
3
+ # 生效条件:python -X utf8 -m md_cg.test_mutation_residue;全仓扫描带 --mutate 的守卫,抽取其 _MUTATIONS 里的「变异态」字符串,断言它不在对应生产源里
4
+ # 子功能:① AST + 受限求值抽取变异态串(chr/常量/拼接)② 判据=「变异态在盘 且 改动前形态不在盘」(两者同在=锚点歧义,跳过不判,防误报)③ 命中即列出文件/行并 rc=1
5
+ # 执行:无需参数;被 run_tests.py 收集。in-place 守卫被强杀后,本守卫在下一次普通跑就把残留变成响亮失败
6
+ # 验证方式:全绿 = 无残留;命中时输出「疑似残留」与修法提示(git checkout -- <file>)
7
+ # 不适用条件:不修任何 in-place 工装本体(124 个文件迁移 + 共享 helper 是设计决定,归维护者);变异态串静态求值取不到时跳过(覆盖缺口如实计数,不误报);不判 CI 是否跑 --mutate
8
+ """issue #353 守卫:变异残留从「静默假红」变成「响亮失败」。
9
+
10
+ 病象:本仓约 125 个守卫带 --mutate 定点变异自证,其中约 113 个的形态是
11
+ 「io.open(生产源, 'w').write(变异) → 跑守卫 → finally 还原」。finally 只防得住
12
+ 异常与 SIGINT;SIGKILL(进程树强杀 / OOM / 断电)绕过 finally ⇒ 工作树停留在
13
+ 变异态且没有任何一处记录这件事,之后在这棵树上跑的每个守卫都把残留当成
14
+ 产品回归报假红(红项措辞与真缺陷完全同形)。
15
+
16
+ 判据方向:**变异态字符串在盘 且 改动前形态不在盘** 才判残留——两者同在视为
17
+ 锚点歧义(同一片段在别处合法出现),跳过不判。只判「变异态在盘」会把
18
+ `return False` / 裸括号这类通用片段误报成残留(项目方首版实测 5/5 全误报)。
19
+ 本守卫不改任何 in-place 工装本体。
20
+ """
21
+ import ast
22
+ import os
23
+ import sys
24
+
25
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
26
+
27
+ _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
28
+ _SKIP_DIRS = {".git", "__pycache__", "node_modules", ".venv", "target", "lib"}
29
+ _MIN_LEN = 20 # 短于此的变异态串不判(太通用,误报面大)
30
+ _SELF = os.path.basename(os.path.abspath(__file__))
31
+ FAILS = []
32
+
33
+
34
+ def _eval_str(node):
35
+ """把 AST 表达式安全求值成字符串:字面量直取;拼接/chr() 用受限名字空间。
36
+ 取不到返回 None(覆盖缺口如实跳过,不误报)。"""
37
+ try:
38
+ v = ast.literal_eval(node)
39
+ return v if isinstance(v, str) else None
40
+ except Exception:
41
+ pass
42
+ try:
43
+ code = compile(ast.Expression(node), "<mut>", "eval")
44
+ v = eval(code, {"__builtins__": {}}, {"chr": chr})
45
+ return v if isinstance(v, str) else None
46
+ except Exception:
47
+ return None
48
+
49
+
50
+ def _guard_files():
51
+ out = []
52
+ for dirpath, dd, ff in os.walk(_REPO):
53
+ dd[:] = [d for d in dd if d not in _SKIP_DIRS]
54
+ for fn in ff:
55
+ if fn.startswith("test_") and fn.endswith(".py") and fn != _SELF:
56
+ out.append(os.path.join(dirpath, fn))
57
+ return sorted(out)
58
+
59
+
60
+ def _extract(node):
61
+ out = []
62
+ for el in getattr(node, "elts", []):
63
+ if not isinstance(el, ast.Tuple) or len(el.elts) < 4:
64
+ continue
65
+ rel = _eval_str(el.elts[1])
66
+ old = _eval_str(el.elts[2])
67
+ new = _eval_str(el.elts[3])
68
+ if rel and new and rel.endswith(".py") and len(new) >= _MIN_LEN:
69
+ out.append((rel, old, new))
70
+ return out
71
+
72
+
73
+ print("== 变异残留预检(issue #353)==")
74
+ _guards = [p for p in _guard_files()
75
+ if "--mutate" in (open(p, encoding="utf-8").read())]
76
+ _checked = _ambiguous = 0
77
+ _hits = []
78
+ for p in _guards:
79
+ try:
80
+ tree = ast.parse(open(p, encoding="utf-8").read())
81
+ except Exception:
82
+ continue
83
+ pairs = []
84
+ for node in ast.walk(tree):
85
+ if isinstance(node, ast.Assign) and any(
86
+ isinstance(t, ast.Name) and "MUTATION" in t.id.upper()
87
+ for t in node.targets):
88
+ pairs.extend(_extract(node.value))
89
+ if not pairs:
90
+ continue
91
+ rel_g = os.path.relpath(p, _REPO).replace(chr(92), "/")
92
+ for rel, old, new in pairs:
93
+ tp = os.path.join(_REPO, rel.replace("/", os.sep))
94
+ try:
95
+ cur = open(tp, encoding="utf-8").read()
96
+ except OSError:
97
+ continue
98
+ _checked += 1
99
+ if new in cur and (old or "") not in cur:
100
+ line = cur[:cur.index(new)].count(chr(10)) + 1
101
+ _hits.append((rel, rel_g, line, new))
102
+ elif new in cur:
103
+ _ambiguous += 1 # 变异态与改动前形态同时在盘 ⇒ 锚点歧义,不判
104
+
105
+ print(" 盘点:带 --mutate 守卫 %d | 变异态判据 %d 条 | 锚点歧义跳过 %d 条"
106
+ % (len(_guards), _checked, _ambiguous))
107
+ if _hits:
108
+ print(" !! 疑似残留变异:上一次 --mutate 未还干净,git checkout -- 下列文件即可")
109
+ for rel, rel_g, line, new in _hits[:20]:
110
+ print(" 残留 %s:%d(来自守卫 %s) 变异态=%r"
111
+ % (rel, line, rel_g, new[:70]))
112
+ FAILS.append("残留 %d 处" % len(_hits))
113
+ else:
114
+ print(" PASS 无变异残留(in-place 工装的变异态串都不在盘上源里)")
115
+
116
+ print("")
117
+ if FAILS:
118
+ print("issue #353 结果:%s" % ";".join(FAILS))
119
+ sys.exit(1)
120
120
  print("issue #353 结果:全部通过")