@hunter-harness/workflow-harness 0.2.2 → 0.2.3

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 (138) hide show
  1. package/harness/bundles/general/claude-code/.harness-build.json +1 -1
  2. package/harness/bundles/general/claude-code/harness-archive/SKILL.md +1 -1
  3. package/harness/bundles/general/claude-code/harness-codebase-map/SKILL.md +1 -1
  4. package/harness/bundles/general/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
  5. package/harness/bundles/general/claude-code/harness-knowledge-query/SKILL.md +1 -1
  6. package/harness/bundles/general/claude-code/harness-plan/SKILL.md +1 -1
  7. package/harness/bundles/general/claude-code/harness-review/SKILL.md +1 -1
  8. package/harness/bundles/general/claude-code/harness-run/SKILL.md +1 -1
  9. package/harness/bundles/general/claude-code/harness-submit/SKILL.md +1 -1
  10. package/harness/bundles/general/claude-code/harness-submit/checklist.md +2 -2
  11. package/harness/bundles/general/claude-code/harness-sync/SKILL.md +1 -1
  12. package/harness/bundles/general/claude-code/harness-test/SKILL.md +1 -1
  13. package/harness/bundles/general/claude-code/scripts/harness_check_gate.py +25 -17
  14. package/harness/bundles/general/codebuddy/.harness-build.json +1 -1
  15. package/harness/bundles/general/codebuddy/harness-archive/SKILL.md +1 -1
  16. package/harness/bundles/general/codebuddy/harness-codebase-map/SKILL.md +1 -1
  17. package/harness/bundles/general/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  18. package/harness/bundles/general/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  19. package/harness/bundles/general/codebuddy/harness-plan/SKILL.md +1 -1
  20. package/harness/bundles/general/codebuddy/harness-review/SKILL.md +1 -1
  21. package/harness/bundles/general/codebuddy/harness-run/SKILL.md +1 -1
  22. package/harness/bundles/general/codebuddy/harness-submit/SKILL.md +1 -1
  23. package/harness/bundles/general/codebuddy/harness-submit/checklist.md +2 -2
  24. package/harness/bundles/general/codebuddy/harness-sync/SKILL.md +1 -1
  25. package/harness/bundles/general/codebuddy/harness-test/SKILL.md +1 -1
  26. package/harness/bundles/general/codebuddy/scripts/harness_check_gate.py +25 -17
  27. package/harness/bundles/general/codex/.harness-build.json +1 -1
  28. package/harness/bundles/general/codex/harness-archive/SKILL.md +1 -1
  29. package/harness/bundles/general/codex/harness-codebase-map/SKILL.md +1 -1
  30. package/harness/bundles/general/codex/harness-knowledge-ingest/SKILL.md +1 -1
  31. package/harness/bundles/general/codex/harness-knowledge-query/SKILL.md +1 -1
  32. package/harness/bundles/general/codex/harness-plan/SKILL.md +1 -1
  33. package/harness/bundles/general/codex/harness-review/SKILL.md +1 -1
  34. package/harness/bundles/general/codex/harness-run/SKILL.md +1 -1
  35. package/harness/bundles/general/codex/harness-submit/SKILL.md +1 -1
  36. package/harness/bundles/general/codex/harness-submit/checklist.md +2 -2
  37. package/harness/bundles/general/codex/harness-sync/SKILL.md +1 -1
  38. package/harness/bundles/general/codex/harness-test/SKILL.md +1 -1
  39. package/harness/bundles/general/codex/scripts/harness_check_gate.py +25 -17
  40. package/harness/bundles/general/cursor/.harness-build.json +1 -1
  41. package/harness/bundles/general/cursor/harness-archive/SKILL.md +1 -1
  42. package/harness/bundles/general/cursor/harness-codebase-map/SKILL.md +1 -1
  43. package/harness/bundles/general/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  44. package/harness/bundles/general/cursor/harness-knowledge-query/SKILL.md +1 -1
  45. package/harness/bundles/general/cursor/harness-plan/SKILL.md +1 -1
  46. package/harness/bundles/general/cursor/harness-review/SKILL.md +1 -1
  47. package/harness/bundles/general/cursor/harness-run/SKILL.md +1 -1
  48. package/harness/bundles/general/cursor/harness-submit/SKILL.md +1 -1
  49. package/harness/bundles/general/cursor/harness-submit/checklist.md +2 -2
  50. package/harness/bundles/general/cursor/harness-sync/SKILL.md +1 -1
  51. package/harness/bundles/general/cursor/harness-test/SKILL.md +1 -1
  52. package/harness/bundles/general/cursor/scripts/harness_check_gate.py +25 -17
  53. package/harness/bundles/java/claude-code/.harness-build.json +1 -1
  54. package/harness/bundles/java/claude-code/harness-apidoc/SKILL.md +1 -1
  55. package/harness/bundles/java/claude-code/harness-archive/SKILL.md +1 -1
  56. package/harness/bundles/java/claude-code/harness-codebase-map/SKILL.md +1 -1
  57. package/harness/bundles/java/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
  58. package/harness/bundles/java/claude-code/harness-knowledge-query/SKILL.md +1 -1
  59. package/harness/bundles/java/claude-code/harness-package/SKILL.md +1 -1
  60. package/harness/bundles/java/claude-code/harness-plan/SKILL.md +1 -1
  61. package/harness/bundles/java/claude-code/harness-review/SKILL.md +1 -1
  62. package/harness/bundles/java/claude-code/harness-run/SKILL.md +1 -1
  63. package/harness/bundles/java/claude-code/harness-run/checklist.md +2 -0
  64. package/harness/bundles/java/claude-code/harness-run/reference.md +6 -0
  65. package/harness/bundles/java/claude-code/harness-submit/SKILL.md +1 -1
  66. package/harness/bundles/java/claude-code/harness-submit/checklist.md +2 -2
  67. package/harness/bundles/java/claude-code/harness-sync/SKILL.md +1 -1
  68. package/harness/bundles/java/claude-code/harness-test/SKILL.md +1 -1
  69. package/harness/bundles/java/claude-code/harness-test/checklist.md +3 -1
  70. package/harness/bundles/java/claude-code/harness-test/reference.md +2 -0
  71. package/harness/bundles/java/claude-code/scripts/harness_check_gate.py +25 -17
  72. package/harness/bundles/java/codebuddy/.harness-build.json +1 -1
  73. package/harness/bundles/java/codebuddy/harness-apidoc/SKILL.md +1 -1
  74. package/harness/bundles/java/codebuddy/harness-archive/SKILL.md +1 -1
  75. package/harness/bundles/java/codebuddy/harness-codebase-map/SKILL.md +1 -1
  76. package/harness/bundles/java/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  77. package/harness/bundles/java/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  78. package/harness/bundles/java/codebuddy/harness-package/SKILL.md +1 -1
  79. package/harness/bundles/java/codebuddy/harness-plan/SKILL.md +1 -1
  80. package/harness/bundles/java/codebuddy/harness-review/SKILL.md +1 -1
  81. package/harness/bundles/java/codebuddy/harness-run/SKILL.md +1 -1
  82. package/harness/bundles/java/codebuddy/harness-run/checklist.md +2 -0
  83. package/harness/bundles/java/codebuddy/harness-run/reference.md +6 -0
  84. package/harness/bundles/java/codebuddy/harness-submit/SKILL.md +1 -1
  85. package/harness/bundles/java/codebuddy/harness-submit/checklist.md +2 -2
  86. package/harness/bundles/java/codebuddy/harness-sync/SKILL.md +1 -1
  87. package/harness/bundles/java/codebuddy/harness-test/SKILL.md +1 -1
  88. package/harness/bundles/java/codebuddy/harness-test/checklist.md +3 -1
  89. package/harness/bundles/java/codebuddy/harness-test/reference.md +2 -0
  90. package/harness/bundles/java/codebuddy/scripts/harness_check_gate.py +25 -17
  91. package/harness/bundles/java/codex/.harness-build.json +1 -1
  92. package/harness/bundles/java/codex/harness-apidoc/SKILL.md +1 -1
  93. package/harness/bundles/java/codex/harness-archive/SKILL.md +1 -1
  94. package/harness/bundles/java/codex/harness-codebase-map/SKILL.md +1 -1
  95. package/harness/bundles/java/codex/harness-knowledge-ingest/SKILL.md +1 -1
  96. package/harness/bundles/java/codex/harness-knowledge-query/SKILL.md +1 -1
  97. package/harness/bundles/java/codex/harness-package/SKILL.md +1 -1
  98. package/harness/bundles/java/codex/harness-plan/SKILL.md +1 -1
  99. package/harness/bundles/java/codex/harness-review/SKILL.md +1 -1
  100. package/harness/bundles/java/codex/harness-run/SKILL.md +1 -1
  101. package/harness/bundles/java/codex/harness-run/checklist.md +2 -0
  102. package/harness/bundles/java/codex/harness-run/reference.md +6 -0
  103. package/harness/bundles/java/codex/harness-submit/SKILL.md +1 -1
  104. package/harness/bundles/java/codex/harness-submit/checklist.md +2 -2
  105. package/harness/bundles/java/codex/harness-sync/SKILL.md +1 -1
  106. package/harness/bundles/java/codex/harness-test/SKILL.md +1 -1
  107. package/harness/bundles/java/codex/harness-test/checklist.md +3 -1
  108. package/harness/bundles/java/codex/harness-test/reference.md +2 -0
  109. package/harness/bundles/java/codex/scripts/harness_check_gate.py +25 -17
  110. package/harness/bundles/java/cursor/.harness-build.json +1 -1
  111. package/harness/bundles/java/cursor/harness-apidoc/SKILL.md +1 -1
  112. package/harness/bundles/java/cursor/harness-archive/SKILL.md +1 -1
  113. package/harness/bundles/java/cursor/harness-codebase-map/SKILL.md +1 -1
  114. package/harness/bundles/java/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  115. package/harness/bundles/java/cursor/harness-knowledge-query/SKILL.md +1 -1
  116. package/harness/bundles/java/cursor/harness-package/SKILL.md +1 -1
  117. package/harness/bundles/java/cursor/harness-plan/SKILL.md +1 -1
  118. package/harness/bundles/java/cursor/harness-review/SKILL.md +1 -1
  119. package/harness/bundles/java/cursor/harness-run/SKILL.md +1 -1
  120. package/harness/bundles/java/cursor/harness-run/checklist.md +2 -0
  121. package/harness/bundles/java/cursor/harness-run/reference.md +6 -0
  122. package/harness/bundles/java/cursor/harness-submit/SKILL.md +1 -1
  123. package/harness/bundles/java/cursor/harness-submit/checklist.md +2 -2
  124. package/harness/bundles/java/cursor/harness-sync/SKILL.md +1 -1
  125. package/harness/bundles/java/cursor/harness-test/SKILL.md +1 -1
  126. package/harness/bundles/java/cursor/harness-test/checklist.md +3 -1
  127. package/harness/bundles/java/cursor/harness-test/reference.md +2 -0
  128. package/harness/bundles/java/cursor/scripts/harness_check_gate.py +25 -17
  129. package/harness/manifests/general/claude-code.json +14 -14
  130. package/harness/manifests/general/codebuddy.json +14 -14
  131. package/harness/manifests/general/codex.json +14 -14
  132. package/harness/manifests/general/cursor.json +14 -14
  133. package/harness/manifests/java/claude-code.json +20 -20
  134. package/harness/manifests/java/codebuddy.json +20 -20
  135. package/harness/manifests/java/codex.json +20 -20
  136. package/harness/manifests/java/cursor.json +20 -20
  137. package/hunter-workflow-family.json +2 -2
  138. package/package.json +1 -1
