@hunter-harness/workflow-harness 0.2.84 → 0.2.85

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 (130) 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 +11 -4
  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-pull/SKILL.md +1 -1
  8. package/harness/bundles/general/claude-code/harness-push/SKILL.md +1 -1
  9. package/harness/bundles/general/claude-code/harness-review/SKILL.md +1 -1
  10. package/harness/bundles/general/claude-code/harness-run/SKILL.md +1 -1
  11. package/harness/bundles/general/claude-code/harness-submit/SKILL.md +1 -1
  12. package/harness/bundles/general/claude-code/harness-sync/SKILL.md +1 -1
  13. package/harness/bundles/general/claude-code/harness-test/SKILL.md +1 -1
  14. package/harness/bundles/general/claude-code/scripts/harness_archive.py +58 -25
  15. package/harness/bundles/general/codebuddy/.harness-build.json +1 -1
  16. package/harness/bundles/general/codebuddy/harness-archive/SKILL.md +11 -4
  17. package/harness/bundles/general/codebuddy/harness-codebase-map/SKILL.md +1 -1
  18. package/harness/bundles/general/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  19. package/harness/bundles/general/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  20. package/harness/bundles/general/codebuddy/harness-plan/SKILL.md +1 -1
  21. package/harness/bundles/general/codebuddy/harness-pull/SKILL.md +1 -1
  22. package/harness/bundles/general/codebuddy/harness-push/SKILL.md +1 -1
  23. package/harness/bundles/general/codebuddy/harness-review/SKILL.md +1 -1
  24. package/harness/bundles/general/codebuddy/harness-run/SKILL.md +1 -1
  25. package/harness/bundles/general/codebuddy/harness-submit/SKILL.md +1 -1
  26. package/harness/bundles/general/codebuddy/harness-sync/SKILL.md +1 -1
  27. package/harness/bundles/general/codebuddy/harness-test/SKILL.md +1 -1
  28. package/harness/bundles/general/codebuddy/scripts/harness_archive.py +58 -25
  29. package/harness/bundles/general/codex/.harness-build.json +1 -1
  30. package/harness/bundles/general/codex/harness-archive/SKILL.md +11 -4
  31. package/harness/bundles/general/codex/harness-codebase-map/SKILL.md +1 -1
  32. package/harness/bundles/general/codex/harness-knowledge-ingest/SKILL.md +1 -1
  33. package/harness/bundles/general/codex/harness-knowledge-query/SKILL.md +1 -1
  34. package/harness/bundles/general/codex/harness-plan/SKILL.md +1 -1
  35. package/harness/bundles/general/codex/harness-pull/SKILL.md +1 -1
  36. package/harness/bundles/general/codex/harness-push/SKILL.md +1 -1
  37. package/harness/bundles/general/codex/harness-review/SKILL.md +1 -1
  38. package/harness/bundles/general/codex/harness-run/SKILL.md +1 -1
  39. package/harness/bundles/general/codex/harness-submit/SKILL.md +1 -1
  40. package/harness/bundles/general/codex/harness-sync/SKILL.md +1 -1
  41. package/harness/bundles/general/codex/harness-test/SKILL.md +1 -1
  42. package/harness/bundles/general/codex/scripts/harness_archive.py +58 -25
  43. package/harness/bundles/general/cursor/.harness-build.json +1 -1
  44. package/harness/bundles/general/cursor/harness-archive/SKILL.md +11 -4
  45. package/harness/bundles/general/cursor/harness-codebase-map/SKILL.md +1 -1
  46. package/harness/bundles/general/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  47. package/harness/bundles/general/cursor/harness-knowledge-query/SKILL.md +1 -1
  48. package/harness/bundles/general/cursor/harness-plan/SKILL.md +1 -1
  49. package/harness/bundles/general/cursor/harness-pull/SKILL.md +1 -1
  50. package/harness/bundles/general/cursor/harness-push/SKILL.md +1 -1
  51. package/harness/bundles/general/cursor/harness-review/SKILL.md +1 -1
  52. package/harness/bundles/general/cursor/harness-run/SKILL.md +1 -1
  53. package/harness/bundles/general/cursor/harness-submit/SKILL.md +1 -1
  54. package/harness/bundles/general/cursor/harness-sync/SKILL.md +1 -1
  55. package/harness/bundles/general/cursor/harness-test/SKILL.md +1 -1
  56. package/harness/bundles/general/cursor/scripts/harness_archive.py +58 -25
  57. package/harness/bundles/java/claude-code/.harness-build.json +1 -1
  58. package/harness/bundles/java/claude-code/harness-apidoc/SKILL.md +1 -1
  59. package/harness/bundles/java/claude-code/harness-archive/SKILL.md +11 -4
  60. package/harness/bundles/java/claude-code/harness-codebase-map/SKILL.md +1 -1
  61. package/harness/bundles/java/claude-code/harness-knowledge-ingest/SKILL.md +1 -1
  62. package/harness/bundles/java/claude-code/harness-knowledge-query/SKILL.md +1 -1
  63. package/harness/bundles/java/claude-code/harness-package/SKILL.md +1 -1
  64. package/harness/bundles/java/claude-code/harness-plan/SKILL.md +1 -1
  65. package/harness/bundles/java/claude-code/harness-pull/SKILL.md +1 -1
  66. package/harness/bundles/java/claude-code/harness-push/SKILL.md +1 -1
  67. package/harness/bundles/java/claude-code/harness-review/SKILL.md +1 -1
  68. package/harness/bundles/java/claude-code/harness-run/SKILL.md +1 -1
  69. package/harness/bundles/java/claude-code/harness-submit/SKILL.md +1 -1
  70. package/harness/bundles/java/claude-code/harness-sync/SKILL.md +1 -1
  71. package/harness/bundles/java/claude-code/harness-test/SKILL.md +1 -1
  72. package/harness/bundles/java/claude-code/scripts/harness_archive.py +58 -25
  73. package/harness/bundles/java/codebuddy/.harness-build.json +1 -1
  74. package/harness/bundles/java/codebuddy/harness-apidoc/SKILL.md +1 -1
  75. package/harness/bundles/java/codebuddy/harness-archive/SKILL.md +11 -4
  76. package/harness/bundles/java/codebuddy/harness-codebase-map/SKILL.md +1 -1
  77. package/harness/bundles/java/codebuddy/harness-knowledge-ingest/SKILL.md +1 -1
  78. package/harness/bundles/java/codebuddy/harness-knowledge-query/SKILL.md +1 -1
  79. package/harness/bundles/java/codebuddy/harness-package/SKILL.md +1 -1
  80. package/harness/bundles/java/codebuddy/harness-plan/SKILL.md +1 -1
  81. package/harness/bundles/java/codebuddy/harness-pull/SKILL.md +1 -1
  82. package/harness/bundles/java/codebuddy/harness-push/SKILL.md +1 -1
  83. package/harness/bundles/java/codebuddy/harness-review/SKILL.md +1 -1
  84. package/harness/bundles/java/codebuddy/harness-run/SKILL.md +1 -1
  85. package/harness/bundles/java/codebuddy/harness-submit/SKILL.md +1 -1
  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/scripts/harness_archive.py +58 -25
  89. package/harness/bundles/java/codex/.harness-build.json +1 -1
  90. package/harness/bundles/java/codex/harness-apidoc/SKILL.md +1 -1
  91. package/harness/bundles/java/codex/harness-archive/SKILL.md +11 -4
  92. package/harness/bundles/java/codex/harness-codebase-map/SKILL.md +1 -1
  93. package/harness/bundles/java/codex/harness-knowledge-ingest/SKILL.md +1 -1
  94. package/harness/bundles/java/codex/harness-knowledge-query/SKILL.md +1 -1
  95. package/harness/bundles/java/codex/harness-package/SKILL.md +1 -1
  96. package/harness/bundles/java/codex/harness-plan/SKILL.md +1 -1
  97. package/harness/bundles/java/codex/harness-pull/SKILL.md +1 -1
  98. package/harness/bundles/java/codex/harness-push/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-submit/SKILL.md +1 -1
  102. package/harness/bundles/java/codex/harness-sync/SKILL.md +1 -1
  103. package/harness/bundles/java/codex/harness-test/SKILL.md +1 -1
  104. package/harness/bundles/java/codex/scripts/harness_archive.py +58 -25
  105. package/harness/bundles/java/cursor/.harness-build.json +1 -1
  106. package/harness/bundles/java/cursor/harness-apidoc/SKILL.md +1 -1
  107. package/harness/bundles/java/cursor/harness-archive/SKILL.md +11 -4
  108. package/harness/bundles/java/cursor/harness-codebase-map/SKILL.md +1 -1
  109. package/harness/bundles/java/cursor/harness-knowledge-ingest/SKILL.md +1 -1
  110. package/harness/bundles/java/cursor/harness-knowledge-query/SKILL.md +1 -1
  111. package/harness/bundles/java/cursor/harness-package/SKILL.md +1 -1
  112. package/harness/bundles/java/cursor/harness-plan/SKILL.md +1 -1
  113. package/harness/bundles/java/cursor/harness-pull/SKILL.md +1 -1
  114. package/harness/bundles/java/cursor/harness-push/SKILL.md +1 -1
  115. package/harness/bundles/java/cursor/harness-review/SKILL.md +1 -1
  116. package/harness/bundles/java/cursor/harness-run/SKILL.md +1 -1
  117. package/harness/bundles/java/cursor/harness-submit/SKILL.md +1 -1
  118. package/harness/bundles/java/cursor/harness-sync/SKILL.md +1 -1
  119. package/harness/bundles/java/cursor/harness-test/SKILL.md +1 -1
  120. package/harness/bundles/java/cursor/scripts/harness_archive.py +58 -25
  121. package/harness/manifests/general/claude-code.json +15 -15
  122. package/harness/manifests/general/codebuddy.json +15 -15
  123. package/harness/manifests/general/codex.json +15 -15
  124. package/harness/manifests/general/cursor.json +15 -15
  125. package/harness/manifests/java/claude-code.json +17 -17
  126. package/harness/manifests/java/codebuddy.json +17 -17
  127. package/harness/manifests/java/codex.json +17 -17
  128. package/harness/manifests/java/cursor.json +17 -17
  129. package/hunter-workflow-family.json +4 -4
  130. package/package.json +1 -1
