@hunter-harness/workflow-harness 0.2.43 → 0.2.44

package/harness/bundles/general/claude-code/contracts/run-session.schema.json

@@ -0,0 +1,142 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hunter-harness.dev/contracts/run-session.schema.json",
+  "title": "Hunter Harness managed run session",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "sessionId",
+    "status",
+    "reasonCode",
+    "exitCode",
+    "processIdentity",
+    "heartbeat",
+    "logs",
+    "cleanup",
+    "resultDigest"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "sessionId": { "type": "string", "minLength": 1 },
+    "status": {
+      "enum": [
+        "PREPARING",
+        "STARTING",
+        "RUNNING",
+        "FINALIZING",
+        "OK",
+        "FAIL",
+        "CANCELLED",
+        "INCOMPLETE"
+      ]
+    },
+    "reasonCode": { "$ref": "#/$defs/reasonCode" },
+    "exitCode": { "type": ["integer", "null"] },
+    "processIdentity": { "type": ["object", "null"] },
+    "heartbeat": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/heartbeat" }
+      ]
+    },
+    "logs": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stdout", "stderr"],
+      "properties": {
+        "stdout": { "$ref": "#/$defs/logStream" },
+        "stderr": { "$ref": "#/$defs/logStream" }
+      }
+    },
+    "cleanup": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["complete", "reasonCode"],
+      "properties": {
+        "complete": { "type": "boolean" },
+        "reasonCode": {
+          "oneOf": [
+            { "$ref": "#/$defs/reasonCode" },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "resultDigest": {
+      "oneOf": [
+        { "$ref": "#/$defs/digest" },
+        { "type": "null" }
+      ]
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": { "status": { "enum": ["OK", "FAIL"] } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "exitCode": { "type": "integer" },
+          "resultDigest": { "$ref": "#/$defs/digest" }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "status": { "const": "INCOMPLETE" } },
+        "required": ["status"]
+      },
+      "then": {
+        "properties": {
+          "exitCode": { "type": "null" },
+          "resultDigest": { "$ref": "#/$defs/digest" }
+        }
+      }
+    }
+  ],
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "reasonCode": {
+      "type": "string",
+      "minLength": 1
+    },
+    "heartbeat": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "writerIdentity",
+        "lastSeenAt",
+        "ttlSeconds",
+        "staleReason"
+      ],
+      "properties": {
+        "kind": { "enum": ["WORKER", "SUPERVISOR", "OBSERVER"] },
+        "writerIdentity": { "$ref": "#/$defs/digest" },
+        "lastSeenAt": { "type": "string", "minLength": 1 },
+        "ttlSeconds": { "type": "integer", "minimum": 1 },
+        "staleReason": {
+          "oneOf": [
+            { "$ref": "#/$defs/reasonCode" },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "logStream": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cursor", "rawDigest", "decodeStatus"],
+      "properties": {
+        "cursor": { "type": "integer", "minimum": 0 },
+        "rawDigest": { "$ref": "#/$defs/digest" },
+        "decodeStatus": { "enum": ["OK", "LOG_DECODE_DEGRADED"] }
+      }
+    }
+  }
+}

package/harness/bundles/general/claude-code/contracts/service-retirement-receipt.schema.json