@@ -2,5 +2,5 @@
2
2
  "schemaVersion": 1,
3
3
  "overlay": "none",
4
4
  "agent": "claude-code",
5
- "coreHash": "0e63599ac74b7033"
5
+ "coreHash": "31546eadb30f5fdf"
6
6
  }
@@ -20,7 +20,7 @@ disallowed-tools:
20
20
  - Bash(awk *)
21
21
  - Bash(curl *)
22
22
  ---
23
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=claude-code; do not edit -->
23
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=claude-code; do not edit -->
24
24
  # harness-archive — 变更归档
25
25
 
26
26
  ## Purpose
@@ -20,7 +20,7 @@ disallowed-tools:
20
20
  - Bash(awk *)
21
21
  - Bash(curl *)
22
22
  ---
23
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=claude-code; do not edit -->
23
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=claude-code; do not edit -->
24
24
  # harness-codebase-map — 代码库地图
25
25
 
26
26
  ## Purpose
@@ -20,7 +20,7 @@ disallowed-tools:
20
20
  - Bash(awk *)
21
21
  - Bash(curl *)
22
22
  ---
23
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=claude-code; do not edit -->
23
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=claude-code; do not edit -->
24
24
  # harness-knowledge-ingest
25
25
 
26
26
  从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识,生成并维护本地 `.harness/knowledge/` 索引。