@@ -2,5 +2,5 @@
2
2
  "schemaVersion": 1,
3
3
  "overlay": "none",
4
4
  "agent": "claude-code",
5
- "coreHash": "2e7fe0fb0fef6467"
5
+ "coreHash": "b0e6891811c856ce"
6
6
  }
@@ -21,7 +21,7 @@ disallowed-tools:
21
21
  - Bash(awk *)
22
22
  - Bash(curl *)
23
23
  ---
24
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
24
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
25
25
  # harness-archive — 变更归档
26
26
 
27
27
  ## Purpose
@@ -178,9 +178,16 @@ disallowed-tools:
178
178
  > ⚠️ 行内标注是**申报**,不是绕过:它把"这是设计决策"写进文档本身,可审计、可追溯。
179
179
  > **不要**为了过扫描去删改设计文档的事实内容——那是篡改证据。
180
180
  >
181
- > ⚠️ 已知限制:`hunter-harness-ignore` 在本地扫描器上确认生效;**服务端是否认这条标注尚未验证**
182
- > (归档上传端点只收裸 ZIP,没有独立的豁免申报通道)。若加了标注仍被 422 拒收,
183
- > 剩余动作是在平台侧对该规则/内容加白,本地无法自解。
181
+ > 行内标注**服务端确认生效**:平台归档入口跑的是同一个 `scanSensitiveFiles`,
182
+ > 它直接从文件内容里解析 `hunter-harness-ignore`,命中转为 `overridden`、不再阻断。
183
+ > 上传端点只收裸 ZIP、没有独立申报通道,靠的就是这条写在文档里的标注。
184
+ >
185
+ > ⚠️ 一处已知的服务端滞后:**不带凭据的连接串**(如 `postgres://dbhost:5432/appdb`)
186
+ > 本地预检判 `low`/可豁免,而线上服务端目前仍判 `high`——high 不接受行内标注,
187
+ > 这类设计文档暂时无法上传。平台侧修复已提交(见 hunter-platform
188
+ > `fix(archive): 归档 422 给出可执行出路`),**部署后**两侧一致。在那之前遇到这一条:
189
+ > 等平台部署,不要为了过扫描删掉连接串。带凭据的连接串(`user:pass@host`)两侧都是
190
+ > `high`,必须真正脱敏。
184
191
 
185
192
  ### 二·B、归档补传(上传失败或历史归档缺条目)
186
193
 
@@ -20,7 +20,7 @@ disallowed-tools:
20
20
  - Bash(awk *)
21
21
  - Bash(curl *)
22
22
  ---
23
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
23
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
24
24
  # harness-codebase-map — 代码库地图
25
25
 
26
26
  ## Purpose
@@ -8,7 +8,7 @@ disallowed-tools:
8
8
  - Bash(git *)
9
9
  - Bash(curl *)
10
10
  ---
11
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
11
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
12
12
  # harness-knowledge-ingest
13
13
 
14
14
  知识 ingest 完全由 Hunter Platform 负责。归档完成时,客户端生成一个确定性 ZIP;
@@ -8,7 +8,7 @@ disallowed-tools:
8
8
  - Bash(git *)
9
9
  - Bash(curl *)
10
10
  ---
11
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
11
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
12
12
  # harness-knowledge-query
13
13
 
14
14
  项目知识以 Hunter Platform 的服务端索引为唯一真源。客户端只提交查询并消费结果:
@@ -21,7 +21,7 @@ disallowed-tools:
21
21
  - Bash(awk *)
22
22
  - Bash(curl *)
23
23
  ---
24
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
24
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
25
25
  # harness-plan — 需求规划
26
26
 
27
27
  ## Purpose
@@ -21,7 +21,7 @@ disallowed-tools:
21
21
  - Bash(awk *)
22
22
  - Bash(curl *)
23
23
  ---
24
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
24
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
25
25
  # harness-pull — 从 Hunter Platform 下拉与恢复
26
26
 
27
27
  ## Purpose
@@ -21,7 +21,7 @@ disallowed-tools:
21
21
  - Bash(awk *)
22
22
  - Bash(curl *)
23
23
  ---
24
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
24
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
25
25
  # harness-push — 上传到 Hunter Platform
26
26
 
27
27
  ## Purpose
@@ -22,7 +22,7 @@ disallowed-tools:
22
22
  - Bash(curl *)
23
23
  - Bash(codegraph *)
24
24
  ---
25
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
25
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
26
26
  # harness-review — 代码审查
27
27
 
28
28
  ## Purpose
@@ -22,7 +22,7 @@ disallowed-tools:
22
22
  - Bash(curl *)
23
23
  - Bash(codegraph *)
24
24
  ---
25
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
25
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
26
26
  # harness-run — 需求编码
27
27
 
28
28
  ## Purpose
