@hunter-harness/workflow-harness 0.2.59 → 0.2.61

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

@@ -810,10 +810,15 @@ def close_transition(
     artifact_entries: list[dict[str, Any]] = []
     for raw in artifacts or []:
         requested = Path(raw)
+        artifact_bases: list[Path] = []
+        for base in (project, contract_root, state_root):
+            resolved_base = base.resolve()
+            if resolved_base not in artifact_bases:
+                artifact_bases.append(resolved_base)
         candidates = (
             [requested]
             if requested.is_absolute()
-            else [project / requested, contract_root / requested]
+            else [base / requested for base in artifact_bases]
         )
         valid: list[Path] = []
         for candidate in candidates:
@@ -838,10 +843,11 @@ def close_transition(
                 "ok": False,
                 "code": "TRANSITION_ARTIFACT_INVALID",
                 "path": raw,
-                "acceptedBases": [str(project), str(contract_root)],
+                "acceptedBases": [str(base) for base in artifact_bases],
                 "examples": [
                     str(contract_root / "meta" / "plan-finalization.json"),
                     f".harness/changes/{change}/meta/plan-finalization.json",
+                    f".harness/state/changes/{change}/evidence/verification-ledger.json",
                     "meta/plan-finalization.json",
                 ],
             }

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

@@ -1077,6 +1077,11 @@ def split_phase_attempts(phase_events: list[dict[str, Any]]) -> list[dict[str, A
         "external.wait",
         "issue",
         "ci.wait",
+        # Preparation is intentionally outside the formal phase lifecycle.
+        # A blocked preflight must remain visible in the raw timeline without
+        # manufacturing an attempt or inflating the phase duration/count.
+        "phase.prepare.start",
+        "phase.prepare.end",
     }
     for event in phase_events:
         if event.get("type") == "phase.start":

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

@@ -1053,6 +1053,40 @@ def ledger_evidence_identity(ledger: dict[str, Any]) -> str:
     return "sha256:" + hashlib.sha256(canonical).hexdigest()
 
 
+def _immutable_change_base(
+    change_dir: Path,
+    project_root: Path,
+) -> str:
+    roots = [change_dir]
+    try:
+        state_root = harness_paths.resolve_state_dir_for_contract(
+            change_dir,
+            project_root,
+        )
+        if state_root.resolve() != change_dir.resolve():
+            roots.insert(0, state_root)
+    except (OSError, ValueError):
+        pass
+    for root in roots:
+        for relative in (
+            Path("meta") / "state-snapshot.json",
+            Path("state-snapshot.json"),
+        ):
+            path = root / relative
+            if not path.is_file():
+                continue
+            try:
+                payload = json.loads(path.read_text(encoding="utf-8-sig"))
+            except (OSError, json.JSONDecodeError, TypeError):
+                continue
+            if not isinstance(payload, dict):
+                continue
+            value = str(payload.get("changeBase") or "").strip()
+            if value:
+                return value
+    return ""
+
+
 def migrate_ledger_for_write(
     change_dir: Path,
     ledger: dict[str, Any],
@@ -1089,6 +1123,15 @@ def migrate_ledger_for_write(
     if not _nonempty_str(resolved_base):
         resolved_base = ledger.get("baseCommit")
     if not _nonempty_str(resolved_base):
+        resolved_base = _immutable_change_base(change_dir, repo_root)
+    if not _nonempty_str(resolved_base):
+        if record_migration:
+            raise LedgerMigrationError(
+                "immutable change base is missing; recapture the Plan boundary "
+                "or pass an explicit --base-commit instead of using write-time HEAD"
+            )
+        # A genuinely new ledger establishes its identity at the first write.
+        # Existing ledgers are handled above and may never take this fallback.
         resolved_base = current_head
     resolved_diff = diff_hash
     if not _nonempty_str(resolved_diff):
@@ -2795,9 +2838,43 @@ def cmd_diff_hash(args: argparse.Namespace) -> int:
     repo_raw = getattr(args, "repo", None)
     repo = Path(repo_raw).expanduser().resolve() if repo_raw else Path.cwd().resolve()
     base = getattr(args, "base", None)
-    change_dir = getattr(args, "change_dir", None)
+    change_dir_raw = getattr(args, "change_dir", None)
     try:
-        diff_hash, meta = compute_diff_hash(repo, base=base, change_dir=change_dir)
+        change_dir = resolve_path(change_dir_raw) if change_dir_raw else None
+        if change_dir is not None and _contract_is_v2(change_dir):
+            resolved_base = str(base or "").strip()
+            if not resolved_base:
+                existing, _ = load_ledger(change_dir)
+                if isinstance(existing, dict):
+                    resolved_base = str(existing.get("baseCommit") or "").strip()
+            if not resolved_base:
+                resolved_base = _immutable_change_base(change_dir, repo)
+            if not resolved_base:
+                raise ValueError(
+                    "immutable change base is missing; capture the Plan boundary "
+                    "or pass --base"
+                )
+            detail = compute_ownership_diff(
+                repo,
+                base=resolved_base,
+                change_dir=change_dir,
+            )
+            payload = {
+                "ok": True,
+                "action": "diff-hash",
+                "identityScope": "change-ownership",
+                "algorithmVersion": "ownership-content-changeset-1",
+                "base": resolved_base,
+                "head": _git_text(repo, "rev-parse", "--verify", "HEAD"),
+                **detail,
+            }
+            emit_json(payload, as_json=as_json)
+            return 0
+        diff_hash, meta = compute_diff_hash(
+            repo,
+            base=base,
+            change_dir=str(change_dir) if change_dir is not None else None,
+        )
     except (OSError, RuntimeError, ValueError) as exc:
         return emit_error(str(exc), as_json=as_json)
     payload = {"ok": True, "action": "diff-hash", "diffHash": diff_hash}

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

@@ -838,13 +838,20 @@ def _node_commands(project: Path) -> dict[str, Any]:
         "src/**/*.tsx",
         "test/**/*.ts",
         "test/**/*.tsx",
+        "tests/**/*.ts",
+        "tests/**/*.tsx",
         "packages/*/src/**/*.ts",
         "packages/*/src/**/*.tsx",
         "packages/*/test/**/*.ts",
         "packages/*/test/**/*.tsx",
+        "packages/*/tests/**/*.ts",
+        "packages/*/tests/**/*.tsx",
         "apps/*/src/**/*.ts",
         "apps/*/src/**/*.tsx",
         "apps/*/test/**/*.ts",
+        "apps/*/test/**/*.tsx",
+        "apps/*/tests/**/*.ts",
+        "apps/*/tests/**/*.tsx",
     ]
     # harness dogfood: canonical Python + .mjs sources feed npm run check (vitest
     # imports harness-test/scripts; smoke:pack runs sync-harness.mjs).

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

@@ -119,6 +119,10 @@ def capture_snapshot(
         "schemaVersion": SNAPSHOT_SCHEMA_VERSION,
         "generatedAt": now_iso(),
         "changeName": change_name,
+        # The first captured Git boundary is the immutable identity of the
+        # change.  Later phases may advance HEAD, but must never silently move
+        # the base and collapse the archive range.
+        "changeBase": base or "",
         "project": {"root": str(project.resolve())},
         "worktree": {"root": str(Path(worktree_root).resolve())},
         "git": {"base": base or "", "head": head or ""},
@@ -250,10 +254,25 @@ def capture_current_state(
     base: str = "",
     head: str = "HEAD",
 ) -> tuple[dict[str, Any], list[str]]:
-    resolved_head = _git(project, "rev-parse", head) or head
-    resolved_base = _git(project, "rev-parse", base) if base else ""
-    files = discover_segment_files(project, change_dir, base=resolved_base, head=resolved_head)
+    git_head = _git(project, "rev-parse", head)
+    resolved_head = git_head or head
     previous = load_snapshot(change_dir)
+    previous_git = previous.get("git") if isinstance(previous, dict) else None
+    previous_base = (
+        str(previous.get("changeBase") or "").strip()
+        if isinstance(previous, dict)
+        else ""
+    )
+    if not previous_base and isinstance(previous_git, dict):
+        previous_base = str(
+            previous_git.get("base") or previous_git.get("baseCommit") or ""
+        ).strip()
+    requested_base = _git(project, "rev-parse", base) if base else ""
+    # First capture establishes the boundary.  A later --base value is an
+    # observation hint only; changing the boundary requires the explicit
+    # archive range-adoption receipt.
+    resolved_base = previous_base or requested_base or git_head
+    files = discover_segment_files(project, change_dir, base=resolved_base, head=resolved_head)
     fresh = capture_snapshot(
         change_dir,
         change_name=change_name,

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

@@ -2,9 +2,9 @@
   "schema_version": 2,
   "profile": "general",
   "adapter": "claude-code",
-  "bundle_version": "0.2.48",
+  "bundle_version": "0.2.50",
   "requires": {
-    "minimumCliVersion": "0.2.65",
+    "minimumCliVersion": "0.2.67",
     "capabilities": [
       "sync@2",
       "rules-sync@1",
@@ -23,7 +23,7 @@
   "files": [
     {
       "path": ".harness-build.json",
-      "sha256": "8589c3b942fcc73d946bd08329f4896cbc9c5a00a7b571786296aec1f627c8b1"
+      "sha256": "8b914d22f840a59a680468f1bdca127d7066fffc253321e55071e294c3bffa64"
     },
     {
       "path": "agents/harness-evaluator.md",
@@ -83,11 +83,11 @@
     },
     {
       "path": "harness-archive/checklist.md",
-      "sha256": "05d320f6558fd1cd75f75ffc05574c20c2d5737393068cab76185860c9056b9e"
+      "sha256": "4844dcfbe052fe0d95a8b41120502777b35ea538d9fcb63c86ca720368a7196d"
     },
     {
       "path": "harness-archive/reference.md",
-      "sha256": "7564286fae2b73a9a646819b408d0dcd3ed757fdc833d19e8a130861f92ffb03"
+      "sha256": "a9f4ff879018d3e9ff7ad267396ae786ca30cee1239bbf0479a92880bbbcd89b"
     },
     {
       "path": "harness-archive/scripts/gen-manifest.ps1",
@@ -95,15 +95,11 @@
     },
     {
       "path": "harness-archive/SKILL.md",
-      "sha256": "1b4c56c176bc65e5256bf699c4dee6447fe61d11a7b2804e33033cd35cac51d4"
-    },
-    {
-      "path": "harness-archive/templates/render-summary.mjs",
-      "sha256": "970585dcd1c590a6fc985289954b60c41b2cf012df7ea2dd790260e452e404c9"
+      "sha256": "cd0e297bc677caf07f74cf53b58280545c53c92d7373a01c7a52ffcb042a7969"
     },
     {
       "path": "harness-archive/templates/summary-data-template.json",
-      "sha256": "6d2a1ef5b02287150f14f530902e78382fcf0111beeff4eb63bcf1a88f26b05c"
+      "sha256": "626e8821af4a29d51ae7a8d8e97f413fa72ce5c440186d115b5390bab24df77c"
     },
     {
       "path": "harness-codebase-map/checklist.md",
@@ -115,7 +111,7 @@
     },
     {
       "path": "harness-codebase-map/SKILL.md",
-      "sha256": "21c4e7e37126e9b25ac5eb1d64066e58d09374f8f2c57931af71238fc0848462"
+      "sha256": "df01a87236c743a80f654710bab97192c5c3c9fd3955ca3b8d6503442ab83309"
     },
     {
       "path": "harness-codebase-map/templates/ARCHITECTURE.md",
@@ -155,11 +151,11 @@
     },
     {
       "path": "harness-knowledge-ingest/SKILL.md",
-      "sha256": "b598952479ccc1a0be4a3c56c4f542ca54344bafa4c62cd31c7cea2aa5b1156d"
+      "sha256": "c2bf251986d898bd01610f66f07ddd450f0a568207741119bf978d647b405ad3"
     },
     {
       "path": "harness-knowledge-query/SKILL.md",
-      "sha256": "9c1b7c403a1d5ab805db97a29b2b27c53defdb46c22a9f8e704373ae21d36c21"
+      "sha256": "61af7d3dd7a65de6667b0366cd8ecc77dd3bf778ab6959faa0f6f28653c3522b"
     },
     {
       "path": "harness-plan/checklist.md",
@@ -175,7 +171,7 @@
     },
     {
       "path": "harness-plan/SKILL.md",
-      "sha256": "eb74a32b4ae17c6e211430a3564f08227b4729a3d3fc076b3674d992ee8d5c08"
+      "sha256": "d5970b58fc9b46755a145834c9045f122ea3777bf1ac5f402794a2a73ec6452f"
     },
     {
       "path": "harness-review/checklist.md",
@@ -191,23 +187,23 @@
     },
     {
       "path": "harness-review/SKILL.md",
-      "sha256": "fb8e6e2717de5681da78cd1836c65bd92c8f7b77060b1f875170a9175caa0593"
+      "sha256": "4137a8aa990c1aaaa12660689b7dfad51c102cb578c779b956c1fc98e062ecad"
     },
     {
       "path": "harness-run/checklist.md",
-      "sha256": "ccbad9ef784da2fbe4c1f1483ab1b02dc995eed6aa1d1750cc0df012b8235bbe"
+      "sha256": "76d32970de25d4d56a04c6935846eabd37bc16767bccd979f9f3fdcbd5d39dd7"
     },
     {
       "path": "harness-run/protocols.md",
-      "sha256": "b02fd6de8c25e0946d89ee7fe9cb8f8aaac73255ecbba6fa7584abb4954469e5"
+      "sha256": "101d52437bd439016227ea0b3ae188c1ca834a85d9c6f1c69a032ac9045f8cf4"
     },
     {
       "path": "harness-run/reference.md",
-      "sha256": "db97a547190bc364f20fff5ff363b78f5cc9732bc93d57900b163c2cf8a73655"
+      "sha256": "1d9714349da70302f19ba2a8f41bfaa125beb099db559070df3c0539c8da3a69"
     },
     {
       "path": "harness-run/SKILL.md",
-      "sha256": "879ee7f60b5a2cf9f08c851a70ca11d5330486a6d3739c43d83573ae22604b61"
+      "sha256": "2a0050feba8f4e9e2257471b52cc7f5ef340b67e328c1979c0b630455f2530b7"
     },
     {
       "path": "harness-submit/checklist.md",
@@ -219,7 +215,7 @@
     },
     {
       "path": "harness-submit/SKILL.md",
-      "sha256": "81b44528a0dfdf1fa8b649cb3755506fcdeb8a25c1a8b2cd630fc8ab40cf4fd8"
+      "sha256": "b762b04506481dc8c177b70ed74c99c43b9b5d0cb0e59700301a526217f2e783"
     },
     {
       "path": "harness-sync/reference.md",
@@ -227,11 +223,11 @@
     },
     {
       "path": "harness-sync/SKILL.md",
-      "sha256": "31bd47cfe2f194e14bf667f5c7711e8e0f329c008ec4dbc379f6a40581b6e1aa"
+      "sha256": "1c7a430e1a1d44da6b0e1efb590d0165169c3cac9dc5c6f8f8fb9ecdcce6fa5f"
     },
     {
       "path": "harness-test/checklist.md",
-      "sha256": "c68bb5e198522f27ac3c6ac53953d428e340898737b5c135de718a178e511e31"
+      "sha256": "b61055fdb7e22a53160bc66cba91b8d842bee501d50bd2122dae5849f2e9cf71"
     },
     {
       "path": "harness-test/pitfalls-java.md",
@@ -239,11 +235,11 @@
     },
     {
       "path": "harness-test/pitfalls.md",
-      "sha256": "2b14fc907885f0f4f5ec5d97e4c6f78fbd83bf1b1368c058b9154a3180c7e761"
+      "sha256": "e28bdcbff963d3cb071a5b0662fccf73682e8c26c83bb57981f9e4c2ce308ba3"
     },
     {
       "path": "harness-test/reference.md",
-      "sha256": "ce79a1f93a99729be8a3f32e923bf32a4a2f94a00b12d4aa8207dbd5747296c8"
+      "sha256": "02104991a1a551181a618cca6d793b3a193546b4f7c5d34858ea768dee7545ef"
     },
     {
       "path": "harness-test/scripts/runtime-helpers.mjs",
@@ -251,11 +247,11 @@
     },
     {
       "path": "harness-test/SKILL.md",
-      "sha256": "6498476a9a787ded376a0a5f3e44e392beff0638820e14dfccef138a8c1a349e"
+      "sha256": "24398adf6467864d5bb8534f91bfc6a51fa1320d97c5207ba91abd03c48b92d5"
     },
     {
       "path": "protocols/archive-report-protocol.md",
-      "sha256": "50bdb1769a57b6e8f29e769a3ae9090c9eddf63a1e22c34bf3671e456cace2d9"
+      "sha256": "23add8a690289b5007bb9a38db55009b41866731f0c37c287ce9467392700652"
     },
     {
       "path": "protocols/ci-layering-protocol.md",
@@ -263,7 +259,7 @@
     },
     {
       "path": "protocols/evidence-based-reporting-protocol.md",
-      "sha256": "f78ea87823c0935a3033175b393582319da433cf4226e1705070b20d53890ba2"
+      "sha256": "6560ccf52fa1e29da7a895eb88f1c7fb18c10d70b83f9e86d8fe4edf4b863ceb"
     },
     {
       "path": "protocols/execution-session-protocol.md",
@@ -275,7 +271,7 @@
     },
     {
       "path": "protocols/ledger-protocol.md",
-      "sha256": "bae14e9cb7422bf9e29551929af258948653ddc44624cc28efadefc5d189d358"
+      "sha256": "c52d7e7d0ee1b21e761edcef2d0e853af3c381dcde3a323d3959b77d56e9818e"
     },
     {
       "path": "protocols/memory-closeout-protocol.md",
@@ -295,15 +291,15 @@
     },
     {
       "path": "protocols/report-pipeline-protocol.md",
-      "sha256": "d37282f90a34e45f4d26f3bbd4f8b7c57ff2fd549a6e4f0ba9d34c037622a990"
+      "sha256": "a755c54942c58262e9e3478021e4c9c5ac8255db625d6714f3fd9810eb1067f9"
     },
     {
       "path": "protocols/sensitive-info-protocol.md",
-      "sha256": "152f87e3218c2eee89362c0ca00fea624e6e37e15c56ca7e28ad2202ef76acec"
+      "sha256": "cdf72b7b35f562a46f671fc6aff7ff6f64ca44bc08e9214e2b3d0c82f1703b22"
     },
     {
       "path": "protocols/state-layout-protocol.md",
-      "sha256": "6cfbaf850cc2455ff89909a27bcfd9f7caa3f210cf552fa0b93b44367b43f860"
+      "sha256": "01ff757004a18913d5d5a8083071d0a6fc9d25ac7cf7db07a879f7bb1319445d"
     },
     {
       "path": "protocols/submit-protocol.md",
@@ -315,7 +311,7 @@
     },
     {
       "path": "README.md",
-      "sha256": "fe2b4a245c7820f3f21886580c17455a95d8411844fcc4e3932d7de0ad491b10"
+      "sha256": "0b236ce76b6cc58f431b8b6be441e42e3120359d24a8c8d63b060164a417a8a7"
     },
     {
       "path": "scripts/harness_apidoc.py",
@@ -323,7 +319,7 @@
     },
     {
       "path": "scripts/harness_archive.py",
-      "sha256": "6ca1f096e69a61b356368c9c8e56859564087ac25b5fedc2edf71c289386d35c"
+      "sha256": "3c6fc709e5a2876fd4bad4ec60402b7b3933af1ea6d15bb6d16f269c7d65bf2f"
     },
     {
       "path": "scripts/harness_change.py",
@@ -335,7 +331,7 @@
     },
     {
       "path": "scripts/harness_context.py",
-      "sha256": "d36bce0bdb0eb6afa57418353e15d87c5fc7823bfa5dbc3fce7d96cdb456878c"
+      "sha256": "5ef587edd57b0c819df1c37a448eda33f00a5b97b930c804290d1a83d9a4ad60"
     },
     {
       "path": "scripts/harness_deploy.py",
@@ -355,7 +351,7 @@
     },
     {
       "path": "scripts/harness_events.py",
-      "sha256": "56858f5488255ed7af22dd38e2529c0287f3e4aa54e889b7a6d37666b4d73cb3"
+      "sha256": "f073ff0445a1de6d4e3030eb9b989e2f419ccdc9c36efcf060727ac4405b0804"
     },
     {
       "path": "scripts/harness_execution_contracts.py",
@@ -379,7 +375,7 @@
     },
     {
       "path": "scripts/harness_ledger.py",
-      "sha256": "a18f3dde32c07593721c1ee03d8625be6217a5aeade902cc1b11778cbeea23dc"
+      "sha256": "5c33a09f3b073294afa21804697488dd5fa5601e79707be8b7db9f89be8e95f9"
     },
     {
       "path": "scripts/harness_migration_head.py",
@@ -415,7 +411,7 @@
     },
     {
       "path": "scripts/harness_profile.py",
-      "sha256": "16b1aac01efc469a57a468fbcb20d72b4cd22a447ae76d0104a013bd3bd4aa0e"
+      "sha256": "9a10e62c52a7c84bf373bfb4aff18b2d51bfae6fd0ca75ef5ad7c87d22059e85"
     },
     {
       "path": "scripts/harness_report_model.py",
@@ -439,7 +435,7 @@
     },
     {
       "path": "scripts/harness_state.py",
-      "sha256": "2a74c29c8c230d0780f23d079cb294597729141e9b988679a0dcc16caf209400"
+      "sha256": "cd08bcf0347a289180d121d079d0d2e638c6188f47b9f393cc70bac3564721c4"
     },
     {
       "path": "scripts/harness_sync.py",