@@ -20,7 +20,7 @@ disallowed-tools:
20
20
  - Bash(awk *)
21
21
  - Bash(curl *)
22
22
  ---
23
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=claude-code; do not edit -->
23
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=claude-code; do not edit -->
24
24
  # harness-knowledge-query
25
25
 
26
26
  根据用户的新需求或排查问题,从项目本地 `.harness/knowledge` 中检索历史需求、决策、实现、风险和测试证据,并生成 AI 可读的 context pack。
@@ -20,7 +20,7 @@ disallowed-tools:
20
20
  - Bash(awk *)
21
21
  - Bash(curl *)
22
22
  ---
23
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=claude-code; do not edit -->
23
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=claude-code; do not edit -->
24
24
  # harness-plan — 需求规划
25
25
 
26
26
  ## Purpose
@@ -21,7 +21,7 @@ disallowed-tools:
21
21
  - Bash(curl *)
22
22
  - Bash(codegraph *)
23
23
  ---
24
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=claude-code; do not edit -->
24
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=claude-code; do not edit -->
25
25
  # harness-review — 代码审查
26
26
 
27
27
  ## Purpose
@@ -21,7 +21,7 @@ disallowed-tools:
21
21
  - Bash(curl *)
22
22
  - Bash(codegraph *)
23
23
  ---
24
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=claude-code; do not edit -->
24
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=claude-code; do not edit -->
25
25
  # harness-run — 需求编码
26
26
 
27
27
  ## Purpose
@@ -20,7 +20,7 @@ disallowed-tools:
20
20
  - Bash(awk *)
21
21
  - Bash(curl *)
22
22
  ---
23
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=claude-code; do not edit -->
23
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=claude-code; do not edit -->
24
24
  # harness-submit — 最终提交(含 worktree 合并)
