@furongjun1999/dsh-memory 0.9.23 → 0.10.3

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 (118) hide show
  1. package/CHANGELOG.en.md +515 -404
  2. package/CHANGELOG.md +642 -449
  3. package/README.en.md +244 -240
  4. package/README.md +272 -262
  5. package/codebuddy/CODEBUDDY.md +1 -1
  6. package/docs/discipline/templates/full.md.tmpl +1 -1
  7. package/docs/discipline/templates/rules.mdc.tmpl +1 -1
  8. package/docs/en/mdcg/world-model-endpoint.md +1 -1
  9. package/docs/mdcg/cogmap_ops.md +19 -16
  10. package/lib/client.js +29 -3
  11. package/lib/hooks.d.ts +12 -0
  12. package/lib/hooks.js +43 -1
  13. package/lib/tools.d.ts +2 -2
  14. package/md_cg/bucketindex.py +231 -0
  15. package/md_cg/bucketscope.py +357 -0
  16. package/md_cg/cohesion.py +337 -0
  17. package/md_cg/config_registry_bulk.py +24 -10
  18. package/md_cg/config_validate.py +14 -2
  19. package/md_cg/constraint_audit.py +231 -0
  20. package/md_cg/constraint_watch.py +206 -0
  21. package/md_cg/context_audit.py +240 -0
  22. package/md_cg/context_plan.py +142 -0
  23. package/md_cg/detrerank.py +137 -0
  24. package/md_cg/distill.py +247 -0
  25. package/md_cg/dossier.py +151 -0
  26. package/md_cg/entities.py +133 -0
  27. package/md_cg/fsutil.py +135 -0
  28. package/md_cg/govern/__init__.py +23 -0
  29. package/md_cg/iface/__init__.py +46 -0
  30. package/md_cg/iface/_verify.py +609 -0
  31. package/md_cg/iface/contracts.py +337 -0
  32. package/md_cg/judgment_manifest.py +14 -0
  33. package/md_cg/kernel/__init__.py +27 -0
  34. package/md_cg/mcp_server.py +6044 -5761
  35. package/md_cg/mdcg.py +501 -16
  36. package/md_cg/mdcos.py +546 -12
  37. package/md_cg/metacognition.py +66 -13
  38. package/md_cg/mutate_extract_shipped.py +126 -0
  39. package/md_cg/mutate_ledger_e2e.py +100 -0
  40. package/md_cg/op_table.py +22 -0
  41. package/md_cg/probe_c_ledger_integrity.py +258 -0
  42. package/md_cg/probe_d_retirement_discipline.py +263 -0
  43. package/md_cg/profiles.py +298 -0
  44. package/md_cg/protocol.py +7 -1
  45. package/md_cg/reldate.py +142 -0
  46. package/md_cg/review_cli.py +6 -1
  47. package/md_cg/run_tests.py +30 -1
  48. package/md_cg/scopeselect.py +214 -0
  49. package/md_cg/scrub.py +66 -9
  50. package/md_cg/selfstmt.py +139 -0
  51. package/md_cg/state_extract.py +149 -0
  52. package/md_cg/state_slots.py +62 -10
  53. package/md_cg/state_view.py +181 -0
  54. package/md_cg/structboost.py +179 -0
  55. package/md_cg/sustain.py +28 -2
  56. package/md_cg/test_alternatives_historical.py +165 -0
  57. package/md_cg/test_b2_sensitivity_landing.py +226 -223
  58. package/md_cg/test_b3_merge_keeps_content.py +608 -583
  59. package/md_cg/test_bucket_cards.py +85 -0
  60. package/md_cg/test_bucket_day_order.py +74 -0
  61. package/md_cg/test_bucket_quota.py +79 -0
  62. package/md_cg/test_bucket_recency_guards.py +75 -0
  63. package/md_cg/test_bucket_three_causes.py +83 -0
  64. package/md_cg/test_bucket_time_rounds.py +87 -0
  65. package/md_cg/test_bucketindex.py +130 -0
  66. package/md_cg/test_bucketscope_early.py +71 -0
  67. package/md_cg/test_cohesion.py +107 -0
  68. package/md_cg/test_cond_term_fold_gate.py +1210 -0
  69. package/md_cg/test_cond_term_neg_scope.py +147 -0
  70. package/md_cg/test_constraint_audit.py +87 -0
  71. package/md_cg/test_constraint_watch.py +108 -0
  72. package/md_cg/test_context_audit.py +110 -0
  73. package/md_cg/test_context_plan.py +81 -0
  74. package/md_cg/test_detrerank.py +157 -0
  75. package/md_cg/test_gate_four_kpi.py +136 -0
  76. package/md_cg/test_generation_guard.py +14 -2
  77. package/md_cg/test_issue192_move_layer_indices_guard.py +48 -0
  78. package/md_cg/test_issue39_utf8_stdio.py +572 -572
  79. package/md_cg/test_issue413_preimage_failclosed.py +147 -9
  80. package/md_cg/test_issue768_overwrite_time_window_anchor.py +135 -0
  81. package/md_cg/test_issue789_log_plaintext_probe.py +100 -0
  82. package/md_cg/test_issue790_verb_negation.py +77 -0
  83. package/md_cg/test_issue810_root_guard.py +71 -0
  84. package/md_cg/test_issue812_info_index_stale.py +78 -0
  85. package/md_cg/test_issue827_weaken_dedup.py +361 -0
  86. package/md_cg/test_issue829_calibration_positive_gate.py +473 -0
  87. package/md_cg/test_kernel_iface_contracts.py +18 -0
  88. package/md_cg/test_md_cg_no_hive_dep.py +238 -17
  89. package/md_cg/test_probe_cd_shipped.py +385 -0
  90. package/md_cg/test_recent_tail.py +93 -0
  91. package/md_cg/test_run_tests_entry_gates.py +110 -0
  92. package/md_cg/test_scopeselect.py +70 -0
  93. package/md_cg/test_scopeselect_clock.py +70 -0
  94. package/md_cg/test_session_attribution_consistency.py +835 -813
  95. package/md_cg/test_state_extract_shipped.py +162 -0
  96. package/md_cg/test_state_ledger_chain.py +207 -0
  97. package/md_cg/test_state_ledger_e2e.py +145 -0
  98. package/md_cg/test_structboost.py +102 -0
  99. package/md_cg/test_timeboost.py +83 -0
  100. package/md_cg/test_timeboost_relativedate.py +71 -0
  101. package/md_cg/test_topicagg.py +129 -0
  102. package/md_cg/timeboost.py +223 -0
  103. package/md_cg/tokens.py +1 -1
  104. package/md_cg/topicagg.py +142 -0
  105. package/md_cg/version_anchor.py +84 -1
  106. package/md_cg/whitebox_kb/wisdom/code_compose.py +33 -5
  107. package/md_cg/whitebox_kb/wisdom/code_solidified.json +6195 -6195
  108. package/md_cg/whitebox_kb/wisdom/compose_engine.py +5 -1
  109. package/md_cg/whitebox_kb/wisdom/role_compose.py +271 -268
  110. package/package.json +1 -1
  111. package/src/hooks.ts +43 -1
  112. package/ui/minimal/payload/build-ui.mjs +41 -2
  113. package/ui/minimal/payload/lib/client.js +29 -3
  114. package/ui/minimal/payload/web/app.js +3 -1
  115. package/ui/minimal/payload/web/client.js +30 -3
  116. package/web/app.js +3 -1
  117. package/web/client.js +30 -3
  118. package/zcode/AGENTS.md +1 -1
