@hunter-harness/workflow-harness 0.2.54 → 0.2.55

package/harness/bundles/java/cursor/scripts/harness_gate.py

@@ -30,6 +30,7 @@ if str(SCRIPTS_DIR) not in sys.path:
     sys.path.insert(0, str(SCRIPTS_DIR))
 
 import harness_change as hc  # noqa: E402
+import harness_context as hctx  # noqa: E402
 import harness_events as he  # noqa: E402
 import harness_events_sync as hes  # noqa: E402
 import harness_ledger as hl  # noqa: E402
@@ -1602,6 +1603,18 @@ def append_phase_event(
     auto_sealed: list[dict[str, Any]] = []
     with he.event_file_lock(lock_path):
         existing = he.load_events(events_file)
+        phase_attempts = he.split_phase_attempts(
+            [event for event in existing if event.get("phase") == phase]
+        )
+        latest_attempt = max(
+            (
+                int(item.get("attempt"))
+                for item in phase_attempts
+                if isinstance(item.get("attempt"), int)
+            ),
+            default=0,
+        )
+        event_attempt = latest_attempt + 1 if type_ == "phase.start" else latest_attempt or 1
         args = argparse.Namespace(
             phase=phase,
             type=type_,
@@ -1619,12 +1632,18 @@ def append_phase_event(
             decision=None,
             reason=None,
             run_id=run_id,
-            attempt=None,
+            attempt=event_attempt,
             executor_tool=executor_tool,
             executor_agent=executor_agent,
             executor_model=executor_model,
             handoff_from_tool=None,
             handoff_reason=None,
+            execution_mode=None,
+            decision_reason_code=None,
+            fallback_reason_code=None,
+            trigger=("fixback" if "fixback" in note.lower() else None),
+            from_phase=("review" if phase == "run" and "fixback" in note.lower() else None),
+            result_status=None,
         )
         event = he.build_event(args, existing)
         if identity:
@@ -1655,6 +1674,7 @@ def append_phase_event(
         content = he.render_execution_log(events)
         log_path = he.write_execution_log(change_dir, content)
         rendered = True
+    he.nudge_remote_sync(change_dir)
     return {
         "ok": True,
         "eventId": event.get("id"),
@@ -1702,6 +1722,80 @@ def _phase_event_exists(change_dir: Path, phase: str, type_: str, run_id: str) -
     )
 
 
+def _latest_phase_end(
+    change_dir: Path,
+    phase: str,
+    run_id: str | None = None,
+) -> dict[str, Any] | None:
+    for event in reversed(he.load_events(he.events_path(change_dir))):
+        if event.get("phase") != phase or event.get("type") != "phase.end":
+            continue
+        if run_id and event.get("run_id") != run_id:
+            continue
+        return event
+    return None
+
+
+def _terminal_matches_context_session(
+    project: Path,
+    change_id: str,
+    phase: str,
+    terminal: dict[str, Any],
+) -> bool:
+    view = hctx.context_view(project, change_id)
+    current = view.get("current") if isinstance(view, dict) else None
+    if not isinstance(current, dict) or current.get("phase") != phase:
+        return False
+    prepared_at = he.parse_timestamp(current.get("preparedAt"))
+    terminal_at = he.parse_timestamp(
+        terminal.get("timestamp") or terminal.get("occurred_at")
+    )
+    return (
+        prepared_at is not None
+        and terminal_at is not None
+        and terminal_at >= prepared_at
+    )
+
+
+def _close_context_handoff(
+    project: Path,
+    change_id: str,
+    args: argparse.Namespace,
+    *,
+    status: str,
+) -> dict[str, Any] | None:
+    to_phase = getattr(args, "to_phase", None)
+    if not to_phase:
+        return None
+    try:
+        return hctx.close_transition(
+            project,
+            change_id,
+            from_phase=args.phase,
+            to_phase=str(to_phase),
+            executor=getattr(args, "executor", None),
+            artifacts=list(getattr(args, "artifact", None) or []),
+            status=status,
+        )
+    except Exception as exc:  # noqa: BLE001 — phase close remains locally durable
+        return {
+            "ok": False,
+            "code": "CONTEXT_HANDOFF_FAILED",
+            "message": str(exc),
+        }
+
+
+def _sync_after_phase_close(project: Path, change_dir: Path) -> dict[str, Any]:
+    try:
+        return hes.auto_events_sync(project, change_dir)
+    except Exception as exc:  # noqa: BLE001 — remote sync is recoverable
+        return {
+            "ok": False,
+            "code": "PLATFORM_EVENTS_SYNC_WARN",
+            "warning": f"events-sync hook failed: {exc}",
+        }
+
+
 def _validate_scenario_coverage(change_dir: Path) -> dict[str, Any]:
     """C9: validate all ledger-required scenarios are covered by ledger entries.
 
@@ -2266,6 +2360,48 @@ def cmd_close(args: argparse.Namespace) -> int:
     explicit_run_id = args.run_id or os.environ.get("HUNTER_HARNESS_RUN_ID")
     current_lease = hc.inspect_lease(project, resolved["changeId"])
     if current_lease is None:
+        terminal = _latest_phase_end(change_dir, args.phase, explicit_run_id)
+        if (
+            getattr(args, "to_phase", None)
+            and terminal is not None
+            and _terminal_matches_context_session(
+                project, str(resolved["changeId"]), args.phase, terminal
+            )
+        ):
+            terminal_status = str(terminal.get("status") or args.status)
+            handoff = _close_context_handoff(
+                project,
+                str(resolved["changeId"]),
+                args,
+                status=terminal_status,
+            )
+            monitor = _sync_after_phase_close(project, change_dir)
+            if not isinstance(handoff, dict) or not handoff.get("ok"):
+                return emit_error(
+                    "PHASE_HANDOFF_PENDING",
+                    "phase gate is closed, but context handoff still needs attention",
+                    as_json=as_json,
+                    extra={
+                        "localCloseComplete": True,
+                        "retryable": True,
+                        "contextHandoff": handoff,
+                        "platformMonitor": monitor,
+                    },
+                )
+            emit(
+                {
+                    "ok": True,
+                    "code": "PHASE_CLOSE_RESUMED",
+                    "phase": args.phase,
+                    "status": terminal_status,
+                    "changeId": resolved["changeId"],
+                    "localCloseComplete": True,
+                    "contextHandoff": handoff,
+                    "platformMonitor": monitor,
+                },
+                as_json=as_json,
+            )
+            return 0
         return emit_error("LEASE_ABSENT", "no active lease for phase close", as_json=as_json)
     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:
@@ -2597,6 +2733,29 @@ def cmd_close(args: argparse.Namespace) -> int:
         capsule["closeStatus"] = close_status
         write_phase_capsule(change_dir, args.phase, run_id, capsule)
 
+    context_handoff = _close_context_handoff(
+        project,
+        str(resolved["changeId"]),
+        args,
+        status=close_status,
+    )
+    platform_monitor = _sync_after_phase_close(project, change_dir)
+    if isinstance(context_handoff, dict) and not context_handoff.get("ok"):
+        return emit_error(
+            "PHASE_HANDOFF_PENDING",
+            "phase gate closed locally, but context handoff failed; retry the same close command",
+            as_json=as_json,
+            extra={
+                "localCloseComplete": True,
+                "retryable": True,
+                "phase": args.phase,
+                "status": close_status,
+                "changeId": resolved["changeId"],
+                "contextHandoff": context_handoff,
+                "platformMonitor": platform_monitor,
+            },
+        )
+
     payload = {
         "ok": True,
         "code": close_code,
@@ -2612,6 +2771,8 @@ def cmd_close(args: argparse.Namespace) -> int:
         "lease": release,
         "gateSeverityMode": severity_mode,
         "gateWarnings": gate_warnings,
+        "contextHandoff": context_handoff,
+        "platformMonitor": platform_monitor,
     }
     emit(payload, as_json=as_json)
     return 0
@@ -2806,6 +2967,9 @@ def build_parser() -> argparse.ArgumentParser:
     p_close.add_argument("--run-id", default=None)
     p_close.add_argument("--task", type=int, default=None)
     p_close.add_argument("--note", default="")
+    p_close.add_argument("--to-phase", default=None)
+    p_close.add_argument("--executor", default=None)
+    p_close.add_argument("--artifact", action="append", default=[])
     p_close.set_defaults(func=cmd_close)
 
     p_classify = sub.add_parser("classify", parents=[shared])

package/harness/bundles/java/cursor/scripts/harness_ledger.py

@@ -1160,6 +1160,8 @@ _DYNAMIC_OWN_DIRS = ("events.ndjson", "logs", "evidence", "reports", "runtime",
 
 def _matches_ownership_path(rel: str, declared: Any) -> bool:
     scope = str(declared).replace("\\", "/").strip("/")
+    if scope.endswith("/**"):
+        scope = scope[:-3].rstrip("/")
     if not scope:
         return False
     normalized = rel.replace("\\", "/").strip("/")

package/harness/bundles/java/cursor/scripts/harness_plan_finalize.py

@@ -1155,6 +1155,7 @@ def finalize_plan(
                 "artifactsHash": validation["artifactsHash"],
                 "files": validation["files"],
                 "receiptPath": str(receipt_path),
+                "artifactRef": "meta/plan-finalization.json",
             }
 
     lock_path.parent.mkdir(parents=True, exist_ok=True)
@@ -1253,6 +1254,7 @@ def finalize_plan(
             "artifactsHash": validation["artifactsHash"],
             "files": validation["files"],
             "receiptPath": str(receipt_path),
+            "artifactRef": "meta/plan-finalization.json",
             "executionLogPath": str(harness_events.execution_log_path(change_dir)),
         }
     except OSError as exc:

package/harness/bundles/java/cursor/scripts/harness_test_guard.py

@@ -1593,18 +1593,15 @@ def close(project: Path | str, change_dir: Path | str) -> dict[str, Any]:
             [],
             error=str(exc),
         )
-    if (
+    profile_changed = bool(
         isinstance(snapshot.get("profileFingerprint"), str)
         and snapshot["profileFingerprint"] != current_profile_fingerprint
-    ):
-        return _result(False, action, "PROFILE_CHANGED", [])
+    )
     baseline_commit = _snapshot_baseline_commit(
         project_root,
         change_root,
         snapshot,
     )
-    profile_changed = False
-
     before_entries = snapshot.get("files")
     if not isinstance(before_entries, list):
         return _result(False, action, "SNAPSHOT_INVALID", [])
@@ -1682,11 +1679,21 @@ def close(project: Path | str, change_dir: Path | str) -> dict[str, Any]:
             return result
 
     recorded = [rel for rel, _ in touched]
-    reconciliation = _reconcile_close_manifest(
-        project_root,
-        change_root,
-        set(recorded),
-        baseline_commit,
+    reconciliation = (
+        {
+            "ok": True,
+            "code": "PROFILE_REBASED_MANIFEST_PRESERVED",
+            "removedCurrentTouches": 0,
+            "deletedEntries": 0,
+            "preservedForeignEntries": 0,
+        }
+        if profile_changed
+        else _reconcile_close_manifest(
+            project_root,
+            change_root,
+            set(recorded),
+            baseline_commit,
+        )
     )
     if not reconciliation.get("ok"):
         return _result(
@@ -1696,40 +1703,26 @@ def close(project: Path | str, change_dir: Path | str) -> dict[str, Any]:
             list(reconciliation.get("files") or []),
         )
 
-    # Cross-check (retro §5.10): if the manifest has active entries for this
-    # change but close computed recordedCount=0, the snapshot/manifest/diff
-    # are inconsistent. Fail closed instead of silently returning success.
-    manifest_path = _manifest_path(change_root)
-    if manifest_path is not None and manifest_path.is_file():
-        try:
-            manifest = _read_json(manifest_path)
-        except (OSError, json.JSONDecodeError):
-            manifest = None
-        if isinstance(manifest, dict):
-            manifest_files = manifest.get("files")
-            if isinstance(manifest_files, list):
-                is_v2 = manifest.get("schemaVersion") == 2
-                change_id = change_root.name
-                active_entries = [
-                    f for f in manifest_files
-                    if isinstance(f, dict)
-                    and f.get("reason") in ("tdd-created", "test-updated", "stale-test-repair")
-                    and (
-                        not is_v2
-                        or f.get("introducedBy") == change_id
-                        or change_id in (f.get("touchedBy") or [])
-                    )
-                ]
-                if active_entries and not recorded:
-                    return _result(
-                        False,
-                        action,
-                        "MANIFEST_DIFF_HASH_MISMATCH",
-                        [],
-                        manifestEntries=len(active_entries),
-                        recordedCount=0,
-                        detail="manifest has active entries but close computed 0 recorded tests",
-                    )
+    # A manifest is change-wide and intentionally survives phase boundaries.
+    # Therefore pre-existing entries with no new diff are consistent and must
+    # not force a test-guard reset. When the build profile changes mid-phase,
+    # retain the diff result and rebaseline the reusable snapshot atomically.
+    if profile_changed:
+        snapshot.update(
+            {
+                "profileFingerprint": current_profile_fingerprint,
+                "capturedAt": time.strftime("%Y-%m-%dT%H:%M:%S"),
+                "files": [
+                    {
+                        "path": rel,
+                        "sha256": digest,
+                        "ignored": _is_ignored(project_root, rel),
+                    }
+                    for rel, digest in sorted(current.items())
+                ],
+            }
+        )
+        _write_json(snapshot_path, snapshot)
 
     return _result(
         True,

package/harness/manifests/general/claude-code.json

@@ -2,9 +2,9 @@
   "schema_version": 2,
   "profile": "general",
   "adapter": "claude-code",
-  "bundle_version": "0.2.42",
+  "bundle_version": "0.2.44",
   "requires": {
-    "minimumCliVersion": "0.2.58",
+    "minimumCliVersion": "0.2.60",
     "capabilities": [
       "sync@2",
       "rules-sync@1",
@@ -23,7 +23,7 @@
   "files": [
     {
       "path": ".harness-build.json",
-      "sha256": "c8c2ab0fc8852cdaa9059a7f5f52eb4701ba20b0fc97cc359ef454f06c1a34ad"
+      "sha256": "489494066d32ece3ef71e7753f8d006a54463751d95b26903613076185420e12"
     },
     {
       "path": "agents/harness-evaluator.md",
@@ -95,7 +95,7 @@
     },
     {
       "path": "harness-archive/SKILL.md",
-      "sha256": "b089ccbe9d9bfa2e8d44f9046065575043d9dd62925b2dbfa7315695a6445d0d"
+      "sha256": "8bdecd1b5470e10c0e907caf036bf39efb04cfd1d8792765bab5931292003dc9"
     },
     {
       "path": "harness-archive/templates/render-summary.mjs",
@@ -115,7 +115,7 @@
     },
     {
       "path": "harness-codebase-map/SKILL.md",
-      "sha256": "af08fd248b95336137e4298d92fb549aac6a9a6d2056b8b672d51d18efc7459b"
+      "sha256": "16009fa030c6e719a23a5f7e1b3fa990683ac5981d61536e6e0cb8600f6af127"
     },
     {
       "path": "harness-codebase-map/templates/ARCHITECTURE.md",
@@ -155,15 +155,15 @@
     },
     {
       "path": "harness-knowledge-ingest/SKILL.md",
-      "sha256": "e402d7c4852017146c14057569533071a1fca63da6f9ca246f5a5832806cda17"
+      "sha256": "74685dc48ba432cf51ba522dda7b588915e58406b1e4796a15d911b7855e6294"
     },
     {
       "path": "harness-knowledge-query/SKILL.md",
-      "sha256": "fa26ce71b081b4f7eaaadfb9c62e4c246180fca2ec82eb3afa2dd1334531c625"
+      "sha256": "69d6700228d3ddbe1f3906dd55d37619471b5e3bf4b7b05b8f9982afc2a55d8c"
     },
     {
       "path": "harness-plan/checklist.md",
-      "sha256": "501e5e73c973e845134a94bd00834274f702d7c45be4e4f1b0fc63d8f9bd0945"
+      "sha256": "03584061a5d51b9c4349f13cbe66e757dd29bfc64ed6a4510f0bd731afd76568"
     },
     {
       "path": "harness-plan/protocols.md",
@@ -175,7 +175,7 @@
     },
     {
       "path": "harness-plan/SKILL.md",
-      "sha256": "70e272c72ca7a554ceb31a17fb3adb6dc8434287a7f0c1d790e06fe0ca05f4d7"
+      "sha256": "f4b5a1d0fe472fd5b957a3a99af2299fa18f3e8c08c64088980804a781dea3c0"
     },
     {
       "path": "harness-review/checklist.md",
@@ -191,7 +191,7 @@
     },
     {
       "path": "harness-review/SKILL.md",
-      "sha256": "8b63724a4cb8ae089ef6f6554509f24a56bb0826eee4ad39d139cd37e1b93e68"
+      "sha256": "e66dbec214193999d4697461d241de8629f597ad7916101e8ad986485326fe1c"
     },
     {
       "path": "harness-run/checklist.md",
@@ -203,11 +203,11 @@
     },
     {
       "path": "harness-run/reference.md",
-      "sha256": "b6887480549e86434d9cfce0003ffe698e81e8ed0b63512e303278f21267748b"
+      "sha256": "b034bab5f5f8b9a39cebc705bd8e0d3f5d7065dc0a0070f64499dc81f9d7fd67"
     },
     {
       "path": "harness-run/SKILL.md",
-      "sha256": "f21b1d277020b30ed34af7e36bbaf9bcff21d2aea50b72ec6c71332670697236"
+      "sha256": "8374c2f0d3b298fac04b6d85858b93d385db6de693efd0453d5f8afff87fa139"
     },
     {
       "path": "harness-submit/checklist.md",
@@ -219,7 +219,7 @@
     },
     {
       "path": "harness-submit/SKILL.md",
-      "sha256": "c7c72c647d12d6d1454e843174702fea6f13d2d890fd5d4412a833c9111ddc83"
+      "sha256": "2630ee53df84f00ac5e6d3871a180affb8c7c976d1185cef9e0f53be74ba0ad7"
     },
     {
       "path": "harness-sync/reference.md",
@@ -227,7 +227,7 @@
     },
     {
       "path": "harness-sync/SKILL.md",
-      "sha256": "af6d8a4b51a054c3e57bdcca77e88bd71d034d3d2316b9210b4a535dbc53cea8"
+      "sha256": "2e38716d9225c19d15245f4bcfb65947da6bbbe254642306f1645e5d37bcf298"
     },
     {
       "path": "harness-test/checklist.md",
@@ -243,7 +243,7 @@
     },
     {
       "path": "harness-test/reference.md",
-      "sha256": "77d85dca80335be4f71824450464b2810a7192eb79f16c6d2e1233ee5e6e5e9a"
+      "sha256": "72ca942018df10857c03f0ee23df45633a8aa4f3f2e635a44e731219a9985c2f"
     },
     {
       "path": "harness-test/scripts/runtime-helpers.mjs",
@@ -251,7 +251,7 @@
     },
     {
       "path": "harness-test/SKILL.md",
-      "sha256": "5823f5d4b56d71459826355aa9b67e76a97961576560eee92db6c813c773261a"
+      "sha256": "f278d08e7729097190071ff25563a6c30dbcdc15dbd1a2cf75a9ac6c377cf68f"
     },
     {
       "path": "protocols/archive-report-protocol.md",
@@ -323,7 +323,7 @@
     },
     {
       "path": "scripts/harness_archive.py",
-      "sha256": "e40181eec861bb1795bad27e8b5d1278a883ffadf8672e2f3888e25e34910869"
+      "sha256": "97a4207a24177761af57e308c7b684c0664f866e8b0d618800916d97c580f8e5"
     },
     {
       "path": "scripts/harness_change.py",
@@ -335,7 +335,7 @@
     },
     {
       "path": "scripts/harness_context.py",
-      "sha256": "c820f0de0c5d19441c0d41f25995a2005ca73ed0a3adb640a129ab53e7919926"
+      "sha256": "fa9557ffffba3866582054305aa74894dd3516eab9c6d088b705146b8e7e8729"
     },
     {
       "path": "scripts/harness_deploy.py",
@@ -351,11 +351,11 @@
     },
     {
       "path": "scripts/harness_events_sync.py",
-      "sha256": "f34d332b726453c39df7b50aa3f8639ee94f79567dd34b87da51a6d730bbdc76"
+      "sha256": "b5b6438cec03524b2837319d5889ffe5e94de88c98f52baa83fefebbd170e88b"
     },
     {
       "path": "scripts/harness_events.py",
-      "sha256": "60249baa71149c1b2d213bc268003b3d059846293de0071ae63efd7fd6a9b4b6"
+      "sha256": "59cccc6ddc24597c15f0542894b2d3a860ba581a5e6ecf277083bac2de94d589"
     },
     {
       "path": "scripts/harness_execution_contracts.py",
@@ -367,7 +367,7 @@
     },
     {
       "path": "scripts/harness_gate.py",
-      "sha256": "4ef8d33f1e3d3d44af6d7c32684665bab2e9b1cbd75b946cc926130624ff5a8f"
+      "sha256": "e6bbb9d177e8261d8c77ef55fdf87e9daf164ae9361ce09bb4e294c1c7f091ac"
     },
     {
       "path": "scripts/harness_headless.py",
@@ -379,7 +379,7 @@
     },
     {
       "path": "scripts/harness_ledger.py",
-      "sha256": "2e019f690309eb9f68e9c20a5bcd8ef7df4a77eafba228a18cf7322b7caacd3b"
+      "sha256": "eea0c064f1430e1c98df1401eec5c11f12ac3e2be9476fe94b78b84d85d17fac"
     },
     {
       "path": "scripts/harness_migration_head.py",
@@ -403,7 +403,7 @@
     },
     {
       "path": "scripts/harness_plan_finalize.py",
-      "sha256": "5d6a4b7e61f96ae72d320afba21719512eaacb12c6a11c609161bf333fbcf68a"
+      "sha256": "d415186905d314e9d768b9527b5564063060e524b359ffa5ba459ff1ad2b8fa1"
     },
     {
       "path": "scripts/harness_preflight.py",
@@ -451,7 +451,7 @@
     },
     {
       "path": "scripts/harness_test_guard.py",
-      "sha256": "426fd0002f643fc4b473f04f0c1164330de8a0c622cde7e07aad78d6a5e64df5"
+      "sha256": "a6ef4107e6ee32038753262623d2ff01c86cc640b42183c7117ed0da943c5742"
     },
     {
       "path": "scripts/harness_test_runner.py",