@hunter-harness/workflow-harness 0.2.24 → 0.2.25

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

@@ -2,7 +2,7 @@
 name: harness-run
 description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编译验证），逐变更簇实现计划中的任务。使用场景：开始编码、实现功能、写代码、TDD 编码
 ---
-<!-- generated by harness_deploy.py; core=57436a1f7a795663; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=e26c16edf7594b9b; overlay=none; agent=codex; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-submit
 description: 最终提交封装：验证→中文 commit→提交/推送；worktree 模式含 --no-ff
   合并回主分支。使用场景：提交代码、commit、push、合并分支、merge to main、完成开发
 ---
-<!-- generated by harness_deploy.py; core=57436a1f7a795663; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=e26c16edf7594b9b; overlay=none; agent=codex; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-sync
 description: 检查并更新项目AI元数据（CodeGraph索引、harness-codebase-map分析、CLAUDE.md、AGENTS.md、.harness/完整性），确保Claude对代码库的理解与最新代码一致。当用户说'同步/更新索引/刷新元数据/检查一致性'时使用
 ---
-<!-- generated by harness_deploy.py; core=57436a1f7a795663; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=e26c16edf7594b9b; overlay=none; agent=codex; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-test
 description: 测试执行：读取场景表，执行单元测试+API接口测试+数据兼容验证，输出测试报告。当用户说'跑测试/验证/跑用例/接口测试/单元测试'时使用
 ---
-<!-- generated by harness_deploy.py; core=57436a1f7a795663; overlay=none; agent=codex; do not edit -->
+<!-- generated by harness_deploy.py; core=e26c16edf7594b9b; overlay=none; agent=codex; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose

package/harness/bundles/general/codex/scripts/harness_archive.py

@@ -900,10 +900,22 @@ def resolve_product_archive_identity(
         or ledger.get("finalCommit")
         or ""
     )
+    feature_merge = str(
+        ledger.get("featureMergeHash")
+        or ledger.get("mergeFinalHash")
+        or product
+    ).strip()
+    code, current_head, _ = git_run(project_root, "rev-parse", "HEAD")
+    release_tip = str(
+        ledger.get("releaseTipHash")
+        or (current_head if code == 0 else "")
+        or ledger.get("archiveCommit")
+        or product
+    ).strip()
     archive = (
         archive_commit
         or ledger.get("archiveCommit")
-        or ledger.get("finalCommit")
+        or release_tip
         or product
     )
     tree = str(ledger.get("productTreeHash") or "")
@@ -930,6 +942,8 @@ def resolve_product_archive_identity(
             tree = hashlib.sha256(b"fixture-no-product-tree").hexdigest()
     identity = {
         "productCommit": str(product),
+        "featureMergeHash": feature_merge,
+        "releaseTipHash": release_tip,
         "productTreeHash": str(tree),
         "archiveCommit": str(archive),
         "productTreeHashTruncated": bool(tree_meta.get("truncated")),
@@ -1659,6 +1673,7 @@ def _ledger_unit_tests(ledger: dict[str, Any] | None) -> dict[str, Any]:
 
     run = failures = errors = skipped = 0
     passed_count: int | None = None
+    deselected = 0
     pass_rate: Any = None
     source = "committed"
     counted = False
@@ -1675,6 +1690,7 @@ def _ledger_unit_tests(ledger: dict[str, Any] | None) -> dict[str, Any]:
             "failures",
             "errors",
             "skipped",
+            "deselected",
         )
     ):
         if "total" in metrics:
@@ -1690,6 +1706,7 @@ def _ledger_unit_tests(ledger: dict[str, Any] | None) -> dict[str, Any]:
         failures = int(metrics.get("failed", metrics.get("failures", 0)) or 0)
         errors = int(metrics.get("errors", 0) or 0)
         skipped = int(metrics.get("skipped", 0) or 0)
+        deselected = int(metrics.get("deselected", 0) or 0)
         if "passed" in metrics:
             passed_count = int(metrics.get("passed", 0) or 0)
         pass_rate = metrics.get("passRate")
@@ -1708,6 +1725,7 @@ def _ledger_unit_tests(ledger: dict[str, Any] | None) -> dict[str, Any]:
         failures = int(evidence.get("failures", unit.get("failures", 0)) or 0)
         errors = int(evidence.get("errors", unit.get("errors", 0)) or 0)
         skipped = int(evidence.get("skipped", unit.get("skipped", 0)) or 0)