25
25
 
26
26
  ## Purpose
@@ -380,14 +380,14 @@ powershell.exe -Command "git -C '<项目路径>' diff --name-only --diff-filter=
380
380
 
381
381
  重跑后写回 ledger 的 `compile`/`unitTest`,更新 `diffHash`/`currentHead`。
382
382
 
383
- **写 check-ok marker**(npm run check exit 0 后强制):让 pre-push hook 跳过重复 check(省 ~350s)。三重校验(marker ts<10min + command + HEAD),任一不满足照跑。
383
+ **写 check-ok marker**(npm run check exit 0 后强制):让 pre-push hook 跳过重复 check。三重校验(marker ts<10min + command + commit tree),任一不满足照跑。marker 写入时记录 `git write-tree`,因此验证后创建 commit 不会仅因 HEAD 前移而使缓存失效。
384
384
 
385
385
  ```powershell
386
386
  # npm run check exit 0 后立即写 marker(M5 或 REUSED 后均可)
387
387
  powershell.exe -Command "python harness/scripts/harness_check_gate.py --write"
388
388
  ```
389
389
 
390
- > marker 写入 `.harness/check-ok.marker`(gitignored,本地)。push 时 pre-push hook marker:HEAD 自写 marker 后未变 + ts<10min + command 匹配 → 跳过 npm run check;否则照跑(安全默认)。
390
+ > marker 写入 `.harness/check-ok.marker`(gitignored,本地)。push 时 pre-push hook 比较 `HEAD^{tree}` marker `treeHash`,再校验 ts<10min + command;commit tree 未变化即可跳过,任何内容变化都照跑(安全默认)。
391
391
 
392
392
  ### 步骤 M6:push 主分支
393
393
 
@@ -19,7 +19,7 @@ disallowed-tools:
19
19
  - Bash(awk *)
20
20
  - Bash(curl *)
21
21
  ---
22
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=claude-code; do not edit -->
22
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=claude-code; do not edit -->
23
23
  # harness-sync — 元数据同步
24
24
 
25
25
  ## Purpose
@@ -22,7 +22,7 @@ disallowed-tools:
22
22
  - Bash(node *)
23
23
  - Bash(codegraph *)
24
24
  ---
25
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=claude-code; do not edit -->
25
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=claude-code; do not edit -->
26
26
  # harness-test — 测试执行
27
27
 
28
28
  ## Purpose
@@ -1,14 +1,15 @@
1
1
  #!/usr/bin/env python3