@@ -21,7 +21,7 @@ disallowed-tools:
21
21
  - Bash(awk *)
22
22
  - Bash(curl *)
23
23
  ---
24
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
24
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
25
25
  # harness-submit — 最终提交(含 worktree 合并)
26
26
 
27
27
  ## Purpose
@@ -19,7 +19,7 @@ disallowed-tools:
19
19
  - Bash(awk *)
20
20
  - Bash(curl *)
21
21
  ---
22
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
22
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
23
23
  # harness-sync
24
24
 
25
25
  ## Purpose
@@ -23,7 +23,7 @@ disallowed-tools:
23
23
  - Bash(node *)
24
24
  - Bash(codegraph *)
25
25
  ---
26
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=claude-code; do not edit -->
26
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=claude-code; do not edit -->
27
27
  # harness-test — 测试执行
28
28
 
29
29
  ## Purpose
@@ -2599,23 +2599,12 @@ def check_status(
2599
2599
  }
2600
2600
  )
2601
2601
 
2602
- # 发布内容预检:与服务端同源的规则,扫的是真正会进 ZIP 的那批文件。
2603
- # 服务端策略不归本地裁决,所以只预警不阻断——但必须在归档开始时就说出来,
2604
- # 而不是等跑完全流程由 upload 返回 422。
2605
- content_scan = precheck_publication_content(change_dir)
2606
- checks["publication_content_scan"] = content_scan
2607
- if content_scan.get("blocked"):
2608
- warnings.append({
2609
- "code": "PUBLICATION_CONTENT_SCAN_FLAGGED",
2610
- "message": str(content_scan.get("nextAction") or ""),
2611
- })
2612
- elif not content_scan.get("ok"):
2613
- warnings.append({
2614
- "code": str(
2615
- content_scan.get("reasonCode") or "PUBLICATION_CONTENT_SCAN_UNAVAILABLE"
2616
- ),
2617
- "message": str(content_scan.get("message") or ""),
2618
- })
2602
+ checks["publication_content_scan"] = {
2603
+ "ok": True,
2604
+ "scan_performed": False,
2605
+ "findings": [],
2606
+ "message": "上传归档链路已停用内容敏感扫描;保留路径、凭据与 ZIP 安全校验。",
2607
+ }
2619
2608
 