@@ -1,9 +1,9 @@
1
1
  # -*- coding: utf-8 -*-
2
2
  # 功能名:md_cg 生产码不得依赖 hive(依赖方向单向:外围→核心)
3
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 自检(真造反例证明本腿能红)
4
+ # 子功能:P 生产面禁止 import hive · T 测试面允许但必须落在显式登记表内(双向:登记了却不存在即红)· S 自检(真造反例证明本腿能红)· R 相对导入折算逐形态断言
5
5
  # 执行:直接跑;退出码 0=全绿、1=有红
6
- # 验证方式:全部 PASS;S 段在临时区真造一份 import hive 的 md_cg 生产文件,断言判据转红
6
+ # 验证方式:全部 PASS;S/R 段在临时区真造 import hive 的 md_cg 生产文件,断言判据转红
7
7
  # 不适用条件:不判 hive 侧反向依赖 md_cg(那是允许方向,实测生产 3 件);不判 md_cg 内部子包之间的依赖;不判动态 import(getattr/__import__ 形式不在 AST 的 Import/ImportFrom 面内)
8
8
  """C1 落腿:**md_cg 生产码不得 `import hive`**。
9
9
 
@@ -20,6 +20,19 @@
20
20
  · **生产面**(文件名不以 `test_` 开头)⇒ **禁止** import hive;
21
21
  · **测试面**(`test_*.py`)⇒ **允许**反向引用(用 hive 的产物做夹具是正当用法),但必须落在下方的
22
22
  `ALLOWED_TEST_FACE` **显式登记表**里 —— 这才是双向断言:登记了却不存在 ⇒ 红(抓陈化登记)。
23
+
24
+ ★★相对导入必须**按所在文件位置折算**(2026-11-07 补,与 PR #806 同根因)
25
+ 旧判据只看 `n.module` 的字面首段,于是:
26
+ · `from .. import hive` → `module is None` → 首段取空串 → **永不命中**(漏判);
27
+ · `from ... import hive` → 同上(漏判);
28
+ · `md_cg/kernel/x.py` 里的 `from ..hive import _append`(= `md_cg.hive`,**并不违规**)
29
+ → 字面首段 `hive` → **误判为违规**(假红)。
30
+ 折算口径(full_pkg 为该文件的完整包段,含 `md_cg`):
31
+ level=0 ⇒ 绝对导入,取 name 本身;
32
+ level>=1 ⇒ keep = len(full_pkg) - (level - 1),
33
+ keep>0 ⇒ full_pkg[:keep] + name(包内);
34
+ keep==0 ⇒ 越过 `md_cg` 到顶层 ⇒ 就是 name 本身(**这才是真正的反向依赖**);
35
+ keep<0 ⇒ 越过仓库根,归属不可判(退回 name 字面名,fail-closed)。
23
36
  """
24
37
  from __future__ import annotations
25
38
 
@@ -32,6 +45,7 @@ import tempfile
32
45
 
33
46
  _REPO = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
34
47
  _MDCG = os.path.join(_REPO, "md_cg")
48
+ _PKG = "md_cg" # 扫描根的包名(与 _MDCG 目录名一致)
35
49
 
36
50
  #: 测试面允许 import hive 的**全量登记表**(实测 6 件)。
37
51
  #: 双向语义:①出现未登记的 test_*.py ⇒ 红(新反向依赖须显式登记,带理由);②登记项已不存在 ⇒ 红(抓陈化)。
@@ -59,10 +73,62 @@ def ok(name, cond, detail=""):
59
73
  print(" FAIL " + name + " " + str(detail)[:220])
60
74
 
61
75
 
62
- # 生效条件:root 存在即成立;返回 (生产违规列表, 测试面 import hive 的文件名排序列表, 扫描到的文件总数)。
76
+ # 生效条件:full_pkg 为该文件完整包段(含 _PKG,如 ['md_cg','kernel']),level/name 取自 AST 节点。
77
+ # 返回折算后的绝对全名;越过仓库根返回 None(归属不可判)。语义见模块 docstring 的 ★★ 段。
78
+ def _resolve_relative(full_pkg, level, name):
79
+ if level <= 0:
80
+ return name or None
81
+ keep = len(full_pkg) - (level - 1)
82
+ if keep < 0:
83
+ return None # 越过仓库根,不可判
84
+ # ★module 为空(`from .. import hive` 形态):被导入名在 alias 里,**前缀无从拼接**,
85
+ # 一律返回 None,由 _resolve_names() 退回 alias 名。早期版本在此返回了包根('md_cg'),
86
+ # 等于把 alias 名整个吃掉 —— 正是 R4 抓到的丢名缺陷。
87
+ if not name:
88
+ return None
89
+ if keep == 0:
90
+ return name # 越过 md_cg 到顶层 ⇒ name 本身就是绝对名(真反向依赖)
91
+ base = full_pkg[:keep] + name.split(".")
92
+ return ".".join(base)
93
+
94
+
95
+ # 生效条件:full_pkg 为该文件完整包段;返回该文件「所有 import 折算后的绝对全名」列表(带行号)。
96
+ def _resolve_names(tree, full_pkg):
97
+ out = []
98
+ for n in ast.walk(tree):
99
+ if isinstance(n, ast.ImportFrom):
100
+ if n.module:
101
+ full = _resolve_relative(full_pkg, n.level or 0, n.module)
102
+ if full:
103
+ out.append((n.lineno, full))
104
+ continue
105
+ # module 为空(`from .. import a, b`):被导入名在 alias 里,前缀按 level 折算后与之拼接。
106
+ # 例:md_cg/kernel/x.py 的 `from .. import hive` ⇒ keep=1 ⇒ 前缀 md_cg ⇒ md_cg.hive(干净);
107
+ # md_cg/x.py 的 `from .. import hive` ⇒ keep=0 ⇒ 前缀为空 ⇒ hive(真违规)。
108
+ if (n.level or 0) > 0:
109
+ _keep = len(full_pkg) - ((n.level or 0) - 1)
110
+ else:
111
+ _keep = len(full_pkg)
112
+ _prefix = full_pkg[:_keep] if _keep > 0 else []
113
+ for al in n.names:
114
+ _segs = _prefix + al.name.split(".")
115
+ out.append((n.lineno, ".".join(_segs) if _segs else al.name))
116
+ elif isinstance(n, ast.Import):
117
+ for al in n.names:
118
+ out.append((n.lineno, al.name))
119
+ return out
120
+
121
+
122
+ # 生效条件:root 存在即成立;返回 ([(相对路径, 行号, 文本)], [相对路径], 文件总数)。
63
123
  # 扫描面取自文件**实际文本**(AST);不截断(一次性取全,打印总数以便核对)。
64
- def scan(root=_MDCG):
124
+ # 相对路径一律用 "/" 分隔且**相对 root**,这样同名文件在 md_cg/ 与 md_cg/kernel/ 下可区分。
125
+ # ★包根名从 root 目录名**派生**,不硬编码 _PKG:否则扫描根改名(或扫子目录当根)时折算全错,
126
+ # 而错法可能恰好仍给出「违规/干净」的正确二元结论,掩盖问题(实测见 C1-R5)。
127
+ def scan_paths(root=_MDCG):
65
128
  prod_viol, test_hits, total = [], [], 0
129
+ all_names = [] # (相对路径, 行号, 折算后全名) —— 供 C1-R5 反证包根名来源
130
+ root = os.path.abspath(root)
131
+ pkg = os.path.basename(root) or _PKG
66
132
  for dp, dn, fns in os.walk(root):
67
133
  dn[:] = [d for d in dn if d not in ("__pycache__",)]
68
134
  for fn in sorted(fns):
@@ -70,26 +136,69 @@ def scan(root=_MDCG):
70
136
  continue
71
137
  total += 1
72
138
  p = os.path.join(dp, fn)
139
+ rel = os.path.relpath(p, root).replace(os.sep, "/")
140
+ rel_dir = os.path.dirname(rel)
141
+ sub = [] if not rel_dir else rel_dir.split("/")
142
+ full_pkg = [pkg] + sub
73
143
  try:
74
144
  tree = ast.parse(io.open(p, encoding="utf-8", errors="replace").read())
75
145
  except SyntaxError as e:
76
- prod_viol.append((fn, 0, "SyntaxError: %s" % e))
146
+ prod_viol.append((rel, 0, "SyntaxError: %s" % e))
77
147
  continue
78
148
  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))
149
+ for ln, full in _resolve_names(tree, full_pkg):
150
+ # 暴露折算结果,供 C1-R5 断言「包根名确实来自 root」——
151
+ # 否则该断言只能直接调 _resolve_names 自己传包段,把派生逻辑绕过去(实测漏抓硬编码回归)。
152
+ all_names.append((rel, ln, full))
153
+ if full.split(".")[0] == "hive":
154
+ hits.append((ln, "import %s" % full))
86
155
  if not hits:
87
156
  continue
88
157
  if fn.startswith("test_"):
89
- test_hits.append(fn)
158
+ test_hits.append(rel)
90
159
  else:
