@hunter-harness/workflow-harness 0.2.43 → 0.2.44

package/harness/bundles/general/cursor/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/cursor/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/cursor/harness-archive/SKILL.md

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

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=25fbc79c2d6a7537; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=d08d6cebbfad24db; 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=25fbc79c2d6a7537; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=d08d6cebbfad24db; 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=25fbc79c2d6a7537; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=d08d6cebbfad24db; 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=25fbc79c2d6a7537; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=d08d6cebbfad24db; 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=25fbc79c2d6a7537; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=d08d6cebbfad24db; 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=25fbc79c2d6a7537; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=d08d6cebbfad24db; 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=25fbc79c2d6a7537; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=d08d6cebbfad24db; overlay=none; agent=cursor; do not edit -->
 # harness-submit — 最终提交（含 worktree 合并）
 
 ## Purpose

package/harness/bundles/general/cursor/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/cursor/harness-sync/SKILL.md

@@ -4,7 +4,7 @@ description: Use when the user asks to synchronize, refresh, or validate Harness
   metadata, adapters, knowledge, rules, instruction entrypoints, config origins,
   or CodeGraph status.
 ---
-<!-- generated by harness_deploy.py; core=25fbc79c2d6a7537; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=d08d6cebbfad24db; 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=25fbc79c2d6a7537; overlay=none; agent=cursor; do not edit -->
+<!-- generated by harness_deploy.py; core=d08d6cebbfad24db; overlay=none; agent=cursor; do not edit -->
 # harness-test — 测试执行
 
 ## Purpose