atlas-project-harness 0.2.0-beta.2 → 0.2.0-beta.21

package/patches/project-wiring/README.md

@@ -7,7 +7,7 @@
 | # | 接线 | 落点 | 作用 |
 |---|---|---|---|
 | A | **AGENTS.md 指针** | `<项目根>/AGENTS.md` 的 `<!-- TRELLIS:END -->` **之后**（`<!-- ATLAS:START/END -->` 区块） | 位于 Trellis 区块外 ⇒ 不被 `trellis update` 覆盖；给出契约路径、skills、需求级 1.6 步、收口门 |
-| B | **`after_finish` hook** | `<项目根>/.trellis/config.yaml` | 每个任务 Finish 后跑 `refresh_structure.py --apply` 刷结构事实（决策 D38） |
+| B | **`after_archive` hook + `session_auto_commit: false`** | `<项目根>/.trellis/config.yaml` | 每个任务归档（`task.py archive` / `/trellis-finish-work`）后跑 `refresh_structure.py --chain` 刷结构事实（决策 D159；旧 `after_finish` 形态自动迁移） |
 
 ## 内容
 
@@ -28,7 +28,8 @@ python3 apply-wiring.py --target <项目根> --apply     # 写入
 ## 幂等与可重放
 
 - AGENTS.md：区块已存在则**按源整段替换**（不新建重复段）；文件不存在则创建；标记单侧存在 → 报 `error` 且**不改文件**。
-- `config.yaml`：hook 命令已在 → `skipped`；有 `hooks:` 块则并入 `after_finish`，无则末尾新增 `hooks:` 块。
+- `config.yaml`：hook 命令已在 `after_archive` → 跳过该步；有 `hooks:` 块则并入 `after_archive`，无则末尾新增 `hooks:` 块；存量 `after_finish` 中的同一条命令自动迁移。
+- `session_auto_commit`：默认写 `false`（D160，提交由人 review）；用户显式设置的键尊重不动（含 `true`）。
 - `.yaml` 写入前做**轻量结构护栏**（不依赖 PyYAML）：顶层 `hooks:` 必须唯一、hook 命令必须存在，否则报 `error` 且不写。
 - **可重放**：`trellis update` 冲掉 `config.yaml` 的本地 hook 或 AGENTS.md 指针后，重跑 `install.sh`（或本接线器 `--apply`）即恢复。
 
@@ -38,4 +39,4 @@ python3 apply-wiring.py --target <项目根> --apply     # 写入
 
 ## 回归测试
 
-`atlas/tests/test_project_wiring.py`：验证「TRELLIS:END 之后插入 / 幂等 / 缺文件创建 / 区块更新 / config 三种落位（无 hooks、有 hooks 无 after_finish、有 after_finish）/ dry-run 不写 / 标记不成对报错不改」。
+`atlas/tests/test_project_wiring.py`：验证「TRELLIS:END 之后插入 / 幂等 / 缺文件创建 / 区块更新 / config 三种落位（无 hooks、有 hooks 无 after_archive、有 after_archive）/ dry-run 不写 / 标记不成对报错不改」。

package/patches/project-wiring/agent-pointer.md

@@ -12,7 +12,7 @@
 - **先分清「装配」与「开户」（第一步就问这个）**：`atlas init` 只装配线束。**若 `product/prd/` 与 `.trellis/spec/structure/` 仍为空 ⇒ 本产品尚未开户** —— 用户说「接入 Atlas 工作流 / 把项目接进来」时走 `atlas-apply adopt`（存量：只登记既有基线 + 开户最小集，不重写老 PRD、不猜老用例），**不得**因为 `.atlas/` / `product/` 已存在就回「已接入」或反问是不是接过了。开户按产物存在与否**断点续跑**，不重来。
 - skills：`atlas-structure` / `atlas-prd` / `atlas-e2e` / `atlas-apply`
 - 需求级流程走 `.trellis/workflow.md` 的 `#### 1.6 项目级资产更新`（= `atlas apply <需求ID>`），**实现在其后**