91
- prod_viol.extend((fn, ln, txt) for ln, txt in hits)
92
- return prod_viol, sorted(test_hits), total
160
+ prod_viol.extend((rel, ln, txt) for ln, txt in hits)
161
+ return prod_viol, sorted(test_hits), total, all_names
162
+
163
+
164
+ # 生效条件:同 scan_paths;但按旧口径返回**文件名**(供 C1-P/T1/T2 与既有登记表比对,登记表存的是文件名)。
165
+ def scan(root=_MDCG):
166
+ pv, th, total, _all = scan_paths(root)
167
+ prod_viol = [(os.path.basename(r), ln, t) for r, ln, t in pv]
168
+ test_hits = sorted(set(os.path.basename(r) for r in th))
169
+ return prod_viol, test_hits, total
170
+
171
+
172
+ #: 相对/绝对导入的 8 个形态断言:(相对 root 的子目录, 文件名, 源码, 期望违规, 说明)
173
+ _REL_CASES = (
174
+ ("", "r_lv2_none.py", "from .. import hive\n", True,
175
+ "md_cg/x.py level=2 越过 md_cg ⇒ 顶层 hive ⇒ 违规"),
176
+ ("", "r_lv1_none.py", "from . import hive\n", False,
177
+ "md_cg/x.py level=1 ⇒ md_cg.hive ⇒ 干净"),
178
+ ("kernel", "r_lv3_none.py", "from ... import hive\n", True,
179
+ "md_cg/kernel/x.py level=3 越过 md_cg ⇒ 顶层 hive ⇒ 违规"),
180
+ ("kernel", "r_lv2_none.py", "from .. import hive\n", False,
181
+ "md_cg/kernel/x.py level=2 ⇒ md_cg.hive ⇒ 干净"),
182
+ ("", "r_lv2_mod.py", "from ..hive import _append\n", True,
183
+ "md_cg/x.py level=2 ⇒ 顶层 hive ⇒ 违规"),
184
+ ("kernel", "r_lv2_mod.py", "from ..hive import _append\n", False,
185
+ "md_cg/kernel/x.py level=2 ⇒ md_cg.hive ⇒ **旧判据在此假红**"),
186
+ ("", "r_abs.py", "from hive import _append\n", True, "绝对导入 ⇒ 违规"),
187
+ ("", "r_mix.py", "from . import hive\nimport hive\n", True,
188
+ "相对干净 + 绝对违规 ⇒ 仍须抓(逐 name 判定,非整文件一刀切)"),
189
+ # ★三层包:只有 keep=2 才能与「永远只取 full_pkg[:1]」区分开。
190
+ # md_cg/kernel/deep/x.py:level=2 ⇒ keep=3-2+1=2 ⇒ md_cg.kernel.hive(干净)
191
+ # level=3 ⇒ keep=1 ⇒ md_cg.hive(干净)
192
+ # level=4 ⇒ keep=0 ⇒ 顶层 hive(违规)
193
+ ("kernel/deep", "r3_lv2.py", "from .. import hive\n", False,
194
+ "md_cg/kernel/deep/x.py level=2 ⇒ md_cg.kernel.hive ⇒ 干净(deep 层被保留)"),
195
+ ("kernel/deep", "r3_lv4.py", "from .... import hive\n", True,
196
+ "md_cg/kernel/deep/x.py level=4 越过 md_cg ⇒ 顶层 hive ⇒ 违规"),
197
+ ("kernel/deep", "r3_lv2_mod.py", "from ..hive import _x\n", False,
198
+ "md_cg/kernel/deep/x.py level=2 ⇒ md_cg.kernel.hive ⇒ 干净"),
199
+ ("kernel/deep", "r3_lv3_mod.py", "from ...hive import _x\n", False,
200
+ "md_cg/kernel/deep/x.py level=3 ⇒ md_cg.hive ⇒ 干净(**只取包根会在此假红**)"),
201
+ )
93
202
 
94
203
 
95
204
  def main():
@@ -111,7 +220,7 @@ def main():
111
220
  sb = tempfile.mkdtemp(prefix="c1_selfcheck_")
112
221
  try:
113
222
  sub = os.path.join(sb, "md_cg")
114
- os.makedirs(sub, exist_ok=True)
223
+ os.makedirs(os.path.join(sub, "kernel"), exist_ok=True)
115
224
  io.open(os.path.join(sub, "okmod.py"), "w", encoding="utf-8").write("import os\n")
116
225
  io.open(os.path.join(sub, "badmod.py"), "w", encoding="utf-8").write(
117
226
  "from hive import _append\nimport json\n")
@@ -124,6 +233,118 @@ def main():
124
233
  ok("C1-S3 测试面同名反例被**正确归入允许面**而非生产违规(两面确实分开)",
125
234
  _th == ["test_legit.py"] and all(v[0] != "test_legit.py" for v in _pv),
126
235
  {"test_hits": _th, "prod": _pv})