2
2
  """Pre-push gate: skip `npm run check` when a recent check-ok marker matches
3
- the current HEAD.
3
+ the tree of the commit being pushed.
4
4
 
5
5
  Triple check (all must pass to skip, else exit 1 → hook runs npm run check):
6
6
  1. marker exists and its `ts` is within MAX_AGE_S (10 min) of now
7
7
  2. marker `command` == EXPECTED_CMD ("npm run check")
8
- 3. current `git rev-parse HEAD` == marker `commitHash`
8
+ 3. current `git rev-parse HEAD^{tree}` == marker `treeHash`
9
9
 
10
- The marker is written by harness-submit M5 right after a green `npm run check`.
11
- Any mismatch (no marker, stale, different command, HEAD moved since the check)
10
+ The marker is written by harness-submit M5 after a green `npm run check` and
11
+ records `git write-tree`. This remains valid after commit because the new HEAD
12
+ has the same tree. Any mismatch (no marker, stale, command or tree changed)
12
13
  forces a full re-run — the safe default. This is a local convenience only;
13
14
  non-harness pushes have no marker and always run the check.
14
15
 
@@ -28,10 +29,10 @@ MAX_AGE_S = 600 # 10 minutes
28
29
  EXPECTED_CMD = "npm run check"
29
30
 
30
31
 
31
- def _current_head() -> str | None:
32
+ def _git_output(args: list[str]) -> str | None:
32
33
  try:
33
34
  r = subprocess.run(
34
- ["git", "rev-parse", "HEAD"],
35
+ ["git", *args],
35
36
  cwd=str(ROOT),
36
37
  capture_output=True,
37
38
  text=True,
@@ -42,20 +43,27 @@ def _current_head() -> str | None:
42
43
  return r.stdout.strip() if r.returncode == 0 else None
43
44
 
44
45
 
46
+ def _current_index_tree() -> str | None:
47
+ return _git_output(["write-tree"])
48
+
49
+
50
+ def _current_head_tree() -> str | None:
51
+ return _git_output(["rev-parse", "HEAD^{tree}"])
52
+
53
+
45
54
  def write_marker() -> int:
46
- """Write a check-ok marker for the current HEAD (called by harness-submit M5
47
- after a green npm run check). Pre-push gate reads it to skip a re-run."""
48
- head = _current_head()
49
- if head is None:
55
+ """Record the verified index tree so the marker survives the next commit."""
56
+ tree = _current_index_tree()
57
+ if tree is None:
50
58
  return 1
51
59
  MARKER.parent.mkdir(parents=True, exist_ok=True)
52
- payload = {"ts": time.time(), "commitHash": head, "command": EXPECTED_CMD}
60
+ payload = {"ts": time.time(), "treeHash": tree, "command": EXPECTED_CMD}
53
61
  MARKER.write_text(
54
62
  json.dumps(payload, ensure_ascii=False) + "\n",
55
63
  encoding="utf-8",
56
64
  newline="\n",
57
65
  )
58
- print(f"check-ok marker written for HEAD {head[:7]}")
66
+ print(f"check-ok marker written for tree {tree[:7]}")
59
67
  return 0
60
68
 
61
69
 
@@ -84,17 +92,17 @@ def main(argv: list[str] | None = None) -> int:
84
92
  return 1
85
93
  if data.get("command") != EXPECTED_CMD:
86
94
  return 1
87
- marker_commit = data.get("commitHash")
88
- if not isinstance(marker_commit, str):
95
+ marker_tree = data.get("treeHash")
96
+ if not isinstance(marker_tree, str):
89
97
  return 1
90
- head = _current_head()
91
- if head is None or head != marker_commit:
98
+ tree = _current_head_tree()
99
+ if tree is None or tree != marker_tree:
92
100
  return 1
93
101
  # All three checks passed: a green npm run check ran on this exact HEAD
94
102
  # within the last 10 minutes. Safe to skip.
95
103
  print(
96
104
  f"pre-push: skipping npm run check (verified {int(time.time() - ts)}s ago "
97
- f"at HEAD {head[:7]})"
105
+ f"for tree {tree[:7]})"
98
106
  )
99
107
  return 0
100
108
 
@@ -2,5 +2,5 @@
2
2
  "schemaVersion": 1,
3
3
  "overlay": "none",
4
4
  "agent": "codebuddy",
5
- "coreHash": "0e63599ac74b7033"
5
+ "coreHash": "31546eadb30f5fdf"
6
6
  }
@@ -3,7 +3,7 @@ name: harness-archive
3
3
  description: 归档所有变更产出(计划/测试报告/审查/SQL/API文档)到
4
4
  .harness/archive/,含归档元数据和可视化最终总结。使用场景:归档、完成归档、收尾、打包产出物
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-archive — 变更归档
8
8
 
9
9
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-codebase-map
3
3
  description: 分析现有代码库并生成 .harness/codebase/map/
4
4
  下的结构化代码库地图。用于陌生项目理解、重大改造前梳理、harness-sync 提示 map 过期后的人工刷新。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-codebase-map — 代码库地图
8
8
 
9
9
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-knowledge-ingest
3
3
  description: 从 .harness/archive 归档整理、同步和维护项目知识索引。适用场景:ingest knowledge、sync
4
4
  knowledge、rebuild knowledge index、promote knowledge、确认知识条目、检查知识库是否过期。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-knowledge-ingest
8
8
 
9
9
  从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识,生成并维护本地 `.harness/knowledge/` 索引。
@@ -3,7 +3,7 @@ name: harness-knowledge-query
3
3
  description: 根据新需求、设计任务、代码修改请求或问题排查,在规划和编码前查询 .harness/knowledge
4
4
  历史上下文。适用场景:query knowledge、查找历史需求、根据归档理解需求、继续之前类似开发、生成需求上下文包。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-knowledge-query
8
8
 
9
9
  根据用户的新需求或排查问题,从项目本地 `.harness/knowledge` 中检索历史需求、决策、实现、风险和测试证据,并生成 AI 可读的 context pack。
@@ -2,7 +2,7 @@
2
2
  name: harness-plan
3
3
  description: 将需求转化为设计文档+实施计划+完整测试场景表,必须在编码前完成。使用场景:需求分析、feature plan、技术方案设计、实现方案规划
4
4
  ---
5
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=codebuddy; do not edit -->
5
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=codebuddy; do not edit -->
6
6
  # harness-plan — 需求规划
7
7
 
8
8
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-review
3
3
  description: 6维度代码审查(架构/安全/规范/兼容/测试/性能),对照项目规则(见
4
4
  .harness/context-index.json)和测试场景表,在隔离上下文运行。使用场景:代码审查、提交前检查、合并评审
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-review — 代码审查
8
8
 
9
9
  ## Purpose
@@ -2,7 +2,7 @@
2
2
  name: harness-run
3
3
  description: 按变更簇执行 TDD 编码循环(RED→GREEN→REFACTOR→编译验证),逐变更簇实现计划中的任务。使用场景:开始编码、实现功能、写代码、TDD 编码
4
4
  ---
5
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=codebuddy; do not edit -->
5
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=codebuddy; do not edit -->
6
6
  # harness-run — 需求编码
7
7
 
8
8
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-submit
3
3
  description: 最终提交封装:验证→中文 commit→提交/推送;worktree 模式含 --no-ff
4
4
  合并回主分支。使用场景:提交代码、commit、push、合并分支、merge to main、完成开发
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-submit — 最终提交(含 worktree 合并)
8
8
 
9
9
  ## Purpose
@@ -380,14 +380,14 @@ powershell.exe -Command "git -C '<项目路径>' diff --name-only --diff-filter=
380
380
 
381
381
  重跑后写回 ledger 的 `compile`/`unitTest`,更新 `diffHash`/`currentHead`。
382
382
 
383
- **写 check-ok marker**(npm run check exit 0 后强制):让 pre-push hook 跳过重复 check(省 ~350s)。三重校验(marker ts<10min + command + HEAD),任一不满足照跑。
383
+ **写 check-ok marker**(npm run check exit 0 后强制):让 pre-push hook 跳过重复 check。三重校验(marker ts<10min + command + commit tree),任一不满足照跑。marker 写入时记录 `git write-tree`,因此验证后创建 commit 不会仅因 HEAD 前移而使缓存失效。
384
384
 
385
385
  ```powershell
386
386
  # npm run check exit 0 后立即写 marker(M5 或 REUSED 后均可)
387
387
  powershell.exe -Command "python harness/scripts/harness_check_gate.py --write"
388
388
  ```
389
389
 
390
- > marker 写入 `.harness/check-ok.marker`(gitignored,本地)。push 时 pre-push hook marker:HEAD 自写 marker 后未变 + ts<10min + command 匹配 → 跳过 npm run check;否则照跑(安全默认)。
390
+ > marker 写入 `.harness/check-ok.marker`(gitignored,本地)。push 时 pre-push hook 比较 `HEAD^{tree}` marker `treeHash`,再校验 ts<10min + command;commit tree 未变化即可跳过,任何内容变化都照跑(安全默认)。
391
391
 
392
392
  ### 步骤 M6:push 主分支
393
393
 
@@ -2,7 +2,7 @@
2
2
  name: harness-sync
3
3
  description: 检查并更新项目AI元数据(CodeGraph索引、harness-codebase-map分析、CLAUDE.md、AGENTS.md、.harness/完整性),确保Claude对代码库的理解与最新代码一致。当用户说'同步/更新索引/刷新元数据/检查一致性'时使用
4
4
  ---
5
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=codebuddy; do not edit -->
5
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=codebuddy; do not edit -->
6
6
  # harness-sync — 元数据同步
7
7
 
8
8
  ## Purpose
@@ -2,7 +2,7 @@
2
2
  name: harness-test
3
3
  description: 测试执行:读取场景表,执行单元测试+API接口测试+数据兼容验证,输出测试报告。当用户说'跑测试/验证/跑用例/接口测试/单元测试'时使用
4
4
  ---
5
- <!-- generated by harness_deploy.py; core=0e63599ac74b7033; overlay=none; agent=codebuddy; do not edit -->
5
+ <!-- generated by harness_deploy.py; core=31546eadb30f5fdf; overlay=none; agent=codebuddy; do not edit -->
6
6
  # harness-test — 测试执行
7
7
 
8
8
  ## Purpose
@@ -1,14 +1,15 @@
1
1
  #!/usr/bin/env python3
2
2
  """Pre-push gate: skip `npm run check` when a recent check-ok marker matches
3
- the current HEAD.
3
+ the tree of the commit being pushed.
4
4
 
5
5
  Triple check (all must pass to skip, else exit 1 → hook runs npm run check):
6
6
  1. marker exists and its `ts` is within MAX_AGE_S (10 min) of now
7
7
  2. marker `command` == EXPECTED_CMD ("npm run check")
8
- 3. current `git rev-parse HEAD` == marker `commitHash`
8
+ 3. current `git rev-parse HEAD^{tree}` == marker `treeHash`
9
9
 
10
- The marker is written by harness-submit M5 right after a green `npm run check`.
11
- Any mismatch (no marker, stale, different command, HEAD moved since the check)
10
+ The marker is written by harness-submit M5 after a green `npm run check` and
11
+ records `git write-tree`. This remains valid after commit because the new HEAD
12
+ has the same tree. Any mismatch (no marker, stale, command or tree changed)
12
13
  forces a full re-run — the safe default. This is a local convenience only;
13
14
  non-harness pushes have no marker and always run the check.
14
15
 
@@ -28,10 +29,10 @@ MAX_AGE_S = 600 # 10 minutes
28
29
  EXPECTED_CMD = "npm run check"
29
30
 
30
31
 
31
- def _current_head() -> str | None:
32
+ def _git_output(args: list[str]) -> str | None:
32
33
  try:
33
34
  r = subprocess.run(
34
- ["git", "rev-parse", "HEAD"],
35
+ ["git", *args],
35
36
  cwd=str(ROOT),
36
37
  capture_output=True,
37
38
  text=True,
@@ -42,20 +43,27 @@ def _current_head() -> str | None:
42
43
  return r.stdout.strip() if r.returncode == 0 else None
43
44
 
44
45
 
46
+ def _current_index_tree() -> str | None:
47
+ return _git_output(["write-tree"])
48
+
49
+
50
+ def _current_head_tree() -> str | None:
51
+ return _git_output(["rev-parse", "HEAD^{tree}"])
52
+
53
+
45
54
  def write_marker() -> int:
46
- """Write a check-ok marker for the current HEAD (called by harness-submit M5
47
- after a green npm run check). Pre-push gate reads it to skip a re-run."""
48
- head = _current_head()
49
- if head is None:
55
+ """Record the verified index tree so the marker survives the next commit."""
56
+ tree = _current_index_tree()
57
+ if tree is None:
50
58
  return 1
51
59
  MARKER.parent.mkdir(parents=True, exist_ok=True)
52
- payload = {"ts": time.time(), "commitHash": head, "command": EXPECTED_CMD}
60
+ payload = {"ts": time.time(), "treeHash": tree, "command": EXPECTED_CMD}
53
61
  MARKER.write_text(
54
62
  json.dumps(payload, ensure_ascii=False) + "\n",
55
63
  encoding="utf-8",
56
64
  newline="\n",
57
65
  )
58
- print(f"check-ok marker written for HEAD {head[:7]}")
66
+ print(f"check-ok marker written for tree {tree[:7]}")
59
67
  return 0
60
68
 
61
69
 
@@ -84,17 +92,17 @@ def main(argv: list[str] | None = None) -> int:
84
92
  return 1
85
93
  if data.get("command") != EXPECTED_CMD:
86
94
  return 1
87
- marker_commit = data.get("commitHash")
88
- if not isinstance(marker_commit, str):
95
+ marker_tree = data.get("treeHash")
96
+ if not isinstance(marker_tree, str):
89
97
  return 1
90
- head = _current_head()
91
- if head is None or head != marker_commit:
98
+ tree = _current_head_tree()
99
+ if tree is None or tree != marker_tree:
92
100
  return 1
93
101
  # All three checks passed: a green npm run check ran on this exact HEAD
94
102
  # within the last 10 minutes. Safe to skip.
95
103
  print(
96
104
  f"pre-push: skipping npm run check (verified {int(time.time() - ts)}s ago "
97
- f"at HEAD {head[:7]})"
105
+ f"for tree {tree[:7]})"
98
106
  )
99
107
  return 0
100
108
 
@@ -2,5 +2,5 @@
2
2
  "schemaVersion": 1,
3
3
  "overlay": "none",
4
4
  "agent": "codex",
5
- "coreHash": "5401f914277e0517"
5
+ "coreHash": "ab1182505b44093f"
6
6
  }
@@ -3,7 +3,7 @@ name: harness-archive
3
3
  description: 归档所有变更产出(计划/测试报告/审查/SQL/API文档)到
4
4
  .harness/archive/,含归档元数据和可视化最终总结。使用场景:归档、完成归档、收尾、打包产出物
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=5401f914277e0517; overlay=none; agent=codex; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=ab1182505b44093f; overlay=none; agent=codex; do not edit -->
7
7
  # harness-archive — 变更归档
8
8
 
9
9
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-codebase-map
3
3
  description: 分析现有代码库并生成 .harness/codebase/map/
4
4
  下的结构化代码库地图。用于陌生项目理解、重大改造前梳理、harness-sync 提示 map 过期后的人工刷新。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=5401f914277e0517; overlay=none; agent=codex; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=ab1182505b44093f; overlay=none; agent=codex; do not edit -->
7
7
  # harness-codebase-map — 代码库地图
8
8
 
9
9
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-knowledge-ingest
3
3
  description: 从 .harness/archive 归档整理、同步和维护项目知识索引。适用场景:ingest knowledge、sync
4
4
  knowledge、rebuild knowledge index、promote knowledge、确认知识条目、检查知识库是否过期。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=5401f914277e0517; overlay=none; agent=codex; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=ab1182505b44093f; overlay=none; agent=codex; do not edit -->
7
7
  # harness-knowledge-ingest
8
8
 
9
9
  从 `.harness/archive/**/reports/final/summary-data.json` 抽取项目知识,生成并维护本地 `.harness/knowledge/` 索引。
@@ -3,7 +3,7 @@ name: harness-knowledge-query
3
3
  description: 根据新需求、设计任务、代码修改请求或问题排查,在规划和编码前查询 .harness/knowledge
4
4
  历史上下文。适用场景:query knowledge、查找历史需求、根据归档理解需求、继续之前类似开发、生成需求上下文包。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=5401f914277e0517; overlay=none; agent=codex; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=ab1182505b44093f; overlay=none; agent=codex; do not edit -->
7
7
  # harness-knowledge-query
8
8
 
9
9
  根据用户的新需求或排查问题,从项目本地 `.harness/knowledge` 中检索历史需求、决策、实现、风险和测试证据,并生成 AI 可读的 context pack。
@@ -2,7 +2,7 @@
2
2
  name: harness-plan
3
3
  description: 将需求转化为设计文档+实施计划+完整测试场景表,必须在编码前完成。使用场景:需求分析、feature plan、技术方案设计、实现方案规划