-- 收口 = 相关 E2E 全 `green` + **用户验收走查确认**（`blocked` ⇒ 域标待验收、不判收口）+ 结构事实刷新（`.trellis/config.yaml` 的 `after_finish` hook）
+- 收口 = 相关 E2E 全 `green` + **用户验收走查确认**（`blocked` ⇒ 域标待验收、不判收口）+ 结构事实刷新（`.trellis/config.yaml` 的 `after_archive` hook）
 - **撞到「规则本身不合业务」不许静默绕过**：注释规则 / 放宽判定 / `--no-verify` / 假装完成都算绕过——按契约 §15 提炼**设计问题**（缺陷本体 · 抽象触发形态 · 建议方向；**不带产品名 / 业务名词 / 真实数据**）后用 `atlas report` 上报，并告知用户 + 给当前阶段最优临时推进方案（`.atlas/shared/global-rules.md` §15）。用户说「这不合理」是同一类。
 
 > 本段由 `atlas/install.sh` 幂等维护（区块可重放）。请勿手改；改契约请改 atlas 源包后重跑 `install.sh`。

package/patches/project-wiring/apply-wiring.py

@@ -11,12 +11,14 @@
      因此不被 `trellis update` 覆盖。已存在则整段按源更新（不新建重复段）。
      文件不存在时创建。
 
-  2. `<项目根>/.trellis/config.yaml`：登记 `after_finish` hook 跑
-     `refresh_structure.py`（结构事实刷新，决策 D38）；已有 `hooks:` 块则并入，
-     否则在文件末尾新增。
+  2. `<项目根>/.trellis/config.yaml`：登记 `after_archive` hook 跑
+     `refresh_structure.py`（结构事实刷新，决策 D159：归档才是任务收口；旧形态
+     `after_finish` 会被迁移）；已有 `hooks:` 块则并入，否则在文件末尾新增。
+     同一步把 `session_auto_commit` 默认写为 `false`（D160：提交由人 review，
+     不让归档自动 commit；用户显式设置的键尊重不动）。
 
-  3. `<项目根>/pytest.ini`（仅 Python 工程）：补 `ac` marker 注册；非 Python 工程里
-     若躺着本脚本误建的那一份，按退役对称清掉。
+  3. `<项目根>/<测试配置>`（仅 extractor 声明的栈）：由 `adapters/ac/` 的 extractor
+     提供项目级配置 hook；无 hook 的栈跳过，不写任何配置。
 
   4. `<项目根>/.pi/`（仅 pi 宿主）：把官方扩展落到 `.pi/extensions/atlas/index.ts`，
      并在 `.pi/settings.json` 的 `extensions[]` 里幂等登记一行（2026-10-15 补）。
@@ -27,7 +29,7 @@
      不只图谱用户。判据：文件**不存在 ⇒ 不首创**（跳过并在报告里给一行建议）；
      内容已含 `.adapter-out` 字样 ⇒ 幂等跳过；出现 `!.adapter-out` 负模式 ⇒ 跳过，
      不与用户既有规则打架。**本触点无退役对称**：`.gitignore` 不是本项目创建的文件，
-     追加后永不回收（与 `pytest.ini` 的「逐字节相等才清」不同——追加是单向动作，
+     追加后永不回收（与 extractor 配置的「逐字节相等才清」不同——追加是单向动作，
      由报告行当刻告知用户）。
 
 设计要点：
@@ -47,6 +49,11 @@ import re
 import sys
 from pathlib import Path
 
+if str(Path(__file__).resolve().parents[2]) not in sys.path:
+    sys.path.insert(0, str(Path(__file__).resolve().parents[2]))
+from _support.layout import LayoutError, load_layout  # noqa: E402
+from adapters.ac import wire_project  # noqa: E402
+
 PKG_ROOT = Path(__file__).resolve().parent
 POINTER_SNIPPET = PKG_ROOT / "agent-pointer.md"
 
@@ -60,6 +67,8 @@ HOOK_CMD = "python3 .atlas/scripts/refresh_structure.py --root . --chain"
 # 子串等于旧命令会漏识别 `--apply` 旧形态 ⇒ 双 hook 常驻、refresh 跑两遍。
 HOOK_PREFIX = "python3 .atlas/scripts/refresh_structure.py --root ."
 CONFIG_REL = ".trellis/config.yaml"
+EVENT_ARCHIVE = "after_archive"
+EVENT_ORDER = ["after_finish", "after_start", "after_create", "after_archive"]
 
 RE_HOOKS = re.compile(r"^hooks:\s*(#.*)?$")
 RE_AFTER_FINISH = re.compile(r"^  after_finish:\s*(#.*)?$")
@@ -118,59 +127,136 @@ def wire_agents(target: Path) -> dict:
 
 # ----------------------------------------------------------------- .trellis/config.yaml
 