@@ -0,0 +1,85 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hunter-harness.dev/contracts/service-retirement-receipt.schema.json",
+  "title": "Hunter Harness service retirement receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "receiptId",
+    "operationId",
+    "serviceId",
+    "oldSessionId",
+    "oldGeneration",
+    "state",
+    "retirementStateCommit",
+    "leaseCleanup",
+    "cleanupComplete",
+    "awaitingSuperseder",
+    "supersededBySessionId",
+    "receiptDigest"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "receiptId": { "type": "string", "minLength": 1 },
+    "operationId": { "type": "string", "minLength": 1 },
+    "serviceId": { "type": "string", "minLength": 1 },
+    "oldSessionId": { "type": "string", "minLength": 1 },
+    "oldGeneration": { "type": "integer", "minimum": 1 },
+    "state": { "enum": ["PENDING", "FINALIZED"] },
+    "retirementStateCommit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "reasonCode"],
+      "properties": {
+        "status": { "enum": ["PENDING", "COMMITTED", "CONFLICT"] },
+        "reasonCode": { "type": "string", "minLength": 1 }
+      }
+    },
+    "leaseCleanup": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "reasonCode", "leaseId"],
+      "properties": {
+        "status": { "enum": ["PENDING", "RELEASED", "RETAINED", "UNVERIFIED"] },
+        "reasonCode": { "type": "string", "minLength": 1 },
+        "leaseId": { "type": ["string", "null"], "minLength": 1 }
+      }
+    },
+    "cleanupComplete": { "type": "boolean" },
+    "awaitingSuperseder": { "type": "boolean" },
+    "supersededBySessionId": { "type": ["string", "null"], "minLength": 1 },
+    "receiptDigest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "leaseCleanup": {
+            "properties": { "status": { "const": "RELEASED" } },
+            "required": ["status"]
+          }
+        },
+        "required": ["leaseCleanup"]
+      },
+      "then": {
+        "properties": { "cleanupComplete": { "const": true } }
+      },
+      "else": {
+        "properties": { "cleanupComplete": { "const": false } }
+      }
+    },
+    {
+      "if": {
+        "properties": { "awaitingSuperseder": { "const": true } },
+        "required": ["awaitingSuperseder"]
+      },
+      "then": {
+        "properties": { "supersededBySessionId": { "type": "null" } }
+      }
+    }
+  ]
+}

package/harness/bundles/general/claude-code/contracts/service-session.schema.json