236
+
237
+ print("")
238
+ print("== C1-R 相对导入折算:逐形态断言(防「判据只认绝对导入」的漏判/误判)==")
239
+ for _d, _n, _s, _e, _desc in _REL_CASES:
240
+ _dst = os.path.join(sub, _d, _n)
241
+ if not os.path.isdir(os.path.dirname(_dst)):
242
+ os.makedirs(os.path.dirname(_dst), exist_ok=True)
243
+ io.open(_dst, "w", encoding="utf-8").write(_s)
244
+ # 关键:**一次整树扫描**,靠相对路径区分 md_cg/x.py 与 md_cg/kernel/x.py
245
+ _pv2, _th2, _, _all2 = scan_paths(sub)
246
+ _flagged = set(r for r, _ln, _t in _pv2)
247
+ _wrong = []
248
+ for _d, _n, _s, _e, _desc in _REL_CASES:
249
+ _rel = (_d + "/" + _n) if _d else _n
250
+ _got = _rel in _flagged
251
+ print(" %-24s 应判=%-4s 实判=%-4s %s %s"
252
+ % (_rel, "违规" if _e else "干净", "违规" if _got else "干净",
253
+ "OK " if _got == _e else "***错判***", _desc))
254
+ if _got != _e:
255
+ _wrong.append((_rel, _e, _got, _desc))
256
+ ok("C1-R1 ★12 态相对/绝对导入折算全部判对(含旧判据的 2 处漏判 + 1 处假红)",
257
+ not _wrong, _wrong)
258
+ # 同一字面导入 `from ..hive import _append` 在两层应给出相反结论
259
+ _root_hit = "r_lv2_mod.py" in _flagged
260
+ _kern_hit = "kernel/r_lv2_mod.py" in _flagged
261
+ ok("C1-R2 同一字面导入在不同层级给出相反结论(证明确实按位置折算,非按字面名一刀切)",
262
+ _root_hit is True and _kern_hit is False,
263
+ {"md_cg/ 命中": _root_hit, "md_cg/kernel/ 命中": _kern_hit})
264
+
265
+ # ★R3 直接断言**折算出的全名字符串**,而不只是二元判定。
266
+ # 仅判「违规/干净」档位不足:把 full_pkg[:keep] 改成 full_pkg[:1] 会让
267
+ # kernel/deep 的干净态仍算干净(都落到 md_cg... 前缀),判定不变却错解了位置。
268
+ # 表内 (完整包段, level, module, 期望全名或 None)。
269
+ # 注意:module is None(`from .. import hive` 形态)时,被导入名在 alias 里,
270
+ # 本函数**只折前缀、返回 None**,由 `_resolve_names()` 拼 alias —— 这条路径由 R4 端到端验证。
271
+ _direct = [
272
+ (["md_cg"], 0, "hive", "hive"),
273
+ (["md_cg"], 2, None, None), # alias 形态:module 为空,前缀不可判 ⇒ None
274
+ (["md_cg"], 1, None, None), # 同上(alias 会是 md_cg.hive)
275
+ (["md_cg"], 1, "hive", "md_cg.hive"),
276
+ (["md_cg"], 2, "hive", "hive"),
277
+ (["md_cg", "kernel"], 2, None, None),
278
+ (["md_cg", "kernel"], 2, "hive", "md_cg.hive"),
279
+ (["md_cg", "kernel"], 3, "hive", "hive"),
280
+ (["md_cg", "kernel", "deep"], 2, "hive", "md_cg.kernel.hive"),
281
+ (["md_cg", "kernel", "deep"], 3, "hive", "md_cg.hive"),
282
+ (["md_cg", "kernel", "deep"], 4, "hive", "hive"),
283
+ (["md_cg"], 5, "hive", None), # 越过仓库根 ⇒ 不可判
284
+ (["md_cg", "kernel"], 0, "a.b", "a.b"),
285
+ ]
286
+ _dbad = []
287
+ for pkg, lv, mod, want in _direct:
288
+ got = _resolve_relative(pkg, lv, mod)
289
+ print(" full_pkg=%-32s level=%d module=%-6r -> %-22r 期望 %r %s"
290
+ % ("/".join(pkg), lv, mod, got, want,
291
+ "OK" if got == want else "***错***"))
292
+ if got != want:
293
+ _dbad.append((pkg, lv, mod, want, got))
294
+ ok("C1-R3 ★折算结果按**全名字符串**逐条比对(13 态;只比二元判定会漏掉「位置取错但仍非 hive」)",
295
+ not _dbad, _dbad)
296
+
297
+ # ★R4 alias 形态(`from .. import hive` / `from ... import hive`)端到端:
298
+ # module 为空时 _resolve_relative 返回 None,必须由 _resolve_names 退回 alias 名,
299
+ # 否则这两态会整条消失(这正是旧判据的漏判形态)。
300
+ _alias = [
301
+ (["md_cg"], "from .. import hive\n", "hive"), # 越过 md_cg ⇒ 顶层 hive
302
+ (["md_cg", "kernel"], "from ... import hive\n", "hive"), # 越过 md_cg ⇒ 顶层 hive
303
+ (["md_cg"], "from . import hive\n", "md_cg.hive"), # 包内 ⇒ 前缀 md_cg
304
+ (["md_cg", "kernel", "deep"], "from .... import hive\n", "hive"),
305
+ ]
306
+ _abad = []
307
+ for pkg, src, want in _alias:
308
+ names = [f for _ln, f in _resolve_names(ast.parse(src), pkg)]
309
+ print(" pkg=%-26s %-26r -> %s" % ("/".join(pkg), src.strip(), names))
310
+ if want not in names:
311
+ _abad.append((pkg, src.strip(), want, names))
312
+ ok("C1-R4 ★alias 形态(module=None)不丢名:4 态都能解析出 hive(旧判据在此全盲)",
313
+ not _abad, _abad)
314
+
315
+ # ★R5 包根名必须从扫描根目录名**派生**,不能硬编码。
316
+ # ★这里必须**经由 scan_paths()** 断言,不能直接调 _resolve_names 并自己传包段
317
+ # —— 后者会把 scan_paths 的派生逻辑整个绕过去,硬编码回归时照样通过(实测漏抓)。
318
+ _op = os.path.join(sb, "otherpkg")
319
+ os.makedirs(os.path.join(_op, "sub"), exist_ok=True)
320
+ io.open(os.path.join(_op, "x.py"), "w", encoding="utf-8").write(
321
+ "from . import hive\n") # otherpkg.hive(干净)
322
+ io.open(os.path.join(_op, "sub", "y.py"), "w", encoding="utf-8").write(
323
+ "from ..hive import _a\n") # otherpkg.hive(干净)
324
+ io.open(os.path.join(_op, "sub", "z.py"), "w", encoding="utf-8").write(
325
+ "from ... import hive\n") # 越过 otherpkg ⇒ 顶层 hive(违规)
326
+ _pv3, _th3, _tot3, _all3 = scan_paths(_op)
327
+ _flagged3 = set(r for r, _l, _t in _pv3)
328
+ _texts3 = " ".join(t for _r, _l, t in _pv3)
329
+ print(" otherpkg 扫描:违规=%s 文件数=%d 文本=%s"
330
+ % (sorted(_flagged3), _tot3, _texts3 or "(无)"))
331
+ _r5bad = []
332
+ # x.py / sub/y.py 折算为 otherpkg.hive 必须干净;硬编码 md_cg 时 x.py 会变 md_cg.hive
333
+ # (仍干净,二元判据看不出)——所以真正能区分的是:sub/z.py 越界仍须判违规,
334
+ # 且 **x.py 的全名必须含 otherpkg**。为此直接读 scan_paths 内部折算不便,
335
+ # 改为断言:sub/z.py 违规(越界)且 x.py、sub/y.py 干净,再用 _resolve_names 反证包名。
336
+ if "sub/z.py" not in _flagged3:
337
+ _r5bad.append(("sub/z.py 应违规", sorted(_flagged3)))
338
+ for _clean in ("x.py", "sub/y.py"):
339
+ if _clean in _flagged3:
340
+ _r5bad.append((_clean + " 应干净", sorted(_flagged3)))
341
+ # 反证:直接用 scan_paths 自己产出的全名表,断言包根名是 otherpkg。
342
+ _nm = [f for _r, _l, f in _all3 if _r == "x.py"]
343
+ print(" otherpkg/x.py 折算全名 =", _nm, "(须含 otherpkg,非 md_cg)")
344
+ if _nm != ["otherpkg.hive"]:
345
+ _r5bad.append(("全名应含 otherpkg", _nm))
346
+ ok("C1-R5 ★包根名从 root 目录名派生(经 scan_paths 端到端 + 全名反证,不绕过派生逻辑)",
347
+ not _r5bad, _r5bad)
127
348
  finally:
128
349
  shutil.rmtree(sb, ignore_errors=True)
129
350
 
@@ -137,4 +358,4 @@ def main():
137
358
 
138
359
 
139
360
  if __name__ == "__main__":
140
- sys.exit(main())
361
+ sys.exit(main())