npm - @hunter-harness/workflow-harness - Versions diffs - 0.2.24 → 0.2.25 - Mend

@hunter-harness/workflow-harness 0.2.24 → 0.2.25

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 (130) hide show

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

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "claude-code",
-  "coreHash": "8fdeda6094f4f0a5"
+  "coreHash": "7a8c4cdf546df376"
 }

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

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

package/harness/bundles/general/claude-code/harness-archive/templates/render-summary.mjs CHANGED Viewed

@@ -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/claude-code/harness-codebase-map/SKILL.md CHANGED Viewed

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

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

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=8fdeda6094f4f0a5; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=7a8c4cdf546df376; overlay=none; agent=claude-code; do not edit -->
 # harness-knowledge-ingest
 从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识，生成并维护本地 `.harness/knowledge/` 索引。

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

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=8fdeda6094f4f0a5; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=7a8c4cdf546df376; overlay=none; agent=claude-code; 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/claude-code/harness-plan/SKILL.md CHANGED Viewed

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

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

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

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

@@ -21,7 +21,7 @@ disallowed-tools:
   - Bash(curl *)
   - Bash(codegraph *)
 ---
-<!-- generated by harness_deploy.py; core=8fdeda6094f4f0a5; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=7a8c4cdf546df376; overlay=none; agent=claude-code; do not edit -->
 # harness-run — 需求编码
 ## Purpose

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

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

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

@@ -19,7 +19,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=8fdeda6094f4f0a5; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=7a8c4cdf546df376; overlay=none; agent=claude-code; do not edit -->
 # harness-sync — 元数据同步
 ## Purpose

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

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

package/harness/bundles/general/claude-code/scripts/harness_archive.py CHANGED Viewed

@@ -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/claude-code/scripts/harness_integration.py CHANGED Viewed

@@ -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/codebuddy/.harness-build.json CHANGED Viewed

@@ -2,5 +2,5 @@
   "schemaVersion": 1,
   "overlay": "none",
   "agent": "codebuddy",
-  "coreHash": "8fdeda6094f4f0a5"
+  "coreHash": "7a8c4cdf546df376"
 }

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

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

package/harness/bundles/general/codebuddy/harness-archive/templates/render-summary.mjs CHANGED Viewed

@@ -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 });