+RE_AUTO_COMMIT = re.compile(r"^session_auto_commit:\s*(.*)$")
+RE_AUTO_COMMIT_COMMENTED = re.compile(r"^#\s*session_auto_commit:.*$")
+
+
+def _wire_auto_commit(lines: list[str]) -> str:
+    """默认关闭 Trellis 的自动提交（D160）。
+
+    自动提交会把 journal / task 归档直接 commit 进用户仓库，绕过人工 review；
+    atlas 的接线口径是「提交由人决定」，故新项目默认写 `session_auto_commit: false`。
+    用户显式写了该键 ⇒ 尊重（true/false 都不改），只在报告里说明。
+    """
+    for ln in lines:
+        m = RE_AUTO_COMMIT.match(ln)
+        if not m:
+            continue
+        value = m.group(1).split("#")[0].strip().lower()
+        return "respected (already false)" if value in ("false", "no", "0", "off") else "respected (user override)"
+    for i, ln in enumerate(lines):
+        if RE_AUTO_COMMIT_COMMENTED.match(ln):
+            lines[i] = "# atlas 接线：默认关闭自动提交，提交由人 review 后手工执行（D160）\nsession_auto_commit: false\n"
+            return "applied (enabled-off at template comment)"
+    if lines and not lines[-1].endswith("\n"):
+        lines[-1] += "\n"
+    lines.append("\n# atlas 接线：默认关闭自动提交，提交由人 review 后手工执行（D160）\nsession_auto_commit: false\n")
+    return "applied (enabled-off appended)"
+
+
+def _hooks_range(lines: list[str]) -> tuple[int, int] | None:
+    """返回 hooks: 子块的行区间 [start, end)（end 为第一个顶层行）。"""
+    hi = next((i for i, ln in enumerate(lines) if RE_HOOKS.match(ln)), None)
+    if hi is None:
+        return None
+    end = len(lines)
+    for j in range(hi + 1, len(lines)):
+        if RE_TOP_LEVEL.match(lines[j]):
+            end = j
+            break
+    return (hi + 1, end)
+
+
+def _event_lines(lines: list[str], rng: tuple[int, int], event: str) -> tuple[int, list[int]] | None:
+    """返回某事件子块的 (键行下标, 命令行下标列表)；不存在返回 None。"""
+    start, end = rng
+    key_re = re.compile(rf"^  {re.escape(event)}:\s*(#.*)?$")
+    for i in range(start, end):
+        if not key_re.match(lines[i]):
+            continue
+        cmd_idx = []
+        j = i + 1
+        while j < end:
+            ln = lines[j]
+            if ln.strip() and not ln.startswith("    "):
+                break
+            if ln.lstrip().startswith("- "):
+                cmd_idx.append(j)
+            j += 1
+        return (i, cmd_idx)
+    return None
+
+
 def wire_config(target: Path) -> dict:
+    """接线 `.trellis/config.yaml` 的两件事（各自幂等）：
+
+    1. refresh hook 登记到 `after_archive`（D159）。归档（`task.py archive`，收尾命令
+       `/trellis-finish-work` 走的也是它）才是任务收口；`after_finish` 只清活动任务指针，
+       用它会在真收口时漏刷新。存量 `after_finish` 里的同一条命令会被**迁移**。
+    2. `session_auto_commit` 默认写 `false`（D160）：自动提交会把 journal / 任务归档直接
+       commit 进用户仓库，绕过人工 review；用户显式写了该键则尊重不动。
+    """
     path = target / CONFIG_REL
     if not path.exists():
         return {"file": CONFIG_REL, "status": "skipped",
                 "detail": "config.yaml 不存在（Trellis 未初始化？）"}
 
     text = path.read_text(encoding="utf-8")
-    if HOOK_CMD in text:
-        return {"file": CONFIG_REL, "status": "skipped", "detail": "after_finish hook 已登记"}
-
-    # C1 迁移分支（R7）：识别旧形态 `HOOK_PREFIX … --apply`（引号/裸命令皆），**原位替换**
-    # 为 --chain，而不是插入新行——否则旧+新双 hook 常驻，每次 finish 刷新跑两遍。
-    if HOOK_PREFIX in text and HOOK_CMD not in text:
-        tails = [m.group(1) for m in re.finditer(re.escape(HOOK_PREFIX) + r"([^\n\"\']*)", text)]
-        if any(t.strip() == "--apply" for t in tails):
-            new_text = re.sub(re.escape(HOOK_PREFIX) + r"\s+--apply", HOOK_CMD, text)
-            # 护栏：替换后同一文件内仍有 `HOOK_PREFIX --apply`（多 hook 场景不期）则拒绝
-            if "--apply" in new_text and HOOK_PREFIX in new_text:
-                return {"file": CONFIG_REL, "status": "error",
-                        "detail": "迁移护栏：替换后仍存在旧形态 --apply hook，不修改"}
-            return {"file": CONFIG_REL, "status": "applied",
-                    "detail": "hook upgraded in-place (--apply → --chain)", "_write": (path, new_text)}
-        if all(t.strip() not in ("--apply", "--chain") for t in tails):
-            # 前缀在但命令尾是自定义形态 ⇒ 尊重用户自定 hook，不插第二行（防双 hook 常驻）
-            return {"file": CONFIG_REL, "status": "skipped",
-                    "detail": "存在自定义 refresh hook（yellow 尾非 --apply/--chain），未改"}
-
     lines = text.splitlines(keepends=True)
-
-    hooks_i = next((i for i, ln in enumerate(lines) if RE_HOOKS.match(ln)), None)
-
-    if hooks_i is not None:
-        after_finish_i = None
-        for j in range(hooks_i + 1, len(lines)):
-            if RE_TOP_LEVEL.match(lines[j]):
-                break  # 离开 hooks 子块
-            if RE_AFTER_FINISH.match(lines[j]):
-                after_finish_i = j
-                break
-        if after_finish_i is not None:
-            lines.insert(after_finish_i + 1, f'    - "{HOOK_CMD}"\n')
-            detail = "applied (hook added to existing after_finish)"
+    rng = _hooks_range(lines)
+
+    hook_ready = False
+    if rng is not None:
+        archive = _event_lines(lines, rng, EVENT_ARCHIVE)
+        hook_ready = archive is not None and any(HOOK_CMD in lines[i] for i in archive[1])
+
+    detail = "after_archive hook already registered"
+    if not hook_ready:
+        # 找到别处（旧形态 after_finish / 其它事件）的同一条命令，准备迁移
+        legacy: list[tuple[str, int]] = []
+        if rng is not None:
+            for event in EVENT_ORDER:
+                found = _event_lines(lines, rng, event)
+                if found is None:
+                    continue
+                for i in found[1]:
+                    if HOOK_PREFIX in lines[i]:
+                        tail = lines[i].split(HOOK_PREFIX, 1)[1].strip().strip('"').strip("'").strip()
+                        if tail not in ("--apply", "--chain"):
+                            return {"file": CONFIG_REL, "status": "skipped",
+                                    "detail": "存在自定义 refresh hook（尾参非 --apply/--chain），未改"}
+                        legacy.append((event, i))
+
+        # 迁移：删除旧命令行；旧事件子块被删空时连键行一起去掉
+        for event, i in sorted(legacy, key=lambda x: -x[1]):
+            del lines[i]
+            found = _event_lines(lines, _hooks_range(lines) or (0, 0), event)
+            if found is not None and not found[1]:
+                del lines[found[0]]
+
+        rng = _hooks_range(lines)
+        if rng is None:
+            if text and not text.endswith("\n"):
+                lines.append("\n")
+            lines.append("\n# atlas structure refresh（D159）：任务归档后刷新结构事实指针层\n")
+            lines.append("hooks:\n")
+            lines.append("  after_archive:\n")
+            lines.append(f'    - "{HOOK_CMD}"\n')
+            detail = "applied (new hooks block at EOF)"
         else:
-            lines.insert(hooks_i + 1, f'  after_finish:\n    - "{HOOK_CMD}"\n')
-            detail = "applied (after_finish added to existing hooks)"
-    else:
-        if text and not text.endswith("\n"):
-            lines.append("\n")
-        lines.append("\n# atlas structure refresh（D38）：每个任务 Finish 后刷新结构事实指针层\n")
-        lines.append("hooks:\n")
-        lines.append("  after_finish:\n")
-        lines.append(f'    - "{HOOK_CMD}"\n')
-        detail = "applied (new hooks block at EOF)"
+            archive = _event_lines(lines, rng, EVENT_ARCHIVE)
+            if archive is None:
+                lines.insert(rng[1], f'  after_archive:\n    - "{HOOK_CMD}"\n')
+                detail = "applied (after_archive added to existing hooks)"
+            else:
+                lines.insert(archive[0] + 1, f'    - "{HOOK_CMD}"\n')
+                detail = "applied (hook added to existing after_archive)"
+            if legacy:
+                detail = detail.replace("applied", "applied (migrated from after_finish)")
+
+    commit_state = _wire_auto_commit(lines)
+    if commit_state.startswith("applied"):
+        detail = f"{detail}; session_auto_commit off"
 
     new_text = "".join(lines)
 
@@ -182,114 +268,16 @@ def wire_config(target: Path) -> dict:
     if HOOK_CMD not in new_text:
         return {"file": CONFIG_REL, "status": "error",
                 "detail": "YAML 护栏：hook 命令未写入，不修改"}
+    active_commit_keys = [ln for ln in new_text.splitlines() if RE_AUTO_COMMIT.match(ln)]
+    if len(active_commit_keys) > 1:
+        return {"file": CONFIG_REL, "status": "error",
+                "detail": f"YAML 护栏：session_auto_commit 出现 {len(active_commit_keys)} 次（期望 ≤1），不修改"}
 
     if new_text == text:
         return {"file": CONFIG_REL, "status": "skipped", "detail": "already current"}
     return {"file": CONFIG_REL, "status": "applied", "detail": detail, "_write": (path, new_text)}
 
 
-# ------------------------------------------------------------------- pytest 配置兜底（R6.2 对账定稿，2026-10-15）
-
-# 注释剥离（2026-10-15 事故）：出厂模板的 `backend_test:` 段是**注释示例**，逐字匹配 raw
-# 文本会把**每个**按模板开户的项目判成 Python 工程 ⇒ 纯前端仓库里凭空多出一个 pytest.ini
-# （存量实测：pnpm + React 仓库，`atlas init` 当刻即中招）。⇒ 只认**声明项**。
-RE_COMMENT = re.compile(r"(?:^|\s+)#.*$")
-
-
-def is_python_project(target: Path) -> bool:
-    """探测是否为 Python 工程（stack-profile **声明**或根目录 Python 特征文件）。
-
-    只看**声明**：注释里出现的关键字不算（见上面 RE_COMMENT 的事故注）——出厂模板的
-    `#   framework: pytest` 是注释，不能当证据。声明面三种任一生效：
-    `python` 字样 / `framework: pytest` / `backend_test:` 段（最后一个是本兜底所服务的
-    AC 标记特性的**契约 opt-in 段**，`shared/stack-profile.md` §2）。
-    """
-    prof_path = target / "product" / "stack-profile.yaml"
-    if prof_path.is_file():
-        text = prof_path.read_text(encoding="utf-8", errors="ignore")
-        declared = "\n".join(RE_COMMENT.sub("", ln) for ln in text.splitlines()).lower()
-        if "python" in declared or "framework: pytest" in declared or "backend_test:" in declared:
-            return True
-    for marker in ("requirements.txt", "pyproject.toml", "setup.py", "Pipfile", ".venv"):
-        if (target / marker).exists():
-            return True
-    return False
-
-
-MARKERS_INI = (
-    "[pytest]\n"
-    "markers =\n"
-    "    ac: mark test with AC ID for traceability\n"
-)
-
-MARKERS_PYPROJECT = (
-    "[tool.pytest.ini_options]\n"
-    "markers = [\n"
-    "    \"ac: mark test with AC ID for traceability\",\n"
-    "]\n"
-)
-
-
-def _has_pytest_section(pyproject: Path) -> bool:
-    try:
-        return "[tool.pytest" in pyproject.read_text(encoding="utf-8", errors="ignore")
-    except OSError:
-        return False
-
-
-def wire_python_scaffold(target: Path) -> dict:
-    """AC 标记注册兜底——**载体优先级：已有 pytest 配置文件 > 既有 pytest.ini > 新建 pytest.ini**。
-
-    R6.2 对账定稿（2026-10-15）：本兜底只承担 **`ac` marker 注册**这一项正当元数据；
-    `pythonpath = .` 环境补丁已随 F23（适配器输出 `python3 -m pytest`，cwd 自动入
-    `sys.path`）退役——线束不再替业务打环境补丁（假桩③病理）。
-
-    优先级（防「复活被清掉的补丁」）：
-      1. pyproject.toml / setup.cfg 已承载 pytest 配置 ⇒ skip；
-      2. 既有 pytest.ini ⇒ 只补缺失的 marker 注册（pythonpath 不再注入）；
-      3. 什么都没有 ⇒ 新建 pytest.ini（仅 marker 注册）。
-
-    **退役对称（2026-10-15 补）**：非 Python 工程里若躺着一份**逐字节等于我们兜底内容**
-    的 pytest.ini，那是本脚本早先误建的（判据事故见 `RE_COMMENT`）⇒ 清掉。用户改过 ⇒
-    一字不动（只跳过）——「只删自己写的、且没被动过的东西」。
-    """
-    ini_path = target / "pytest.ini"
-    if not is_python_project(target):
-        if ini_path.is_file() and ini_path.read_text(encoding="utf-8") == MARKERS_INI:
-            return {"file": "pytest.ini", "status": "removed",
-                    "detail": "非 Python 工程：清掉本兜底误建的 pytest.ini"
-                              "（仅当内容逐字节等于兜底内容；用户改过则保留）",
-                    "_remove": ini_path}
-        return {"file": "pytest.ini", "status": "skipped", "detail": "非 Python 工程，跳过"}
-
-    pyproject = target / "pyproject.toml"
-    setup_cfg = target / "setup.cfg"
-
-    # 1. pyproject.toml / setup.cfg 已承载 pytest 配置 ⇒ 尊重，不另立 pytest.ini
-    if pyproject.is_file() and _has_pytest_section(pyproject):
-        return {"file": "pytest.ini", "status": "skipped", "detail": "已由 pyproject.toml 承载 pytest 配置"}
-    if setup_cfg.is_file():
-        text_cfg = setup_cfg.read_text(encoding="utf-8", errors="ignore")
-        if "[tool:pytest]" in text_cfg:
-            return {"file": "pytest.ini", "status": "skipped", "detail": "已由 setup.cfg 承载 pytest 配置"}
-
-    if not ini_path.is_file():
-        # 3. 全无 ⇒ 新建 pytest.ini（只承载 marker 注册；pythonpath 补丁已随 F23 退役）
-        return {"file": "pytest.ini", "status": "applied",
-                "detail": "created pytest.ini with ac marker registration (pythonpath retired with F23)",
-                "_write": (ini_path, MARKERS_INI)}
-
-    # 2. 既有 pytest.ini ⇒ 只补 marker 注册（幂等）
-    content = ini_path.read_text(encoding="utf-8")
-    if "markers" in content:
-        return {"file": "pytest.ini", "status": "skipped", "detail": "pytest.ini 已包含 marker 注册"}
-
-    new_content = content.rstrip("\n") + "\nmarkers =\n    ac: mark test with AC ID for traceability\n"
-    return {"file": "pytest.ini", "status": "applied",
-            "detail": "updated (appended ac marker registration)",
-            "_write": (ini_path, new_content)}
-
-
 # ----------------------------------------------------------------- .gitignore 兜底（2026-10-15 补，第 5 个触点）
 
 GITIGNORE_REL = ".gitignore"
@@ -427,8 +415,13 @@ def main() -> int:
 
     write = bool(args.apply) and not bool(args.dry_run)
     target = Path(args.target).resolve()
+    try:
+        load_layout(target)
+    except LayoutError as exc:
+        print(f"[FAIL] {exc}", file=sys.stderr)
+        return 2
 
-    results = [wire_agents(target), wire_config(target), wire_python_scaffold(target),
+    results = [wire_agents(target), wire_config(target), wire_project(target),
                wire_gitignore(target)]
     results += wire_pi_extension(target)
     errors = sum(1 for r in results if r["status"] == "error")

package/patches/workflow-plan-apply/1.6-plan-apply.insert.md

@@ -9,7 +9,7 @@
 - **独立审查门**：`e2e` 用例产出后、生成脚本前跑 **E2E 环独立审查**（`rings/e2e/reference.md` §12；有 `Critical` 不得生成脚本）。
 - 应然 UI 的 testid 落点 = 用例分片 `testid:`（应然源）；不改 UI 的复用既有 testid（实然 = 前端源码）。
 - **影响面无法确定 / 门控态 / 任一环失败**：如实报告并**停在 planning**，**不得进入实现**——除非用户显式放弃或降级，且结论已写入 `atlas-apply.md`。
-- 结构事实由 `after_finish` hook 在实现后刷新，本步不写结构事实（唯一例外：本次改了域清单 ⇒ 末尾追一次 structure re-key）。
+- 结构事实由 `after_archive` hook 在实现后刷新，本步不写结构事实（唯一例外：本次改了域清单 ⇒ 末尾追一次 structure re-key）。
 - 三问门的**判定 + 依据**必须写进 `atlas-apply.md`（机器判不了，靠留痕）。
 - 并发时先声明写面：同一项目级文件**单写者**（`apply/reference.md` §5.1）。
 - 幂等：重跑只处理受影响增量。