@@ -0,0 +1,147 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://hunter-harness.dev/contracts/service-session.schema.json",
+  "title": "Hunter Harness managed service session",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "serviceId",
+    "sessionId",
+    "status",
+    "reasonCode",
+    "serviceGeneration",
+    "stateRevision",
+    "operationId",
+    "fingerprint",
+    "processIdentity",
+    "heartbeat",
+    "leaseIdentity",
+    "transitionHistory",
+    "cleanupComplete",
+    "supersedesSessionId"
+  ],
+  "properties": {
+    "schemaVersion": { "const": 1 },
+    "serviceId": { "type": "string", "minLength": 1 },
+    "sessionId": { "type": "string", "minLength": 1 },
+    "status": {
+      "enum": [
+        "STARTING",
+        "READY",
+        "STOPPING",
+        "STOPPED",
+        "FAILED",
+        "STALE_IDENTITY_MISMATCH",
+        "RETIRED"
+      ]
+    },
+    "reasonCode": { "type": "string", "minLength": 1 },
+    "serviceGeneration": { "type": "integer", "minimum": 1 },
+    "stateRevision": { "type": "integer", "minimum": 1 },
+    "operationId": { "type": "string", "minLength": 1 },
+    "fingerprint": { "$ref": "#/$defs/digest" },
+    "processIdentity": { "type": ["object", "null"] },
+    "heartbeat": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "writerIdentity",
+            "generation",
+            "lastSeenAt",
+            "ttlSeconds",
+            "staleReason"
+          ],
+          "properties": {
+            "kind": { "enum": ["SUPERVISOR", "OBSERVER"] },
+            "writerIdentity": { "$ref": "#/$defs/digest" },
+            "generation": { "type": "integer", "minimum": 1 },
+            "lastSeenAt": { "type": "string", "minLength": 1 },
+            "ttlSeconds": { "type": "integer", "minimum": 1 },
+            "staleReason": { "type": ["string", "null"] }
+          }
+        }
+      ]
+    },
+    "leaseIdentity": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "leaseId",
+            "changeId",
+            "runId",
+            "expiresAt",
+            "generation"
+          ],
+          "properties": {
+            "leaseId": { "type": "string", "minLength": 1 },
+            "changeId": { "type": "string", "minLength": 1 },
+            "runId": { "type": "string", "minLength": 1 },
+            "expiresAt": { "type": "string", "minLength": 1 },
+            "generation": { "type": "integer", "minimum": 1 },
+            "listenerIdentity": { "type": "object" }
+          }
+        }
+      ]
+    },
+    "transitionHistory": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["from", "to", "reasonCode", "revision"],
+        "properties": {
+          "from": {
+            "type": ["string", "null"]
+          },
+            "to": { "type": "string", "minLength": 1 },
+            "reasonCode": { "type": "string", "minLength": 1 },
+            "revision": { "type": "integer", "minimum": 1 },
+            "operationId": { "type": "string", "minLength": 1 },
+            "at": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "cleanupComplete": { "type": "boolean" },
+    "supersedesSessionId": { "type": ["string", "null"], "minLength": 1 },
+    "pid": { "type": "integer", "minimum": 1 },
+    "startedBy": { "type": "string", "minLength": 1 },
+    "moduleInputsHash": { "$ref": "#/$defs/digest" },
+    "moduleInputsFiles": { "type": "array", "items": { "type": "string" } },
+    "profile": { "type": "string", "minLength": 1 },
+    "startCommandHash": { "$ref": "#/$defs/digest" },
+    "overlayPath": { "type": "string" },
+    "startedAt": { "type": "string", "minLength": 1 },
+    "command": { "type": "string" },
+    "argv": { "type": "array", "items": { "type": "string" } },
+    "ownedPorts": {
+      "type": "array",
+      "items": { "type": "integer", "minimum": 1, "maximum": 65535 }
+    },
+    "processAttestation": { "type": "object" },
+    "ownershipProof": { "type": "object" },
+    "servicePid": { "type": "integer", "minimum": 1 },
+    "jobId": { "type": "string", "minLength": 1 },
+    "leasedPort": { "type": "integer", "minimum": 1, "maximum": 65535 },
+    "leaseOwner": { "type": ["string", "null"] },
+    "worktreeRoot": { "type": "string", "minLength": 1 },
+    "executionRoot": { "type": "string", "minLength": 1 },
+    "changeId": { "type": "string", "minLength": 1 },
+    "attemptId": { "type": "string", "minLength": 1 },
+    "instanceTokenHash": { "$ref": "#/$defs/digest" },
+    "identityCompleteness": { "type": "string", "minLength": 1 }
+  },
+  "$defs": {
+    "digest": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    }
+  }
+}

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

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

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

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

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

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=49a193cd2335f90e; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=367eb27020f2b966; 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

@@ -20,7 +20,7 @@ disallowed-tools:
   - Bash(awk *)
   - Bash(curl *)
 ---
-<!-- generated by harness_deploy.py; core=49a193cd2335f90e; overlay=none; agent=claude-code; do not edit -->
+<!-- generated by harness_deploy.py; core=367eb27020f2b966; 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

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

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

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

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

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

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

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

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

@@ -389,6 +389,18 @@ python harness/scripts/harness_integration.py push --change <change-name> --run-
 
 远端基线漂移 → `TARGET_MOVED` 结构化失败，不继续。成功后 journal `pushedHead` 即 `mergeFinalHash`。
 
+若远端已确认 mergeCommit，但包装事务名与证据所属 Change 不同，导致
+`LEDGER_SYNC_PENDING / LEDGER_MISSING`，必须显式指定真实证据归属后恢复：
+
+```powershell
+python harness/scripts/harness_integration.py recover --change <transaction-change> --evidence-change <evidence-change> --run-id <run-id> --feature-branch harness/<transaction-change> --target-branch <主分支> --temp-root <task-temp>
+```
+
+该覆盖只允许修复“默认同名台账缺失”的远端已确认事务；一旦 journal 已绑定证据
+Change，后续传入不同值会 fail closed。目标台账的既有三项集成哈希必须精确匹配
+本事务基线（或已匹配本次 mergeCommit），作为前序集成交接身份；禁止为包装事务
+伪造空台账或覆盖其他历史 Change 的集成哈希。
+
 ### 步骤 M6：cleanup
 
 ```powershell

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

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

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

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