+        deselected = int(evidence.get("deselected", unit.get("deselected", 0)) or 0)
         pass_rate = evidence.get("passRate") or unit.get("passRate")
         source = "committed"
         counted = run > 0 or failures > 0 or errors > 0 or skipped > 0
@@ -1729,6 +1747,7 @@ def _ledger_unit_tests(ledger: dict[str, Any] | None) -> dict[str, Any]:
         failures = int(unit.get("failures", 0) or 0)
         errors = int(unit.get("errors", 0) or 0)
         skipped = int(unit.get("skipped", 0) or 0)
+        deselected = int(unit.get("deselected", 0) or 0)
         pass_rate = unit.get("passRate")
         source = "committed"
 
@@ -1755,6 +1774,7 @@ def _ledger_unit_tests(ledger: dict[str, Any] | None) -> dict[str, Any]:
         "failures": int(failures or 0),
         "errors": int(errors or 0),
         "skipped": int(skipped or 0),
+        "deselected": int(deselected or 0),
         "passRate": pass_rate if pass_rate is not None else NOT_AVAILABLE,
         "source": source,
     }
@@ -1771,10 +1791,12 @@ def _ledger_api_tests(
     empty = {
         "status": "NOT_RUN",
         "total": 0,
+        "executed": 0,
         "passed": 0,
         "failed": 0,
         "blocked": 0,
         "passRate": NOT_AVAILABLE,
+        "executionRate": NOT_AVAILABLE,
         "source": "not-run",
     }
     if not ledger:
@@ -1853,18 +1875,19 @@ def _ledger_api_tests(
         pass_rate = api.get("passRate")
         source = "committed"
 
-    if pass_rate is None and total > 0:
-        pass_rate = f"{passed / total:.0%}"
-    elif pass_rate is None:
-        pass_rate = NOT_AVAILABLE
+    executed = passed + failed
+    pass_rate = f"{passed / executed:.0%}" if executed > 0 else NOT_AVAILABLE
+    execution_rate = f"{executed / total:.0%}" if total > 0 else NOT_AVAILABLE
 
     return {
         "status": status,
         "total": int(total or 0),
+        "executed": int(executed or 0),
         "passed": int(passed or 0),
         "failed": int(failed or 0),
         "blocked": int(blocked or 0),
-        "passRate": pass_rate if pass_rate is not None else NOT_AVAILABLE,
+        "passRate": pass_rate,
+        "executionRate": execution_rate,
         "source": source,
     }
 
@@ -1937,13 +1960,16 @@ def _typed_test_metrics(entry: dict[str, Any], *, total_key: str) -> dict[str, A
     total = int(metrics.get(total_key, 0) or 0)
     passed = int(metrics.get("passed", 0) or 0)
     failed = int(metrics.get("failed", 0) or 0)
+    executed = passed + failed
     status = str(entry.get("status") or "").upper() or "NOT_RUN"
     out: dict[str, Any] = {
         "status": status,
         "total": total,
+        "executed": executed,
         "passed": passed,
         "failed": failed,
-        "passRate": f"{passed / total:.0%}" if total > 0 else NOT_AVAILABLE,
+        "passRate": f"{passed / executed:.0%}" if executed > 0 else NOT_AVAILABLE,
+        "executionRate": f"{executed / total:.0%}" if total > 0 else NOT_AVAILABLE,
         "source": "committed" if total > 0 else "not-run",
     }
     if "blocked" in metrics:
@@ -1980,6 +2006,17 @@ def build_verification_projection(
     browser_e2e = validations.get("browserE2E")
     if isinstance(browser_e2e, dict):
         projection["browserE2E"] = _typed_test_metrics(browser_e2e, total_key="total")
+    performance = validations.get("performance")
+    if isinstance(performance, dict):
+        projection["performance"] = {
+            "status": str(performance.get("status") or "NOT_RUN").upper(),
+            "metrics": _deepcopy_json(
+                performance.get("metrics")
+                if isinstance(performance.get("metrics"), dict)
+                else {}
+            ),
+            "source": "committed",
+        }
     return projection
 
 
@@ -2142,14 +2179,25 @@ def _verification_checks_from_events(
     return checks
 
 
-def _artifacts_from_events(events: list[dict[str, Any]]) -> list[dict[str, Any]]:
+def _artifacts_from_events(
+    events: list[dict[str, Any]],
+    *,
+    change_dir: Path | None = None,
+) -> list[dict[str, Any]]:
     out: list[dict[str, Any]] = []
     for e in events:
         if e.get("type") != "artifact":
             continue
+        raw_path = str(e.get("path") or "")
+        archived_path = raw_path
+        if change_dir is not None and raw_path:
+            product_copy = change_dir / "artifacts" / "product" / raw_path
+            if not (change_dir / raw_path).is_file() and product_copy.is_file():
+                archived_path = product_copy.relative_to(change_dir).as_posix()
         out.append(
             {
-                "path": e.get("path") or "",
+                "path": archived_path,
+                **({"sourcePath": raw_path} if archived_path != raw_path else {}),
                 "kind": e.get("kind") or "",
                 "phase": e.get("phase") or "",
             }
@@ -2882,7 +2930,7 @@ def collect_summary_data(
             "dbCompatibility": db,
             "coverageDisplay": coverage,
         }
-        for typed_key in ("apiContract", "browserE2E"):
+        for typed_key in ("apiContract", "browserE2E", "performance"):
             if typed_key in projection:
                 data["verification"][typed_key] = projection[typed_key]
         if ci_metrics is not None:
@@ -2982,6 +3030,8 @@ def collect_summary_data(
     if not for_replay:
         identity = resolve_product_archive_identity(change_dir, project=project)
         data["productCommit"] = identity.get("productCommit") or data.get("finalCommit")
+        data["featureMergeHash"] = identity.get("featureMergeHash") or data.get("finalCommit")
+        data["releaseTipHash"] = identity.get("releaseTipHash") or data.get("archiveCommit")
         data["productTreeHash"] = identity.get("productTreeHash")
         data["archiveCommit"] = identity.get("archiveCommit") or data.get("finalCommit")
         data["changeIdentity"] = identity
@@ -3049,6 +3099,8 @@ def collect_summary_data(
     data["gitFacts"] = {
         "baseCommit": data.get("baseCommit") or "",
         "finalCommit": data.get("finalCommit") or "",
+        "featureMergeHash": data.get("featureMergeHash") or "",
+        "releaseTipHash": data.get("releaseTipHash") or "",
         "filesChanged": int(diff_for_facts.get("filesChanged") or 0),
         "insertions": int(diff_for_facts.get("insertions") or 0),
         "deletions": int(diff_for_facts.get("deletions") or 0),
@@ -3069,7 +3121,9 @@ def collect_summary_data(
     if not isinstance(data.get("artifacts"), list):
         data["artifacts"] = []
     if not for_replay:
-        data["artifacts"] = _artifacts_from_events(projected_events)
+        data["artifacts"] = _artifacts_from_events(
+            projected_events, change_dir=change_dir
+        )
 
     data["reviewSummary"] = _review_summary(
         change_dir,
@@ -3151,7 +3205,9 @@ def collect_summary_data(
         # Cannot invent commands
         pass
     verification_checks = _verification_checks_from_events(projected_events, ledger)
-    pipeline_artifacts = _artifacts_from_events(projected_events)
+    pipeline_artifacts = _artifacts_from_events(
+        projected_events, change_dir=change_dir
+    )
     if not sources:
         sources = [NOT_AVAILABLE]
 
@@ -4012,6 +4068,7 @@ def artifact_preflight(change_dir: Path) -> dict[str, Any]:
     if not events_p.is_file():
         return {"ok": True, "items": [], "blocking": []}
     change_id = change_dir.name
+    project_root = find_project_root(change_dir)
     for line in events_p.read_text(encoding="utf-8").splitlines():
         try:
             event = json.loads(line)
@@ -4058,16 +4115,56 @@ def artifact_preflight(change_dir: Path) -> dict[str, Any]:
                 "correction": f"append correction --target-event-id {event_id} --target-field path --new-value-json \"{canonical}\"",
             })
             continue
-        # Change-relative path: OK.
-        items.append({
+        change_file = change_dir / path
+        if change_file.is_file():
+            items.append({
+                "eventId": event_id,
+                "category": "file-backed",
+                "path": path,
+                "exists": True,
+            })
+            continue
+        repository_file = project_root / path
+        if repository_file.is_file():
+            items.append({
+                "eventId": event_id,
+                "category": "repository-file",
+                "path": path,
+                "archivePath": f"artifacts/product/{path}",
+                "exists": True,
+            })
+            continue
+        item = {
             "eventId": event_id,
-            "category": "file-backed",
+            "category": "blocking",
             "path": path,
-            "exists": (change_dir / path).is_file(),
-        })
+            "kind": kind,
+            "reason": "artifact file not found in change or project root",
+        }
+        items.append(item)
+        blocking.append(item)
     return {"ok": not blocking, "items": items, "blocking": blocking}
 
 
+def materialize_repository_artifacts(change_dir: Path) -> dict[str, Any]:
+    """Copy project-root business artifacts into the immutable archive namespace."""
+    change_dir = change_dir.resolve()
+    project_root = find_project_root(change_dir)
+    preflight = artifact_preflight(change_dir)
+    copied: list[str] = []
+    for item in preflight.get("items") or []:
+        if item.get("category") != "repository-file":
+            continue
+        source = (project_root / str(item["path"])).resolve()
+        target = (change_dir / str(item["archivePath"])).resolve()
+        if not source.is_relative_to(project_root) or not target.is_relative_to(change_dir):
+            raise ValueError(f"artifact materialization escaped boundary: {item['path']}")
+        target.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copy2(source, target)
+        copied.append(target.relative_to(change_dir).as_posix())
+    return {"ok": True, "copied": sorted(copied)}
+
+
 def run_knowledge_poststeps(project_root: Path) -> dict[str, Any]:
     results: dict[str, Any] = {"ran": False, "steps": [], "warnings": []}
     if not KNOWLEDGE_SCRIPT.is_file():
@@ -4343,6 +4440,16 @@ def cmd_finalize(
         warnings.append(f"cleanup failed: {exc}")
         payload["steps"]["cleanup"] = {"ok": False, "error": str(exc)}
 
+    # Product/business artifacts may live at repository-relative paths. Freeze
+    # byte-for-byte copies inside the staged archive before either manifest.
+    try:
+        materialized = materialize_repository_artifacts(work_dir)
+        payload["steps"]["artifact_materialization"] = materialized
+    except (OSError, ValueError) as exc:
+        payload["error"] = f"artifact materialization failed: {exc}"
+        _restore_finalize_failure()
+        return 1, payload
+
     # --- 1. before-manifest ---
     before_path = work_dir / "evidence" / "archive-manifest-before.json"
     try:

package/harness/bundles/general/codex/scripts/harness_integration.py

@@ -257,6 +257,42 @@ def journal_path(project_root: Path, transaction_id: str) -> Path:
     return journal_dir(project_root, transaction_id) / "journal.json"
 
 
+def _write_verify_log(
+    project_root: Path,
+    transaction_id: str,
+    index: int,
+    *,
+    command: Sequence[str],
+    resolved_command: Sequence[str],
+    started: dt.datetime,
+    finished: dt.datetime,
+    exit_code: int | None,
+    stdout: str | bytes | None = None,
+    stderr: str | bytes | None = None,
+    error: str | None = None,
+) -> str:
+    def as_text(value: str | bytes | None) -> str:
+        if isinstance(value, bytes):
+            return value.decode("utf-8", errors="replace")
+        return value or ""
+
+    path = journal_dir(project_root, transaction_id) / "logs" / f"verify-{index + 1}.log"
+    path.parent.mkdir(parents=True, exist_ok=True)
+    lines = [
+        f"command: {json.dumps(list(command), ensure_ascii=False)}",
+        f"resolvedCommand: {json.dumps(list(resolved_command), ensure_ascii=False)}",
+        f"startedAt: {started.isoformat(timespec='milliseconds')}",
+        f"finishedAt: {finished.isoformat(timespec='milliseconds')}",
+        f"durationMs: {int((finished - started).total_seconds() * 1000)}",
+        f"exitCode: {exit_code if exit_code is not None else 'null'}",
+    ]
+    if error:
+        lines.append(f"error: {error}")
+    lines.extend(["--- stdout ---", as_text(stdout), "--- stderr ---", as_text(stderr)])
+    path.write_text("\n".join(lines) + "\n", encoding="utf-8", newline="\n")
+    return path.relative_to(project_root).as_posix()
+
+
 def load_journal(project_root: Path, transaction_id: str) -> dict[str, Any]:
     path = journal_path(project_root, transaction_id)
     if not path.is_file():
@@ -965,7 +1001,7 @@ class IntegrationTransaction:
                 )
             intg_root = Path(journal["integrationRoot"]).resolve()
             results: list[dict[str, Any]] = []
-            for command in commands:
+            for index, command in enumerate(commands):
                 executable_command = _normalize_verify_command(command)
                 started = dt.datetime.now().astimezone()
                 try:
@@ -979,8 +1015,21 @@ class IntegrationTransaction:
                         check=False,
                         timeout=timeout_seconds,
                     )
-                except subprocess.TimeoutExpired:
+                except subprocess.TimeoutExpired as exc:
                     finished = dt.datetime.now().astimezone()
+                    log_path = _write_verify_log(
+                        self.project_root,
+                        self.transaction_id,
+                        index,
+                        command=command,
+                        resolved_command=executable_command,
+                        started=started,
+                        finished=finished,
+                        exit_code=None,
+                        stdout=exc.stdout,
+                        stderr=exc.stderr,
+                        error=f"timed out after {timeout_seconds}s",
+                    )
                     results.append(
                         {
                             "command": list(command),
@@ -993,6 +1042,7 @@ class IntegrationTransaction:
                             "durationMs": int(
                                 (finished - started).total_seconds() * 1000
                             ),
+                            "logPath": log_path,
                         }
                     )
                     journal["verifyResults"] = results
@@ -1002,6 +1052,17 @@ class IntegrationTransaction:
                     )
                 except FileNotFoundError as exc:
                     finished = dt.datetime.now().astimezone()
+                    log_path = _write_verify_log(
+                        self.project_root,
+                        self.transaction_id,
+                        index,
+                        command=command,
+                        resolved_command=executable_command,
+                        started=started,
+                        finished=finished,
+                        exit_code=None,
+                        error=str(exc),
+                    )
                     results.append(
                         {
                             "command": list(command),
@@ -1013,6 +1074,7 @@ class IntegrationTransaction:
                             "durationMs": int(
                                 (finished - started).total_seconds() * 1000
                             ),
+                            "logPath": log_path,
                         }
                     )
                     journal["verifyResults"] = results
@@ -1021,6 +1083,18 @@ class IntegrationTransaction:
                         f"verification executable not found: {executable_command[0]}"
                     ) from exc
                 finished = dt.datetime.now().astimezone()
+                log_path = _write_verify_log(
+                    self.project_root,
+                    self.transaction_id,
+                    index,
+                    command=command,
+                    resolved_command=executable_command,
+                    started=started,
+                    finished=finished,
+                    exit_code=proc.returncode,
+                    stdout=proc.stdout,
+                    stderr=proc.stderr,
+                )
                 results.append(
                     {
                         "command": list(command),
@@ -1032,6 +1106,7 @@ class IntegrationTransaction:
                         "durationMs": int(
                             (finished - started).total_seconds() * 1000
                         ),
+                        "logPath": log_path,
                     }
                 )
                 if proc.returncode != 0:

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "cursor",
-  "coreHash": "5276e9170462644d"
+  "coreHash": "170e634f2d9f865c"
 }

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

@@ -3,7 +3,7 @@ name: harness-archive
 description: 归档所有变更产出（计划/测试报告/审查/SQL/API文档）到
   .harness/archive/，含归档元数据和可视化最终总结。使用场景：归档、完成归档、收尾、打包产出物
 ---
-<!-- generated by harness_deploy.py; core=5276e9170462644d; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
 # harness-archive — 变更归档
 
 ## Purpose

package/harness/bundles/general/cursor/harness-archive/templates/render-summary.mjs

@@ -57,6 +57,7 @@ const stages = Object.entries(record(data.stageStatus));
 const verification = record(data.verification);
 const unit = record(verification.unitTests);
 const api = record(verification.apiTests);
+const performance = record(verification.performance);
 const durations = record(data.durations);
 const durationStages = list(durations.stages);
 const timing = record(data.timing);
@@ -84,9 +85,10 @@ const reasonHtml = statusReasons.length
 
 const stageHtml = stages.map(([name, status]) => `<div class="row"><span>${esc(name)}</span>${pill(status)}</div>`).join("") || '<p class="empty">没有阶段状态记录</p>';
 const verificationHtml = [
-  ["单元测试", unit.status || ((number(unit.failures) + number(unit.errors)) > 0 ? "FAIL" : (number(unit.run) > 0 ? "OK" : "NOT_RUN")), `${number(unit.run)} 个 · ${number(unit.failures)} 失败 · ${number(unit.errors)} 错误`],
-  ["API 测试", api.status || "NOT_RUN", `${number(api.passed)}/${number(api.total)} 通过 · ${number(api.blocked)} 阻塞`],
-  ["数据库兼容", verification.dbCompatibility || "NOT_RUN", verification.coverageDisplay || "未记录覆盖率"]
+  ["单元测试", unit.status || ((number(unit.failures) + number(unit.errors)) > 0 ? "FAIL" : (number(unit.run) > 0 ? "OK" : "NOT_RUN")), `${number(unit.run)} 个 · ${number(unit.failures)} 失败 · ${number(unit.errors)} 错误 · ${number(unit.skipped)} 跳过 · ${number(unit.deselected)} 未选择`],
+  ["API 测试", api.status || "NOT_RUN", `${number(api.executed)}/${number(api.total)} 已执行 · ${number(api.passed)} 通过 · ${number(api.failed)} 失败 · ${number(api.blocked)} 阻塞 · 通过率 ${api.passRate || "N/A"} · 执行率 ${api.executionRate || "N/A"}`],
+  ["数据库兼容", verification.dbCompatibility || "NOT_RUN", verification.coverageDisplay || "未记录覆盖率"],
+  ["性能验证", performance.status || "NOT_RUN", Object.keys(record(performance.metrics)).length ? JSON.stringify(performance.metrics) : "未记录性能指标"]
 ].map(([name, status, note]) => `<div class="row"><div><strong>${esc(name)}</strong><small>${esc(note)}</small></div>${pill(status)}</div>`).join("");
 const durationHtml = durationStages.map((item) => {
   const width = Math.max(2, Math.round(number(item.minutes) / maxMinutes * 100));
@@ -112,7 +114,7 @@ const html = `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"><met
 <details><summary>变更文件（${files.length}）</summary><div><table><thead><tr><th>文件</th><th>新增</th><th>删除</th></tr></thead><tbody>${fileRows}</tbody></table></div></details>
 <details><summary>执行时间线与工具交接（${timeline.length}）</summary><div><table><thead><tr><th>阶段</th><th>尝试</th><th>状态</th><th>来源 / 摘要</th></tr></thead><tbody>${timelineRows}</tbody></table></div></details>
 <details><summary>命令证据（${commands.length}）</summary><div><table><thead><tr><th>阶段</th><th>命令</th><th>结果</th></tr></thead><tbody>${commandRows}</tbody></table></div></details>
-<details><summary>技术元数据</summary><div><dl><dt>产品提交</dt><dd><code>${esc(data.productCommit || data.finalCommit || "N/A")}</code></dd><dt>产品树哈希</dt><dd><code>${esc(data.productTreeHash || "N/A")}</code></dd><dt>归档提交</dt><dd><code>${esc(data.archiveCommit || data.finalCommit || "N/A")}</code></dd><dt>基线提交</dt><dd><code>${esc(data.baseCommit || "N/A")}</code></dd><dt>Git 范围</dt><dd><code>${esc(diff.range || "N/A")}</code></dd><dt>报告数据版本</dt><dd>${esc(data.schemaVersion || "N/A")}</dd><dt>事实来源</dt><dd>${esc(list(record(data.reportPipeline).sources).join(" · ") || "N/A")}</dd></dl></div></details>
+<details><summary>技术元数据</summary><div><dl><dt>功能合并提交</dt><dd><code>${esc(data.featureMergeHash || data.productCommit || data.finalCommit || "N/A")}</code></dd><dt>发布线尖端</dt><dd><code>${esc(data.releaseTipHash || data.archiveCommit || "N/A")}</code></dd><dt>产品提交</dt><dd><code>${esc(data.productCommit || data.finalCommit || "N/A")}</code></dd><dt>产品树哈希</dt><dd><code>${esc(data.productTreeHash || "N/A")}</code></dd><dt>归档提交</dt><dd><code>${esc(data.archiveCommit || data.finalCommit || "N/A")}</code></dd><dt>基线提交</dt><dd><code>${esc(data.baseCommit || "N/A")}</code></dd><dt>Git 范围</dt><dd><code>${esc(diff.range || "N/A")}</code></dd><dt>报告数据版本</dt><dd>${esc(data.schemaVersion || "N/A")}</dd><dt>事实来源</dt><dd>${esc(list(record(data.reportPipeline).sources).join(" · ") || "N/A")}</dd></dl></div></details>
 </main></body></html>`;
 
 fs.mkdirSync(path.dirname(outPath), { recursive: true });

package/harness/bundles/general/cursor/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=5276e9170462644d; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
 # harness-codebase-map — 代码库地图
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-knowledge-ingest
 description: 从 .harness/archive 归档整理、同步和维护项目知识索引。适用场景：ingest knowledge、sync
   knowledge、rebuild knowledge index、promote knowledge、确认知识条目、检查知识库是否过期。
 ---
-<!-- generated by harness_deploy.py; core=5276e9170462644d; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
 # harness-knowledge-ingest
 
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。

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

@@ -3,7 +3,7 @@ name: harness-knowledge-query
 description: 根据新需求、设计任务、代码修改请求或问题排查，在规划和编码前查询 .harness/knowledge
   历史上下文。适用场景：query knowledge、查找历史需求、根据归档理解需求、继续之前类似开发、生成需求上下文包。
 ---
-<!-- generated by harness_deploy.py; core=5276e9170462644d; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
 # harness-knowledge-query
 
 并行 change 中查询必须传 `--change <change-id>`；成功后以该 change 的 `meta/knowledge-context.json` 为稳定指针。全局 `context-packs/latest.json` 仅向后兼容，不得用于判断多个 active change 的上下文归属。

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

@@ -2,7 +2,7 @@
 name: harness-plan
 description: 将需求转化为设计文档+实施计划+完整测试场景表，必须在编码前完成。使用场景：需求分析、feature plan、技术方案设计、实现方案规划
 ---
-<!-- generated by harness_deploy.py; core=5276e9170462644d; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
 # harness-plan — 需求规划
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-review
 description: 6维度代码审查（架构/安全/规范/兼容/测试/性能），对照项目规则（见
   .harness/context-index.json）和测试场景表，在隔离上下文运行。使用场景：代码审查、提交前检查、合并评审
 ---
-<!-- generated by harness_deploy.py; core=5276e9170462644d; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
 # harness-review — 代码审查
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-run
 description: 按变更簇执行 TDD 编码循环（RED→GREEN→REFACTOR→编译验证），逐变更簇实现计划中的任务。使用场景：开始编码、实现功能、写代码、TDD 编码
 ---
-<!-- generated by harness_deploy.py; core=5276e9170462644d; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
 # harness-run — 需求编码
 
 ## Purpose

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

@@ -3,7 +3,7 @@ name: harness-submit
 description: 最终提交封装：验证→中文 commit→提交/推送；worktree 模式含 --no-ff
   合并回主分支。使用场景：提交代码、commit、push、合并分支、merge to main、完成开发
 ---
-<!-- generated by harness_deploy.py; core=5276e9170462644d; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-sync
 description: 检查并更新项目AI元数据（CodeGraph索引、harness-codebase-map分析、CLAUDE.md、AGENTS.md、.harness/完整性），确保Claude对代码库的理解与最新代码一致。当用户说'同步/更新索引/刷新元数据/检查一致性'时使用
 ---
-<!-- generated by harness_deploy.py; core=5276e9170462644d; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
 # harness-sync — 元数据同步
 
 ## Purpose

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

@@ -2,7 +2,7 @@
 name: harness-test
 description: 测试执行：读取场景表，执行单元测试+API接口测试+数据兼容验证，输出测试报告。当用户说'跑测试/验证/跑用例/接口测试/单元测试'时使用
 ---
-<!-- generated by harness_deploy.py; core=5276e9170462644d; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=170e634f2d9f865c; overlay=none; agent=cursor; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose