@hunter-harness/workflow-harness 0.2.82 → 0.2.83

package/harness/bundles/general/claude-code/.harness-build.json

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "claude-code",
-  "coreHash": "611f91f44adcd1d1"
+  "coreHash": "d1ddcf707a26d7b6"
 }

package/harness/bundles/general/claude-code/harness-archive/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-codebase-map/SKILL.md

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-knowledge-ingest/SKILL.md

@@ -8,7 +8,7 @@ disallowed-tools:
   - Bash(git *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-ingest
 
 知识 ingest 完全由 Hunter Platform 负责。归档完成时，客户端生成一个确定性 ZIP；

package/harness/bundles/general/claude-code/harness-knowledge-query/SKILL.md

@@ -8,7 +8,7 @@ disallowed-tools:
   - Bash(git *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-query
 
 项目知识以 Hunter Platform 的服务端索引为唯一真源。客户端只提交查询并消费结果：

package/harness/bundles/general/claude-code/harness-plan/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-pull/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-pull — 从 Hunter Platform 下拉与恢复
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-push/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-push — 上传到 Hunter Platform
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-review/SKILL.md

@@ -22,7 +22,7 @@ disallowed-tools:
   - Bash(curl *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-run/SKILL.md

@@ -22,7 +22,7 @@ disallowed-tools:
   - Bash(curl *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose
@@ -92,6 +92,24 @@ disallowed-tools:
 
 **Fixback**：入口只用 `launch-review`，后续问题处理通过 `resolve-issue/close` 驱动，不得把修复说明当成新的普通 Run。只读取返回的受影响问题和文件；验证仅失效与 `changedFiles` 相交的目标，其他 Test/Review 证据继续复用。RED 优先；`manual`、`workflow` 或未选用的建议不进入代码批次，使用中文记录处理结论。
 
+**构建/测试执行入口**：所有构建与测试命令（mvn / gradle / npm test / pytest 等）必须经 `harness_test_runner.py exec` 发起，**禁止**用 `powershell.exe -Command` 直接裸跑：
+
+```text
+python <skills-root>/scripts/harness_test_runner.py exec --project . --timeout-seconds <预估上限> -- <构建命令及参数>
+```
+
+该入口持有项目级互斥锁并托管进程树。裸跑构建在宿主工具超时后会被推入后台，多个后台构建同时写同一个 `target/`、`build/` 或 `node_modules/.cache`，表现为编译产物被清空、日志文件被占用、"增量编译抖动"——这些都不是代码缺陷，是并发自相残杀，排查成本极高。`--timeout-seconds` 按最慢的一次全量构建估（默认 300 秒偏短），宁可给足也不要让命令被中途掐断。
+
+返回 `TEST_RUN_ALREADY_ACTIVE`（退出码 3）说明**已有构建在跑**：等它结束或用 `lock-status` 查明持有者，**不得**改用裸跑绕开锁，也不得另起一个并行构建。确认持有进程已消失时才用 `lock-reap` 回收。
+
+**长阶段租约续期**：`gate begin` 的租约默认 TTL 3600 秒，而 run 阶段常常跑得更久。租约过期不会中断执行，只会让最后的 `gate close` 报 `LEASE_ABSENT`。凡预计超过 1 小时的阶段，每完成一个变更簇就用本阶段**原 run-id** 续租一次（同 run-id 重复 claim 即刷新，不会新开 attempt）：
+
+```text
+python <skills-root>/scripts/harness_change.py claim --change <id> --phase run --run-id <本阶段 run-id> --ttl-seconds 3600 --json
+```
+
+已经报了 `LEASE_ABSENT` 也按同一条命令恢复——错误响应的 `resumeRunId` 就是要用的 run-id；**不要**重跑 `gate begin`，那会新开 attempt 并丢失本轮 capsule。
+
 **执行器边界**：优先使用项目 build profile 和已有测试入口。禁止为了绕过 ESM、路径或参数问题临时生成 `.js`、`require` 脚本；需要文件式 runner 时使用项目已有入口，确需新增时遵循项目模块类型（例如 ESM 使用 `.mjs`）。runner 包装说明写入 `runnerCommand` 元数据，不得拼进账本的规范 `command`。
 
 **Foundation Gate**：若 `meta/implementation-checkpoints.json` 中 `foundation-gate` 为 pending，不得开始 plan 中任务 6+；由 `harness_gate.py` 硬阻断。
@@ -123,7 +141,9 @@ disallowed-tools:
 | **预存变更** | 保留 → baseline 隔离；存在则最终 ≥ 🟡WARN |
 | **关门/状态** | 10 项关门检查；持久化 run-task-status；仅 run-owned P0 静态-only 导致 WARN；test-owned 待办正常移交 |
 | **Worktree** | `requested=true` 时代码只写 worktree |
-| **PowerShell** | 所有 git/构建经 `powershell.exe -NoProfile -Command` |
+| **构建/测试** | 一律经 `harness_test_runner.py exec`；禁止裸跑 mvn/gradle/npm test；`TEST_RUN_ALREADY_ACTIVE` 表示已有构建在跑，等待而非另起 |
+| **租约** | 阶段超 1 小时按变更簇用原 run-id 续租；`LEASE_ABSENT` 用 `harness_change.py claim` 恢复，不重跑 begin |
+| **PowerShell** | 所有 git 经 `powershell.exe -NoProfile -Command` |
 
 ### 陈旧测试安全修复与精确跟踪
 

package/harness/bundles/general/claude-code/harness-submit/SKILL.md

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-sync/SKILL.md

@@ -19,7 +19,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-sync
 
 ## Purpose

package/harness/bundles/general/claude-code/harness-test/SKILL.md

@@ -23,7 +23,7 @@ disallowed-tools:
   - Bash(node *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=claude-code; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose

package/harness/bundles/general/claude-code/scripts/harness_gate.py

@@ -1906,6 +1906,31 @@ def _latest_phase_end(
     return None
 
 
+def _latest_open_run_id(change_dir: Path, phase: str) -> str | None:
+    """Return the newest ``phase.start`` run_id that has no matching ``phase.end``.
+
+    A long phase can outlive its lease TTL; close then reports ``LEASE_ABSENT``
+    with no way back.  Resuming needs the *original* run_id, so surface it here
+    instead of making the caller reconstruct it from ``events.ndjson``.
+    """
+    started: list[str] = []
+    ended: set[str] = set()
+    for event in he.load_events(he.events_path(change_dir)):
+        if event.get("phase") != phase:
+            continue
+        run_id = str(event.get("run_id") or "")
+        if not run_id:
+            continue
+        if event.get("type") == "phase.start":
+            started.append(run_id)
+        elif event.get("type") == "phase.end":
+            ended.add(run_id)
+    for run_id in reversed(started):
+        if run_id not in ended:
+            return run_id
+    return None
+
+
 def _terminal_matches_context_session(
     project: Path,
     change_id: str,
@@ -2631,11 +2656,42 @@ def cmd_begin(args: argparse.Namespace) -> int:
         ttl_seconds=int(args.ttl_seconds),
     )
     if not claim.get("ok"):
+        claim_code = str(claim.get("code", "LEASE_CONFLICT"))
+        claim_extra = {
+            k: v for k, v in claim.items() if k not in {"ok", "message", "code"}
+        }
+        holder = claim.get("holder")
+        if claim_code == "LEASE_CONFLICT" and isinstance(holder, dict):
+            holder_phase = str(holder.get("phase") or "")
+            holder_run_id = str(holder.get("runId") or "")
+            # A lease whose own phase already recorded phase.end is leftover state:
+            # only close releases the lease, so any begin-without-close strands it
+            # for the full TTL and blocks the next phase.
+            holder_closed = (
+                bool(holder_phase)
+                and bool(holder_run_id)
+                and _latest_phase_end(change_dir, holder_phase, holder_run_id) is not None
+            )
+            claim_extra["holderPhaseClosed"] = holder_closed
+            if holder_closed:
+                claim_extra["recoveryAction"] = (
+                    f"持有租约的 {holder_phase} 阶段（run-id {holder_run_id}）已写入 phase.end，"
+                    "这是残留租约，释放后重试 begin 是安全的："
+                    "python <skills-root>/scripts/harness_change.py release "
+                    f"--change {resolved['changeId']} --phase {holder_phase} "
+                    f"--run-id {holder_run_id} --json"
+                )
+            else:
+                claim_extra["recoveryAction"] = (
+                    f"{holder_phase or '另一个'} 阶段（run-id {holder_run_id or '未知'}）"
+                    "仍在进行中且尚未写入 phase.end。先让该阶段正常关门；"
+                    "确认其执行进程已不存在时才可释放租约，不要直接 --steal。"
+                )
         return emit_error(
-            str(claim.get("code", "LEASE_CONFLICT")),
+            claim_code,
             str(claim.get("message", "lease claim failed")),
             as_json=as_json,
-            extra={k: v for k, v in claim.items() if k not in {"ok", "message", "code"}},
+            extra=claim_extra,
         )
 
     guard_result: dict[str, Any] | None = None
@@ -2843,7 +2899,26 @@ def cmd_close(args: argparse.Namespace) -> int:
                 as_json=as_json,
             )
             return 0
-        return emit_error("LEASE_ABSENT", "no active lease for phase close", as_json=as_json)
+        resume_run_id = explicit_run_id or _latest_open_run_id(change_dir, args.phase)
+        return emit_error(
+            "LEASE_ABSENT",
+            "no active lease for phase close",
+            as_json=as_json,
+            extra={
+                "retryable": True,
+                "phase": args.phase,
+                "changeId": resolved["changeId"],
+                "resumeRunId": resume_run_id,
+                "recoveryAction": (
+                    "阶段租约已过期（TTL 由 begin 的 --ttl-seconds 决定，默认 3600 秒）或已被释放。"
+                    "用本阶段原 run-id 重新取得租约后原样重试 close："
+                    "python <skills-root>/scripts/harness_change.py claim "
+                    f"--change {resolved['changeId']} --phase {args.phase} "
+                    f"--run-id {resume_run_id or '<原 run-id>'} --ttl-seconds 3600 --json"
+                    "。不要重跑 gate begin——那会新开一次 attempt 并丢失本轮 capsule。"
+                ),
+            },
+        )
     run_id = explicit_run_id or str(current_lease.get("runId") or "")
     if str(current_lease.get("runId")) != run_id or str(current_lease.get("phase")) != args.phase:
         return emit_error(

package/harness/bundles/general/codebuddy/.harness-build.json

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "codebuddy",
-  "coreHash": "611f91f44adcd1d1"
+  "coreHash": "d1ddcf707a26d7b6"
 }

package/harness/bundles/general/codebuddy/harness-archive/SKILL.md

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到 .harness/archive/，含归档元数据。仅当用户显式调用
   /harness-archive 时使用；不得被其他阶段 skill 自动接续触发。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-codebase-map/SKILL.md

@@ -3,7 +3,7 @@ name: harness-codebase-map
 description: 分析现有代码库并生成 .harness/codebase/map/
   下的结构化代码库地图。用于陌生项目理解、重大改造前梳理、harness-sync 提示 map 过期后的人工刷新。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-knowledge-ingest/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-knowledge-ingest
 description: 确认归档 ZIP 已上传并由 Hunter Platform 在服务端解包、校验和入库。客户端不再构建或维护本地知识索引。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-knowledge-ingest
 
 知识 ingest 完全由 Hunter Platform 负责。归档完成时，客户端生成一个确定性 ZIP；

package/harness/bundles/general/codebuddy/harness-knowledge-query/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-knowledge-query
 description: 在规划、实现或排查前，通过 hunter-harness CLI 查询远端项目知识库。远端不可用时直接报告不可用，不建立本地索引或离线回退。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-knowledge-query
 
 项目知识以 Hunter Platform 的服务端索引为唯一真源。客户端只提交查询并消费结果：

package/harness/bundles/general/codebuddy/harness-plan/SKILL.md

@@ -3,7 +3,7 @@ name: harness-plan
 description: 将需求转化为设计文档+实施计划+完整测试场景表，必须在编码前完成。仅当用户显式调用 /harness-plan 或明确要求进入
   Harness 规划阶段时使用；不得因用户描述需求就自动触发。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-pull/SKILL.md

@@ -3,7 +3,7 @@ name: harness-pull
 description: 从 Hunter Platform 下拉配置/规则/架构/指令（及显式来源分支的分支文件恢复）。仅当用户显式调用
   /harness-pull 或明确说'从平台拉取/恢复'时使用；不得自动触发。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-pull — 从 Hunter Platform 下拉与恢复
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-push/SKILL.md

@@ -3,7 +3,7 @@ name: harness-push
 description: 上传本地配置/规则/架构/指令（及显式归档）到 Hunter Platform。仅当用户显式调用 /harness-push
   或明确说'上传到平台'时使用；不得因存在本地修改就自动触发。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-push — 上传到 Hunter Platform
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-review/SKILL.md

@@ -4,7 +4,7 @@ description: 6维度代码审查（架构/安全/规范/兼容/测试/性能）
   .harness/context-index.json）和测试场景表，在隔离上下文运行。仅当用户显式调用 /harness-review 时使用；不得在
   test 结束后自动接续执行。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-run/SKILL.md

@@ -3,7 +3,7 @@ name: harness-run
 description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编译验证），逐变更簇实现计划中的任务。仅当用户显式调用
   /harness-run 时使用；不得因用户提到编码/实现就自动触发，也不得被其他阶段 skill 自动接续。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose
@@ -73,6 +73,24 @@ description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编
 
 **Fixback**：入口只用 `launch-review`，后续问题处理通过 `resolve-issue/close` 驱动，不得把修复说明当成新的普通 Run。只读取返回的受影响问题和文件；验证仅失效与 `changedFiles` 相交的目标，其他 Test/Review 证据继续复用。RED 优先；`manual`、`workflow` 或未选用的建议不进入代码批次，使用中文记录处理结论。
 
+**构建/测试执行入口**：所有构建与测试命令（mvn / gradle / npm test / pytest 等）必须经 `harness_test_runner.py exec` 发起，**禁止**用 `powershell.exe -Command` 直接裸跑：
+
+```text
+python <skills-root>/scripts/harness_test_runner.py exec --project . --timeout-seconds <预估上限> -- <构建命令及参数>
+```
+
+该入口持有项目级互斥锁并托管进程树。裸跑构建在宿主工具超时后会被推入后台，多个后台构建同时写同一个 `target/`、`build/` 或 `node_modules/.cache`，表现为编译产物被清空、日志文件被占用、"增量编译抖动"——这些都不是代码缺陷，是并发自相残杀，排查成本极高。`--timeout-seconds` 按最慢的一次全量构建估（默认 300 秒偏短），宁可给足也不要让命令被中途掐断。
+
+返回 `TEST_RUN_ALREADY_ACTIVE`（退出码 3）说明**已有构建在跑**：等它结束或用 `lock-status` 查明持有者，**不得**改用裸跑绕开锁，也不得另起一个并行构建。确认持有进程已消失时才用 `lock-reap` 回收。
+
+**长阶段租约续期**：`gate begin` 的租约默认 TTL 3600 秒，而 run 阶段常常跑得更久。租约过期不会中断执行，只会让最后的 `gate close` 报 `LEASE_ABSENT`。凡预计超过 1 小时的阶段，每完成一个变更簇就用本阶段**原 run-id** 续租一次（同 run-id 重复 claim 即刷新，不会新开 attempt）：
+
+```text
+python <skills-root>/scripts/harness_change.py claim --change <id> --phase run --run-id <本阶段 run-id> --ttl-seconds 3600 --json
+```
+
+已经报了 `LEASE_ABSENT` 也按同一条命令恢复——错误响应的 `resumeRunId` 就是要用的 run-id；**不要**重跑 `gate begin`，那会新开 attempt 并丢失本轮 capsule。
+
 **执行器边界**：优先使用项目 build profile 和已有测试入口。禁止为了绕过 ESM、路径或参数问题临时生成 `.js`、`require` 脚本；需要文件式 runner 时使用项目已有入口，确需新增时遵循项目模块类型（例如 ESM 使用 `.mjs`）。runner 包装说明写入 `runnerCommand` 元数据，不得拼进账本的规范 `command`。
 
 **Foundation Gate**：若 `meta/implementation-checkpoints.json` 中 `foundation-gate` 为 pending，不得开始 plan 中任务 6+；由 `harness_gate.py` 硬阻断。
@@ -104,7 +122,9 @@ description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编
 | **预存变更** | 保留 → baseline 隔离；存在则最终 ≥ 🟡WARN |
 | **关门/状态** | 10 项关门检查；持久化 run-task-status；仅 run-owned P0 静态-only 导致 WARN；test-owned 待办正常移交 |
 | **Worktree** | `requested=true` 时代码只写 worktree |
-| **PowerShell** | 所有 git/构建经 `powershell.exe -NoProfile -Command` |
+| **构建/测试** | 一律经 `harness_test_runner.py exec`；禁止裸跑 mvn/gradle/npm test；`TEST_RUN_ALREADY_ACTIVE` 表示已有构建在跑，等待而非另起 |
+| **租约** | 阶段超 1 小时按变更簇用原 run-id 续租；`LEASE_ABSENT` 用 `harness_change.py claim` 恢复，不重跑 begin |
+| **PowerShell** | 所有 git 经 `powershell.exe -NoProfile -Command` |
 
 ### 陈旧测试安全修复与精确跟踪
 

package/harness/bundles/general/codebuddy/harness-submit/SKILL.md

@@ -3,7 +3,7 @@ name: harness-submit
 description: 最终提交封装：验证→中文 commit→提交/推送；worktree 模式含 --no-ff 合并回主分支。仅当用户显式调用
   /harness-submit（或 /harness-merge 重入合并段）时使用；用户口头说'提交/commit/push'时必须先确认，不得自动触发。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-sync/SKILL.md

@@ -4,7 +4,7 @@ description: Use when the user asks to synchronize, refresh, or validate Harness
   metadata, adapters, remote knowledge ownership, instruction entrypoints,
   config origins, or CodeGraph status.
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-sync
 
 ## Purpose

package/harness/bundles/general/codebuddy/harness-test/SKILL.md

@@ -3,7 +3,7 @@ name: harness-test
 description: 测试执行：读取场景表，执行单元测试+API接口测试+数据兼容验证，输出测试报告。仅当用户显式调用 /harness-test
   时使用；不得在 run 结束后自动接续执行。
 ---
-<!-- generated by harness_deploy.py; core=611f91f44adcd1d1; overlay=none; agent=codebuddy; do not edit -->
+<!-- generated by harness_deploy.py; core=d1ddcf707a26d7b6; overlay=none; agent=codebuddy; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose

package/harness/bundles/general/codebuddy/scripts/harness_gate.py

@@ -1906,6 +1906,31 @@ def _latest_phase_end(
     return None
 
 
+def _latest_open_run_id(change_dir: Path, phase: str) -> str | None:
+    """Return the newest ``phase.start`` run_id that has no matching ``phase.end``.
+
+    A long phase can outlive its lease TTL; close then reports ``LEASE_ABSENT``
+    with no way back.  Resuming needs the *original* run_id, so surface it here
+    instead of making the caller reconstruct it from ``events.ndjson``.
+    """
+    started: list[str] = []
+    ended: set[str] = set()
+    for event in he.load_events(he.events_path(change_dir)):
+        if event.get("phase") != phase:
+            continue
+        run_id = str(event.get("run_id") or "")
+        if not run_id:
+            continue
+        if event.get("type") == "phase.start":
+            started.append(run_id)
+        elif event.get("type") == "phase.end":
+            ended.add(run_id)
+    for run_id in reversed(started):
+        if run_id not in ended:
+            return run_id
+    return None
+
+
 def _terminal_matches_context_session(
     project: Path,
     change_id: str,
@@ -2631,11 +2656,42 @@ def cmd_begin(args: argparse.Namespace) -> int:
         ttl_seconds=int(args.ttl_seconds),
     )
     if not claim.get("ok"):
+        claim_code = str(claim.get("code", "LEASE_CONFLICT"))
+        claim_extra = {
+            k: v for k, v in claim.items() if k not in {"ok", "message", "code"}
+        }
+        holder = claim.get("holder")
+        if claim_code == "LEASE_CONFLICT" and isinstance(holder, dict):
+            holder_phase = str(holder.get("phase") or "")
+            holder_run_id = str(holder.get("runId") or "")
+            # A lease whose own phase already recorded phase.end is leftover state:
+            # only close releases the lease, so any begin-without-close strands it
+            # for the full TTL and blocks the next phase.
+            holder_closed = (
+                bool(holder_phase)
+                and bool(holder_run_id)
+                and _latest_phase_end(change_dir, holder_phase, holder_run_id) is not None
+            )
+            claim_extra["holderPhaseClosed"] = holder_closed
+            if holder_closed:
+                claim_extra["recoveryAction"] = (
+                    f"持有租约的 {holder_phase} 阶段（run-id {holder_run_id}）已写入 phase.end，"
+                    "这是残留租约，释放后重试 begin 是安全的："
+                    "python <skills-root>/scripts/harness_change.py release "
+                    f"--change {resolved['changeId']} --phase {holder_phase} "
+                    f"--run-id {holder_run_id} --json"
+                )
+            else:
+                claim_extra["recoveryAction"] = (
+                    f"{holder_phase or '另一个'} 阶段（run-id {holder_run_id or '未知'}）"
+                    "仍在进行中且尚未写入 phase.end。先让该阶段正常关门；"
+                    "确认其执行进程已不存在时才可释放租约，不要直接 --steal。"
+                )
         return emit_error(
-            str(claim.get("code", "LEASE_CONFLICT")),
+            claim_code,
             str(claim.get("message", "lease claim failed")),
             as_json=as_json,
-            extra={k: v for k, v in claim.items() if k not in {"ok", "message", "code"}},
+            extra=claim_extra,
         )
 
     guard_result: dict[str, Any] | None = None
@@ -2843,7 +2899,26 @@ def cmd_close(args: argparse.Namespace) -> int:
                 as_json=as_json,
             )
             return 0
-        return emit_error("LEASE_ABSENT", "no active lease for phase close", as_json=as_json)
+        resume_run_id = explicit_run_id or _latest_open_run_id(change_dir, args.phase)
+        return emit_error(
+            "LEASE_ABSENT",
+            "no active lease for phase close",
+            as_json=as_json,
+            extra={
+                "retryable": True,
+                "phase": args.phase,
+                "changeId": resolved["changeId"],
+                "resumeRunId": resume_run_id,
+                "recoveryAction": (
+                    "阶段租约已过期（TTL 由 begin 的 --ttl-seconds 决定，默认 3600 秒）或已被释放。"
+                    "用本阶段原 run-id 重新取得租约后原样重试 close："
+                    "python <skills-root>/scripts/harness_change.py claim "
+                    f"--change {resolved['changeId']} --phase {args.phase} "
+                    f"--run-id {resume_run_id or '<原 run-id>'} --ttl-seconds 3600 --json"
+                    "。不要重跑 gate begin——那会新开一次 attempt 并丢失本轮 capsule。"
+                ),
+            },
+        )
     run_id = explicit_run_id or str(current_lease.get("runId") or "")
     if str(current_lease.get("runId")) != run_id or str(current_lease.get("phase")) != args.phase:
         return emit_error(

package/harness/bundles/general/codex/.harness-build.json

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "codex",
-  "coreHash": "2676178fa6f219fd"
+  "coreHash": "164aae46328cbf6c"
 }

package/harness/bundles/general/codex/harness-archive/SKILL.md

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到 .harness/archive/，含归档元数据。仅当用户显式调用
   /harness-archive 时使用；不得被其他阶段 skill 自动接续触发。
 ---
-<!-- generated by harness_deploy.py; core=2676178fa6f219fd; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=164aae46328cbf6c; overlay=none; agent=codex; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

package/harness/bundles/general/codex/harness-codebase-map/SKILL.md

@@ -3,7 +3,7 @@ name: harness-codebase-map
 description: 分析现有代码库并生成 .harness/codebase/map/
   下的结构化代码库地图。用于陌生项目理解、重大改造前梳理、harness-sync 提示 map 过期后的人工刷新。
 ---
-<!-- generated by harness_deploy.py; core=2676178fa6f219fd; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=164aae46328cbf6c; overlay=none; agent=codex; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

package/harness/bundles/general/codex/harness-knowledge-ingest/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-knowledge-ingest
 description: 确认归档 ZIP 已上传并由 Hunter Platform 在服务端解包、校验和入库。客户端不再构建或维护本地知识索引。
 ---
-<!-- generated by harness_deploy.py; core=2676178fa6f219fd; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=164aae46328cbf6c; overlay=none; agent=codex; do not edit -->
 # harness-knowledge-ingest
 
 知识 ingest 完全由 Hunter Platform 负责。归档完成时，客户端生成一个确定性 ZIP；

package/harness/bundles/general/codex/harness-knowledge-query/SKILL.md

@@ -2,7 +2,7 @@
 name: harness-knowledge-query
 description: 在规划、实现或排查前，通过 hunter-harness CLI 查询远端项目知识库。远端不可用时直接报告不可用，不建立本地索引或离线回退。
 ---
-<!-- generated by harness_deploy.py; core=2676178fa6f219fd; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=164aae46328cbf6c; overlay=none; agent=codex; do not edit -->
 # harness-knowledge-query
 
 项目知识以 Hunter Platform 的服务端索引为唯一真源。客户端只提交查询并消费结果：

package/harness/bundles/general/codex/harness-plan/SKILL.md

@@ -3,7 +3,7 @@ name: harness-plan
 description: 将需求转化为设计文档+实施计划+完整测试场景表，必须在编码前完成。仅当用户显式调用 /harness-plan 或明确要求进入
   Harness 规划阶段时使用；不得因用户描述需求就自动触发。
 ---
-<!-- generated by harness_deploy.py; core=2676178fa6f219fd; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=164aae46328cbf6c; overlay=none; agent=codex; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

package/harness/bundles/general/codex/harness-pull/SKILL.md

@@ -3,7 +3,7 @@ name: harness-pull
 description: 从 Hunter Platform 下拉配置/规则/架构/指令（及显式来源分支的分支文件恢复）。仅当用户显式调用
   /harness-pull 或明确说'从平台拉取/恢复'时使用；不得自动触发。
 ---
-<!-- generated by harness_deploy.py; core=2676178fa6f219fd; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=164aae46328cbf6c; overlay=none; agent=codex; do not edit -->
 # harness-pull — 从 Hunter Platform 下拉与恢复
 
 ## Purpose

package/harness/bundles/general/codex/harness-push/SKILL.md

@@ -3,7 +3,7 @@ name: harness-push
 description: 上传本地配置/规则/架构/指令（及显式归档）到 Hunter Platform。仅当用户显式调用 /harness-push
   或明确说'上传到平台'时使用；不得因存在本地修改就自动触发。
 ---
-<!-- generated by harness_deploy.py; core=2676178fa6f219fd; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=164aae46328cbf6c; overlay=none; agent=codex; do not edit -->
 # harness-push — 上传到 Hunter Platform
 
 ## Purpose