4
4
  ---
5
- <!-- generated by harness_deploy.py; core=5401f914277e0517; overlay=none; agent=codex; do not edit -->
5
+ <!-- generated by harness_deploy.py; core=ab1182505b44093f; overlay=none; agent=codex; do not edit -->
6
6
  # harness-plan — 需求规划
7
7
 
8
8
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-review
3
3
  description: 6维度代码审查(架构/安全/规范/兼容/测试/性能),对照项目规则(见
4
4
  .harness/context-index.json)和测试场景表,在隔离上下文运行。使用场景:代码审查、提交前检查、合并评审
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=5401f914277e0517; overlay=none; agent=codex; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=ab1182505b44093f; overlay=none; agent=codex; do not edit -->
7
7
  # harness-review — 代码审查
8
8
 
9
9
  ## Purpose
@@ -2,7 +2,7 @@
2
2
  name: harness-run
3
3
  description: 按变更簇执行 TDD 编码循环(RED→GREEN→REFACTOR→编译验证),逐变更簇实现计划中的任务。使用场景:开始编码、实现功能、写代码、TDD 编码
4
4
  ---
5
- <!-- generated by harness_deploy.py; core=5401f914277e0517; overlay=none; agent=codex; do not edit -->
5
+ <!-- generated by harness_deploy.py; core=ab1182505b44093f; overlay=none; agent=codex; do not edit -->
6
6
  # harness-run — 需求编码
7
7
 
8
8
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-submit
3
3
  description: 最终提交封装:验证→中文 commit→提交/推送;worktree 模式含 --no-ff
4
4
  合并回主分支。使用场景:提交代码、commit、push、合并分支、merge to main、完成开发
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=5401f914277e0517; overlay=none; agent=codex; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=ab1182505b44093f; overlay=none; agent=codex; do not edit -->
7
7
  # harness-submit — 最终提交(含 worktree 合并)
8
8
 
9
9
  ## Purpose
@@ -380,14 +380,14 @@ powershell.exe -Command "git -C '<项目路径>' diff --name-only --diff-filter=
380
380
 
381
381
  重跑后写回 ledger 的 `compile`/`unitTest`,更新 `diffHash`/`currentHead`。
382
382
 
383
- **写 check-ok marker**(npm run check exit 0 后强制):让 pre-push hook 跳过重复 check(省 ~350s)。三重校验(marker ts<10min + command + HEAD),任一不满足照跑。
383
+ **写 check-ok marker**(npm run check exit 0 后强制):让 pre-push hook 跳过重复 check。三重校验(marker ts<10min + command + commit tree),任一不满足照跑。marker 写入时记录 `git write-tree`,因此验证后创建 commit 不会仅因 HEAD 前移而使缓存失效。
384
384
 
385
385
  ```powershell
386
386
  # npm run check exit 0 后立即写 marker(M5 或 REUSED 后均可)
387
387
  powershell.exe -Command "python harness/scripts/harness_check_gate.py --write"
388
388
  ```
389
389
 
390
- > marker 写入 `.harness/check-ok.marker`(gitignored,本地)。push 时 pre-push hook marker:HEAD 自写 marker 后未变 + ts<10min + command 匹配 → 跳过 npm run check;否则照跑(安全默认)。
390
+ > marker 写入 `.harness/check-ok.marker`(gitignored,本地)。push 时 pre-push hook 比较 `HEAD^{tree}` marker `treeHash`,再校验 ts<10min + command;commit tree 未变化即可跳过,任何内容变化都照跑(安全默认)。
391
391
 
392
392
  ### 步骤 M6:push 主分支
393
393
 
@@ -2,7 +2,7 @@
2
2
  name: harness-sync
3
3
  description: 检查并更新项目AI元数据(CodeGraph索引、harness-codebase-map分析、CLAUDE.md、AGENTS.md、.harness/完整性),确保Claude对代码库的理解与最新代码一致。当用户说'同步/更新索引/刷新元数据/检查一致性'时使用
4
4
  ---
5
- <!-- generated by harness_deploy.py; core=5401f914277e0517; overlay=none; agent=codex; do not edit -->
5
+ <!-- generated by harness_deploy.py; core=ab1182505b44093f; overlay=none; agent=codex; do not edit -->
6
6
  # harness-sync — 元数据同步
7
7
 
8
8
  ## Purpose
@@ -2,7 +2,7 @@
2
2
  name: harness-test
3
3
  description: 测试执行:读取场景表,执行单元测试+API接口测试+数据兼容验证,输出测试报告。当用户说'跑测试/验证/跑用例/接口测试/单元测试'时使用
4
4
  ---
5
- <!-- generated by harness_deploy.py; core=5401f914277e0517; overlay=none; agent=codex; do not edit -->
5
+ <!-- generated by harness_deploy.py; core=ab1182505b44093f; overlay=none; agent=codex; do not edit -->
6
6
  # harness-test — 测试执行
7
7
 
8
8
  ## Purpose