2620
2609
  sensitive_gate = validate_sensitive_evidence_publication_gate(
2621
2610
  change_dir,
@@ -9408,6 +9397,9 @@ def resolve_hunter_cli_command(project_root: Path) -> list[str]:
9408
9397
  """Command prefix that runs the hunter-harness CLI, cheapest route first."""
9409
9398
  node = shutil.which("node")
9410
9399
  if node:
9400
+ current_entry = os.environ.get("HUNTER_HARNESS_CLI_ENTRY", "").strip()
9401
+ if current_entry and Path(current_entry).is_file():
9402
+ return [node, str(Path(current_entry).resolve())]
9411
9403
  entry = _installed_cli_entry(project_root)
9412
9404
  if entry is not None:
9413
9405
  return [node, str(entry)]
@@ -9774,6 +9766,7 @@ def auto_push_archive_core(
9774
9766
  change_key: str | None = None,
9775
9767
  extra_entries: dict[str, tuple[str, str, bytes]] | None = None,
9776
9768
  reuse_retained_package: bool = False,
9769
+ prepared_package: dict[str, Any] | None = None,
9777
9770
  ) -> dict[str, Any]:
9778
9771
  """Build and upload one deterministic core ZIP after finalize.
9779
9772
 
@@ -9786,11 +9779,13 @@ def auto_push_archive_core(
9786
9779
  """
9787
9780
  project_root = project_root.resolve()
9788
9781
  effective_change_key = change_key or archive_dir.name
9789
- package = (
9790
- load_retained_package(project_root, effective_change_key)
9791
- if reuse_retained_package
9792
- else None
9793
- )
9782
+ package = prepared_package
9783
+ if package is None:
9784
+ package = (
9785
+ load_retained_package(project_root, effective_change_key)
9786
+ if reuse_retained_package
9787
+ else None
9788
+ )
9794
9789
  if package is None:
9795
9790
  try:
9796
9791
  package = build_archive_package(
@@ -10637,6 +10632,28 @@ def resolve_archive_dir_for_change(
10637
10632
  return archive_root / matches[-1], matches
10638
10633
 
10639
10634
 
10635
+ def resolve_latest_unpublished_archive(project_root: Path) -> tuple[str | None, list[str]]:
10636
+ """Choose the newest sealed archive without a durable local receipt."""
10637
+ archive_root = project_root / ".harness" / "archive"
10638
+ if not archive_root.is_dir():
10639
+ return None, []
10640
+ candidates: list[tuple[str, str]] = []
10641
+ for entry in archive_root.iterdir():
10642
+ if not entry.is_dir():
10643
+ continue
10644
+ change = entry.name
10645
+ try:
10646
+ summary = read_json(entry / "reports" / "final" / "summary-data.json")
10647
+ if isinstance(summary, dict) and isinstance(summary.get("changeName"), str):
10648
+ change = str(summary["changeName"]).strip() or change
10649
+ except (OSError, ValueError, json.JSONDecodeError):
10650
+ pass
10651
+ if read_durable_archive_receipt(project_root, change) is None:
10652
+ candidates.append((entry.name, change))
10653
+ candidates.sort(reverse=True)
10654
+ return (candidates[0][1] if candidates else None), [item[1] for item in candidates]
10655
+
10656
+
10640
10657
  def _republish_knowledge_entry(archive_dir: Path) -> dict[str, tuple[str, str, bytes]]:
10641
10658
  """Knowledge candidates for archives sealed before the candidates step.
10642
10659
 
@@ -10707,12 +10724,26 @@ def cmd_republish(
10707
10724
  "changeKey": change_key,
10708
10725
  "dryRun": dry_run,
10709
10726
  }
10727
+ root = resolve_republish_project_root(project_root, archive_dir)
10728
+ if change_key == "latest":
10729
+ selected, available = resolve_latest_unpublished_archive(root)
10730
+ if selected is None:
10731
+ payload.update({
10732
+ "ok": True,
10733
+ "reasonCode": "ARCHIVE_NO_UNPUBLISHED_ARCHIVE",
10734
+ "noChanges": True,
10735
+ "availableChanges": available,
10736
+ "projectRoot": str(root)
10737
+ })
10738
+ return 0, payload
10739
+ change_key = selected
10740
+ payload["changeKey"] = change_key
10741
+ payload["selectedChange"] = selected
10710
10742
  if re.fullmatch(r"[A-Za-z0-9][A-Za-z0-9._-]{0,159}", change_key) is None:
10711
10743
  payload["error"] = "change key must be a portable path segment"
10712
10744
  payload["reasonCode"] = "ARCHIVE_CHANGE_KEY_INVALID"
10713
10745
  return 2, payload
10714
10746
 
10715
- root = resolve_republish_project_root(project_root, archive_dir)
10716
10747
  payload["projectRoot"] = str(root)
10717
10748
  matches: list[str] = []
10718
10749
  if archive_dir is None:
@@ -10821,7 +10852,7 @@ def cmd_republish(
10821
10852
  # distinct name; it must never be mistaken for a pending upload.
10822
10853
  preview_path = (
10823
10854
  root / ".harness" / "state" / "local" / "archive-packages"
10824
- / f"{change_key}.preview.zip"
10855
+ / f"{change_key}{'.preview.zip' if dry_run else '.zip'}"
10825
10856
  )
10826
10857
  try:
10827
10858
  package = build_archive_package(
@@ -10837,7 +10868,8 @@ def cmd_republish(
10837
10868
  return 1, payload
10838
10869
  finally:
10839
10870
  try:
10840
- preview_path.unlink(missing_ok=True)
10871
+ if dry_run:
10872
+ preview_path.unlink(missing_ok=True)
10841
10873
  except OSError:
10842
10874
  pass
10843
10875
 
@@ -10907,6 +10939,7 @@ def cmd_republish(
10907
10939
  archive_dir,
10908
10940
  change_key=change_key,
10909
10941
  extra_entries=extra_entries,
10942
+ prepared_package=package,
10910
10943
  )
10911
10944
  payload["push"] = result
10912
10945
  payload["ok"] = bool(result.get("ok"))
@@ -2,5 +2,5 @@
2
2
  "schemaVersion": 1,
3
3
  "overlay": "none",
4
4
  "agent": "codebuddy",
5
- "coreHash": "2e7fe0fb0fef6467"
5
+ "coreHash": "b0e6891811c856ce"
6
6
  }
@@ -3,7 +3,7 @@ name: harness-archive
3
3
  description: 归档所有变更产出(计划/测试报告/审查/SQL/API文档)到 .harness/archive/,含归档元数据。仅当用户显式调用
4
4
  /harness-archive 时使用;不得被其他阶段 skill 自动接续触发。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-archive — 变更归档
8
8
 
9
9
  ## Purpose
@@ -160,9 +160,16 @@ description: 归档所有变更产出(计划/测试报告/审查/SQL/API文档
160
160
  > ⚠️ 行内标注是**申报**,不是绕过:它把"这是设计决策"写进文档本身,可审计、可追溯。
161
161
  > **不要**为了过扫描去删改设计文档的事实内容——那是篡改证据。
162
162
  >
163
- > ⚠️ 已知限制:`hunter-harness-ignore` 在本地扫描器上确认生效;**服务端是否认这条标注尚未验证**
164
- > (归档上传端点只收裸 ZIP,没有独立的豁免申报通道)。若加了标注仍被 422 拒收,
165
- > 剩余动作是在平台侧对该规则/内容加白,本地无法自解。
163
+ > 行内标注**服务端确认生效**:平台归档入口跑的是同一个 `scanSensitiveFiles`,
164
+ > 它直接从文件内容里解析 `hunter-harness-ignore`,命中转为 `overridden`、不再阻断。
165
+ > 上传端点只收裸 ZIP、没有独立申报通道,靠的就是这条写在文档里的标注。
166
+ >
167
+ > ⚠️ 一处已知的服务端滞后:**不带凭据的连接串**(如 `postgres://dbhost:5432/appdb`)
168
+ > 本地预检判 `low`/可豁免,而线上服务端目前仍判 `high`——high 不接受行内标注,
169
+ > 这类设计文档暂时无法上传。平台侧修复已提交(见 hunter-platform
170
+ > `fix(archive): 归档 422 给出可执行出路`),**部署后**两侧一致。在那之前遇到这一条:
171
+ > 等平台部署,不要为了过扫描删掉连接串。带凭据的连接串(`user:pass@host`)两侧都是
172
+ > `high`,必须真正脱敏。
166
173
 
167
174
  ### 二·B、归档补传(上传失败或历史归档缺条目)
168
175
 
@@ -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=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-codebase-map — 代码库地图
8
8
 
9
9
  ## Purpose
@@ -2,7 +2,7 @@
2
2
  name: harness-knowledge-ingest
3
3
  description: 确认归档 ZIP 已上传并由 Hunter Platform 在服务端解包、校验和入库。客户端不再构建或维护本地知识索引。
4
4
  ---
5
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
5
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
6
6
  # harness-knowledge-ingest
7
7
 
8
8
  知识 ingest 完全由 Hunter Platform 负责。归档完成时,客户端生成一个确定性 ZIP;
@@ -2,7 +2,7 @@
2
2
  name: harness-knowledge-query
3
3
  description: 在规划、实现或排查前,通过 hunter-harness CLI 查询远端项目知识库。远端不可用时直接报告不可用,不建立本地索引或离线回退。
4
4
  ---
5
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
5
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
6
6
  # harness-knowledge-query
7
7
 
8
8
  项目知识以 Hunter Platform 的服务端索引为唯一真源。客户端只提交查询并消费结果:
@@ -3,7 +3,7 @@ name: harness-plan
3
3
  description: 将需求转化为设计文档+实施计划+完整测试场景表,必须在编码前完成。仅当用户显式调用 /harness-plan 或明确要求进入
4
4
  Harness 规划阶段时使用;不得因用户描述需求就自动触发。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-plan — 需求规划
8
8
 
9
9
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-pull
3
3
  description: 从 Hunter Platform 下拉配置/规则/架构/指令(及显式来源分支的分支文件恢复)。仅当用户显式调用
4
4
  /harness-pull 或明确说'从平台拉取/恢复'时使用;不得自动触发。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-pull — 从 Hunter Platform 下拉与恢复
8
8
 
9
9
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-push
3
3
  description: 上传本地配置/规则/架构/指令(及显式归档)到 Hunter Platform。仅当用户显式调用 /harness-push
4
4
  或明确说'上传到平台'时使用;不得因存在本地修改就自动触发。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-push — 上传到 Hunter Platform
8
8
 
9
9
  ## Purpose
@@ -4,7 +4,7 @@ description: 6维度代码审查(架构/安全/规范/兼容/测试/性能)
4
4
  .harness/context-index.json)和测试场景表,在隔离上下文运行。仅当用户显式调用 /harness-review 时使用;不得在
5
5
  test 结束后自动接续执行。
6
6
  ---
7
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
7
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
8
8
  # harness-review — 代码审查
9
9
 
10
10
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-run
3
3
  description: 按变更簇执行 TDD 编码循环(RED→GREEN→REFACTOR→编译验证),逐变更簇实现计划中的任务。仅当用户显式调用
4
4
  /harness-run 时使用;不得因用户提到编码/实现就自动触发,也不得被其他阶段 skill 自动接续。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-run — 需求编码
8
8
 
9
9
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-submit
3
3
  description: 最终提交封装:验证→中文 commit→提交/推送;worktree 模式含 --no-ff 合并回主分支。仅当用户显式调用
4
4
  /harness-submit(或 /harness-merge 重入合并段)时使用;用户口头说'提交/commit/push'时必须先确认,不得自动触发。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-submit — 最终提交(含 worktree 合并)
8
8
 
9
9
  ## Purpose
@@ -4,7 +4,7 @@ description: Use when the user asks to synchronize, refresh, or validate Harness
4
4
  metadata, adapters, remote knowledge ownership, instruction entrypoints,
5
5
  config origins, or CodeGraph status.
6
6
  ---
7
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
7
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
8
8
  # harness-sync
9
9
 
10
10
  ## Purpose
@@ -3,7 +3,7 @@ name: harness-test
3
3
  description: 测试执行:读取场景表,执行单元测试+API接口测试+数据兼容验证,输出测试报告。仅当用户显式调用 /harness-test
4
4
  时使用;不得在 run 结束后自动接续执行。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=2e7fe0fb0fef6467; overlay=none; agent=codebuddy; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=b0e6891811c856ce; overlay=none; agent=codebuddy; do not edit -->
7
7
  # harness-test — 测试执行
8
8
 
9
9
  ## Purpose
@@ -2599,23 +2599,12 @@ def check_status(
2599
2599
  }
2600
2600
  )
2601
2601
 
2602
- # 发布内容预检:与服务端同源的规则,扫的是真正会进 ZIP 的那批文件。
2603
- # 服务端策略不归本地裁决,所以只预警不阻断——但必须在归档开始时就说出来,
2604
- # 而不是等跑完全流程由 upload 返回 422。
2605
- content_scan = precheck_publication_content(change_dir)
2606
- checks["publication_content_scan"] = content_scan
2607
- if content_scan.get("blocked"):
2608
- warnings.append({
2609
- "code": "PUBLICATION_CONTENT_SCAN_FLAGGED",
2610
- "message": str(content_scan.get("nextAction") or ""),
2611
- })
2612
- elif not content_scan.get("ok"):
2613
- warnings.append({
2614
- "code": str(
2615
- content_scan.get("reasonCode") or "PUBLICATION_CONTENT_SCAN_UNAVAILABLE"
2616
- ),
2617
- "message": str(content_scan.get("message") or ""),
2618
- })
2602
+ checks["publication_content_scan"] = {
2603
+ "ok": True,
2604
+ "scan_performed": False,
2605
+ "findings": [],
2606
+ "message": "上传归档链路已停用内容敏感扫描;保留路径、凭据与 ZIP 安全校验。",
2607
+ }
2619
2608
 
2620
2609
  sensitive_gate = validate_sensitive_evidence_publication_gate(
2621
2610
  change_dir,
@@ -9408,6 +9397,9 @@ def resolve_hunter_cli_command(project_root: Path) -> list[str]:
9408
9397
  """Command prefix that runs the hunter-harness CLI, cheapest route first."""
9409
9398
  node = shutil.which("node")
9410
9399
  if node:
9400
+ current_entry = os.environ.get("HUNTER_HARNESS_CLI_ENTRY", "").strip()
9401
+ if current_entry and Path(current_entry).is_file():
9402
+ return [node, str(Path(current_entry).resolve())]
9411
9403
  entry = _installed_cli_entry(project_root)
9412
9404
  if entry is not None:
9413
9405
  return [node, str(entry)]
@@ -9774,6 +9766,7 @@ def auto_push_archive_core(
9774
9766
  change_key: str | None = None,
9775
9767
  extra_entries: dict[str, tuple[str, str, bytes]] | None = None,
9776
9768
  reuse_retained_package: bool = False,
9769
+ prepared_package: dict[str, Any] | None = None,
9777
9770
  ) -> dict[str, Any]:
9778
9771
  """Build and upload one deterministic core ZIP after finalize.
9779
9772
 
@@ -9786,11 +9779,13 @@ def auto_push_archive_core(
9786
9779
  """
9787
9780
  project_root = project_root.resolve()
9788
9781
  effective_change_key = change_key or archive_dir.name
9789
- package = (
9790
- load_retained_package(project_root, effective_change_key)
9791
- if reuse_retained_package
9792
- else None
9793
- )
9782
+ package = prepared_package
9783
+ if package is None:
9784
+ package = (
9785
+ load_retained_package(project_root, effective_change_key)
9786
+ if reuse_retained_package
9787
+ else None
9788
+ )
9794
9789
  if package is None:
9795
9790
  try:
9796
9791
  package = build_archive_package(
@@ -10637,6 +10632,28 @@ def resolve_archive_dir_for_change(
10637
10632
  return archive_root / matches[-1], matches
10638
10633
 
10639
10634
 
10635
+ def resolve_latest_unpublished_archive(project_root: Path) -> tuple[str | None, list[str]]:
10636
+ """Choose the newest sealed archive without a durable local receipt."""
10637
+ archive_root = project_root / ".harness" / "archive"
10638
+ if not archive_root.is_dir():
10639
+ return None, []
10640
+ candidates: list[tuple[str, str]] = []
10641
+ for entry in archive_root.iterdir():
10642
+ if not entry.is_dir():
10643
+ continue
10644
+ change = entry.name
10645
+ try:
10646
+ summary = read_json(entry / "reports" / "final" / "summary-data.json")
10647
+ if isinstance(summary, dict) and isinstance(summary.get("changeName"), str):
10648
+ change = str(summary["changeName"]).strip() or change
10649
+ except (OSError, ValueError, json.JSONDecodeError):
10650
+ pass
10651
+ if read_durable_archive_receipt(project_root, change) is None:
10652
+ candidates.append((entry.name, change))
10653
+ candidates.sort(reverse=True)
10654
+ return (candidates[0][1] if candidates else None), [item[1] for item in candidates]
10655
+
10656
+
10640
10657
  def _republish_knowledge_entry(archive_dir: Path) -> dict[str, tuple[str, str, bytes]]:
10641
10658
  """Knowledge candidates for archives sealed before the candidates step.
10642
10659
 
@@ -10707,12 +10724,26 @@ def cmd_republish(
10707
10724
  "changeKey": change_key,
10708
10725
  "dryRun": dry_run,
10709
10726
  }
10727
+ root = resolve_republish_project_root(project_root, archive_dir)
10728
+ if change_key == "latest":
10729
+ selected, available = resolve_latest_unpublished_archive(root)
10730
+ if selected is None:
10731
+ payload.update({
10732
+ "ok": True,
10733
+ "reasonCode": "ARCHIVE_NO_UNPUBLISHED_ARCHIVE",
10734
+ "noChanges": True,
10735
+ "availableChanges": available,
10736
+ "projectRoot": str(root)
10737
+ })
10738
+ return 0, payload
10739
+ change_key = selected
10740
+ payload["changeKey"] = change_key
10741
+ payload["selectedChange"] = selected
10710
10742
  if re.fullmatch(r"[A-Za-z0-9][A-Za-z0-9._-]{0,159}", change_key) is None:
10711
10743
  payload["error"] = "change key must be a portable path segment"
10712
10744
  payload["reasonCode"] = "ARCHIVE_CHANGE_KEY_INVALID"
10713
10745
  return 2, payload
10714
10746
 
10715
- root = resolve_republish_project_root(project_root, archive_dir)
10716
10747
  payload["projectRoot"] = str(root)
10717
10748
  matches: list[str] = []
10718
10749
  if archive_dir is None:
@@ -10821,7 +10852,7 @@ def cmd_republish(
10821
10852
  # distinct name; it must never be mistaken for a pending upload.
10822
10853
  preview_path = (
10823
10854
  root / ".harness" / "state" / "local" / "archive-packages"
10824
- / f"{change_key}.preview.zip"
10855
+ / f"{change_key}{'.preview.zip' if dry_run else '.zip'}"
10825
10856
  )
10826
10857
  try:
10827
10858
  package = build_archive_package(
@@ -10837,7 +10868,8 @@ def cmd_republish(
10837
10868
  return 1, payload
10838
10869
  finally:
10839
10870
  try:
10840
- preview_path.unlink(missing_ok=True)
10871
+ if dry_run:
10872
+ preview_path.unlink(missing_ok=True)
10841
10873
  except OSError:
10842
10874
  pass
10843
10875
 
@@ -10907,6 +10939,7 @@ def cmd_republish(
10907
10939
  archive_dir,
10908
10940
  change_key=change_key,
10909
10941
  extra_entries=extra_entries,
10942
+ prepared_package=package,
10910
10943
  )
10911
10944
  payload["push"] = result
10912
10945
  payload["ok"] = bool(result.get("ok"))
@@ -2,5 +2,5 @@
2
2
  "schemaVersion": 1,
3
3
  "overlay": "none",
4
4
  "agent": "codex",
5
- "coreHash": "47340f933bad16d2"
5
+ "coreHash": "c0c77f0c226fcac9"
6
6
  }
@@ -3,7 +3,7 @@ name: harness-archive
3
3
  description: 归档所有变更产出(计划/测试报告/审查/SQL/API文档)到 .harness/archive/,含归档元数据。仅当用户显式调用
4
4
  /harness-archive 时使用;不得被其他阶段 skill 自动接续触发。
5
5
  ---
6
- <!-- generated by harness_deploy.py; core=47340f933bad16d2; overlay=none; agent=codex; do not edit -->
6
+ <!-- generated by harness_deploy.py; core=c0c77f0c226fcac9; overlay=none; agent=codex; do not edit -->
7
7
  # harness-archive — 变更归档
8
8
 
9
9
  ## Purpose
@@ -160,9 +160,16 @@ description: 归档所有变更产出(计划/测试报告/审查/SQL/API文档
160
160
  > ⚠️ 行内标注是**申报**,不是绕过:它把"这是设计决策"写进文档本身,可审计、可追溯。
161
161
  > **不要**为了过扫描去删改设计文档的事实内容——那是篡改证据。
162
162
  >
163
- > ⚠️ 已知限制:`hunter-harness-ignore` 在本地扫描器上确认生效;**服务端是否认这条标注尚未验证**
164
- > (归档上传端点只收裸 ZIP,没有独立的豁免申报通道)。若加了标注仍被 422 拒收,
165
- > 剩余动作是在平台侧对该规则/内容加白,本地无法自解。
163
+ > 行内标注**服务端确认生效**:平台归档入口跑的是同一个 `scanSensitiveFiles`,
164
+ > 它直接从文件内容里解析 `hunter-harness-ignore`,命中转为 `overridden`、不再阻断。
165
+ > 上传端点只收裸 ZIP、没有独立申报通道,靠的就是这条写在文档里的标注。
166
+ >
167
+ > ⚠️ 一处已知的服务端滞后:**不带凭据的连接串**(如 `postgres://dbhost:5432/appdb`)
168
+ > 本地预检判 `low`/可豁免,而线上服务端目前仍判 `high`——high 不接受行内标注,
169
+ > 这类设计文档暂时无法上传。平台侧修复已提交(见 hunter-platform
170
+ > `fix(archive): 归档 422 给出可执行出路`),**部署后**两侧一致。在那之前遇到这一条:
171
+ > 等平台部署,不要为了过扫描删掉连接串。带凭据的连接串(`user:pass@host`)两侧都是
172
+ > `high`,必须真正脱敏。
166
173
 
167
174
  ### 二·B、归档补传(上传失败或历史归档缺条目)
168
175